org.omg.DynamicAny
类 _DynSequenceStub

java.lang.Object
  org.omg.CORBA.portable.ObjectImpl
      org.omg.DynamicAny._DynSequenceStub

所有已实现的接口：

Serializable, Object, IDLEntity, DynAny, DynAnyOperations, DynSequence, DynSequenceOperations

public class _DynSequenceStub
     

      extends 
      ObjectImpl
     
     

      implements 
      DynSequence
     

DynSequence 对象支持对 IDL 序列 (sequence) 的操作。

_opsClass

public static final Class _opsClass

_DynSequenceStub

public _DynSequenceStub()

get_length

public int get_length()

返回当前序列的长度。

指定者：

接口 DynSequenceOperations 中的 get_length

set_length

public void set_length(int len)
                throws InvalidValue

设置序列的长度。增加序列的长度将在尾部添加新元素，同时不影响现有元素的值。新添加的元素按默认方式初始化。如果上一个当前位置是 -1，则增加序列的长度会将当前位置设置为第一个新添加的元素。如果上一个当前位置不是 -1，则该操作对当前位置没有影响。减少序列的长度将从尾部移除元素，同时不影响剩余元素的值。减少序列长度后，新的当前位置用以下方式确定：

• 如果将序列长度设置为 0，则当前位置被设置为 -1。
• 如果减少长度前当前位置为 -1，则其仍然为 -1。
• 如果当前位置指示一个有效元素，而该元素在减少长度后没有被移除，则当前位置保持不变。
• 如果当前位置指示一个有效元素，但该元素在减少长度后被移除，则将当前位置设置为 -1。

指定者：

接口 DynSequenceOperations 中的 set_length

抛出：

InvalidValue - 如果此为有界序列且 len 大于其界限

get_elements

public Any[] get_elements()

返回序列的元素。

指定者：

接口 DynSequenceOperations 中的 get_elements

set_elements

public void set_elements(Any[] value)
                  throws TypeMismatch,
                         InvalidValue

设置序列的元素。将 DynSequence 的长度设置为 value 的长度。如果 value 的长度不为 0，则将当前位置设置为 0；如果 value 是长度为 0 的序列，则将当前位置设置为 -1。

指定者：

接口 DynSequenceOperations 中的 set_elements

抛出：

TypeMismatch - 如果 value 包含一个或多个元素，而这些元素的 TypeCode 不等于 DynSequence 的 TypeCode 元素

InvalidValue - 如果 value 的长度超出有界序列的界限

get_elements_as_dyn_any

public DynAny[] get_elements_as_dyn_any()

返回表示序列的元素的 DynAny。

指定者：

接口 DynSequenceOperations 中的 get_elements_as_dyn_any

set_elements_as_dyn_any

public void set_elements_as_dyn_any(DynAny[] value)
                             throws TypeMismatch,
                                    InvalidValue

使用 DynAny 设置序列的元素。将 DynSequence 的长度设置为 value 的长度。如果 value 的长度不为 0，则将当前位置设置为 0；如果 value 是长度为 0 的序列，则将当前位置设置为 -1。

指定者：

接口 DynSequenceOperations 中的 set_elements_as_dyn_any

抛出：

TypeMismatch - 如果 value 包含一个或多个元素，而这些元素的 TypeCode 不等于 DynSequence 的 TypeCode 元素

InvalidValue - 如果 value 的长度超出有界序列的界限

type

public TypeCode type()

返回与此 DynAny 对象关联的 TypeCode。DynAny 对象是通过分配给它的 TypeCode 值创建的。此 TypeCode 值确定通过 DynAny 对象处理的值的类型。注意，与 DynAny 对象关联的 TypeCode 在创建 DynAny 时初始化，在 DynAny 对象的生存期间不能更改。

指定者：

接口 DynAnyOperations 中的 type

返回：

与 DynAny 对象关联的 TypeCode

assign

public void assign(DynAny dyn_any)
            throws TypeMismatch

使用与另一个 DynAny 对象关联的值初始化与 DynAny 对象关联的值。对具有组件的值，将目标 DynAny 的当前位置设置为 0，对不具有组件的值，将该位置设置为 -1。

指定者：

接口 DynAnyOperations 中的 assign

参数：

dyn_any -

抛出：

TypeMismatch - 如果传递的 DynAny 的类型不等于目标 DynAny 的类型

from_any

public void from_any(Any value)
              throws TypeMismatch,
                     InvalidValue

使用 any 中包含的值初始化与 DynAny 对象关联的值。对具有组件的值，将目标 DynAny 的当前位置设置为 0，对不具有组件的值，将该位置设置为 -1。

指定者：

接口 DynAnyOperations 中的 from_any

抛出：

TypeMismatch - 如果所传递 Any 的类型不等于目标 DynAny 的类型

InvalidValue - 如果所传递的 Any 不包含合法值（如 null 字符串）

to_any

public Any to_any()

从 DynAny 对象创建 any 值。将与 DynAny 对象关联的 TypeCode 的副本分配给所得 any。将与 DynAny 对象关联的值复制到 any 中。

指定者：

接口 DynAnyOperations 中的 to_any

返回：

具有相同值和 TypeCode 的新 Any 对象

equal

public boolean equal(DynAny dyn_any)

比较两个 DynAny 值是否相等。如果两个 DynAny 值的 TypeCode 相等，则它们的值相等；以此类推，所有组件 DynAny 都具有相等的值。将比较的两个 DynAny 的当前位置不影响比较结果。

