Класс Any

public abstract class Any
extends Object
implements IDLEntity

Служит контейнером для любых данных, которые могут быть описаны в IDL, или для любого примитивного типа IDL. Объект Any используется как компонент объекта NamedValue, который предоставляет информацию об аргументах или возвращаемых значениях в запросах и используется для определения пар имя/значение в объектах Context.

Объект Any состоит из двух частей:

1. значение данных
2. объект TypeCode, описывающий тип значения данных, содержащегося в объекте Any. Например, объект TypeCode для массива содержит поле для длины массива и поле для типа элементов массива. (Обратите внимание, что в этом случае второе поле объекта TypeCode само является объектом TypeCode.)

Большая часть класса Any состоит из пар методов для вставки значений в объект Any и извлечения значений из него.

Для заданного примитивного типа X эти методы:

void insert_X(X x)

Этот метод позволяет вставить экземпляр x примитивного типа X в поле value объекта Any. Обратите внимание, что метод insert_X также сбрасывает поле Any объекта type при необходимости.

X extract_X()

Этот метод позволяет извлечь экземпляр типа X из объекта Any.

Этот метод выбрасывает исключение BAD_OPERATION в двух случаях:

1. тип элемента, содержащегося в объекте Any не является X
2. метод extract_X вызывается до того, как поле value объекта Any было установлено

Существуют отдельные пары методов для каждого примитивного типа данных IDL (insert_long и extract_long, insert_string и extract_string, и так далее).

Класс Any также имеет методы для получения и установки кода типа, для проверки двух объектов Any на равенство и для чтения объекта Any из потока или записи его в поток.

Конструкторы

Any

public Any()

Методы

equal

public abstract boolean equal(Any a)

Проверяет равенство данного объекта и заданного объекта. Два объекта считаются равными, если равны их значения и коды типов.

Параметры:

a - проверяемый объект

Возвращает:

true , если объекты равны; false в противном случае

См. также:

CORBA комментарии к пакету для функций, не реализованных в текущей версии

type

public abstract TypeCode type()

Возвращает информацию о типе элемента, содержащегося в этом объекте.

Возвращает:

объект, содержащий информацию о типе значения, хранящегося в этом объекте

type

public abstract void type(TypeCode t)

Параметры:

t - объект, содержащий информацию о типе значения в этом объекте

read_value

public abstract void read_value(InputStream is,
                                TypeCode t)
                         throws MARSHAL

Считывает (десериализует) значение объекта из заданного потока ввода с использованием заданного кода типа.

Параметры:

is - поток ввода, из которого нужно считать значение

t - объект, содержащий информацию о типе считываемого значения

Исключения:

MARSHAL - если заданный объект не соответствует значению, содержащемуся в потоке ввода

write_value

public abstract void write_value(OutputStream os)

Параметры:

os - поток вывода, в который нужно записать значение этого объекта

create_output_stream

public abstract OutputStream create_output_stream()

Создаёт поток вывода, в который можно сериализовать значение этого объекта.

Возвращает:

созданный поток вывода

create_input_stream

public abstract InputStream create_input_stream()

Создаёт поток ввода, из которого можно десериализовать значение этого объекта.

Возвращает:

созданный поток ввода

extract_short

public abstract short extract_short()
                             throws BAD_OPERATION

Извлекает короткое целое значение из поля объекта.

Возвращает:

сохранённое короткое целое значение

Исключения:

BAD_OPERATION - если объект содержит не короткое целое значение или поле ещё не установлено

insert_short

public abstract void insert_short(short s)

Вставляет заданное короткое целое значение в поле объекта.

Параметры:

s - вставляемое короткое целое значение

extract_long

public abstract int extract_long()
                          throws BAD_OPERATION

Извлекает целое значение из поля объекта.

Возвращает:

сохранённое целое значение

Исключения:

BAD_OPERATION - если объект содержит не целое значение или поле ещё не установлено

insert_long

public abstract void insert_long(int l)

Вставляет заданное целое значение в поле объекта.

Параметры:

l - вставляемое целое значение

extract_longlong

