Expand description
GIOP/IIOP message types, IOR and corbaloc handling.
Accepts GIOP 1.0 to 1.2 and sends GIOP 1.2.
MessageHeaderparses and writes the 12-byte GIOP header.decode_messageturns one complete message into aMessagewhose body can be read with a CDR decoder that keeps the message alignment.MessageEncoderwrites a message header and lets the caller append the body; it patches the message size when finished. Replies use the version of the request, so every version can be written.FragmentAssemblerjoins GIOP 1.1/1.2 fragments into one message, keeping the alignment of each fragment.Iorreads and writes stringified IORs;IiopProfileinterprets IIOP 1.0 to 1.2 profile bodies and theirTaggedComponents, with typed access to the ORB type, code sets and alternate addresses.Corbaloc,CorbaNameandObjectUrlparse and writecorbaloc:andcorbaname:URLs.
Modules§
- association_
options Security::AssociationOptionsbits, as in theSslSecTranscomponent.- code_
set - OSF registry ids of common code sets (
CONV_FRAME::CodeSetId). - component_
tag - Standard
IOP::ComponentIdvalues, and the omniORB specific ones. - orb_
type - Values of the
component_tag::ORB_TYPEcomponent. - response_
flags - Values of the GIOP 1.2
response_flagsoctet. - service_
id - Standard
IOP::ServiceIdvalues.
Structs§
- Alternate
Iiop Address - The data of the
component_tag::ALTERNATE_IIOP_ADDRESScomponent: one more address the object can be reached at. - Assembled
Message - A whole message returned by a
FragmentAssembler. - BiDir
Iiop Service Context IIOP::BiDirIIOPServiceContext: the addresses a client listens on, sent withservice_id::BI_DIR_IIOPto offer the connection for requests from the server (bidirectional GIOP, GIOP 1.2 and later).- Body
- The body of a message: the bytes after the message header, kept with their offset in the message so that CDR alignment is preserved.
- Cancel
Request Header - The header of a
CancelRequestmessage. - Code
SetComponent CONV_FRAME::CodeSetComponent: the native code set of one character type and the code sets it can convert to.- Code
SetComponent Info CONV_FRAME::CodeSetComponentInfo, the data of thecomponent_tag::CODE_SETScomponent.- Code
SetContext CONV_FRAME::CodeSetContext, the transmission code sets chosen by a client.- Corba
Name - A
corbaname:URL: a naming context given as a corbaloc location, and a stringified name to resolve in it. - Corbaloc
- A
corbaloc:URL: a list of addresses and an object key. - Fragment
Assembler - Joins fragmented GIOP 1.1 and 1.2 messages.
- Fragment
Header - The header of a
Fragmentmessage. - Iiop
Addr - An IIOP address in a corbaloc URL:
[major.minor@]host[:port]. - Iiop
Profile IIOP::ProfileBody, the body of aTAG_INTERNET_IOPprofile.- Ior
IOP::IOR, an interoperable object reference.- Listen
Point IIOP::ListenPoint: a host and port a client listens on.- Locate
Reply Header - The header of a
LocateReplymessage. - Locate
Request Header - The header of a
LocateRequestmessage. - Message
Encoder - Writes one GIOP message.
- Message
Header - The 12-byte header that starts every GIOP message.
- OutMessage
- A whole message to send: its bytes, with large octet sequences that were not copied in kept apart.
- Reply
Header - The header of a
Replymessage. - Request
Header - The header of a
Requestmessage, in its GIOP 1.2 shape. - Service
Context IOP::ServiceContext, with the context data left as an encapsulation.- SslSec
Trans SSLIOP::SSL, the data of acomponent_tag::SSL_SEC_TRANScomponent: the port of the TLS endpoint at the host of the IIOP profile, and the association options of the target.- System
Exception Body - The body of a
SYSTEM_EXCEPTIONreply. - 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.- Unix
Trans - omniORB’s
TAG_OMNIORB_UNIX_TRANScomponent: a Unix domain socket the target listens on (giop:unix), usable from the host it names. The layout (two strings in an encapsulation) is as observed in omniORB 4.3 IORs; see docs/unix-transport.md. - Version
- A GIOP protocol version.
Enums§
- Addressing
Disposition GIOP::AddressingDisposition, the kind ofTargetAddress.- Completion
Status CORBA::CompletionStatus.- Error
- Errors raised while reading or writing GIOP messages.
- Locate
Status GIOP::LocateStatusType.- Message
- A decoded GIOP message.
- MsgType
- A GIOP message type.
- ObjAddr
- One address of a corbaloc URL.
- Object
Url - Any string
CORBA::ORB::string_to_objectaccepts. - Reply
Status GIOP::ReplyStatusType.- Target
Address GIOP::TargetAddress, the object a request is sent to.
Constants§
- DEFAULT_
CORBALOC_ PORT - Port used when a corbaloc IIOP address has none.
- DEFAULT_
CORBANAME_ KEY - Object key used by
corbaname:URLs that have none. - TAG_
INTERNET_ IOP IOP::TAG_INTERNET_IOP, an IIOP profile.- TAG_
MULTIPLE_ COMPONENTS IOP::TAG_MULTIPLE_COMPONENTS.
Functions§
- decode_
message - Decodes one complete GIOP message: the header followed by exactly
message_sizebytes. - orb_
type_ component - Builds a
component_tag::ORB_TYPEcomponent.
Type Aliases§
- Result
- Result type of GIOP operations.