RequestInfoOperations (Платформа Java SE 7)

Все Известные Подынтерфейсы:

ClientRequestInfo, ClientRequestInfoOperations, RequestInfo, ServerRequestInfo, ServerRequestInfoOperations
```
public interface RequestInfoOperations
```
Информация о запросе, доступная для Перехватчиков.
Каждой точке перехвата дают объект, через который Перехватчик может получить доступ к информации о запросе. Клиентская сторона и точки перехвата серверной стороны касаются различной информации, таким образом есть два информационных объекта: ClientRequestInfo передается к точкам перехвата клиентской стороны и ServerRequestInfo передается к точкам перехвата серверной стороны. Но есть информация, которая характерна для обоих, таким образом, они оба наследовались от общего интерфейса: RequestInfo.

См. Также:
ClientRequestInfo, ServerRequestInfo

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

Методы
Модификатор и Тип	Метод и Описание
`Параметр[]`	`arguments()` Возвращает массив `Parameter` объекты, содержа параметры на вызываемой работе.
`Строка[]`	`contexts()` Возвращает массив `String` объекты, описывающие контексты, которые можно передать этому вызову работы.
`TypeCode[]`	`exceptions()` Возвращает массив `TypeCode` объекты, описывающие `TypeCode`s пользовательских исключений, которые может выдать этот вызов работы.
`Объект`	`forward_reference()` Содержит объект, к которому запрос будет передан, если `reply_status` атрибут `LOCATION_FORWARD`.
`ServiceContext`	`get_reply_service_context(int id)` Возвращает копию контекста службы с данным ID, который связывается с ответом.
`ServiceContext`	`get_request_service_context(int id)` Возвращает копию контекста службы с данным ID, который связывается с запросом.
`Любой`	`get_slot(int id)` Возвращает данные из данного слота `PortableInterceptor.Current` это в пределах запроса.
`Строка[]`	`operation_context()` Возвращает массив `String` объекты, содержащие контексты, отправляемые по запросу.
`Строка`	`operation()` Возвращает имя вызываемой работы.
`short`	`reply_status()` Описывает состояние результата вызова работы.
`int`	`request_id()` Возвращает идентификатор, который однозначно определяет активную последовательность запроса/ответа.
`boolean`	`response_expected()` Указывает, ожидается ли ответ.
`Любой`	`result()` Возвращает любого, содержащего результат вызова работы.
`short`	`sync_scope()` Определяет, как далеко запрос должен прогрессировать прежде, чем управление возвращается клиенту.

- Деталь метода
  - request_id
```
int request_id()
```
    Возвращает идентификатор, который однозначно определяет активную последовательность запроса/ответа. Как только последовательность запроса/ответа завершается, этот ID может быть снова использован. Отметьте, что этот идентификатор не является тем же самым как GIOP request_id. Если GIOP является транспортным используемым механизмом, то эти ID могут очень хорошо быть тем же самым, но это не гарантируется, ни требуется.
  - работа
```
String operation()
```
    Возвращает имя вызываемой работы.
  - параметры
```
Parameter[] arguments()
```
    Возвращает массив Parameter объекты, содержа параметры на вызываемой работе. Если не будет никаких параметров, то этот атрибут будет нулевым массивом длины.
    Не все среды обеспечивают доступ к параметрам. С Java переносимая привязка, например, параметры не доступны. В этих средах, когда к этому атрибуту получают доступ, NO_RESOURCES будет брошен со стандартным незначительным кодом 1.
    Отметьте: Параметры доступны для вызовов DSI/DII.
    
    Броски:
    
    NO_RESOURCES - брошенный, если параметры не доступны.
    См. Также:
    PortableInterceptor пакет комментирует для ограничений / нереализованные функции
  - исключения
