java.rmi.activation
클래스 Activatable

java.lang.Object 
  java.rmi.server.RemoteObject 
      java.rmi.server.RemoteServer 
          java.rmi.activation.Activatable

모든 구현된 인터페이스:

Serializable, Remote

public abstract class Activatable
extends RemoteServer 

영속적인 액세스를 필요로 해, 시스템으로부터 시작할 수 있는 리모트 객체를 지원 합니다.

생성자 및 static exportObject 메서드의 경우, export 하는 리모트 객체의 스텁는 UnicastRemoteObject 로 설명한 방법으로 취득됩니다.

도입된 버전 :

1.2

관련 항목:

직렬화 된 형식

필드 개요

클래스 java.rmi.server. RemoteObject 로부터 상속된 필드

ref

생성자 개요

protected	Activatable (ActivationID id, int port) 지정된 포트상에서 객체를 시작 또는 export 하기 위해서 사용하는 생성자 입니다.
protected	Activatable (ActivationID id, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) 지정된 포트상에서 객체를 시작 또는 export 하기 위해서 사용하는 생성자 입니다.
protected	Activatable (String location, MarshalledObject data, boolean restart, int port) 지정된 포트에 객체를 등록 및 export 하기 위해서 사용하는 생성자 입니다.
protected	Activatable (String location, MarshalledObject data, boolean restart, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) 지정된 포트에 객체를 등록 및 export 하기 위해서 사용하는 생성자 입니다.

메서드 개요

static Remote	exportObject (Remote obj, ActivationID id, int port) 시작 가능한 리모트 객체를 RMI 런타임에 export 하는 것으로써, 착신 호출의 접수에 객체를 사용할 수 있도록 합니다.
static Remote	exportObject (Remote obj, ActivationID id, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) 시작 가능한 리모트 객체를 RMI 런타임에 export 하는 것으로써, 착신 호출의 접수에 객체를 사용할 수 있도록 합니다.
static ActivationID	exportObject (Remote obj, String location, MarshalledObject data, boolean restart, int port) exportObject 메서드는 Activatable 클래스를 확장하지 않는 「시작 가능한」객체로부터 명시적으로 호출되는 일이 있습니다.
static ActivationID	exportObject (Remote obj, String location, MarshalledObject data, boolean restart, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) exportObject 메서드는 Activatable 클래스를 확장하지 않는 「시작 가능한」객체로부터 명시적으로 호출되는 일이 있습니다.
protected ActivationID	getID () 객체의 시작 식별자를 리턴합니다.
static boolean	inactive (ActivationID id) 대응하는 시작 id 객체가 현재 정지하고 있는 것을 시스템에 통지합니다.
static Remote	register (ActivationDesc desc) 시작 가능한 리모트 객체의 객체 기술자를 등록해, 요구에 응해 리모트 객체를 시작할 수 있도록 합니다.
static boolean	unexportObject (Remote obj, boolean force) RMI 런타임으로부터 리모트 객체 obj를 삭제합니다.
static void	unregister (ActivationID id) id에 관련한 시작 기술자의 등록을 취소합니다.

클래스 java.rmi.server. RemoteServer 로부터 상속된 메서드

getClientHost, getLog, setLog

클래스 java.rmi.server. RemoteObject 로부터 상속된 메서드

equals, getRef, hashCode, toString, toStub

클래스 java.lang. Object 로부터 상속된 메서드

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

생성자 상세

Activatable

protected Activatable(String  location,
                      MarshalledObject  data,
                      boolean restart,
                      int port)
               throws ActivationException,

                      RemoteException 

지정된 포트에 객체를 등록 및 export 하기 위해서 사용하는 생성자 입니다. port=0인 경우는 익명 포트가 선택됩니다.이 클래스의 구상 서브 클래스는 최초의 구축시에 객체를 등록 및 export 하기 위해서 이 생성자를 호출할 필요가 있습니다. 시작 가능한 객체를 구축하면, 리모트 객체가 시작 시스템에 「등록」되어 RMI 런타임에 「export」됩니다. port=0인 경우는 익명 포트가 사용됩니다. 이것에 의해 리모트 객체는 클라이언트로부터의 착신 호출의 접수에 사용할 수 있습니다.

