org.omg.CORBA

Class Any

java.lang.Object

org.omg.CORBA.Any

All Implemented Interfaces:

Serializable ， IDLEntity

public abstract class Any
extends Object
implements IDLEntity

作为可以在IDL或任何IDL原语类型中描述的任何数据的容器。 一个Any对象用作的一个组件NamedValue对象，它提供了有关请求参数或返回值的信息，并且用于在定义的名称/值对Context对象。

一个Any对象由两部分组成：

1. 一个数据值
2. TypeCode对象中包含的数据值类型的Any对象。 例如，数组的TypeCode对象包含数组长度的字段和数组中元素类型的字段。 （请注意，在这种情况下， TypeCode对象的第二个字段本身就是一个TypeCode对象。）

A large part of the Any class consists of pairs of methods for inserting values into and extracting values from an Any object.

For a given primitive type X, these methods are:

void insert_X(X x)

This method allows the insertion of an instance x of primitive type X into the value field of the Any object. Note that the method insert_X also resets the Any object's type field if necessary.

X extract_X()

This method allows the extraction of an instance of type X from the Any object.

This method throws the exception BAD_OPERATION under two conditions:

1. the type of the element contained in the Any object is not X
2. the method extract_X is called before the value field of the Any object has been set

There are distinct method pairs for each primitive IDL data type (insert_long and extract_long, insert_string and extract_string, and so on).

The class Any also has methods for getting and setting the type code, for testing two Any objects for equality, and for reading an Any object from a stream or writing it to a stream.

从以下版本开始：

JDK1.2

构造方法摘要

构造方法

Constructor and Description
Any()

方法摘要

Modifier and Type	Method and Description
abstract InputStream	create_input_stream() 创建一个输入流，从中可以对该 Any对象的值进行解组。
abstract OutputStream	create_output_stream() 创建一个可以编组此 Any对象值的输出流。
abstract boolean	equal(Any a) 检查此 Any对象与给定的 Any对象之间是否相等。
abstract Any	extract_any() 在此 Any对象的 value字段中提取 Any对象。
abstract boolean	extract_boolean() 提取 boolean这个 Any对象 value场。
abstract char	extract_char() 提取 char这个 Any对象 value场。
abstract double	extract_double() 提取 double这个 Any对象 value场。
BigDecimal	extract_fixed() 提取 java.math.BigDecimal这个对象 Any对象 value场。
abstract float	extract_float() 提取 float这个 Any对象 value场。
abstract int	extract_long() 提取 int这个 Any对象 value场。
abstract long	extract_longlong() 提取 long这个 Any对象 value场。
abstract Object	extract_Object() 提取 org.omg.CORBA.Object这个 Any对象 value场。
abstract byte	extract_octet() 提取 byte这个 Any对象 value场。
Principal	extract_Principal() 已弃用 被CORBA弃用2.2。
abstract short	extract_short() 提取 short这个 Any对象 value场。
Streamable	extract_Streamable() 提取 Streamable从这个 Any对象 value场。
abstract String	extract_string() 在 Any对象的 value字段中提取 String对象。
abstract TypeCode	extract_TypeCode() 在此 Any对象的 value字段中提取 TypeCode对象。
abstract int	extract_ulong() 提取 int这个 Any对象 value场。
abstract long	extract_ulonglong() 提取 long这个 Any对象 value场。
abstract short	extract_ushort() 提取 short这个 Any对象 value场。
abstract Serializable	extract_Value() 在此 Any对象的 value字段中提取 java.io.Serializable对象。
abstract char	extract_wchar() 提取 char这个 Any对象 value场。
abstract String	extract_wstring() 在 Any对象的 value字段中提取 String对象。
abstract void	insert_any(Any a) 将给定的 Any对象插入到此 Any对象的 value字段中。
abstract void	insert_boolean(boolean b) 将给定的 boolean插入到这个 Any对象的 value字段中。
abstract void	insert_char(char c) 将给定的 char插入此 Any对象的 value字段。
abstract void	insert_double(double d) 将给定的 double插入到这个 Any对象的 value字段中。
void	insert_fixed(BigDecimal value) 抛出一个 org.omg.CORBA.NO_IMPLEMENT异常。
void	insert_fixed(BigDecimal value, TypeCode type) 抛出 org.omg.CORBA.NO_IMPLEMENT异常。
abstract void	insert_float(float f) 将给定的 float插入此 Any对象的 value字段。
abstract void	insert_long(int l) 将给定的 int插入到这个 Any对象的 value字段中。
abstract void	insert_longlong(long l) 将给定的 long插入此 Any对象的 value字段。
abstract void	insert_Object(Object o) 将给定的 org.omg.CORBA.Object对象插入到此 Any对象的 value字段中。
abstract void	insert_Object(Object o, TypeCode t) 将给定的 org.omg.CORBA.Object对象插入到此 Any对象的 value字段中。
abstract void	insert_octet(byte b) 将给定的 byte插入到这个 Any对象的 value字段中。
void	insert_Principal(Principal p) 已弃用 被CORBA弃用2.2。
abstract void	insert_short(short s) 将给定的 short插入到这个 Any对象的 value字段中。
void	insert_Streamable(Streamable s) 将给定的 Streamable对象插入到此 Any对象的 value字段中。
abstract void	insert_string(String s) 将给定的 String对象插入到此 Any对象的 value字段中。
abstract void	insert_TypeCode(TypeCode t) 将给定的 TypeCode对象插入到此 Any对象的 value字段中。
abstract void	insert_ulong(int l) 将给定的 int插入到这个 Any对象的 value字段中。
abstract void	insert_ulonglong(long l) 将给定的 long插入到这个 Any对象的 value字段中。
abstract void	insert_ushort(short s) 将给定的 short插入到这个 Any对象的 value字段中。
abstract void	insert_Value(Serializable v) 将给定的 java.io.Serializable对象插入到此 Any对象的 value字段中。
abstract void	insert_Value(Serializable v, TypeCode t) 将给定的 java.io.Serializable对象插入到此 Any对象的 value字段中。
abstract void	insert_wchar(char c) 将给定的 char插入此 Any对象的 value字段。
abstract void	insert_wstring(String s) 将给定的 String对象插入到此 Any对象的 value字段中。
abstract void	read_value(InputStream is, TypeCode t) 使用给定的类型代码，从给定的输入流中读取（解组） Any对象的值。
abstract TypeCode	type() 返回此 Any对象中包含的元素的类型信息。
abstract void	type(TypeCode t) 将此 Any对象的 type字段设置为给定的 TypeCode对象并清除其值。
abstract void	write_value(OutputStream os) 将此 Any对象的值写入给定的输出流。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造方法详细信息

