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:
- a
ClientRequestInterceptorsees each request the ORB sends, before it goes out and when it ends; - a
ServerRequestInterceptorsees each request the ORB’s POAs receive, before the servant runs and before the reply goes out; - an
IorInterceptoradds tagged components to the references of a new POA.
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::ReplyStatusvalues.- sync_
scope Messaging::SyncScopevalues (ClientRequestInfo::sync_scope).
Structs§
- Client
Request Info PortableInterceptor::ClientRequestInfo: one request as the client interceptors see it, during one interception point.- Duplicate
Name PortableInterceptor::ORBInitInfo::DuplicateName: an interceptor of the same kind already has this name.- Invalid
Slot PortableInterceptor::InvalidSlot: no slot has this id.- IorInfo
PortableInterceptor::IORInfo: a new POA, forIorInterceptor::establish_components.- OrbInit
Info PortableInterceptor::ORBInitInfo, given to the initializers.- Parameter
Dynamic::Parameter: an argument and its direction.- PiCurrent
PortableInterceptor::Currentof 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.- Server
Request Info PortableInterceptor::ServerRequestInfo: one request as the server interceptors see it, during one interception point.- Service
Context IOP::ServiceContext, with the context data left as an encapsulation.- Tagged
Component IOP::TaggedComponent, with the component data left as an encapsulation (or raw octets for the few components that are not).- Tagged
Profile IOP::TaggedProfile, with the profile body left as an encapsulation.
Enums§
- Client
Point - The client interception points.
- Intercept
Error - What an interception point may raise besides returning: a system
exception, or
PortableInterceptor::ForwardRequestto send the request to another object. - Server
Point - The server interception points.
Traits§
- Client
Request Interceptor 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.- Server
Request Interceptor PortableInterceptor::ServerRequestInterceptor.
Functions§
- register_
orb_ initializer PortableInterceptor::register_orb_initializer: runsinitfor every ORB created from now on in this process, before the initializers ofOrbOptions::initializers.- system_
exception_ any - A system exception as an Any.
Type Aliases§
- SlotId
PortableInterceptor::SlotId.