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

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 에 유효하지 않은지, 경합 하고 있는지, 실행되어 있지 않다 관리 액션을 필요로 하고 있는 경우에 throw 된다

find_POA

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

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

ThreadPolicy  create_thread_policy(ThreadPolicyValue  value)

이러한 오퍼레이션은 각각, 지정된 값을 가지는 정책 객체에의 참조를 돌려줍니다.

파라미터:

value - 정책형

반환값:

ThreadPolcy 객체

create_lifespan_policy

LifespanPolicy  create_lifespan_policy(LifespanPolicyValue  value)

이러한 오퍼레이션은 각각, 지정된 값을 가지는 정책 객체에의 참조를 돌려줍니다.

파라미터:

value - 정책형

반환값:

LifespanPolicy 객체

create_id_uniqueness_policy

IdUniquenessPolicy  create_id_uniqueness_policy(IdUniquenessPolicyValue  value)

이러한 오퍼레이션은 각각, 지정된 값을 가지는 정책 객체에의 참조를 돌려줍니다.

파라미터:

value - 정책형

반환값:

IdUniquenessPolicy 객체

create_id_assignment_policy

IdAssignmentPolicy  create_id_assignment_policy(IdAssignmentPolicyValue  value)

이러한 오퍼레이션은 각각, 지정된 값을 가지는 정책 객체에의 참조를 돌려줍니다.

파라미터:

value - 정책형

반환값:

IdAssignmentPolicy 객체

create_implicit_activation_policy

ImplicitActivationPolicy  create_implicit_activation_policy(ImplicitActivationPolicyValue  value)

이러한 오퍼레이션은 각각, 지정된 값을 가지는 정책 객체에의 참조를 돌려줍니다.

파라미터:

value - 정책형

반환값:

ImplicitActivationPolicy 객체

create_servant_retention_policy

ServantRetentionPolicy  create_servant_retention_policy(ServantRetentionPolicyValue  value)

이러한 오퍼레이션은 각각, 지정된 값을 가지는 정책 객체에의 참조를 돌려줍니다.

파라미터:

value - 정책형

반환값:

ServantRetentionPolicy 객체

create_request_processing_policy

RequestProcessingPolicy  create_request_processing_policy(RequestProcessingPolicyValue  value)

이러한 오퍼레이션은 각각, 지정된 값을 가지는 정책 객체에의 참조를 돌려줍니다.

파라미터:

value - 정책형

반환값:

RequestProcessingPolicy 객체

the_name

String  the_name()

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

the_parent

POA  the_parent()

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

the_children

POA [] the_children()

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

the_POAManager

POAManager  the_POAManager()

이 속성은, POA 에 관련지을 수 있었던 POA 매니저를 식별합니다.

the_activator

AdapterActivator  the_activator()

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

the_activator

void the_activator(AdapterActivator  newThe_activator)

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

get_servant_manager

ServantManager  get_servant_manager()
                                   throws WrongPolicy 

POA 의 ServantRetentionPolicy 가 RETAIN 의 경우, ServantManager 인수 (imgr)는 ServantActivator 인터페이스를 지원합니다. NON_RETAIN 정책의 경우, ServantManager 인수는 ServantLocator 인터페이스를 지원합니다. 이 인수가 nil 인지, 필요한 인터페이스를 지원하고 있지 않는 경우는, OBJ_ADAPTER 예외가 throw 됩니다.

반환값:

POA 에 관련지을 수 있었던 ServantManager, 아무것도 존재하지 않는 경우는 null

예외:

WrongPolicy - USE_SERVANT_MANAGER 정책가 지정되어 있지 않은 경우에 throw 된다

set_servant_manager

void set_servant_manager(ServantManager  imgr)
                         throws WrongPolicy 

이 조작은, POA 에 관련지을 수 있었던 디폴트의 서번트 매니저를 설정합니다. POA 가 작성된 뒤에 1 번만 호출할 수가 있습니다. 벌써 설정 끝난 서번트 매니저를 설정하려고 하면(자), BAD_INV_ORDER 예외가 throw 됩니다.

파라미터:

imgr - 디폴트로서 사용되는 서번트 매니저

예외:

