SubsystemInstanceRegistry class

Central registry managing subsystem singleton instances across all SubsystemTypeDesc categories.

Orchestrates the initialization, dependency ordering, and teardown of subsystems.

Constructors

SubsystemInstanceRegistry()

Properties

hashCode → int

The hash code for this object.

no setter, inherited

runtimeType → Type

A representation of the runtime type of the object.

no setter, inherited

Methods

noSuchMethod(Invocation invocation) → dynamic

Invoked when a nonexistent method or property is accessed.

inherited

toString() → String

A string representation of this object.

inherited

Operators

operator ==(Object other) → bool

The equality operator.

inherited

Static Properties

lastFailedRegistrations → List<BuildServiceParameters>

Returns an unmodifiable list of parameters that failed to build or initialize during the last buildInstances executions.

no setter

onLifecycleError ↔ void Function(Object error, StackTrace stackTrace)?

Configurable handler for non-fatal lifecycle errors.

getter/setter pair

Static Methods

allInstancesOfClass<TSubsystem>() → List<TSubsystem>

All active subsystem instances matching TSubsystem, across every registered SubsystemTypeDesc — not scoped to a single type.

allInstancesWhere(bool predicate(Subsystem instance)) → List<Subsystem>

All active subsystem instances across every registered SubsystemTypeDesc matching predicate — not scoped to a single type.

buildInstances<TSubsystem extends Subsystem>(List<BuildServiceParameters> paramsList, {bool atomicBatch = false}) → Future<List<TSubsystem>>

Builds and initializes a batch of subsystems defined by paramsList.

clearAll() → Future<void>

Clears all registered subsystems across all types and resets registries.

clearFailedRegistrations() → void

Clears the history of failed registrations.

clearType(String typeId) → Future<void>

Clears all subsystems of a given type and disposes its type context.

findRegistryForTypeId(String typeId) → SubsystemInstanceRegistryByTypeDesc?

Finds the registry associated with typeId.

findSubsystemByIds<TSubsystem extends Subsystem>(String typeId, String classId) → TSubsystem?

Finds a subsystem singleton by its type and class IDs.

findSubsystemByIdsChecked<TSubsystem extends Subsystem>(String typeId, String classId) → TSubsystem

Finds a subsystem singleton or throws SubsystemNotFoundException if absent.

removeSubsystemByIds(String typeId, String classId) → Future<void>

Unregisters and disposes a subsystem by its type and class IDs.