com.sun.corba.se.impl.orb

Class ORBImpl

java.lang.Object

org.omg.CORBA.ORB

org.omg.CORBA_2_3.ORB

com.sun.corba.se.org.omg.CORBA.ORB

com.sun.corba.se.spi.orb.ORB

com.sun.corba.se.impl.orb.ORBImpl

All Implemented Interfaces:

TypeCodeFactory, Broker

Direct Known Subclasses:

ORB

public class ORBImpl
extends ORB

The JavaIDL ORB implementation.

Field Summary

Fields

Modifier and Type	Field and Description
protected LegacyServerSocketManager	legacyServerSocketManager
protected TransportManager	transportManager

Fields inherited from class com.sun.corba.se.spi.orb.ORB

giopDebugFlag, giopVersionDebugFlag, invocationTimingDebugFlag, monitoringManager, namingDebugFlag, omgWrapper, orbdDebugFlag, ORBInitDebug, poaConcurrencyDebugFlag, poaDebugFlag, poaFSMDebugFlag, serviceContextDebugFlag, shutdownDebugFlag, staticWrapper, subcontractDebugFlag, transientObjectManagerDebugFlag, transportDebugFlag, wrapper

Constructor Summary

Constructors

Constructor and Description
ORBImpl() Create a new ORB.

Method Summary

