JavaTM Platform
Standard Ed. 6

org.omg.PortableInterceptor
인터페이스 ClientRequestInfoOperations

모든 슈퍼 인터페이스:
RequestInfoOperations
기존의 서브 인터페이스의 일람:
ClientRequestInfo


public interface ClientRequestInfoOperations
extends RequestInfoOperations

클라이언트측의 요구 인타세프타를 액세스 할 수 있는 요구 정보입니다.

ClientRequestInfo 에 대한 일부의 속성이나 오퍼레이션은, 모든 차단점으로써 유효하다라고는 한정하지 않습니다. 다음의 겉(표)에, 각 속성 또는 조작의 유효성을 나타냅니다. 유효하지 않은 속성이나 조작에 액세스 하려고 하면(자), 표준 마이너 코드 14 가 설정된 BAD_INV_ORDER 가 throw 됩니다.

  send_request send_poll receive_reply receive_exception receive_other
RequestInfo 로부터 상속된다:

request_id

operation

arguments

1 아니오 아니오 아니오

exceptions

아니오

contexts

아니오

operation_context

아니오

result

아니오 아니오 아니오 아니오

response_expected

sync_scope

아니오

reply_status

아니오 아니오

forward_reference

아니오 아니오 아니오 아니오 2

get_slot

get_request_service_context

아니오

get_reply_service_context

아니오 아니오
ClientRequestInfo 고유:

target

effective_target

effective_profile

received_exception

아니오 아니오 아니오 아니오

received_exception_id

아니오 아니오 아니오 아니오

get_effective_component

아니오

get_effective_components

아니오

get_request_policy

아니오

add_request_service_context

아니오 아니오 아니오 아니오
  1. ClientRequestInfosend_request 에게 건네질 때는, 각 인수의 리스트에 in, inout, out 의 어떤 것인가의 엔트리가 있습니다만, 사용할 수 있는 것은, in 와 inout 의 인수 뿐입니다.
  2. reply_status 속성이 LOCATION_FORWARD 가 아닌 경우는, 이 속성에 액세스 하면(자), 표준 마이너 코드 14 가 설정된 BAD_INV_ORDER 가 throw 됩니다.

관련 항목:
ClientRequestInterceptor

메소드의 개요
 void add_request_service_context (ServiceContext  service_context, boolean replace)
          인타세프타가 서비스 문맥을 요구에 추가할 수 있도록(듯이) 합니다.
 TaggedProfile effective_profile ()
          요구의 송신에 사용되는 프로파일을 돌려줍니다.
 Object effective_target ()
          오퍼레이션의 호출의 대상이 되는 실제 객체를 돌려줍니다.
 TaggedComponent get_effective_component (int id)
          이 요구에 대해서 선택된 프로파일로부터, 지정된 ID 를 가지는 IOP.TaggedComponent 를 돌려줍니다.
 TaggedComponent [] get_effective_components (int id)
          이 요구에 대해서 선택된 프로파일로부터, 지정된 ID 를 가지는 모든 태그 첨부 컴퍼넌트의 배열을 돌려줍니다.
 Policy get_request_policy (int type)
          이 오퍼레이션에 대해서 유효하게 되어 있는 지정된 정책를 돌려줍니다.
 String received_exception_id ()
          클라이언트에 반환되는 예외의 리포지터리(repository) ID 를 돌려줍니다.
 Any received_exception ()
          클라이언트에 반환되는 예외를 포함하는 any 를 돌려줍니다.
 Object target ()
          오퍼레이션을 실행하기 위해서 클라이언트가 호출한 객체를 돌려줍니다.
 
인터페이스 org.omg.PortableInterceptor. RequestInfoOperations 로부터 상속된 메소드
arguments , contexts , exceptions , forward_reference , get_reply_service_context , get_request_service_context , get_slot , operation_context , operation , reply_status , request_id , response_expected , result , sync_scope
 

메소드의 상세

target

Object  target()
오퍼레이션을 실행하기 위해서 클라이언트가 호출한 객체를 돌려줍니다.

관련 항목:
effective_target()

effective_target

Object  effective_target()
오퍼레이션의 호출의 대상이 되는 실제 객체를 돌려줍니다. reply_status 가 LOCATION_FORWARD 의 경우는, 후속의 요구로,effective_target 에는 전송 된 IOR 가 포함됩니다만, 타겟은 바뀌지 않습니다.

관련 항목:
target()