파라미터:

location - 객체가 사용하는 클래스의 위치

data - 객체의 초기화 데이터

port - 객체의 export처의 포트. port=0인 경우는 익명 포트가 사용되는

restart - true인 경우는 activator가 재시작했을 때, 또는 갑자기 의 크래쉬 후에 객체의 시작 그룹을 재시작했을 때에 객체도 시작된다. false인 경우는 객체는 요구에 응해 시작된다. restart를 true로 지정해도, 새로운 등록 객체를 최초로 곧 시작하는 것은 아니다. 초기 시작은 곧바로 하행 깨지지 않는다

예외:

ActivationException - 객체의 등록이 실패했을 경우

RemoteException - 다음의 어느 쪽인지가 실패했을 경우. a) 시작 시스템에의 객체의 등록. b) RMI 런타임에의 객체의 export

도입된 버전 :

1.2

Activatable

protected Activatable(String  location,
                      MarshalledObject  data,
                      boolean restart,
                      int port,
                      RMIClientSocketFactory  csf,
                      RMIServerSocketFactory  ssf)
               throws ActivationException,

                      RemoteException 

지정된 포트에 객체를 등록 및 export 하기 위해서 사용하는 생성자 입니다. port=0인 경우는 익명 포트가 선택됩니다.

이 클래스의 구상 서브 클래스는 최초의 구축시에 객체를 등록 및 export 하기 위해서 이 생성자를 호출할 필요가 있습니다. 시작 가능한 객체를 구축하면, 리모트 객체가 시작 시스템에 「등록」되어 RMI 런타임에 「export」됩니다. port=0인 경우는 익명 포트가 사용됩니다. 이것에 의해 리모트 객체는 클라이언트로부터의 착신 호출의 접수에 사용할 수 있습니다.

파라미터:

location - 객체가 사용하는 클래스의 위치

data - 객체의 초기화 데이터

restart - true인 경우는 activator가 재시작했을 때, 또는 갑자기 의 크래쉬 후에 객체의 시작 그룹을 재시작했을 때에 객체도 시작된다. false인 경우는 객체는 요구에 응해 시작된다. restart를 true로 지정해도, 새로운 등록 객체를 최초로 곧 시작하는 것은 아니다. 초기 시작은 곧바로 하행 깨지지 않는

port - 객체의 export처의 포트. port=0인 경우는 익명 포트가 사용되는

csf - 리모트 객체의 호출해에 사용하는 클라이언트측 소켓 팩토리

ssf - 리모트 객체 호출을 수신하는 서버측 소켓 팩토리

예외:

ActivationException - 객체의 등록이 실패했을 경우

RemoteException - 다음의 어느 쪽인지가 실패했을 경우. a) 시작 시스템에의 객체의 등록. b) RMI 런타임에의 객체의 export

도입된 버전 :

1.2

Activatable

protected Activatable(ActivationID  id,
                      int port)
               throws RemoteException 

지정된 포트상에서 객체를 시작 또는 export 하기 위해서 사용하는 생성자 입니다. 「시작 가능한」리모트 객체에는 아래의 2개의 인수를 가지는 생성자가 필요합니다.

• 객체의 시작 식별자 (ActivationID)
• 객체의 초기화 데이터 (MarshalledObject)

이 클래스의 구상 서브 클래스는 전술한 생성자를 통해서 시작될 때, 이 생성자를 호출할 필요가 있습니다. 시작 가능한 객체를 구축하면, 지정된 port 상의 RMI 런타임에 리모트 객체가 export 되어 클라이언트로부터의 착신 호출의 접수에 사용할 수 있게 됩니다.

파라미터:

id - 객체의 시작 식별자

port - 객체의 export처의 포트 번호

예외:

RemoteException - RMI 런타임에의 객체의 export가 실패했을 경우

도입된 버전 :

1.2

Activatable

