ActivationSystem (Java 2 Platform SE 5.0)

개요

패키지

클래스

사용

계층 트리

비추천 API

색인

헬프

Java^TM 2 Platform
Standard Ed. 5.0

이전 클래스 다음 클래스

프레임으로 프레임 없이

개요: NESTED | 필드 | constructor　　 | 메서드

상세: 필드 | constructor　　 | 메서드

java.rmi.activation
인터페이스 ActivationSystem

모든 슈퍼 인터페이스:: Remote

public interface ActivationSystem
extends Remote
extends Remote

ActivationSystem는 그룹 및 그 중에 있는 시작 가능한 객체 가운데로 시작해 두는 것을 등록하는 방법을 제공합니다. ActivationSystem 은, ActivationSystem를 사용해 등록된 객체를 시작하는 Activator 및 시작중 혹은 정지중의 객체와 정지중의 그룹의 정보를 얻는 ActivationMonitor와 밀접하게 제휴합니다.

도입된 버전 :: 1.2
관련 항목:: Activator, ActivationMonitor

필드 개요
`static int`	`SYSTEM_PORT` 시작 시스템을 찾는 포트입니다.

메서드 개요
`ActivationMonitor`	`activeGroup (ActivationGroupID id, ActivationInstantiator group, long incarnation)` 그룹이 시작중인 것을 시작 시스템에 통지하는 콜백입니다.
`ActivationDesc`	`getActivationDesc (ActivationID id)` 시작 식별자가 `id`인 객체의 시작 기술자를 리턴합니다.
`ActivationGroupDesc`	`getActivationGroupDesc (ActivationGroupID id)` 시작 그룹 식별자가 `id`인 그룹의 시작 그룹 기술자를 리턴합니다.
`ActivationGroupID`	`registerGroup (ActivationGroupDesc desc)` 시작 그룹을 등록합니다.
`ActivationID`	`registerObject (ActivationDesc desc)` 시작 기술자 `desc` 등록 및 시작 가능한 리모트 객체의 시작 식별자의 취득에 사용합니다.
`ActivationDesc`	`setActivationDesc (ActivationID id, ActivationDesc desc)` 시작 식별자가 `id`인 객체의 시작 기술자 `desc`를 설정합니다.
`ActivationGroupDesc`	`setActivationGroupDesc (ActivationGroupID id, ActivationGroupDesc desc)` 시작 그룹 식별자가 `id`인 객체의 시작 그룹 기술자 `desc`를 설정합니다.
`void`	`shutdown ()` 시작 시스템을 정지합니다.
`void`	`unregisterGroup (ActivationGroupID id)` 시작 그룹을 삭제합니다.
`void`	`unregisterObject (ActivationID id)` `ActivationSystem`로 등록된 시작 ID 및 관련한 기술자를 삭제합니다.

필드의 상세

SYSTEM_PORT

static final int SYSTEM_PORT

시작 시스템을 찾는 포트입니다.

관련 항목:: 정수 필드값

메서드의 상세

registerObject

ActivationID  registerObject(ActivationDesc  desc)
                            throws ActivationException,

                                   UnknownGroupException,

                                   RemoteException

시작 기술자 desc 등록 및 시작 가능한 리모트 객체의 시작 식별자의 취득에 사용합니다. ActivationSystem는 기술자 desc로 지정된 객체의 ActivationID (시작 식별자)를 작성해, 안정 기억 영역에 나중에 사용하기 위한 시작 기술자 및 거기에 관련한 식별자를 기록합니다. Activator가 특정의 식별자의 activate 요구를 받아들였을 경우는 지정된 식별자의 시작 기술자 (이전에 등록된 것)를 검색한 다음, 그 정보를 사용해 객체를 시작합니다.

파라미터:: desc - 객체의 시작 기술자
반환값:: 객체의 시작에 사용하는 시작 ID
예외:: ActivationException - 등록이 실패했을 경우. 예를 들어 데이타베이스 갱신의 실패; UnknownGroupException - desc에 나타난 그룹이 시스템에 등록되지 않은 경우; RemoteException - 리모트 호출이 실패했을 경우
도입된 버전 :: 1.2

unregisterObject

void unregisterObject(ActivationID  id)
                      throws ActivationException,

                             UnknownObjectException,

                             RemoteException

ActivationSystem로 등록된 시작 ID 및 관련한 기술자를 삭제합니다. 객체는 그 시작 ID 로 시작은 할 수 없게 됩니다.

파라미터:: id - 객체의 시작 ID (이전에 등록된 것)
예외:: ActivationException - 등록 해제가 실패했을 경우. 예를 들어 데이타베이스 갱신의 실패; UnknownObjectException - 객체가 불명한 (등록되지 않았다) 경우; RemoteException - 리모트 호출이 실패했을 경우
도입된 버전 :: 1.2

registerGroup

ActivationGroupID  registerGroup(ActivationGroupDesc  desc)
                                throws ActivationException,

                                       RemoteException

시작 그룹을 등록합니다. ActivationSystem로 시작 그룹을 등록하지 않으면 그 그룹에 객체를 등록할 수 없습니다.

파라미터:: desc - 그룹의 기술자
반환값:: 그룹의 식별자
예외:: ActivationException - 그룹의 등록이 실패했을 경우; RemoteException - 리모트 호출이 실패했을 경우
도입된 버전 :: 1.2

activeGroup

ActivationMonitor  activeGroup(ActivationGroupID  id,
                              ActivationInstantiator  group,
                              long incarnation)
                              throws UnknownGroupException,

                                     ActivationException,

                                     RemoteException

