JavaTM 2
Platform
Std.  Ed.  v1. 4.0

org.omg.PortableServer
인터페이스 POAOperations

기존의 서브 인터페이스의 일람:
POA

public interface POAOperations

POA 오브젝트는 오브젝트의 콜렉션의 구현을 관리합니다. POA 는 오브젝트 ID 에 의해 식별되는 오브젝트의 이름 공간을 서포트합니다. 또, POA 의 이름 공간도 제공합니다. POA 는 기존의 POA 의 아이로서 작성되어 거기에 따라 루트 POA 로 시작되는 계층이 형성됩니다. POA 오브젝트는 다른 프로세스에 export 하거나 ORB::object_to_string 를 사용해 외부화하거나 하지 말아 주세요.


메소드의 개요
 void activate_object_with_id (byte[] id, Servant  p_servant)
          이 오퍼레이션은 지정된 오브젝트 ID 와 지정된 서번트와의 관련짓고를 Active Object Map 에 넣습니다.
 byte[] activate_object (Servant  p_servant)
          이 오퍼레이션은 오브젝트 ID 를 생성해, 그 오브젝트 ID 와 지정된 서번트를 Active Object Map 에 넣습니다.
 IdAssignmentPolicy create_id_assignment_policy (IdAssignmentPolicyValue  value)
          이러한 오퍼레이션은 각각, 지정된 값을 가지는 폴리시 오브젝트에의 참조를 돌려줍니다.
 IdUniquenessPolicy create_id_uniqueness_policy (IdUniquenessPolicyValue  value)
          이러한 오퍼레이션은 각각, 지정된 값을 가지는 폴리시 오브젝트에의 참조를 돌려줍니다.
 ImplicitActivationPolicy create_implicit_activation_policy (ImplicitActivationPolicyValue  value)
          이러한 오퍼레이션은 각각, 지정된 값을 가지는 폴리시 오브젝트에의 참조를 돌려줍니다.
 LifespanPolicy create_lifespan_policy (LifespanPolicyValue  value)
          이러한 오퍼레이션은 각각, 지정된 값을 가지는 폴리시 오브젝트에의 참조를 돌려줍니다.
 POA create_POA (String  adapter_name, POAManager  a_POAManager, Policy [] policies)
          이 오퍼레이션은 새로운 POA 를 타겟 POA 의 아이로서 작성합니다.
 Object create_reference_with_id (byte[] oid, String  intf)
          이 오퍼레이션은 지정된 오브젝트 ID 와 인터페이스 리포지터리(repository) ID 의 값을 캡슐화하는 오브젝트 참조를 작성합니다.
 Object create_reference (String  intf)
          이 오퍼레이션은 POA 에 의해 생성된 오브젝트 ID 치와 지정된 인터페이스 리포지터리(repository) ID 를 캡슐화하는 오브젝트 참조를 작성합니다.
 RequestProcessingPolicy create_request_processing_policy (RequestProcessingPolicyValue  value)
          이러한 오퍼레이션은 각각, 지정된 값을 가지는 폴리시 오브젝트에의 참조를 돌려줍니다.
 ServantRetentionPolicy create_servant_retention_policy (ServantRetentionPolicyValue  value)
          이러한 오퍼레이션은 각각, 지정된 값을 가지는 폴리시 오브젝트에의 참조를 돌려줍니다.
 ThreadPolicy create_thread_policy (ThreadPolicyValue  value)
          이러한 오퍼레이션은 각각, 지정된 값을 가지는 폴리시 오브젝트에의 참조를 돌려줍니다.
 void deactivate_object (byte[] oid)
          이 오퍼레이션에 의해, oid 파라미터로 지정된 ObjectId 가 종료됩니다.
 void destroy (boolean etherealize_objects, boolean wait_for_completion)
          이 오퍼레이션은 POA 와 그 하위 POA 를 모두 파기합니다.
 POA find_POA (String  adapter_name, boolean activate_it)
          타겟 POA 가 지정된 이름 (타겟 POA 를 기준으로 하고 있다)을 가지는 아이 POA 의 부모인 경우는 그 아이 POA 가 돌려주어집니다.
 ServantManager get_servant_manager ()
          POA 의 ServantRetentionPolicy 가 RETAIN 의 경우, ServantManager 인수 (imgr)는 ServantActivator 인터페이스를 서포트합니다.
 Servant get_servant ()
          이 오퍼레이션은 POA 에 관련지을 수 있었던 디폴트의 서번트를 돌려줍니다.
 Object id_to_reference (byte[] oid)
          지정된 오브젝트 ID 를 가지는 오브젝트가 현재 액티브하게 되어 있는 경우는 그 오브젝트를 기동하기 위한 정보를 캡슐화하고 있는 오브젝트 참조가 돌려주어집니다.
 Servant id_to_servant (byte[] oid)
          POA 에 RETAIN 폴리시가 설정되어 있어, 지정의 ObjectId 가 Active Object Map 에 포함되어 있는 경우는 Active Object Map 내의 해당 오브젝트에 관련지을 수 있었던 서번트를 돌려줍니다.
 byte[] id ()
          POA 가 작성되는 과정에서, POA 의 일의의 ID 를 돌려줍니다.
 byte[] reference_to_id (Object  reference)
          이 오퍼레이션은 지정의 오브젝트 참조에 의해 캡슐화된 오브젝트 ID 치를 돌려줍니다.
 Servant reference_to_servant (Object  reference)
          POA 에 RETAIN 폴리시가 설정되어 있어, 지정의 오브젝트가 Active Object Map 에 포함되어 있는 경우는 Active Object Map 내의 해당 오브젝트에 관련지을 수 있었던 서번트를 돌려줍니다.
 byte[] servant_to_id (Servant  p_servant)
          이 오퍼레이션에는 다음의 4 개의 동작이 생각됩니다.
 Object servant_to_reference (Servant  p_servant)
          이 POA 에 의해 오퍼레이션이 디스팟치 될 때 이외로 이 오퍼레이션이 불려 가는 경우는 RETAIN 폴리시와 UNIQUE_ID 또는 IMPLICIT_ACTIVATION 폴리시의 어느 쪽인지가 필요합니다.
 void set_servant_manager (ServantManager  imgr)
          이 오퍼레이션은 POA 에 관련지을 수 있었던 디폴트의 서번트 매니저를 설정합니다.
 void set_servant (Servant  p_servant)
          이 오퍼레이션은 지정된 서번트를 디폴트의 서번트로서 POA 에 등록합니다.
 AdapterActivator the_activator ()
          이 속성은 POA 에 관련지을 수 있었던 어댑터 activator를 식별합니다.
 void the_activator (AdapterActivator  newThe_activator)
          이 속성은 POA 에 관련지을 수 있었던 어댑터 activator를 식별합니다.
 POA [] the_children ()
          이 속성은 POA 의 모든 아이 POA 로부터 완성되는 현재의 아이 POA 세트를 식별합니다.
 String the_name ()
          이 속성은 POA 를, 그 부모를 기준으로 해 식별합니다.
 POA the_parent ()
          이 속성은 POA 의 부모를 식별합니다.
 POAManager the_POAManager ()
          이 속성은 POA 에 관련지을 수 있었던 POA 매니저를 식별합니다.
 