protected Activatable(ActivationID  id,
                      int port,
                      RMIClientSocketFactory  csf,
                      RMIServerSocketFactory  ssf)
               throws RemoteException 

지정된 포트상에서 객체를 시작 또는 export 하기 위해서 사용하는 생성자 입니다. 「시작 가능한」리모트 객체에는 아래의 2개의 인수를 가지는 생성자가 필요합니다.

• 객체의 시작 식별자 (ActivationID)
• 객체의 초기화 데이터 (MarshalledObject)

이 클래스의 구상 서브 클래스는 전술한 생성자를 통해서 시작될 때, 이 생성자를 호출할 필요가 있습니다. 시작 가능한 객체를 구축하면, 지정된 port 상의 RMI 런타임에 리모트 객체가 export 되어 클라이언트로부터의 착신 호출의 접수에 사용할 수 있게 됩니다.

파라미터:

id - 객체의 시작 식별자

port - 객체의 export처의 포트 번호

csf - 리모트 객체의 호출해에 사용하는 클라이언트측 소켓 팩토리

ssf - 리모트 객체 호출을 수신하는 서버측 소켓 팩토리

예외:

RemoteException - RMI 런타임에의 객체의 export가 실패했을 경우

도입된 버전 :

1.2

메서드의 상세

getID

protected ActivationID  getID()

객체의 시작 식별자를 리턴합니다. 이 메서드는 서브 클래스만이 객체의 식별자를 취득할 수 있도록 보호되고 있습니다.

반환값:

객체의 시작 식별자

도입된 버전 :

1.2

register

public static Remote  register(ActivationDesc  desc)
                       throws UnknownGroupException,

                              ActivationException,

                              RemoteException 

시작 가능한 리모트 객체의 객체 기술자를 등록해, 요구에 응해 리모트 객체를 시작할 수 있도록 합니다.

파라미터:

desc - 객체의 기술자

반환값:

시작 가능한 리모트 객체가 사용하는 스텁

예외:

UnknownGroupException - desc에 있는 그룹 ID가 시작 시스템에 등록되지 않은 경우

ActivationException - 시작 시스템이 동작하고 있지 않는 경우

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

도입된 버전 :

1.2

inactive

public static boolean inactive(ActivationID  id)
                        throws UnknownObjectException,

                               ActivationException,

                               RemoteException 

대응하는 시작 id 객체가 현재 정지하고 있는 것을 시스템에 통지합니다. 객체가 현재 시작중인 경우, 그 객체는 RMI 런타임으로부터 「안 export」되고 (보류중, 혹은 진행중의 호출이 없는 경우만), 이후의 착신 호출을 수신할 수 없게 됩니다. 이 호출은 VM ActivationGroup에 객체가 정지하고 있는 것을 통지해, ActivationGroup는 해당하는 ActivationMonitor에 통지를 실시합니다. 이 호출이 정상적으로 완료했을 경우, activator에의 후속의 시작 요구에 의해 객체가 다시 시작됩니다. 이 조작은 객체가 시작중에서 만나도, 안 export 끝난 경우는 true를 리턴합니다.

파라미터:

id - 객체의 시작 식별자

반환값:

처리가 성공했을 경우는 true. 객체가 시작중에서 만나도, 안 export가 끝난 상태인지, export중이며, 보류중 혹은 실행중의 호출이 없는 경우, 처리는 성공한다. 객체에 보류중 혹은 실행중의 호출이 있어, 객체를 종료할 수 없는 경우는 false

예외:

UnknownObjectException - 객체가 불명한 경우. 이미 정지하고 있는 경우도 있다

ActivationException - 그룹이 동작하고 있지 않는 경우

RemoteException - 호출 통지 모니터가 실패했을 경우

도입된 버전 :

1.2

unregister

public static void unregister(ActivationID  id)
                       throws UnknownObjectException,

                              ActivationException,

                              RemoteException 

id에 관련한 시작 기술자의 등록을 취소합니다. 그 id를 사용해 객체를 시작할 수 없게 됩니다.

파라미터:

id - 객체의 시작 식별자

예외:

UnknownObjectException - 객체 (id)가 불명한 경우

