Sun Java Solaris Communities My SDN Account Join SDN
 
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