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
impl Poa
Sourcepub fn the_parent(&self) -> Option<Poa>
pub fn the_parent(&self) -> Option<Poa>
the_parent; None for the RootPOA.
Sourcepub fn the_children(&self) -> Vec<Poa>
pub fn the_children(&self) -> Vec<Poa>
the_children, in no particular order.
Sourcepub fn the_poa_manager(&self) -> PoaManager
pub fn the_poa_manager(&self) -> PoaManager
the_POAManager.
Sourcepub fn create_poa(
&self,
name: &str,
manager: Option<&PoaManager>,
policies: &[Policy],
) -> Result<Poa, PoaError>
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.
Sourcepub fn find_poa(&self, name: &str, activate_it: bool) -> Result<Poa, PoaError>
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.
Sourcepub fn the_activator(&self) -> Option<Arc<dyn AdapterActivator>>
pub fn the_activator(&self) -> Option<Arc<dyn AdapterActivator>>
the_activator.
Sourcepub fn set_the_activator(
&self,
activator: Option<Arc<dyn AdapterActivator>>,
) -> Result<(), PoaError>
pub fn set_the_activator( &self, activator: Option<Arc<dyn AdapterActivator>>, ) -> Result<(), PoaError>
the_activator (set): the adapter activator for unknown children,
or none.
Sourcepub fn get_servant_manager(&self) -> Result<Option<ServantManager>, PoaError>
pub fn get_servant_manager(&self) -> Result<Option<ServantManager>, PoaError>
get_servant_manager (USE_SERVANT_MANAGER only).
Sourcepub fn set_servant_manager(
&self,
manager: ServantManager,
) -> Result<(), PoaError>
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).
Sourcepub fn get_servant(&self) -> Result<Arc<dyn Servant>, PoaError>
pub fn get_servant(&self) -> Result<Arc<dyn Servant>, PoaError>
get_servant: the default servant (USE_DEFAULT_SERVANT only).
Sourcepub fn set_servant(&self, servant: Arc<dyn Servant>) -> Result<(), PoaError>
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.
Sourcepub fn destroy(
&self,
etherealize: bool,
wait_for_completion: bool,
) -> Result<(), PoaError>
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).
Sourcepub fn activate_object(
&self,
servant: Arc<dyn Servant>,
) -> Result<ObjectId, PoaError>
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).
Sourcepub fn activate_object_with_id(
&self,
id: &[u8],
servant: Arc<dyn Servant>,
) -> Result<(), PoaError>
pub fn activate_object_with_id( &self, id: &[u8], servant: Arc<dyn Servant>, ) -> Result<(), PoaError>
activate_object_with_id (RETAIN only).
Sourcepub fn deactivate_object(&self, id: &[u8]) -> Result<(), PoaError>
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.
Sourcepub fn servant_to_id(
&self,
servant: &Arc<dyn Servant>,
) -> Result<ObjectId, PoaError>
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.
Sourcepub fn servant_to_reference(
&self,
servant: &Arc<dyn Servant>,
) -> Result<ObjectRef, PoaError>
pub fn servant_to_reference( &self, servant: &Arc<dyn Servant>, ) -> Result<ObjectRef, PoaError>
servant_to_reference, activating the servant like
servant_to_id.
Sourcepub fn id_to_servant(&self, id: &[u8]) -> Result<Arc<dyn Servant>, PoaError>
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.
Sourcepub fn id_to_reference(&self, id: &[u8]) -> Result<ObjectRef, PoaError>
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.
Sourcepub fn create_reference(&self, intf: &str) -> Result<ObjectRef, PoaError>
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).
Sourcepub fn create_reference_with_id(
&self,
id: &[u8],
intf: &str,
) -> Result<ObjectRef, PoaError>
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.