ActivationException - 시작 시스템이 동작하고 있지 않는 경우

RemoteException - 시작 시스템에의 리모트 호출이 실패했을 경우

도입된 버전 :

1.2

exportObject

public static ActivationID  exportObject(Remote  obj,
                                        String  location,
                                        MarshalledObject  data,
                                        boolean restart,
                                        int port)
                                 throws ActivationException,

                                        RemoteException 

exportObject 메서드는 Activatable 클래스를 확장하지 않는 「시작 가능한」객체로부터 명시적으로 호출되는 일이 있습니다. 이 호출로 a) 지정된 location 및 data로 구축된, 객체의 시작 기술자를 시작 시스템에 등록하는 것으로써, 객체를 시작 가능하게 하거나 b) 리모트 객체 obj를, 지정된 포트에 export 하거나 합니다. port=0인 경우는 익명 포트가 선택됩니다. 객체가 일단 export 되면, RMI 착신 호출을 받을 수가 있습니다.

obj가 Activatable 클래스를 확장하는 경우는 최초의 생성자가 이 메서드를 호출하므로 이 메서드의 명시적인 호출은 불필요합니다.

파라미터:

obj - export 대상의 객체

location - 객체의 코드의 위치

data - 객체의 bootstrap 데이터

restart - true인 경우는 activator가 재시작했을 때, 또는 갑자기 의 크래쉬 후에 객체의 시작 그룹을 재시작했을 때에 객체도 시작된다. false인 경우는 객체는 요구에 응해 시작된다. restart를 true로 지정해도, 새로운 등록 객체를 최초로 곧 시작하는 것은 아니다. 초기 시작은 곧바로 하행 깨지지 않는

port - 객체의 export처의 포트. port=0인 경우는 익명 포트가 사용된다

반환값:

시작 시스템이 잘못한 그룹인 경우에 기술자 desc를 등록했을 때에 취득한 시작 식별자

예외:

ActivationException - 그룹이 정지하고 있는 경우

RemoteException - 객체의 등록 혹은 export가 실패했을 경우

도입된 버전 :

1.2

exportObject

public static ActivationID  exportObject(Remote  obj,
                                        String  location,
                                        MarshalledObject  data,
                                        boolean restart,
                                        int port,
                                        RMIClientSocketFactory  csf,
                                        RMIServerSocketFactory  ssf)
                                 throws ActivationException,

                                        RemoteException 

exportObject 메서드는 Activatable 클래스를 확장하지 않는 「시작 가능한」객체로부터 명시적으로 호출되는 일이 있습니다. 이 호출로 a) 지정된 location 및 data로 구축된, 객체의 시작 기술자를 시작 시스템에 등록하는 것으로써, 객체를 시작 가능하게 하거나 b) 리모트 객체 obj를, 지정된 포트에 export 하거나 합니다. port=0인 경우는 익명 포트가 선택됩니다. 객체가 일단 export 되면, RMI 착신 호출을 받을 수가 있습니다.

obj가 Activatable 클래스를 확장하는 경우는 최초의 생성자가 이 메서드를 호출하므로 이 메서드의 명시적인 호출은 불필요합니다.

파라미터:

obj - export 대상의 객체

location - 객체의 코드의 위치

data - 객체의 bootstrap 데이터

restart - true인 경우는 activator가 재시작했을 때, 또는 갑자기 의 크래쉬 후에 객체의 시작 그룹을 재시작했을 때에 객체도 시작된다. false인 경우는 객체는 요구에 응해 시작된다. restart를 true로 지정해도, 새로운 등록 객체를 최초로 곧 시작하는 것은 아니다. 초기 시작은 곧바로 하행 깨지지 않는

port - 객체의 export처의 포트. port=0인 경우는 익명 포트가 사용되는

csf - 리모트 객체의 호출해에 사용하는 클라이언트측 소켓 팩토리

ssf - 리모트 객체 호출을 수신하는 서버측 소켓 팩토리

반환값:

시작 시스템이 잘못한 그룹인 경우에 기술자 desc를 등록했을 때에 취득한 시작 식별자

