Struct Registry 

pub struct Registry { /* private fields */ }

Registry of guest resources.

Implementations

impl Registry

pub fn new() -> Arc<Self>

Create a new registry.

pub fn instance(self: &Arc<Self>) -> Result<InstanceRegistry, RegistryError>

Create an InstanceRegistry view tied to this registry.

pub fn add<T: Send + 'static>( &self, resource: T, owner: Option<ResourceId>, kind: ResourceType, ) -> Result<ResourceHandle<T>, RegistryError>

Add a resource to the registry and return its typed handle.

pub fn reserve( &self, owner: Option<ResourceId>, kind: ResourceType, ) -> Result<ResourceId, RegistryError>

Reserve a slot for a resource and return its identifier.

pub fn initialise<T: Send + 'static>( &self, id: ResourceId, resource: T, ) -> Result<ResourceHandle<T>, RegistryError>

Initialise a reserved slot with the given resource.

pub fn remove<T: 'static>(&self, id: ResourceHandle<T>) -> Option<T>

Remove a resource from the registry, returning ownership.

pub fn discard(&self, id: ResourceId) -> bool

Discard a resource entry without attempting to downcast its payload.

pub fn with<T: 'static, R>( &self, id: ResourceHandle<T>, func: impl FnOnce(&mut T) -> R, ) -> Option<R>

Borrow a resource mutably by erased handle and run a closure with it.

pub fn share_handle( &self, id: ResourceId, ) -> Result<GuestResourceId, RegistryError>

Create or retrieve a shared guest handle for the resource id.

pub fn resolve_shared(&self, handle: GuestResourceId) -> Option<ResourceId>

Resolve a shared guest handle into its resource id.

pub fn shared_handle(&self, id: ResourceId) -> Option<GuestResourceId>

Return the shared guest handle for a resource id, if one exists.

pub fn metadata(&self, id: ResourceId) -> Option<ResourceMetadata>

Fetch metadata for a resource.

pub fn owner(&self, id: ResourceId) -> Option<ResourceId>

Return the recorded owner for a resource.

pub fn owned_resources(&self, owner: ResourceId) -> Vec<ResourceId>

Return the resources owned by the provided resource id.

pub fn parent(&self, id: ResourceId) -> Option<ResourceId>

Return the recorded parent for a resource.

pub fn children(&self, id: ResourceId) -> Vec<ResourceId>

Return the children linked to the provided resource id.

pub fn instance_process(&self, instance_id: ResourceId) -> Option<ResourceId>

Return the process id associated with the provided instance id.

pub fn process_instance(&self, process_id: ResourceId) -> Option<ResourceId>

Return the instance id associated with the provided process id.

pub fn log_channel(&self, process_id: ResourceId) -> Option<ResourceId>

Return the registered log channel resource for the process, if present.

pub fn log_channel_handle( &self, process_id: ResourceId, ) -> Option<GuestResourceId>

Return the registered log channel handle for the process, if present.

pub fn register_singleton( &self, id: DependencyId, resource: ResourceId, ) -> Result<bool, RegistryError>

Register a singleton dependency identifier against the supplied resource.

Returns false if the identifier or resource is already registered.

pub fn singleton(&self, id: DependencyId) -> Option<ResourceId>

Resolve a singleton dependency identifier to its backing resource id.