Any

public Any()

方法详细信息

equal

public abstract boolean equal(Any a)

检查此Any对象与给定的Any对象之间是否相等。 如果两个Any对象的值和类型代码相等，则相等。

参数

a - Any对象测试相等

结果

true如果Any对象相等; false否则

另请参见：

CORBA package comments for unimplemented features

type

public abstract TypeCode type()

返回此 Any对象中包含的元素的类型信息。

结果

该 TypeCode对象包含有关此 Any对象中包含的值的类型信息

type

public abstract void type(TypeCode t)

将此Any对象的type字段设置为给定的TypeCode对象并清除其值。

请注意，使用此方法设置类型代码会擦除值，如果有的话。 主要提供的方法是为IDL out参数设置适当的类型。 通常，设置类型是由insert_X方法完成的，如果尚未设置为X，则将其类型设置为X.

参数

t -在 TypeCode这个对象，提供信息的价值 Any对象

read_value

public abstract void read_value(InputStream is,
                                TypeCode t)
                         throws MARSHAL

使用给定的类型代码从给定的输入流中读取（解组） Any对象的值。

参数

is - org.omg.CORBA.portable.InputStream对象，从中读取此 Any对象中 Any值

t - 一个 TypeCode对象，其中包含有关要读取的值的类型信息

异常

MARSHAL - 当给定的 TypeCode对象与输入流中包含的值不一致时

write_value

public abstract void write_value(OutputStream os)

将此Any对象的值写入给定的输出流。 如果typecode和value都需要写入，请使用create_output_stream()创建一个OutputStream ，然后在write_any上使用OutputStream 。

如果在没有将值插入到其value字段的Any对象上调用此方法，则会抛出异常java.lang.NullPointerException 。

