java.rmi.activation
인터페이스 Activator

모든 슈퍼 인터페이스:

Remote

public interface Activator
extends Remote 

Activator는 리모트 객체의 시작을 간단하게 합니다. 절단 되어 가고 있는 리모트 참조는 activator의 activate 메서드를 호출해, 시작 가능한 리모트 객체에의 「라이브 (live)」참조를 취득하려고 합니다. 시작의 요구를 받아들인 activator는 시작 식별자 id 시작 기술자를 찾고 나서, 그룹을 결정합니다. 그 그룹에서는 시작하는 객체가newInstance 호출을 통해서 그룹의 ActivationInstantiator를 사용해, 객체의 재작성을 개시합니다. activator는 필요에 따라서 시작 그룹의 실행을 개시합니다. 예를 들어 특정의 그룹 식별자의 시작 그룹이 아직 실행중이 아닌 경우는 activator가 그 그룹의 VM 실행을 개시합니다.

Activator는 그룹과 그 그룹내의 객체를 등록하는 방법을 제공하는 ActivationSystem 및, 시작중 혹은 정지중의 객체와 정지중의 그룹의 정보를 얻는 ActivationMonitor와 밀접하게 제휴합니다.

activator는 시작 그룹이 실패했을 경우의 감시 및 검출을 실시해, 그룹 및 그 그룹내의 시작중의 객체에의 무효인 리모트 참조를 삭제할 수 있도록 합니다.

도입된 버전 :

1.2

관련 항목:

ActivationInstantiator, ActivationGroupDesc, ActivationGroupID

메서드 개요

MarshalledObject

activate (ActivationID id, boolean force) 시작 식별자 id에 관련한 객체를 시작합니다.

메서드의 상세

activate

MarshalledObject  activate(ActivationID  id,
                          boolean force)
                          throws ActivationException,

                                 UnknownObjectException,

                                 RemoteException 

시작 식별자 id에 관련한 객체를 시작합니다. 그 객체가 시작하고 있는 것을 activator가 인식하고 있어, force값이 false인 경우는 「라이브 (live)」참조의 스텁이 즉석에서 호출해 바탕으로 리턴됩니다 . 그렇지 않은 경우는 대응하는 리모트 객체가 시작하고 있는 것을 activator가 모르면, activator는 이전에 등록된 시작 기술자의 정보를 사용해, 객체를 시작하는 장소가 되는 그룹 (VM)을 결정합니다. 객체의 그룹 기술자에게 대응하는 ActivationInstantiator가 이미 존재하는 경우, activator는 시작 그룹의 newInstance를 호출해, 게다가 객체의 ID 및 기술자를 건네줍니다.

객체의 그룹 기술자가 사용하는 시작 그룹이 아직 존재하지 않는 경우는 activator는 child process의 생성등에의해 ActivationInstantiator 실행을 개시합니다. ActivationSystem activeGroup 메서드를 통해서 그 시작 그룹의 참조를 나타내는 콜백을 시작 그룹이 받으면, activator는 시작 인스탄시에이타의 newInstance 메서드를 호출해, 보류중의 각 시작 요구를 시작 그룹에 전송 합니다. 요구의 결과인 정렬화 된 리모트 객체 참조를 스텁 로서 호출해 측에 리턴합니다.

activator는 리모트 객체가 아니고 「정렬화 되었다」객체를 받으므로 그 객체의 코드를 로드할 필요는 없고, 객체의 분산 가비지 컬렉션에 관여할 필요도 없습니다. activator가 리모트 객체에의 강참조를 보관 유지하고 있는 경우, 보통 의 분산 가비지 컬렉션 도구 아래에서도, activator는 객체를 가비지 컬렉션으로부터 지킵니다.

파라미터:

id - 시작되는 객체의 시작 식별자

force - true인 경우는 activator는 그룹에 접속해 리모트 객체의 참조를 취득한다. 그렇지 않은 경우는 캐쉬에 들어가 있는 값을 반환값으로서 사용할 수 있다

반환값:

정렬화 된 형식의 리모트 객체 (스텁)

예외:

ActivationException - 객체의 시작에 실패했을 경우

UnknownObjectException - 객체가 불명한 (등록되지 않았다) 경우

RemoteException - 리모트 호출이 실패했을 경우

도입된 버전 :

1.2