java.rmi.activation
클래스 Activatable

java.lang.Object 
  |
  +--java.rmi.server.RemoteObject 
        |
        +--java.rmi.server.RemoteServer 
              |
              +--java.rmi.activation.Activatable

모든 구현 인터페이스:

Remote , Serializable

public abstract class Activatable

extends RemoteServer

영속적인 액세스를 필요로 해, 시스템으로부터 기동할 수 있는 리모트 오브젝트를 서포트합니다.

도입된 버젼:

1.2

관련 항목:

직렬화 된 형식

필드의 개요

클래스 java.rmi.server. RemoteObject 에서 상속받은 필드

ref

생성자의 개요

protected	Activatable (ActivationID id, int port) 지정된 포토상에서 오브젝트를 기동 또는 export 하기 위해서 사용하는 constructor 입니다.
protected	Activatable (ActivationID id, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) 지정된 포토상에서 오브젝트를 기동 또는 export 하기 위해서 사용하는 constructor 입니다.
protected	Activatable (String location, MarshalledObject data, boolean restart, int port) 지정된 포토에 오브젝트를 등록 및 export 하기 위해서 사용하는 constructor 입니다.
protected	Activatable (String location, MarshalledObject data, boolean restart, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) 지정된 포토에 오브젝트를 등록 및 export 하기 위해서 사용하는 constructor 입니다.

메소드의 개요

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 하기 위해서 사용하는 constructor 입니다. port=0 의 경우는 익명 포토가 선택됩니다. 이 클래스의 구상 서브 클래스는 최초의 구축시에 오브젝트를 등록 및 export 하기 위해서, 이 constructor를 호출할 필요가 있습니다. 기동 가능한 오브젝트를 구축하면(자), 리모트 오브젝트가 기동 시스템에 「등록」되어 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 하기 위해서 사용하는 constructor 입니다. port=0 의 경우는 익명 포토가 선택됩니다.

이 클래스의 구상 서브 클래스는 최초의 구축시에 오브젝트를 등록 및 export 하기 위해서, 이 constructor를 호출할 필요가 있습니다. 기동 가능한 오브젝트를 구축하면(자), 리모트 오브젝트가 기동 시스템에 「등록」되어 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 하기 위해서 사용하는 constructor 입니다. 「기동 가능한」리모트 오브젝트에는 이하의 2 개의 인수를 가지는 constructor 이 필요합니다.

• 오브젝트의 기동 식별자 (ActivationID)
• 오브젝트의 초기화 데이터 (MarshalledObject)

이 클래스의 구상 서브 클래스는 전술한 constructor를 통해서 기동될 때, 이 constructor를 호출할 필요가 있습니다. 기동 가능한 오브젝트를 구축하면(자), 지정된 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 하기 위해서 사용하는 constructor 입니다. 「기동 가능한」리모트 오브젝트에는 이하의 2 개의 인수를 가지는 constructor 이 필요합니다.

• 오브젝트의 기동 식별자 (ActivationID)
• 오브젝트의 초기화 데이터 (MarshalledObject)

이 클래스의 구상 서브 클래스는 전술한 constructor를 통해서 기동될 때, 이 constructor를 호출할 필요가 있습니다. 기동 가능한 오브젝트를 구축하면(자), 지정된 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 클래스를 확장하는 경우는 최초의 constructor 이 이 메소드를 호출하므로, 이 메소드의 명시적인 호출은 불필요합니다.

파라미터:

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 클래스를 확장하는 경우는 최초의 constructor 이 이 메소드를 호출하므로, 이 메소드의 명시적인 호출은 불필요합니다.

파라미터:

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 번째의 constructor 에 불려 갑니다. 또, 서브 클래스가, 특별한 기동 constructor 으로부터 이 constructor를 호출하는 일이 있습니다.

파라미터:

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 번째의 constructor 에 불려 갑니다. 또, 서브 클래스가, 특별한 기동 constructor 으로부터 이 constructor를 호출하는 일이 있습니다.

파라미터:

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