메소드의 상세

create_POA

public POA  create_POA(String  adapter_name,
                      POAManager  a_POAManager,
                      Policy [] policies)
               throws AdapterAlreadyExists ,
                      InvalidPolicy 
이 오퍼레이션은 새로운 POA 를 타겟 POA 의 아이로서 작성합니다.

파라미터:
adapter_name - 같은 친 POA 를 가지는 다른 POA 를 기준으로 해 새로운 POA 를 식별하는
a_POAManager - 새로운 POA 에 관련지을 수 있는 POA 매니저를 나타내는
policies - POA 에 관련지어, 그 동작을 제어하기 위한 폴리시 오브젝트를 나타낸다
예외:
AdapterAlreadyExists - 타겟 POA 가 지정된 이름을 가지는 아이 POA 를 벌써 보유하고 있는 것을 나타낸다
InvalidPolicy - 폴리시 오브젝트의 어떤 것인가가 ORB 에 유효하지 않은지 경합 하고 있는지 실행되어 있지 않은 관리 액션을 필요로 하고 있는 경우에 슬로우 된다

find_POA

public POA  find_POA(String  adapter_name,
                    boolean activate_it)
             throws AdapterNonExistent 
타겟 POA 가 지정된 이름 (타겟 POA 를 기준으로 하고 있다)을 가지는 아이 POA 의 부모인 경우는 그 아이 POA 가 돌려주어집니다.

