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가 발생 됩니다.

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

예외:

NO_RESOURCES - 인수를 이용할 수 없는 경우에 발생되는

관련 항목:

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

exceptions

TypeCode [] exceptions()

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

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

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

예외:

NO_RESOURCES - 예외를 이용할 수 없는 경우에 발생되는

관련 항목:

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

contexts

String [] contexts()

이 오퍼레이션 호출로 건네받을 가능성이 있는 컨텍스트를 기술하는 String 객체의 배열을 리턴합니다. 컨텍스트이 없는 경우는 길이 0 배열을 리턴합니다.

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

주: DSI/DII 호출에는 컨텍스트를 이용할 수 있습니다.

예외:

NO_RESOURCES - 컨텍스트를 이용할 수 없는 경우에 발생되는

관련 항목:

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

operation_context

String [] operation_context()

이 요구로 송신되는 컨텍스트를 포함한 String 객체의 배열을 리턴합니다.

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

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

예외:

NO_RESOURCES - 오퍼레이션 컨텍스트를 이용할 수 없는 경우에 발생되는

관련 항목:

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

result

Any  result()

오퍼레이션 호출의 결과를 포함하는 any를 리턴합니다. 오퍼레이션의 반환값의 형태가 void인 경우, 이 속성은 TCKind값이 tk_void로 설정된 값이 없는 형태 코드를 포함한 any가 됩니다.

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

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

예외:

NO_RESOURCES - 결과를 이용할 수 없는 경우에 발생되는

관련 항목:

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

response_expected

boolean response_expected()

응답이 예상될지 어떨지를 나타냅니다.

클라이언트에서는 response_expected가 false 때는 응답이 돌려주고지지 않기 때문에 receive_reply를 호출할 수가 없습니다. 예외가 Throw 되지 않는 경우는 receive_other 이 불려가 예외가 발생되는 경우는 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인 경우, 서버는 타겟이 불려가기 전에 비어있는 응답을 클라이언트에 돌려 보냅니다. 이 응답은 서버측의 인타세프타에 의해 차단되지 않습니다.

관련 항목:

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에 의해 할당하고 끝난 슬롯이 정의되어 있지 않은 경우에 발생되는

관련 항목:

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 된다