GrainService

1. Documentation
2. API reference
3. Microsoft.Orleans.Runtime
4. GrainService

class

Namespace: Orleans.Runtime

NuGetSourceMarkdown

Base class for implementing a grain-like partitioned service with per silo instances of it automatically instantiated and started by silo runtime

public abstract class GrainService : SystemTarget, ISystemTarget, IRingRangeListener, IAddressable, IGrainService

Constructors

• GrainServiceOnly to make Reflection happy. Do not use it in your implementation
• GrainService(GrainId, Silo, ILoggerFactory)Constructor to use for grain services

Properties

• RangeSerialNumberGets the monotonically increasing serial number of the version of the ring range owned by the grain service instance
• RingRangeGets the range of the partitioning ring currently owned by the grain service instance
• StatusGets the status of the grain service instance
• StoppedCancellationTokenSourceGets the token for signaling cancellation upon stopping of grain service

Methods

• Init(IServiceProvider) Invoked upon initialization of the service
• OnRangeChange(IRingRange, IRingRange, bool) Invoked when the ring range owned by the service instance changes because of a change in the cluster state
• StartInvoked when service is being started
• StartInBackground Deferred part of initialization that executes after the service is already started (to speed up startup). Sets Status to Started.
• StopInvoked when service is being stopped