org.omg.PortableServer
인터페이스 ServantLocatorOperations

모든 슈퍼 인터페이스:

ServantManagerOperations

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

ServantLocator

기존의 구현 클래스의 일람:

_ServantLocatorStub , ServantLocatorPOA

public interface ServantLocatorOperations
extends ServantManagerOperations 

POA 에 NON_RETAIN 정책가 지정되고 있을 때는, 서번트 매니저로서 ServantLocator 가 사용됩니다. POA 는 이 서번트 매니저가 돌려주는 서번트가 1 개의 요구인 만큼 사용되는 것을 인식하고 있기 (위해)때문에, 서번트 매니저의 오퍼레이션에 추가 정보를 제공할 수 있어 서번트 매니저의 오퍼레이션의 페어는 제휴해 ServantActivator 와는 다른 처리를 실행할 수 있는 경우가 있습니다. POA 가 preinvoke 에 의해 반환된 서번트에 대한 오퍼레이션 호출을 실행한 직후에 ServantLocator 인터페이스를 사용했을 때는, 그 서번트에 대해서 postinvoke 를 호출해, 특히 ObjectId 치와 Servant 치를 파라미터로서 건네줍니다. 이 기능은, POA 에 관련지을 수 있었던 객체의 각 요구가 강제적으로 서번트 매니저를 개입시켜 행해지도록(듯이) 하는 경우에 사용됩니다.

메소드의 개요

void	postinvoke (byte[] oid, POA adapter, String operation, Object the_cookie, Servant the_servant) 이 오퍼레이션은, 서번트가 요구를 완료했을 때에 반드시 불려 갑니다.
Servant	preinvoke (byte[] oid, POA adapter, String operation, CookieHolder the_cookie) 이 오퍼레이션은, preinvoke 가 불려 가는 원인이 된 요구를 처리하기 위한 서번트를 취득하는 경우에 사용됩니다.

메소드의 상세

preinvoke

Servant  preinvoke(byte[] oid,
                  POA  adapter,
                  String  operation,
                  CookieHolder  the_cookie)
                  throws ForwardRequest 

이 오퍼레이션은, preinvoke 가 불려 가는 원인이 된 요구를 처리하기 위한 서번트를 취득하는 경우에 사용됩니다.

파라미터:

oid - 요구의 대상이 된 객체에 관련지을 수 있었다 객체 ID

adapter - 객체가 기동된다 POA 의 객체 참조

operation - 오퍼레이션의 이름

the_cookie - postinvoke 의 호출시에 사용된다 서번트 매니저에 의해 설정할 수 있다 불투명한 값

반환값:

착신 요구를 처리하기 위한 서번트

예외:

ForwardRequest - 현재의 요구와 거기에 계속되는 요구를 그 예외의 forward_reference 멤버에게 나타났다 객체에 전달할 책임이 있는 것을 ORB 에 통지한다

postinvoke

void postinvoke(byte[] oid,
                POA  adapter,
                String  operation,
                Object  the_cookie,
                Servant  the_servant)

이 오퍼레이션은, 서번트가 요구를 완료했을 때에 반드시 불려 갑니다.

파라미터:

oid - 요구의 대상이 된 객체에 관련지을 수 있었다 객체 ID

adapter - 객체가 액티브하게 되어 있었다 POA 의 객체 참조

the_cookie - preinvoke 에 의해 설정되었다 데이터를 포함한 불투명한 값

the_servant - 객체에 관련지을 수 있다 서번트에게로의 참조