org.omg.PortableInterceptor
Interface ORBInitInfoOperations

All Known Subinterfaces:
ORBInitInfo

public interface ORBInitInfoOperations

Defines operations, applicable to ORBInitInfo. The ORBInitInfo is passed to the ORBInitializer that is reponsible for registering an Interceptor.


Method Summary
 void add_client_request_interceptor(ClientRequestInterceptor interceptor)
          Register the client request interceptor.
 void add_ior_interceptor(IORInterceptor interceptor)
          Register the IOR (object reference) interceptor.
 void add_server_request_interceptor(ServerRequestInterceptor interceptor)
          Register the server request interceptor.
 int allocate_slot_id()
          Allocate a slot on a Current of this interceptor.
 String[] arguments()
          Returns the arguments passed to the ORB.init.
 CodecFactory codec_factory()
          Get the CodecFactory that may be needed during the interceptor initialization.
 String orb_id()
          Returns the ID of the ORB being initialized.
 void register_initial_reference(String object_name, Object object)
          Register the initial reference.
 void register_policy_factory(int policy_type, PolicyFactory policy_factory)
          Registers a PolicyFactory for the given PolicyType.
 Object resolve_initial_references(String object_name)
          Identical to ORB.resolve_initial_references(java.lang.String).
 

Method Detail

add_client_request_interceptor

void add_client_request_interceptor(ClientRequestInterceptor interceptor)
                                    throws DuplicateName
Register the client request interceptor.

Parameters:
interceptor - the interceptor to register.
Throws:
DuplicateName - if the interceptor name is not an empty string and an interceptor with this name is already registered with the ORB being created.

add_ior_interceptor

void add_ior_interceptor(IORInterceptor interceptor)
                         throws DuplicateName
Register the IOR (object reference) interceptor. If the registered interceptor implements the extended IORInterceptor_3_0 interface, ORB will call its additional methods, defined in the IORInterceptor_3_0Operations.

Parameters:
interceptor - the interceptor to register.
Throws:
DuplicateName - if the interceptor name is not an empty string and an interceptor with this name is already registered with the ORB being created.

add_server_request_interceptor

void add_server_request_interceptor(ServerRequestInterceptor interceptor)
                                    throws DuplicateName
Register the server request interceptor.

Parameters:
interceptor - the interceptor to register.
Throws:
DuplicateName - if the interceptor name is not an empty string and an interceptor with this name is already registered with the ORB being created.

allocate_slot_id

int allocate_slot_id()
Allocate a slot on a Current of this interceptor. While slots can be allocated by this method, they cannot be initialized. CurrentOperations.get_slot(int) and CurrentOperations.set_slot(int, org.omg.CORBA.Any) throw BAD_INV_ORDER while called from the interceptor initializer.

Returns:
the index to the slot that has been allocated.

arguments

String[] arguments()
Returns the arguments passed to the ORB.init.

Returns:
the first parameter, passed to the methods from the group org.omg.CORBA.ORB#init(String[], ...).

codec_factory

CodecFactory codec_factory()
Get the CodecFactory that may be needed during the interceptor initialization. The method ORB.resolve_initial_references ("CodecFactory") cannot be used during ORB initialization.

Returns:
the CodecFactory.

orb_id

String orb_id()
Returns the ID of the ORB being initialized.

Returns:
the ORB id that differs for each new ORB being created during the current run of the java virtual machine.

register_initial_reference

void register_initial_reference(String object_name,
                                Object object)
                                throws InvalidName
Register the initial reference. The registered object will be accessible by the ORB.resolve_initial_references(java.lang.String) under the object_name.

Parameters:
object_name - the name of the object to register.
object - the object to register.
Throws:
InvalidName - if the name being registered is assumed to be invalid.

resolve_initial_references

Object resolve_initial_references(String object_name)
                                  throws InvalidName
Identical to ORB.resolve_initial_references(java.lang.String). This method can only be called from ORBInitializerOperations.post_init(org.omg.PortableInterceptor.ORBInitInfo) and not during ORBInitializerOperations.pre_init(org.omg.PortableInterceptor.ORBInitInfo).

Parameters:
object_name - the name of the object to search.
Returns:
the object, accessible by the given name.
Throws:
InvalidName - if the given name is not associated with the known object.
See Also:
ORB.resolve_initial_references(java.lang.String)

register_policy_factory

void register_policy_factory(int policy_type,
                             PolicyFactory policy_factory)
Registers a PolicyFactory for the given PolicyType.

Parameters:
policy_type - the type of policy for that the factory is being registered.
policy_factory - the policy factory to register.
Throws:
BAD_INV_ORDER - minor 16 if the policy of the given type already has the registered factory in this ORB.