Запрос (Платформа Java SE 7)

java.lang. Объект
- org.omg. CORBA.Request

```
public abstract class Request
extends Object
```
Объект, содержащий информацию, необходимую для того, чтобы вызвать метод. Этот класс является краеугольным камнем ШАРА Динамический Интерфейс Вызова (DII), который позволяет динамическое создание и вызов запросов. Сервер не может сказать различие между клиентским вызовом, используя клиентский тупик и запросом, используя DII.
A Request объект состоит из:
- имя работы, которая будет вызвана
- NVList содержа параметры за работу.
  Каждый элемент в списке является a NamedValue объект, у которого есть три части:
  1. имя параметра
  2. значение параметра (как Any объект)
  3. флаг режима параметра, указывающий, является ли параметр для ввода, вывода, или обоих
Request объекты могут также содержать дополнительную информацию, в зависимости от того, как работа была определена в исходном определении интерфейса IDL. Например, где необходимо, они могут содержать a NamedValue возразите, чтобы содержать возвращаемое значение или исключение, контекст, список возможных исключений, и список строк контекста, которые должны быть разрешены.
Новый Request объекты создаются, используя один из create_request методы в Object класс. Другими словами, a create_request метод выполняется на объекте, который должен быть вызван.
См. Также:
NamedValue

Сводка конструктора

Конструкторы
Конструктор и Описание

Request()

Конструкторы
Конструктор и Описание
`Request()`

Сводка метода

Методы
Модификатор и Тип	Метод и Описание
`abstract Any`	`add_in_arg()` Создает входной параметр и добавляет это к этому `Request` объект.
`abstract Any`	`add_inout_arg()` Добавляет параметр ввода/вывода этому `Request` объект.
`abstract Any`	`add_named_in_arg(String name)` Создает входной параметр с именем и добавляет это к этому `Request` объект.
`abstract Any`	`add_named_inout_arg(String name)` Добавляет параметр ввода/вывода с именем к этому `Request` объект.
`abstract Any`	`add_named_out_arg(String name)` Добавляет выходной параметр с именем к этому `Request` объект.
`abstract Any`	`add_out_arg()` Добавляет выходной параметр этому `Request` объект.
`abstract NVList`	`arguments()` Получает `NVList` объект, содержащий параметры вызываемому методу.
`abstract ContextList`	`contexts()` Получает `ContextList` объект для этого запроса.
`abstract Context`	`ctx()` Получает `Context` объект для этого запроса.
`abstract void`	`ctx(Context c)` Наборы этот запрос `Context` возразите против один данный.
`abstract Environment`	`env()` Получает `Environment` объект для этого запроса.
`abstract ExceptionList`	`exceptions()` Получает `ExceptionList` объект для этого запроса.
`abstract void`	`get_response()` Позволяет пользователю получать доступ к ответу для вызова, инициированного ранее с `send_deferred` метод.
`abstract void`	`invoke()` Делает синхронный вызов, используя информацию в `Request` объект.
`abstract String`	`operation()` Получает имя метода, который будет вызван.
`abstract boolean`	`poll_response()` Позволяет пользователю определять, был ли ответ получен для вызова, инициированного ранее с `send_deferred` метод.
`abstract NamedValue`	`result()` Получает `NamedValue` объект, содержащий возвращаемое значение для метода.
`abstract Any`	`return_value()` Возвраты `Any` объект, который содержит значение для результата метода.
`abstract void`	`send_deferred()` Делает асинхронный вызов по запросу.
`abstract void`	`send_oneway()` Делает односторонний вызов по запросу.
`abstract void`	`set_return_type(TypeCode tc)` Устанавливает typecode для возвращаемого значения метода.
`abstract Object`	`target()` Получает целевую ссылку на объект.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь конструктора
  - Запрос
```
public Request()
```
- Деталь метода
  - цель
```
public abstract Object target()
```
    Получает целевую ссылку на объект.
    
    Возвраты:
    ссылка на объект, которая указывает на объектную реализацию для метода, который будет вызван
  - работа
```
public abstract String operation()
```
    Получает имя метода, который будет вызван.
    
    Возвраты:
    имя метода, который будет вызван
  - параметры
```
public abstract NVList arguments()
```
    Получает NVList объект, содержащий параметры вызываемому методу. Элементы в списке NamedValue объекты, с каждым описанием параметра методу.
    
    Возвраты:
    NVList объект, содержащий параметры за метод
  - результат
```
public abstract NamedValue result()
```
    Получает NamedValue объект, содержащий возвращаемое значение для метода.
    
    Возвраты:
    NamedValue объект, содержащий результат метода
  - конверт
```
public abstract Environment env()
```
    Получает Environment объект для этого запроса. Это содержит исключение, которое вызываемый метод выдал (после того, как вызов возвращается).
    
    Возвраты:
    Environment объект для этого запроса
  - исключения
