Trait Driver

pub trait Driver
where
    Self: 'static + Any + Downcast + DowncastSync + Send + Sync,
{
    // Provided methods
    fn call(&self, func: &str, value: &Resource) -> Result<(), RuntimeError> { ... }
    fn with(&self, value: &Resource) -> Result<Option<ArcDriver>, RuntimeError> { ... }
    fn status(&self) -> Result<DriverState, RuntimeError> { ... }
    fn hibernate(&self) -> Result<(), RuntimeError> { ... }
    fn wake_up(&self) -> Result<(), RuntimeError> { ... }
    fn enter(&self) -> Result<(), RuntimeError> { ... }
    fn exit(&self) -> Result<(), RuntimeError> { ... }
}

Provided Methods

fn call(&self, func: &str, value: &Resource) -> Result<(), RuntimeError>

fn with(&self, value: &Resource) -> Result<Option<ArcDriver>, RuntimeError>

fn status(&self) -> Result<DriverState, RuntimeError>

Load the driver’s current state.

If there is a shortage of physical resources, hibernate drivers that are not needed.

fn hibernate(&self) -> Result<(), RuntimeError>

Hibernate the driver.

The hibernating driver must unload the heavy data from memory and be able to reload it in the wake.

fn wake_up(&self) -> Result<(), RuntimeError>

Wake the hibernating driver.

note: This function will never be called if it is already awake.

fn enter(&self) -> Result<(), RuntimeError>

Inform the driver that a work will use it.

fn exit(&self) -> Result<(), RuntimeError>

Inform the driver that the work is completed.

Implementations

impl dyn Driver

pub fn is<__T: Driver>(&self) -> bool

Returns true if the trait object wraps an object of type __T.

pub fn downcast<__T: Driver>(self: Box<Self>) -> Result<Box<__T>, Box<Self>>

Returns a boxed object from a boxed trait object if the underlying object is of type __T. Returns the original boxed trait if it isn’t.

pub fn downcast_rc<__T: Driver>(self: Rc<Self>) -> Result<Rc<__T>, Rc<Self>>

Returns an Rc-ed object from an Rc-ed trait object if the underlying object is of type __T. Returns the original Rc-ed trait if it isn’t.

pub fn downcast_ref<__T: Driver>(&self) -> Option<&__T>

Returns a reference to the object within the trait object if it is of type __T, or None if it isn’t.

pub fn downcast_mut<__T: Driver>(&mut self) -> Option<&mut __T>

Returns a mutable reference to the object within the trait object if it is of type __T, or None if it isn’t.

pub fn downcast_arc<__T: Driver + Any + Send + Sync>( self: Arc<Self>, ) -> Result<Arc<__T>, Arc<Self>>

Returns an Arc-ed object from an Arc-ed trait object if the underlying object is of type __T. Returns the original Arc-ed trait if it isn’t.

Implementors