그룹이 시작중인 것을 시작 시스템에 통지하는 콜백입니다. 이 호출이 ActivationGroup.createGroup 메서드의 내부에서 실행되는 것으로 그룹이 시작중인 것을 ActivationSystem에 통지합니다.

파라미터:: id - 시작 그룹의 식별자; group - 그룹의 인스탄시에이타; incarnation - 그룹의 생성 번호
반환값:: 시작 그룹의 모니터
예외:: UnknownGroupException - 그룹이 미등록의 경우; ActivationException - 지정된 id에 대한 그룹이 이미 시작되고 있어 한편 그 그룹이 지정된 group와 동일하지 않은지, 혹은 그 그룹이 지정된 group와는 다른 incarnation을 가지는 경우; RemoteException - 리모트 호출이 실패했을 경우
도입된 버전 :: 1.2

unregisterGroup

void unregisterGroup(ActivationGroupID  id)
                     throws ActivationException,

                            UnknownGroupException,

                            RemoteException

시작 그룹을 삭제합니다. 시작 그룹은 이 콜백을 돌려주는 것으로 그룹을 삭제 (파기)하도록 activator에 통지합니다. 이 호출이 완료했을 경우, 그룹내에서의 객체의 등록이나 시작은 할 수 없게 됩니다. 그룹 및 거기에 관련한 객체의 정보는 모두, 시스템으로부터 삭제됩니다.

파라미터:: id - 시작 그룹의 식별자
예외:: ActivationException - 등록 해제가 실패했을 경우. 예를 들어 데이타베이스 갱신의 실패; UnknownGroupException - 그룹이 미등록의 경우; RemoteException - 리모트 호출이 실패했을 경우
도입된 버전 :: 1.2

shutdown

void shutdown()
              throws RemoteException

시작 시스템을 정지합니다. 시작 demon에 의해 생성된 그룹을 모두 파기해, 시작 demon를 종료합니다.

예외:: RemoteException - 시작 demon의 접속/정지가 실패했을 경우
도입된 버전 :: 1.2

setActivationDesc

ActivationDesc  setActivationDesc(ActivationID  id,
                                 ActivationDesc  desc)
                                 throws ActivationException,

                                        UnknownObjectException,

                                        UnknownGroupException,

                                        RemoteException

시작 식별자가 id인 객체의 시작 기술자 desc를 설정합니다. 이 변경은 다음번 객체를 시작했을 때에 유효하게 됩니다.

파라미터:: id - 시작 가능한 객체의 시작 식별자; desc - 시작 가능한 객체의 시작 기술자
반환값:: 시작 기술자의 이전의 값
예외:: UnknownGroupException - desc에 관련한 그룹이 미등록의 경우; UnknownObjectException - 시작 id가 미등록의 경우; ActivationException - 일반적인 에러. 예를 들어 로그의 갱신이 불가능한 경우; RemoteException - 리모트 호출이 실패했을 경우
도입된 버전 :: 1.2
관련 항목:: getActivationDesc(java.rmi.activation.ActivationID)

setActivationGroupDesc

ActivationGroupDesc  setActivationGroupDesc(ActivationGroupID  id,
                                           ActivationGroupDesc  desc)
                                           throws ActivationException,

                                                  UnknownGroupException,

                                                  RemoteException

시작 그룹 식별자가 id인 객체의 시작 그룹 기술자 desc를 설정합니다. 이 변경은 다음번 그룹을 시작했을 때에 유효하게 됩니다.

파라미터:: id - 시작 그룹의 시작 그룹 식별자; desc - 시작 그룹의 시작 그룹 기술자
반환값:: 시작 그룹 기술자의 이전의 값
예외:: UnknownGroupException - id에 관련한 그룹이 미등록의 경우; ActivationException - 일반적인 에러. 예를 들어 로그의 갱신이 불가능한 경우; RemoteException - 리모트 호출이 실패했을 경우
도입된 버전 :: 1.2
관련 항목:: getActivationGroupDesc(java.rmi.activation.ActivationGroupID)

getActivationDesc

ActivationDesc  getActivationDesc(ActivationID  id)
                                 throws ActivationException,

                                        UnknownObjectException,

                                        RemoteException

시작 식별자가 id인 객체의 시작 기술자를 리턴합니다.

파라미터:: id - 시작 가능한 객체의 시작 식별자
반환값:: 시작 기술자
예외:: UnknownObjectException - id가 미등록의 경우; ActivationException - 일반적인 에러; RemoteException - 리모트 호출이 실패했을 경우
도입된 버전 :: 1.2
관련 항목:: setActivationDesc(java.rmi.activation.ActivationID, java.rmi.activation.ActivationDesc)

getActivationGroupDesc

ActivationGroupDesc  getActivationGroupDesc(ActivationGroupID  id)
                                           throws ActivationException,

                                                  UnknownGroupException,

                                                  RemoteException

시작 그룹 식별자가 id인 그룹의 시작 그룹 기술자를 리턴합니다.

파라미터:: id - 그룹의 시작 그룹 식별자
반환값:: 시작 그룹 기술자
예외:: UnknownGroupException - id가 미등록의 경우; ActivationException - 일반적인 에러; RemoteException - 리모트 호출이 실패했을 경우
도입된 버전 :: 1.2
관련 항목:: setActivationGroupDesc(java.rmi.activation.ActivationGroupID, java.rmi.activation.ActivationGroupDesc)