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 가 일의가 됩니다.