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

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

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

Методы, наследованные от class 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, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92

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

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

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

Методы, наследованные от class 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