The corbaloc URL scheme, one of the three CORBA object URL schemes, uses either IIOP or resolve_initial_references (RIR) style addressing.
The IIOP style allows specification of host and port information, which identifies a server or agent that can be resolved to provide the object. Alternatively, corbaloc URLs can indicate that an object can be contacted by CORBA::resolve_initial_references.
Examples of corbaloc URL scheme strings:
corbaloc:iiop:1.2@xyz_host.net/NameService corbaloc:rir:/NameService corbaloc::ABC_host.com/ProductZ/TradingService corbaloc::primary.com:110,:1.2@backup.com:120/Dev/NameService
A corbaloc URL scheme begins with the characters "corbaloc:". This is followed by "rir:", which indicates the resolve_initial_references form or one or more IIOP addresses. Both RIR and IIOP forms are followed by a forward slash delimiter and the object key.
An IIOP address begins with either "iiop:" or just ":". Optionally, the GIOP version can be specified and delimited by a trailing "@". Next, a host identifier is specified, either as a DNS-style host name or as a dotted decimal address. Optionally, the host identifier is followed by a delimiting ":" and a port number. If more than one IIOP address is specified, a "," delimiter separates each one.
After the last iiop: or rir: address, a forward slash, "/", delimits the object key, which is the final part of the URL. The object key can contain embedded slashes.
If the GIOP version is not specified, it defaults to 1.0. This determines the GIOP level of messages that are used when contacting the host and port. If the port number is not specified, it defaults to 2809.
In the corbaloc URL scheme example, corbaloc::primary.com:110,:1.2@backup.com:120/Dev/NameService, two IIOP addresses are specified. An attempt to convert this to an object causes the Object Request Broker (ORB) to contact port 110 at host "primary.com" and request an object identified by the object key, "Dev/NameService". If this fails, the ORB contacts port 120 at the host "backup.com", using GIOP Version 1.2 and the object key "Dev/NameService".
When a resolve_initial_reference form of a corbaloc URL scheme is converted to an object, the object key portion of the URL is passed to CORBA::resolve_initial_references and the result is returned.
Only the IIOP form of a corbaloc URL scheme can be used as a parameter with the CORBA::ORB_init method to configure Initial References.