Table of Contents

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

SubscriptionName string

The stable subscription name the roster belongs to.

Members IReadOnlyList<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

IReadOnlyList<SubscriptionMember>

SubscriptionName

The stable subscription name the roster belongs to.

public string SubscriptionName { get; init; }

Property Value

string