effective_profile

TaggedProfile  effective_profile()
요구의 송신에 사용되는 프로파일을 돌려줍니다. 이 오퍼레이션의 객체에 대해서 위치 전송 (location forward)이 발생해, 거기에 따라서 객체의 프로파일이 변경되었을 경우, 이 프로파일은 그 위치 지정된 프로파일이 됩니다.


received_exception

Any  received_exception()
클라이언트에 반환되는 예외를 포함하는 any 를 돌려줍니다.

예외가, any 에 삽입할 수 없는 사용자 예외 (예외가 불명하거나 바인딩에 의해 TypeCode 가 제공되지 않는 등)인 경우, 이 속성은 표준 마이너 코드 1 이 설정된 시스템 예외 UNKNOWN 를 포함한 any 가 됩니다. 다만,received_exception_id 속성에서는 예외의 리포지터리(repository) ID 를 사용할 수 있습니다.

관련 항목:
received_exception_id()

received_exception_id

String  received_exception_id()
클라이언트에 반환되는 예외의 리포지터리(repository) ID 를 돌려줍니다.

관련 항목:
received_exception() , PortableInterceptor 패키지의 기존의 제한/구현되어 있지 않은 메소드에 대한 코멘트

get_effective_component

TaggedComponent  get_effective_component(int id)
이 요구에 대해서 선택된 프로파일로부터, 지정된 ID 를 가지는 IOP.TaggedComponent 를 돌려줍니다.

지정된 컴퍼넌트 ID 를 가지는 컴퍼넌트가 다수 있는 경우, 이 오퍼레이션에 의해 어느 컴퍼넌트가 돌려주어질까는 부정입니다. 그 경우는, 대신에 get_effective_components 를 호출해 주세요.

파라미터:
id - 반환되는 컴퍼넌트의 컴퍼넌트 ID
반환값:
지정의 ID 를 사용해 취득되었다 IOP.TaggedComponent
예외:
BAD_PARAM - BAD_PARAM 지정의 컴퍼넌트 ID 를 가지는 컴퍼넌트가 없는 경우, 표준 마이너 코드 28 으로 throw 되는
관련 항목:
get_effective_components(int)

get_effective_components

TaggedComponent [] get_effective_components(int id)
이 요구에 대해서 선택된 프로파일로부터, 지정된 ID 를 가지는 모든 태그 첨부 컴퍼넌트의 배열을 돌려줍니다.

파라미터:
id - 반환되는 컴퍼넌트의 컴퍼넌트 ID
반환값:
각각이 지정된 ID 를 가지는 TaggedComponent 객체의 배열
예외:
BAD_PARAM - BAD_PARAM 지정의 컴퍼넌트 ID 를 가지는 컴퍼넌트가 없는 경우, 표준 마이너 코드 28 으로 throw 되는
관련 항목:
get_effective_component(int)

get_request_policy

Policy  get_request_policy(int type)
이 오퍼레이션에 대해서 유효하게 되어 있는 지정된 정책를 돌려줍니다.

파라미터:
type - 반환되는 정책를 나타낸다 정책형
반환값:
지정의 형태를 사용해 취득된 CORBA.Policy
예외:
INV_POLICY - 이 ORB 가 지정된 형태를 지원하고 있지 않는지, 그 형태의 정책 객체가 이 Object 에 관련지을 수 있지 않기 위해(때문에), 정책형의 값이 유효하지 않은 경우, 표준 마이너 코드 1 으로 throw 되는
관련 항목:
PortableInterceptor 패키지의 기존의 제한/구현되어 있지 않은 메소드에 대한 코멘트

add_request_service_context

void add_request_service_context(ServiceContext  service_context,
                                 boolean replace)
인타세프타가 서비스 문맥을 요구에 추가할 수 있도록(듯이) 합니다.

서비스 문맥의 순서의 선언은 없습니다. 이 때문에, 추가된 순서에 표시되는 경우도 표시되지 않는 경우도 있습니다.

파라미터:
service_context - 요구에 추가된다 IOP.ServiceContext
replace - 지정된 ID 를 가지는 서비스 문맥이 벌써 존재하고 있을 때의 이 오퍼레이션의 동작을 나타낸다. false 의 경우는, 표준 마이너 코드 15 가 설정된 BAD_INV_ORDER 가 throw 된다. true 의 경우는, 기존의 서비스 문맥이 새로운 것에 치환된다

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.