Interface DynAny
- All Superinterfaces:
- Object
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.
Methods
Modifier and Type | Method and Description |
---|---|
void |
assign(DynAny dyn_any) Deprecated. Copy the contents from one Dynamic Any into another. |
DynAny |
copy() Deprecated. Clones this |
DynAny |
current_component() Deprecated. Returns a |
void |
destroy() Deprecated. Destroys this |
void |
from_any(Any value) Deprecated. Make a |
Any |
get_any() Deprecated. Retrieves the |
boolean |
get_boolean() Deprecated. Retrieves the |
char |
get_char() Deprecated. Retrieves the |
double |
get_double() Deprecated. Retrieves the |
float |
get_float() Deprecated. Retrieves the |
int |
get_long() Deprecated. Retrieves the |
long |
get_longlong() Deprecated. Retrieves the |
byte |
get_octet() Deprecated. Retrieves the |
Object |
get_reference() Deprecated. Retrieves the |
short |
get_short() Deprecated. Retrieves the |
String |
get_string() Deprecated. Retrieves the |
TypeCode |
get_typecode() Deprecated. Retrieves the |
int |
get_ulong() Deprecated. Retrieves the |
long |
get_ulonglong() Deprecated. Retrieves the |
short |
get_ushort() Deprecated. Retrieves the |
Serializable |
get_val() Deprecated. Retrieves the |
char |
get_wchar() Deprecated. Retrieves the |
String |
get_wstring() Deprecated. Retrieves the |
void |
insert_any(Any value) Deprecated. Inserts the given |
void |
insert_boolean(boolean value) Deprecated. Inserts the given |
void |
insert_char(char value) Deprecated. Inserts the given |
void |
insert_double(double value) Deprecated. Inserts the given |
void |
insert_float(float value) Deprecated. Inserts the given |
void |
insert_long(int value) Deprecated. Inserts the given |
void |
insert_longlong(long value) Deprecated. Inserts the given |
void |
insert_octet(byte value) Deprecated. Inserts the given |
void |
insert_reference(Object value) Deprecated. Inserts the given |
void |
insert_short(short value) Deprecated. Inserts the given |
void |
insert_string(String value) Deprecated. Inserts the given |
void |
insert_typecode(TypeCode value) Deprecated. Inserts the given |
void |
insert_ulong(int value) Deprecated. Inserts the given |
void |
insert_ulonglong(long value) Deprecated. Inserts the given |
void |
insert_ushort(short value) Deprecated. Inserts the given |
void |
insert_val(Serializable value) Deprecated. Inserts the given |
void |
insert_wchar(char value) Deprecated. Inserts the given |
void |
insert_wstring(String value) Deprecated. Inserts the given |
boolean |
next() Deprecated. Moves to the next component of this |
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 |
TypeCode |
type() Deprecated. Returns the |
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
Methods
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
- theDynAny
object whose contents are assigned to thisDynAny
. - Throws:
-
Invalid
- if the sourceDynAny
is invalid
from_any
void from_any(Any value) throws Invalid
Deprecated.
Make a DynAny
object from an Any
object.
- Parameters:
-
value
- theAny
object. - Throws:
-
Invalid
- if the sourceAny
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 thisDynAny
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
- theboolean
to insert into thisDynAny
object - Throws:
-
InvalidValue
- if the value inserted is not consistent with the type of the accessed component in thisDynAny
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
- thebyte
to insert into thisDynAny
object - Throws:
-
InvalidValue
- if the value inserted is not consistent with the type of the accessed component in thisDynAny
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
- thechar
to insert into thisDynAny
object - Throws:
-
InvalidValue
- if the value inserted is not consistent with the type of the accessed component in thisDynAny
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
- theshort
to insert into thisDynAny
object - Throws:
-
InvalidValue
- if the value inserted is not consistent with the type of the accessed component in thisDynAny
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
- theshort
to insert into thisDynAny
object - Throws:
-
InvalidValue
- if the value inserted is not consistent with the type of the accessed component in thisDynAny
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
- theint
to insert into thisDynAny
object - Throws:
-
InvalidValue
- if the value inserted is not consistent with the type of the accessed component in thisDynAny
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
- theint
to insert into thisDynAny
object - Throws:
-
InvalidValue
- if the value inserted is not consistent with the type of the accessed component in thisDynAny
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
- thefloat
to insert into thisDynAny
object - Throws:
-
InvalidValue
- if the value inserted is not consistent with the type of the accessed component in thisDynAny
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
- thedouble
to insert into thisDynAny
object - Throws:
-
InvalidValue
- if the value inserted is not consistent with the type of the accessed component in thisDynAny
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
- theString
to insert into thisDynAny
object - Throws:
-
InvalidValue
- if the value inserted is not consistent with the type of the accessed component in thisDynAny
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
- theorg.omg.CORBA.Object
to insert into thisDynAny
object - Throws:
-
InvalidValue
- if the value inserted is not consistent with the type of the accessed component in thisDynAny
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
- theorg.omg.CORBA.TypeCode
to insert into thisDynAny
object - Throws:
-
InvalidValue
- if the value inserted is not consistent with the type of the accessed component in thisDynAny
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
- thelong
to insert into thisDynAny
object - Throws:
-
InvalidValue
- if the value inserted is not consistent with the type of the accessed component in thisDynAny
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
- thelong
to insert into thisDynAny
object - Throws:
-
InvalidValue
- if the value inserted is not consistent with the type of the accessed component in thisDynAny
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
- thechar
to insert into thisDynAny
object - Throws:
-
InvalidValue
- if the value inserted is not consistent with the type of the accessed component in thisDynAny
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
- theString
to insert into thisDynAny
object - Throws:
-
InvalidValue
- if the value inserted is not consistent with the type of the accessed component in thisDynAny
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
- theorg.omg.CORBA.Any
object to insert into thisDynAny
object - Throws:
-
InvalidValue
- if the value inserted is not consistent with the type of the accessed component in thisDynAny
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
- thejava.io.Serializable
object to insert into thisDynAny
object - Throws:
-
InvalidValue
- if the value inserted is not consistent with the type of the accessed component in thisDynAny
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 thisDynAny
object - Throws:
-
TypeMismatch
- if the type code of the accessed component in thisDynAny
object is not equivalent to the type code for ajava.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 thisDynAny
object - Throws:
-
TypeMismatch
- if the type code of the accessed component in thisDynAny
object is not equivalent to the type code for aboolean
get_octet
byte get_octet() throws TypeMismatch
Deprecated.
Retrieves the byte
contained in this DynAny
object.
- Returns:
- the
byte
that is the value for thisDynAny
object - Throws:
-
TypeMismatch
- if the type code of the accessed component in thisDynAny
object is not equivalent to the type code for abyte
get_char
char get_char() throws TypeMismatch
Deprecated.
Retrieves the char
contained in this DynAny
object.
- Returns:
- the
char
that is the value for thisDynAny
object - Throws:
-
TypeMismatch
- if the type code of the accessed component in thisDynAny
object is not equivalent to the type code for achar
get_short
short get_short() throws TypeMismatch
Deprecated.
Retrieves the short
contained in this DynAny
object.
- Returns:
- the
short
that is the value for thisDynAny
object - Throws:
-
TypeMismatch
- if the type code of the accessed component in thisDynAny
object is not equivalent to the type code for ashort
get_ushort
short get_ushort() throws TypeMismatch
Deprecated.
Retrieves the short
contained in this DynAny
object.
- Returns:
- the
short
that is the value for thisDynAny
object - Throws:
-
TypeMismatch
- if the type code of the accessed component in thisDynAny
object is not equivalent to the type code for ashort
get_long
int get_long() throws TypeMismatch
Deprecated.
Retrieves the int
contained in this DynAny
object.
- Returns:
- the
int
that is the value for thisDynAny
object - Throws:
-
TypeMismatch
- if the type code of the accessed component in thisDynAny
object is not equivalent to the type code for aint
get_ulong
int get_ulong() throws TypeMismatch
Deprecated.
Retrieves the int
contained in this DynAny
object.
- Returns:
- the
int
that is the value for thisDynAny
object - Throws:
-
TypeMismatch
- if the type code of the accessed component in thisDynAny
object is not equivalent to the type code for aint
get_float
float get_float() throws TypeMismatch
Deprecated.
Retrieves the float
contained in this DynAny
object.
- Returns:
- the
float
that is the value for thisDynAny
object - Throws:
-
TypeMismatch
- if the type code of the accessed component in thisDynAny
object is not equivalent to the type code for afloat
get_double
double get_double() throws TypeMismatch
Deprecated.
Retrieves the double
contained in this DynAny
object.
- Returns:
- the
double
that is the value for thisDynAny
object - Throws:
-
TypeMismatch
- if the type code of the accessed component in thisDynAny
object is not equivalent to the type code for adouble
get_string
String get_string() throws TypeMismatch
Deprecated.
Retrieves the String
contained in this DynAny
object.
- Returns:
- the
String
that is the value for thisDynAny
object - Throws:
-
TypeMismatch
- if the type code of the accessed component in thisDynAny
object is not equivalent to the type code for aString
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 thisDynAny
object - Throws:
-
TypeMismatch
- if the type code of the accessed component in thisDynAny
object is not equivalent to the type code for anorg.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 thisDynAny
object - Throws:
-
TypeMismatch
- if the type code of the accessed component in thisDynAny
object is not equivalent to the type code for aorg.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 thisDynAny
object - Throws:
-
TypeMismatch
- if the type code of the accessed component in thisDynAny
object is not equivalent to the type code for along
get_ulonglong
long get_ulonglong() throws TypeMismatch
Deprecated.
Retrieves the long
contained in this DynAny
object.
- Returns:
- the
long
that is the value for thisDynAny
object - Throws:
-
TypeMismatch
- if the type code of the accessed component in thisDynAny
object is not equivalent to the type code for along
get_wchar
char get_wchar() throws TypeMismatch
Deprecated.
Retrieves the char
contained in this DynAny
object.
- Returns:
- the
char
that is the value for thisDynAny
object - Throws:
-
TypeMismatch
- if the type code of the accessed component in thisDynAny
object is not equivalent to the type code for achar
get_wstring
String get_wstring() throws TypeMismatch
Deprecated.
Retrieves the String
contained in this DynAny
object.
- Returns:
- the
String
that is the value for thisDynAny
object - Throws:
-
TypeMismatch
- if the type code of the accessed component in thisDynAny
object is not equivalent to the type code for aString
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 thisDynAny
object - Throws:
-
TypeMismatch
- if the type code of the accessed component in thisDynAny
object is not equivalent to the type code for anorg.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 thisDynAny
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
- anint
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 thisDynAny
object is associated with a basic type, this method returnsfalse
for any index other than 0.
rewind
void rewind()
Deprecated.
Moves the internal pointer to the first component.
© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/javase/8/docs/api/org/omg/CORBA/DynAny.html