```
TypeCode[] exceptions()
```
    Возвращает массив TypeCode объекты, описывающие TypeCodes пользовательских исключений, которые может выдать этот вызов работы. Если не будет никаких пользовательских исключений, то это возвратит нулевой массив длины.
    Не все среды обеспечивают доступ к списку исключения. С Java переносимая привязка, например, список исключения не доступен. В этих средах, когда к этому атрибуту получают доступ, NO_RESOURCES будет брошен со стандартным незначительным кодом 1.
    Отметьте: Исключения доступны для вызовов DSI/DII.
    
    Броски:
    
    NO_RESOURCES - брошенный, если исключения не доступны.
    См. Также:
    PortableInterceptor пакет комментирует для ограничений / нереализованные функции
  - контексты
```
String[] contexts()
```
    Возвращает массив String объекты, описывающие контексты, которые можно передать этому вызову работы. Если не будет никаких контекстов, то это возвратит нулевой массив длины.
    Не все среды обеспечивают доступ к списку контекста. С Java переносимая привязка, например, список контекста не доступен. В этих средах, когда к этому атрибуту получают доступ, NO_RESOURCES будет брошен со стандартным незначительным кодом 1.
    Отметьте: Контексты доступны для вызовов DSI/DII.
    
    Броски:
    
    NO_RESOURCES - брошенный, если контексты не доступны.
    См. Также:
    PortableInterceptor пакет комментирует для ограничений / нереализованные функции
  - operation_context
```
String[] operation_context()
```
    Возвращает массив String объекты, содержащие контексты, отправляемые по запросу.
    Не все среды обеспечивают доступ к контексту. С Java переносимая привязка, например, контекст не доступен. В этих средах, когда к этому атрибуту получают доступ, NO_RESOURCES будет брошен со стандартным незначительным кодом 1.
    Отметьте: operation_context доступно для вызовов DSI/DII.
    
    Броски:
    
    NO_RESOURCES - брошенный, если контекст работы не доступен.
    См. Также:
    PortableInterceptor пакет комментирует для ограничений / нереализованные функции
  - результат
```
Any result()
```
    Возвращает любого, содержащего результат вызова работы. Если тип возврата работы будет пустым, то этот атрибут будет любым, содержащим код типа с a TCKind значение tk_void и никакое значение.
    Не все среды обеспечивают доступ к результату. С Java переносимая привязка, например, результат не доступен. В этих средах, когда к этому атрибуту получают доступ, NO_RESOURCES будет брошен со стандартным незначительным кодом 1.
    Отметьте: Результат доступен для вызовов DSI/DII.
    
    Броски:
    
    NO_RESOURCES - брошенный, если результат не доступен.
    См. Также:
    PortableInterceptor пакет комментирует для ограничений / нереализованные функции
  - response_expected
```
boolean response_expected()
```
    Указывает, ожидается ли ответ.
    На клиенте ответ не возвращается когда response_expected ложь, таким образом, receive_reply не может быть вызван. receive_other вызывается, если исключение не происходит, когда receive_exception вызывается.
    На клиенте, в пределах send_poll, этот атрибут является истиной.
  - sync_scope
```
short sync_scope()
```
    Определяет, как далеко запрос должен прогрессировать прежде, чем управление возвращается клиенту. Это определяется в Обменивающейся сообщениями спецификации, и подходящее только когда response_expected ложь. Если response_expected истина, значение sync_scope неопределено. У этого атрибута может быть одно из следующих значений:
    - Messaging.SYNC_NONE
    - Messaging.SYNC_WITH_TRANSPORT
    - Messaging.SYNC_WITH_SERVER
    - Messaging.SYNC_WITH_TARGET
    На сервере, для всех контекстов, ответ будет создаваться из возврата целевого вызова работы, но ответ не будет возвращаться к клиенту. Хотя это не возвращается к клиенту, это действительно происходит, таким образом, нормальные точки перехвата серверной стороны сопровождаются (то есть, receive_request_service_contexts, receive_request, send_reply или send_exception).
    Для SYNC_WITH_SERVER и SYNC_WITH_TARGET, сервер действительно отсылает пустой ответ назад к клиенту прежде, чем цель будет вызвана. Этот ответ не прерывается Перехватчиками серверной стороны.
    См. Также:
    PortableInterceptor пакет комментирует для ограничений / нереализованные функции
  - reply_status