파라미터:
adapter_name - 검색 대상의 POA 명
activate_it - 지정된 이름을 가지는 POA 가 존재하지 않을 때에, activate_it 파라미터의 값이 TRUE 인 경우는 타겟 POA 의 AdapterActivator (존재하는 경우)가 불려 간다
반환값:
POA 가 존재하는지 AdapterActivator 에 의해 기동되고 있는 경우는 그 POA
AdapterNonExistent

destroy

public void destroy(boolean etherealize_objects,
                    boolean wait_for_completion)
이 오퍼레이션은 POA 와 그 하위 POA 를 모두 파기합니다. 하위 POA 가 모두 파기되고 나서 (재귀적으로), 그것들을 포함 하고 있던 POA 가 파기됩니다. 그처럼 해 파괴된 POA (즉, 그 이름을 가지는 POA)는 같은 프로세스내에 나중에 재작성할 수가 있습니다.

파라미터:
etherealize_objects - 서번트 매니저에 대한 etherealize 오퍼레이션을 호출할 필요가 있을지 어떨지를 나타내는 플래그
wait_for_completion - POA 와 그 아이 POA 가 기동 요구와 령화 (etherealization)가 완료할 때까지 대기할 필요가 있을지 어떨지를 나타내는 플래그

create_thread_policy

public ThreadPolicy  create_thread_policy(ThreadPolicyValue  value)
이러한 오퍼레이션은 각각, 지정된 값을 가지는 폴리시 오브젝트에의 참조를 돌려줍니다.

파라미터:
value - 폴리시형
반환값:
ThreadPolcy 오브젝트

create_lifespan_policy

public LifespanPolicy  create_lifespan_policy(LifespanPolicyValue  value)
이러한 오퍼레이션은 각각, 지정된 값을 가지는 폴리시 오브젝트에의 참조를 돌려줍니다.

파라미터:
value - 폴리시형
반환값:
LifespanPolicy 오브젝트

create_id_uniqueness_policy

public IdUniquenessPolicy  create_id_uniqueness_policy(IdUniquenessPolicyValue  value)
이러한 오퍼레이션은 각각, 지정된 값을 가지는 폴리시 오브젝트에의 참조를 돌려줍니다.

파라미터:
value - 폴리시형
반환값:
IdUniquenessPolicy 오브젝트

create_id_assignment_policy

public IdAssignmentPolicy  create_id_assignment_policy(IdAssignmentPolicyValue  value)
이러한 오퍼레이션은 각각, 지정된 값을 가지는 폴리시 오브젝트에의 참조를 돌려줍니다.

파라미터:
value - 폴리시형
반환값:
IdAssignmentPolicy 오브젝트

create_implicit_activation_policy

public ImplicitActivationPolicy  create_implicit_activation_policy(ImplicitActivationPolicyValue  value)
이러한 오퍼레이션은 각각, 지정된 값을 가지는 폴리시 오브젝트에의 참조를 돌려줍니다.

파라미터:
value - 폴리시형
반환값:
ImplicitActivationPolicy 오브젝트

create_servant_retention_policy

public ServantRetentionPolicy  create_servant_retention_policy(ServantRetentionPolicyValue  value)
이러한 오퍼레이션은 각각, 지정된 값을 가지는 폴리시 오브젝트에의 참조를 돌려줍니다.

파라미터:
value - 폴리시형
반환값:
ServantRetentionPolicy 오브젝트

create_request_processing_policy

public RequestProcessingPolicy  create_request_processing_policy(RequestProcessingPolicyValue  value)
이러한 오퍼레이션은 각각, 지정된 값을 가지는 폴리시 오브젝트에의 참조를 돌려줍니다.

파라미터:
value - 폴리시형
반환값:
RequestProcessingPolicy 오브젝트

the_name

public String  the_name()
이 속성은 POA 를, 그 부모를 기준으로 해 식별합니다. 이 이름은 POA 가 작성되었을 때에 할당할 수 있습니다.


the_parent