public abstract long extract_longlong()
                               throws BAD_OPERATION

Извлекает значение длинного целого типа из поля объекта.

Возвращает:

сохранённое значение длинного целого типа

Исключения:

BAD_OPERATION - если объект содержит не значение длинного целого типа или поле ещё не установлено

insert_longlong

public abstract void insert_longlong(long l)

Вставляет заданное значение длинного целого типа в поле объекта.

Параметры:

l - вставляемое значение длинного целого типа

extract_ushort

public abstract short extract_ushort()
                              throws BAD_OPERATION

Извлекает значение беззнакового короткого целого типа из поля объекта.

Возвращает:

сохранённое значение беззнакового короткого целого типа

Исключения:

BAD_OPERATION - если объект содержит не беззнаковое короткое целое значение или поле ещё не установлено

insert_ushort

public abstract void insert_ushort(short s)

Вставляет заданное значение беззнакового короткого целого типа в поле объекта.

Параметры:

s - вставляемое значение беззнакового короткого целого типа

extract_ulong

public abstract int extract_ulong()
                           throws BAD_OPERATION

Извлекает значение беззнакового целого типа из поля объекта.

Возвращает:

сохранённое значение беззнакового целого типа

Исключения:

BAD_OPERATION - если объект содержит не беззнаковое целое значение или поле ещё не установлено

insert_ulong

public abstract void insert_ulong(int l)

Вставляет заданное значение беззнакового целого типа в поле объекта.

Параметры:

l - вставляемое значение беззнакового целого типа

extract_ulonglong

public abstract long extract_ulonglong()
                                throws BAD_OPERATION

Извлекает значение беззнакового длинного целого типа из поля объекта.

Возвращает:

сохранённое значение беззнакового длинного целого типа

Исключения:

BAD_OPERATION - если объект содержит не беззнаковое значение длинного целого типа или поле ещё не установлено

insert_ulonglong

public abstract void insert_ulonglong(long l)

Вставляет заданное значение беззнакового длинного целого типа в поле объекта.

Параметры:

l - вставляемое значение беззнакового длинного целого типа

extract_float

public abstract float extract_float()
                             throws BAD_OPERATION

Извлекает значение типа с плавающей точкой из поля объекта.

Возвращает:

сохранённое значение типа с плавающей точкой

Исключения:

BAD_OPERATION - если объект содержит не значение типа с плавающей точкой или поле ещё не установлено

insert_float

public abstract void insert_float(float f)

Вставляет заданное значение типа с плавающей точкой в поле объекта.

Параметры:

f - вставляемое значение типа с плавающей точкой

extract_double

public abstract double extract_double()
                               throws BAD_OPERATION

Извлекает значение двойной точности из поля объекта.

Возвращает:

сохранённое значение двойной точности

Исключения:

BAD_OPERATION - если объект содержит не значение двойной точности или поле ещё не установлено

insert_double

public abstract void insert_double(double d)

Вставляет заданное значение двойной точности в поле объекта.

Параметры:

d - вставляемое значение двойной точности

extract_boolean

public abstract boolean extract_boolean()
                                 throws BAD_OPERATION

Извлекает значение булевого типа из поля объекта.

Возвращает:

сохранённое значение булевого типа

Исключения:

BAD_OPERATION - если объект содержит не значение булевого типа или поле ещё не установлено

insert_boolean

public abstract void insert_boolean(boolean b)

Вставляет заданный boolean в поле value объекта Any.

Параметры:

b — вставляемый boolean в объект Any

extract_char

public abstract char extract_char()
                           throws BAD_OPERATION

Извлекает char из поля value объекта Any.

Возвращает:

хранимое в этом объекте Any значение char

Выбрасывает:

BAD_OPERATION — если объект Any содержит не char, или поле value ещё не задано

insert_char

public abstract void insert_char(char c)
                          throws DATA_CONVERSION

Вставляет заданный char в поле value объекта Any.

Параметры:

c — вставляемый char в объект Any

Выбрасывает:

DATA_CONVERSION — при ошибке преобразования данных

extract_wchar