예외:

ActivationException - 그룹이 정지하고 있는 경우

RemoteException - 객체의 등록 혹은 export가 실패했을 경우

도입된 버전 :

1.2

exportObject

public static Remote  exportObject(Remote  obj,
                                  ActivationID  id,
                                  int port)
                           throws RemoteException 

시작 가능한 리모트 객체를 RMI 런타임에 export 하는 것으로써, 착신 호출의 접수에 객체를 사용할 수 있도록 합니다. port값이 0인 경우, 객체는 익명 포트에 export 됩니다.

시작시에 exportObject 메서드는 Activatable 클래스를 확장하지 않는 「시작 가능한」객체로부터 명시적으로 호출되는 일이 있습니다. Activatable을 확장하는 객체이면, 이 메서드를 직접 호출할 필요는 없습니다. 이 메서드는 전술의 2번째의 생성자에 호출합니다. 또, 서브 클래스가 특별한 시작 생성자로부터 이 생성자를 호출하는 일이 있습니다.

파라미터:

obj - 구현된 리모트 객체

id - 객체의 시작 식별자

port - 객체의 export처의 포트. port=0인 경우는 익명 포트가 사용된다

반환값:

시작 가능한 리모트 객체가 사용하는 스텁

예외:

RemoteException - 객체의 export에 실패했을 경우

도입된 버전 :

1.2

exportObject

public static Remote  exportObject(Remote  obj,
                                  ActivationID  id,
                                  int port,
                                  RMIClientSocketFactory  csf,
                                  RMIServerSocketFactory  ssf)
                           throws RemoteException 

시작 가능한 리모트 객체를 RMI 런타임에 export 하는 것으로써, 착신 호출의 접수에 객체를 사용할 수 있도록 합니다. port값이 0인 경우, 객체는 익명 포트에 export 됩니다.

시작시에 exportObject 메서드는 Activatable 클래스를 확장하지 않는 「시작 가능한」객체로부터 명시적으로 호출되는 일이 있습니다. Activatable을 확장하는 객체이면, 이 메서드를 직접 호출할 필요는 없습니다. 이 메서드는 전술의 2번째의 생성자에 호출합니다. 또, 서브 클래스가 특별한 시작 생성자로부터 이 생성자를 호출하는 일이 있습니다.

파라미터:

obj - 구현된 리모트 객체

id - 객체의 시작 식별자

port - 객체의 export처의 포트. port=0인 경우는 익명 포트가 사용되는

csf - 리모트 객체의 호출해에 사용하는 클라이언트측 소켓 팩토리

ssf - 리모트 객체 호출을 수신하는 서버측 소켓 팩토리

반환값:

시작 가능한 리모트 객체가 사용하는 스텁

예외:

RemoteException - 객체의 export에 실패했을 경우

도입된 버전 :

1.2

unexportObject

public static boolean unexportObject(Remote  obj,
                                     boolean force)
                              throws NoSuchObjectException 

RMI 런타임으로부터 리모트 객체 obj를 삭제합니다. 삭제가 성공하면, 객체는 RMI 입접속호의 접수를 위해서 사용할 수 없게 됩니다. 파라미터 force가 true 로 설정되어 있으면, 리모트 객체에의 보류 상태의 호출이 있는 경우나, 진행중의 호출이 있는 경우에서도, 객체는 강제적으로 안 export 됩니다. 파라미터 force가 false 로 설정되어 있으면, 객체에의 보류중 또는 진행중의 호출이 없는 경우에게만, 객체가 안 export 됩니다.

파라미터:

obj - export 되고 리모트 객체

force - true인 경우는 보류중 또는 진행중의 호출이 있어도, 객체의 export를 해제한다. false인 경우에는 보류중 또는 진행중의 호출이 없을 때에만, 객체는 안 export 된다

반환값:

조작이 성공했을 경우는 true, 그렇지 않은 경우는 false

예외:

NoSuchObjectException - 리모트 객체가 현재 export되어 있지 않은 경우

도입된 버전 :

1.2