参数

os - org.omg.CORBA.portable.OutputStream对象，其中向这个 Any对象的值进行编组

create_output_stream

public abstract OutputStream create_output_stream()

创建一个可以编组此 Any对象的值的输出流。

结果

新创 OutputStream

create_input_stream

public abstract InputStream create_input_stream()

创建一个输入流，从中可以对该 Any对象的值进行解组。

结果

新创 InputStream

extract_short

public abstract short extract_short()
                             throws BAD_OPERATION

提取 short这个 Any对象 value场。

结果

该 short存储在此 Any对象中

异常

BAD_OPERATION -如果此 Any对象包含比其他东西 short或 value领域尚未设置

insert_short

public abstract void insert_short(short s)

将给定的 short插入到这个 Any对象的 value字段中。

参数

s -在 short插入到这个 Any对象

extract_long

public abstract int extract_long()
                          throws BAD_OPERATION

提取 int这个 Any对象 value场。

结果

int存储在此 Any对象中

异常

BAD_OPERATION - 如果这 Any对象包含一个不是 int或 value字段还没有设置

insert_long

public abstract void insert_long(int l)

将给定的 int插入此 Any对象的 value字段。

参数

l -在 int插入到这个 Any对象

extract_longlong

public abstract long extract_longlong()
                               throws BAD_OPERATION

提取 long这个 Any对象 value场。

结果

long存储在此 Any对象中

异常

BAD_OPERATION -如果此 Any对象包含比其他东西 long或 value领域尚未设置

insert_longlong

public abstract void insert_longlong(long l)

将给定的 long插入此 Any对象的 value字段。

参数

l -在 long插入到这个 Any对象

extract_ushort

public abstract short extract_ushort()
                              throws BAD_OPERATION

提取 short这个 Any对象 value场。

结果

short存储在此 Any对象中

异常

BAD_OPERATION -如果此 Any对象包含比其他东西 short或 value领域尚未设置

insert_ushort

public abstract void insert_ushort(short s)

将给定的 short插入到这个 Any对象的 value字段中。

参数

s - short插入到这个 Any对象

extract_ulong

public abstract int extract_ulong()
                           throws BAD_OPERATION

提取 int这个 Any对象 value场。

结果

int存储在此 Any对象中

异常

BAD_OPERATION -如果此 Any对象包含比其他东西 int或 value领域尚未设置

insert_ulong

public abstract void insert_ulong(int l)

将给定的 int插入此 Any对象的 value字段。

参数

l -在 int插入到这个 Any对象

extract_ulonglong

public abstract long extract_ulonglong()
                                throws BAD_OPERATION

提取 long这个 Any对象 value场。

结果

long存储在此 Any对象中

异常

BAD_OPERATION -如果此 Any对象包含比其他东西 long或 value领域尚未设置

insert_ulonglong

public abstract void insert_ulonglong(long l)

将给定的 long插入此 Any对象的 value字段。

参数

l - long插入到这个 Any对象

extract_float

public abstract float extract_float()
                             throws BAD_OPERATION

提取 float这个 Any对象 value场。

结果

float存储在此 Any对象中

异常

BAD_OPERATION -如果此 Any对象包含比其他东西 float或 value领域尚未设置

insert_float

public abstract void insert_float(float f)

将给定的 float插入此 Any对象的 value字段。

参数

f - float插入此 Any对象

extract_double

public abstract double extract_double()
                               throws BAD_OPERATION

提取 double这个 Any对象 value场。

结果

double存储在此 Any对象中

异常

BAD_OPERATION - 如果这 Any对象包含一个不是 double或 value字段尚未设置

insert_double

public abstract void insert_double(double d)

将给定的 double插入到这个 Any对象的 value字段中。

参数

d -在 double插入到这个 Any对象

extract_boolean

public abstract boolean extract_boolean()
                                 throws BAD_OPERATION

提取 boolean这个 Any对象 value场。

结果

boolean存储在此 Any对象中

异常

BAD_OPERATION -如果此 Any对象包含比其他东西 boolean或 value领域尚未设置

insert_boolean

public abstract void insert_boolean(boolean b)

将给定的 boolean插入此 Any对象的 value字段。