public abstract char extract_wchar()
                            throws BAD_OPERATION

Извлекает char из поля value объекта Any.

Возвращает:

хранимое в этом объекте Any значение char

Выбрасывает:

BAD_OPERATION — если объект Any содержит не char, или поле value ещё не задано

insert_wchar

public abstract void insert_wchar(char c)

Вставляет заданный char в поле value объекта Any.

Параметры:

c — вставляемый char в объект Any

extract_octet

public abstract byte extract_octet()
                            throws BAD_OPERATION

Извлекает byte из поля value объекта Any.

Возвращает:

хранимое в этом объекте Any значение byte

Выбрасывает:

BAD_OPERATION — если объект Any содержит не byte, или поле value ещё не задано

insert_octet

public abstract void insert_octet(byte b)

Вставляет заданный byte в поле value объекта Any.

Параметры:

b — вставляемый byte в объект Any

extract_any

public abstract Any extract_any()
                         throws BAD_OPERATION

Извлекает объект Any из поля value объекта Any.

Возвращает:

хранимый в этом объекте Any объект Any

Выбрасывает:

BAD_OPERATION — если объект Any содержит не объект Any, или поле value ещё не задано

insert_any

public abstract void insert_any(Any a)

Вставляет заданный объект Any в поле value объекта Any.

Параметры:

a — вставляемый объект Any в объект Any

extract_Object

public abstract Object extract_Object()
                               throws BAD_OPERATION

Извлекает org.omg.CORBA.Object из поля value объекта Any.

Возвращает:

хранимое в этом объекте Any значение org.omg.CORBA.Object

Выбрасывает:

BAD_OPERATION — если объект Any содержит не org.omg.CORBA.Object, или поле value ещё не задано

insert_Object

public abstract void insert_Object(Object o)

Вставляет заданный объект org.omg.CORBA.Object в поле value объекта Any.

Параметры:

o — вставляемый объект org.omg.CORBA.Object в объект Any

extract_Value

public abstract Serializable extract_Value()
                                    throws BAD_OPERATION

Извлекает объект java.io.Serializable из поля value объекта Any.

Возвращает:

хранимый в этом объекте Any объект java.io.Serializable

Выбрасывает:

BAD_OPERATION — если объект Any содержит не объект java.io.Serializable, или поле value ещё не задано

insert_Value

public abstract void insert_Value(Serializable v)

Вставляет заданный объект java.io.Serializable в поле value объекта Any.

Параметры:

v — вставляемый объект java.io.Serializable в объект Any

insert_Value

public abstract void insert_Value(Serializable v,
                                  TypeCode t)
                           throws MARSHAL

Вставляет заданный объект java.io.Serializable в поле value объекта Any.

Параметры:

v — вставляемый объект java.io.Serializable в объект Any

t — вставляемый в поле type объекта Any объект TypeCode, описывающий вставляемый объект java.io.Serializable

Выбрасывает:

MARSHAL — если у ORB возникли проблемы с маришованием или расмаришованием параметров

insert_Object

public abstract void insert_Object(Object o,
                                   TypeCode t)
                            throws BAD_PARAM

Вставляет заданный объект org.omg.CORBA.Object в поле value объекта Any.

Параметры:

o — вставляемый экземпляр org.omg.CORBA.Object в объект Any

t — вставляемый объект TypeCode и описывающий вставляемый объект Object

Выбрасывает:

BAD_OPERATION — если метод недействителен для этого объекта Any

BAD_PARAM

extract_string

public abstract String extract_string()
                               throws BAD_OPERATION

Извлекает объект String из поля value объекта Any.

Возвращает:

хранимый в этом объекте Any объект String

Выбрасывает:

BAD_OPERATION — если объект Any содержит не объект String, или поле value ещё не задано

insert_string

public abstract void insert_string(String s)
                            throws DATA_CONVERSION,
                                   MARSHAL

Вставляет заданный объект String в поле value объекта Any.

Параметры:

s — вставляемый объект String в объект Any

Выбрасывает:

DATA_CONVERSION — при ошибке преобразования данных

