Class ProtoRegistrationGuard

Namespace

ProtoTest.Core

Assembly

ProtoTest.Core.dll

The public facade for the one internal once-only rule (ProtoRegistration): first registration wins, later calls are no-ops. The guard reads through that helper for a service collection, a marker with the caller's own identity rule, and a builder that keeps its marker out of DI, so an integration's idempotency cannot drift from Core's.

public static class ProtoRegistrationGuard

Inheritance

object

ProtoRegistrationGuard

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Methods

Find<TMarker>(IServiceCollection, Func<TMarker, bool>)

Returns the registered marker instance matching matches, or null. The read half of the once-only rule: a later caller can observe the registration that won instead of deriving it again.

public static TMarker? Find<TMarker>(IServiceCollection services, Func<TMarker, bool> matches) where TMarker : class

Parameters

services IServiceCollection

matches Func<TMarker, bool>

Returns

TMarker

Type Parameters

TMarker

TryRegisterOnce<TMarker>(IServiceCollection)

Registers TMarker once and reports whether this call won. The marker is the integration's own type, so its presence means exactly "this integration registered".

public static bool TryRegisterOnce<TMarker>(IServiceCollection services) where TMarker : class

Parameters

services IServiceCollection

Returns

bool

Type Parameters

TMarker

TryRegisterOnce<TMarker>(IServiceCollection, TMarker, Func<TMarker, bool>)

Registers marker once and reports whether this call won. matches is the caller's identity rule and decides what "already registered" means, so an integration whose identity is a value - a target name, a transport - guards repeats the same way the type-marker form does.

public static bool TryRegisterOnce<TMarker>(IServiceCollection services, TMarker marker, Func<TMarker, bool> matches) where TMarker : class

Parameters

services IServiceCollection

marker TMarker

matches Func<TMarker, bool>

Returns

bool

Type Parameters

TMarker

TryRegisterOnce<TBuilder>(ConditionalWeakTable<TBuilder, object>, TBuilder)

The same rule for a builder whose marker lives in a weak table instead of the collection.

public static bool TryRegisterOnce<TBuilder>(ConditionalWeakTable<TBuilder, object> registrations, TBuilder builder) where TBuilder : class

Parameters

registrations ConditionalWeakTable<TBuilder, object>

builder TBuilder

Returns

bool

Type Parameters

TBuilder