参数

b - boolean插入到这个 Any对象

extract_char

public abstract char extract_char()
                           throws BAD_OPERATION

提取 char这个 Any对象 value场。

结果

char存储在此 Any对象中

异常

BAD_OPERATION -如果此 Any对象包含比其他东西 char或 value领域尚未设置

insert_char

public abstract void insert_char(char c)
                          throws DATA_CONVERSION

将给定的 char插入此 Any对象的 value字段。

参数

c - char插入此 Any对象

异常

DATA_CONVERSION - 如果有数据转换错误

extract_wchar

public abstract char extract_wchar()
                            throws BAD_OPERATION

提取 char这个 Any对象 value场。

结果

char存储在此 Any对象中

异常

BAD_OPERATION -如果此 Any对象包含比其他东西 char或 value领域尚未设置

insert_wchar

public abstract void insert_wchar(char c)

将给定的 char插入此 Any对象的 value字段。

参数

c - char插入此 Any对象

extract_octet

public abstract byte extract_octet()
                            throws BAD_OPERATION

提取 byte这个 Any对象 value场。

结果

byte存储在此 Any对象中

异常

BAD_OPERATION -如果此 Any对象包含比其他东西 byte或 value领域尚未设置

insert_octet

public abstract void insert_octet(byte b)

将给定的 byte插入此 Any对象的 value字段。

参数

b - byte插入到这个 Any对象

extract_any

public abstract Any extract_any()
                         throws BAD_OPERATION

在 Any对象的 value字段中提取 Any对象。

结果

Any对象存储在此 Any对象中

异常

BAD_OPERATION -如果此 Any对象包含其他的东西比一个 Any对象或 value领域尚未设置

insert_any

public abstract void insert_any(Any a)

将给定的 Any对象插入到这个 Any对象的 value字段中。

参数

a -在 Any对象插入此 Any对象

extract_Object

public abstract Object extract_Object()
                               throws BAD_OPERATION

提取 org.omg.CORBA.Object这个 Any对象 value场。

结果

org.omg.CORBA.Object存储在此 Any对象中

异常

BAD_OPERATION -如果此 Any对象包含比其他东西 org.omg.CORBA.Object或 value领域尚未设置

insert_Object

public abstract void insert_Object(Object o)

将给定的 org.omg.CORBA.Object对象插入到此 Any对象的 value字段中。

参数

o -在 org.omg.CORBA.Object对象插入此 Any对象

extract_Value

public abstract Serializable extract_Value()
                                    throws BAD_OPERATION

在 Any对象的 value字段中提取 java.io.Serializable对象。

结果

java.io.Serializable对象存储在此 Any对象中

异常

BAD_OPERATION -如果此 Any对象包含其他东西比 java.io.Serializable对象或 value领域尚未设置

insert_Value

public abstract void insert_Value(Serializable v)

将给定的 java.io.Serializable对象插入到此 Any对象的 value字段中。

参数

v -在 java.io.Serializable对象插入此 Any对象

insert_Value

public abstract void insert_Value(Serializable v,
                                  TypeCode t)
                           throws MARSHAL

将给定的 java.io.Serializable对象插入到此 Any对象的 value字段中。

参数

v -在 java.io.Serializable对象插入此 Any对象

t -所述 TypeCode对象，它是要插入到本 Any对象的 type字段和描述 java.io.Serializable被插入对象

异常

MARSHAL - 如果ORB编组或解组参数有问题

insert_Object

public abstract void insert_Object(Object o,
                                   TypeCode t)
                            throws BAD_PARAM

将给定的 org.omg.CORBA.Object对象插入到此 Any对象的 value字段中。

参数

o - 要插入 Any对象的 org.omg.CORBA.Object实例

t -所述 TypeCode对象，它是将被插入到这个 Any对象和描述该 Object被插入

异常

BAD_OPERATION - 如果此方法对此 Any对象无效

BAD_PARAM

extract_string

public abstract String extract_string()
                               throws BAD_OPERATION

在此 Any对象的 value字段中提取 String对象。

结果

String对象存储在此 Any对象中

异常

BAD_OPERATION -如果此 Any对象包含其他东西比 String对象或 value领域尚未设置

