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()
Определяет, как далеко запрос должен прогрессировать прежде, чем управление возвращается клиенту.
|
int request_id()
request_id
. Если GIOP является транспортным используемым механизмом, то эти ID могут очень хорошо быть тем же самым, но это не гарантируется, ни требуется.String operation()
Parameter[] arguments()
Parameter
объекты, содержа параметры на вызываемой работе. Если не будет никаких параметров, то этот атрибут будет нулевым массивом длины. Не все среды обеспечивают доступ к параметрам. С Java переносимая привязка, например, параметры не доступны. В этих средах, когда к этому атрибуту получают доступ, NO_RESOURCES
будет брошен со стандартным незначительным кодом 1.
Отметьте: Параметры доступны для вызовов DSI/DII.
NO_RESOURCES
- брошенный, если параметры не доступны.PortableInterceptor
пакет комментирует для ограничений / нереализованные функцииTypeCode[] exceptions()
TypeCode
объекты, описывающие TypeCode
s пользовательских исключений, которые может выдать этот вызов работы. Если не будет никаких пользовательских исключений, то это возвратит нулевой массив длины. Не все среды обеспечивают доступ к списку исключения. С Java переносимая привязка, например, список исключения не доступен. В этих средах, когда к этому атрибуту получают доступ, NO_RESOURCES
будет брошен со стандартным незначительным кодом 1.
Отметьте: Исключения доступны для вызовов DSI/DII.
NO_RESOURCES
- брошенный, если исключения не доступны.PortableInterceptor
пакет комментирует для ограничений / нереализованные функцииString[] contexts()
String
объекты, описывающие контексты, которые можно передать этому вызову работы. Если не будет никаких контекстов, то это возвратит нулевой массив длины. Не все среды обеспечивают доступ к списку контекста. С Java переносимая привязка, например, список контекста не доступен. В этих средах, когда к этому атрибуту получают доступ, NO_RESOURCES
будет брошен со стандартным незначительным кодом 1.
Отметьте: Контексты доступны для вызовов DSI/DII.
NO_RESOURCES
- брошенный, если контексты не доступны.PortableInterceptor
пакет комментирует для ограничений / нереализованные функцииString[] operation_context()
String
объекты, содержащие контексты, отправляемые по запросу. Не все среды обеспечивают доступ к контексту. С Java переносимая привязка, например, контекст не доступен. В этих средах, когда к этому атрибуту получают доступ, NO_RESOURCES будет брошен со стандартным незначительным кодом 1.
Отметьте: operation_context
доступно для вызовов DSI/DII.
NO_RESOURCES
- брошенный, если контекст работы не доступен.PortableInterceptor
пакет комментирует для ограничений / нереализованные функцииAny result()
TCKind
значение tk_void
и никакое значение. Не все среды обеспечивают доступ к результату. С Java переносимая привязка, например, результат не доступен. В этих средах, когда к этому атрибуту получают доступ, NO_RESOURCES
будет брошен со стандартным незначительным кодом 1.
Отметьте: Результат доступен для вызовов DSI/DII.
NO_RESOURCES
- брошенный, если результат не доступен.PortableInterceptor
пакет комментирует для ограничений / нереализованные функцииboolean response_expected()
На клиенте ответ не возвращается когда response_expected
ложь, таким образом, receive_reply
не может быть вызван. receive_other
вызывается, если исключение не происходит, когда receive_exception
вызывается.
На клиенте, в пределах send_poll
, этот атрибут является истиной.
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
, сервер действительно отсылает пустой ответ назад к клиенту прежде, чем цель будет вызвана. Этот ответ не прерывается серверными Перехватчиками.
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
Object forward_reference()
reply_status
атрибут LOCATION_FORWARD
. Это неопределенно, произойдет ли переданный запрос фактически.Any get_slot(int id) throws InvalidSlot
PortableInterceptor.Current
это в пределах запроса. Если данный слот не был установлен, то любой, содержащий код типа с a TCKind
значение tk_null
возвращается.
id
- SlotId
из слота, который должен быть возвращен.InvalidSlot
- брошенный, если ID не определяет выделенный слот.Current
ServiceContext get_request_service_context(int id)
id
- IOP.ServiceId
из контекста службы, который должен быть возвращен.IOP.ServiceContext
полученный с данным идентификатором.BAD_PARAM
- брошенный со стандартным незначительным кодом 26, если контекст службы запроса не содержит запись для того ID.ServiceContext get_reply_service_context(int id)
id
- IOP.ServiceId
из контекста службы, который должен быть возвращен.IOP.ServiceContext
полученный с данным идентификатором.BAD_PARAM
- брошенный со стандартным незначительным кодом 26, если контекст службы запроса не содержит запись для того ID.
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2013, Oracle и/или его филиалы. Все права защищены.
Проект сборка-b92