public POA  the_parent()
이 속성은 POA 의 부모를 식별합니다. 루트 POA 의 부모는 null 입니다.


the_children

public POA [] the_children()
이 속성은 POA 의 모든 아이 POA 로부터 완성되는 현재의 아이 POA 세트를 식별합니다. 아이 POA 세트에는 POA 의 직접적인 아이만이 포함되어 그 하위의 POA 는 포함되지 않습니다.


the_POAManager

public POAManager  the_POAManager()
이 속성은 POA 에 관련지을 수 있었던 POA 매니저를 식별합니다.


the_activator

public AdapterActivator  the_activator()
이 속성은 POA 에 관련지을 수 있었던 어댑터 activator를 식별합니다.


the_activator

public void the_activator(AdapterActivator  newThe_activator)
이 속성은 POA 에 관련지을 수 있었던 어댑터 activator를 식별합니다.


get_servant_manager

public ServantManager  get_servant_manager()
                                   throws WrongPolicy 
POA 의 ServantRetentionPolicy 가 RETAIN 의 경우, ServantManager 인수 (imgr)는 ServantActivator 인터페이스를 서포트합니다. NON_RETAIN 폴리시의 경우, ServantManager 인수는 ServantLocator 인터페이스를 서포트합니다. 이 인수가 nil 인지 필요한 인터페이스를 서포트하고 있지 않는 경우는 OBJ_ADAPTER 예외가 슬로우 됩니다.

반환값:
POA 에 관련지을 수 있었던 ServantManager, 아무것도 존재하지 않는 경우는 null
예외:
WrongPolicy - USE_SERVANT_MANAGER 폴리시가 지정되어 있지 않은 경우에 슬로우 된다

set_servant_manager

public void set_servant_manager(ServantManager  imgr)
                         throws WrongPolicy 
이 오퍼레이션은 POA 에 관련지을 수 있었던 디폴트의 서번트 매니저를 설정합니다. POA 가 작성된 뒤에 1 번만 호출할 수가 있습니다. 벌써 설정 끝난 서번트 매니저를 설정하려고 하면(자), BAD_INV_ORDER 예외가 슬로우 됩니다.

파라미터:
imgr - 디폴트로서 사용되는 서번트 매니저
예외:
WrongPolicy - USE_SERVANT_MANAGER 폴리시가 지정되어 있지 않은 경우에 슬로우 된다

get_servant

public Servant  get_servant()
                    throws NoServant ,
                           WrongPolicy 
이 오퍼레이션은 POA 에 관련지을 수 있었던 디폴트의 서번트를 돌려줍니다.

반환값:
p_servant POA 에 관련지을 수 있었던 디폴트의 서번트
예외:
NoServant - POA 에 관련지을 수 있었던 디폴트의 서번트가 없는 경우에 슬로우 된다
WrongPolicy - USE_DEFAULT_SERVANT 폴리시가 지정되어 있지 않은 경우에 슬로우 된다

set_servant

public void set_servant(Servant  p_servant)
                 throws WrongPolicy 
이 오퍼레이션은 지정된 서번트를 디폴트의 서번트로서 POA 에 등록합니다. 이 서번트는 Active Object Map 에 서번트가 발견되지 않는 모든 요구에 사용됩니다.

파라미터:
p_servant - 디폴트로서 사용되는 서번트
예외:
WrongPolicy - USE_DEFAULT_SERVANT 폴리시가 지정되어 있지 않은 경우에 슬로우 된다

activate_object

public byte[] activate_object(Servant  p_servant)
                       throws ServantAlreadyActive ,
                              WrongPolicy 
이 오퍼레이션은 오브젝트 ID 를 생성해, 그 오브젝트 ID 와 지정된 서번트를 Active Object Map 에 넣습니다.

파라미터:
p_servant - 기동하는 오브젝트에 관련지을 수 있는 서번트
반환값:
POA 에 의해 생성된 오브젝트 ID
예외:
ServantAlreadyActive - POA 에 UNIQUE_ID 폴리시가 지정되고 있을 때, 서번트가 Active Object Map 에 벌써 저장되고 있는 경우에 슬로우 된다
WrongPolicy - SYSTEM_ID 와 RETAIN 폴리시가 지정되어 있지 않은 경우에 슬로우 된다

activate_object_with_id

