Class org.omg.CORBA.ORB
All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class org.omg.CORBA.ORB

java.lang.Object
   |
   +----org.omg.CORBA.ORB

public class ORB
extends Object
Class ORB represents an implementation of a CORBA Object Request Broker. The ORB class can be used to obtain references to objects implemented anywhere on the network. Specific ORB implementations can extend this class to add new features.

Property Name Property Value
Standard Java CORBA Properties:
org.omg.CORBA.ORBClass class name of an ORB implementation
org.omg.CORBA.ORBSingletonClass class name of the ORB returned by init()
When creating an ORB instance, these values are located using a standard search order:

  1. check in Applet parameter or application string array
  2. check in properties parameter, if any
  3. check in the System properties
  4. fallback on a hardcoded default behavior

Constructor Index

 o ORB()

Method Index

 o connect(Skeleton)
All objects created by the user become ORB objects only after connect is called.
 o create_alias_tc(String, String, TypeCode)
Create a TypeCode for an alias.
 o create_any()
Create an Any.
 o create_array_tc(int, TypeCode)
Create a TypeCode for an array.
 o create_context_list()
Create a ContextList
 o create_enum_tc(String, String, String[])
Create a TypeCode for an enum.
 o create_environment()
Create an Environment
 o create_exception_list()
Create an ExceptionList
 o create_exception_tc(String, String, StructMember[])
Create a TypeCode for an exception.
 o create_interface_tc(String, String)
Create a TypeCode for an interface.
 o create_list(int)
Create an NVList
 o create_named_value(String, Any, int)
Create a NamedValue
 o create_operation_list(OperationDef)
Create an NVList corresponding to an OperationDef
 o create_output_stream()
Create a new Output Stream.
 o create_recursive_sequence_tc(int, int)
Create a recursive TypeCode in a sequence.
 o create_sequence_tc(int, TypeCode)
Create a TypeCode for a sequence.
 o create_string_tc(int)
Create a TypeCode for a string.
 o create_struct_tc(String, String, StructMember[])
Create a TypeCode for a structure.
 o create_union_tc(String, String, TypeCode, UnionMember[])
Create a TypeCode for a union.
 o create_wstring_tc(int)
Create a TypeCode for a wide string.
 o disconnect(Skeleton)
To stop an ORB object from receiving remote invocations disconnect needs to be called.
 o get_default_context()
Get the default Context object
 o get_next_response()
Get the next request that has gotten a response.
 o get_primitive_tc(TCKind)
Get the TypeCode for a primitive type.
 o init()
Return the ORB singleton object.
 o init(Applet, Properties)
Create a new ORB instance for an applet.
 o init(String[], Properties)
Create a new ORB instance for an application.
 o list_initial_services()
Return a list of the initially available CORBA objects.
 o object_to_string(Object)
Convert a COBRA object reference to a string.
 o poll_next_response()
Find out if any of the deferred invocations have a response yet.
 o resolve_initial_references(String)
Resolve a specific object reference from the set of available initial services.
 o send_multiple_requests_deferred(Request[])
Send multiple dynamic requests asynchronously.
 o send_multiple_requests_oneway(Request[])
Send multiple dynamic requests asynchronously without expecting any responses.
 o set_parameters(Applet, Properties)
 o set_parameters(String[], Properties)
 o string_to_object(String)
Convert a string to a CORBA object reference.

Constructors

 o ORB
  public ORB()

Methods

 o init
  public static ORB init()
Return the ORB singleton object. This method always returns the same ORB which is an instance of the class described by the org.omg.CORBA.ORBSingletonClass system property. When called in an applet environment, the returned ORB can only be used as a factory for TypeCodes. The resulting TypeCodes can be safely shared between untrusted applets.
Returns:
the singleton ORB
 o init
  public static ORB init(String args[],
                         Properties props)
Create a new ORB instance for an application.
Parameters:
args - application strings from main() method
props - application-specific properties
Returns:
the newly create ORB instance
 o init
  public static ORB init(Applet app,
                         Properties props)
Create a new ORB instance for an applet.
Parameters:
app - the applet
props - applet-specific properties
Returns:
the newly create ORB instance
 o set_parameters
  protected abstract void set_parameters(String args[],
                                         Properties props)
 o set_parameters
  protected abstract void set_parameters(Applet app,
                                         Properties props)
 o connect
  public abstract void connect(Skeleton s)
All objects created by the user become ORB objects only after connect is called.
 o disconnect
  public abstract void disconnect(Skeleton s)
To stop an ORB object from receiving remote invocations disconnect needs to be called.
 o list_initial_services
  public abstract String[] list_initial_services()
Return a list of the initially available CORBA objects.
Returns:
the list of object service names
Throws: SystemException
One of a fixed set of CORBA system exceptions.
 o resolve_initial_references
  public abstract Object resolve_initial_references(String name) throws InvalidName
