RequestInfoOperations (Java Platform SE 6) - xrath.com 에서 번역됨

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM Platform
Standard Ed. 6

전의 클래스 다음의 클래스

프레임 있어 프레임 없음

개요: 상자 | 필드 | 생성자 | 메소드

상세: 필드 | 생성자 | 메소드

org.omg.PortableInterceptor
인터페이스 RequestInfoOperations

기존의 서브 인터페이스의 일람:: ClientRequestInfo , ClientRequestInfoOperations , RequestInfo , ServerRequestInfo , ServerRequestInfoOperations

public interface RequestInfoOperations

인타세프타를 액세스 할 수 있는 요구 정보입니다.

각 차단점에는, 인타세프타가 요구 정보에 액세스하기 위한 객체가 준비되어 있습니다. 클라이언트측과 서버측의 차단점은 다른 정보에 관계하고 있기 (위해)때문에, 2 개의 정보 객체가 준비되어 있습니다. 즉,ClientRequestInfo 는 클라이언트측의 차단점에게 건네져ServerRequestInfo 는 서버측의 차단점에게 건네집니다. 다만, 양쪽 모두에 공통되고 있는 정보가 있기 (위해)때문에, 어느 쪽의 객체도 공통 인터페이스 RequestInfo 를 상속합니다.

관련 항목:: ClientRequestInfo , ServerRequestInfo

메소드의 개요
`Parameter []`	`arguments ()` 불려 가는 오퍼레이션의 인수를 포함한 `Parameter` 객체의 배열을 돌려줍니다.
`String []`	`contexts ()` 이 오퍼레이션 호출로 건네받을 가능성이 있는 문맥을 기술하는 `String` 객체의 배열을 돌려줍니다.
`TypeCode []`	`exceptions ()` 이 오퍼레이션 호출에 의해 throw 될 가능성이 있는 사용자 예외의 `TypeCode` 를 기술하는 `TypeCode` 객체의 배열을 돌려줍니다.
`Object`	`forward_reference ()` `reply_status` 속성이 `LOCATION_FORWARD` 인 경우는, 요구의 전송처가 되는 객체를 포함합니다.
`ServiceContext`	`get_reply_service_context (int id)` 응답에 관련지을 수 있고 있는 지정된 ID 를 가지는 서비스 문맥의 카피를 돌려줍니다.
`ServiceContext`	`get_request_service_context (int id)` 요구에 관련지을 수 있고 있는 지정된 ID 를 가지는 서비스 문맥의 카피를 돌려줍니다.
`Any`	`get_slot (int id)` 요구의 스코프내에 있는 `PortableInterceptor.Current` 의 지정된 슬롯으로부터 데이터를 돌려줍니다.
`String []`	`operation_context ()` 이 요구로 송신되는 문맥을 포함한 `String` 객체의 배열을 돌려줍니다.
`String`	`operation ()` 불려 가는 오퍼레이션의 이름을 돌려줍니다.
`short`	`reply_status ()` 오퍼레이션 호출의 결과 상태를 기술합니다.
`int`	`request_id ()` 액티브한 요구/응답 순서를 일의에 식별하는 ID 를 돌려줍니다.
`boolean`	`response_expected ()` 응답이 예상될지 어떨지를 나타냅니다.
`Any`	`result ()` 오퍼레이션 호출의 결과를 포함하는 any 를 돌려줍니다.
`short`	`sync_scope ()` 제어가 클라이언트에 돌려주어지기까지 요구가 전송 되는 범위를 정의합니다.

메소드의 상세

request_id

int request_id()

액티브한 요구/응답 순서를 일의에 식별하는 ID 를 돌려줍니다. 요구/응답 순서가 종료하면(자), 이 ID 는 재사용할 수 있습니다. 이 ID 와 GIOP 의 request_id 는 동일하지는 않습니다. GIOP 가 전송 기구로 사용되는 경우는, 이러한 ID 가 완전히 같게 되는 일이 있습니다만, 이것은 보증되지 않고, 또 필수이기도 하지 않습니다.

