org.omg.IOP
Class TaggedComponentHolder

java.lang.Object
  |
  +--org.omg.IOP.TaggedComponentHolder
All Implemented Interfaces:
Streamable
public final class TaggedComponentHolder
extends Object
implements Streamable

TaggedComponents contained in TAG_INTERNET_IOP and TAG_MULTIPLE_COMPONENTS profiles are identified by unique numeric tags using a namespace distinct form that is used for profile tags. Component tags are assigned by the OMG.

Specifications of components must include the following information:

  • Component ID: The compound tag that is obtained from OMG.
  • Structure and encoding: The syntax of the component data and the encoding rules. If the component value is encoded as a CDR encapsulation, the IDL type that is encapsulated and the GIOP version which is used for encoding the value, if different than GIOP 1.0, must be specified as part of the component definition.
  • Semantics: How the component data is intended to be used.
  • Protocols: The protocol for which the component is defined, and whether it is intended that the component be usable by other protocols.
  • At most once: whether more than one instance of this component can be included in a profile.
Specification of protocols must describe how the components affect the protocol. The following should be specified in any protocol definition for each TaggedComponent that the protocol uses:
  • Mandatory presence: Whether inclusion of the component in profiles supporting the protocol is required (MANDATORY PRESENCE) or not required (OPTIONAL PRESENCE).
  • Droppable: For optional presence component, whether component, if present, must be retained or may be dropped.

 

Field Summary

 TaggedComponent value
    
 

 

Constructor Summary

TaggedComponentHolder()
    
TaggedComponentHolder(TaggedComponent initialValue)
    
 

 

Method Summary

 void _read(InputStream i)
    Reads data from istream and initalizes the value field of the Holder with the unmarshalled data.
 TypeCode _type()
    Retrieves the TypeCode object corresponding to the value in the value field of the Holder.
 void _write(OutputStream o)
    Marshals to ostream the value in the value field of the Holder.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

 

Field Detail

 

value

public TaggedComponent value

 

Constructor Detail

 

TaggedComponentHolder

public TaggedComponentHolder()

 

TaggedComponentHolder

public TaggedComponentHolder(TaggedComponent initialValue)

 

Method Detail

 

_read

public void _read(InputStream i)
Description copied from interface: Streamable
Reads data from istream and initalizes the value field of the Holder with the unmarshalled data.

Specified by:
_read in interface Streamable
Parameters:
i - the InputStream that represents the CDR data from the wire.

 

_write

public void _write(OutputStream o)
Description copied from interface: Streamable
Marshals to ostream the value in the value field of the Holder.

Specified by:
_write in interface Streamable
Parameters:
o - the CDR OutputStream

 

_type

public TypeCode _type()
Description copied from interface: Streamable
Retrieves the TypeCode object corresponding to the value in the value field of the Holder.

Specified by:
_type in interface Streamable
Returns:
the TypeCode object for the value held in the holder