This is part of the NServiceBus Upgrade Guide from Version 6 to 7, which also includes the following individual upgrade guides for specific components:
Transports
- Migrating Msmq subscription messages
- Azure Service Bus Transport (Legacy) Upgrade Version 7 to 8
- RabbitMQ Transport Upgrade Version 4 to 5
- SQL Server Transport Upgrade Version 3 to 4
Persistence
Hosting
Other
Upgrade to NServiceBus Version 7
NServiceBus.Testing requires NServiceBus Version 7.
When upgrading to NServiceBus.Testing Version 7 projects will also require an upgrade to NServiceBus Version 7.
AssertSagaCompletionIs
The AssertSagaCompletionIs
method has been obsoleted and replaced by ExpectSagaCompleted
and ExpectSagaNotCompleted
.
7.x - 7.1 NServiceBus.Testing
Test.Saga<MySaga>()
.ExpectSagaCompleted()
.WhenHandling<CompleteSagaMessage>();
6.x NServiceBus.Testing
Test.Saga<MySaga>()
.WhenHandling<CompleteSagaMessage>()
.AssertSagaCompletionIs(true);
Note the ExpectSagaCompleted
and ExpectSagaNotCompleted
expectations must be placed before a When
method, similar to other expectation methods.
ExpectHandleCurrentMessageLater
The ExpectHandleCurrentMessageLater
has been obsoleted as IMessageHandlerContext.
has been deprecated in NServiceBus Version 7.
WhenHandling
An overload of the WhenHandling
method has been added, which accepts a preconstructed message.
7.x - 7.1 NServiceBus.Testing
var message = new CompleteSagaMessage();
Test.Saga<MySaga>()
.ExpectSagaCompleted()
.WhenHandling(message);
6.x NServiceBus.Testing
var message = new CompleteSagaMessage();
Test.Saga<MySaga>()
.WhenHandling<CompleteSagaMessage>(msg => { /* msg has already been created */ })
.AssertSagaCompletionIs(true);