Modifier and Type	Method and Description
void	checkShutdownState()
void	connect(Object servant) This is the implementation of the public API used to connect a servant-skeleton to the ORB.
TypeCode	create_abstract_interface_tc(String id, String name) Create a TypeCode object for an IDL abstract interface.
TypeCode	create_alias_tc(String id, String name, TypeCode original_type) Create a TypeCode for an alias.
Any	create_any() Create a new Any
TypeCode	create_array_tc(int length, TypeCode element_type) Create a TypeCode for an array.
ContextList	create_context_list() Create a ContextList
TypeCode	create_enum_tc(String id, String name, String[] members) Create a TypeCode for an enum.
Environment	create_environment() Create an Environment
ExceptionList	create_exception_list() Create an ExceptionList
TypeCode	create_exception_tc(String id, String name, StructMember[] members) Create a TypeCode for an exception.
TypeCode	create_fixed_tc(short digits, short scale) Create a TypeCode object for an IDL fixed type.
TypeCode	create_interface_tc(String id, String name) Create a TypeCode for an interface.
NVList	create_list(int count) Create an NVList
NamedValue	create_named_value(String s, Any any, int flags) Create a NamedValue
TypeCode	create_native_tc(String id, String name) Create a TypeCode object for an IDL native type.
NVList	create_operation_list(Object oper) Create an NVList corresponding to an OperationDef
OutputStream	create_output_stream() The following methods are standard public CORBA ORB APIs
Policy	create_policy(int type, Any val) Can be invoked to create new instances of policy objects of a specific type with specified initial state.
TypeCode	create_recursive_sequence_tc(int bound, int offset) Create a recursive TypeCode in a sequence.
TypeCode	create_recursive_tc(String id) Create a recursive TypeCode object which serves as a placeholder for a concrete TypeCode during the process of creating TypeCodes which contain recursion.
TypeCode	create_sequence_tc(int bound, TypeCode element_type) Create a TypeCode for a sequence.
TypeCode	create_string_tc(int bound) Create a TypeCode for a string.
TypeCode	create_struct_tc(String id, String name, StructMember[] members) Create a TypeCode for a structure.
TypeCode	create_union_tc(String id, String name, TypeCode discriminator_type, UnionMember[] members) Create a TypeCode for a union.
TypeCode	create_value_box_tc(String id, String name, TypeCode boxed_type) Creates a TypeCode object for an IDL value box.
TypeCode	create_value_tc(String id, String name, short type_modifier, TypeCode concrete_base, ValueMember[] members) Create a TypeCode object for an IDL value type.
TypeCode	create_wstring_tc(int bound) Create a TypeCode for a wide string.
ClientInvocationInfo	createOrIncrementInvocationInfo()
void	destroy() formal/99-10-07 p 159: "If destroy is called on an ORB that has not been shut down, it will start the shutdown process and block until the ORB has shut down before it destroys the ORB."
void	disconnect(Object obj) Disconnects the given servant object from the ORB.
void	finishedDispatch()
Current	get_current() Deprecated.
Context	get_default_context() Get the default Context object
Request	get_next_response() Get the next request that has gotten a response.
TypeCode	get_primitive_tc(TCKind tcKind) Get the TypeCode for a primitive type.
ClientDelegateFactory	getClientDelegateFactory()
CopierManager	getCopierManager()
CorbaContactInfoListFactory	getCorbaContactInfoListFactory()
CorbaTransportManager	getCorbaTransportManager()
IOR	getFVDCodeBaseIOR()
ClientInvocationInfo	getInvocationInfo()
LegacyServerSocketManager	getLegacyServerSocketManager()
LocalResolver	getLocalResolver() Get the LocalResolver used in this ORB.
ObjectKeyFactory	getObjectKeyFactory()
ORBData	getORBData()
ORBVersion	getORBVersion()
PIHandler	getPIHandler()
RequestDispatcherRegistry	getRequestDispatcherRegistry()
Resolver	getResolver() Get the resolver used in this ORB.
ServiceContextRegistry	getServiceContextRegistry()
TaggedComponentFactoryFinder	getTaggedComponentFactoryFinder() Factory finders for the various parts of the IOR: tagged components, tagged profiles, and tagged profile templates.
IdentifiableFactoryFinder	getTaggedProfileFactoryFinder()
IdentifiableFactoryFinder	getTaggedProfileTemplateFactoryFinder()
ThreadPoolManager	getThreadPoolManager()
int	getTransientServerId() Return this ORB's transient server ID.
TransportManager	getTransportManager()
TypeCodeImpl	getTypeCodeForClass(Class c)
Operation	getURLOperation() Get the operation used in string_to_object calls.
void	handleBadServerId(ObjectKey okey) Handle a bad server id for the given object key.
void	initBadServerIdHandler()
boolean	isDuringDispatch()
boolean	isLocalHost(String hostName)
boolean	isLocalServerId(int subcontractId, int serverId)
String[]	list_initial_services() Get a list of the initially available CORBA services.
ValueFactory	lookup_value_factory(String repositoryID) Finds and returns a value factory for the given repository ID.
void	notifyORB() Notify response to ORB for get_next_response
String	object_to_string(Object obj) Convert an object ref to a string.
OAInvocationInfo	peekInvocationInfo()
void	perform_work() This method does nothing.
boolean	poll_next_response() Find out if any of the deferred invocations have a response yet.
OAInvocationInfo	popInvocationInfo()
void	pushInvocationInfo(OAInvocationInfo info)
void	register_initial_reference(String id, Object obj) If this operation is called with an id, "Y", and an object, YY, then a subsequent call to ORB.resolve_initial_references( "Y" ) will return object YY.
ValueFactory	register_value_factory(String repositoryID, ValueFactory factory) Registers a value factory for a particular repository ID.
void	releaseOrDecrementInvocationInfo()
Object	resolve_initial_references(String identifier) Resolve the stringified reference of one of the initially available CORBA services.
void	run() The following methods (introduced in POA / CORBA2.1) deal with shutdown / single threading.
void	send_multiple_requests_deferred(Request[] req) Send multiple dynamic requests asynchronously.
void	send_multiple_requests_oneway(Request[] req) Sends multiple dynamic (DII) requests asynchronously without expecting any responses.
void	set_delegate(Object servant)
protected void	set_parameters(Applet app, Properties props) Allows the ORB implementation to be initialized with the given applet and parameters.
void	set_parameters(Properties props)
protected void	set_parameters(String[] params, Properties props) Allows the ORB implementation to be initialized with the given parameters and properties.
void	setBadServerIdHandler(BadServerIdHandler handler)
void	setClientDelegateFactory(ClientDelegateFactory factory)
void	setCorbaContactInfoListFactory(CorbaContactInfoListFactory factory)
protected void	setDebugFlags(String[] args)
void	setINSDelegate(CorbaServerRequestDispatcher sdel) Set the ServerRequestDispatcher that should be used for handling INS requests.
void	setLocalResolver(LocalResolver resolver) Set the LocalResolver used in this ORB.
void	setObjectKeyFactory(ObjectKeyFactory factory)
void	setORBVersion(ORBVersion verObj)
void	setResolver(Resolver resolver) Set the resolver used in this ORB.
void	setThreadPoolManager(ThreadPoolManager mgr)
void	setTypeCodeForClass(Class c, TypeCodeImpl tci)
void	setURLOperation(Operation stringToObject) Set the operation used in string_to_object calls.
void	shutdown(boolean wait_for_completion) Instructs the ORB to shut down, which causes all object adapters to shut down, in preparation for destruction. If the wait_for_completion parameter is true, this operation blocks until all ORB processing (including processing of currently executing requests, object deactivation, and other object adapter operations) has completed.
protected void	shutdownServants(boolean wait_for_completion)
void	startingDispatch()
Object	string_to_object(String str) Convert a stringified object reference to the object it represents.
void	unregister_value_factory(String repositoryID) Unregisters a value factory for a particular repository ID.
boolean	work_pending() This method always returns false because the ORB never needs the main thread to do work.

