Expand description
Stable extern "C" ABI layer over the rustorb core.
The C++ binding (cpp/include/rustorb) and the Java binding (through
the FFM API) are built on this crate; the Python binding uses PyO3
directly instead. The functions are declared, with the rules every
caller follows (handles, errors, strings, the lifetime of streams), in
include/rustorb/rustorb.h.
orb:ORB_initand the ORB operations.object: object references, and invocations whose arguments and results the caller writes and reads in callbacks.stream: the CDR streams the callbacks get. Their errors are sticky, so generated code does not check every call.owned: input streams the caller owns after the call that made them (replies, the bytes a callback writes, the value of an any), for the portable streams of the Java mapping.servant: servants implemented by the caller through a table of callbacks, and the replies they write.poa: the POA, its manager andPortableServer::Current.manager: servant managers and adapter activators implemented by the caller through tables of callbacks.any: TypeCodes, and anys whose values the caller puts in and takes out through the same streams.dynany:DynamicAny, its values going in and out as anys.value: valuetypes on the streams (sharing, chunks, truncation), their TypeCodes and the registry of valuetypes the core reads.
Modules§
- any
rorb_typecodeandrorb_any: TypeCodes and anys.- dynany
rorb_dynany: the core’sDynAnyfor the C++ and Java bindings.- local
- Values of
Exception::local(RORB_ADAPTER_ALREADY_EXISTS, …). - manager
- Servant managers (
ServantActivator,ServantLocator) and adapter activators implemented by the caller through a table of callbacks. - object
- Object references (
rorb_objectis a boxedObjectRef) and invocations. - orb
CORBA::ORB:rorb_orbis a boxedOrb.- owned
- Input streams the caller owns, valid until
rorb_in_release: the reply ofrorb_object_invoke_stream, what a callback writes (rorb_in_new) and the value of an any (rorb_any_input). They are the streams of the portable stubs and of the streams Java’screate_input_streamreturns. - poa
- The POA (
rorb_poais a boxedPoa), its manager (rorb_poa_manager, a boxedPoaManager) andPortableServer::Current. - policy
ORB::create_policy,ORB::register_initial_referenceand the policy overrides of object references, the calling thread and the ORB. Policies cross the ABI as a type and a value (PolicyValue::raw_value).- servant
- Servants implemented in C (
rorb_servantis a boxedArc<FfiServant>) and the replies they write. - stream
rorb_outandrorb_in: the CDR streams given to callbacks.- value
- Valuetypes on the
rorb_outandrorb_instreams.
Structs§
Constants§
- ABI_
VERSION - The version of the ABI in the header (
RORB_ABI_VERSION). - CALLBACK_
FAILED - A callback failed and keeps its own error.
- LOCAL_
EXCEPTION - An exception of a local interface, named by
Exception::local. - OK
- Success.
- SYSTEM_
EXCEPTION - A system exception, in the
Exception. - USER_
EXCEPTION - A user exception, taken by the caller’s callback.
Functions§
Type Aliases§
- Status
rorb_status.