See: Description
Interface | Description |
---|---|
ARG_IN |
Signifies an "input" argument to an invocation,
meaning that the argument is being passed from the client to
the server.
|
ARG_INOUT |
Signifies an argument used for both input and output in an invocation,
meaning that the argument is being passed from the client to
the server and then back from the server to the client.
|
ARG_OUT |
A constant that signifies an "output" argument to an invocation,
meaning that the argument is being passed from the server to
the client.
|
BAD_POLICY |
A PolicyErrorCode which would be filled in
the PolicyError exception.
|
BAD_POLICY_TYPE |
A PolicyErrorCode which would be filled in
the PolicyError exception.
|
BAD_POLICY_VALUE |
Contains the value used to indicate a policy value that is
incorrect for a valid policy type in a call to the
create_policy method defined in the ORB class. |
CTX_RESTRICT_SCOPE |
A flag that can be used as the second parameter to the method
Context.get_values to restrict the search scope. |
Current |
Interfaces derived from the Current interface enable ORB and CORBA
services to provide access to information (context) associated with
the thread of execution in which they are running.
|
CurrentOperations |
The interface for Current.
|
CustomMarshal |
An abstract value type that is meant to
be used by the ORB, not the user.
|
DataInputStream |
Defines the methods used to read primitive data types from input streams
for unmarshaling custom value types.
|
DataOutputStream |
Defines the methods used to write primitive data types to output streams
for marshalling custom value types.
|
DomainManager |
Provides mechanisms for establishing and navigating relationships to
superior and subordinate domains, as well as for creating and accessing
policies.
|
DomainManagerOperations |
Provides the DomainManager with the means to access policies.
|
DynAny | Deprecated |
IDLTypeOperations |
This interface must be implemented by all IDLType objects.
|
IRObject |
An IRObject IDL interface represents the most generic interface
from which all other Interface Repository interfaces are derived,
even the Repository itself.
|
IRObjectOperations |
This is the Operations interface for the mapping from IRObject.
|
Object |
The definition for a CORBA object reference.
|
OMGVMCID |
The vendor minor code ID reserved for OMG.
|
Policy |
Interfaces derived from the Policy interface allow an
ORB or CORBA service access to certain choices that affect
its operation.
|
PolicyOperations |
Provides the operations for a
Policy object. |
PRIVATE_MEMBER |
Constant to define a private member in the
ValueMember class. |
PUBLIC_MEMBER |
Constant to define a public member in the
ValueMember
class. |
UNSUPPORTED_POLICY |
One of the PolicyErrorCodes which would be filled if
the requested Policy is understood to be valid by the
ORB, but is not currently supported.
|
UNSUPPORTED_POLICY_VALUE |
A PolicyErrorCode which would be filled if the value
requested for the Policy is of a
valid type and within the valid range for that type, but this valid value
is not currently supported.
|
VM_ABSTRACT |
Defines the code used to represent an Abstract interface in
a typecode.
|
VM_CUSTOM |
Defines the code used to represent a custom marshalled value type in
a typecode.
|
VM_NONE |
Defines the code used to represent the one of the values of a value type
in a typecode.
|
VM_TRUNCATABLE |
Defines the code used to represent a truncatable value type in
a typecode.
|
Class | Description | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
_IDLTypeStub |
The Stub for IDLType.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
_PolicyStub |
The Stub for Policy.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Any |
Serves as a container for any data that can be
described in IDL or for any IDL primitive type.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AnyHolder |
The Holder for Any.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AnySeqHelper |
The Helper for AnySeq.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
AnySeqHolder |
The Holder for AnySeq.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
BooleanHolder |
The Holder for Boolean.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
BooleanSeqHelper |
The Helper for BooleanSeq.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
BooleanSeqHolder |
The Holder for BooleanSeq.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ByteHolder |
The Holder for Byte.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
CharHolder |
The Holder for Char.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
CharSeqHelper |
The Helper for CharSeq.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
CharSeqHolder |
The Holder for CharSeq.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
CompletionStatus |
An object that indicates whether a method had completed running
when a
SystemException was thrown. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
CompletionStatusHelper |
The Helper for CompletionStatus.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Context |
An object used in
Request operations
to specify the context object in which context strings
must be resolved before being sent along with the request invocation. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ContextList |
An object containing a modifiable list of
String objects
that represent property names. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
CurrentHelper |
The Helper for Current.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
CurrentHolder |
The Holder for Current.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DefinitionKind |
The class that provides the constants used to identify the type of an
Interface Repository object.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DefinitionKindHelper |
The Helper for DefinitionKind.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DoubleHolder |
The Holder for Double.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DoubleSeqHelper |
The Helper for DoubleSeq.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DoubleSeqHolder |
The Holder for DoubleSeq.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
DynamicImplementation | Deprecated
org.omg.CORBA.DynamicImplementation
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Environment |
A container (holder) for an exception that is used in
Request
operations to make exceptions available to the client. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ExceptionList |
An object used in
Request operations to
describe the exceptions that can be thrown by a method. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
FieldNameHelper |
The Helper for FieldName.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
FixedHolder |
The Holder for Fixed.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
FloatHolder |
The Holder for Float.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
FloatSeqHelper |
The Helper for FloatSeq.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
FloatSeqHolder |
The Holder for FloatSeq.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IdentifierHelper |
The Helper for Identifier.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IDLTypeHelper |
The Helper for IDLType.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
IntHolder |
The Holder for Int.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
LocalObject |
Used as a base class for implementation of a local IDL interface in the
Java language mapping.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
LongHolder |
The Holder for Long.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
LongLongSeqHelper |
The Helper for LongLongSeq.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
LongLongSeqHolder |
The Holder for LongLongSeq.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
LongSeqHelper |
The Helper for LongSeqHelper.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
LongSeqHolder |
The Holder for LongSeq.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
NamedValue |
An object used in the DII and DSI to describe
arguments and return values.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
NameValuePair |
Associates a name with a value that is an
attribute of an IDL struct, and is used in the DynStruct APIs.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
NameValuePairHelper |
The Helper for NameValuePair.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
NVList |
A modifiable list containing
NamedValue objects. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ObjectHelper | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ObjectHolder |
The Holder for Object.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
OctetSeqHelper |
The Helper for OctetSeq.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
OctetSeqHolder |
The Holder for OctetSeq.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ORB |
A class providing APIs for the CORBA Object Request Broker
features.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ParameterMode |
Enumeration of parameter modes for Parameter.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ParameterModeHelper |
Enumeration of parameter modes for Parameter.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ParameterModeHolder |
Enumeration of parameter modes for Parameter.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PolicyErrorCodeHelper |
Encapsulates a reason a Policy may be invalid.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PolicyErrorHelper |
Thrown to indicate problems with parameter values passed to the
ORB.create_policy operation. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PolicyErrorHolder |
Thrown to indicate problems with parameter values passed to the
ORB.create_policy operation. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PolicyHelper |
The Helper for Policy.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PolicyHolder |
The Holder for Policy.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PolicyListHelper |
The Helper for PolicyList.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PolicyListHolder |
The Holder for PolicyList.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PolicyTypeHelper |
The Helper for PolicyType.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Principal | Deprecated
Deprecated by CORBA 2.2.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
PrincipalHolder | Deprecated
Deprecated by CORBA 2.2.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
RepositoryIdHelper |
The Helper for RepositoryId.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Request |
An object containing the information necessary for
invoking a method.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ServerRequest |
An object that captures the explicit state of a request
for the Dynamic Skeleton Interface (DSI).
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ServiceDetail |
An object that represents an ORB service: its
service_detail_type
field contains the type of the ORB service, and its service_detail
field contains a description of the ORB service. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ServiceDetailHelper | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ServiceInformation |
An IDL struct in the CORBA module that
stores information about a CORBA service available in the
ORB implementation and is obtained from the ORB.get_service_information
method.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ServiceInformationHelper | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ServiceInformationHolder |
The Holder for ServiceInformation.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SetOverrideType |
The mapping of a CORBA
enum tagging
SET_OVERRIDE and ADD_OVERRIDE , which
indicate whether policies should replace the
existing policies of an Object or be added to them. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
SetOverrideTypeHelper |
The Helper for SetOverrideType.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ShortHolder |
The Holder for Short.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ShortSeqHelper |
The Helper for ShortSeqHelper.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ShortSeqHolder |
The Holder for ShortSeq.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
StringHolder |
The Holder for String.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
StringSeqHelper |
An array of Strings
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
StringSeqHolder |
An array of Strings
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
StringValueHelper |
The Helper for StringValue.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
StructMember |
Describes a member of an IDL
struct in the
Interface Repository, including
the name of the struct member, the type of
the struct member, and
the typedef that represents the IDL type of the
struct member
described the struct member object. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
StructMemberHelper |
The Helper for StructMember.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TCKind |
The Java mapping of the IDL enum
TCKind , which
specifies the kind of a TypeCode object. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TypeCode |
A container for information about a specific CORBA data
type.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TypeCodeHolder |
The Holder for TypeCode.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ULongLongSeqHelper |
The Helper for ULongLongSeq.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ULongLongSeqHolder |
The Holder for ULongLongSeq.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ULongSeqHelper |
The Helper for ULongSeq.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ULongSeqHolder |
The Holder for ULongSeq.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UnionMember |
A description in the Interface Repository of a member of an IDL union.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UnionMemberHelper |
The Helper for UnionMember.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UnknownUserExceptionHelper |
The Helper for UnknownUserException.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UnknownUserExceptionHolder |
The Holder for UnknownUserException.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UShortSeqHelper |
The Helper for UShortSeq.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
UShortSeqHolder |
The Holder for UShortSeq.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ValueBaseHelper | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ValueBaseHolder |
The Holder for ValueBase.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ValueMember |
A description in the Interface Repository of
a member of a
value object. |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
ValueMemberHelper |
The Helper for ValueMember.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
VersionSpecHelper |
The Helper for VersionSpec.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
VisibilityHelper |
The Helper for Visibility.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
WCharSeqHelper |
The Helper for WCharSeq.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
WCharSeqHolder |
The Holder for WCharSeq.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
WrongTransactionHelper |
The Helper for WrongTransaction.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
WrongTransactionHolder |
The Holder for WrongTransaction.
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
WStringSeqHelper |
An array of WStrings
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
WStringSeqHolder |
An array of WStrings
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
WStringValueHelper |
org/omg/CORBA/WStringValueHelper.java
Generated by the IDL-to-Java compiler (portable), version "3.0"
from orb.idl
31 May 1999 22:27:30 o'clock GMT+00:00
The class definition has been modified to conform to the following
OMG specifications :
ORB core as defined by CORBA 2.3.1
(
Package org.omg.CORBA DescriptionProvides the mapping of the OMG CORBA APIs to the JavaTM
programming language, including the class ORB, which is implemented
so that a programmer can use it as a fully-functional Object Request Broker
(ORB).
For a precise list of supported sections of official CORBA specifications with which the Java[TM] Platform, Standard Edition 6 complies, see Official Specifications for CORBA support in Java[TM] SE 6. General InformationThe information in this section is information relevant to someone who compiles Interface Definition Language (IDL) files and uses the ORB to write clients and servers.The classes and interfaces described in this section can be put into four groups: ORB classes, Exceptions, Helper classes, and Holder classes. The ORB ClassAn ORB handles (or brokers) method invocations between a client and the method's implementation on a server. Because the client and server may be anywhere on a network, and because the invocation and implementation may be written in different programming languages, an ORB does a great deal of work behind the scenes to accomplish this communication. Most of what an ORB does is completely transparent to the user, and a major portion of the CORBA package consists of classes used by the ORB behind the scenes. The result is that most programmers will use only a small part of this package directly. In fact, most programmers will use only a few methods from the ORB class, some exceptions, and occasionally, a holder class. ORB MethodsBefore an application can enter the CORBA environment, it must first:
The following operations are provided to initialize applications and obtain the appropriate object references:
When an application requires a CORBA environment it needs a mechanism to get an ORB object reference and possibly an OA object reference (such as the root POA). This serves two purposes. First, it initializes an application into the ORB and OA environments. Second, it returns the ORB object reference and the OA object reference to the application for use in future ORB and OA operations. In order to obtain an ORB object reference, applications call the ORB.init operation. The parameters to the call can comprise an identifier for the ORB for which the object reference is required, and an arg_list, which is used to allow environment-specific data to be passed into the call. These are the ORB methods that provide access to the ORB:
Using the init() method without parameters initiates a singleton ORB, which can only give typecode creation anys needed in code generated in Helper classes by idlj. Applications require a portable means by which to obtain their initial object references. References are required for the root POA, POA Current, Interface Repository, and various Object Services instances. The functionality required by the application is similar to that provided by the Naming Service. However, the OMG does not want to mandate that the Naming Service be made available to all applications in order that they may be portably initialized. Consequently, the operations shown in this section provide a simplified, local version of the Naming Service that applications can use to obtain a small, defined set of object references which are essential to its operation. Because only a small well-defined set of objects are expected with this mechanism, the naming context can be flattened to be a single-level name space. This simplification results in only two operations being defined to achieve the functionality required. Initial references are obtained via two operations provided in the ORB object interface, providing facilities to list and resolve initial object references. These are:
An example that uses some of these methods is Getting Started with Java IDL. ExceptionsExceptions in Java IDL are similar to those in any code written in the Java programming language. If a method is defined to throw an exception, then any code using that method must have a try/catch block and handle that exception when it is thrown.The documentation on Java IDL exceptions has more information and explains the difference between system exceptions and user-defined exceptions. The following is a list of the system exceptions (which are unchecked exceptions inheriting through org.omg.CORBA.SystemException from java.lang.RuntimeException) that are defined in the package org.omg.CORBA:
The following is a list of user-defined exceptions defined in the package org.omg.CORBA.
SubpackagesThere are some packages inside the CORBA package with "Package" as part of their names. These packages are generally quite small because all they do is provide exceptions or classes for use by interfaces and classes in the CORBA package.For example, the package org.omg.CORBA.TypeCodePackage contains two exceptions thrown by methods in the class TypeCode. These exceptions are:
Another package that is a subpackage of CORBA is the portable package. It provides a set of ORB APIs that makes it possible for code generated by one vendor's IDL compiler to run on another vendor's ORB. Holder classesSupport for out and inout parameter passing modes requires the use of additional holder classes. Because the Java programming language does not support out or inout parameters, holder classes are needed as a means of passing a parameter that can be modified. To support portable stubs and skeletons, holder classes also implement the org.omg.CORBA.portable.Streamable interface. Holder classes are named by appending "Holder" to the name of the type. The name of the type refers to its name in the Java programming language. For example, a holder class for the interface named Account in the Java programming language would be named AccountHolder. Holder classes are available for all of the basic IDL datatypes in the org.omg.CORBA package. So, for example, there are already-defined classes for LongHolder, ShortHolder, FloatHolder, and so on. Classes are also generated for all named user-defined IDL types except those defined by typedefs. (Note that in this context user defined includes types that are defined in OMG specifications such as those for the Interface Repository, and other OMG services.) Each holder class has:
The default constructor sets the value field to the default value for the type as defined by the Java language:
As an example, if the interface public final class AccountHolder implements org.omg.CORBA.portable.Streamable { // field that holds an Account object public Account value = null; // default constructor public AccountHolder () { } // creates a new AccountHolder from initialValue public AccountHolder (Account initialValue) { value = initialValue; } // reads the contents of i and assigns the contents to value public void _read (org.omg.CORBA.portable.InputStream i) { value = AccountHelper.read (i); } // writes value to o public void _write (org.omg.CORBA.portable.OutputStream o) { AccountHelper.write (o, value); } // returns the typecode for Account public org.omg.CORBA.TypeCode _type () { return AccountHelper.type (); } } For more information on Holder classes, see Chapter 1.4, Mapping for Basic Types in the OMG IDL to Java Language Mapping. The Holder classes defined in the package org.omg.CORBA are: AnyHolder AnySeqHolder BooleanHolder BooleanSeqHolder ByteHolder CharHolder CharSeqHolder CurrentHolder DoubleHolder DoubleSeqHolder FixedHolder FloatHolder FloatSeqHolder IntHolder LongHolder LongLongSeqHolder LongSeqHolder ObjectHolder OctetSeqHolder ParameterModeHolder PolicyErrorHolder PolicyListHolder PrincipalHolder ServiceInformationHolder ShortHolder ShortSeqHolder StringHolder StringSeqHolder TypeCodeHolder ULongLongSeqHolder ULongSeqHolder UnknownUserExceptionHolder UShortSeqHolder ValueBaseHolder WCharSeqHolder WrongTransactionHolder WStringSeqHolder Helper ClassesHelper files supply several static methods needed to manipulate the type. These include:
The helper class for a mapped IDL interface or abstract interface
also include narrow operation(s). The static narrow method allows
an org.omg.CORBA.Object to be narrowed to the object reference
of a more specific type. The IDL exception CORBA.BAD_PARAM
is thrown if the narrow fails because the object reference does not
support the requested type. A different system exception is raised
to indicate other kinds of errors. Trying to narrow a null will always
succeed with a return value of null. Generally, the only helper method an application programmer uses is
the Helper classes fall into two broad categories, helpers for value types and helpers for non value types. Because all of the helper classes in one category provide the same methods, one generic explanation of each category of helper classes is presented here.
When OMG IDL is mapped to the Java programming language,
a "helper" class is generated for each user-defined type.
This generated class will have the name of the user-defined type with
the suffix The
When an object is the return value for a method, it is returned in the
form of a generic object, either an |