operation

String  operation()

불려 가는 오퍼레이션의 이름을 돌려줍니다.

arguments

Parameter [] arguments()

불려 가는 오퍼레이션의 인수를 포함한 Parameter 객체의 배열을 돌려줍니다. 인수가 없는 경우, 이 속성은 길이 0 의 배열이 됩니다.

모든 환경에서 인수를 이용할 수 있는 것은 아닙니다. 예를 들어, Java 휴대용 바인딩을 사용하면(자), 인수는 이용할 수 없게 됩니다. 이러한 환경에서 이 속성에 액세스 하면(자), 표준 마이너 코드 1 이 설정된 NO_RESOURCES 가 throw 됩니다.

주:DSI/DII 호출에는 인수를 이용할 수 있습니다.

예외:: NO_RESOURCES - 인수를 이용할 수 없는 경우에 throw 되는
관련 항목:: PortableInterceptor 패키지의 기존의 제한/구현되어 있지 않은 메소드에 대한 코멘트

exceptions

TypeCode [] exceptions()

이 오퍼레이션 호출에 의해 throw 될 가능성이 있는 사용자 예외의 TypeCode 를 기술하는 TypeCode 객체의 배열을 돌려줍니다. 사용자 예외가 없는 경우는, 길이 0 의 배열을 돌려줍니다.

모든 환경에서 예외 리스트를 이용할 수 있는 것은 아닙니다. 예를 들어, Java 휴대용 바인딩을 사용하면(자), 예외 리스트는 이용할 수 없게 됩니다. 이러한 환경에서 이 속성에 액세스 하면(자), 표준 마이너 코드 1 이 설정된 NO_RESOURCES 가 throw 됩니다.

주:DSI/DII 호출에는 예외를 이용할 수 있습니다.

예외:: NO_RESOURCES - 예외를 이용할 수 없는 경우에 throw 되는
관련 항목:: PortableInterceptor 패키지의 기존의 제한/구현되어 있지 않은 메소드에 대한 코멘트

contexts

String [] contexts()

이 오퍼레이션 호출로 건네받을 가능성이 있는 문맥을 기술하는 String 객체의 배열을 돌려줍니다. 문맥이 없는 경우는, 길이 0 의 배열을 돌려줍니다.

모든 환경에서 문맥 리스트를 이용할 수 있는 것은 아닙니다. 예를 들어, Java 휴대용 바인딩을 사용하면(자), 문맥 리스트는 이용할 수 없게 됩니다. 이러한 환경에서 이 속성에 액세스 하면(자), 표준 마이너 코드 1 이 설정된 NO_RESOURCES 가 throw 됩니다.

주:DSI/DII 호출에는 문맥을 이용할 수 있습니다.

예외:: NO_RESOURCES - 문맥을 이용할 수 없는 경우에 throw 되는
관련 항목:: PortableInterceptor 패키지의 기존의 제한/구현되어 있지 않은 메소드에 대한 코멘트

operation_context

String [] operation_context()

이 요구로 송신되는 문맥을 포함한 String 객체의 배열을 돌려줍니다.

모든 환경에서 문맥을 이용할 수 있는 것은 아닙니다. 예를 들어, Java 휴대용 바인딩을 사용하면(자), 문맥은 이용할 수 없게 됩니다. 이러한 환경에서 이 속성에 액세스 하면(자), 표준 마이너 코드 1 이 설정된 NO_RESOURCES 가 throw 됩니다.

주:DSI/DII 호출에는 operation_context 를 이용할 수 있습니다.

예외:: NO_RESOURCES - 오퍼레이션 문맥을 이용할 수 없는 경우에 throw 되는
관련 항목:: PortableInterceptor 패키지의 기존의 제한/구현되어 있지 않은 메소드에 대한 코멘트




 
result
Any  result()

