javax.rmi

クラス PortableRemoteObject

java.lang.Object

javax.rmi.PortableRemoteObject

public class PortableRemoteObject
extends Object

サーバー実装オブジェクトは、javax.rmi.PortableRemoteObject を継承するか、あるいはリモートインタフェースを実装して exportObject メソッドを使用して、このオブジェクト自体をサーバーオブジェクトとして登録します。toStub メソッドはサーバー実装を受け取り、そのサーバーオブジェクトへのアクセスに使用できるスタブを返します。接続メソッドは Remote オブジェクトをリモート通信可能な状態にします。unexportObject メソッドは、サーバーオブジェクトの登録解除に使われ、サーバーオブジェクトをガベージコレクションで使用できるようにします。narrow メソッドはオブジェクト参照または抽象インタフェースタイプを取り込み、それをナロー変換して指定されたインタフェースに一致させようとします。操作が完了すると指定されたタイプのオブジェクトになり、そうでない場合は例外がスローされます。

コンストラクタのサマリー

コンストラクタ

修飾子	コンストラクタと説明
protected	PortableRemoteObject() exportObject(this) を呼び出してオブジェクトを初期化します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
static void	connect(Remote target, Remote source) リモート通信準備のできたリモートオブジェクトを作成します。
static void	exportObject(Remote obj) サーバーオブジェクトがリモート呼び出しを受信できるようにします。
static Object	narrow(Object narrowFrom, Class narrowTo) リモートインタフェースまたは抽象インタフェースのオブジェクトを目的のタイプにキャストできることを確認します。
static Remote	toStub(Remote obj) 指定されたサーバーオブジェクトのスタブを返します。
static void	unexportObject(Remote obj) サーバーオブジェクトをランタイムから登録解除し、そのオブジェクトがガベージコレクションの対象となるようにします。

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

PortableRemoteObject

protected PortableRemoteObject()
                        throws RemoteException

exportObject(this) を呼び出してオブジェクトを初期化します。

例外:

RemoteException - エクスポートに失敗した場合。

メソッドの詳細

exportObject

public static void exportObject(Remote obj)
                         throws RemoteException

サーバーオブジェクトがリモート呼び出しを受信できるようにします。PortableRemoteObject のサブクラスの場合、このメソッドはコンストラクタが呼び出すので、呼び出す必要はありません。

パラメータ:

obj - エクスポート対象のサーバーオブジェクト。

例外:

RemoteException - エクスポートに失敗した場合。

toStub

public static Remote toStub(Remote obj)
                     throws NoSuchObjectException

指定されたサーバーオブジェクトのスタブを返します。

パラメータ:

obj - スタブを必要とするサーバーオブジェクト。PortableRemoteObject のサブクラスであるか、あるいはこれまでに exportObject(java.rmi.Remote) 呼び出しのターゲットとなっていることが必要。

戻り値:

オブジェクトの最上位派生スタブ。

例外:

NoSuchObjectException - 指定されたサーバーオブジェクトにスタブを配置できない場合。

unexportObject

public static void unexportObject(Remote obj)
                           throws NoSuchObjectException

サーバーオブジェクトをランタイムから登録解除し、そのオブジェクトがガベージコレクションの対象となるようにします。

パラメータ:

obj - アンエクスポートするオブジェクト。

例外:

NoSuchObjectException - リモートオブジェクトが現在エクスポートされていない場合。

narrow

public static Object narrow(Object narrowFrom,
            Class narrowTo)
                     throws ClassCastException

リモートインタフェースまたは抽象インタフェースのオブジェクトを目的のタイプにキャストできることを確認します。

パラメータ:

narrowFrom - チェック対象のオブジェクト。

narrowTo - 目的のタイプ。

戻り値:

目的のタイプにキャストできるオブジェクト。

例外:

ClassCastException - narrowFrom を narrowTo にキャストできない場合。

connect

public static void connect(Remote target,
           Remote source)
                    throws RemoteException

リモート通信準備のできたリモートオブジェクトを作成します。通常、リモートメソッドの呼び出しでオブジェクトが引数として送信または受信された場合に暗黙的に通信可能な状態になりますが、状況によっては明示的に呼び出してこの動作を行うのに役立ちます。詳細は、Stub.connect(org.omg.CORBA.ORB) メソッドを参照してください。

パラメータ:

target - 接続対象のオブジェクト。

source - すでに接続されているオブジェクト。

例外:

RemoteException - source が接続されていない場合、または target が source 以外の ORB に接続されている場合。