ServiceFabric.Mocks contains many Mock and helper classes to facilitate and simplify unit testing of Service Fabric Actors and Services.
https://www.nuget.org/packages/ServiceFabric.Mocks/
Contributions are most welcome:
- Please upgrade the package version with a minor tick if there are no breaking changes, by changing the
<VersionPrefix>X.Y.Z</VersionPrefix>
in the csproj file - Add a line to the readme.md, stating the changes, e.g. 'upgraded to SF version x.y.z'.
Doing so will allow me to simply accept the PR, which will automatically trigger the release of a new package. Please also make sure all feature additions have a corresponding unit test.
Or donate a cup of coffee.
The VSTS Agent lagged behind in Service Fabric SDK version, this caused runtime errors. This issue is now resolved.
-
3.1.5
- Fixed bug in SaveReminderAsync which did not update existing reminder if called multiple times with same reminder name. Now updates existing reminder, if any.
- Fixed bug in GetActorReminders which threw exception if called when no reminders had been registered at all. Now returns empty collection.
-
3.1.4
- Fixed bug in TransactedConcurrentDictionary.SetAsync which threw ArgumentException when key was not already present. Updated to follow MS documentation: Adds a key/value pair to the Reliable Dictionary if the key does not already exist, or updates a key/value pair in the Reliable Dictionary if the key already exists. Fixes issue #44.
-
3.1.3
- Merged PR by Jaah. Fix creation of
IReliableDictionary2
collections
- Merged PR by Jaah. Fix creation of
-
3.1.2
- Merged PR by Jaah. Add support for
IReliableDictionary2
- Merged PR by Jaah. Add support for
-
3.1.1
- Sign assembly
-
3.1.0
- Upgraded nuget packages (SF 2.8.232)
-
3.0.1
- Merged PR by esbenbach, fix
ActorStateManager
TryAddStateAsync
behavior not same as actual implementation. Added unit test.
- Merged PR by esbenbach, fix
-
3.0.0
- Merged PR by ralphcu
- Breaking change: list of past Transactions replaced by events (
MockTransactionChanged
) - Created Lock and LockManager classes to try to simulate the locking and blocking of SF transactions. Added unit tests.
- Created TransactedConcurrentDictionary class which is now used by MockReliableDictionary and MockReliableStateManager. Added unit tests. o OnStateManagerChanged is now fired on CommitAsync() of transaction used to add or remove. o OndictionaryChanged is now fired on CommitAsync() of transaction used for add, remove, update.
- Add transaction support to MockReliableQueue and MockReliableConcurrentQueue.
- Reworked MockreliableDictionary changes to work with above changes.
-
2.4.0
- Upgraded nuget packages (SF 2.8.219)
-
2.3.2
- Merged PR by huesie, fix exception type thrown for duplicate key in
MockReliableDictionary
. Added unit tests.
- Merged PR by huesie, fix exception type thrown for duplicate key in
-
2.3.1
- Merged PR by Izzmo, adding a list of past Transactions to the
MockReliableStateManager
. Added unit tests
- Merged PR by Izzmo, adding a list of past Transactions to the
-
2.3.0
- Merged PR by dotnetgator, upgrading to SF 2.8.211
-
2.2.4
- Added
InvokeOnPreActorMethodAsync
&InvokeOnPostActorMethodAsync
onActorBaseExtensions
, requested by JefSchraag.
- Added
-
2.2.4
- Fixed
MockActorStateManager
issue, when callingSetStateAsync
with different types for T. Found by samneirinck.
- Fixed
-
2.2.3
- Added
MockConfigurationPackage
to mock service configuration for CharlesZhong
- Added
-
2.2.2
- Upgraded nuget packages (SF 2.7.198)
-
2.2.1
- Allow MockActorServiceFactory to create several actors
-
2.2.0
- Upgraded nuget packages (SF 2.6.220, MSTest 1.1.18)
-
2.1.0
- Upgraded nuget packages (SF 2.6.210)
-
2.0.0
- Upgraded sln to VS2017
-
1.9.0
- Upgraded nuget packages (SF 2.6.204)
- ReliableConcurrentQueue no longer preview
-
1.8.1
- Fix issue in MockActorStateManager.AddStateAsync not throwing on duplicate keys, found by mackgyver2k.
-
1.8.0
- Added MockActorServiceRemotingClientFactory and MockActorServiceRemotingClient to mock the IServiceRemotingCallbackClient of ActorProxyFactory. (still looking for a way to mock remoting though)
- Added example use of MockActorEventSubscriptionHelper for VDBorovikov
-
1.7.0
- Upgraded nuget packages (SF 2.5.216)
-
1.6.3
- Merged PR by kotvisbj. Added 'MissingActor' event to MockActorProxyFactory, to dynamically resolve Actor instances if needed.
- Fixed some code quality issues.
-
1.6.2
- MockReliableConcurrentQueue Name property now has public get and set.
-
1.6.1
- merged PR by Scythen that sets the Name of a ReliableCollection when it's created.
-
1.6.0
- upgraded to new SDK (2.4.164)
- added MockActorEventSubscriptionHelper to assist with testing Actor Events, as suggested by ThiemeNL.
-
1.5.0
- Added support for custom ActorServices. (For andrejohansson) (See 'CustomActorServiceTests' for details on using custom ActorServices.)
- Added ActorServiceExtensions class to enable Actor activation from any ActorService implementation.
-
1.4.1
- Fixed issue in ActorStateManager TryGetStateAsync using valuetype, found by massimobonanni
-
1.4.0
- upgraded to new SDK (2.4.145)
-
1.3.2
- Add MockServicePartitionFactory to create mock service partitions.
- Add option to invoke OnActivateAsync while creating an Actor.
-
1.3.1
- Merged pull request from moswald to allow multiple instances of different Actor types share the same ActorId
-
1.3.0
- upgraded to new SDK (2.3.311)
-
1.2.0
- Merged pull request from WonderPanda
- add customizable service context factories
- add some unit test
-
1.1.0
- add MockActorStateProvider to unit test reminder registration (Note: Reminders are not automatically triggered by the mock.)
- add MockActorService with a method that creates Actor instances
- changed MockActorServiceFactory to support MockActorStateProvider and MockActorService
- add ReminderTimerActor to demo unit tests for timers and reminders (registration)
-
1.0.0
- upgraded to new SDK and packages (2.3.301)
-
0.9.4
- add MockActorProxyFactory, MockActorServiceFactory, MockStatelessServiceContextFactory
- added samples to Mock Service and Actor proxies.
-
0.9.3
- add support for the preview collection type 'IReliableConcurrentQueue' using MockReliableConcurrentQueue
-
0.9.2
- no longer preview
-
0.9.1-preview
- Fixed issue in MockReliableStateManager.
- Added unit tests.
-
0.9.0-preview
- First implementation.
[StatePersistence(StatePersistence.Persisted)]
public class MyStatefulActor : Actor, IMyStatefulActor
{
public MyStatefulActor(ActorService actorSerice, ActorId actorId)
: base(actorSerice, actorId)
{
}
public async Task InsertAsync(string stateName, Payload value)
{
await StateManager.AddStateAsync(stateName, value);
}
}
[DataContract]
public class Payload
{
[DataMember]
public readonly string Content;
public Payload(string content)
{
Content = content;
}
}
Create an instance using an ActorService with the MockActorStateManager and MockStatefulServiceContextFactory.Default
private const string StatePayload = "some value";
[TestMethod]
public async Task TestActorState()
{
var actorGuid = Guid.NewGuid();
var id = new ActorId(actorGuid);
var actor = CreateActor(id);
var stateManager = (MockActorStateManager)actor.StateManager;
const string stateName = "test";
var payload = new Payload(StatePayload);
//create state
await actor.InsertAsync(stateName, payload);
//get state
var actual = await stateManager.GetStateAsync<Payload>(stateName);
Assert.AreEqual(StatePayload, actual.Content);
}
internal static MyStatefulActor CreateActor(ActorId id)
{
Func<ActorService, ActorId, ActorBase> actorFactory = (service, actorId) => new MyStatefulActor(service, id);
var svc = MockActorServiceFactory.CreateActorServiceForActor<MyStatefulActor>(actorFactory);
var actor = svc.Activate(id);
return actor;
}
public class MyStatefulService : StatefulService, IMyStatefulService
{
public const string StateManagerDictionaryKey = "dictionaryname";
public const string StateManagerQueueKey = "queuename";
public const string StateManagerConcurrentQueueKey = "concurrentqueuename";
public MyStatefulService(StatefulServiceContext serviceContext) : base(serviceContext)
{
}
public MyStatefulService(StatefulServiceContext serviceContext, IReliableStateManagerReplica reliableStateManagerReplica)
: base(serviceContext, reliableStateManagerReplica)
{
}
public async Task InsertAsync(string stateName, Payload value)
{
var dictionary = await StateManager.GetOrAddAsync<IReliableDictionary<string, Payload>>(StateManagerDictionaryKey);
using (var tx = StateManager.CreateTransaction())
{
await dictionary.TryAddAsync(tx, stateName, value);
await tx.CommitAsync();
}
}
public async Task EnqueueAsync(Payload value)
{
var queue = await StateManager.GetOrAddAsync<IReliableQueue<Payload>>(StateManagerQueueKey);
using (var tx = StateManager.CreateTransaction())
{
await queue.EnqueueAsync(tx, value);
await tx.CommitAsync();
}
}
public async Task ConcurrentEnqueueAsync(Payload value)
{
var concurrentQueue = await StateManager.GetOrAddAsync<IReliableConcurrentQueue<Payload>>(StateManagerConcurrentQueueKey);
using (var tx = StateManager.CreateTransaction())
{
await concurrentQueue.EnqueueAsync(tx, value);
await tx.CommitAsync();
}
}
}
Create an instance using with the MockReliableStateManager and MockStatefulServiceContextFactory.Default
[TestMethod]
public async Task TestServiceState_Dictionary()
{
var context = MockStatefulServiceContextFactory.Default;
var stateManager = new MockReliableStateManager();
var service = new MyStatefulService(context, stateManager);
const string stateName = "test";
var payload = new Payload(StatePayload);
//create state
await service.InsertAsync(stateName, payload);
//get state
var dictionary = await stateManager.TryGetAsync<IReliableDictionary<string, Payload>>(MyStatefulService.StateManagerDictionaryKey);
var actual = (await dictionary.Value.TryGetValueAsync(null, stateName)).Value;
Assert.AreEqual(StatePayload, actual.Content);
}
[TestMethod]
public async Task TestServiceState_Queue()
{
var context = MockStatefulServiceContextFactory.Default;
var stateManager = new MockReliableStateManager();
var service = new MyStatefulService(context, stateManager);
var payload = new Payload(StatePayload);
//create state
await service.EnqueueAsync(payload);
//get state
var queue = await stateManager.TryGetAsync<IReliableQueue<Payload>>(MyStatefulService.StateManagerQueueKey);
var actual = (await queue.Value.TryPeekAsync(null)).Value;
Assert.AreEqual(StatePayload, actual.Content);
}
[TestMethod]
public async Task TestServiceState_ConcurrentQueue()
{
var context = MockStatefulServiceContextFactory.Default;
var stateManager = new MockReliableStateManager();
var service = new MyStatefulService(context, stateManager);
var payload = new Payload(StatePayload);
//create state
await service.ConcurrentEnqueueAsync(payload);
//get state
var queue = await stateManager.TryGetAsync<IReliableConcurrentQueue<Payload>>(MyStatefulService.StateManagerConcurrentQueueKey);
var actual = (await queue.Value.DequeueAsync(null));
Assert.AreEqual(StatePayload, actual.Content);
}
Works by injecting IServiceProxyFactory and/or IActorProxyFactory Mocks into Actors and Services. The factories will create Mock Proxies.
public class ActorCallerService : StatelessService
{
public static readonly Guid CalledActorId = Guid.Parse("{1F263E8C-78D4-4D91-AAE6-C4B9CE03D6EB}");
public IActorProxyFactory ProxyFactory { get; }
public ActorCallerService(StatelessServiceContext serviceContext, IActorProxyFactory proxyFactory = null)
: base(serviceContext)
{
ProxyFactory = proxyFactory ?? new ActorProxyFactory();
}
public async Task CallActorAsync()
{
var proxy = ProxyFactory.CreateActorProxy<IMyStatefulActor>(new ActorId(CalledActorId));
var value = new Payload("some other value");
await proxy.InsertAsync("test", value);
}
}
[TestMethod]
public async Task TestActorProxyFactory()
{
//mock out the called actor
var id = new ActorId(ActorCallerService.CalledActorId);
Func<ActorService, ActorId, ActorBase> actorFactory = (service, actorId) => new MockTestStatefulActor(service, id);
var svc = MockActorServiceFactory.CreateActorServiceForActor<MockTestStatefulActor>(actorFactory);
var actor = svc.Activate(id);
//prepare the service:
var mockProxyFactory = new MockActorProxyFactory();
mockProxyFactory.RegisterActor(actor);
var serviceInstance = new ActorCallerService(MockStatelessServiceContextFactory.Default, mockProxyFactory);
//act:
await serviceInstance.CallActorAsync();
//assert:
Assert.IsTrue(actor.InsertAsyncCalled);
}
private class MockTestStatefulActor : Actor, IMyStatefulActor
{
public bool InsertAsyncCalled { get; private set; }
public MockTestStatefulActor(ActorService actorService, ActorId actorId) : base(actorService, actorId)
{
}
public Task InsertAsync(string stateName, Payload value)
{
InsertAsyncCalled = true;
return Task.FromResult(true);
}
}
public class ServiceCallerActor : Actor, IMyStatefulActor
{
public static readonly Uri CalledServiceName = new Uri("fabric:/MockApp/MockStatefulService");
public IServiceProxyFactory ServiceProxyFactory { get; }
public ServiceCallerActor(ActorService actorService, ActorId actorId, IServiceProxyFactory serviceProxyFactory)
: base(actorService, actorId)
{
ServiceProxyFactory = serviceProxyFactory ?? new ServiceProxyFactory();
}
public Task InsertAsync(string stateName, Payload value)
{
var serviceProxy = ServiceProxyFactory.CreateServiceProxy<IMyStatefulService>(CalledServiceName, new ServicePartitionKey(0L));
return serviceProxy.InsertAsync(stateName, value);
}
}
[TestMethod]
public async Task TestServiceProxyFactory()
{
//mock out the called service
var mockProxyFactory = new MockServiceProxyFactory();
var mockService = new MockTestStatefulService();
mockProxyFactory.RegisterService(ServiceCallerActor.CalledServiceName, mockService);
//prepare the actor:
Func<ActorService, ActorId, ActorBase> actorFactory = (service, actorId) => new ServiceCallerActor(service, actorId, mockProxyFactory);
var svc = MockActorServiceFactory.CreateActorServiceForActor<ServiceCallerActor>(actorFactory);
var actor = svc.Activate(ActorId.CreateRandom());
//act:
await actor.InsertAsync("test", new Payload("some other value"));
//assert:
Assert.IsTrue(mockService.InsertAsyncCalled);
}
private class MockTestStatefulService : IMyStatefulService
{
public bool InsertAsyncCalled { get; private set; }
public Task ConcurrentEnqueueAsync(Payload value)
{
throw new NotImplementedException();
}
public Task EnqueueAsync(Payload value)
{
throw new NotImplementedException();
}
public Task InsertAsync(string stateName, Payload value)
{
InsertAsyncCalled = true;
return Task.FromResult(true);
}
}
An actor is created from the ActorCallerActor and we need to test that it is there and that its state was set.
public class ActorCallerActor : Actor, IMyStatefulActor
{
public static readonly Uri CalledServiceName = new Uri("fabric:/MockApp/MyStatefulActor");
public const string ChildActorIdKeyName = "ChildActorIdKeyName";
public IActorProxyFactory ActorProxyFactory { get; }
public ActorCallerActor(ActorService actorService, ActorId actorId, IActorProxyFactory actorProxyFactory)
: base(actorService, actorId)
{
ActorProxyFactory = actorProxyFactory ?? new ActorProxyFactory();
}
public Task InsertAsync(string stateName, Payload value)
{
var actorProxy = ActorProxyFactory.CreateActorProxy<IMyStatefulActor>(CalledServiceName, new ActorId(Guid.NewGuid()));
this.StateManager.SetStateAsync(ChildActorIdKeyName, actorProxy.GetActorId());
return actorProxy.InsertAsync(stateName, value);
}
}
Here a callback is used when the actor is requested and not found that will allow you to create it with the identifier defined in the original actor. So you can test it.
[TestMethod]
public async Task TestServiceProxyFactory()
{
//mock out the called service
var mockProxyFactory = new MockActorProxyFactory();
mockProxyFactory.MissingActor += MockProxyFactory_MissingActorId;
//prepare the actor:
Func<ActorService, ActorId, ActorBase> actorFactory = (service, actorId) => new ActorCallerActor(service, actorId, mockProxyFactory);
var svc = MockActorServiceFactory.CreateActorServiceForActor<ActorCallerActor>(actorFactory);
var actor = svc.Activate(ActorId.CreateRandom());
//act:
await actor.InsertAsync("test", new Payload("some other value"));
//check if the other actor was called
var statefulActorId = await actor.StateManager.GetStateAsync<ActorId>(ActorCallerActor.ChildActorIdKeyName);
Func<ActorService, ActorId, ActorBase> statefulActorFactory = (service, actorId) => new MyStatefulActor(service, actorId);
var statefulActor = mockProxyFactory.CreateActorProxy<IMyStatefulActor>(ActorCallerActor.CalledServiceName, statefulActorId);
var payload = await ((MyStatefulActor)statefulActor).StateManager.GetStateAsync<Payload>("test");
//assert:
Assert.AreEqual("some other value", payload.Content);
}
private void MockProxyFactory_MissingActorId(object sender, MissingActorEventArgs args)
{
var registrar = (MockActorProxyFactory)sender;
Func<ActorService, ActorId, ActorBase> actorFactory = (service, actorId) => new MyStatefulActor(service, actorId);
var svc = MockActorServiceFactory.CreateActorServiceForActor<MyStatefulActor>(actorFactory);
var actor = svc.Activate(args.Id);
registrar.RegisterActor(actor);
}
public class ReminderTimerActor : Actor, IRemindable, IReminderTimerActor
{
public ReminderTimerActor(ActorService actorService, ActorId actorId) : base(actorService, actorId)
{
}
public Task RegisterReminderAsync(string reminderName)
{
return RegisterReminderAsync(reminderName, null, TimeSpan.Zero, TimeSpan.FromMilliseconds(-1));
}
public Task ReceiveReminderAsync(string reminderName, byte[] context, TimeSpan dueTime, TimeSpan period)
{
//will not be called automatically.
return Task.FromResult(true);
}
public Task RegisterTimerAsync()
{
RegisterTimer(TimerCallbackAsync, null, TimeSpan.Zero, TimeSpan.FromMilliseconds(-1));
return Task.FromResult(true);
}
private Task TimerCallbackAsync(object state)
{
//will not be called automatically.
return Task.FromResult(true);
}
}
[TestMethod]
public async Task TestActorReminderRegistration()
{
var svc = MockActorServiceFactory.CreateActorServiceForActor<ReminderTimerActor>();
var actor = svc.Activate(new ActorId(Guid.NewGuid()));
string reminderName = "reminder";
//setup
await actor.RegisterReminderAsync(reminderName);
//assert
var reminderCollection = actor.GetActorReminders(); //extension method
bool hasReminder = reminderCollection.Any();
Assert.IsTrue(hasReminder);
}
[TestMethod]
public async Task TestActorTimerRegistration()
{
var svc = MockActorServiceFactory.CreateActorServiceForActor<ReminderTimerActor>();
var actor = svc.Activate(new ActorId(Guid.NewGuid()));
//setup
await actor.RegisterTimerAsync();
//assert
var timers = actor.GetActorTimers(); //extension method
bool hasTimer = timers.Any();
Assert.IsTrue(hasTimer);
}
You can use a custom ActorService implementations to create your Actor instances.
public class CustomActorService : ActorService
{
//no additional constructor parameters
public CustomActorService(StatefulServiceContext context, ActorTypeInformation actorTypeInfo, Func<ActorService, ActorId,
ActorBase> actorFactory = null, Func<ActorBase, IActorStateProvider, IActorStateManager> stateManagerFactory = null,
IActorStateProvider stateProvider = null, ActorServiceSettings settings = null) : base(context, actorTypeInfo,
actorFactory, stateManagerFactory, stateProvider, settings)
{
}
}
//an ActorService with a standard constructor can be created by the MockActorServiceFactory
var customActorService = MockActorServiceFactory.CreateCustomActorServiceForActor<CustomActorService, OnActivateActor>();
var actor = customActorService.Activate<OnActivateActor>(new ActorId(123L));
Assert.IsInstanceOfType(customActorService, typeof(CustomActorService));
Assert.IsInstanceOfType(actor, typeof(OnActivateActor));
Assert.AreEqual(123L, actor.Id.GetLongId());
In this situation you can't use the MockActorServiceFactory, so you'll need to create an instance directly.
//an ActorService with a NON standard constructor can be created by passing Mock arguments:
var stateManager = new MockActorStateManager();
Func<ActorBase, IActorStateProvider, IActorStateManager> stateManagerFactory = (actr, stateProvider) => stateManager;
IActorStateProvider actorStateProvider = new MockActorStateProvider();
actorStateProvider.Initialize(ActorTypeInformation.Get(typeof(OnActivateActor)));
var context = MockStatefulServiceContextFactory.Default;
var dummy = new object(); //this argument causes the 'non standard' ctor.
var customActorService = new AnotherCustomActorService(dummy, context, ActorTypeInformation.Get(typeof(OnActivateActor)));
var actor = customActorService.Activate<OnActivateActor>(new ActorId(123L));
Assert.IsInstanceOfType(actor, typeof(OnActivateActor));
Assert.AreEqual(123L, actor.Id.GetLongId());
To inject a configuration section into the MockCodePackageActivationContext, you can use this code:
[TestClass]
public class ConfigurationPackageTests
{
[TestMethod]
public void ConfigurationPackageAtMockCodePackageActivationContextTest()
{
//build ConfigurationSectionCollection
var configSections = new ConfigurationSectionCollection();
//Build ConfigurationSettings
var configSettings = CreateConfigurationSettings(configSections);
//add one ConfigurationSection
ConfigurationSection configSection = CreateConfigurationSection(nameof(configSection.Name));
configSections.Add(configSection);
//add one Parameters entry
ConfigurationProperty parameter = CreateConfigurationSectionParameters(nameof(parameter.Name), nameof(parameter.Value));
configSection.Parameters.Add(parameter);
//Build ConfigurationPackage
ConfigurationPackage configPackage = CreateConfigurationPackage(configSettings, nameof(configPackage.Path));
[..]
}
}
}