org.omg.PortableInterceptor

Interface ORBInitInfoOperations

public interface ORBInitInfoOperations

Defines operations, applicable to {@link ORBInitInfo}. The {@link ORBInitInfo} is passed to the {@link ORBInitializer} that is reponsible for registering an {@link 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 {@link 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 {@link org.omg.CORBA.ORB#resolve_initial_references}.

Method Detail

add_client_request_interceptor

public void add_client_request_interceptor(ClientRequestInterceptor 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 {@link IORInterceptor_3_0} interface, ORB will call its additional methods, defined in the {@link 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)

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 {@link Current} of this interceptor. While slots can be allocated by this method, they cannot be initialized. {@link CurrentOperations#get_slot} and {@link CurrentOperations#set_slot} throw {@link org.omg.CORBA.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 {@link ORB#resolve_initial_references} 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 {@link org.omg.CORBA.ORB#resolve_initial_references}. This method can only be called from {@link ORBInitializerOperations#post_init} and not during {@link ORBInitializerOperations#pre_init}.

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.