Класс ServerRequest

public abstract class ServerRequest
extends Object

Объект, который захватывает явное состояние запроса для интерфейса динамического скелета (DSI). Этот класс, краеугольный камень DSI, аналогичен объекту Request в DII.

ORB отвечает за создание этого воплощения запроса и доставку его в динамическую реализующую процедуру (DIR). Динамический слуга (DIR) создаётся путём реализации класса DynamicImplementation, который имеет единственный метод invoke. Этот метод принимает объект ServerRequest. Абстрактный класс ServerRequest определяет методы для доступа к имени метода, аргументам и контексту запроса, а также методы для установки результата запроса либо как возвращаемое значение, либо как исключение.

Суть доступа к аргументам запроса заключается в том, что DIR должен предоставить информацию о типе ожидаемых аргументов, так как нет скомпилированной информации об этом. Эта информация предоставляется через NVList, который представляет собой список объектов NamedValue. Каждый объект NamedValue содержит объект Any, который в свою очередь содержит объект TypeCode, представляющий тип аргумента.

Аналогично, информация о типе необходима для ответа, как для ожидаемого результата, так и для исключения, поэтому методы result и except принимают объект Any в качестве параметра.

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

ServerRequest

public ServerRequest()

Методы

op_name

@Deprecated
public String op_name()

Устаревшее. Используйте operation()

Возвращает имя вызываемой операции. Согласно правилам OMG IDL, эти имена должны быть уникальными среди всех операций, поддерживаемых интерфейсом этого объекта «наиболее производного» уровня. Обратите внимание, что имена операций для получения и установки атрибутов соответственно равны _get_<attribute_name> и _set_<attribute_name>.

Возвращает:

имя вызываемой операции

operation

public String operation()

Возвращает:

имя вызываемой операции

См. также:

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

params

@Deprecated
public void params(NVList params)

Устаревшее. Используйте метод arguments

Параметры:

params - аргументы метода в виде объекта NVList

arguments

public void arguments(NVList args)

Определяет типы параметров метода и получает значения аргументов «in» и «inout». Если не вызывается метод set_exception, DIR должен вызвать этот метод ровно один раз, даже если сигнатура метода не содержит параметров. После вызова методов arguments или set_exception, вызов arguments на том же объекте ServerRequest приведет к возникновению системного исключения BAD_INV_ORDER. DIR должен передать методу arguments объект NVList, инициализированный TypeCodes и флагами, описывающими типы параметров операции в порядке их появления в спецификации IDL (слева направо). Потенциально другой объект NVList будет возвращен методом arguments, с предоставленными значениями аргументов «in» и «inout». Если не вызывается метод set_exception, DIR должен заполнить возвращённый объект NVList значениями для аргументов «out» перед возвратом, и может также изменить возвращаемые значения для аргументов «inout».

Параметры:

args - аргументы метода в виде NVList

См. также:

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

result

@Deprecated
public void result(Any any)

Устаревшее. Используйте метод set_result

Параметры:

any - объект Any, содержащий возвращаемое значение

set_result

public void set_result(Any any)

Параметры:

any - объект Any, содержащий возвращаемое значение

См. также:

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

except

@Deprecated
public void except(Any any)

Устаревшее. Используйте set_exception()

DIR может вызвать set_exception в любое время, чтобы вернуть исключение клиенту. Any, переданный в set_exception, должен содержать либо системное исключение, либо пользовательское исключение, указанное в выражении raises вызываемой операции IDL. Передача Any, не содержащего исключения, приведет к системному исключению BAD_PARAM. Передача не указанного пользовательского исключения приведет к тому, что DIR получит системное исключение BAD_PARAM или клиент получит системное исключение UNKNOWN_EXCEPTION.

Параметры:

any - объект Any, содержащий исключение

set_exception

public void set_exception(Any any)

Параметры:

any - объект Any, содержащий исключение

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

BAD_PARAM - если переданный объект Any не содержит исключение или исключение не указано

UNKNOWN_EXCEPTION - если переданное исключение является не указанным пользовательским исключением, и DIR не получил исключения BAD_PARAM

См. также:

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

ctx

public abstract Context ctx()

Возвращает информацию о контексте, указанную в IDL для операции, когда операция не является доступом к атрибуту и определение операции IDL содержит выражение контекста; в противном случае возвращает нулевую ссылку Context. Вызов метода ctx до вызова метода arguments или после вызова методов ctx, set_result, или set_exception приведет к возникновению системного исключения BAD_INV_ORDER.

Возвращает:

объект контекста, который будет использоваться для разрешения любых строк контекста, значения которых необходимо отправить с вызовом.

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

BAD_INV_ORDER - если (1) метод ctx вызывается до метода arguments или (2) метод ctx вызывается после вызова set_result или set_exception