Methods inherited from class com.sun.corba.se.spi.orb.ORB

get_primitive_tc, getByteBufferPool, getLogger, getLogWrapper, getMonitoringManager, getPresentationManager, getStubFactoryFactory, getTypeCode, setTypeCode, staticGetLogger, staticGetLogWrapper

Methods inherited from class org.omg.CORBA_2_3.ORB

get_value_def

Methods inherited from class org.omg.CORBA.ORB

create_basic_dyn_any, create_dyn_any, create_dyn_array, create_dyn_enum, create_dyn_sequence, create_dyn_struct, create_dyn_union, get_service_information, init, init, init

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

transportManager

protected TransportManager transportManager

legacyServerSocketManager

protected LegacyServerSocketManager legacyServerSocketManager

Constructor Detail

ORBImpl

public ORBImpl()

Create a new ORB. Should be followed by the appropriate set_parameters() call.

Method Detail

getORBData

public ORBData getORBData()

Specified by:

getORBData in class ORB

getPIHandler

public PIHandler getPIHandler()

Specified by:

getPIHandler in class ORB

getORBVersion

public ORBVersion getORBVersion()

Specified by:

getORBVersion in class ORB

setORBVersion

public void setORBVersion(ORBVersion verObj)

Specified by:

setORBVersion in class ORB

setDebugFlags

protected void setDebugFlags(String[] args)

set_parameters

public void set_parameters(Properties props)

Specified by:

set_parameters in class ORB

set_parameters

protected void set_parameters(Applet app,
                              Properties props)

Description copied from class: ORB

Allows the ORB implementation to be initialized with the given applet and parameters. This method, used in applets only, is implemented by subclass ORB implementations and called by the appropriate init method to pass in its parameters.

Specified by:

set_parameters in class ORB

Parameters:

app - the applet; may be null

props - applet-specific properties; may be null

set_parameters

protected void set_parameters(String[] params,
                              Properties props)

Description copied from class: ORB

Allows the ORB implementation to be initialized with the given parameters and properties. This method, used in applications only, is implemented by subclass ORB implementations and called by the appropriate init method to pass in its parameters.

Specified by:

set_parameters in class ORB

Parameters:

params - command-line arguments for the application's main method; may be null

props - application-specific properties; may be null

create_output_stream

public OutputStream create_output_stream()

The following methods are standard public CORBA ORB APIs

Specified by:

create_output_stream in class ORB

Returns:

the newly-created org.omg.CORBA.portable.OutputStream object

get_current

public Current get_current()

Deprecated.

Get a Current pseudo-object. The Current interface is used to manage thread-specific information for use by the transactions, security and other services. This method is deprecated, and replaced by ORB.resolve_initial_references("NameOfCurrentObject");

Overrides:

get_current in class ORB

Returns:

a Current pseudo-object.

See Also:

CORBA package comments for unimplemented features

create_list

public NVList create_list(int count)

Create an NVList

Specified by:

create_list in class ORB

Parameters:

count - size of list to create

Returns:

the newly-created NVList

See Also:

NVList

create_operation_list

public NVList create_operation_list(Object oper)

Create an NVList corresponding to an OperationDef

Overrides:

create_operation_list in class ORB

Parameters:

oper - operation def to use to create list

Returns:

a newly-created NVList object containing descriptions of the arguments to the method described in the given OperationDef object

See Also:

NVList

create_named_value

public NamedValue create_named_value(String s,
                                     Any any,
                                     int flags)

Create a NamedValue

Specified by:

create_named_value in class ORB

Parameters:

s - the name of the NamedValue object

any - the Any value to be inserted into the NamedValue object

flags - the argument mode flags for the NamedValue: one of ARG_IN.value, ARG_OUT.value, or ARG_INOUT.value.

Returns:

the newly-created NamedValue object

See Also:

NamedValue

create_exception_list

public ExceptionList create_exception_list()

Create an ExceptionList

Specified by:

create_exception_list in class ORB

Returns:

the newly-created ExceptionList object

create_context_list

public ContextList create_context_list()

Create a ContextList

