|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |
java.lang.Object | +--java.rmi.server.RemoteObject | +--java.rmi.server.RemoteServer | +--java.rmi.activation.Activatable
永続的なアクセスを必要とし、システムから起動できるリモートオブジェクトをサポートします。
クラス java.rmi.server.RemoteObject から継承したフィールド |
ref |
コンストラクタの概要 | |
protected |
Activatable(ActivationID id,
int port)
指定されたポート上でオブジェクトを起動またはエクスポートするために使うコンストラクタです。 |
protected |
Activatable(ActivationID id,
int port,
RMIClientSocketFactory csf,
RMIServerSocketFactory ssf)
指定されたポート上でオブジェクトを起動またはエクスポートするために使うコンストラクタです。 |
protected |
Activatable(String location,
MarshalledObject data,
boolean restart,
int port)
指定されたポートにオブジェクトを登録およびエクスポートするために使うコンストラクタです。 |
protected |
Activatable(String location,
MarshalledObject data,
boolean restart,
int port,
RMIClientSocketFactory csf,
RMIServerSocketFactory ssf)
指定されたポートにオブジェクトを登録およびエクスポートするために使うコンストラクタです。 |
メソッドの概要 | |
static Remote |
exportObject(Remote obj,
ActivationID id,
int port)
起動可能なリモートオブジェクトを RMI ランタイムにエクスポートすることにより、着信呼び出しの受け付けにオブジェクトを使用できるようにします。 |
static Remote |
exportObject(Remote obj,
ActivationID id,
int port,
RMIClientSocketFactory csf,
RMIServerSocketFactory ssf)
起動可能なリモートオブジェクトを RMI ランタイムにエクスポートすることにより、着信呼び出しの受け付けにオブジェクトを使用できるようにします。 |
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 |
コンストラクタの詳細 |
protected Activatable(String location, MarshalledObject data, boolean restart, int port) throws ActivationException, RemoteException
location
- オブジェクトが使うクラスの位置data
- オブジェクトの初期化データport
- オブジェクトのエクスポート先のポート。port=0 の場合は匿名ポートが使用されるrestart
- true の場合は、アクティベータが再起動されるとオブジェクトも再起動される。false の場合は、オブジェクトは要求に応じて再起動されるprotected Activatable(String location, MarshalledObject data, boolean restart, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) throws ActivationException, RemoteException
このクラスの具象サブクラスは、最初の作成時にオブジェクトを登録およびエクスポートするために、このコンストラクタを呼び出す必要があります。起動可能なオブジェクトを構築すると、リモートオブジェクトが起動システムに登録され、RMI ランタイムにエクスポートされます。port=0 の場合は匿名ポートが使用されます。これによって、リモートオブジェクトはクライアントからの着信呼び出しの受け付けに使用できます。このコンストラクタで作成されたオブジェクトは、要求に応じて起動されます。起動デーモンが開始したときには再起動されません。起動デーモン rmid が開始したときに起動可能なオブジェクトも再起動する必要がある場合は、2 番目の形式の Activatable コンストラクタを使ってください。
location
- オブジェクトが使うクラスの位置data
- オブジェクトの初期化データrestart
- true の場合は、アクティベータが再起動されるとオブジェクトも再起動される。false の場合は、オブジェクトは要求に応じて再起動されるport
- オブジェクトのエクスポート先のポート。 port=0 の場合は匿名ポートが使用されるcsf
- リモートオブジェクトの呼び出しに使用する、クライアント側ソケットファクトリssf
- リモート呼び出しを受信する、サーバ側ソケットファクトリprotected Activatable(ActivationID id, int port) throws RemoteException
ActivationID
)
MarshalledObject
)
このクラスの具象サブクラスは、前述したコンストラクタを通じて起動されるときに、このコンストラクタを呼び出す必要があります。起動可能なオブジェクトを構築すると、指定された port
上の RMI ランタイムにリモートオブジェクトがエクスポートされ、クライアントからの着信呼び出しの受け付けに使用できるようになります。
id
- オブジェクトの起動識別子port
- オブジェクトのエクスポート先のポート番号protected Activatable(ActivationID id, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) throws RemoteException
ActivationID
)
MarshalledObject
)
このクラスの具象サブクラスは、前述したコンストラクタを通じて起動されるときに、このコンストラクタを呼び出す必要があります。起動可能なオブジェクトを構築すると、指定された port
上の RMI ランタイムにリモートオブジェクトがエクスポートされ、クライアントからの着信呼び出しの受け付けに使用できるようになります。
id
- オブジェクトの起動識別子port
- オブジェクトのエクスポート先のポート番号csf
- リモートオブジェクトの呼び出しに使用する、クライアント側ソケットファクトリssf
- リモート呼び出しを受信する、サーバ側ソケットファクトリメソッドの詳細 |
protected ActivationID getID()
public static Remote register(ActivationDesc desc) throws UnknownGroupException, ActivationException, RemoteException
desc
- オブジェクトの記述子desc
にあるグループ ID が起動システムに登録されていない場合public static boolean inactive(ActivationID id) throws UnknownObjectException, ActivationException, RemoteException
id
のオブジェクトが現在停止していることを、システムに通知します。オブジェクトが現在起動中である場合、そのオブジェクトは RMI ランタイムから「アンエクスポート」され (保留中、あるいは進行中の呼び出しがない場合のみ)、以後の着信呼び出しを受信できなくなります。この呼び出しは VM の ActivationGroup にオブジェクトが停止していることを通知し、ActivationGroup は、該当する ActivationMonitor に通知を行います。この呼び出しが正常に完了した場合、アクティベータへの後続の起動要求によってオブジェクトが再び起動されます。このオペレーションは、オブジェクトが起動中であっても、アンエクスポート済みの場合は true を返します。id
- オブジェクトの起動識別子public static void unregister(ActivationID id) throws UnknownObjectException, ActivationException, RemoteException
id
に関連付けられた起動記述子の登録を取り消します。その id
を使ってオブジェクトを起動することはできなくなります。id
- オブジェクトの起動識別子id
) が不明な場合public static ActivationID exportObject(Remote obj, String location, MarshalledObject data, boolean restart, int port) throws ActivationException, RemoteException
exportObject
メソッドは、Activatable
クラスを拡張しない「起動可能な」オブジェクトから、明示的に呼び出されることがあります。この呼び出しで、a) 指定された location
および data
で構築された、オブジェクトの起動記述子を起動システムに登録することにより、オブジェクトを起動可能にしたり、b) リモートオブジェクト obj
を、指定されたポートにエクスポートしたりします。 port=0 の場合は、匿名ポートが選択されます。オブジェクトがいったんエクスポートされると、RMI 着信呼び出しを受け取ることができます。
obj
が Activatable
クラスを拡張する場合は、最初のコンストラクタがこのメソッドを呼び出すので、このメソッドの明示的な呼び出しは不要です。
obj
- エクスポート対象のオブジェクトlocation
- オブジェクトのコードの位置data
- オブジェクトのブートストラップデータrestart
- true の場合は、アクティベータが再起動するときにオブジェクトが再起動される。false の場合は、オブジェクトは要求に応じて起動されるport
- オブジェクトのエクスポート先のポート。port=0 の場合は匿名ポートが使用されるdesc
を登録したときに取得した起動識別子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
を、指定されたポートにエクスポートしたりします。port=0 の場合は、匿名ポートが選択されます。オブジェクトがいったんエクスポートされると、RMI 着信呼び出しを受け取ることができます。
obj
が Activatable
クラスを拡張する場合は、最初のコンストラクタがこのメソッドを呼び出すので、このメソッドの明示的な呼び出しは不要です。
obj
- エクスポート対象のオブジェクトlocation
- オブジェクトのコードの位置data
- オブジェクトのブートストラップデータrestart
- true の場合は、アクティベータが再起動するときにオブジェクトが再起動される。false の場合は、オブジェクトは要求に応じて起動されるport
- オブジェクトのエクスポート先のポート。 port=0 の場合は匿名ポートが使用されるcsf
- リモートオブジェクトを呼び出すためのクライアント側ソケットファクトリssf
- リモート呼び出しを受信するためのサーバ側ソケットファクトリdesc
を登録したときに取得した起動識別子public static Remote exportObject(Remote obj, ActivationID id, int port) throws RemoteException
port
の値が 0 の場合、オブジェクトは匿名ポートにエクスポートされます。
起動時に、exportObject
メソッドは、Activatable
クラスを拡張しない「起動可能な」オブジェクトから明示的に呼び出されることがあります。Activatable
を拡張するオブジェクトであれば、このメソッドを直接呼び出す必要はありません。このメソッドは、前述の 2 番目のコンストラクタによって呼び出されます。また、サブクラスが、特別な起動コンストラクタからこのコンストラクタを呼び出すことがあります。
obj
- リモートオブジェクトの実装id
- オブジェクトの起動識別子port
- オブジェクトのエクスポート先のポート。port=0 の場合は匿名ポートが使用されるpublic static Remote exportObject(Remote obj, ActivationID id, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) throws RemoteException
port
の値が 0 の場合、オブジェクトは匿名ポートにエクスポートされます。
起動時に、exportObject
メソッドは、Activatable
クラスを拡張しない「起動可能な」オブジェクトから明示的に呼び出されることがあります。Activatable
を拡張するオブジェクトであれば、このメソッドを直接呼び出す必要はありません。このメソッドは、前述の 2 番目のコンストラクタに呼び出されます。また、サブクラスが、特別な起動コンストラクタからこのコンストラクタを呼び出すことがあります。
obj
- リモートオブジェクトの実装id
- オブジェクトの起動識別子port
- オブジェクトのエクスポート先のポート。port=0 の場合は匿名ポートが使用されるcsf
- リモートオブジェクトを呼び出すためのクライアント側ソケットファクトリssf
- リモート呼び出しを受信するためのサーバ側ソケットファクトリpublic static boolean unexportObject(Remote obj, boolean force) throws NoSuchObjectException
obj
- アンエクスポートされるリモートオブジェクトforce
- true の場合は、保留中あるいは進行中の呼び出しがあってもオブジェクトをアンエクスポートする。false の場合は、保留中あるいは進行中の呼び出しがない場合にだけオブジェクトをアンエクスポートする
|
Java プラットフォーム 1.2 |
|||||||||
前のクラス 次のクラス | フレームあり フレームなし | |||||||||
概要: 内部クラス | フィールド | コンストラクタ | メソッド | 詳細: フィールド | コンストラクタ | メソッド |