DynAny (Java 2 Platform SE v1.4.1) - JDK 5 Documentation v1.4.1, Java 2 SDK 英文文档

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

Java^TM 2 Platform
Std. Ed. v1.4.1

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.omg.CORBA
Interface DynAny

All Superinterfaces:: Object

All Known Subinterfaces:: DynArray, DynEnum, DynFixed, DynSequence, DynStruct, DynUnion, DynValue

public interface DynAny
extends Object

Enables org.omg.CORBA.Any values to be dynamically interpreted (traversed) and constructed. A DynAny object is associated with a data value which may correspond to a copy of the value inserted into an Any. The DynAny APIs enable traversal of the data value associated with an Any at runtime and extraction of the primitive constituents of the data value.

Method Summary

void assign(DynAny dyn_any)
          Copy the contents from one Dynamic Any into another.

DynAny copy()
          Clones this DynAny object.

DynAny current_component()
          Returns a DynAny object reference that can be used to get/set the value of the component currently accessed.

void destroy()
          Destroys this DynAny object and frees any resources used to represent the data value associated with it.

void from_any(Any value)
          Make a DynAny object from an Any object.

Any get_any()
          Retrieves the org.omg.CORBA.Any contained in this DynAny object.

boolean get_boolean()
          Retrieves the boolean contained in this DynAny object.

char get_char()
          Retrieves the char contained in this DynAny object.

double get_double()
          Retrieves the double contained in this DynAny object.

float get_float()
          Retrieves the float contained in this DynAny object.

int get_long()
          Retrieves the int contained in this DynAny object.

long get_longlong()
          Retrieves the long contained in this DynAny object.

byte get_octet()
          Retrieves the byte contained in this DynAny object.

Object get_reference()
          Retrieves the org.omg.CORBA.Other contained in this DynAny object.

short get_short()
          Retrieves the short contained in this DynAny object.

String get_string()
          Retrieves the String contained in this DynAny object.

TypeCode get_typecode()
          Retrieves the org.omg.CORBA.TypeCode contained in this DynAny object.

int get_ulong()
          Retrieves the int contained in this DynAny object.

long get_ulonglong()
          Retrieves the long contained in this DynAny object.

short get_ushort()
          Retrieves the short contained in this DynAny object.

Serializable get_val()
          Retrieves the java.io.Serializable object contained in this DynAny object.

char get_wchar()
          Retrieves the char contained in this DynAny object.

String get_wstring()
          Retrieves the String contained in this DynAny object.

void insert_any(Any value)
          Inserts the given org.omg.CORBA.Any object as the value for this DynAny object.

void insert_boolean(boolean value)
          Inserts the given boolean as the value for this DynAny object.

void insert_char(char value)
          Inserts the given char as the value for this DynAny object.

void insert_double(double value)
          Inserts the given double as the value for this DynAny object.

void insert_float(float value)
          Inserts the given float as the value for this DynAny object.

void insert_long(int value)
          Inserts the given int as the value for this DynAny object.

void insert_longlong(long value)
          Inserts the given long as the value for this DynAny object.

void insert_octet(byte value)
          Inserts the given byte as the value for this DynAny object.

void insert_reference(Object value)
          Inserts the given org.omg.CORBA.Object as the value for this DynAny object.

void insert_short(short value)
          Inserts the given short as the value for this DynAny object.

void insert_string(String value)
          Inserts the given String object as the value for this DynAny object.

void insert_typecode(TypeCode value)
          Inserts the given org.omg.CORBA.TypeCode as the value for this DynAny object.

void insert_ulong(int value)
          Inserts the given int as the value for this DynAny object.

void insert_ulonglong(long value)
          Inserts the given long as the value for this DynAny object.

void insert_ushort(short value)
          Inserts the given short as the value for this DynAny object.

void insert_val(Serializable value)
          Inserts the given java.io.Serializable object as the value for this DynAny object.

void insert_wchar(char value)
          Inserts the given char as the value for this DynAny object.

void insert_wstring(String value)
          Inserts the given String as the value for this DynAny object.

boolean next()
          Moves to the next component of this DynAny object.

void rewind()
          Moves the internal pointer to the first component.

boolean seek(int index)
          Moves the internal pointer to the given index.

Any to_any()
          Convert a DynAny object to an Any object.

TypeCode type()
          Returns the TypeCode of the object inserted into this DynAny.

Methods inherited from interface org.omg.CORBA.Object

_create_request, _create_request, _duplicate, _get_domain_managers, _get_interface_def, _get_policy, _hash, _is_a, _is_equivalent, _non_existent, _release, _request, _set_policy_override

Method Detail

type

public TypeCode type()

Returns the TypeCode of the object inserted into this DynAny.

Returns:: the TypeCode object.

assign

public void assign(DynAny dyn_any)
            throws Invalid

Copy the contents from one Dynamic Any into another.

Parameters:: dyn_any - the DynAny object whose contents are assigned to this DynAny.
Throws:: Invalid - if the source DynAny is invalid

from_any

public void from_any(Any value)
              throws Invalid

Make a DynAny object from an Any object.

Parameters:: value - the Any object.
Throws:: Invalid - if the source Any object is empty or bad

to_any

public Any to_any()
           throws Invalid

Convert a DynAny object to an Any object.

Returns:: the Any object.
Throws:: Invalid - if this DynAny is empty or bad. created or does not contain a meaningful value

destroy

public void destroy()

Destroys this DynAny object and frees any resources used to represent the data value associated with it. This method also destroys all DynAny objects obtained from it.

Destruction of DynAny objects should be handled with care, taking into account issues dealing with the representation of data values associated with DynAny objects. A programmer who wants to destroy a DynAny object but still be able to manipulate some component of the data value associated with it, should first create a DynAny object for the component and then make a copy of the created DynAny object.

copy

public DynAny copy()

Clones this DynAny object.

Returns:: a copy of this DynAny object