JavaTM 2 Platform
Standard Ed. 6

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. 6

提交錯誤或意見

版權所有 2008 Sun Microsystems, Inc. 保留所有權利。請遵守GNU General Public License, version 2 only