Class SubscriptionRoster
- Namespace
- Excalibur.EventSourcing.Subscriptions
- Assembly
- Excalibur.EventSourcing.dll
Every projection a subscription is bound to, as the durable store holds it.
public sealed record SubscriptionRoster : IEquatable<SubscriptionRoster>
- Inheritance
-
SubscriptionRoster
- Implements
- Inherited Members
Remarks
THE ROSTER IS A PROPERTY OF THE SUBSCRIPTION, NOT OF THE PROCESS, and that is the whole reason this type is returned rather than the binding simply succeeding or throwing. Any attestation quantified over "every registration" -- the freshness a returning save reports -- is honest only while the quantifier's domain is read from the durable store. Computed instead from the local registry, the attestation narrows silently to whatever this process happens to host: a save folds the projections it can see, reports fresh, and says nothing about a sibling bound by another deployment that has not folded the same events. Nothing downstream can detect that, because the caller was told it need not re-check.
Constructors
SubscriptionRoster(string, IReadOnlyList<SubscriptionMember>)
Every projection a subscription is bound to, as the durable store holds it.
public SubscriptionRoster(string SubscriptionName, IReadOnlyList<SubscriptionMember> Members)
Parameters
SubscriptionNamestringThe stable subscription name the roster belongs to.
MembersIReadOnlyList<SubscriptionMember>Every bound member, INCLUDING any the caller did not supply. That inclusion is the point of this type: a member present in the store and absent from the calling process is work this process cannot perform and therefore cannot attest, and it can only be accounted for if the caller is told it exists.
Remarks
THE ROSTER IS A PROPERTY OF THE SUBSCRIPTION, NOT OF THE PROCESS, and that is the whole reason this type is returned rather than the binding simply succeeding or throwing. Any attestation quantified over "every registration" -- the freshness a returning save reports -- is honest only while the quantifier's domain is read from the durable store. Computed instead from the local registry, the attestation narrows silently to whatever this process happens to host: a save folds the projections it can see, reports fresh, and says nothing about a sibling bound by another deployment that has not folded the same events. Nothing downstream can detect that, because the caller was told it need not re-check.
Properties
Identity
Gets a fingerprint of the roster's member lifetimes, independent of their progress.
public string Identity { get; }
Property Value
- string
A SHA-256 digest of the sorted keys and binding identifiers.
Members
Every bound member, INCLUDING any the caller did not supply. That inclusion is the point of this type: a member present in the store and absent from the calling process is work this process cannot perform and therefore cannot attest, and it can only be accounted for if the caller is told it exists.
public IReadOnlyList<SubscriptionMember> Members { get; init; }
Property Value
SubscriptionName
The stable subscription name the roster belongs to.
public string SubscriptionName { get; init; }