WrongPolicy - USE_SERVANT_MANAGER 정책가 지정되어 있지 않은 경우에 throw 된다

get_servant

Servant  get_servant()
                    throws NoServant ,
                           WrongPolicy 

이 오퍼레이션은, POA 에 관련지을 수 있었던 디폴트의 서번트를 돌려줍니다.

반환값:

p_servant POA 에 관련지을 수 있었던 디폴트의 서번트

예외:

NoServant - POA 에 관련지을 수 있었던 디폴트의 서번트가 없는 경우에 throw 된다

WrongPolicy - USE_DEFAULT_SERVANT 정책가 정책가 지정되어 있지 않은 경우에 throw 된다

set_servant

void set_servant(Servant  p_servant)
                 throws WrongPolicy 

이 조작은, 지정된 서번트를 디폴트의 서번트로서 POA 에 등록합니다. 이 서번트는, Active Object Map 에 서번트가 발견되지 않는 모든 요구에 사용됩니다.

파라미터:

p_servant - 디폴트로서 사용되는 서번트

예외:

WrongPolicy - USE_DEFAULT_SERVANT 정책가 정책가 지정되어 있지 않은 경우에 throw 된다

activate_object

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 에 벌써 포함되고 있는 경우에 throw 된다

WrongPolicy - SYSTEM_ID 와 RETAIN 정책가 지정되어 있지 않은 경우에 throw 된다

activate_object_with_id

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 에 벌써 포함되고 있는 경우에 throw 된다

ObjectAlreadyActive - 객체가 POA 내에서 벌써 액티브하게 되어 있는 경우에 throw 된다

WrongPolicy - RETAIN 정책가 지정되어 없는 경우에 throw 된다

deactivate_object

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 정책가 지정되어 없는 경우에 throw 된다

create_reference

Object  create_reference(String  intf)
                        throws WrongPolicy 

이 오퍼레이션은, POA 에 의해 생성된 객체 ID 치와 지정된 인터페이스 리포지터리(repository) ID 를 캡슐화하는 객체 참조를 작성합니다.

파라미터:

intf - 객체 참조를 작성하기 위한 리포지터리(repository) ID

반환값:

intf 를 사용해 작성된 객체 참조

예외:

WrongPolicy - SYSTEM_ID 정책가 지정되어 없는 경우

create_reference_with_id

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 치가 생성되지 않았던 경우에 throw 된다

servant_to_id

byte[] servant_to_id(Servant  p_servant)
                     throws ServantNotActive ,
                            WrongPolicy 

이 조작에는, 다음의 4 개의 동작이 생각됩니다. 1. POA 에 UNIQUE_ID 정책가 설정되어 있어, 지정된 서번트가 액티브한 경우는, 그 서번트가 관련지을 수 있었던 객체 ID 가 돌려주어집니다. 2. 2. POA 에 IMPLICIT_ACTIVATION 정책가 설정되어 있어, POA 에 MULTIPLE_ID 정책가 지정되고 있는지, 지정된 서번트가 액티브하지 않은 경우는, POA 에 의해 생성된 객체 ID 와 그 서번트가 관련지을 수 있었던 인터페이스 ID 를 사용해 그 서번트가 기동되어 그 객체 ID 가 돌려주어집니다. 3. 3. POA 에 USE_DEFAULT_SERVANT 정책가 설정되어 지정된 서번트가 디폴트의 서번트이며, 그 디폴트의 서번트에 대한 요구를 실행하고 있을 때 이 조작이 불려 가는 경우는, 현재의 호출에 관련지을 수 있었던 객체 ID 가 돌려주어집니다. 4. 4. 상기 이외의 경우는, ServantNotActive 예외가 throw 됩니다.

파라미터:

p_servant - 객체 ID 가 반환되는 서번트

반환값:

이 서번트가 관련지을 수 있었던 객체 ID

예외:

ServantNotActive - 상기의 규칙과 정책의 편성이 채워지지 않은 경우

WrongPolicy - USE_DEFAULT_SERVANT 정책가 지정되어 있지 않은 경우, 혹은 RETAIN 정책와 UNIQUE_ID 또는 IMPLICIT_ACTIVATION 정책의 편성이 지정되어 있지 않은 경우

servant_to_reference