insert_string

public abstract void insert_string(String s)
                            throws DATA_CONVERSION,
                                   MARSHAL

将给定的 String对象插入到此 Any对象的 value字段中。

参数

s -在 String对象插入此 Any对象

异常

DATA_CONVERSION - 如果有数据转换错误

MARSHAL - 如果ORB编组或解组参数有问题

extract_wstring

public abstract String extract_wstring()
                                throws BAD_OPERATION

在此 Any对象的 value字段中提取 String对象。

结果

String对象存储在此 Any对象中

异常

BAD_OPERATION -如果此 Any对象包含其他东西比 String对象或 value领域尚未设置

insert_wstring

public abstract void insert_wstring(String s)
                             throws MARSHAL

将给定的 String对象插入到此 Any对象的 value字段中。

参数

s -在 String对象插入此 Any对象

异常

MARSHAL - 如果ORB编组或解组参数有问题

extract_TypeCode

public abstract TypeCode extract_TypeCode()
                                   throws BAD_OPERATION

在此 Any对象的 value字段中提取 TypeCode对象。

结果

TypeCode对象存储在此 Any对象中

异常

BAD_OPERATION -如果此 Any对象包含其他东西比 TypeCode对象或 value领域尚未设置

insert_TypeCode

public abstract void insert_TypeCode(TypeCode t)

将给定的 TypeCode对象插入到此 Any对象的 value字段中。

参数

t -在 TypeCode对象插入此 Any对象

extract_Principal

@Deprecated
public Principal extract_Principal()
                                        throws BAD_OPERATION

已弃用 被CORBA弃用2.2。

在此Any对象的value字段中提取Principal对象。 请注意， Principal已被弃用。

结果

Principal对象存储在此 Any对象中

异常

BAD_OPERATION -如果此 Any对象包含其他东西比 Principal对象或 value领域尚未设置

另请参见：

CORBA package comments for unimplemented features

insert_Principal

@Deprecated
public void insert_Principal(Principal p)

已弃用 被CORBA弃用2.2。

将给定的Principal对象插入到此Any对象的value字段中。 请注意， Principal类已被弃用。

参数

p -在 Principal对象插入此 Any对象

另请参见：

CORBA package comments for unimplemented features

extract_Streamable

public Streamable extract_Streamable()
                              throws BAD_INV_ORDER

提取Streamable从这个Any对象value场。 该方法允许提取非原始IDL类型。

结果

Streamable存储在 Any对象中。

异常

BAD_INV_ORDER - 如果调用者以错误的顺序调用操作

另请参见：

CORBA package comments for unimplemented features

insert_Streamable

public void insert_Streamable(Streamable s)

将给定的Streamable对象插入到这个Any对象的value字段中。 该方法允许插入非原始IDL类型。

参数

s - Streamable对象插入到这个Any对象中; 可能是非原始的IDL类型

另请参见：

CORBA package comments for unimplemented features

extract_fixed

public BigDecimal extract_fixed()

在此 Any对象的 value字段中提取 java.math.BigDecimal对象。

结果

java.math.BigDecimal对象存储在此 Any对象中

异常

BAD_OPERATION -如果此 Any对象包含其他东西比 java.math.BigDecimal对象或 value领域尚未设置

另请参见：

CORBA package comments for unimplemented features

insert_fixed

public void insert_fixed(BigDecimal value)

抛出org.omg.CORBA.NO_IMPLEMENT例外。

将给定的java.math.BigDecimal对象插入此Any对象的value字段。

参数

value - java.math.BigDecimal对象插入到这个 Any对象

另请参见：

CORBA package comments for unimplemented features

insert_fixed

public void insert_fixed(BigDecimal value,
                         TypeCode type)
                  throws BAD_INV_ORDER

抛出org.omg.CORBA.NO_IMPLEMENT异常。

将给定的java.math.BigDecimal对象插入到此Any对象的value字段中。

参数

value -在 java.math.BigDecimal对象插入此 Any对象

type -所述 TypeCode对象，它是要插入到本 Any对象的 type字段和描述 java.math.BigDecimal被插入对象

异常

BAD_INV_ORDER - 如果这种方法被调用不当

另请参见：

CORBA package comments for unimplemented features