org.omg.PortableInterceptor

Interface ORBInitInfoOperations

public interface ORBInitInfoOperations

Defines operations, applicable to ORBInitInfo. The ORBInitInfo is passed to the ORBInitializer that is reponsible for registering an Interceptor.
Method Summary
voidadd_client_request_interceptor(ClientRequestInterceptor interceptor)
Register the client request interceptor.
voidadd_ior_interceptor(IORInterceptor interceptor)
Register the IOR (object reference) interceptor.
voidadd_server_request_interceptor(ServerRequestInterceptor interceptor)
Register the server request interceptor.
intallocate_slot_id()
Allocate a slot on a Current of this interceptor.
String[]arguments()
Returns the arguments passed to the ORB.init.
CodecFactorycodec_factory()
Get the CodecFactory that may be needed during the interceptor initialization.
Stringorb_id()
Returns the ID of the ORB being initialized.
voidregister_initial_reference(String object_name, Object object)
Register the initial reference.
voidregister_policy_factory(int policy_type, PolicyFactory policy_factory)
Registers a PolicyFactory for the given PolicyType.
Objectresolve_initial_references(String object_name)
Identical to ORB.

Method Detail

add_client_request_interceptor

public void add_client_request_interceptor(ClientRequestInterceptor interceptor)
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

public void add_ior_interceptor(IORInterceptor interceptor)
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

public void add_server_request_interceptor(ServerRequestInterceptor interceptor)
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

public 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 and CurrentOperations throw BAD_INV_ORDER while called from the interceptor initializer.

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

arguments

public 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

public 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

public 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

public void register_initial_reference(String object_name, Object object)
Register the initial reference. The registered object will be accessible by the ORB under the object_name.

Parameters: object_name the name of the object to register. object the object to register.

Throws: org.omg.PortableInterceptor.ORBInitInfoPackage.InvalidName if the name being registered is assumed to be invalid.

register_policy_factory

public 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.

resolve_initial_references

public Object resolve_initial_references(String object_name)
Identical to ORB. This method can only be called from ORBInitializerOperations and not during ORBInitializerOperations.

Parameters: object_name the name of the object to search.

Returns: the object, accessible by the given name.

Throws: org.omg.PortableInterceptor.ORBInitInfoPackage.InvalidName if the given name is not associated with the known object.

See Also: ORB