Resolve a specific object reference from the set of available initial services. public * @param name the name of the object
Returns:
An object reference for the named object.
Throws: InvalidName
The given name is not associated with a known service.
Throws: SystemException
One of a fixed set of CORBA system exceptions.
 o object_to_string
  public abstract String object_to_string(Object obj)
Convert a COBRA object reference to a string.
Parameters:
obj - the object reference to stringify.
Returns:
the string
Throws: SystemException
One of a fixed set of CORBA system exceptions.
 o string_to_object
  public abstract Object string_to_object(String str)
Convert a string to a CORBA object reference.
Parameters:
str - the string
Returns:
the object reference.
Throws: SystemException
One of a fixed set of CORBA system exceptions.
 o create_list
  public abstract NVList create_list(int count)
Create an NVList
Parameters:
count - size of list to create
See Also:
NVList
 o create_operation_list
  public abstract NVList create_operation_list(OperationDef oper)
Create an NVList corresponding to an OperationDef
Parameters:
oper - operation def to use to create list
See Also:
NVList
 o create_named_value
  public abstract NamedValue create_named_value(String s,
                                                Any any,
                                                int flags)
Create a NamedValue
 o create_exception_list
  public abstract ExceptionList create_exception_list()
Create an ExceptionList
 o create_context_list
  public abstract ContextList create_context_list()
Create a ContextList
 o get_default_context
  public abstract Context get_default_context()
Get the default Context object
 o create_environment
  public abstract Environment create_environment()
Create an Environment
 o create_output_stream
  public abstract OutputStream create_output_stream()
Create a new Output Stream.
 o send_multiple_requests_oneway
  public abstract void send_multiple_requests_oneway(Request req[])
Send multiple dynamic requests asynchronously without expecting any responses.
Parameters:
req - an array of request objects.
 o send_multiple_requests_deferred
  public abstract void send_multiple_requests_deferred(Request req[])
Send multiple dynamic requests asynchronously.
Parameters:
req - an array of request objects.
 o poll_next_response
  public abstract boolean poll_next_response()
Find out if any of the deferred invocations have a response yet.
 o get_next_response
  public abstract Request get_next_response()
Get the next request that has gotten a response.
 o get_primitive_tc
  public abstract TypeCode get_primitive_tc(TCKind tcKind)
Get the TypeCode for a primitive type.
Parameters:
tcKind - the integer kind for the primitive type
Returns:
the requested TypeCode
 o create_struct_tc
  public abstract TypeCode create_struct_tc(String id,
                                            String name,
                                            StructMember members[])
Create a TypeCode for a structure.
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.
 o create_union_tc
  public abstract TypeCode create_union_tc(String id,
                                           String name,
                                           TypeCode discriminator_type,
                                           UnionMember members[])
Create a TypeCode for a union.
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.
 o create_enum_tc
  public abstract TypeCode create_enum_tc(String id,
                                          String name,
                                          String members[])
Create a TypeCode for an enum.
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.
 o create_alias_tc
  public abstract TypeCode create_alias_tc(String id,
                                           String name,
                                           TypeCode original_type)
Create a TypeCode for an alias.
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.
 o create_exception_tc
  public abstract TypeCode create_exception_tc(String id,
                                               String name,
                                               StructMember members[])
Create a TypeCode for an exception.
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.
 o create_interface_tc
  public abstract TypeCode create_interface_tc(String id,
                                               String name)
Create a TypeCode for an interface.
Parameters:
id - the logical id for the typecode.
name - the name for the typecode.
Returns:
the requested TypeCode.
 o create_string_tc
  public abstract TypeCode create_string_tc(int bound)
Create a TypeCode for a string.
Parameters:
bound - the bound for the string.
Returns:
the requested TypeCode.
 o create_wstring_tc
  public abstract TypeCode create_wstring_tc(int bound)
Create a TypeCode for a wide string.
Parameters:
bound - the bound for the string.
Returns:
the requested TypeCode.
 o create_sequence_tc
  public abstract TypeCode create_sequence_tc(int bound,
                                              TypeCode element_type)
Create a TypeCode for a sequence.
Parameters:
bound - the bound for the sequence.
element_type - the type of elements of the sequence.
Returns:
the requested TypeCode.
 o create_recursive_sequence_tc
  public abstract TypeCode create_recursive_sequence_tc(int bound,
                                                        int offset)
Create a recursive TypeCode in a sequence.
Parameters:
bound - the bound for the sequence.
offset - the index to the enclosing TypeCode that is being referenced.
Returns:
the requested TypeCode.
 o create_array_tc
  public abstract TypeCode create_array_tc(int length,
                                           TypeCode element_type)
Create a TypeCode for an array.
Parameters:
length - the length of the array.
element_type - the type of elements of the array.
Returns:
the requested TypeCode.
 o create_any
  public abstract Any create_any()
Create an Any. The returned object is initialized to contain a typecode of type TCKind.tc_null.
Returns:
the requested Any.

All Packages  Class Hierarchy  This Package  Previous  Next  Index