当前页面: 在线文档首页 > JavaTM 2 Platform Standard Edition 6.0 API 规范中文版
org.omg.DynamicAny
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
DynAnyOperations (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
org.omg.DynamicAny
接口 DynAnyOperations
- 所有已知子接口：
- DynAny, DynArray, DynArrayOperations, DynEnum, DynEnumOperations, DynFixed, DynFixedOperations, DynSequence, DynSequenceOperations, DynStruct, DynStructOperations, DynUnion, DynUnionOperations, DynValue, DynValueBox, DynValueBoxOperations, DynValueCommon, DynValueCommonOperations, DynValueOperations
- 所有已知实现类：
- _DynAnyStub, _DynArrayStub, _DynEnumStub, _DynFixedStub, _DynSequenceStub, _DynStructStub, _DynUnionStub, _DynValueStub
public interface DynAnyOperations
通过 DynAny 对象可以动态解释（遍历）和构造 Any 值。DynAny 对象与对应于插入 any 的值的副本的数据值相关联。
DynAny 对象可视为一个有序的 DynAny 组件集合。对于表示基本类型（如 long）或没有组件的类型（如空异常）的 DynAny，有序的组件集合为空。每个 DynAny 对象在其组件 DynAny 集合中都有一个当前位置。当前位置由 0 到 n-1 的索引值标识，其中 n 为组件数。特殊索引值 -1 指示不指向任何位置的当前位置。对于不能有当前位置的值（如空异常），索引值始终为 -1。如果使用具有组件的值初始化 DynAny，则索引被初始化为 0。在创建未初始化的 DynAny（即不具有值但具有允许组件的 TypeCode 的 DynAny）之后，当前位置取决于由 DynAny 表示的值的类型。（将当前位置设置为 0 还是 -1 取决于新 DynAny 是否获取了其组件的默认值。）
迭代操作 rewind、seek 和 next 可用于更改当前位置，current_component 操作返回当前位置的组件。component_count 操作返回 DynAny 的组件数。总体上说，这些操作都能在 DynAny 的组件上进行迭代，从而能够（例如）检查其内容（递归式）。
已构造的 DynAny 对象是与构造类型关联的 DynAny 对象。还有一种从 DynAny 接口继承而来的接口，它与 IDL 中的每种构造类型（fixed、enum、struct、sequence、union、array、exception 和 value 类型）相关联。
已构造的 DynAny 对象导出支持创建新 DynAny 对象的操作，每个对象都与已构造数据值的组件相关联。例如，DynStruct 与 struct 值关联。这意味着 DynStruct 可视为拥有一个有序的组件集合，每个结构成员一个。DynStruct 对象导出支持创建新 DynAny 对象的操作，其中每个对象都与 struct 的成员关联。
如果 DynAny 对象是从另一个（已构造）DynAny 对象获取的（如表示从 DynStruct 创建的结构成员的 DynAny），则成员 DynAny 在逻辑上包含在 DynStruct 中。调用 insert 或 get 操作不更改当前位置。销毁顶级 DynAny 对象（不是作为另一个 DynAny 的组件获取的）将同时销毁从其获取的所有 DynAny 对象组件。销毁非顶级 DynAny 对象的操作没有任何效果。在已销毁的顶级 DynAny 或其任何子代上调用操作将引发 OBJECT_NOT_EXIST。如果程序员要销毁 DynAny 对象，但还需要操作与其关联的数据值的某个组件，则应该首先为该组件创建一个 DynAny，然后生成所创建的 DynAny 对象的副本。
为了支持高效实现，根据分配的内存空间和存取速度定义 DynAny 对象的行为。DynAny 对象旨在用于遍历从 any 析取的值，或用于在运行时构造 any 的值。不建议将其用于其他目的。
Insert 和 get 操作是处理基本 DynAny 对象所必需的，但是也可以使用它们来处理已构造的 DynAny 对象。将基本数据类型值插入已构造的 DynAny 对象意味着初始化与 DynAny 对象关联的已构造数据值的当前组件。例如，对 DynStruct 调用 insert_boolean 意味着在关联的 struct 数据值的当前位置插入 boolean 数据值。如果某个类型的 TypeCode 等效于 DynAny 中包含的 TypeCode，或者等效于处于当前位置的 DynAny 的 TypeCode（如果 DynAny 具有组件），则该类型与插入值或析取值一致。
DynAny 和 DynAnyFactory 对象对于创建和使用它们的进程而言是本地的。这意味着不能将对 DynAny 和 DynAnyFactory 对象的引用导出到其他进程，也不能通过 ORB.object_to_string() 使其具体化。如果进行这样的尝试，则该违反规则的操作将引发 MARSHAL 系统异常。由于它们的接口是在 IDL 中指定的，所以 DynAny 对象导出在标准 org.omg.CORBA.Object 接口中定义的操作。但是，任何尝试调用通过 Object 接口导出的操作都会引发标准 NO_IMPLEMENT 异常。尝试使用带有 DII 的 DynAny 对象将引发 NO_IMPLEMENT 异常。
| 方法摘要 | |
|---|---|
void |
assign(DynAny dyn_any)
使用与另一个 DynAny 对象有关联的值初始化与 DynAny 对象有关联的值。 |
int |
component_count()
返回 DynAny 的组件数。 |
DynAny |
copy()
创建一个新 DynAny 对象，其值为调用此方法的 DynAny 的深层复制。 |
DynAny |
current_component()
返回当前位置上的组件的 DynAny。 |
void |
destroy()
销毁 DynAny 对象。 |
boolean |
equal(DynAny dyn_any)
比较两个 DynAny 值是否相等。 |
void |
from_any(Any value)
使用 any 中包含的值初始化与 DynAny 对象有关联的值。 |
Any |
get_any()
提取由此 DynAny 表示的 Any 中所包含的 Any 值。 |
boolean |
get_boolean()
从此 DynAny 中提取 boolean 值。 |
char |
get_char()
从此 DynAny 中提取 char 值。 |
double |
get_double()
从此 DynAny 中提取 double 值。 |
DynAny |
get_dyn_any()
提取由此 DynAny 表示的 Any 中所包含的 Any 值，并将其包装在新 DynAny 中返回。 |
float |
get_float()
从此 DynAny 中提取 float 值。 |
int |
get_long()
从此 DynAny 中提取 integer 值。 |
long |
get_longlong()
从此 DynAny 中提取 long 值。 |
byte |
get_octet()
从此 DynAny 中提取 byte 值。 |
Object |
get_reference()
从此 DynAny 中提取对 CORBA 对象的引用。 |
short |
get_short()
从此 DynAny 中提取 short 值。 |
String |
get_string()
从此 DynAny 中提取 string 值。 |
TypeCode |
get_typecode()
从此 DynAny 中提取 TypeCode 对象。 |
int |
get_ulong()
从此 DynAny 中提取 integer 值。 |
long |
get_ulonglong()
从此 DynAny 中提取 long 值。 |
short |
get_ushort()
从此 DynAny 中提取 short 值。 |
Serializable |
get_val()
从此 DynAny 中提取 Serializable 对象。 |
char |
get_wchar()
从此 DynAny 中提取 long 值。 |
String |
get_wstring()
从此 DynAny 中提取 string 值。 |
void |
insert_any(Any value)
将 Any 值插入此 DynAny 表示的 Any 中。 |
void |
insert_boolean(boolean value)
将 boolean 值插入 DynAny 中。 |
void |
insert_char(char value)
将 char 值插入 DynAny 中。 |
void |
insert_double(double value)
将 double 值插入 DynAny 中。 |
void |
insert_dyn_any(DynAny value)
将参数 DynAny 中包含的 Any 值插入此 DynAny 表示的 Any 中。 |
void |
insert_float(float value)
将 float 值插入 DynAny 中。 |
void |
insert_long(int value)
将 integer 值插入 DynAny 中。 |
void |
insert_longlong(long value)
将 long 值插入 DynAny 中。 |
void |
insert_octet(byte value)
将 byte 值插入 DynAny 中。 |
void |
insert_reference(Object value)
将对 CORBA 对象的引用插入到 DynAny 中。 |
void |
insert_short(short value)
将 short 值插入 DynAny 中。 |
void |
insert_string(String value)
将 string 值插入 DynAny 中。 |
void |
insert_typecode(TypeCode value)
将 TypeCode 对象插入 DynAny 中。 |
void |
insert_ulong(int value)
将 integer 值插入 DynAny 中。 |
void |
insert_ulonglong(long value)
将 long 值插入 DynAny 中。 |
void |
insert_ushort(short value)
将 short 值插入 DynAny 中。 |
void |
insert_val(Serializable value)
将对 Serializable 对象的引用插入此 DynAny 中。 |
void |
insert_wchar(char value)
将 char 值插入 DynAny 中。 |
void |
insert_wstring(String value)
将 string 值插入 DynAny 中。 |
boolean |
next()
将当前位置推进到下一个组件。 |
void |
rewind()
等效于 seek(0)。 |
boolean |
seek(int index)
将当前位置设置为索引。 |
Any |
to_any()
从 DynAny 对象创建 any 值。 |
TypeCode |
type()
返回与此 DynAny 对象有关联的 TypeCode。 |
| 方法详细信息 |
|---|
type
TypeCode type()
- 返回与此 DynAny 对象有关联的 TypeCode。DynAny 对象是通过分配给它的 TypeCode 值创建的。此 TypeCode 值确定通过 DynAny 对象处理的值的类型。注意，与 DynAny 对象关联的 TypeCode 在创建 DynAny 时初始化，在 DynAny 对象的生存期间不能更改。
- 返回：
- 与 DynAny 对象关联的 TypeCode
assign
void assign(DynAny dyn_any) throws TypeMismatch
- 使用与另一个 DynAny 对象有关联的值初始化与 DynAny 对象有关联的值。对具有组件的值，将目标 DynAny 的当前位置设置为 0，对不具有组件的值，将该位置设置为 -1。
- 参数：
dyn_any-- 抛出：
TypeMismatch- 如果传递的 DynAny 的类型不等于目标 DynAny 的类型
from_any
void from_any(Any value) throws TypeMismatch, InvalidValue
- 使用 any 中包含的值初始化与 DynAny 对象有关联的值。对具有组件的值，将目标 DynAny 的当前位置设置为 0，对不具有组件的值，将该位置设置为 -1。
- 抛出：
TypeMismatch- 如果所传递 Any 的类型不等于目标 DynAny 的类型InvalidValue- 如果所传递的 Any 不包含合法值（如 null 字符串）
to_any
Any to_any()
- 从 DynAny 对象创建 any 值。将与 DynAny 对象关联的 TypeCode 的副本分配给所得 any。将与 DynAny 对象关联的值复制到 any 中。
- 返回：
- 具有相同值和 TypeCode 的新 Any 对象
equal
boolean equal(DynAny dyn_any)
- 比较两个 DynAny 值是否相等。如果两个 DynAny 值的 TypeCode 相等，则它们的值相等；以此类推，所有组件 DynAny 都具有相等的值。将比较的两个 DynAny 的当前位置不影响比较结果。
- 返回：
- 如果 DynAny 相等，则返回 true；否则返回 false
destroy
void destroy()
- 销毁 DynAny 对象。此操作释放所有用来表示与 DynAny 对象关联的数据值的资源。为了避免资源泄漏，此操作必须在从 ORB 接口的创建操作之一获取的引用或者 DynAny.copy() 返回的引用上调用。在组件 DynAny 对象（例如，current_component 操作返回的对象）上调用 destroy 没有任何效果。销毁 DynAny 对象意味着销毁从其获取的所有 DynAny 对象。即对已销毁 DynAny 组件的引用将变得无效。调用这种引用将引发 OBJECT_NOT_EXIST。如果在销毁可从中获取组件的 DynAny 前使用 copy 操作生成了组件的复本，则可以在该 DynAny 的生存期后操作其组件。
copy
DynAny copy()
- 创建一个新 DynAny 对象，其值为调用此方法的 DynAny 的深层复制。该操作是多态的，即对派生自 DynAny 的类型之一（如 DynStruct）调用该操作时，将创建派生的类型，但以 DynAny 基本类型的形式返回其引用。
- 返回：
- DynAny 对象的深层复制
insert_boolean
void insert_boolean(boolean value)
throws TypeMismatch,
InvalidValue
- 将 boolean 值插入 DynAny 中。
- 抛出：
InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法
insert_octet
void insert_octet(byte value)
throws TypeMismatch,
InvalidValue
- 将 byte 值插入 DynAny 中。将 IDL octet 数据类型映射为 Java byte 数据类型。
- 抛出：
InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法
insert_char
void insert_char(char value)
throws TypeMismatch,
InvalidValue
- 将 char 值插入 DynAny 中。
- 抛出：
InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法
insert_short
void insert_short(short value)
throws TypeMismatch,
InvalidValue
- 将 short 值插入 DynAny 中。
- 抛出：
InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法
insert_ushort
void insert_ushort(short value)
throws TypeMismatch,
InvalidValue
- 将 short 值插入 DynAny 中。将 IDL ushort 数据类型映射为 Java short 数据类型。
- 抛出：
InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法
insert_long
void insert_long(int value)
throws TypeMismatch,
InvalidValue
- 将 integer 值插入 DynAny 中。将 IDL long 数据类型映射为 Java int 数据类型。
- 抛出：
InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法
insert_ulong
void insert_ulong(int value)
throws TypeMismatch,
InvalidValue
- 将 integer 值插入 DynAny 中。将 IDL ulong 数据类型映射为 Java int 数据类型。
- 抛出：
InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法
insert_float
void insert_float(float value)
throws TypeMismatch,
InvalidValue
- 将 float 值插入 DynAny 中。
- 抛出：
InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法
insert_double
void insert_double(double value)
throws TypeMismatch,
InvalidValue
- 将 double 值插入 DynAny 中。
- 抛出：
InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法
insert_string
void insert_string(String value) throws TypeMismatch, InvalidValue
- 将 string 值插入 DynAny 中。有界的和无界的字符串都使用此方法插入。
- 抛出：
InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1InvalidValue- 如果插入的字符串的长度超出有界字符串的界限TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法
insert_reference
void insert_reference(Object value) throws TypeMismatch, InvalidValue
- 将对 CORBA 对象的引用插入到 DynAny 中。
- 抛出：
InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法
insert_typecode
void insert_typecode(TypeCode value) throws TypeMismatch, InvalidValue
- 将 TypeCode 对象插入 DynAny 中。
- 抛出：
InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法
insert_longlong
void insert_longlong(long value)
throws TypeMismatch,
InvalidValue
- 将 long 值插入 DynAny 中。将 IDL long 数据类型映射为 Java long 数据类型。
- 抛出：
InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法
insert_ulonglong
void insert_ulonglong(long value)
throws TypeMismatch,
InvalidValue
- 将 long 值插入 DynAny 中。将 IDL 无符号 long 数据类型映射为 Java long 数据类型。
- 抛出：
InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法
insert_wchar
void insert_wchar(char value)
throws TypeMismatch,
InvalidValue
- 将 char 值插入 DynAny 中。将 IDL wchar 数据类型映射为 Java char 数据类型。
- 抛出：
InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法
insert_wstring
void insert_wstring(String value) throws TypeMismatch, InvalidValue
- 将 string 值插入 DynAny 中。有界的和无界的字符串都使用此方法插入。
- 抛出：
InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1InvalidValue- 如果插入的字符串的长度超出有界字符串的界限TypeMismatch
insert_any
void insert_any(Any value) throws TypeMismatch, InvalidValue
- 将 Any 值插入此 DynAny 表示的 Any 中。
- 抛出：
InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法
insert_dyn_any
void insert_dyn_any(DynAny value) throws TypeMismatch, InvalidValue
- 将参数 DynAny 中包含的 Any 值插入此 DynAny 表示的 Any 中。
- 抛出：
InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法
insert_val
void insert_val(Serializable value) throws TypeMismatch, InvalidValue
- 将对 Serializable 对象的引用插入此 DynAny 中。将 IDL ValueBase 类型映射为 Java Serializable 类型。
- 抛出：
InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法
get_boolean
boolean get_boolean()
throws TypeMismatch,
InvalidValue
- 从此 DynAny 中提取 boolean 值。
- 抛出：
TypeMismatch- 如果在 DynAny 中访问的组件类型不等于所请求的类型。TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1
get_octet
byte get_octet()
throws TypeMismatch,
InvalidValue
- 从此 DynAny 中提取 byte 值。将 IDL octet 数据类型映射为 Java byte 数据类型。
- 抛出：
TypeMismatch- 如果在 DynAny 中访问的组件类型不等于所请求的类型。TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1
get_char
char get_char()
throws TypeMismatch,
InvalidValue
- 从此 DynAny 中提取 char 值。
- 抛出：
TypeMismatch- 如果在 DynAny 中访问的组件类型不等于所请求的类型。TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1
get_short
short get_short()
throws TypeMismatch,
InvalidValue
- 从此 DynAny 中提取 short 值。
- 抛出：
TypeMismatch- 如果在 DynAny 中访问的组件类型不等于所请求的类型。TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1
get_ushort
short get_ushort()
throws TypeMismatch,
InvalidValue
- 从此 DynAny 中提取 short 值。将 IDL ushort 数据类型映射为 Java short 数据类型。
- 抛出：
TypeMismatch- 如果在 DynAny 中访问的组件类型不等于所请求的类型。TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1
get_long
int get_long()
throws TypeMismatch,
InvalidValue
- 从此 DynAny 中提取 integer 值。将 IDL long 数据类型映射为 Java int 数据类型。
- 抛出：
TypeMismatch- 如果在 DynAny 中访问的组件类型不等于所请求的类型。TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1
get_ulong
int get_ulong()
throws TypeMismatch,
InvalidValue
- 从此 DynAny 中提取 integer 值。将 IDL ulong 数据类型映射为 Java int 数据类型。
- 抛出：
TypeMismatch- 如果在 DynAny 中访问的组件类型不等于所请求的类型。TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1
get_float
float get_float()
throws TypeMismatch,
InvalidValue
- 从此 DynAny 中提取 float 值。
- 抛出：
TypeMismatch- 如果在 DynAny 中访问的组件类型不等于所请求的类型。TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1
get_double
double get_double()
throws TypeMismatch,
InvalidValue
- 从此 DynAny 中提取 double 值。
- 抛出：
TypeMismatch- 如果在 DynAny 中访问的组件类型不等于所请求的类型。TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1
get_string
String get_string() throws TypeMismatch, InvalidValue
- 从此 DynAny 中提取 string 值。有界的和无界的字符串都使用此方法析取。
- 抛出：
TypeMismatch- 如果在 DynAny 中访问的组件类型不等于所请求的类型。TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1
get_reference
Object get_reference() throws TypeMismatch, InvalidValue
- 从此 DynAny 中提取对 CORBA 对象的引用。
- 抛出：
TypeMismatch- 如果在 DynAny 中访问的组件类型不等于所请求的类型。TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1
get_typecode
TypeCode get_typecode() throws TypeMismatch, InvalidValue
- 从此 DynAny 中提取 TypeCode 对象。
- 抛出：
TypeMismatch- 如果在 DynAny 中访问的组件类型不等于所请求的类型。TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1
get_longlong
long get_longlong()
throws TypeMismatch,
InvalidValue
- 从此 DynAny 中提取 long 值。将 IDL long 数据类型映射为 Java long 数据类型。
- 抛出：
TypeMismatch- 如果在 DynAny 中访问的组件类型不等于所请求的类型。TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1
get_ulonglong
long get_ulonglong()
throws TypeMismatch,
InvalidValue
- 从此 DynAny 中提取 long 值。将 IDL 无符号 long 数据类型映射为 Java long 数据类型。
- 抛出：
TypeMismatch- 如果在 DynAny 中访问的组件类型不等于所请求的类型。TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1
get_wchar
char get_wchar()
throws TypeMismatch,
InvalidValue
- 从此 DynAny 中提取 long 值。将 IDL wchar 数据类型映射为 Java char 数据类型。
- 抛出：
TypeMismatch- 如果在 DynAny 中访问的组件类型不等于所请求的类型。TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1
get_wstring
String get_wstring() throws TypeMismatch, InvalidValue
- 从此 DynAny 中提取 string 值。有界的和无界的字符串都使用此方法析取。
- 抛出：
TypeMismatch- 如果在 DynAny 中访问的组件类型不等于所请求的类型。TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法InvalidValue
get_any
Any get_any() throws TypeMismatch, InvalidValue
- 提取由此 DynAny 表示的 Any 中所包含的 Any 值。
- 抛出：
TypeMismatch- 如果在 DynAny 中访问的组件类型不等于所请求的类型。TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1
get_dyn_any
DynAny get_dyn_any() throws TypeMismatch, InvalidValue
- 提取由此 DynAny 表示的 Any 中所包含的 Any 值，并将其包装在新 DynAny 中返回。
- 抛出：
TypeMismatch- 如果在 DynAny 中访问的组件类型不等于所请求的类型。TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1
get_val
Serializable get_val() throws TypeMismatch, InvalidValue
- 从此 DynAny 中提取 Serializable 对象。将 IDL ValueBase 类型映射为 Java Serializable 类型。
- 抛出：
TypeMismatch- 如果在 DynAny 中访问的组件类型不等于所请求的类型。TypeMismatch- 如果在其当前组件本身也有组件的 DynAny 上调用此方法InvalidValue- 如果此 DynAny 具有组件，但当前位置为 -1
seek
boolean seek(int index)
- 将当前位置设置为索引。当前位置为索引 0 到 n-1，即索引 0 对应于第一个组件。如果所得当前位置指示 DynAny 的组件，则操作返回 true；如果索引指示的位置不与组件对应，则返回 false。使用负索引调用 seek 是合法的。它将当前位置设置为 -1，指示不存在组件，并返回 false。如果传递相应位置上没有组件的 DynAny 的非负索引值，则会将当前位置设置为 -1 并返回 false。
rewind
void rewind()
- 等效于 seek(0)。
next
boolean next()
- 将当前位置推进到下一个组件。如果所得当前位置指示一个组件，则该操作返回 true；否则返回 false。返回值为 false 时当前位置仍为 -1。如果在没有组件的 DynAny 上调用 next，则当前位置仍为 -1 并返回 false。
component_count
int component_count()
- 返回 DynAny 的组件数。对于没有组件的 DynAny，它返回 0。该操作仅计算位于顶层的组件。例如，如果在具有单个成员的 DynStruct 上调用 component_count，则返回值为 1，与成员的类型无关。
- 对于序列 (sequence)，该操作返回当前的元素数。
- 对于结构 (structure)、异常 (exception) 和值 (value) 类型，该操作返回成员数。
- 对于数组 (array)，该操作返回元素数。
- 对于联合数据 (union)，如果鉴别符指示指定的成员为活动状态，则返回 2；否则，它返回 1。
- 对于 DynFixed 和 DynEnum，该操作返回 0。
current_component
DynAny current_component() throws TypeMismatch
- 返回当前位置上的组件的 DynAny。它不推进当前位置，所以反复调用 current_component 且不插入对 rewind、next 或 seek 的调用将返回相同的组件。返回的 DynAny 对象引用可用于获取/设置当前组件的值。如果当前组件表示复合类型，则可基于 TypeCode 缩小返回引用的范围以获取对应于复合类型的接口。在不能有组件的 DynAny（如 DynEnum 或空异常）上调用 current_component 将引发 TypeMismatch。在其当前位置为 -1 的 DynAny 上调用 current_component 将返回 nil 引用。迭代操作和 current_component 都可用于动态组成 any 值。创建动态 any（如 DynStruct）后，current_component 和 next 可用于初始化值的所有组件。一旦完成初始化动态值，to_any 将创建相应的 any 值。
- 抛出：
TypeMismatch- 如果在不能有组件的 DynAny（如 DynEnum 或空异常）上调用此方法
|
JavaTM Platform Standard Ed. 6 |
|||||||||
| 上一个类 下一个类 | 框架 无框架 | |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | |||||||||
提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。
版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。