站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

DynAny (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

JavaTM 2 Platform
Standard Ed. 5.0

org.omg.CORBA
接口 DynAny

所有超级接口:
Object
所有已知子接口:
DynArray, DynEnum, DynFixed, DynSequence, DynStruct, DynUnion, DynValue

已过时。 使用新的 DynAny 替代

@Deprecated
public interface DynAny
extends Object

支持动态解释(遍历)和构造 org.omg.CORBA.Any 值。DynAny 对象与一个数据值关联,该值对应于插入 Any 的值的副本。DynAny API 允许在运行时遍历与 Any 关联的数据值,并提取数据值的基本成分。


方法摘要
 void assign(DynAny dyn_any)
          已过时。 将内容从一个 Dynamic Any 复制到另一个 Dynamic Any 中。
 DynAny copy()
          已过时。 克隆此 DynAny 对象。
 DynAny current_component()
          已过时。 返回一个 DynAny 对象引用,可用来获取/设置当前所访问组件的值。
 void destroy()
          已过时。 销毁此 DynAny 对象,释放用来表示与之关联的数据值的所有资源。
 void from_any(Any value)
          已过时。 根据 Any 对象生成一个 DynAny 对象。
 Any get_any()
          已过时。 检索此 DynAny 对象中包含的 org.omg.CORBA.Any
 boolean get_boolean()
          已过时。 检索此 DynAny 对象中包含的 boolean 值。
 char get_char()
          已过时。 检索此 DynAny 对象中包含的 char 值。
 double get_double()
          已过时。 检索此 DynAny 对象中包含的 double 值。
 float get_float()
          已过时。 检索此 DynAny 对象中包含的 float 值。
 int get_long()
          已过时。 检索此 DynAny 对象中包含的 int 值。
 long get_longlong()
          已过时。 检索此 DynAny 对象中包含的 long 值。
 byte get_octet()
          已过时。 检索此 DynAny 对象中包含的 byte 值。
 Object get_reference()
          已过时。 检索此 DynAny 对象中包含的 org.omg.CORBA.Other
 short get_short()
          已过时。 检索此 DynAny 对象中包含的 short 值。
 String get_string()
          已过时。 检索此 DynAny 对象中包含的 String
 TypeCode get_typecode()
          已过时。 检索此 DynAny 对象中包含的 org.omg.CORBA.TypeCode
 int get_ulong()
          已过时。 检索此 DynAny 对象中包含的 int 值。
 long get_ulonglong()
          已过时。 检索此 DynAny 对象中包含的 long 值。
 short get_ushort()
          已过时。 检索此 DynAny 对象中包含的 short 值。
 Serializable get_val()
          已过时。 检索此 DynAny 对象中包含的 java.io.Serializable 对象。
 char get_wchar()
          已过时。 检索此 DynAny 对象中包含的 char 值。
 String get_wstring()
          已过时。 检索此 DynAny 对象中包含的 String
 void insert_any(Any value)
          已过时。 插入给定 org.omg.CORBA.Any 对象作为此 DynAny 对象的值。
 void insert_boolean(boolean value)
          已过时。 插入给定 boolean 值作为此 DynAny 对象的值。
 void insert_char(char value)
          已过时。 插入给定 char 值作为此 DynAny 对象的值。
 void insert_double(double value)
          已过时。 插入给定 double 值作为此 DynAny 对象的值。
 void insert_float(float value)
          已过时。 插入给定 float 值作为此 DynAny 对象的值。
 void insert_long(int value)
          已过时。 插入给定 int 值作为此 DynAny 对象的值。
 void insert_longlong(long value)
          已过时。 插入给定 long 值作为此 DynAny 对象的值。
 void insert_octet(byte value)
          已过时。 插入给定 byte 值作为此 DynAny 对象的值。
 void insert_reference(Object value)
          已过时。 插入给定 org.omg.CORBA.Object 作为此 DynAny 对象的值。
 void insert_short(short value)
          已过时。 插入给定 short 值作为此 DynAny 对象的值。
 void insert_string(String value)
          已过时。 插入给定 String 对象作为此 DynAny 对象的值。
 void insert_typecode(TypeCode value)
          已过时。 插入给定 org.omg.CORBA.TypeCode 值作为此 DynAny 对象的值。
 void insert_ulong(int value)
          已过时。 插入给定 int 值作为此 DynAny 对象的值。
 void insert_ulonglong(long value)
          已过时。 插入给定 long 值作为此 DynAny 对象的值。
 void insert_ushort(short value)
          已过时。 插入给定 short 值作为此 DynAny 对象的值。
 void insert_val(Serializable value)
          已过时。 插入给定 java.io.Serializable 对象作为此 DynAny 对象的值。
 void insert_wchar(char value)
          已过时。 插入给定 char 值作为此 DynAny 对象的值。
 void insert_wstring(String value)
          已过时。 插入给定 String 作为此 DynAny 对象的值。
 boolean next()
          已过时。 移动到此 DynAny 对象的下一个组件。
 void rewind()
          已过时。 将内部指针移动到第一个组件。
 boolean seek(int index)
          已过时。 将内部指针移动到给定索引。
 Any to_any()
          已过时。 将 DynAny 对象转换成 Any 对象。
 TypeCode type()
          已过时。 返回插入此 DynAny 对象的 TypeCode
 
从接口 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()
已过时。 
返回插入此 DynAny 对象的 TypeCode

返回:
TypeCode 对象。

assign

void assign(DynAny dyn_any)
            throws Invalid
已过时。 
将内容从一个 Dynamic Any 复制到另一个 Dynamic Any 中。

参数:
dyn_any - 内容被分配给此 DynAnyDynAny 对象。
抛出:
Invalid - 如果源 DynAny 无效

from_any

void from_any(Any value)
              throws Invalid
已过时。 
根据 Any 对象生成一个 DynAny 对象。

参数:
value - Any 对象。
抛出:
Invalid - 如果源 Any 对象为空或损坏

to_any

Any to_any()
           throws Invalid
已过时。 
DynAny 对象转换成 Any 对象。

返回:
Any 对象。
抛出:
Invalid - 如果此 DynAny 为空或损坏,或者创建的 DynAny 对象不包含任何有意义的值

destroy

void destroy()
已过时。 
销毁此 DynAny 对象,释放用来表示与之关联的数据值的所有资源。此方法还销毁从对象获取的所有 DynAny 对象。

销毁 DynAny 对象应小心处理,需要考虑如何处理与 DynAny 对象关联的数据值的表示形式。如果程序员要销毁 DynAny 对象,但还需要操作与其关联的数据值的某个组件,则应该首先为该组件创建一个 DynAny 对象,然后生成所创建的 DynAny 对象的副本。


copy

DynAny copy()
已过时。 
克隆此 DynAny 对象。

返回:
DynAny 对象的副本

insert_boolean

void insert_boolean(boolean value)
                    throws InvalidValue
已过时。 
插入给定 boolean 值作为此 DynAny 对象的值。

如果对已构造 DynAny 对象调用此方法,则该方法将初始化与此 DynAny 对象关联的已构造数据值的下一个组件。

参数:
value - 插入此 DynAny 对象的 boolean
抛出:
InvalidValue - 如果插入值与此 DynAny 对象中被访问组件的类型不一致

insert_octet

void insert_octet(byte value)
                  throws InvalidValue
已过时。 
插入给定 byte 值作为此 DynAny 对象的值。

如果对已构造 DynAny 对象调用此方法,则该方法将初始化与此 DynAny 对象关联的已构造数据值的下一个组件。

参数:
value - 插入此 DynAny 对象的 byte
抛出:
InvalidValue - 如果插入值与此 DynAny 对象中被访问组件的类型不一致

insert_char

void insert_char(char value)
                 throws InvalidValue
已过时。 
插入给定 char 值作为此 DynAny 对象的值。

如果对已构造 DynAny 对象调用此方法,则该方法将初始化与此 DynAny 对象关联的已构造数据值的下一个组件。

参数:
value - 插入此 DynAny 对象的 char
抛出:
InvalidValue - 如果插入值与此 DynAny 对象中被访问组件的类型不一致

insert_short

void insert_short(short value)
                  throws InvalidValue
已过时。 
插入给定 short 值作为此 DynAny 对象的值。

如果对已构造 DynAny 对象调用此方法,则该方法将初始化与此 DynAny 对象关联的已构造数据值的下一个组件。

参数:
value - 插入此 DynAny 对象的 short
抛出:
InvalidValue - 如果插入值与此 DynAny 对象中被访问组件的类型不一致

insert_ushort

void insert_ushort(short value)
                   throws InvalidValue
已过时。 
插入给定 short 值作为此 DynAny 对象的值。

如果对已构造 DynAny 对象调用此方法,则该方法将初始化与此 DynAny 对象关联的已构造数据值的下一个组件。

参数:
value - 插入此 DynAny 对象的 short
抛出:
InvalidValue - 如果插入值与此 DynAny 对象中被访问组件的类型不一致

insert_long

void insert_long(int value)
                 throws InvalidValue
已过时。 
插入给定 int 值作为此 DynAny 对象的值。

如果对已构造 DynAny 对象调用此方法,则该方法将初始化与此 DynAny 对象关联的已构造数据值的下一个组件。

参数:
value - 插入此 DynAny 对象的 int
抛出:
InvalidValue - 如果插入值与此 DynAny 对象中被访问组件的类型不一致

insert_ulong

void insert_ulong(int value)
                  throws InvalidValue
已过时。 
插入给定 int 值作为此 DynAny 对象的值。

如果对已构造 DynAny 对象调用此方法,则该方法将初始化与此 DynAny 对象关联的已构造数据值的下一个组件。

参数:
value - 插入此 DynAny 对象的 int
抛出:
InvalidValue - 如果插入值与此 DynAny 对象中被访问组件的类型不一致

insert_float

void insert_float(float value)
                  throws InvalidValue
已过时。 
插入给定 float 值作为此 DynAny 对象的值。

如果对已构造 DynAny 对象调用此方法,则该方法将初始化与此 DynAny 对象关联的已构造数据值的下一个组件。

参数:
value - 插入此 DynAny 对象的 float
抛出:
InvalidValue - 如果插入值与此 DynAny 对象中被访问组件的类型不一致

insert_double

void insert_double(double value)
                   throws InvalidValue
已过时。 
插入给定 double 值作为此 DynAny 对象的值。

如果对已构造 DynAny 对象调用此方法,则该方法将初始化与此 DynAny 对象关联的已构造数据值的下一个组件。

参数:
value - 插入此 DynAny 对象的 double
抛出:
InvalidValue - 如果插入值与此 DynAny 对象中被访问组件的类型不一致

insert_string

void insert_string(String value)
                   throws InvalidValue
已过时。 
插入给定 String 对象作为此 DynAny 对象的值。

如果对已构造 DynAny 对象调用此方法,则该方法将初始化与此 DynAny 对象关联的已构造数据值的下一个组件。

参数:
value - 插入此 DynAny 对象的 String
抛出:
InvalidValue - 如果插入值与此 DynAny 对象中被访问组件的类型不一致

insert_reference

void insert_reference(Object value)
                      throws InvalidValue
已过时。 
插入给定 org.omg.CORBA.Object 作为此 DynAny 对象的值。

如果对已构造 DynAny 对象调用此方法,则该方法将初始化与此 DynAny 对象关联的已构造数据值的下一个组件。

参数:
value - 插入此 DynAny 对象的 org.omg.CORBA.Object
抛出:
InvalidValue - 如果插入值与此 DynAny 对象中被访问组件的类型不一致

insert_typecode

void insert_typecode(TypeCode value)
                     throws InvalidValue
已过时。 
插入给定 org.omg.CORBA.TypeCode 值作为此 DynAny 对象的值。

如果对已构造 DynAny 对象调用此方法,则该方法将初始化与此 DynAny 对象关联的已构造数据值的下一个组件。

参数:
value - 插入此 DynAny 对象的 org.omg.CORBA.TypeCode
抛出:
InvalidValue - 如果插入值与此 DynAny 对象中被访问组件的类型不一致

insert_longlong

void insert_longlong(long value)
                     throws InvalidValue
已过时。 
插入给定 long 值作为此 DynAny 对象的值。

如果对已构造 DynAny 对象调用此方法,则该方法将初始化与此 DynAny 对象关联的已构造数据值的下一个组件。

参数:
value - 插入此 DynAny 对象的 long
抛出:
InvalidValue - 如果插入值与此 DynAny 对象中被访问组件的类型不一致

insert_ulonglong

void insert_ulonglong(long value)
                      throws InvalidValue
已过时。 
插入给定 long 值作为此 DynAny 对象的值。

如果对已构造 DynAny 对象调用此方法,则该方法将初始化与此 DynAny 对象关联的已构造数据值的下一个组件。

参数:
value - 插入此 DynAny 对象的 long
抛出:
InvalidValue - 如果插入值与此 DynAny 对象中被访问组件的类型不一致

insert_wchar

void insert_wchar(char value)
                  throws InvalidValue
已过时。 
插入给定 char 值作为此 DynAny 对象的值。

如果对已构造 DynAny 对象调用此方法,则该方法将初始化与此 DynAny 对象关联的已构造数据值的下一个组件。

参数:
value - 插入此 DynAny 对象的 char
抛出:
InvalidValue - 如果插入值与此 DynAny 对象中被访问组件的类型不一致

insert_wstring

void insert_wstring(String value)
                    throws InvalidValue
已过时。 
插入给定 String 作为此 DynAny 对象的值。

如果对已构造 DynAny 对象调用此方法,则该方法将初始化与此 DynAny 对象关联的已构造数据值的下一个组件。

参数:
value - 插入此 DynAny 对象的 String
抛出:
InvalidValue - 如果插入值与此 DynAny 对象中被访问组件的类型不一致

insert_any

void insert_any(Any value)
                throws InvalidValue
已过时。 
插入给定 org.omg.CORBA.Any 对象作为此 DynAny 对象的值。

如果对已构造 DynAny 对象调用此方法,则该方法将初始化与此 DynAny 对象关联的已构造数据值的下一个组件。

参数:
value - 插入此 DynAny 对象中的 org.omg.CORBA.Any 对象
抛出:
InvalidValue - 如果插入值与此 DynAny 对象中被访问组件的类型不一致

insert_val

void insert_val(Serializable value)
                throws InvalidValue
已过时。 
插入给定 java.io.Serializable 对象作为此 DynAny 对象的值。

如果对已构造 DynAny 对象调用此方法,则该方法将初始化与此 DynAny 对象关联的已构造数据值的下一个组件。

参数:
value - 插入此 DynAny 对象中的 java.io.Serializable 对象
抛出:
InvalidValue - 如果插入值与此 DynAny 对象中被访问组件的类型不一致

get_val

Serializable get_val()
                     throws TypeMismatch
已过时。 
检索此 DynAny 对象中包含的 java.io.Serializable 对象。

返回:
作为此 DynAny 对象的值的 java.io.Serializable 对象
抛出:
TypeMismatch - 如果此 DynAny 对象中被访问组件的类型代码与 java.io.Serializable 对象的类型代码不同

get_boolean

boolean get_boolean()
                    throws TypeMismatch
已过时。 
检索此 DynAny 对象中包含的 boolean 值。

返回:
作为此 DynAny 对象的值的 boolean
抛出:
TypeMismatch - 如果此 DynAny 对象中被访问组件的类型代码与该 boolean 值的类型代码不同

get_octet

byte get_octet()
               throws TypeMismatch
已过时。 
检索此 DynAny 对象中包含的 byte 值。

返回:
作为此 DynAny 对象的值的 byte
抛出:
TypeMismatch - 如果此 DynAny 对象中被访问组件的类型代码与该 byte 值的类型代码不同

get_char

char get_char()
              throws TypeMismatch
已过时。 
检索此 DynAny 对象中包含的 char 值。

返回:
作为此 DynAny 对象的值的 char
抛出:
TypeMismatch - 如果此 DynAny 对象中被访问组件的类型代码与该 char 值的类型代码不同

get_short

short get_short()
                throws TypeMismatch
已过时。 
检索此 DynAny 对象中包含的 short 值。

返回:
作为此 DynAny 对象的值的 short
抛出:
TypeMismatch - 如果此 DynAny 对象中被访问组件的类型代码与该 short 值的类型代码不同

get_ushort

short get_ushort()
                 throws TypeMismatch
已过时。 
检索此 DynAny 对象中包含的 short 值。

返回:
作为此 DynAny 对象的值的 short
抛出:
TypeMismatch - 如果此 DynAny 对象中被访问组件的类型代码与该 short 值的类型代码不同

get_long

int get_long()
             throws TypeMismatch
已过时。 
检索此 DynAny 对象中包含的 int 值。

返回:
作为此 DynAny 对象的值的 int
抛出:
TypeMismatch - 如果此 DynAny 对象中被访问组件的类型代码与该 int 值的类型代码不同

get_ulong

int get_ulong()
              throws TypeMismatch
已过时。 
检索此 DynAny 对象中包含的 int 值。

返回:
作为此 DynAny 对象的值的 int
抛出:
TypeMismatch - 如果此 DynAny 对象中被访问组件的类型代码与该 int 值的类型代码不同

get_float

float get_float()
                throws TypeMismatch
已过时。 
检索此 DynAny 对象中包含的 float 值。

返回:
作为此 DynAny 对象的值的 float
抛出:
TypeMismatch - 如果此 DynAny 对象中被访问组件的类型代码与该 float 值的类型代码不同

get_double

double get_double()
                  throws TypeMismatch
已过时。 
检索此 DynAny 对象中包含的 double 值。

返回:
作为此 DynAny 对象的值的 double
抛出:
TypeMismatch - 如果此 DynAny 对象中被访问组件的类型代码与该 double 值的类型代码不同

get_string

String get_string()
                  throws TypeMismatch
已过时。 
检索此 DynAny 对象中包含的 String

返回:
作为此 DynAny 对象的值的 String
抛出:
TypeMismatch - 如果此 DynAny 对象中被访问组件的类型代码与该 String 的类型代码不同

get_reference

Object get_reference()
                     throws TypeMismatch
已过时。 
检索此 DynAny 对象中包含的 org.omg.CORBA.Other

返回:
作为此 DynAny 对象的值的 org.omg.CORBA.Other
抛出:
TypeMismatch - 如果此 DynAny 对象中被访问组件的类型代码与该 org.omg.CORBA.Other 的类型代码不同

get_typecode

TypeCode get_typecode()
                      throws TypeMismatch
已过时。 
检索此 DynAny 对象中包含的 org.omg.CORBA.TypeCode

返回:
作为此 DynAny 对象的值的 org.omg.CORBA.TypeCode
抛出:
TypeMismatch - 如果此 DynAny 对象中被访问组件的类型代码与该 org.omg.CORBA.TypeCode 的类型代码不同

get_longlong

long get_longlong()
                  throws TypeMismatch
已过时。 
检索此 DynAny 对象中包含的 long 值。

返回:
作为此 DynAny 对象的值的 long
抛出:
TypeMismatch - 如果此 DynAny 对象中被访问组件的类型代码与该 long 值的类型代码不同

get_ulonglong

long get_ulonglong()
                   throws TypeMismatch
已过时。 
检索此 DynAny 对象中包含的 long 值。

返回:
作为此 DynAny 对象的值的 long
抛出:
TypeMismatch - 如果此 DynAny 对象中被访问组件的类型代码与该 long 值的类型代码不同

get_wchar

char get_wchar()
               throws TypeMismatch
已过时。 
检索此 DynAny 对象中包含的 char 值。

返回:
作为此 DynAny 对象的值的 char
抛出:
TypeMismatch - 如果此 DynAny 对象中被访问组件的类型代码与该 char 值的类型代码不同

get_wstring

String get_wstring()
                   throws TypeMismatch
已过时。 
检索此 DynAny 对象中包含的 String

返回:
作为此 DynAny 对象的值的 String
抛出:
TypeMismatch - 如果此 DynAny 对象中被访问组件的类型代码与该 String 的类型代码不同

get_any

Any get_any()
            throws TypeMismatch
已过时。 
检索此 DynAny 对象中包含的 org.omg.CORBA.Any

返回:
作为此 DynAny 对象的值的 org.omg.CORBA.Any
抛出:
TypeMismatch - 如果此 DynAny 对象中被访问组件的类型代码与该 org.omg.CORBA.Any 的类型代码不同

current_component

DynAny current_component()
已过时。 
返回一个 DynAny 对象引用,可用来获取/设置当前所访问组件的值。可在得到的 DynAny 对象上调用适当的 insert 方法来初始化该组件。可在得到的 DynAny 对象上调用适当的 get 方法来提取该组件的值。

返回:
DynAny 对象引用,可用来检索或设置当前所访问组件的值

next

boolean next()
已过时。 
移动到此 DynAny 对象的下一个组件。此方法用于在所构造类型的组件上进行迭代,有效地将指针从一个组件移动到下一个组件。在创建 DynAny 对象时,指针从第一个组件开始移动。

返回:
如果指针指向某一组件,则返回 true;如果不再有组件或者此 DynAny 与基本类型相关而不是与所构造类型相关,则返回 false

seek

boolean seek(int index)
已过时。 
将内部指针移动到给定索引。从逻辑上说,此方法为该指针设置了一个新偏移量。

参数:
index - 指示作为指针移动目标位置的 int 值。第一个位置为 0。
返回:
如果指针指向某一组件,则返回 true;如果在指定索引处没有组件,则返回 false。如果此 DynAny 对象与基本类型关联,则此方法对 0 以外的任何索引都返回 false

rewind

void rewind()
已过时。 
将内部指针移动到第一个组件。


JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策