Sun Java Solaris Communities My SDN Account
 
Documentation

Java IDL Supplemental Documentation

 


Updated Documentation

Click on the following classes, interfaces, or exceptions to get updated documentation. The material in parentheses indicates what has been updated.

Package org.omg.CORBA:

Any (Updated documentation)
DefinitionKind (Updated documentation)
DynAny (Updated documentation)
DynUnion (Comments on methods)
IDLType (Updated documentation)
IRObject (Updated documentation)
NameValuePair (Updated documentation)
Policy (Comments on method policy_type explaining the constant values)
PolicyError (Comments on class linking to the policy error reason codes)
TypeCode (Updated documentation)
WrongTransaction (Comments on constructors)

Package org.omg.CORBA.portable:

ApplicationException (Updated documentation)
InvokeHandler (Updated documentation)
RemarshalException (Updated documentation)
ResponseHandler (Updated documentation)
ServantObject (Updated documentation)

Package org.omg.CORBA.ORBPackage:

InconsistentTypeCode (Comments on constructors)
 

Interfaces That Serve as Constants

The IDL to Java mapping defines that IDL enums are mapped to a Java class with the enumerated values represented as public static final fields in that class (e.g. DefinitionKind). On the other hand IDL constants defined outside of an IDL interface are mapped to a Java interface for each constant.
This is the reason why several interfaces in the org.omg.CORBA package consist of a single field, value, which is a short. This field is a constant used for such things as an error code or value modifier. For example, the value field of the interface BAD_POLICY is one of the possible reasons for the exception PolicyError to be thrown. To specify this error code, you would use BAD_POLICY.value

The exception PolicyError uses the value field of the following interfaces as its possible error codes. 

  • BAD_POLICY
  • BAD_POLICY_TYPE
  • BAD_POLICY_VALUE
  • UNSUPPORTED_POLICY
  • UNSUPPORTED_POLICY_VALUE
The method TypeCode.type_modifier returns the value field of one of the following interfaces. The VM in the names of these interfaces stands for "value modifier."
  • VM_NONE
  • VM_ABSTRACT
  • VM_CUSTOM
  • VM_TRUNCATABLE
The following constants are returned by ValueMembers access method to denote the visibility of the ValueMember
  • PRIVATE_MEMBER
  • PUBLIC_MEMBER

Interface Repository

Even though this release does not include an implementation of a CORBA Interface Repository the following IR classes and interfaces have been included for the purpose of creating type codes (see create_value_tc, create_struct_tc, create_union_tc and create_exception_tc methods in interface org.omg.CORBA.ORB)
 
  • IRObject
  • IDLType
  • DefinitionKind
  • StructMember
  • UnionMember
  • ValueMember


Oracle is reviewing the Sun product roadmap and will provide guidance to customers in accordance with Oracle's standard product communication policies. Any resulting features and timing of release of such features as determined by Oracle's review of roadmaps, are at the sole discretion of Oracle. All product roadmap information, whether communicated by Sun Microsystems or by Oracle, does not represent a commitment to deliver any material, code, or functionality, and should not be relied upon in making purchasing decisions. It is intended for information purposes only, and may not be incorporated into any contract.