class
Di::Registry
- Di::Registry
- Reference
- Object
Overview
Internal registry for storing providers and tracking shutdown order. Uses a string key format: "TypeName" for default, "TypeName/name" for named providers. For interface bindings, uses "TypeName:ImplName" to allow multiple implementations. Thread-safe for multi-threaded Crystal (-Dpreview_mt).
Defined in:
di/registry.crClass Method Summary
-
.interface_key(interface_type : String, impl_type : String) : String
Build an interface binding key from interface and implementation types.
-
.key(type_name : String, service_name : String | Nil = nil) : String
Build a registry key from type name and optional service name.
Instance Method Summary
-
#clear : Nil
Clear all providers and reset order.
-
#count_implementations(interface_type : String) : Int32
Count implementations for an interface type.
-
#delete(key : String) : Nil
Remove a provider by key (used for rollback on partial registration failure).
-
#each(& : String, Provider::Base -> )
Iterate over all providers with their keys.
-
#get(key : String) : Provider::Base
Get a provider by key, raising ServiceNotFound if not registered.
-
#get?(key : String) : Provider::Base | Nil
Get a provider by key, or nil if not registered.
-
#get_all(interface_type : String) : Array(Provider::Base)
Get all providers for an interface type (keys starting with "Type:").
-
#get_all_keyed(interface_type : String) : Hash(String, Provider::Base)
Get all providers keyed by full key for deduplication in child scopes.
-
#implementation_names(interface_type : String) : Array(String)
Get implementation names for an interface type.
-
#order : Array(String)
Return all registered keys in registration order.
-
#register(key : String, provider : Provider::Base) : Nil
Register a provider with the given key.
-
#register_interface(interface_type : String, impl_type : String, provider : Provider::Base) : Nil
Register an interface binding with implementation tracking.
-
#registered?(key : String) : Bool
Check if a provider is registered for the given key.
-
#reverse_order : Array(String)
Return all registered keys in reverse order (for shutdown).
-
#size : Int32
Number of registered providers.
-
#snapshot : Hash(String, Provider::Base)
Return a snapshot of all providers for iteration without holding mutex.
Class Method Detail
Build an interface binding key from interface and implementation types.
Build a registry key from type name and optional service name.
Instance Method Detail
Count implementations for an interface type.
Remove a provider by key (used for rollback on partial registration failure).
Iterate over all providers with their keys. Note: Holds mutex for the duration of iteration.
Get a provider by key, raising ServiceNotFound if not registered.
Get all providers for an interface type (keys starting with "Type:"). Returns array of providers matching the interface prefix.
Get all providers keyed by full key for deduplication in child scopes.
Get implementation names for an interface type.
Register a provider with the given key. Raises AlreadyRegistered if the key already exists.
Register an interface binding with implementation tracking. Uses "InterfaceType:ImplType" key format to allow multiple implementations. Does NOT raise for duplicate interface type — multiple impls are tracked.
Return a snapshot of all providers for iteration without holding mutex. Use this when callbacks may call back into Di (e.g., health checks).