MARSHAL — если у ORB возникли проблемы с маришованием или расмаришованием параметров

extract_wstring

public abstract String extract_wstring()
                                throws BAD_OPERATION

Извлекает объект String из поля value объекта Any.

Возвращает:

хранимый в этом объекте Any объект String

Выбрасывает:

BAD_OPERATION — если объект Any содержит не объект String, или поле value ещё не задано

insert_wstring

public abstract void insert_wstring(String s)
                             throws MARSHAL

Вставляет заданный объект String в поле value объекта Any.

Параметры:

s — вставляемый объект String в объект Any

Выбрасывает:

MARSHAL — если у ORB возникли проблемы с маришованием или расмаришованием параметров

extract_TypeCode

public abstract TypeCode extract_TypeCode()
                                   throws BAD_OPERATION

Извлекает объект TypeCode из поля value объекта Any.

Возвращает:

хранимый в этом объекте Any объект TypeCode

Выбрасывает:

BAD_OPERATION — если объект Any содержит не объект TypeCode, или поле value ещё не задано

insert_TypeCode

public abstract void insert_TypeCode(TypeCode t)

Вставляет заданный объект TypeCode в поле value объекта Any.

Параметры:

t — вставляемый объект TypeCode в объект Any

extract_Principal

@Deprecated
public Principal extract_Principal()
                                        throws BAD_OPERATION

Устаревшее. Устарело в CORBA 2.2.

Извлекает объект Principal из поля value объекта Any. Обратите внимание, что класс Principal устарел.

Возвращает:

хранимый в этом объекте Any объект Principal

Выбрасывает:

BAD_OPERATION — если объект Any содержит не объект Principal, или поле value ещё не задано

См. также:

CORBA Комментарии к пакету для неосуществлённых функций

insert_Principal

@Deprecated
public void insert_Principal(Principal p)

Устаревшее. Устарело в CORBA 2.2.

Вставляет заданный объект Principal в поле value объекта Any. Обратите внимание, что класс Principal устарел.

Параметры:

p — объект Principal, который необходимо вставить в этот объект Any

См. также:

CORBA комментарии к пакету по нереализованным функциям

extract_Streamable

public Streamable extract_Streamable()
                              throws BAD_INV_ORDER

Извлекает объект Streamable из поля value этого объекта Any. Этот метод позволяет извлекать непримитивные типы IDL.

Возвращает:

объект Streamable, сохранённый в объекте Any.

Исключения:

BAD_INV_ORDER — если вызывающий код выполнил операции в неправильном порядке

См. также:

CORBA комментарии к пакету по нереализованным функциям

insert_Streamable

public void insert_Streamable(Streamable s)

Вставляет заданный объект Streamable в поле value этого объекта Any. Этот метод позволяет вставлять не примитивные типы IDL.

Параметры:

s — объект Streamable для вставки в этот объект Any; может быть не примитивным типом IDL

См. также:

CORBA комментарии к пакету по нереализованным функциям

extract_fixed

public BigDecimal extract_fixed()

Извлекает объект java.math.BigDecimal из поля value этого объекта Any.

Возвращает:

объект java.math.BigDecimal , сохраненный в этом объекте Any

Исключения:

BAD_OPERATION — если этот объект Any содержит что-либо помимо объекта java.math.BigDecimal или поле value ещё не было установлено

См. также:

CORBA комментарии к пакету по нереализованным функциям

insert_fixed

public void insert_fixed(BigDecimal value)

Параметры:

value — объект java.math.BigDecimal для вставки в этот объект Any

См. также:

CORBA комментарии к пакету по нереализованным функциям

insert_fixed

public void insert_fixed(BigDecimal value,
                         TypeCode type)
                  throws BAD_INV_ORDER

Параметры:

value — объект java.math.BigDecimal для вставки в этот объект Any

type — объект TypeCode, который должен быть вставлен в поле type этого объекта Any и который описывает объект java.math.BigDecimal , который вставляется

Исключения:

BAD_INV_ORDER — если этот метод вызван неправильно

См. также:

CORBA комментарии к пакету по нереализованным функциям