Specified by:

create_context_list in class ORB

Returns:

the newly-created ContextList object

See Also:

ContextList, Context

get_default_context

public Context get_default_context()

Get the default Context object

Specified by:

get_default_context in class ORB

Returns:

the default Context object

See Also:

Context

create_environment

public Environment create_environment()

Create an Environment

Specified by:

create_environment in class ORB

Returns:

the newly-created Environment object

See Also:

Environment

send_multiple_requests_oneway

public void send_multiple_requests_oneway(Request[] req)

Description copied from class: ORB

Sends multiple dynamic (DII) requests asynchronously without expecting any responses. Note that oneway invocations are not guaranteed to reach the server.

Specified by:

send_multiple_requests_oneway in class ORB

Parameters:

req - an array of request objects

send_multiple_requests_deferred

public void send_multiple_requests_deferred(Request[] req)

Send multiple dynamic requests asynchronously.

Specified by:

send_multiple_requests_deferred in class ORB

Parameters:

req - an array of request objects.

poll_next_response

public boolean poll_next_response()

Find out if any of the deferred invocations have a response yet.

Specified by:

poll_next_response in class ORB

Returns:

true if there is a response available; false otherwise

get_next_response

public Request get_next_response()
                          throws WrongTransaction

Get the next request that has gotten a response.

Specified by:

get_next_response in class ORB

Returns:

the next Request object ready with a response

Throws:

WrongTransaction - if the method get_next_response is called from a transaction scope different from the one from which the original request was sent. See the OMG Transaction Service specification for details.

notifyORB

public void notifyORB()

Notify response to ORB for get_next_response

Specified by:

notifyORB in class ORB

object_to_string

public String object_to_string(Object obj)

Convert an object ref to a string.

Specified by:

object_to_string in class ORB

Parameters:

obj - The object to stringify.

Returns:

A stringified object reference.

string_to_object

public Object string_to_object(String str)

Convert a stringified object reference to the object it represents.

Specified by:

string_to_object in class ORB

Parameters:

str - The stringified object reference.

Returns:

The unstringified object reference.

getFVDCodeBaseIOR

public IOR getFVDCodeBaseIOR()

Specified by:

getFVDCodeBaseIOR in class ORB

get_primitive_tc

public TypeCode get_primitive_tc(TCKind tcKind)

Get the TypeCode for a primitive type.

Specified by:

get_primitive_tc in class ORB

Parameters:

tcKind - the integer kind for the primitive type

Returns:

the requested TypeCode

create_struct_tc

public TypeCode create_struct_tc(String id,
                                 String name,
                                 StructMember[] members)

Create a TypeCode for a structure.

Specified by:

create_struct_tc in class ORB

Parameters:

id - the logical id for the typecode.

name - the name for the typecode.

members - an array describing the members of the TypeCode.

Returns:

the requested TypeCode.

create_union_tc

public TypeCode create_union_tc(String id,
                                String name,
                                TypeCode discriminator_type,
                                UnionMember[] members)

Create a TypeCode for a union.

Specified by:

create_union_tc in class ORB

Parameters:

id - the logical id for the typecode.

name - the name for the typecode.

discriminator_type - the type of the union discriminator.

members - an array describing the members of the TypeCode.

Returns:

the requested TypeCode.

create_enum_tc

public TypeCode create_enum_tc(String id,
                               String name,
                               String[] members)

Create a TypeCode for an enum.

Specified by:

create_enum_tc in class ORB

Parameters:

id - the logical id for the typecode.

name - the name for the typecode.

members - an array describing the members of the TypeCode.

Returns:

the requested TypeCode.

create_alias_tc

public TypeCode create_alias_tc(String id,
                                String name,
                                TypeCode original_type)

Create a TypeCode for an alias.

Specified by:

create_alias_tc in class ORB

Parameters:

id - the logical id for the typecode.

name - the name for the typecode.

original_type - the type this is an alias for.

Returns:

the requested TypeCode.

create_exception_tc

public TypeCode create_exception_tc(String id,
                                    String name,
                                    StructMember[] members)

Create a TypeCode for an exception.

Specified by:

create_exception_tc in class ORB

Parameters:

id - the logical id for the typecode.

name - the name for the typecode.

members - an array describing the members of the TypeCode.

Returns:

the requested TypeCode.

create_interface_tc

public TypeCode create_interface_tc(String id,
                                    String name)

Create a TypeCode for an interface.

Specified by:

create_interface_tc in class ORB

Parameters:

id - the logical id for the typecode.

name - the name for the typecode.

Returns:

the requested TypeCode.

create_string_tc

public TypeCode create_string_tc(int bound)

Create a TypeCode for a string.

Specified by:

create_string_tc in class ORB

Parameters:

bound - the bound for the string.

Returns:

the requested TypeCode.

create_wstring_tc

public TypeCode create_wstring_tc(int bound)

Create a TypeCode for a wide string.

Specified by:

create_wstring_tc in class ORB

Parameters:

bound - the bound for the string.

Returns:

the requested TypeCode.

create_sequence_tc

public TypeCode create_sequence_tc(int bound,
                                   TypeCode element_type)

Create a TypeCode for a sequence.

Specified by:

create_sequence_tc in class ORB

Parameters:

bound - the bound for the sequence.

element_type - the type of elements of the sequence.

Returns:

the requested TypeCode.

create_recursive_sequence_tc

public TypeCode create_recursive_sequence_tc(int bound,
                                             int offset)

Create a recursive TypeCode in a sequence.

Specified by:

create_recursive_sequence_tc in class ORB

Parameters:

bound - the bound for the sequence.

offset - the index to the enclosing TypeCode that is being referenced.

Returns:

the requested TypeCode.

See Also:

create_recursive_tc, create_sequence_tc

create_array_tc

public TypeCode create_array_tc(int length,
                                TypeCode element_type)

Create a TypeCode for an array.

Specified by:

create_array_tc in class ORB

Parameters:

length - the length of the array.

element_type - the type of elements of the array.

Returns:

the requested TypeCode.

create_native_tc

public TypeCode create_native_tc(String id,
                                 String name)

Description copied from class: ORB

Create a TypeCode object for an IDL native type.

Overrides:

create_native_tc in class ORB

Parameters:

id - the logical id for the native type.

name - the name of the native type.

Returns:

the requested TypeCode.

create_abstract_interface_tc

public TypeCode create_abstract_interface_tc(String id,
                                             String name)

Description copied from class: ORB

Create a TypeCode object for an IDL abstract interface.

Overrides:

create_abstract_interface_tc in class ORB

Parameters:

id - the logical id for the abstract interface type.

name - the name of the abstract interface type.

Returns:

the requested TypeCode.

create_fixed_tc

public TypeCode create_fixed_tc(short digits,
                                short scale)

Description copied from class: ORB

Create a TypeCode object for an IDL fixed type.

Overrides:

create_fixed_tc in class ORB

Parameters:

digits - specifies the total number of decimal digits in the number and must be from 1 to 31 inclusive.

scale - specifies the position of the decimal point.

Returns:

the requested TypeCode.

create_value_tc

public TypeCode create_value_tc(String id,
                                String name,
                                short type_modifier,
                                TypeCode concrete_base,
                                ValueMember[] members)

Description copied from class: ORB

Create a TypeCode object for an IDL value type. The concrete_base parameter is the TypeCode for the immediate concrete valuetype base of the valuetype for which the TypeCode is being created. It may be null if the valuetype does not have a concrete base.

Overrides:

create_value_tc in class ORB

Parameters:

id - the logical id for the value type.

name - the name of the value type.

type_modifier - one of the value type modifier constants: VM_NONE, VM_CUSTOM, VM_ABSTRACT or VM_TRUNCATABLE

concrete_base - a TypeCode object describing the concrete valuetype base

members - an array containing the members of the value type

Returns:

the requested TypeCode

create_recursive_tc

public TypeCode create_recursive_tc(String id)

Description copied from class: ORB

Create a recursive TypeCode object which serves as a placeholder for a concrete TypeCode during the process of creating TypeCodes which contain recursion. The id parameter specifies the repository id of the type for which the recursive TypeCode is serving as a placeholder. Once the recursive TypeCode has been properly embedded in the enclosing TypeCode which corresponds to the specified repository id, it will function as a normal TypeCode. Invoking operations on the recursive TypeCode before it has been embedded in the enclosing TypeCode will result in a BAD_TYPECODE exception.

For example, the following IDL type declaration contains recursion:

    Struct Node {
        Sequence<Node> subnodes;
    };
 

To create a TypeCode for struct Node, you would invoke the TypeCode creation operations as shown below:

 String nodeID = "IDL:Node:1.0";
 TypeCode recursiveSeqTC = orb.create_sequence_tc(0, orb.create_recursive_tc(nodeID));
 StructMember[] members = { new StructMember("subnodes", recursiveSeqTC, null) };
 TypeCode structNodeTC = orb.create_struct_tc(nodeID, "Node", members);
 