public void activate_object_with_id(byte[] id,
                                    Servant  p_servant)
                             throws ServantAlreadyActive ,
                                    ObjectAlreadyActive ,
                                    WrongPolicy 
이 오퍼레이션은 지정된 오브젝트 ID 와 지정된 서번트와의 관련짓고를 Active Object Map 에 넣습니다.

파라미터:
id - 기동하는 오브젝트의 오브젝트 ID
p_servant - 오브젝트에 관련지을 수 있는 서번트
예외:
ServantAlreadyActive - POA 에 UNIQUE_ID 폴리시가 지정되고 있을 때, 서번트가 Active Object Map 에 벌써 저장되고 있는 경우에 슬로우 된다
ObjectAlreadyActive - 오브젝트가 POA 내에서 벌써 액티브하게 되어 있는 경우에 슬로우 된다
WrongPolicy - RETAIN 폴리시가 지정되어 있지 않은 경우에 슬로우 된다

deactivate_object

public void deactivate_object(byte[] oid)
                       throws ObjectNotActive ,
                              WrongPolicy 
이 오퍼레이션에 의해, oid 파라미터로 지정된 ObjectId 가 종료됩니다. 종료한 ObjectId 는 그 ObjectId 의 액티브한 요구가 없어질 때까지 계속 요구를 처리합니다. 그리고, ObjectId 에 대해서 실행 떠날 수 있어 모든 요구가 완료하면(자), Active Object Map 로부터 삭제됩니다.

파라미터:
oid - 종료하는 오브젝트의 오브젝트 ID
예외:
ObjectNotActive - 지정된 oid 를 가지는 오브젝트가 Active Object Map 에 없는 경우
WrongPolicy - RETAIN 폴리시가 지정되어 있지 않은 경우에 슬로우 된다

create_reference

public Object  create_reference(String  intf)
                        throws WrongPolicy 
이 오퍼레이션은 POA 에 의해 생성된 오브젝트 ID 치와 지정된 인터페이스 리포지터리(repository) ID 를 캡슐화하는 오브젝트 참조를 작성합니다.

파라미터:
intf - 오브젝트 참조를 작성하기 위한 리포지터리(repository) ID
반환값:
intf 를 사용해 작성된 오브젝트 참조
예외:
WrongPolicy - SYSTEM_ID 폴리시가 지정되어 있지 않은 경우

create_reference_with_id

public Object  create_reference_with_id(byte[] oid,
                                       String  intf)
이 오퍼레이션은 지정된 오브젝트 ID 와 인터페이스 리포지터리(repository) ID 의 값을 캡슐화하는 오브젝트 참조를 작성합니다. 이 오퍼레이션에 의해 기동은 행해지지 않습니다. 작성된 오브젝트 참조는 클라이언트에 건네줄 수가 있습니다. 그리고, 해당하는 폴리시에 의해, 그러한 참조에 대한 그 후의 요구로, 필요가 있으면 오브젝트가 기동되거나 디폴트의 서번트가 사용 되거나 합니다.

파라미터:
oid - objref 를 작성하기 위한 오브젝트 ID
intf - objref 를 작성하기 위한 리포지터리(repository) ID
반환값:
oid 와 intf 를 사용해 작성된 오브젝트 참조
예외:
BAD_PARAM - POA 에 SYSTEM_ID 폴리시가 지정되고 있을 때, 시스템에 의해 또는 이 POA 에 대해서 오브젝트 ID 치가 생성되지 않았던 경우에 슬로우 된다

servant_to_id

public byte[] servant_to_id(Servant  p_servant)
                     throws ServantNotActive ,
                            WrongPolicy 
이 오퍼레이션에는 다음의 4 개의 동작이 생각됩니다. 1. POA 에 UNIQUE_ID 폴리시가 설정되어 있어, 지정의 서번트가 액티브한 경우는 그 서번트가 관련지을 수 있었던 오브젝트 ID 가 돌려주어집니다. 2. POA 에 IMPLICIT_ACTIVATION 폴리시가 설정되어 있어, POA 에 MULTIPLE_ID 폴리시가 지정되고 있는지 지정의 서번트가 액티브하지 않은 경우는 POA 에 의해 생성된 오브젝트 ID 와 그 서번트가 관련지을 수 있었던 인터페이스 ID 를 사용해 그 서번트가 기동되어 그 오브젝트 ID 가 돌려주어집니다. 3. POA 에 USE_DEFAULT_SERVANT 폴리시가 설정되어 지정의 서번트가 디폴트의 서번트이며, 그 디폴트의 서번트에 대한 요구를 실행하고 있을 때 이 오퍼레이션이 불려 가는 경우는 현재의 호출에 관련지을 수 있었던 오브젝트 ID 가 돌려주어집니다. 4. 상기 이외의 경우는 ServantNotActive 예외가 슬로우 됩니다.

