JavaTM Platform
Standard Ed. 6

java.rmi.activation
인터페이스 ActivationSystem

모든 슈퍼 인터페이스:
Remote


public interface ActivationSystem
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)

JavaTM Platform
Standard Ed. 6

버그의 보고와 기능의 요청
한층 더 자세한 API 레퍼런스 및 개발자 문서에 대해서는,Java SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms . Documentation Redistribution Policy 도 참조해 주세요.