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 () 이 오퍼레이션 호출에 의해 슬로우 될 가능성이 있는 유저 예외의 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

public int request_id()

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

operation

public String  operation()

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

arguments

public Parameter [] arguments()

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

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

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

예외:

NO_RESOURCES - 인수를 이용할 수 없는 경우에 슬로우 되는

관련 항목:

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

exceptions

public TypeCode [] exceptions()

이 오퍼레이션 호출에 의해 슬로우 될 가능성이 있는 유저 예외의 TypeCode 를 기술하는 TypeCode 오브젝트의 배열을 돌려줍니다. 유저 예외가 없는 경우는 길이 0 의 배열을 돌려줍니다.

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

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

예외:

NO_RESOURCES - 예외를 이용할 수 없는 경우에 슬로우 되는

관련 항목:

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

contexts

public String [] contexts()

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

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

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

예외:

NO_RESOURCES - 문맥을 이용할 수 없는 경우에 슬로우 되는

관련 항목:

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

operation_context

public String [] operation_context()

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

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

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

예외:

NO_RESOURCES - 오퍼레이션 문맥을 이용할 수 없는 경우에 슬로우 되는

관련 항목:

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

result

public Any  result()

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

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

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

예외:

NO_RESOURCES - 결과를 이용할 수 없는 경우에 슬로우 되는

관련 항목:

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

response_expected

public boolean response_expected()

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

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

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

sync_scope

public 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

public 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

public Object  forward_reference()

reply_status 속성이 LOCATION_FORWARD 인 경우는 요구의 전송처가 되는 오브젝트를 저장합니다. 전송 된 요구가 실제로 실행될지 어떨지는 모릅니다.

get_slot

public Any  get_slot(int id)
             throws InvalidSlot 

요구의 스코프내에 있는 PortableInterceptor.Current 의 지정의 슬롯으로부터 데이터를 돌려줍니다.

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

파라미터:

id - 돌려주어지는 슬롯의 SlotId

반환값:

지정의 ID 를 사용해 취득된 any 형식의 슬롯 데이터

예외:

InvalidSlot - 이 ID 에 의해 할당하고 끝난 슬롯이 정의되어 있지 않은 경우에 슬로우 되는

관련 항목:

Current

get_request_service_context

public ServiceContext  get_request_service_context(int id)

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

파라미터:

id - 돌려주어지는 서비스 문맥의 IOP.ServiceId

반환값:

지정의 ID 를 사용해 취득된 IOP.ServiceContext

예외:

BAD_PARAM - 요구의 서비스 문맥에 그 ID 의 엔트리가 포함되지 않은 경우, 표준 마이너 코드 26 으로 슬로우 된다

get_reply_service_context

public ServiceContext  get_reply_service_context(int id)

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

파라미터:

id - 돌려주어지는 서비스 문맥의 IOP.ServiceId

반환값:

지정의 ID 를 사용해 취득된 IOP.ServiceContext

예외:

BAD_PARAM - 요구의 서비스 문맥에 그 ID 의 엔트리가 포함되지 않은 경우, 표준 마이너 코드 26 으로 슬로우 된다