- java.lang.Object
-
- org.omg.CORBA.Any
-
- All Implemented Interfaces:
- Serializable, IDLEntity
public abstract class Any extends Object implements IDLEntity
Serves as a container for any data that can be described in IDL or for any IDL primitive type. AnAny
object is used as a component of aNamedValue
object, which provides information about arguments or return values in requests, and which is used to define name/value pairs inContext
objects.An
Any
object consists of two parts:- a data value
- a
TypeCode
object describing the type of the data value contained in theAny
object. For example, aTypeCode
object for an array contains a field for the length of the array and a field for the type of elements in the array. (Note that in this case, the second field of theTypeCode
object is itself aTypeCode
object.)
- Since:
- JDK1.2
-
-
Constructor Summary
Constructors Constructor and Description Any()
-
Method Summary
Methods Modifier and Type Method and Description abstract InputStream
create_input_stream()
Creates an input stream from which thisAny
object's value can be unmarshalled.abstract OutputStream
create_output_stream()
Creates an output stream into which thisAny
object's value can be marshalled.abstract boolean
equal(Any a)
Checks for equality between thisAny
object and the givenAny
object.abstract Any
extract_any()
Extracts theAny
object in thisAny
object'svalue
field.abstract boolean
extract_boolean()
Extracts theboolean
in thisAny
object'svalue
field.abstract char
extract_char()
Extracts thechar
in thisAny
object'svalue
field.abstract double
extract_double()
Extracts thedouble
in thisAny
object'svalue
field.BigDecimal
extract_fixed()
Extracts thejava.math.BigDecimal
object in thisAny
object'svalue
field.abstract float
extract_float()
Extracts thefloat
in thisAny
object'svalue
field.abstract int
extract_long()
Extracts theint
in thisAny
object'svalue
field.abstract long
extract_longlong()
Extracts thelong
in thisAny
object'svalue
field.abstract Object
extract_Object()
Extracts theorg.omg.CORBA.Object
in thisAny
object'svalue
field.abstract byte
extract_octet()
Extracts thebyte
in thisAny
object'svalue
field.Principal
extract_Principal()
Deprecated.Deprecated by CORBA 2.2.abstract short
extract_short()
Extracts theshort
in thisAny
object'svalue
field.Streamable
extract_Streamable()
Extracts aStreamable
from thisAny
object'svalue
field.abstract String
extract_string()
Extracts theString
object in thisAny
object'svalue
field.abstract TypeCode
extract_TypeCode()
Extracts theTypeCode
object in thisAny
object'svalue
field.abstract int
extract_ulong()
Extracts theint
in thisAny
object'svalue
field.abstract long
extract_ulonglong()
Extracts thelong
in thisAny
object'svalue
field.abstract short
extract_ushort()
Extracts theshort
in thisAny
object'svalue
field.abstract Serializable
extract_Value()
Extracts thejava.io.Serializable
object in thisAny
object'svalue
field.abstract char
extract_wchar()
Extracts thechar
in thisAny
object'svalue
field.abstract String
extract_wstring()
Extracts theString
object in thisAny
object'svalue
field.abstract void
insert_any(Any a)
Inserts the givenAny
object into thisAny
object'svalue
field.abstract void
insert_boolean(boolean b)
Inserts the givenboolean
into thisAny
object'svalue
field.abstract void
insert_char(char c)
Inserts the givenchar
into thisAny
object'svalue
field.abstract void
insert_double(double d)
Inserts the givendouble
into thisAny
object'svalue
field.void
insert_fixed(BigDecimal value)
Throws anorg.omg.CORBA.NO_IMPLEMENT
exception.void
insert_fixed(BigDecimal value, TypeCode type)
Throws anorg.omg.CORBA.NO_IMPLEMENT
exception.abstract void
insert_float(float f)
Inserts the givenfloat
into thisAny
object'svalue
field.abstract void
insert_long(int l)
Inserts the givenint
into thisAny
object'svalue
field.abstract void
insert_longlong(long l)
Inserts the givenlong
into thisAny
object'svalue
field.abstract void
insert_Object(Object o)
Inserts the givenorg.omg.CORBA.Object
object into thisAny
object'svalue
field.abstract void
insert_Object(Object o, TypeCode t)
Inserts the givenorg.omg.CORBA.Object
object into thisAny
object'svalue
field.abstract void
insert_octet(byte b)
Inserts the givenbyte
into thisAny
object'svalue
field.void
insert_Principal(Principal p)
Deprecated.Deprecated by CORBA 2.2.abstract void
insert_short(short s)
Inserts the givenshort
into thisAny
object'svalue
field.void
insert_Streamable(Streamable s)
Inserts the givenStreamable
object into thisAny
object'svalue
field.abstract void
insert_string(String s)
Inserts the givenString
object into thisAny
object'svalue
field.abstract void
insert_TypeCode(TypeCode t)
Inserts the givenTypeCode
object into thisAny
object'svalue
field.abstract void
insert_ulong(int l)
Inserts the givenint
into thisAny
object'svalue
field.abstract void
insert_ulonglong(long l)
Inserts the givenlong
into thisAny
object'svalue
field.abstract void
insert_ushort(short s)
Inserts the givenshort
into thisAny
object'svalue
field.abstract void
insert_Value(Serializable v)
Inserts the givenjava.io.Serializable
object into thisAny
object'svalue
field.abstract void
insert_Value(Serializable v, TypeCode t)
Inserts the givenjava.io.Serializable
object into thisAny
object'svalue
field.abstract void
insert_wchar(char c)
Inserts the givenchar
into thisAny
object'svalue
field.abstract void
insert_wstring(String s)
Inserts the givenString
object into thisAny
object'svalue
field.abstract void
read_value(InputStream is, TypeCode t)
Reads off (unmarshals) the value of anAny
object from the given input stream using the given typecode.abstract TypeCode
type()
Returns type information for the element contained in thisAny
object.abstract void
type(TypeCode t)
Sets thisAny
object'stype
field to the givenTypeCode
object and clears its value.abstract void
write_value(OutputStream os)
Writes out the value of thisAny
object to the given output stream.
-
-
-
Method Detail
-
equal
public abstract boolean equal(Any a)
Checks for equality between thisAny
object and the givenAny
object. TwoAny
objects are equal if both their values and type codes are equal.- Parameters:
a
- theAny
object to test for equality- Returns:
true
if theAny
objects are equal;false
otherwise- See Also:
CORBA
package comments for unimplemented features
-
type
public abstract TypeCode type()
Returns type information for the element contained in thisAny
object.- Returns:
- the
TypeCode
object containing type information about the value contained in thisAny
object
-
type
public abstract void type(TypeCode t)
Sets thisAny
object'stype
field to the givenTypeCode
object and clears its value.Note that using this method to set the type code wipes out the value if there is one. The method is provided primarily so that the type may be set properly for IDL
out
parameters. Generally, setting the type is done by theinsert_X
methods, which will set the type to X if it is not already set to X.- Parameters:
t
- theTypeCode
object giving information for the value in thisAny
object
-
read_value
public abstract void read_value(InputStream is, TypeCode t) throws MARSHAL
Reads off (unmarshals) the value of anAny
object from the given input stream using the given typecode.- Parameters:
is
- theorg.omg.CORBA.portable.InputStream
object from which to read the value contained in thisAny
objectt
- aTypeCode
object containing type information about the value to be read- Throws:
MARSHAL
- when the givenTypeCode
object is not consistent with the value that was contained in the input stream
-
write_value
public abstract void write_value(OutputStream os)
Writes out the value of thisAny
object to the given output stream. If bothtypecode
andvalue
need to be written, usecreate_output_stream()
to create anOutputStream
, then usewrite_any
on theOutputStream
.If this method is called on an
Any
object that has not had a value inserted into itsvalue
field, it will throw the exceptionjava.lang.NullPointerException
.- Parameters:
os
- theorg.omg.CORBA.portable.OutputStream
object into which to marshal the value of thisAny
object
-
create_output_stream
public abstract OutputStream create_output_stream()
Creates an output stream into which thisAny
object's value can be marshalled.- Returns:
- the newly-created
OutputStream
-
create_input_stream
public abstract InputStream create_input_stream()
Creates an input stream from which thisAny
object's value can be unmarshalled.- Returns:
- the newly-created
InputStream
-
extract_short
public abstract short extract_short() throws BAD_OPERATION
Extracts theshort
in thisAny
object'svalue
field.- Returns:
- the
short
stored in thisAny
object - Throws:
BAD_OPERATION
- if thisAny
object contains something other than ashort
or thevalue
field has not yet been set
-
insert_short
public abstract void insert_short(short s)
Inserts the givenshort
into thisAny
object'svalue
field.- Parameters:
s
- theshort
to insert into thisAny
object
-
extract_long
public abstract int extract_long() throws BAD_OPERATION
Extracts theint
in thisAny
object'svalue
field.- Returns:
- the
int
stored in thisAny
object - Throws:
BAD_OPERATION
- if thisAny
object contains something other than anint
or thevalue
field has not yet been set
-
insert_long
public abstract void insert_long(int l)
Inserts the givenint
into thisAny
object'svalue
field.- Parameters:
l
- theint
to insert into thisAny
object
-
extract_longlong
public abstract long extract_longlong() throws BAD_OPERATION
Extracts thelong
in thisAny
object'svalue
field.- Returns:
- the
long
stored in thisAny
object - Throws:
BAD_OPERATION
- if thisAny
object contains something other than along
or thevalue
field has not yet been set
-
insert_longlong
public abstract void insert_longlong(long l)
Inserts the givenlong
into thisAny
object'svalue
field.- Parameters:
l
- thelong
to insert into thisAny
object
-
extract_ushort
public abstract short extract_ushort() throws BAD_OPERATION
Extracts theshort
in thisAny
object'svalue
field.- Returns:
- the
short
stored in thisAny
object - Throws:
BAD_OPERATION
- if thisAny
object contains something other than ashort
or thevalue
field has not yet been set
-
insert_ushort
public abstract void insert_ushort(short s)
Inserts the givenshort
into thisAny
object'svalue
field.- Parameters:
s
- theshort
to insert into thisAny
object
-
extract_ulong
public abstract int extract_ulong() throws BAD_OPERATION
Extracts theint
in thisAny
object'svalue
field.- Returns:
- the
int
stored in thisAny
object - Throws:
BAD_OPERATION
- if thisAny
object contains something other than anint
or thevalue
field has not yet been set
-
insert_ulong
public abstract void insert_ulong(int l)
Inserts the givenint
into thisAny
object'svalue
field.- Parameters:
l
- theint
to insert into thisAny
object
-
extract_ulonglong
public abstract long extract_ulonglong() throws BAD_OPERATION
Extracts thelong
in thisAny
object'svalue
field.- Returns:
- the
long
stored in thisAny
object - Throws:
BAD_OPERATION
- if thisAny
object contains something other than along
or thevalue
field has not yet been set
-
insert_ulonglong
public abstract void insert_ulonglong(long l)
Inserts the givenlong
into thisAny
object'svalue
field.- Parameters:
l
- thelong
to insert into thisAny
object
-
extract_float
public abstract float extract_float() throws BAD_OPERATION
Extracts thefloat
in thisAny
object'svalue
field.- Returns:
- the
float
stored in thisAny
object - Throws:
BAD_OPERATION
- if thisAny
object contains something other than afloat
or thevalue
field has not yet been set
-
insert_float
public abstract void insert_float(float f)
Inserts the givenfloat
into thisAny
object'svalue
field.- Parameters:
f
- thefloat
to insert into thisAny
object
-
extract_double
public abstract double extract_double() throws BAD_OPERATION
Extracts thedouble
in thisAny
object'svalue
field.- Returns:
- the
double
stored in thisAny
object - Throws:
BAD_OPERATION
- if thisAny
object contains something other than adouble
or thevalue
field has not yet been set
-
insert_double
public abstract void insert_double(double d)
Inserts the givendouble
into thisAny
object'svalue
field.- Parameters:
d
- thedouble
to insert into thisAny
object
-
extract_boolean
public abstract boolean extract_boolean() throws BAD_OPERATION
Extracts theboolean
in thisAny
object'svalue
field.- Returns:
- the
boolean
stored in thisAny
object - Throws:
BAD_OPERATION
- if thisAny
object contains something other than aboolean
or thevalue
field has not yet been set
-
insert_boolean
public abstract void insert_boolean(boolean b)
Inserts the givenboolean
into thisAny
object'svalue
field.- Parameters:
b
- theboolean
to insert into thisAny
object
-
extract_char
public abstract char extract_char() throws BAD_OPERATION
Extracts thechar
in thisAny
object'svalue
field.- Returns:
- the
char
stored in thisAny
object - Throws:
BAD_OPERATION
- if thisAny
object contains something other than achar
or thevalue
field has not yet been set
-
insert_char
public abstract void insert_char(char c) throws DATA_CONVERSION
Inserts the givenchar
into thisAny
object'svalue
field.- Parameters:
c
- thechar
to insert into thisAny
object- Throws:
DATA_CONVERSION
- if there is a data conversion error
-
extract_wchar
public abstract char extract_wchar() throws BAD_OPERATION
Extracts thechar
in thisAny
object'svalue
field.- Returns:
- the
char
stored in thisAny
object - Throws:
BAD_OPERATION
- if thisAny
object contains something other than achar
or thevalue
field has not yet been set
-
insert_wchar
public abstract void insert_wchar(char c)
Inserts the givenchar
into thisAny
object'svalue
field.- Parameters:
c
- thechar
to insert into thisAny
object
-
extract_octet
public abstract byte extract_octet() throws BAD_OPERATION
Extracts thebyte
in thisAny
object'svalue
field.- Returns:
- the
byte
stored in thisAny
object - Throws:
BAD_OPERATION
- if thisAny
object contains something other than abyte
or thevalue
field has not yet been set
-
insert_octet
public abstract void insert_octet(byte b)
Inserts the givenbyte
into thisAny
object'svalue
field.- Parameters:
b
- thebyte
to insert into thisAny
object
-
extract_any
public abstract Any extract_any() throws BAD_OPERATION
Extracts theAny
object in thisAny
object'svalue
field.- Returns:
- the
Any
object stored in thisAny
object - Throws:
BAD_OPERATION
- if thisAny
object contains something other than anAny
object or thevalue
field has not yet been set
-
insert_any
public abstract void insert_any(Any a)
Inserts the givenAny
object into thisAny
object'svalue
field.- Parameters:
a
- theAny
object to insert into thisAny
object
-
extract_Object
public abstract Object extract_Object() throws BAD_OPERATION
Extracts theorg.omg.CORBA.Object
in thisAny
object'svalue
field.- Returns:
- the
org.omg.CORBA.Object
stored in thisAny
object - Throws:
BAD_OPERATION
- if thisAny
object contains something other than anorg.omg.CORBA.Object
or thevalue
field has not yet been set
-
insert_Object
public abstract void insert_Object(Object o)
Inserts the givenorg.omg.CORBA.Object
object into thisAny
object'svalue
field.- Parameters:
o
- theorg.omg.CORBA.Object
object to insert into thisAny
object
-
extract_Value
public abstract Serializable extract_Value() throws BAD_OPERATION
Extracts thejava.io.Serializable
object in thisAny
object'svalue
field.- Returns:
- the
java.io.Serializable
object stored in thisAny
object - Throws:
BAD_OPERATION
- if thisAny
object contains something other than ajava.io.Serializable
object or thevalue
field has not yet been set
-
insert_Value
public abstract void insert_Value(Serializable v)
Inserts the givenjava.io.Serializable
object into thisAny
object'svalue
field.- Parameters:
v
- thejava.io.Serializable
object to insert into thisAny
object
-
insert_Value
public abstract void insert_Value(Serializable v, TypeCode t) throws MARSHAL
Inserts the givenjava.io.Serializable
object into thisAny
object'svalue
field.- Parameters:
v
- thejava.io.Serializable
object to insert into thisAny
objectt
- theTypeCode
object that is to be inserted into thisAny
object'stype
field and that describes thejava.io.Serializable
object being inserted- Throws:
MARSHAL
- if the ORB has a problem marshalling or unmarshalling parameters
-
insert_Object
public abstract void insert_Object(Object o, TypeCode t) throws BAD_PARAM
Inserts the givenorg.omg.CORBA.Object
object into thisAny
object'svalue
field.- Parameters:
o
- theorg.omg.CORBA.Object
instance to insert into thisAny
objectt
- theTypeCode
object that is to be inserted into thisAny
object and that describes theObject
being inserted- Throws:
BAD_OPERATION
- if this method is invalid for thisAny
objectBAD_PARAM
-
extract_string
public abstract String extract_string() throws BAD_OPERATION
Extracts theString
object in thisAny
object'svalue
field.- Returns:
- the
String
object stored in thisAny
object - Throws:
BAD_OPERATION
- if thisAny
object contains something other than aString
object or thevalue
field has not yet been set
-
insert_string
public abstract void insert_string(String s) throws DATA_CONVERSION, MARSHAL
Inserts the givenString
object into thisAny
object'svalue
field.- Parameters:
s
- theString
object to insert into thisAny
object- Throws:
DATA_CONVERSION
- if there is a data conversion errorMARSHAL
- if the ORB has a problem marshalling or unmarshalling parameters
-
extract_wstring
public abstract String extract_wstring() throws BAD_OPERATION
Extracts theString
object in thisAny
object'svalue
field.- Returns:
- the
String
object stored in thisAny
object - Throws:
BAD_OPERATION
- if thisAny
object contains something other than aString
object or thevalue
field has not yet been set
-
insert_wstring
public abstract void insert_wstring(String s) throws MARSHAL
Inserts the givenString
object into thisAny
object'svalue
field.- Parameters:
s
- theString
object to insert into thisAny
object- Throws:
MARSHAL
- if the ORB has a problem marshalling or unmarshalling parameters
-
extract_TypeCode
public abstract TypeCode extract_TypeCode() throws BAD_OPERATION
Extracts theTypeCode
object in thisAny
object'svalue
field.- Returns:
- the
TypeCode
object stored in thisAny
object - Throws:
BAD_OPERATION
- if thisAny
object contains something other than aTypeCode
object or thevalue
field has not yet been set
-
insert_TypeCode
public abstract void insert_TypeCode(TypeCode t)
Inserts the givenTypeCode
object into thisAny
object'svalue
field.- Parameters:
t
- theTypeCode
object to insert into thisAny
object
-
extract_Principal
@Deprecated public Principal extract_Principal() throws BAD_OPERATION
Deprecated. Deprecated by CORBA 2.2.Extracts thePrincipal
object in thisAny
object'svalue
field. Note that the classPrincipal
has been deprecated.- Returns:
- the
Principal
object stored in thisAny
object - Throws:
BAD_OPERATION
- if thisAny
object contains something other than aPrincipal
object or thevalue
field has not yet been set- See Also:
CORBA
package comments for unimplemented features
-
insert_Principal
@Deprecated public void insert_Principal(Principal p)
Deprecated. Deprecated by CORBA 2.2.Inserts the givenPrincipal
object into thisAny
object'svalue
field. Note that the classPrincipal
has been deprecated.- Parameters:
p
- thePrincipal
object to insert into thisAny
object- See Also:
CORBA
package comments for unimplemented features
-
extract_Streamable
public Streamable extract_Streamable() throws BAD_INV_ORDER
Extracts aStreamable
from thisAny
object'svalue
field. This method allows the extraction of non-primitive IDL types.- Returns:
- the
Streamable
stored in theAny
object. - Throws:
BAD_INV_ORDER
- if the caller has invoked operations in the wrong order- See Also:
CORBA
package comments for unimplemented features
-
insert_Streamable
public void insert_Streamable(Streamable s)
Inserts the givenStreamable
object into thisAny
object'svalue
field. This method allows the insertion of non-primitive IDL types.- Parameters:
s
- theStreamable
object to insert into thisAny
object; may be a non-primitive IDL type- See Also:
CORBA
package comments for unimplemented features
-
extract_fixed
public BigDecimal extract_fixed()
Extracts thejava.math.BigDecimal
object in thisAny
object'svalue
field.- Returns:
- the
java.math.BigDecimal
object stored in thisAny
object - Throws:
BAD_OPERATION
- if thisAny
object contains something other than ajava.math.BigDecimal
object or thevalue
field has not yet been set- See Also:
CORBA
package comments for unimplemented features
-
insert_fixed
public void insert_fixed(BigDecimal value)
Throws anorg.omg.CORBA.NO_IMPLEMENT
exception.Inserts the given
java.math.BigDecimal
object into thisAny
object'svalue
field.- Parameters:
value
- thejava.math.BigDecimal
object to insert into thisAny
object- See Also:
CORBA
package comments for unimplemented features
-
insert_fixed
public void insert_fixed(BigDecimal value, TypeCode type) throws BAD_INV_ORDER
Throws anorg.omg.CORBA.NO_IMPLEMENT
exception.Inserts the given
java.math.BigDecimal
object into thisAny
object'svalue
field.- Parameters:
value
- thejava.math.BigDecimal
object to insert into thisAny
objecttype
- theTypeCode
object that is to be inserted into thisAny
object'stype
field and that describes thejava.math.BigDecimal
object being inserted- Throws:
BAD_INV_ORDER
- if this method is invoked improperly- See Also:
CORBA
package comments for unimplemented features
-
-
Nederlandse vertaling
U hebt gevraagd om deze site in het Nederlands te bezoeken. Voor nu wordt alleen de interface vertaald, maar nog niet alle inhoud.Als je me wilt helpen met vertalingen, is je bijdrage welkom. Het enige dat u hoeft te doen, is u op de site registreren en mij een bericht sturen waarin u wordt gevraagd om u toe te voegen aan de groep vertalers, zodat u de gewenste pagina's kunt vertalen. Een link onderaan elke vertaalde pagina geeft aan dat u de vertaler bent en heeft een link naar uw profiel.
Bij voorbaat dank.
Document heeft de 11/06/2005 gemaakt, de laatste keer de 04/03/2020 gewijzigd
Bron van het afgedrukte document:https://www.gaudry.be/nl/java-api-rf-org/omg/CORBA/Any.html
De infobrol is een persoonlijke site waarvan de inhoud uitsluitend mijn verantwoordelijkheid is. De tekst is beschikbaar onder CreativeCommons-licentie (BY-NC-SA). Meer info op de gebruiksvoorwaarden en de auteur.
Referenties
Deze verwijzingen en links verwijzen naar documenten die geraadpleegd zijn tijdens het schrijven van deze pagina, of die aanvullende informatie kunnen geven, maar de auteurs van deze bronnen kunnen niet verantwoordelijk worden gehouden voor de inhoud van deze pagina.
De auteur Deze site is als enige verantwoordelijk voor de manier waarop de verschillende concepten, en de vrijheden die met de referentiewerken worden genomen, hier worden gepresenteerd. Vergeet niet dat u meerdere broninformatie moet doorgeven om het risico op fouten te verkleinen.