Skip to main content

Module pi

Module pi 

Source
Expand description

Portable Interceptors (PortableInterceptor): hooks on the requests an ORB sends and receives and on the references its POAs make.

An OrbInitializer, registered for every ORB (register_orb_initializer) or for one (OrbOptions::initializers), adds interceptors while the ORB is created:

Interceptors carry data in service contexts, usually encoded with an IOP::Codec, and hand it to the application and back through the slots of PiCurrent. The design, and how rustorb fits the specification, is in docs/portable-interceptors.md.

Modules§

minor
Minor codes of the exceptions the interceptor interfaces raise.
reply_status
PortableInterceptor::ReplyStatus values.
sync_scope
Messaging::SyncScope values (ClientRequestInfo::sync_scope).

Structs§

ClientRequestInfo
PortableInterceptor::ClientRequestInfo: one request as the client interceptors see it, during one interception point.
DuplicateName
PortableInterceptor::ORBInitInfo::DuplicateName: an interceptor of the same kind already has this name.
InvalidSlot
PortableInterceptor::InvalidSlot: no slot has this id.
IorInfo
PortableInterceptor::IORInfo: a new POA, for IorInterceptor::establish_components.
OrbInitInfo
PortableInterceptor::ORBInitInfo, given to the initializers.
Parameter
Dynamic::Parameter: an argument and its direction.
PiCurrent
PortableInterceptor::Current of an ORB (Orb::pi_current): the slots of the calling thread. A request copies them when it starts, so client interceptors see what the application set; a server interceptor’s slots are what the servant sees.
ServerRequestInfo
PortableInterceptor::ServerRequestInfo: one request as the server interceptors see it, during one interception point.
ServiceContext
IOP::ServiceContext, with the context data left as an encapsulation.
TaggedComponent
IOP::TaggedComponent, with the component data left as an encapsulation (or raw octets for the few components that are not).
TaggedProfile
IOP::TaggedProfile, with the profile body left as an encapsulation.

Enums§

ClientPoint
The client interception points.
InterceptError
What an interception point may raise besides returning: a system exception, or PortableInterceptor::ForwardRequest to send the request to another object.
ServerPoint
The server interception points.

Traits§

ClientRequestInterceptor
PortableInterceptor::ClientRequestInterceptor.
Interceptor
PortableInterceptor::Interceptor: what every interceptor has.
IorInterceptor
PortableInterceptor::IORInterceptor.
OrbInitializer
PortableInterceptor::ORBInitializer: adds interceptors and slots to an ORB while it is created.
ServerRequestInterceptor
PortableInterceptor::ServerRequestInterceptor.

Functions§

register_orb_initializer
PortableInterceptor::register_orb_initializer: runs init for every ORB created from now on in this process, before the initializers of OrbOptions::initializers.
system_exception_any
A system exception as an Any.

Type Aliases§

SlotId
PortableInterceptor::SlotId.