```
public abstract ExceptionList exceptions()
```
    Получает ExceptionList объект для этого запроса. Этот список содержит TypeCode объекты, описывающие исключения, которые могут быть выданы вызываемым методом.
    
    Возвраты:
    ExceptionList объект, описывающий исключения, которые могут быть выданы вызываемым методом
  - контексты
```
public abstract ContextList contexts()
```
    Получает ContextList объект для этого запроса. Этот список содержит контекст Strings, который должен быть разрешен и отправлен с вызовом.
    
    Возвраты:
    список строк контекста, значения которых должны быть разрешены и отправлены с вызовом.
  - ctx
```
public abstract Context ctx()
```
    Получает Context объект для этого запроса. Это - список свойств, дающих информацию о клиенте, среде, или обстоятельствах этого запроса.
    
    Возвраты:
    Context объект, который должен использоваться, чтобы разрешить любые строки контекста, значения которых должны быть отправлены с вызовом
  - ctx
```
public abstract void ctx(Context c)
```
    Наборы этот запрос Context возразите против один данный.
    
    Параметры:
    c - новое Context объект, который будет использоваться для того, чтобы разрешить строки контекста
  - add_in_arg
```
public abstract Any add_in_arg()
```
    Создает входной параметр и добавляет это к этому Request объект.
    
    Возвраты:
    Any объект, который содержит значение и typecode для входного добавленного параметра
  - add_named_in_arg
```
public abstract Any add_named_in_arg(String name)
```
    Создает входной параметр с именем и добавляет это к этому Request объект.
    
    Параметры:
    name - имя добавляемого параметра
    
    Возвраты:
    Any объект, который содержит значение и typecode для входного добавленного параметра
  - add_inout_arg
```
public abstract Any add_inout_arg()
```
    Добавляет параметр ввода/вывода этому Request объект.
    
    Возвраты:
    Any объект, который содержит значение и typecode для добавленного параметра ввода/вывода
  - add_named_inout_arg
```
public abstract Any add_named_inout_arg(String name)
```
    Добавляет параметр ввода/вывода с именем к этому Request объект.
    
    Параметры:
    name - имя добавляемого параметра
    
    Возвраты:
    Any объект, который содержит значение и typecode для добавленного параметра ввода/вывода
  - add_out_arg
```
public abstract Any add_out_arg()
```
    Добавляет выходной параметр этому Request объект.
    
    Возвраты:
    Any объект, который содержит значение и typecode для выходного добавленного параметра
  - add_named_out_arg
```
public abstract Any add_named_out_arg(String name)
```
    Добавляет выходной параметр с именем к этому Request объект.
    
    Параметры:
    name - имя добавляемого параметра
    
    Возвраты:
    Any объект, который содержит значение и typecode для выходного добавленного параметра
  - set_return_type
```
public abstract void set_return_type(TypeCode tc)
```
    Устанавливает typecode для возвращаемого значения метода.
    
    Параметры:
    tc - TypeCode объект, содержащий информацию о типе для возвращаемого значения
  - return_value
```
public abstract Any return_value()
```
    Возвраты Any объект, который содержит значение для результата метода.
    
    Возвраты:
    Any объект, содержащий значение и typecode для возвращаемого значения
  - вызвать
```
public abstract void invoke()
```
    Делает синхронный вызов, используя информацию в Request объект. Информация об исключении помещается в Request объект среды объекта.
  - send_oneway
```
public abstract void send_oneway()
```
    Делает односторонний вызов по запросу. Другими словами это не ожидает или ожидает ответа. Отметьте, что это может использоваться, даже если работа не была объявлена как односторонняя в объявлении IDL. Никакой ответ или информация об исключении не возвращаются.
  - send_deferred
```
public abstract void send_deferred()
```
    Делает асинхронный вызов по запросу. Другими словами это не ожидает ответа прежде, чем это возвратится к пользователю. Пользователь может тогда позже использовать методы poll_response и get_response получить результат или информацию об исключении для вызова.
  - poll_response
```
public abstract boolean poll_response()
```
    Позволяет пользователю определять, был ли ответ получен для вызова, инициированного ранее с send_deferred метод.
    
    Возвраты:
    true если ответ метода был получен; false иначе
  - get_response
```
public abstract void get_response()
                           throws WrongTransaction
```
    Позволяет пользователю получать доступ к ответу для вызова, инициированного ранее с send_deferred метод.
    
    Броски:
    
    WrongTransaction - если метод get_response был вызван от контекста различной транзакции чем тот, от которого был первоначально отправлен запрос. См. спецификацию Службы Транзакции OMG для деталей.

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Запрос класса

Сводка конструктора

Сводка метода

Методы java.lang унаследованный от класса. Объект

Деталь конструктора

Запрос

Деталь метода

цель

работа

параметры

результат

конверт

исключения

контексты

ctx

ctx

add_in_arg

add_named_in_arg

add_inout_arg

add_named_inout_arg

add_out_arg

add_named_out_arg

set_return_type

return_value

вызвать

send_oneway

send_deferred

poll_response

get_response