| JavaTM 2 Platform Std. Ed. v1.6.0
org.omg.CORBA
Interface DynAny
- All Superinterfaces:
- Object
- All Known Subinterfaces:
- DynArray, DynEnum, DynFixed, DynSequence, DynStruct, DynUnion, DynValue
Deprecated. Use the new DynAny instead
@Deprecated
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)
Deprecated. Copy the contents from one Dynamic Any into another. |
DynAny |
copy()
Deprecated. Clones this DynAny object. |
DynAny |
current_component()
Deprecated. Returns a DynAny object reference that can
be used to get/set the value of the component currently accessed. |
void |
destroy()
Deprecated. Destroys this DynAny object and frees any resources
used to represent the data value associated with it. |
void |
from_any(Any value)
Deprecated. Make a DynAny object from an Any
object. |
Any |
get_any()
Deprecated. Retrieves the org.omg.CORBA.Any contained
in this DynAny object. |
boolean |
get_boolean()
Deprecated. Retrieves the boolean contained
in this DynAny object. |
char |
get_char()
Deprecated. Retrieves the char contained
in this DynAny object. |
double |
get_double()
Deprecated. Retrieves the double contained
in this DynAny object. |
float |
get_float()
Deprecated. Retrieves the float contained
in this DynAny object. |
int |
get_long()
Deprecated. Retrieves the int contained
in this DynAny object. |
long |
get_longlong()
Deprecated. Retrieves the long contained
in this DynAny object. |
byte |
get_octet()
Deprecated. Retrieves the byte contained
in this DynAny object. |
Object |
get_reference()
Deprecated. Retrieves the org.omg.CORBA.Other contained
in this DynAny object. |
short |
get_short()
Deprecated. Retrieves the short contained
in this DynAny object. |
String |
get_string()
Deprecated. Retrieves the String contained
in this DynAny object. |
TypeCode |
get_typecode()
Deprecated. Retrieves the org.omg.CORBA.TypeCode contained
in this DynAny object. |
int |
get_ulong()
Deprecated. Retrieves the int contained
in this DynAny object. |
long |
get_ulonglong()
Deprecated. Retrieves the long contained
in this DynAny object. |
short |
get_ushort()
Deprecated. Retrieves the short contained
in this DynAny object. |
Serializable |
get_val()
Deprecated. Retrieves the java.io.Serializable object contained
in this DynAny object. |
char |
get_wchar()
Deprecated. Retrieves the char contained
in this DynAny object. |
String |
get_wstring()
Deprecated. Retrieves the String contained
in this DynAny object. |
void |
insert_any(Any value)
Deprecated. Inserts the given org.omg.CORBA.Any object as the value for this
DynAny object. |
void |
insert_boolean(boolean value)
Deprecated. Inserts the given boolean as the value for this
DynAny object. |
void |
insert_char(char value)
Deprecated. Inserts the given char as the value for this
DynAny object. |
void |
insert_double(double value)
Deprecated. Inserts the given double as the value for this
DynAny object. |
void |
insert_float(float value)
Deprecated. Inserts the given float as the value for this
DynAny object. |
void |
insert_long(int value)
Deprecated. Inserts the given int as the value for this
DynAny object. |
void |
insert_longlong(long value)
Deprecated. Inserts the given long as the value for this
DynAny object. |
void |
insert_octet(byte value)
Deprecated. Inserts the given byte as the value for this
DynAny object. |
void |
insert_reference(Object value)
Deprecated. Inserts the given org.omg.CORBA.Object as the value for this
DynAny object. |
void |
insert_short(short value)
Deprecated. Inserts the given short as the value for this
DynAny object. |
void |
insert_string(String value)
Deprecated. Inserts the given String object as the value for this
DynAny object. |
void |
insert_typecode(TypeCode value)
Deprecated. Inserts the given org.omg.CORBA.TypeCode as the value for this
DynAny object. |
void |
insert_ulong(int value)
Deprecated. Inserts the given int as the value for this
DynAny object. |
void |
insert_ulonglong(long value)
Deprecated. Inserts the given long as the value for this
DynAny object. |
void |
insert_ushort(short value)
Deprecated. Inserts the given short as the value for this
DynAny object. |
void |
insert_val(Serializable value)
Deprecated. Inserts the given java.io.Serializable object as the value for this
DynAny object. |
void |
insert_wchar(char value)
Deprecated. Inserts the given char as the value for this
DynAny object. |
void |
insert_wstring(String value)
Deprecated. Inserts the given String as the value for this
DynAny object. |
boolean |
next()
Deprecated. Moves to the next component of this DynAny object. |
void |
rewind()
Deprecated. Moves the internal pointer to the first component. |
boolean |
seek(int index)
Deprecated. Moves the internal pointer to the given index. |
Any |
to_any()
Deprecated. Convert a DynAny object to an Any
object. |
TypeCode |
type()
Deprecated. 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 |
type
TypeCode type()
- Deprecated.
- Returns the
TypeCode of the object inserted into
this DynAny.
- Returns:
- the
TypeCode object.
assign
void assign(DynAny dyn_any)
throws Invalid
- Deprecated.
- 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
void from_any(Any value)
throws Invalid
- Deprecated.
- 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
Any to_any()
throws Invalid
- Deprecated.
- 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
void destroy()
- Deprecated.
- 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
DynAny copy()
- Deprecated.
- Clones this
DynAny object.
- Returns:
- a copy of this
DynAny object
insert_boolean
void insert_boolean(boolean value)
throws InvalidValue
- Deprecated.
- Inserts the given
boolean as the value for this
DynAny object.
If this method is called on a constructed DynAny
object, it initializes the next component of the constructed data
value associated with this DynAny object.
- Parameters:
value - the boolean to insert into this
DynAny object
- Throws:
InvalidValue - if the value inserted is not consistent with the type
of the accessed component in this DynAny object
insert_octet
void insert_octet(byte value)
throws InvalidValue
- Deprecated.
- Inserts the given
byte as the value for this
DynAny object.
If this method is called on a constructed DynAny
object, it initializes the next component of the constructed data
value associated with this DynAny object.
- Parameters:
value - the byte to insert into this
DynAny object
- Throws:
InvalidValue - if the value inserted is not consistent with the type
of the accessed component in this DynAny object
insert_char
void insert_char(char value)
throws InvalidValue
- Deprecated.
- Inserts the given
char as the value for this
DynAny object.
If this method is called on a constructed DynAny
object, it initializes the next component of the constructed data
value associated with this DynAny object.
- Parameters:
value - the char to insert into this
DynAny object
- Throws:
InvalidValue - if the value inserted is not consistent with the type
of the accessed component in this DynAny object
insert_short
void insert_short(short value)
throws InvalidValue
- Deprecated.
- Inserts the given
short as the value for this
DynAny object.
If this method is called on a constructed DynAny
object, it initializes the next component of the constructed data
value associated with this DynAny object.
- Parameters:
value - the short to insert into this
DynAny object
- Throws:
InvalidValue - if the value inserted is not consistent with the type
of the accessed component in this DynAny object
insert_ushort
void insert_ushort(short value)
throws InvalidValue
- Deprecated.
- Inserts the given
short as the value for this
DynAny object.
If this method is called on a constructed DynAny
object, it initializes the next component of the constructed data
value associated with this DynAny object.
- Parameters:
value - the short to insert into this
DynAny object
- Throws:
InvalidValue - if the value inserted is not consistent with the type
of the accessed component in this DynAny object
insert_long
void insert_long(int value)
throws InvalidValue
- Deprecated.
- Inserts the given
int as the value for this
DynAny object.
If this method is called on a constructed DynAny
object, it initializes the next component of the constructed data
value associated with this DynAny object.
- Parameters:
value - the int to insert into this
DynAny object
- Throws:
InvalidValue - if the value inserted is not consistent with the type
of the accessed component in this DynAny object
insert_ulong
void insert_ulong(int value)
throws InvalidValue
- Deprecated.
- Inserts the given
int as the value for this
DynAny object.
If this method is called on a constructed DynAny
object, it initializes the next component of the constructed data
value associated with this DynAny object.
- Parameters:
value - the int to insert into this
DynAny object
- Throws:
InvalidValue - if the value inserted is not consistent with the type
of the accessed component in this DynAny object
insert_float
void insert_float(float value)
throws InvalidValue
- Deprecated.
- Inserts the given
float as the value for this
DynAny object.
If this method is called on a constructed DynAny
object, it initializes the next component of the constructed data
value associated with this DynAny object.
- Parameters:
value - the float to insert into this
DynAny object
- Throws:
InvalidValue - if the value inserted is not consistent with the type
of the accessed component in this DynAny object
insert_double
void insert_double(double value)
throws InvalidValue
- Deprecated.
- Inserts the given
double as the value for this
DynAny object.
If this method is called on a constructed DynAny
object, it initializes the next component of the constructed data
value associated with this DynAny object.
- Parameters:
value - the double to insert into this
DynAny object
- Throws:
InvalidValue - if the value inserted is not consistent with the type
of the accessed component in this DynAny object
insert_string
void insert_string(String value)
throws InvalidValue
- Deprecated.
- Inserts the given
String object as the value for this
DynAny object.
If this method is called on a constructed DynAny
object, it initializes the next component of the constructed data
value associated with this DynAny object.
- Parameters:
value - the String to insert into this
DynAny object
- Throws:
InvalidValue - if the value inserted is not consistent with the type
of the accessed component in this DynAny object
insert_reference
void insert_reference(Object value)
throws InvalidValue
- Deprecated.
- Inserts the given
org.omg.CORBA.Object as the value for this
DynAny object.
If this method is called on a constructed DynAny
object, it initializes the next component of the constructed data
value associated with this DynAny object.
- Parameters:
value - the org.omg.CORBA.Object to insert into this
DynAny object
- Throws:
InvalidValue - if the value inserted is not consistent with the type
of the accessed component in this DynAny object
insert_typecode
void insert_typecode(TypeCode value)
throws InvalidValue
- Deprecated.
- Inserts the given
org.omg.CORBA.TypeCode as the value for this
DynAny object.
If this method is called on a constructed DynAny
object, it initializes the next component of the constructed data
value associated with this DynAny object.
- Parameters:
value - the org.omg.CORBA.TypeCode to insert into this
DynAny object
- Throws:
InvalidValue - if the value inserted is not consistent with the type
of the accessed component in this DynAny object
insert_longlong
void insert_longlong(long value)
throws InvalidValue
- Deprecated.
- Inserts the given
long as the value for this
DynAny object.
If this method is called on a constructed DynAny
object, it initializes the next component of the constructed data
value associated with this DynAny object.
- Parameters:
value - the long to insert into this
DynAny object
- Throws:
InvalidValue - if the value inserted is not consistent with the type
of the accessed component in this DynAny object
insert_ulonglong
void insert_ulonglong(long value)
throws InvalidValue
- Deprecated.
- Inserts the given
long as the value for this
DynAny object.
If this method is called on a constructed DynAny
object, it initializes the next component of the constructed data
value associated with this DynAny object.
- Parameters:
value - the long to insert into this
DynAny object
- Throws:
InvalidValue - if the value inserted is not consistent with the type
of the accessed component in this DynAny object
insert_wchar
void insert_wchar(char value)
throws InvalidValue
- Deprecated.
- Inserts the given
char as the value for this
DynAny object.
If this method is called on a constructed DynAny
object, it initializes the next component of the constructed data
value associated with this DynAny object.
- Parameters:
value - the char to insert into this
DynAny object
- Throws:
InvalidValue - if the value inserted is not consistent with the type
of the accessed component in this DynAny object
insert_wstring
void insert_wstring(String value)
throws InvalidValue
- Deprecated.
- Inserts the given
String as the value for this
DynAny object.
If this method is called on a constructed DynAny
object, it initializes the next component of the constructed data
value associated with this DynAny object.
- Parameters:
value - the String to insert into this
DynAny object
- Throws:
InvalidValue - if the value inserted is not consistent with the type
of the accessed component in this DynAny object
insert_any
void insert_any(Any value)
throws InvalidValue
- Deprecated.
- Inserts the given
org.omg.CORBA.Any object as the value for this
DynAny object.
If this method is called on a constructed DynAny
object, it initializes the next component of the constructed data
value associated with this DynAny object.
- Parameters:
value - the org.omg.CORBA.Any object to insert into this
DynAny object
- Throws:
InvalidValue - if the value inserted is not consistent with the type
of the accessed component in this DynAny object
insert_val
void insert_val(Serializable value)
throws InvalidValue
- Deprecated.
- Inserts the given
java.io.Serializable object as the value for this
DynAny object.
If this method is called on a constructed DynAny
object, it initializes the next component of the constructed data
value associated with this DynAny object.
- Parameters:
value - the java.io.Serializable object to insert into this
DynAny object
- Throws:
InvalidValue - if the value inserted is not consistent with the type
of the accessed component in this DynAny object
get_val
Serializable get_val()
throws TypeMismatch
- Deprecated.
- Retrieves the
java.io.Serializable object contained
in this DynAny object.
- Returns:
- the
java.io.Serializable object that is the
value for this DynAny object
- Throws:
TypeMismatch - if the type code of the accessed component in this
DynAny object is not equivalent to
the type code for a java.io.Serializable object
get_boolean
boolean get_boolean()
throws TypeMismatch
- Deprecated.
- Retrieves the
boolean contained
in this DynAny object.
- Returns:
- the
boolean that is the
value for this DynAny object
- Throws:
TypeMismatch - if the type code of the accessed component in this
DynAny object is not equivalent to
the type code for a boolean
get_octet
byte get_octet()
throws TypeMismatch
- Deprecated.
- Retrieves the
byte contained
in this DynAny object.
- Returns:
- the
byte that is the
value for this DynAny object
- Throws:
TypeMismatch - if the type code of the accessed component in this
DynAny object is not equivalent to
the type code for a byte
get_char
char get_char()
throws TypeMismatch
- Deprecated.
- Retrieves the
char contained
in this DynAny object.
- Returns:
- the
char that is the
value for this DynAny object
- Throws:
TypeMismatch - if the type code of the accessed component in this
DynAny object is not equivalent to
the type code for a char
get_short
short get_short()
throws TypeMismatch
- Deprecated.
- Retrieves the
short contained
in this DynAny object.
- Returns:
- the
short that is the
value for this DynAny object
- Throws:
TypeMismatch - if the type code of the accessed component in this
DynAny object is not equivalent to
the type code for a short
get_ushort
short get_ushort()
throws TypeMismatch
- Deprecated.
- Retrieves the
short contained
in this DynAny object.
- Returns:
- the
short that is the
value for this DynAny object
- Throws:
TypeMismatch - if the type code of the accessed component in this
DynAny object is not equivalent to
the type code for a short
get_long
int get_long()
throws TypeMismatch
- Deprecated.
- Retrieves the
int contained
in this DynAny object.
- Returns:
- the
int that is the
value for this DynAny object
- Throws:
TypeMismatch - if the type code of the accessed component in this
DynAny object is not equivalent to
the type code for a int
get_ulong
int get_ulong()
throws TypeMismatch
- Deprecated.
- Retrieves the
int contained
in this DynAny object.
- Returns:
- the
int that is the
value for this DynAny object
- Throws:
TypeMismatch - if the type code of the accessed component in this
DynAny object is not equivalent to
the type code for a int
get_float
float get_float()
throws TypeMismatch
- Deprecated.
- Retrieves the
float contained
in this DynAny object.
- Returns:
- the
float that is the
value for this DynAny object
- Throws:
TypeMismatch - if the type code of the accessed component in this
DynAny object is not equivalent to
the type code for a float
get_double
double get_double()
throws TypeMismatch
- Deprecated.
- Retrieves the
double contained
in this DynAny object.
- Returns:
- the
double that is the
value for this DynAny object
- Throws:
TypeMismatch - if the type code of the accessed component in this
DynAny object is not equivalent to
the type code for a double
get_string
String get_string()
throws TypeMismatch
- Deprecated.
- Retrieves the
String contained
in this DynAny object.
- Returns:
- the
String that is the
value for this DynAny object
- Throws:
TypeMismatch - if the type code of the accessed component in this
DynAny object is not equivalent to
the type code for a String
get_reference
Object get_reference()
throws TypeMismatch
- Deprecated.
- Retrieves the
org.omg.CORBA.Other contained
in this DynAny object.
- Returns:
- the
org.omg.CORBA.Other that is the
value for this DynAny object
- Throws:
TypeMismatch - if the type code of the accessed component in this
DynAny object is not equivalent to
the type code for an org.omg.CORBA.Other
get_typecode
TypeCode get_typecode()
throws TypeMismatch
- Deprecated.
- Retrieves the
org.omg.CORBA.TypeCode contained
in this DynAny object.
- Returns:
- the
org.omg.CORBA.TypeCode that is the
value for this DynAny object
- Throws:
TypeMismatch - if the type code of the accessed component in this
DynAny object is not equivalent to
the type code for a org.omg.CORBA.TypeCode
get_longlong
long get_longlong()
throws TypeMismatch
- Deprecated.
- Retrieves the
long contained
in this DynAny object.
- Returns:
- the
long that is the
value for this DynAny object
- Throws:
TypeMismatch - if the type code of the accessed component in this
DynAny object is not equivalent to
the type code for a long
get_ulonglong
long get_ulonglong()
throws TypeMismatch
- Deprecated.
- Retrieves the
long contained
in this DynAny object.
- Returns:
- the
long that is the
value for this DynAny object
- Throws:
TypeMismatch - if the type code of the accessed component in this
DynAny object is not equivalent to
the type code for a long
get_wchar
char get_wchar()
throws TypeMismatch
- Deprecated.
- Retrieves the
char contained
in this DynAny object.
- Returns:
- the
char that is the
value for this DynAny object
- Throws:
TypeMismatch - if the type code of the accessed component in this
DynAny object is not equivalent to
the type code for a char
get_wstring
String get_wstring()
throws TypeMismatch
- Deprecated.
- Retrieves the
String contained
in this DynAny object.
- Returns:
- the
String that is the
value for this DynAny object
- Throws:
TypeMismatch - if the type code of the accessed component in this
DynAny object is not equivalent to
the type code for a String
get_any
Any get_any()
throws TypeMismatch
- Deprecated.
- Retrieves the
org.omg.CORBA.Any contained
in this DynAny object.
- Returns:
- the
org.omg.CORBA.Any that is the
value for this DynAny object
- Throws:
TypeMismatch - if the type code of the accessed component in this
DynAny object is not equivalent to
the type code for an org.omg.CORBA.Any
current_component
DynAny current_component()
- Deprecated.
- Returns a
DynAny object reference that can
be used to get/set the value of the component currently accessed.
The appropriate insert method
can be called on the resulting DynAny object
to initialize the component.
The appropriate get method
can be called on the resulting DynAny object
to extract the value of the component.
- Returns:
- a
DynAny object reference that can be
used to retrieve or set the value of the component currently
accessed
next
boolean next()
- Deprecated.
- Moves to the next component of this
DynAny object.
This method is used for iterating through the components of
a constructed type, effectively moving a pointer from one
component to the next. The pointer starts out on the first
component when a DynAny object is created.
- Returns:
true if the pointer points to a component;
false if there are no more components or this
DynAny is associated with a basic type rather than
a constructed type
seek
boolean seek(int index)
- Deprecated.
- Moves the internal pointer to the given index. Logically, this method
sets a new offset for this pointer.
- Parameters:
index - an int indicating the position to which
the pointer should move. The first position is 0.
- Returns:
true if the pointer points to a component;
false if there is no component at the designated
index. If this DynAny object is associated with a
basic type, this method returns false for any index
other than 0.
rewind
void rewind()
- Deprecated.
- Moves the internal pointer to the first component.
Copyright 2003 Sun Microsystems, Inc. All rights reserved
|