Also note that the following is an illegal IDL type declaration:

    Struct Node {
        Node next;
    };
 

Recursive types can only appear within sequences which can be empty. That way marshaling problems, when transmitting the struct in an Any, are avoided.

Overrides:

create_recursive_tc in class ORB

Parameters:

id - the logical id of the referenced type

Returns:

the requested TypeCode

create_value_box_tc

public TypeCode create_value_box_tc(String id,
                                    String name,
                                    TypeCode boxed_type)

Description copied from class: ORB

Creates a TypeCode object for an IDL value box.

Overrides:

create_value_box_tc in class ORB

Parameters:

id - the logical id for the value type

name - the name of the value type

boxed_type - the TypeCode for the type

Returns:

the requested TypeCode

create_any

public Any create_any()

Create a new Any

Specified by:

create_any in class ORB

Returns:

the new Any created.

setTypeCodeForClass

public void setTypeCodeForClass(Class c,
                                TypeCodeImpl tci)

getTypeCodeForClass

public TypeCodeImpl getTypeCodeForClass(Class c)

list_initial_services

public String[] list_initial_services()

Get a list of the initially available CORBA services. This does not work unless an ORBInitialHost is specified during initialization (or unless there is an ORB running on the AppletHost) since the localhostname is inaccessible to applets. If a service properties URL was specified, then it is used, otherwise the bootstrapping protocol is used.

Specified by:

list_initial_services in class ORB

Returns:

A list of the initial services available.

resolve_initial_references

public Object resolve_initial_references(String identifier)
                                  throws InvalidName

Resolve the stringified reference of one of the initially available CORBA services.

Specified by:

resolve_initial_references in class ORB

Parameters:

identifier - The stringified object reference of the desired service.

Returns:

An object reference for the desired service.

Throws:

InvalidName - The supplied identifier is not associated with a known service.

SystemException - One of a fixed set of Corba system exceptions.

register_initial_reference

public void register_initial_reference(String id,
                                       Object obj)
                                throws InvalidName

If this operation is called with an id, "Y", and an object, YY, then a subsequent call to ORB.resolve_initial_references( "Y" ) will return object YY.

Overrides:

register_initial_reference in class ORB

Parameters:

id - The ID by which the initial reference will be known.

obj - The initial reference itself.

Throws:

InvalidName - if this operation is called with an empty string id or this operation is called with an id that is already registered, including the default names defined by OMG.

BAD_PARAM - if the obj parameter is null.

run

public void run()

The following methods (introduced in POA / CORBA2.1) deal with shutdown / single threading.

Overrides:

run in class ORB

shutdown

public void shutdown(boolean wait_for_completion)

Description copied from class: ORB

Instructs the ORB to shut down, which causes all object adapters to shut down, in preparation for destruction.
If the wait_for_completion parameter is true, this operation blocks until all ORB processing (including processing of currently executing requests, object deactivation, and other object adapter operations) has completed. If an application does this in a thread that is currently servicing an invocation, the BAD_INV_ORDER system exception will be thrown with the OMG minor code 3, since blocking would result in a deadlock.
If the wait_for_completion parameter is FALSE, then shutdown may not have completed upon return.

While the ORB is in the process of shutting down, the ORB operates as normal, servicing incoming and outgoing requests until all requests have been completed. Once an ORB has shutdown, only object reference management operations may be invoked on the ORB or any object reference obtained from it. An application may also invoke the destroy operation on the ORB itself. Invoking any other operation will throw the BAD_INV_ORDER system exception with the OMG minor code 4.

The ORB.run method will return after shutdown has been called.

Overrides:

shutdown in class ORB

Parameters:

wait_for_completion - true if the call should block until the shutdown is complete; false if it should return immediately

shutdownServants

protected void shutdownServants(boolean wait_for_completion)

checkShutdownState

public void checkShutdownState()

Specified by:

checkShutdownState in class ORB

isDuringDispatch

public boolean isDuringDispatch()

Specified by:

isDuringDispatch in class ORB

startingDispatch

public void startingDispatch()

Specified by:

startingDispatch in class ORB

finishedDispatch

public void finishedDispatch()

Specified by:

finishedDispatch in class ORB

destroy

public void destroy()

formal/99-10-07 p 159: "If destroy is called on an ORB that has not been shut down, it will start the shutdown process and block until the ORB has shut down before it destroys the ORB."

Overrides:

destroy in class ORB

register_value_factory

public ValueFactory register_value_factory(String repositoryID,
                                           ValueFactory factory)

Registers a value factory for a particular repository ID.

Overrides:

register_value_factory in class ORB

Parameters:

repositoryID - the repository ID.

factory - the factory.

Returns:

the previously registered factory for the given repository ID, or null if no such factory was previously registered.

Throws:

BAD_PARAM - if the registration fails.

unregister_value_factory

public void unregister_value_factory(String repositoryID)

Unregisters a value factory for a particular repository ID.

Overrides:

unregister_value_factory in class ORB

Parameters:

repositoryID - the repository ID.

lookup_value_factory

public ValueFactory lookup_value_factory(String repositoryID)

Finds and returns a value factory for the given repository ID. The value factory returned was previously registered by a call to register_value_factory(java.lang.String, org.omg.CORBA.portable.ValueFactory) or is the default factory.

Overrides:

lookup_value_factory in class ORB

Parameters:

repositoryID - the repository ID.

Returns:

the value factory.

Throws:

BAD_PARAM - if unable to locate a factory.

peekInvocationInfo

public OAInvocationInfo peekInvocationInfo()

Specified by:

peekInvocationInfo in class ORB

pushInvocationInfo

public void pushInvocationInfo(OAInvocationInfo info)

Specified by:

pushInvocationInfo in class ORB

popInvocationInfo

public OAInvocationInfo popInvocationInfo()

Specified by:

popInvocationInfo in class ORB

initBadServerIdHandler

public void initBadServerIdHandler()

Specified by:

initBadServerIdHandler in class ORB

setBadServerIdHandler

public void setBadServerIdHandler(BadServerIdHandler handler)

Specified by:

setBadServerIdHandler in class ORB

handleBadServerId

public void handleBadServerId(ObjectKey okey)

Description copied from class: ORB

Handle a bad server id for the given object key. This should always through an exception: either a ForwardException to allow another server to handle the request, or else an error indication. XXX Remove after ORT for ORBD work is integrated.

Specified by:

handleBadServerId in class ORB

create_policy

public Policy create_policy(int type,
                            Any val)
                     throws PolicyError

Description copied from class: ORB

Can be invoked to create new instances of policy objects of a specific type with specified initial state. If create_policy fails to instantiate a new Policy object due to its inability to interpret the requested type and content of the policy, it raises the PolicyError exception with the appropriate reason.

Overrides:

create_policy in class ORB

Parameters:

type - the PolicyType of the policy object to be created

val - the value that will be used to set the initial state of the Policy object that is created

Returns:

Reference to a newly created Policy object of type specified by the type parameter and initialized to a state specified by the val parameter

Throws:

PolicyError

connect

public void connect(Object servant)

This is the implementation of the public API used to connect a servant-skeleton to the ORB.

Overrides:

connect in class ORB

Parameters:

servant - The servant object reference

disconnect

public void disconnect(Object obj)

Description copied from class: ORB

Disconnects the given servant object from the ORB. After this method returns, the ORB will reject incoming remote requests for the disconnected servant and will send the exception org.omg.CORBA.OBJECT_NOT_EXIST back to the remote client. Thus the object appears to be destroyed from the point of view of remote clients. Note, however, that local requests issued using the servant directly do not pass through the ORB; hence, they will continue to be processed by the servant.

Calling the method disconnect has no effect if the servant is not connected to the ORB.

Deprecated by the OMG in favor of the Portable Object Adapter APIs.

Overrides:

disconnect in class ORB

Parameters:

obj - The servant object to be disconnected from the ORB

getTransientServerId

public int getTransientServerId()

Description copied from class: ORB

Return this ORB's transient server ID. This is needed for initializing object adapters.

Specified by:

getTransientServerId in class ORB

getRequestDispatcherRegistry

public RequestDispatcherRegistry getRequestDispatcherRegistry()

Specified by:

getRequestDispatcherRegistry in class ORB

getServiceContextRegistry

public ServiceContextRegistry getServiceContextRegistry()

Specified by:

getServiceContextRegistry in class ORB

isLocalHost

public boolean isLocalHost(String hostName)

Specified by:

isLocalHost in class ORB

isLocalServerId

public boolean isLocalServerId(int subcontractId,
                               int serverId)

Specified by:

isLocalServerId in class ORB

work_pending

public boolean work_pending()

This method always returns false because the ORB never needs the main thread to do work.

Overrides:

work_pending in class ORB

Returns:

true if there is work pending, meaning that the ORB needs the main thread to perform some work; false if there is no work pending and thus the ORB does not need the main thread

perform_work

public void perform_work()

This method does nothing. It is not required by the spec to do anything!

Overrides:

perform_work in class ORB

set_delegate

public void set_delegate(Object servant)

Overrides:

set_delegate in class ORB

See Also:

CORBA_2_3 package comments for unimplemented features

createOrIncrementInvocationInfo

public ClientInvocationInfo createOrIncrementInvocationInfo()

releaseOrDecrementInvocationInfo

public void releaseOrDecrementInvocationInfo()

getInvocationInfo

public ClientInvocationInfo getInvocationInfo()

setClientDelegateFactory

public void setClientDelegateFactory(ClientDelegateFactory factory)

Specified by:

setClientDelegateFactory in class ORB

getClientDelegateFactory

public ClientDelegateFactory getClientDelegateFactory()

Specified by:

getClientDelegateFactory in class ORB

setCorbaContactInfoListFactory

public void setCorbaContactInfoListFactory(CorbaContactInfoListFactory factory)

Specified by:

setCorbaContactInfoListFactory in class ORB

getCorbaContactInfoListFactory

public CorbaContactInfoListFactory getCorbaContactInfoListFactory()

Specified by:

getCorbaContactInfoListFactory in class ORB

setResolver

public void setResolver(Resolver resolver)

Set the resolver used in this ORB. This resolver will be used for list_initial_services and resolve_initial_references.

Specified by:

setResolver in class ORB

getResolver

public Resolver getResolver()

Get the resolver used in this ORB. This resolver will be used for list_initial_services and resolve_initial_references.

Specified by:

getResolver in class ORB

setLocalResolver

public void setLocalResolver(LocalResolver resolver)

Set the LocalResolver used in this ORB. This LocalResolver is used for register_initial_reference only.

Specified by:

setLocalResolver in class ORB

getLocalResolver

public LocalResolver getLocalResolver()

Get the LocalResolver used in this ORB. This LocalResolver is used for register_initial_reference only.

Specified by:

getLocalResolver in class ORB

setURLOperation

public void setURLOperation(Operation stringToObject)

Set the operation used in string_to_object calls. The Operation must expect a String and return an org.omg.CORBA.Object.

Specified by:

setURLOperation in class ORB

getURLOperation

public Operation getURLOperation()

Get the operation used in string_to_object calls. The Operation must expect a String and return an org.omg.CORBA.Object.

Specified by:

getURLOperation in class ORB

setINSDelegate

public void setINSDelegate(CorbaServerRequestDispatcher sdel)

Description copied from class: ORB

Set the ServerRequestDispatcher that should be used for handling INS requests.

Specified by:

setINSDelegate in class ORB

getTaggedComponentFactoryFinder

public TaggedComponentFactoryFinder getTaggedComponentFactoryFinder()

Description copied from class: ORB

Factory finders for the various parts of the IOR: tagged components, tagged profiles, and tagged profile templates.

Specified by:

getTaggedComponentFactoryFinder in class ORB

getTaggedProfileFactoryFinder

public IdentifiableFactoryFinder getTaggedProfileFactoryFinder()

Specified by:

getTaggedProfileFactoryFinder in class ORB

getTaggedProfileTemplateFactoryFinder

public IdentifiableFactoryFinder getTaggedProfileTemplateFactoryFinder()

Specified by:

getTaggedProfileTemplateFactoryFinder in class ORB

getObjectKeyFactory

public ObjectKeyFactory getObjectKeyFactory()

Specified by:

getObjectKeyFactory in class ORB

setObjectKeyFactory

public void setObjectKeyFactory(ObjectKeyFactory factory)

Specified by:

setObjectKeyFactory in class ORB

getTransportManager

public TransportManager getTransportManager()

getCorbaTransportManager

public CorbaTransportManager getCorbaTransportManager()

Specified by:

getCorbaTransportManager in class ORB

getLegacyServerSocketManager

public LegacyServerSocketManager getLegacyServerSocketManager()

Specified by:

getLegacyServerSocketManager in class ORB

setThreadPoolManager

public void setThreadPoolManager(ThreadPoolManager mgr)

Specified by:

setThreadPoolManager in class ORB

getThreadPoolManager

public ThreadPoolManager getThreadPoolManager()

Specified by:

getThreadPoolManager in class ORB

getCopierManager

public CopierManager getCopierManager()

Specified by:

getCopierManager in class ORB