```
short reply_status()
```
    Описывает состояние результата вызова работы. Возвращаемое значение может быть одним из следующего:
    - PortableInterceptor.SUCCESSFUL
    - PortableInterceptor.SYSTEM_EXCEPTION
    - PortableInterceptor.USER_EXCEPTION
    - PortableInterceptor.LOCATION_FORWARD
    - PortableInterceptor.TRANSPORT_RETRY
    На клиенте:
    - В пределах receive_reply точка перехвата, это только возвратится SUCCESSFUL
    - В пределах receive_exception точка перехвата, это будет также SYSTEM_EXCEPTION или USER_EXCEPTION.
    - В пределах receive_other точка перехвата, это будет любым из: SUCCESSFUL, LOCATION_FORWARD, или TRANSPORT_RETRY. SUCCESSFUL означает асинхронный запрос, возвращенный успешно. LOCATION_FORWARD средства, с которыми возвратился ответ LOCATION_FORWARD как его состояние. TRANSPORT_RETRY средства, что транспортный механизм, обозначенный повторная попытка - ответ GIOP с состоянием NEEDS_ADDRESSING_MODE, например.
    На сервере:
    - В пределах send_reply точка перехвата, это только будет SUCCESSFUL.
    - В пределах send_exception точка перехвата, это будет также SYSTEM_EXCEPTION или USER_EXCEPTION.
    - В пределах send_other точка перехвата, этот атрибут будет любым из: SUCCESSFUL, или LOCATION_FORWARD. SUCCESSFUL означает асинхронный запрос, возвращенный успешно. LOCATION_FORWARD средства, с которыми возвратился ответ LOCATION_FORWARD как его состояние.
    См. Также:
    SUCCESSFUL, SYSTEM_EXCEPTION, USER_EXCEPTION, LOCATION_FORWARD, TRANSPORT_RETRY
  - forward_reference
```
Object forward_reference()
```
    Содержит объект, к которому запрос будет передан, если reply_status атрибут LOCATION_FORWARD. Это неопределенно, произойдет ли переданный запрос фактически.
  - get_slot
```
Any get_slot(int id)
             throws InvalidSlot
```
    Возвращает данные из данного слота PortableInterceptor.Current это в пределах запроса.
    Если данный слот не был установлен, то любой, содержащий код типа с a TCKind значение tk_null возвращается.
    
    Параметры:
    id - SlotId из слота, который должен быть возвращен.
    
    Возвраты:
    Данные слота, в форме любого, полученного с данным идентификатором.
    
    Броски:
    
    InvalidSlot - брошенный, если ID не определяет выделенный слот.
    См. Также:
    Current
  - get_request_service_context
```
ServiceContext get_request_service_context(int id)
```
    Возвращает копию контекста службы с данным ID, который связывается с запросом.
    
    Параметры:
    id - IOP.ServiceId из контекста службы, который должен быть возвращен.
    
    Возвраты:
    IOP.ServiceContext полученный с данным идентификатором.
    
    Броски:
    
    BAD_PARAM - брошенный со стандартным незначительным кодом 26, если контекст службы запроса не содержит запись для того ID.
  - get_reply_service_context
```
ServiceContext get_reply_service_context(int id)
```
    Возвращает копию контекста службы с данным ID, который связывается с ответом.
    
    Параметры:
    id - IOP.ServiceId из контекста службы, который должен быть возвращен.
    
    Возвраты:
    IOP.ServiceContext полученный с данным идентификатором.
    
    Броски:
    
    BAD_PARAM - брошенный со стандартным незначительным кодом 26, если контекст службы запроса не содержит запись для того ID.

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

Интерфейсный RequestInfoOperations

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

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

request_id

работа

параметры

исключения

контексты

operation_context

результат

response_expected

sync_scope

reply_status

forward_reference

get_slot

get_request_service_context

get_reply_service_context