- java.lang.Object
-
- org.omg.CORBA.ORB
-
- Direct Known Subclasses:
- ORB
public abstract class ORB extends Object
A class providing APIs for the CORBA Object Request Broker features. TheORB
class also provides "pluggable ORB implementation" APIs that allow another vendor's ORB implementation to be used.An ORB makes it possible for CORBA objects to communicate with each other by connecting objects making requests (clients) with objects servicing requests (servers).
The
ORB
class, which encapsulates generic CORBA functionality, does the following: (Note that items 5 and 6, which include most of the methods in the classORB
, are typically used with theDynamic Invocation Interface
(DII) and theDynamic Skeleton Interface
(DSI). These interfaces may be used by a developer directly, but most commonly they are used by the ORB internally and are not seen by the general programmer.)- initializes the ORB implementation by supplying values for predefined properties and environmental parameters
- obtains initial object references to services such as
the NameService using the method
resolve_initial_references
- converts object references to strings and back
- connects the ORB to a servant (an instance of a CORBA object implementation) and disconnects the ORB from a servant
- creates objects such as
TypeCode
Any
NamedValue
Context
Environment
- lists (such as
NVList
) containing these objects
- sends multiple messages in the DII
The
ORB
class can be used to obtain references to objects implemented anywhere on the network.An application or applet gains access to the CORBA environment by initializing itself into an
ORB
using one of threeinit
methods. Two of the three methods use the properties (associations of a name with a value) shown in the table below.
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()
These properties allow a different vendor's
ORB
implementation to be "plugged in."When an ORB instance is being created, the class name of the ORB implementation is located using the following standard search order:
- check in Applet parameter or application string array, if any
- check in properties parameter, if any
- check in the System properties
- check in the orb.properties file located in the user.home directory (if any)
- check in the orb.properties file located in the java.home/lib directory (if any)
- fall back on a hardcoded default behavior (use the Java IDL implementation)
Note that Java IDL provides a default implementation for the fully-functional ORB and for the Singleton ORB. When the method
init
is given no parameters, the default Singleton ORB is returned. When the methodinit
is given parameters but no ORB class is specified, the Java IDL ORB implementation is returned.The following code fragment creates an
ORB
object initialized with the default ORB Singleton. This ORB has a restricted implementation to prevent malicious applets from doing anything beyond creating typecodes. It is called a singleton because there is only one instance for an entire virtual machine.ORB orb = ORB.init();
The following code fragment creates an
ORB
object for an application. The parameterargs
represents the arguments supplied to the application'smain
method. Since the property specifies the ORB class to be "SomeORBImplementation", the new ORB will be initialized with that ORB implementation. If p had been null, and the arguments had not specified an ORB class, the new ORB would have been initialized with the default Java IDL implementation.Properties p = new Properties(); p.put("org.omg.CORBA.ORBClass", "SomeORBImplementation"); ORB orb = ORB.init(args, p);
The following code fragment creates an
ORB
object for the applet supplied as the first parameter. If the given applet does not specify an ORB class, the new ORB will be initialized with the default Java IDL implementation.ORB orb = ORB.init(myApplet, null);
An application or applet can be initialized in one or more ORBs. ORB initialization is a bootstrap call into the CORBA world.
- Since:
- JDK1.2
-
-
Constructor Summary
Constructors Constructor and Description ORB()
-
Method Summary
Methods Modifier and Type Method and Description void
connect(Object obj)
Connects the given servant object (a Java object that is an instance of the server implementation class) to the ORB.TypeCode
create_abstract_interface_tc(String id, String name)
Create aTypeCode
object for an IDL abstract interface.abstract TypeCode
create_alias_tc(String id, String name, TypeCode original_type)
Creates aTypeCode
object representing an IDLalias
(typedef
).abstract Any
create_any()
Creates an IDLAny
object initialized to contain aTypecode
object whosekind
field is set toTCKind.tc_null
.abstract TypeCode
create_array_tc(int length, TypeCode element_type)
Creates aTypeCode
object representing an IDLarray
.DynAny
create_basic_dyn_any(TypeCode type)
Deprecated.Use the new DynAnyFactory API insteadabstract ContextList
create_context_list()
Creates an emptyContextList
object.DynAny
create_dyn_any(Any value)
Deprecated.Use the new DynAnyFactory API insteadDynArray
create_dyn_array(TypeCode type)
Deprecated.Use the new DynAnyFactory API insteadDynEnum
create_dyn_enum(TypeCode type)
Deprecated.Use the new DynAnyFactory API insteadDynSequence
create_dyn_sequence(TypeCode type)
Deprecated.Use the new DynAnyFactory API insteadDynStruct
create_dyn_struct(TypeCode type)
Deprecated.Use the new DynAnyFactory API insteadDynUnion
create_dyn_union(TypeCode type)
Deprecated.Use the new DynAnyFactory API insteadabstract TypeCode
create_enum_tc(String id, String name, String[] members)
Creates aTypeCode
object representing an IDLenum
.abstract Environment
create_environment()
Creates anEnvironment
object.abstract ExceptionList
create_exception_list()
Creates an emptyExceptionList
object.abstract TypeCode
create_exception_tc(String id, String name, StructMember[] members)
Creates aTypeCode
object representing an IDLexception
.TypeCode
create_fixed_tc(short digits, short scale)
Create aTypeCode
object for an IDL fixed type.abstract TypeCode
create_interface_tc(String id, String name)
Creates aTypeCode
object representing an IDLinterface
.abstract NVList
create_list(int count)
Allocates anNVList
with (probably) enough space for the specified number ofNamedValue
objects.abstract NamedValue
create_named_value(String s, Any any, int flags)
Creates aNamedValue
object using the given name, value, and argument mode flags.TypeCode
create_native_tc(String id, String name)
Create aTypeCode
object for an IDL native type.NVList
create_operation_list(Object oper)
Creates anNVList
initialized with argument descriptions for the operation described in the givenOperationDef
object.abstract OutputStream
create_output_stream()
Creates a neworg.omg.CORBA.portable.OutputStream
into which IDL method parameters can be marshalled during method invocation.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.abstract TypeCode
create_recursive_sequence_tc(int bound, int offset)
Deprecated.Use a combination of create_recursive_tc and create_sequence_tc insteadTypeCode
create_recursive_tc(String id)
Create a recursiveTypeCode
object which serves as a placeholder for a concrete TypeCode during the process of creating TypeCodes which contain recursion.abstract TypeCode
create_sequence_tc(int bound, TypeCode element_type)
Creates aTypeCode
object representing an IDLsequence
.abstract TypeCode
create_string_tc(int bound)
Creates aTypeCode
object representing a bounded IDLstring
.abstract TypeCode
create_struct_tc(String id, String name, StructMember[] members)
Creates aTypeCode
object representing an IDLstruct
.abstract TypeCode
create_union_tc(String id, String name, TypeCode discriminator_type, UnionMember[] members)
Creates aTypeCode
object representing an IDLunion
.TypeCode
create_value_box_tc(String id, String name, TypeCode boxed_type)
Creates aTypeCode
object for an IDL value box.TypeCode
create_value_tc(String id, String name, short type_modifier, TypeCode concrete_base, ValueMember[] members)
Create aTypeCode
object for an IDL value type.abstract TypeCode
create_wstring_tc(int bound)
Creates aTypeCode
object representing a bounded IDLwstring
(wide string).void
destroy()
Destroys the ORB so that its resources can be reclaimed.void
disconnect(Object obj)
Disconnects the given servant object from the ORB.Current
get_current()
Deprecated.useresolve_initial_references
.abstract Context
get_default_context()
Gets the defaultContext
object.abstract Request
get_next_response()
Gets the nextRequest
instance for which a response has been received.abstract TypeCode
get_primitive_tc(TCKind tcKind)
Retrieves theTypeCode
object that represents the given primitive IDL type.boolean
get_service_information(short service_type, ServiceInformationHolder service_info)
Used to obtain information about CORBA facilities and services that are supported by this ORB.static ORB
init()
Returns theORB
singleton object.static ORB
init(Applet app, Properties props)
Creates a newORB
instance for an applet.static ORB
init(String[] args, Properties props)
Creates a newORB
instance for a standalone application.abstract String[]
list_initial_services()
Returns a list of the initially available CORBA object references, such as "NameService" and "InterfaceRepository".abstract String
object_to_string(Object obj)
Converts the given CORBA object reference to a string.void
perform_work()
Performs an implementation-dependent unit of work if called by the main thread.abstract boolean
poll_next_response()
Finds out if any of the deferred (asynchronous) invocations have a response yet.abstract Object
resolve_initial_references(String object_name)
Resolves a specific object reference from the set of available initial service names.void
run()
This operation blocks the current thread until the ORB has completed the shutdown process, initiated when some thread callsshutdown
.abstract void
send_multiple_requests_deferred(Request[] req)
Sends multiple dynamic (DII) requests asynchronously.abstract void
send_multiple_requests_oneway(Request[] req)
Sends multiple dynamic (DII) requests asynchronously without expecting any responses.protected abstract void
set_parameters(Applet app, Properties props)
Allows the ORB implementation to be initialized with the given applet and parameters.protected abstract void
set_parameters(String[] args, Properties props)
Allows the ORB implementation to be initialized with the given parameters and properties.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 thewait_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.abstract Object
string_to_object(String str)
Converts a string produced by the methodobject_to_string
back to a CORBA object reference.boolean
work_pending()
Returnstrue
if the ORB needs the main thread to perform some work, andfalse
if the ORB does not need the main thread.
-
-
-
Method Detail
-
init
public static ORB init()
Returns theORB
singleton object. This method always returns the same ORB instance, which is an instance of the class described by theorg.omg.CORBA.ORBSingletonClass
system property.This no-argument version of the method
init
is used primarily as a factory forTypeCode
objects, which are used byHelper
classes to implement the methodtype
. It is also used to createAny
objects that are used to describeunion
labels (as part of creating aTypeCode
object for aunion
).This method is not intended to be used by applets, and in the event that it is called in an applet environment, the ORB it returns is restricted so that it can be used only as a factory for
TypeCode
objects. AnyTypeCode
objects it produces can be safely shared among untrusted applets.If an ORB is created using this method from an applet, a system exception will be thrown if methods other than those for creating
TypeCode
objects are invoked.- Returns:
- the singleton ORB
-
init
public static ORB init(String[] args, Properties props)
Creates a newORB
instance for a standalone application. This method may be called from applications only and returns a new fully functionalORB
object each time it is called.- Parameters:
args
- command-line arguments for the application'smain
method; may benull
props
- application-specific properties; may benull
- Returns:
- the newly-created ORB instance
-
init
public static ORB init(Applet app, Properties props)
Creates a newORB
instance for an applet. This method may be called from applets only and returns a new fully-functionalORB
object each time it is called.- Parameters:
app
- the applet; may benull
props
- applet-specific properties; may benull
- Returns:
- the newly-created ORB instance
-
set_parameters
protected abstract void set_parameters(String[] args, Properties props)
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 appropriateinit
method to pass in its parameters.- Parameters:
args
- command-line arguments for the application'smain
method; may benull
props
- application-specific properties; may benull
-
set_parameters
protected abstract void set_parameters(Applet app, Properties props)
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 appropriateinit
method to pass in its parameters.- Parameters:
app
- the applet; may benull
props
- applet-specific properties; may benull
-
connect
public void connect(Object obj)
Connects the given servant object (a Java object that is an instance of the server implementation class) to the ORB. The servant class must extend theImplBase
class corresponding to the interface that is supported by the server. The servant must thus be a CORBA object reference, and inherit fromorg.omg.CORBA.Object
. Servants created by the user can start receiving remote invocations after the methodconnect
has been called. A servant may also be automatically and implicitly connected to the ORB if it is passed as an IDL parameter in an IDL method invocation on a non-local object, that is, if the servant object has to be marshalled and sent outside of the process address space.Calling the method
connect
has no effect when the servant object is already connected to the ORB.Deprecated by the OMG in favor of the Portable Object Adapter APIs.
- Parameters:
obj
- The servant object reference
-
destroy
public void destroy()
Destroys the ORB so that its resources can be reclaimed. Any operation invoked on a destroyed ORB reference will throw theOBJECT_NOT_EXIST
exception. Once an ORB has been destroyed, another call toinit
with the same ORBid will return a reference to a newly constructed ORB.If
destroy
is called on an ORB that has not been shut down, it will start the shut down process and block until the ORB has shut down before it destroys the ORB.
If an application callsdestroy
in a thread that is currently servicing an invocation, theBAD_INV_ORDER
system exception will be thrown with the OMG minor code 3, since blocking would result in a deadlock.For maximum portability and to avoid resource leaks, an application should always call
shutdown
anddestroy
on all ORB instances before exiting.- Throws:
BAD_INV_ORDER
- if the current thread is servicing an invocation
-
disconnect
public void disconnect(Object obj)
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 exceptionorg.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.
- Parameters:
obj
- The servant object to be disconnected from the ORB
-
list_initial_services
public abstract String[] list_initial_services()
Returns a list of the initially available CORBA object references, such as "NameService" and "InterfaceRepository".- Returns:
- an array of
String
objects that represent the object references for CORBA services that are initially available with this ORB
-
resolve_initial_references
public abstract Object resolve_initial_references(String object_name) throws InvalidName
Resolves a specific object reference from the set of available initial service names.- Parameters:
object_name
- the name of the initial service as a string- Returns:
- the object reference associated with the given name
- Throws:
InvalidName
- if the given name is not associated with a known service
-
object_to_string
public abstract String object_to_string(Object obj)
Converts the given CORBA object reference to a string. Note that the format of this string is predefined by IIOP, allowing strings generated by a different ORB to be converted back into an object reference.The resulting
String
object may be stored or communicated in any way that aString
object can be manipulated.- Parameters:
obj
- the object reference to stringify- Returns:
- the string representing the object reference
-
string_to_object
public abstract Object string_to_object(String str)
Converts a string produced by the methodobject_to_string
back to a CORBA object reference.- Parameters:
str
- the string to be converted back to an object reference. It must be the result of converting an object reference to a string using the methodobject_to_string
.- Returns:
- the object reference
-
create_list
public abstract NVList create_list(int count)
Allocates anNVList
with (probably) enough space for the specified number ofNamedValue
objects. Note that the specified size is only a hint to help with storage allocation and does not imply the maximum size of the list.- Parameters:
count
- suggested number ofNamedValue
objects for which to allocate space- Returns:
- the newly-created
NVList
- See Also:
NVList
-
create_operation_list
public NVList create_operation_list(Object oper)
Creates anNVList
initialized with argument descriptions for the operation described in the givenOperationDef
object. ThisOperationDef
object is obtained from an Interface Repository. The arguments in the returnedNVList
object are in the same order as in the original IDL operation definition, which makes it possible for the list to be used in dynamic invocation requests.- Parameters:
oper
- theOperationDef
object to use to create the list- Returns:
- a newly-created
NVList
object containing descriptions of the arguments to the method described in the givenOperationDef
object - See Also:
NVList
-
create_named_value
public abstract NamedValue create_named_value(String s, Any any, int flags)
Creates aNamedValue
object using the given name, value, and argument mode flags.A
NamedValue
object serves as (1) a parameter or return value or (2) a context property. It may be used by itself or as an element in anNVList
object.- Parameters:
s
- the name of theNamedValue
objectany
- theAny
value to be inserted into theNamedValue
objectflags
- the argument mode flags for theNamedValue
: one ofARG_IN.value
,ARG_OUT.value
, orARG_INOUT.value
.- Returns:
- the newly-created
NamedValue
object - See Also:
NamedValue
-
create_exception_list
public abstract ExceptionList create_exception_list()
Creates an emptyExceptionList
object.- Returns:
- the newly-created
ExceptionList
object
-
create_context_list
public abstract ContextList create_context_list()
Creates an emptyContextList
object.- Returns:
- the newly-created
ContextList
object - See Also:
ContextList
,Context
-
get_default_context
public abstract Context get_default_context()
Gets the defaultContext
object.- Returns:
- the default
Context
object - See Also:
Context
-
create_environment
public abstract Environment create_environment()
Creates anEnvironment
object.- Returns:
- the newly-created
Environment
object - See Also:
Environment
-
create_output_stream
public abstract OutputStream create_output_stream()
Creates a neworg.omg.CORBA.portable.OutputStream
into which IDL method parameters can be marshalled during method invocation.- Returns:
- the newly-created
org.omg.CORBA.portable.OutputStream
object
-
send_multiple_requests_oneway
public abstract void send_multiple_requests_oneway(Request[] req)
Sends multiple dynamic (DII) requests asynchronously without expecting any responses. Note that oneway invocations are not guaranteed to reach the server.- Parameters:
req
- an array of request objects
-
send_multiple_requests_deferred
public abstract void send_multiple_requests_deferred(Request[] req)
Sends multiple dynamic (DII) requests asynchronously.- Parameters:
req
- an array ofRequest
objects
-
poll_next_response
public abstract boolean poll_next_response()
Finds out if any of the deferred (asynchronous) invocations have a response yet.- Returns:
true
if there is a response available;false
otherwise
-
get_next_response
public abstract Request get_next_response() throws WrongTransaction
Gets the nextRequest
instance for which a response has been received.- Returns:
- the next
Request
object ready with a response - Throws:
WrongTransaction
- if the methodget_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.
-
get_primitive_tc
public abstract TypeCode get_primitive_tc(TCKind tcKind)
Retrieves theTypeCode
object that represents the given primitive IDL type.- Parameters:
tcKind
- theTCKind
instance corresponding to the desired primitive type- Returns:
- the requested
TypeCode
object
-
create_struct_tc
public abstract TypeCode create_struct_tc(String id, String name, StructMember[] members)
Creates aTypeCode
object representing an IDLstruct
. TheTypeCode
object is initialized with the given id, name, and members.- Parameters:
id
- the repository id for thestruct
name
- the name of thestruct
members
- an array describing the members of thestruct
- Returns:
- a newly-created
TypeCode
object describing an IDLstruct
-
create_union_tc
public abstract TypeCode create_union_tc(String id, String name, TypeCode discriminator_type, UnionMember[] members)
Creates aTypeCode
object representing an IDLunion
. TheTypeCode
object is initialized with the given id, name, discriminator type, and members.- Parameters:
id
- the repository id of theunion
name
- the name of theunion
discriminator_type
- the type of theunion
discriminatormembers
- an array describing the members of theunion
- Returns:
- a newly-created
TypeCode
object describing an IDLunion
-
create_enum_tc
public abstract TypeCode create_enum_tc(String id, String name, String[] members)
Creates aTypeCode
object representing an IDLenum
. TheTypeCode
object is initialized with the given id, name, and members.- Parameters:
id
- the repository id for theenum
name
- the name for theenum
members
- an array describing the members of theenum
- Returns:
- a newly-created
TypeCode
object describing an IDLenum
-
create_alias_tc
public abstract TypeCode create_alias_tc(String id, String name, TypeCode original_type)
Creates aTypeCode
object representing an IDLalias
(typedef
). TheTypeCode
object is initialized with the given id, name, and original type.- Parameters:
id
- the repository id for the aliasname
- the name for the aliasoriginal_type
- theTypeCode
object describing the original type for which this is an alias- Returns:
- a newly-created
TypeCode
object describing an IDLalias
-
create_exception_tc
public abstract TypeCode create_exception_tc(String id, String name, StructMember[] members)
Creates aTypeCode
object representing an IDLexception
. TheTypeCode
object is initialized with the given id, name, and members.- Parameters:
id
- the repository id for theexception
name
- the name for theexception
members
- an array describing the members of theexception
- Returns:
- a newly-created
TypeCode
object describing an IDLexception
-
create_interface_tc
public abstract TypeCode create_interface_tc(String id, String name)
Creates aTypeCode
object representing an IDLinterface
. TheTypeCode
object is initialized with the given id and name.- Parameters:
id
- the repository id for the interfacename
- the name for the interface- Returns:
- a newly-created
TypeCode
object describing an IDLinterface
-
create_string_tc
public abstract TypeCode create_string_tc(int bound)
Creates aTypeCode
object representing a bounded IDLstring
. TheTypeCode
object is initialized with the given bound, which represents the maximum length of the string. Zero indicates that the string described by this type code is unbounded.- Parameters:
bound
- the bound for thestring
; cannot be negative- Returns:
- a newly-created
TypeCode
object describing a bounded IDLstring
- Throws:
BAD_PARAM
- if bound is a negative value
-
create_wstring_tc
public abstract TypeCode create_wstring_tc(int bound)
Creates aTypeCode
object representing a bounded IDLwstring
(wide string). TheTypeCode
object is initialized with the given bound, which represents the maximum length of the wide string. Zero indicates that the string described by this type code is unbounded.- Parameters:
bound
- the bound for thewstring
; cannot be negative- Returns:
- a newly-created
TypeCode
object describing a bounded IDLwstring
- Throws:
BAD_PARAM
- if bound is a negative value
-
create_sequence_tc
public abstract TypeCode create_sequence_tc(int bound, TypeCode element_type)
Creates aTypeCode
object representing an IDLsequence
. TheTypeCode
object is initialized with the given bound and element type.- Parameters:
bound
- the bound for thesequence
, 0 if unboundedelement_type
- theTypeCode
object describing the elements contained in thesequence
- Returns:
- a newly-created
TypeCode
object describing an IDLsequence
-
create_recursive_sequence_tc
@Deprecated public abstract TypeCode create_recursive_sequence_tc(int bound, int offset)
Deprecated. Use a combination of create_recursive_tc and create_sequence_tc insteadCreates aTypeCode
object representing a a recursive IDLsequence
.For the IDL
struct
Node in following code fragment, the offset parameter for creating its sequence would be 1:Struct Node { long value; Sequence <Node> subnodes; };
- Parameters:
bound
- the bound for the sequence, 0 if unboundedoffset
- the index to the enclosingTypeCode
object that describes the elements of this sequence- Returns:
- a newly-created
TypeCode
object describing a recursive sequence - See Also:
create_recursive_tc
,create_sequence_tc
-
create_array_tc
public abstract TypeCode create_array_tc(int length, TypeCode element_type)
Creates aTypeCode
object representing an IDLarray
. TheTypeCode
object is initialized with the given length and element type.- Parameters:
length
- the length of thearray
element_type
- aTypeCode
object describing the type of element contained in thearray
- Returns:
- a newly-created
TypeCode
object describing an IDLarray
-
create_native_tc
public TypeCode create_native_tc(String id, String name)
Create aTypeCode
object for an IDL native type.- 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)
Create aTypeCode
object for an IDL abstract interface.- 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)
Create aTypeCode
object for an IDL fixed type.- 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)
Create aTypeCode
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.- 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_TRUNCATABLEconcrete_base
- aTypeCode
object describing the concrete valuetype basemembers
- an array containing the members of the value type- Returns:
- the requested TypeCode
-
create_recursive_tc
public TypeCode create_recursive_tc(String id)
Create a recursiveTypeCode
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 aBAD_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.
- 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)
Creates aTypeCode
object for an IDL value box.- Parameters:
id
- the logical id for the value typename
- the name of the value typeboxed_type
- the TypeCode for the type- Returns:
- the requested TypeCode
-
create_any
public abstract Any create_any()
Creates an IDLAny
object initialized to contain aTypecode
object whosekind
field is set toTCKind.tc_null
.- Returns:
- a newly-created
Any
object
-
get_current
@Deprecated public Current get_current()
Deprecated. useresolve_initial_references
.Retrieves aCurrent
object. TheCurrent
interface is used to manage thread-specific information for use by services such as transactions and security.- Returns:
- a newly-created
Current
object - See Also:
CORBA
package comments for unimplemented features
-
run
public void run()
This operation blocks the current thread until the ORB has completed the shutdown process, initiated when some thread callsshutdown
. It may be used by multiple threads which get all notified when the ORB shuts down.
-
shutdown
public 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 thewait_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, theBAD_INV_ORDER
system exception will be thrown with the OMG minor code 3, since blocking would result in a deadlock.
If thewait_for_completion
parameter isFALSE
, 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 theBAD_INV_ORDER
system exception with the OMG minor code 4.The
ORB.run
method will return aftershutdown
has been called.- Parameters:
wait_for_completion
-true
if the call should block until the shutdown is complete;false
if it should return immediately- Throws:
BAD_INV_ORDER
- if the current thread is servicing an invocation
-
work_pending
public boolean work_pending()
Returnstrue
if the ORB needs the main thread to perform some work, andfalse
if the ORB does not need the main thread.- 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()
Performs an implementation-dependent unit of work if called by the main thread. Otherwise it does nothing. The methodswork_pending
andperform_work
can be used in conjunction to implement a simple polling loop that multiplexes the main thread among the ORB and other activities.
-
get_service_information
public boolean get_service_information(short service_type, ServiceInformationHolder service_info)
Used to obtain information about CORBA facilities and services that are supported by this ORB. The service type for which information is being requested is passed in as the in parameter service_type, the values defined by constants in the CORBA module. If service information is available for that type, that is returned in the out parameter service_info, and the operation returns the value true. If no information for the requested services type is available, the operation returns false (i.e., the service is not supported by this ORB).- Parameters:
service_type
- ashort
indicating the service type for which information is being requestedservice_info
- aServiceInformationHolder
object that will hold theServiceInformation
object produced by this method- Returns:
true
if service information is available for the service_type; false if no information for the requested services type is available- See Also:
CORBA
package comments for unimplemented features
-
create_dyn_any
@Deprecated public DynAny create_dyn_any(Any value)
Deprecated. Use the new DynAnyFactory API insteadCreates a newDynAny
object from the givenAny
object.- Parameters:
value
- theAny
object from which to create a newDynAny
object- Returns:
- the new
DynAny
object created from the givenAny
object - See Also:
CORBA
package comments for unimplemented features
-
create_basic_dyn_any
@Deprecated public DynAny create_basic_dyn_any(TypeCode type) throws InconsistentTypeCode
Deprecated. Use the new DynAnyFactory API insteadCreates a basicDynAny
object from the givenTypeCode
object.- Parameters:
type
- theTypeCode
object from which to create a newDynAny
object- Returns:
- the new
DynAny
object created from the givenTypeCode
object - Throws:
InconsistentTypeCode
- if the givenTypeCode
object is not consistent with the operation.- See Also:
CORBA
package comments for unimplemented features
-
create_dyn_struct
@Deprecated public DynStruct create_dyn_struct(TypeCode type) throws InconsistentTypeCode
Deprecated. Use the new DynAnyFactory API insteadCreates a newDynStruct
object from the givenTypeCode
object.- Parameters:
type
- theTypeCode
object from which to create a newDynStruct
object- Returns:
- the new
DynStruct
object created from the givenTypeCode
object - Throws:
InconsistentTypeCode
- if the givenTypeCode
object is not consistent with the operation.- See Also:
CORBA
package comments for unimplemented features
-
create_dyn_sequence
@Deprecated public DynSequence create_dyn_sequence(TypeCode type) throws InconsistentTypeCode
Deprecated. Use the new DynAnyFactory API insteadCreates a newDynSequence
object from the givenTypeCode
object.- Parameters:
type
- theTypeCode
object from which to create a newDynSequence
object- Returns:
- the new
DynSequence
object created from the givenTypeCode
object - Throws:
InconsistentTypeCode
- if the givenTypeCode
object is not consistent with the operation.- See Also:
CORBA
package comments for unimplemented features
-
create_dyn_array
@Deprecated public DynArray create_dyn_array(TypeCode type) throws InconsistentTypeCode
Deprecated. Use the new DynAnyFactory API insteadCreates a newDynArray
object from the givenTypeCode
object.- Parameters:
type
- theTypeCode
object from which to create a newDynArray
object- Returns:
- the new
DynArray
object created from the givenTypeCode
object - Throws:
InconsistentTypeCode
- if the givenTypeCode
object is not consistent with the operation.- See Also:
CORBA
package comments for unimplemented features
-
create_dyn_union
@Deprecated public DynUnion create_dyn_union(TypeCode type) throws InconsistentTypeCode
Deprecated. Use the new DynAnyFactory API insteadCreates a newDynUnion
object from the givenTypeCode
object.- Parameters:
type
- theTypeCode
object from which to create a newDynUnion
object- Returns:
- the new
DynUnion
object created from the givenTypeCode
object - Throws:
InconsistentTypeCode
- if the givenTypeCode
object is not consistent with the operation.- See Also:
CORBA
package comments for unimplemented features
-
create_dyn_enum
@Deprecated public DynEnum create_dyn_enum(TypeCode type) throws InconsistentTypeCode
Deprecated. Use the new DynAnyFactory API insteadCreates a newDynEnum
object from the givenTypeCode
object.- Parameters:
type
- theTypeCode
object from which to create a newDynEnum
object- Returns:
- the new
DynEnum
object created from the givenTypeCode
object - Throws:
InconsistentTypeCode
- if the givenTypeCode
object is not consistent with the operation.- See Also:
CORBA
package comments for unimplemented features
-
create_policy
public Policy create_policy(int type, Any val) throws PolicyError
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.- Parameters:
type
- the PolicyType of the policy object to be createdval
- 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:
org.omg.CORBA.PolicyError
- when the requested policy is not supported or a requested initial state for the policy is not supported.PolicyError
-
-
Traduction non disponible
Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.
Version en cache
21/11/2024 21:21:50 Cette version de la page est en cache (à la date du 21/11/2024 21:21:50) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.Document créé le 16/09/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-org/omg/corba/orb.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.