Struct ResourceHandle 

pub struct ResourceHandle {
    pub module: String,
    pub type_name: String,
    pub id: u64,
    pub task_safe: bool,
}

The identity of one resource a host owns.

ADR 0013: a handle is a name. Every field here is part of the name and none of them is state — module and type_name say what kind of thing is named, id says which one, and task_safe is the schema’s answer copied onto the handle so the task boundary can read it without a registry.

That is why a handle is Arc-shared and immutable: copying one copies a name, two tasks holding it name the same resource, and a trace that records it records something a replay can reproduce exactly.

Fields

module: String

The host module that issued this handle, such as database.

type_name: String

The resource kind, such as Connection.

id: u64

Which resource of that kind, unique among the ones this host issued.

task_safe: bool

Whether this handle may cross a task boundary, copied from the resource’s ResourceSchema when the handle was issued.

Implementations

impl ResourceHandle

pub fn new( module: &str, resource: &ResourceSchema, id: u64, ) -> Arc<ResourceHandle>

Issues a handle for resource id of kind resource in module.

pub fn qualified_type(&self) -> String

The type as Cove source writes it: database.Connection.

pub fn names_same(&self, other: &ResourceHandle) -> bool

Whether two handles name the same resource.

Trait Implementations

impl Clone for ResourceHandle

fn clone(&self) -> ResourceHandle

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ResourceHandle

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for ResourceHandle

A handle shows as the name it is: the type, and which one.

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for ResourceHandle

impl PartialEq for ResourceHandle

fn eq(&self, other: &ResourceHandle) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for ResourceHandle