파라미터:
p_servant - 오브젝트 ID 가 돌려주어지는 서번트
반환값:
이 서번트가 관련지을 수 있었던 오브젝트 ID
예외:
ServantNotActive - 상기의 규칙과 폴리시의 편성이 채워지지 않은 경우
WrongPolicy - USE_DEFAULT_SERVANT 폴리시가 지정되어 있지 않은 경우, 혹은 RETAIN 폴리시와 UNIQUE_ID 또는 IMPLICIT_ACTIVATION 폴리시의 편성이 지정되어 있지 않은 경우

servant_to_reference

public Object  servant_to_reference(Servant  p_servant)
                            throws ServantNotActive ,
                                   WrongPolicy 
이 POA 에 의해 오퍼레이션이 디스팟치 될 때 이외로 이 오퍼레이션이 불려 가는 경우는 RETAIN 폴리시와 UNIQUE_ID 또는 IMPLICIT_ACTIVATION 폴리시의 어느 쪽인지가 필요합니다. 다음의 4 개의 동작이 생각됩니다. 1. POA 에 RETAIN 와 UNIQUE_ID 의 양쪽 모두의 폴리시가 설정되어 있어, 지정의 서번트가 액티브한 경우는 그 서번트를 기동하기 위한 정보를 캡슐화하고 있는 오브젝트 참조가 돌려주어집니다. 2. POA 에 RETAIN 와 IMPLICIT_ACTIVATION 의 양쪽 모두의 폴리시가 설정되어 있어, POA 에 MULTIPLE_ID 폴리시가 지정되고 있는지 지정의 서번트가 액티브하지 않은 경우는 POA 에 의해 생성된 오브젝트 ID 와 그 서번트가 관련지을 수 있었던 인터페이스 ID 를 사용해 그 서번트가 기동되어 대응하는 오브젝트 참조가 돌려주어집니다. 3. 지정의 서번트에 대한 요구를 실행하고 있을 때 이 메소드가 불려 가는 경우는 현재의 호출에 관련지을 수 있었던 오브젝트 참조가 돌려주어집니다. 4. 상기 이외의 경우는 ServantNotActive 예외가 슬로우 됩니다.

파라미터:
p_servant - 오브젝트 참조를 취득할 필요가 있는 서번트
반환값:
이 서번트가 관련지을 수 있었던 오브젝트 참조
예외:
WrongPolicy - 지정의 서번트에 대한 요구를 실행하고 있을 때 이외로 이 오퍼레이션이 불려 갈 때, 필요한 폴리시가 지정되어 있지 않은 경우
ServantNotActive - 상기의 폴리시와 규칙이 채워지지 않은 경우

reference_to_servant

public Servant  reference_to_servant(Object  reference)
                             throws ObjectNotActive ,
                                    WrongPolicy ,
                                    WrongAdapter 
POA 에 RETAIN 폴리시가 설정되어 있어, 지정의 오브젝트가 Active Object Map 에 포함되어 있는 경우는 Active Object Map 내의 해당 오브젝트에 관련지을 수 있었던 서번트를 돌려줍니다. 이것에 대해, POA 에 USE_DEFAULT_SERVANT 폴리시가 설정되어 있어, 디폴트의 서번트가 POA 에 등록되어 있는 경우는 디폴트의 서번트를 돌려줍니다. 이 POA 에 의해 오브젝트 참조가 작성되지 않았던 경우는 WrongAdapter 예외가 슬로우 됩니다 (POA.IDL 와의 불일치에 관한 OMG 문제).