指定者：

接口 DynAnyOperations 中的 equal

返回：

如果 DynAny 相等，则返回 true；否则返回 false

destroy

public void destroy()

销毁 DynAny 对象。此操作释放所有用来表示与 DynAny 对象关联的数据值的资源。为了避免资源泄漏，此操作必须在从 ORB 接口的创建操作之一获取的引用或者 DynAny.copy() 返回的引用上调用。在组件 DynAny 对象（例如，current_component 操作返回的对象）上调用 destroy 没有任何效果。销毁 DynAny 对象意味着销毁从其获取的所有 DynAny 对象。即对已销毁 DynAny 组件的引用将变得无效。调用这种引用将引发 OBJECT_NOT_EXIST。如果在销毁可从中获取组件的 DynAny 前使用 copy 操作生成了组件的复本，则可以在该 DynAny 的生存期后操作其组件。

指定者：

接口 DynAnyOperations 中的 destroy

copy

public DynAny copy()

创建一个新 DynAny 对象，其值为调用此方法的 DynAny 的深层复制。该操作是多态的，即对派生自 DynAny 的类型之一（如 DynStruct）调用该操作时，将创建派生的类型，但以 DynAny 基本类型的形式返回其引用。

指定者：

接口 DynAnyOperations 中的 copy

返回：

DynAny 对象的深层复制

insert_boolean

public void insert_boolean(boolean value)
                    throws TypeMismatch,
                           InvalidValue

将 boolean 值插入 DynAny 中。

指定者：

接口 DynAnyOperations 中的 insert_boolean

抛出：

InvalidValue - 如果此 DynAny 具有组件，但当前位置为 -1

TypeMismatch - 如果在其当前组件本身也有组件的 DynAny 上调用此方法

insert_octet

public void insert_octet(byte value)
                  throws TypeMismatch,
                         InvalidValue

将 byte 值插入 DynAny 中。将 IDL octet 数据类型映射为 Java byte 数据类型。

指定者：

接口 DynAnyOperations 中的 insert_octet

抛出：

InvalidValue - 如果此 DynAny 具有组件，但当前位置为 -1

TypeMismatch - 如果在其当前组件本身也有组件的 DynAny 上调用此方法

insert_char

public void insert_char(char value)
                 throws TypeMismatch,
                        InvalidValue

将 char 值插入 DynAny 中。

指定者：

接口 DynAnyOperations 中的 insert_char

抛出：

InvalidValue - 如果此 DynAny 具有组件，但当前位置为 -1

TypeMismatch - 如果在其当前组件本身也有组件的 DynAny 上调用此方法

insert_short

public void insert_short(short value)
                  throws TypeMismatch,
                         InvalidValue

将 short 值插入 DynAny 中。

指定者：

接口 DynAnyOperations 中的 insert_short

抛出：

InvalidValue - 如果此 DynAny 具有组件，但当前位置为 -1

TypeMismatch - 如果在其当前组件本身也有组件的 DynAny 上调用此方法

insert_ushort

public void insert_ushort(short value)
                   throws TypeMismatch,
                          InvalidValue

将 short 值插入 DynAny 中。将 IDL ushort 数据类型映射为 Java short 数据类型。

指定者：

接口 DynAnyOperations 中的 insert_ushort

抛出：

InvalidValue - 如果此 DynAny 具有组件，但当前位置为 -1

TypeMismatch - 如果在其当前组件本身也有组件的 DynAny 上调用此方法

insert_long

public void insert_long(int value)
                 throws TypeMismatch,
                        InvalidValue

将 integer 值插入 DynAny 中。将 IDL long 数据类型映射为 Java int 数据类型。

指定者：

接口 DynAnyOperations 中的 insert_long

抛出：

InvalidValue - 如果此 DynAny 具有组件，但当前位置为 -1

TypeMismatch - 如果在其当前组件本身也有组件的 DynAny 上调用此方法

insert_ulong

public void insert_ulong(int value)
                  throws TypeMismatch,
                         InvalidValue

将 integer 值插入 DynAny 中。将 IDL ulong 数据类型映射为 Java int 数据类型。

指定者：

接口 DynAnyOperations 中的 insert_ulong

抛出：

InvalidValue - 如果此 DynAny 具有组件，但当前位置为 -1

TypeMismatch - 如果在其当前组件本身也有组件的 DynAny 上调用此方法

insert_float

public void insert_float(float value)
                  throws TypeMismatch,
                         InvalidValue

将 float 值插入 DynAny 中。

指定者：

接口 DynAnyOperations 中的 insert_float

抛出：

InvalidValue - 如果此 DynAny 具有组件，但当前位置为 -1

TypeMismatch - 如果在其当前组件本身也有组件的 DynAny 上调用此方法

insert_double

public void insert_double(double value)
                   throws TypeMismatch,
                          InvalidValue

将 double 值插入 DynAny 中。

指定者：

接口 DynAnyOperations 中的 insert_double

抛出：

InvalidValue - 如果此 DynAny 具有组件，但当前位置为 -1

TypeMismatch - 如果在其当前组件本身也有组件的 DynAny 上调用此方法

insert_string

public void insert_string(String value)
                   throws TypeMismatch,
                          InvalidValue

将 string 值插入 DynAny 中。有界的和无界的字符串都使用此方法插入。

指定者：

接口 DynAnyOperations 中的 insert_string

抛出：

InvalidValue - 如果此 DynAny 具有组件，但当前位置为 -1