Object  servant_to_reference(Servant  p_servant)
                            throws ServantNotActive ,
                                   WrongPolicy 

이 POA 에 의해 조작이 발송 될 때 이외로 이 조작이 불려 가는 경우는, RETAIN 정책와 UNIQUE_ID 또는 IMPLICIT_ACTIVATION 정책의 어느 쪽인지가 필요합니다. 다음의 4 개의 동작이 생각됩니다. 1. 1. POA 에 RETAIN 와 UNIQUE_ID 의 양쪽 모두의 정책가 설정되어 있어, 지정된 서번트가 액티브한 경우는, 그 서번트를 기동하기 위한 정보를 캡슐화하고 있는 객체 참조가 돌려주어집니다. 2. 2. POA 에 RETAIN 와 IMPLICIT_ACTIVATION 의 양쪽 모두의 정책가 설정되어 있어, POA 에 MULTIPLE_ID 정책가 지정되고 있는지, 지정된 서번트가 액티브하지 않은 경우는, POA 에 의해 생성된 객체 ID 와 그 서번트가 관련지을 수 있었던 인터페이스 ID 를 사용해 그 서번트가 기동되어 대응하는 객체 참조가 돌려주어집니다. 3. 3. 지정된 서번트에 대한 요구를 실행하고 있을 때 이 메소드가 불려 가는 경우는, 현재의 호출에 관련지을 수 있었던 객체 참조가 돌려주어집니다. 4. 4. 상기 이외의 경우는, ServantNotActive 예외가 throw 됩니다.

파라미터:

p_servant - 객체 참조를 취득한다 필요가 있는 서번트

반환값:

이 서번트가 관련지을 수 있었던 객체 참조

예외:

WrongPolicy - 지정된 서번트에 대한 요구를 실행하고 있을 때 이외로 이 오퍼레이션이 불려 갈 때, 필요한 정책가 지정되어 있지 않은 경우

ServantNotActive - 상기의 정책와 규칙이 채워지지 않은 경우

reference_to_servant

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 예외가 throw 됩니다 (POA.IDL 와의 불일치에 관한 OMG 문제).

파라미터:

reference - 서번트가 반환된다 객체 참조

반환값:

객체 참조에 관련지을 수 있었던 서번트

예외:

WrongPolicy - RETAIN 정책와 USE_DEFAULT_SERVANT 정책의 어느쪽이나 지정되어 있지 않은 경우

ObjectNotActive - 서번트가 Active Object Map 에 존재하지 않는지 (RETAIN 의 경우), 디폴트의 서번트가 등록되지 않았다 (USE_DEFAULT_SERVANT 의 경우) 경우

WrongAdapter - 이 POA 인스턴스에 의해 객체 참조가 작성되지 않았던 경우

reference_to_id

byte[] reference_to_id(Object  reference)
                       throws WrongAdapter ,
                              WrongPolicy 

이 조작은, 지정된 객체 참조에 의해 캡슐화된 객체 ID 치를 돌려줍니다. 그 조작이 실행되고 있는 POA 에 의해 객체 참조가 작성되었을 경우에만 유효합니다. 그 객체 참조가 가리키는 객체가 액티브하게 되지 않아도, 이 조작은 성공합니다.

파라미터:

reference - 객체 ID 가 반환된다 필요가 있는 객체 참조

반환값:

객체 참조에 캡슐화되고 있는 객체 ID

예외:

WrongAdapter - 객체 참조가 거기로 지정된 POA 에 의해 작성되지 않았던 경우

WrongPolicy - 향후의 기능확장에 대비해 선언되고 있다

id_to_servant

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

Object  id_to_reference(byte[] oid)
                       throws ObjectNotActive ,
                              WrongPolicy 

지정된 객체 ID 를 가지는 객체가 현재 액티브하게 되어 있는 경우는, 그 객체를 기동하기 위한 정보를 캡슐화하고 있는 객체 참조가 돌려주어집니다.

파라미터:

oid - 객체 참조가 반환된다 객체의 ID

반환값:

객체 참조

예외:

ObjectNotActive - 객체 ID 치가 POA 로 액티브하게 되지 않은 경우

WrongPolicy - RETAIN 정책가 없는 경우

id

byte[] id()

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

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