Spec-Zone .ru
спецификации, руководства, описания, API
|
public interface DynAnyOperations
Объект DynAny может быть просмотрен как упорядоченный набор компонента DynAnys. Для DynAnys, представляющего основной тип, такой столь же длинный, или тип без компонентов, таких как пустое исключение, упорядоченный набор компонентов пуст. Каждый объект DynAny поддерживает понятие текущей позиции в ее набор компонента DynAnys. Текущая позиция идентифицируется индексировать значением, которое работает от 0 до n-1, где n является числом компонентов. Специальное предложение индексирует значение-1, указывает на текущую позицию, которая не указывает нигде. Для значений, у которых не может быть текущей позиции (такой как пустое исключение), индексировать значение фиксируется в-1. Если DynAny инициализируется со значением, у которого есть компоненты, индексирование инициализируется к 0. После создания неинициализированного DynAny (то есть, DynAny, у которого нет никакого значения, но TypeCode, который разрешает компоненты), текущая позиция зависит от типа имеющего значение, представленного DynAny. (Текущая позиция устанавливается в 0 или-1, в зависимости от того, получает ли новый DynAny значения по умолчанию для своих компонентов.)
Итеративная перемотка операций, ищите, и затем может использоваться, чтобы изменить текущую позицию, и current_component работа возвращает компонент в текущей позиции. component_count работа возвращает число компонентов DynAny. Все вместе эти операции позволяют итерации по компонентам DynAny, например, (рекурсивно) исследовать свое содержание.
Созданный объект DynAny является объектом DynAny, связанным с созданным типом. Есть различный интерфейс, наследовавшийся от интерфейса DynAny, связанный с каждым видом созданных вводят IDL (фиксированный, перечисление, struct, последовательность, объединение, массив, исключение, и оцените тип).
Созданный объект DynAny экспортирует операции, которые включают созданию новых объектов DynAny, каждому из них связанный с компонентом созданного значения данных. Как пример, DynStruct связывается со значением struct. Это означает, что DynStruct может быть замечен как обладание упорядоченного набора компонентов, один для каждого элемента структуры. Объект DynStruct экспортирует операции, которые включают созданию новых объектов DynAny, каждому из них связанный с элементом struct.
Если объект DynAny был получен от другого (создал) объект DynAny, такой как DynAny, представляющий элемент структуры, который создавался из DynStruct, элемент DynAny логически содержится в DynStruct. Вызов вставки или получает листы работы неизменная текущая позиция. Уничтожая верхний уровень объект DynAny (тот, который не был получен как компонент другого DynAny) также уничтожает любой компонент объекты DynAny, полученные из него. Уничтожая неверхний уровень объект DynAny ничего не делает. Вызывая операции на уничтоженный верхний уровень DynAny или любой из его потомков повышают OBJECT_NOT_EXIST. Если программист хочет уничтожить объект DynAny, но все еще хочет управлять некоторым компонентом значения данных, связанного с этим, то он или она должен сначала создать DynAny для компонента и после этого, сделайте копию создаваемого объекта DynAny.
Поведение объектов DynAny было определено, чтобы включить эффективным реализациям с точки зрения выделенного пространства памяти и скорости доступа. Объекты DynAny предназначаются, чтобы использоваться для того, чтобы пересечь значения, извлеченные из anys или создать значения anys во времени выполнения. Их использование в других целях не рекомендуется.
Вставьте и доберитесь, операции необходимы, чтобы обработать основные объекты DynAny, но также полезны, чтобы обработать созданные объекты DynAny. Вставка значения типа исходных данных в созданный объект DynAny подразумевает инициализацию текущего компонента созданного значения данных, связанного с объектом DynAny. Например, вызов insert_boolean на DynStruct подразумевает вставку значения булевых данных в текущей позиции связанного struct значения данных. Тип является непротиворечивым для вставки или извлечения значения, если его TypeCode эквивалентен TypeCode, содержавшемуся в DynAny или, если у DynAny есть компоненты, эквивалентно TypeCode DynAny в текущей позиции.
DynAny и объекты DynAnyFactory предназначаются, чтобы быть локальными для процесса, в котором они создаются и используются. Это означает, что ссылки на объекты DynAny и DynAnyFactory не могут быть экспортированы в другие процессы, или воплощены с Шаром object_to_string (). Если какая-либо попытка будет предпринята, чтобы сделать так, то незаконная работа повысит УПОРЯДОЧИВАТЬ системное исключение. Так как их интерфейсы определяются в IDL, операции экспорта объектов DynAny, определенные в стандарте org.omg. Интерфейс CORBA.Object. Однако, любая попытка вызвать операции, экспортируемые через Интерфейс объекта, может повысить стандартное исключение NO_IMPLEMENT. Попытка использовать объект DynAny с DII может повысить исключение 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)
Инициализирует значение, связанное с объектом DynAny со значением, содержавшимся в любом.
|
Любой |
get_any()
Извлекает Любое значение, содержавшееся в Любом, представленном этим DynAny.
|
boolean |
get_boolean()
Извлекает булево значение из этого DynAny.
|
char |
get_char()
Извлекает значение случайной работы из этого DynAny.
|
double |
get_double()
Извлекает двойное значение из этого DynAny.
|
DynAny |
get_dyn_any()
Извлекает Любое значение, содержавшееся в Любом, представленном этим DynAny, и возвращает обернутое в новый DynAny.
|
float |
get_float()
Извлекает значение плавающее из этого DynAny.
|
int |
get_long()
Извлекает целочисленное значение из этого DynAny.
|
long |
get_longlong()
Извлекает длинное значение из этого DynAny.
|
byte |
get_octet()
Извлекает значение байта из этого DynAny.
|
Объект |
get_reference()
Извлекает ссылку на Объект CORBA от этого DynAny.
|
short |
get_short()
Извлекает короткое значение из этого DynAny.
|
Строка |
get_string()
Извлекает строковое значение из этого DynAny.
|
TypeCode |
get_typecode()
Извлекает объект TypeCode из этого DynAny.
|
int |
get_ulong()
Извлекает целочисленное значение из этого DynAny.
|
long |
get_ulonglong()
Извлекает длинное значение из этого DynAny.
|
short |
get_ushort()
Извлекает короткое значение из этого DynAny.
|
Сериализуемый |
get_val()
Извлекает Сериализуемый объект из этого DynAny.
|
char |
get_wchar()
Извлекает длинное значение из этого DynAny.
|
Строка |
get_wstring()
Извлекает строковое значение из этого DynAny.
|
void |
insert_any(Any value)
Вставляет Любое значение в Любого, представленного этим DynAny.
|
void |
insert_boolean(boolean value)
Вставляет булево значение в DynAny.
|
void |
insert_char(char value)
Вставляет значение случайной работы в DynAny.
|
void |
insert_double(double value)
Вставляет двойное значение в DynAny.
|
void |
insert_dyn_any(DynAny value)
Вставляет Любое значение, содержавшееся в параметре DynAny в Любого, представленного этим DynAny.
|
void |
insert_float(float value)
Вставляет значение плавающее в DynAny.
|
void |
insert_long(int value)
Вставляет целочисленное значение в DynAny.
|
void |
insert_longlong(long value)
Вставляет длинное значение в DynAny.
|
void |
insert_octet(byte value)
Вставляет значение байта в DynAny.
|
void |
insert_reference(Object value)
Вставляет ссылку на объект CORBA в DynAny.
|
void |
insert_short(short value)
Вставляет короткое значение в DynAny.
|
void |
insert_string(String value)
Вставляет строковое значение в DynAny.
|
void |
insert_typecode(TypeCode value)
Вставляет объект TypeCode в DynAny.
|
void |
insert_ulong(int value)
Вставляет целочисленное значение в DynAny.
|
void |
insert_ulonglong(long value)
Вставляет длинное значение в DynAny.
|
void |
insert_ushort(short value)
Вставляет короткое значение в DynAny.
|
void |
insert_val(Serializable value)
Вставляет ссылку на Сериализуемый объект в этот DynAny.
|
void |
insert_wchar(char value)
Вставляет значение случайной работы в DynAny.
|
void |
insert_wstring(String value)
Вставляет строковое значение в DynAny.
|
boolean |
next()
Совершенствует текущую позицию к следующему компоненту.
|
void |
rewind()
Эквивалентно, чтобы искать (0).
|
boolean |
seek(int index)
Устанавливает текущую позицию, чтобы индексировать.
|
Любой |
to_any()
Создает любую стоимость от объекта DynAny.
|
TypeCode |
type()
Возвращает TypeCode, связанный с этим объектом DynAny.
|
TypeCode type()
void assign(DynAny dyn_any) throws TypeMismatch
dyn_any
- TypeMismatch
- если тип переданного DynAny не эквивалентен типу целевого DynAnyvoid from_any(Any value) throws TypeMismatch, InvalidValue
TypeMismatch
- если тип переданного Кто-либо не эквивалентен типу целевого DynAnyInvalidValue
- если переданный Кто-либо не содержит юридическое значение (такое как пустая строка)Any to_any()
boolean equal(DynAny dyn_any)
void destroy()
DynAny copy()
void insert_boolean(boolean value) throws TypeMismatch, InvalidValue
InvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыvoid insert_octet(byte value) throws TypeMismatch, InvalidValue
InvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыvoid insert_char(char value) throws TypeMismatch, InvalidValue
InvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыvoid insert_short(short value) throws TypeMismatch, InvalidValue
InvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыvoid insert_ushort(short value) throws TypeMismatch, InvalidValue
InvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыvoid insert_long(int value) throws TypeMismatch, InvalidValue
InvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыvoid insert_ulong(int value) throws TypeMismatch, InvalidValue
InvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыvoid insert_float(float value) throws TypeMismatch, InvalidValue
InvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыvoid insert_double(double value) throws TypeMismatch, InvalidValue
InvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыvoid insert_string(String value) throws TypeMismatch, InvalidValue
InvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1InvalidValue
- если вставленная строка более длинна чем связанная из ограниченной струныTypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыvoid insert_reference(Object value) throws TypeMismatch, InvalidValue
InvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыvoid insert_typecode(TypeCode value) throws TypeMismatch, InvalidValue
InvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыvoid insert_longlong(long value) throws TypeMismatch, InvalidValue
InvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыvoid insert_ulonglong(long value) throws TypeMismatch, InvalidValue
InvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыvoid insert_wchar(char value) throws TypeMismatch, InvalidValue
InvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыvoid insert_wstring(String value) throws TypeMismatch, InvalidValue
InvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1InvalidValue
- если вставленная строка более длинна чем связанная из ограниченной струныTypeMismatch
void insert_any(Any value) throws TypeMismatch, InvalidValue
InvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыvoid insert_dyn_any(DynAny value) throws TypeMismatch, InvalidValue
InvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыvoid insert_val(Serializable value) throws TypeMismatch, InvalidValue
InvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыboolean get_boolean() throws TypeMismatch, InvalidValue
TypeMismatch
- если компонент, к которому получают доступ, в DynAny имеет тип, который не эквивалентен требуемому типу.TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыInvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1byte get_octet() throws TypeMismatch, InvalidValue
TypeMismatch
- если компонент, к которому получают доступ, в DynAny имеет тип, который не эквивалентен требуемому типу.TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыInvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1char get_char() throws TypeMismatch, InvalidValue
TypeMismatch
- если компонент, к которому получают доступ, в DynAny имеет тип, который не эквивалентен требуемому типу.TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыInvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1short get_short() throws TypeMismatch, InvalidValue
TypeMismatch
- если компонент, к которому получают доступ, в DynAny имеет тип, который не эквивалентен требуемому типу.TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыInvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1short get_ushort() throws TypeMismatch, InvalidValue
TypeMismatch
- если компонент, к которому получают доступ, в DynAny имеет тип, который не эквивалентен требуемому типу.TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыInvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1int get_long() throws TypeMismatch, InvalidValue
TypeMismatch
- если компонент, к которому получают доступ, в DynAny имеет тип, который не эквивалентен требуемому типу.TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыInvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1int get_ulong() throws TypeMismatch, InvalidValue
TypeMismatch
- если компонент, к которому получают доступ, в DynAny имеет тип, который не эквивалентен требуемому типу.TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыInvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1float get_float() throws TypeMismatch, InvalidValue
TypeMismatch
- если компонент, к которому получают доступ, в DynAny имеет тип, который не эквивалентен требуемому типу.TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыInvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1double get_double() throws TypeMismatch, InvalidValue
TypeMismatch
- если компонент, к которому получают доступ, в DynAny имеет тип, который не эквивалентен требуемому типу.TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыInvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1String get_string() throws TypeMismatch, InvalidValue
TypeMismatch
- если компонент, к которому получают доступ, в DynAny имеет тип, который не эквивалентен требуемому типу.TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыInvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1Object get_reference() throws TypeMismatch, InvalidValue
TypeMismatch
- если компонент, к которому получают доступ, в DynAny имеет тип, который не эквивалентен требуемому типу.TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыInvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1TypeCode get_typecode() throws TypeMismatch, InvalidValue
TypeMismatch
- если компонент, к которому получают доступ, в DynAny имеет тип, который не эквивалентен требуемому типу.TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыInvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1long get_longlong() throws TypeMismatch, InvalidValue
TypeMismatch
- если компонент, к которому получают доступ, в DynAny имеет тип, который не эквивалентен требуемому типу.TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыInvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1long get_ulonglong() throws TypeMismatch, InvalidValue
TypeMismatch
- если компонент, к которому получают доступ, в DynAny имеет тип, который не эквивалентен требуемому типу.TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыInvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1char get_wchar() throws TypeMismatch, InvalidValue
TypeMismatch
- если компонент, к которому получают доступ, в DynAny имеет тип, который не эквивалентен требуемому типу.TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыInvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1String get_wstring() throws TypeMismatch, InvalidValue
TypeMismatch
- если компонент, к которому получают доступ, в DynAny имеет тип, который не эквивалентен требуемому типу.TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыInvalidValue
Any get_any() throws TypeMismatch, InvalidValue
TypeMismatch
- если компонент, к которому получают доступ, в DynAny имеет тип, который не эквивалентен требуемому типу.TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыInvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1DynAny get_dyn_any() throws TypeMismatch, InvalidValue
TypeMismatch
- если компонент, к которому получают доступ, в DynAny имеет тип, который не эквивалентен требуемому типу.TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыInvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1Serializable get_val() throws TypeMismatch, InvalidValue
TypeMismatch
- если компонент, к которому получают доступ, в DynAny имеет тип, который не эквивалентен требуемому типу.TypeMismatch
- если обращено DynAny, у самого текущего компонента которого есть компонентыInvalidValue
- если этот DynAny имеет компоненты, но имеет текущую позицию-1boolean seek(int index)
void rewind()
boolean next()
int component_count()
DynAny current_component() throws TypeMismatch
TypeMismatch
- Если обращено DynAny, у которого не может быть компонентов, таких как DynEnum или пустое исключение
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
ЧЕРНОВАЯ земля-b92