파라미터:
reference - 서번트가 돌려주어지는 오브젝트 참조
반환값:
오브젝트 참조에 관련지을 수 있었던 서번트
예외:
WrongPolicy - RETAIN 폴리시와 USE_DEFAULT_SERVANT 폴리시의 어느쪽이나 지정되어 있지 않은 경우
ObjectNotActive - 서번트가 Active Object Map 에 존재하지 않는지 (RETAIN 의 경우), 디폴트의 서번트가 등록되지 않은 (USE_DEFAULT_SERVANT 의 경우) 경우
WrongAdapter - 이 POA 인스턴스에 의해 오브젝트 참조가 작성되지 않았던 경우

reference_to_id

public byte[] reference_to_id(Object  reference)
                       throws WrongAdapter ,
                              WrongPolicy 
이 오퍼레이션은 지정의 오브젝트 참조에 의해 캡슐화된 오브젝트 ID 치를 돌려줍니다. 그 오퍼레이션이 실행되고 있는 POA 에 의해 오브젝트 참조가 작성되었을 경우에만 유효합니다. 그 오브젝트 참조가 가리키는 오브젝트가 액티브하게 되지 않아도, 이 오퍼레이션은 성공합니다.

파라미터:
reference - 오브젝트 ID 가 돌려주어질 필요가 있는 오브젝트 참조
반환값:
오브젝트 참조에 캡슐화되고 있는 오브젝트 ID
예외:
WrongAdapter - 오브젝트 참조가 거기로 지정된 POA 에 의해 작성되지 않았던 경우
WrongPolicy - 향후의 기능확장에 대비해 선언되고 있다

id_to_servant

public Servant  id_to_servant(byte[] oid)
                      throws ObjectNotActive ,
                             WrongPolicy 
POA 에 RETAIN 폴리시가 설정되어 있어, 지정의 ObjectId 가 Active Object Map 에 포함되어 있는 경우는 Active Object Map 내의 해당 오브젝트에 관련지을 수 있었던 서번트를 돌려줍니다. 이것에 대해, POA 에 USE_DEFAULT_SERVANT 폴리시가 설정되어 있어, 디폴트의 서번트가 POA 에 등록되어 있는 경우는 디폴트의 서번트를 돌려줍니다.

파라미터:
oid - 서번트가 돌려주어지는 오브젝트 ID
반환값:
oid 에 관련지을 수 있었던 서번트
예외:
ObjectNotActive - ObjectId 가 Active Object Map 에 존재하지 않는지 (RETAIN 폴리시의 경우), 디폴트의 서번트가 등록되지 않은 (USE_DEFAULT_SERVANT 폴리시의 경우) 경우
WrongPolicy - RETAIN 폴리시와 USE_DEFAULT_SERVANT 폴리시의 어느쪽이나 지정되어 있지 않은 경우

id_to_reference

public Object  id_to_reference(byte[] oid)
                       throws ObjectNotActive ,
                              WrongPolicy 
지정된 오브젝트 ID 를 가지는 오브젝트가 현재 액티브하게 되어 있는 경우는 그 오브젝트를 기동하기 위한 정보를 캡슐화하고 있는 오브젝트 참조가 돌려주어집니다.

파라미터:
oid - 오브젝트 참조가 돌려주어지는 오브젝트의 ID
반환값:
오브젝트 참조
예외:
ObjectNotActive - 오브젝트 ID 치가 POA 로 액티브하게 되지 않은 경우
WrongPolicy - RETAIN 폴리시가 없는 경우

id

public byte[] id()
POA 가 작성되는 과정에서, POA 의 일의의 ID 를 돌려줍니다. 이 ID 는 포타브르인타세프타로 사용됩니다.

이 ID 는 그 프로세스에 있어서의 POA 의 유효기간에 대해서 일의인 것이 프로텍션되고 있습니다. 지속적인 POA 의 경우, 다른 POA 와 같은 이름으로 같은 패스에 작성된 POA 는 동일하기 때문에, ID 도 같게 됩니다. 일시적인 POA 의 경우, 각각의 POA 가 일의가 됩니다.


JavaTM 2
Platform
Std.  Ed.  v1. 4.0

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

Java, Java 2 D, 및 JDBC 는 미국 및 그 외의 나라에 있어서의 미국 Sun Microsystems, Inc. 의 상표 혹은 등록상표입니다.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.