오퍼레이션 호출의 결과를 포함하는 any 를 돌려줍니다. 오퍼레이션의 반환값의 형태가 void 의 경우, 이 속성은 TCKind 치가 tk_void 로 설정된 값이 없는 형태 코드를 포함한 any 가 됩니다.  
 
모든 환경에서 결과를 이용할 수 있는 것은 아닙니다. 예를 들어, Java 휴대용 바인딩을 사용하면(자), 결과는 이용할 수 없게 됩니다. 이러한 환경에서 이 속성에 액세스 하면(자), 표준 마이너 코드 1 이 설정된 NO_RESOURCES 가 throw 됩니다.
 

주:DSI/DII 호출에는 결과를 이용할 수 있습니다. 



예외:
NO_RESOURCES - 결과를 이용할 수 없는 경우에 throw 되는
관련 항목:

     PortableInterceptor 패키지의 
     기존의 제한/구현되어 있지 않은 메소드에 대한 코멘트 




 
response_expected
boolean response_expected()

응답이 예상될지 어떨지를 나타냅니다.  
 
클라이언트에서는,response_expected 가 false 때는 응답이 돌려주어지지 않기 때문에,receive_reply 를 호출할 수가 없습니다. 예외가 throw 되지 않는 경우는 receive_other 이 불려 가 예외가 throw 되는 경우는 receive_exception 가 불려 갑니다.  
 

클라이언트의 send_poll 내에서는, 이 속성은 true 입니다.







 
sync_scope
short sync_scope()

제어가 클라이언트에 돌려주어지기까지 요구가 전송 되는 범위를 정의합니다. 이것은, Messaging 스펙으로 정의되어response_expected 가 false 의 경우에만 관계가 있습니다. response_expected 가 true 의 경우,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 의 경우, 서버는 타겟이 불려 가기 전에, 빈 상태(empty)의 응답을 클라이언트에 돌려 보냅니다. 이 응답은, 서버측의 인타세프타에 의해 차단되지 않습니다.


관련 항목:

     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 는, 전송 기구가 재시행 (NEEDS_ADDRESSING_MODE 라고 하는 상태의 GIOP 응답등)을 지시한 것을 의미합니다.

서버측:

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 의 지정된 슬롯으로부터 데이터를 돌려줍니다.

지정된 슬롯이 설정되어 있지 않은 경우는,TCKind 치가 tk_null 로 설정된 형태 코드를 포함한 any 가 돌려주어집니다.

파라미터:: id - 반환되는 슬롯의 SlotId
반환값:: 지정된 ID 를 사용해 취득된 any 형식의 슬롯 데이터
예외:: InvalidSlot - 이 ID 에 의해 할당하고 끝난 슬롯이 정의되어 없는 경우에 throw 되는
관련 항목:: Current

get_request_service_context

ServiceContext  get_request_service_context(int id)

요구에 관련지을 수 있고 있는 지정된 ID 를 가지는 서비스 문맥의 카피를 돌려줍니다.

파라미터:: id - 반환되는 서비스 문맥의 IOP.ServiceId
반환값:: 지정된 ID 를 사용해 취득되었다 IOP.ServiceContext
예외:: BAD_PARAM - 요구의 서비스 문맥에 그 ID 의 엔트리가 포함되지 않은 경우, 표준 마이너 코드 26 으로 throw 된다

get_reply_service_context

ServiceContext  get_reply_service_context(int id)

응답에 관련지을 수 있고 있는 지정된 ID 를 가지는 서비스 문맥의 카피를 돌려줍니다.

파라미터:: id - 반환되는 서비스 문맥의 IOP.ServiceId
반환값:: 지정된 ID 를 사용해 취득되었다 IOP.ServiceContext
예외:: BAD_PARAM - 요구의 서비스 문맥에 그 ID 의 엔트리가 포함되지 않은 경우, 표준 마이너 코드 26 으로 throw 된다

개요