Skip to main content

Poa

Struct Poa 

Source
pub struct Poa { /* private fields */ }
Expand description

PortableServer::POA: an object adapter, with its active object map and its child POAs.

A cheap handle; clones refer to the same POA.

Implementations§

Source§

impl Poa

Source

pub fn the_name(&self) -> &str

the_name.

Source

pub fn the_parent(&self) -> Option<Poa>

the_parent; None for the RootPOA.

Source

pub fn the_children(&self) -> Vec<Poa>

the_children, in no particular order.

Source

pub fn the_poa_manager(&self) -> PoaManager

the_POAManager.

Source

pub fn policies(&self) -> Policies

The policies of the POA.

Source

pub fn create_poa( &self, name: &str, manager: Option<&PoaManager>, policies: &[Policy], ) -> Result<Poa, PoaError>

create_POA: a child POA named name, managed by manager or, if None, by a new manager. Policies not in policies take their default values (not those of this POA). Inconsistent policies fail with InvalidPolicy, and a name containing NUL with BAD_PARAM.

Source

pub fn find_poa(&self, name: &str, activate_it: bool) -> Result<Poa, PoaError>

find_POA: the child name. With activate_it, a missing child is asked of the adapter activator, if the POA has one.

Source

pub fn the_activator(&self) -> Option<Arc<dyn AdapterActivator>>

the_activator.

Source

pub fn set_the_activator( &self, activator: Option<Arc<dyn AdapterActivator>>, ) -> Result<(), PoaError>

the_activator (set): the adapter activator for unknown children, or none.

Source

pub fn get_servant_manager(&self) -> Result<Option<ServantManager>, PoaError>

get_servant_manager (USE_SERVANT_MANAGER only).

Source

pub fn set_servant_manager( &self, manager: ServantManager, ) -> Result<(), PoaError>

set_servant_manager (USE_SERVANT_MANAGER only): a ServantActivator with RETAIN, a ServantLocator with NON_RETAIN (otherwise OBJ_ADAPTER). It can be set once (BAD_INV_ORDER after that).

Source

pub fn get_servant(&self) -> Result<Arc<dyn Servant>, PoaError>

get_servant: the default servant (USE_DEFAULT_SERVANT only).

Source

pub fn set_servant(&self, servant: Arc<dyn Servant>) -> Result<(), PoaError>

set_servant: the default servant (USE_DEFAULT_SERVANT only), which runs the requests for objects not in the active object map.

Source

pub fn destroy( &self, etherealize: bool, wait_for_completion: bool, ) -> Result<(), PoaError>

destroy: destroys the POA and its descendants and drops their servants. Requests already running finish; later ones get OBJECT_NOT_EXIST. With etherealize, the objects of POAs with a ServantActivator are etherealized once their requests have finished. With wait_for_completion, returns once the running requests of this POA have finished and the objects are etherealized (BAD_INV_ORDER when called from a servant).

Source

pub fn activate_object( &self, servant: Arc<dyn Servant>, ) -> Result<ObjectId, PoaError>

activate_object: activates servant under a new ObjectId (SYSTEM_ID and RETAIN only).

Source

pub fn activate_object_with_id( &self, id: &[u8], servant: Arc<dyn Servant>, ) -> Result<(), PoaError>

activate_object_with_id (RETAIN only).

Source

pub fn deactivate_object(&self, id: &[u8]) -> Result<(), PoaError>

deactivate_object (RETAIN only): requests already running finish; later ones get OBJECT_NOT_EXIST, or incarnate the object again with a ServantActivator. The activator’s etherealize is called on an upcall thread once the running requests have finished; this does not wait for it.

Source

pub fn servant_to_id( &self, servant: &Arc<dyn Servant>, ) -> Result<ObjectId, PoaError>

servant_to_id: the ObjectId of an active servant (UNIQUE_ID), a new one with IMPLICIT_ACTIVATION, or, for the default servant inside a request it runs, the ObjectId of that request.

Source

pub fn servant_to_reference( &self, servant: &Arc<dyn Servant>, ) -> Result<ObjectRef, PoaError>

servant_to_reference, activating the servant like servant_to_id.

Source

pub fn id_to_servant(&self, id: &[u8]) -> Result<Arc<dyn Servant>, PoaError>

id_to_servant (RETAIN or USE_DEFAULT_SERVANT): the servant active under id, or else the default servant.

Source

pub fn id_to_reference(&self, id: &[u8]) -> Result<ObjectRef, PoaError>

id_to_reference (RETAIN only): a reference to the active object id, with the servant’s repository id as type id.

Source

pub fn create_reference(&self, intf: &str) -> Result<ObjectRef, PoaError>

create_reference: a reference with a new ObjectId and the type id intf, without activating anything (SYSTEM_ID only).

Source

pub fn create_reference_with_id( &self, id: &[u8], intf: &str, ) -> Result<ObjectRef, PoaError>

create_reference_with_id: a reference to id with the type id intf, without activating anything.

Source

pub fn reference_to_id( &self, reference: &ObjectRef, ) -> Result<ObjectId, PoaError>

reference_to_id: the ObjectId of a reference made by this POA (WrongAdapter for any other).

Source

pub fn reference_to_servant( &self, reference: &ObjectRef, ) -> Result<Arc<dyn Servant>, PoaError>

reference_to_servant.

Trait Implementations§

Source§

impl Clone for Poa

Source§

fn clone(&self) -> Self

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for Poa

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Eq for Poa

Source§

impl PartialEq for Poa

Source§

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

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more

Auto Trait Implementations§

§

impl !RefUnwindSafe for Poa

§

impl !UnwindSafe for Poa

§

impl Freeze for Poa

§

impl Send for Poa

§

impl Sync for Poa

§

impl Unpin for Poa

§

impl UnsafeUnpin for Poa

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.