java.rmi.server

クラス UnicastRemoteObject

java.lang.Object

java.rmi.server.RemoteObject

java.rmi.server.RemoteServer

java.rmi.server.UnicastRemoteObject

すべての実装されたインタフェース:

Serializable、Remote

直系の既知のサブクラス:

ActivationGroup

public class UnicastRemoteObject
extends RemoteServer

リモートオブジェクトを JRMP を使ってエクスポートし、リモートオブジェクトと通信するスタブを取得するために使用されます。

コンストラクタおよび static exportObject メソッドの場合、エクスポートするリモートオブジェクトのスタブは、次のようにして取得されます。

• UnicastRemoteObject.exportObject(Remote) メソッドを使ってリモートオブジェクトをエクスポートする場合、スタブクラス (通常はリモートオブジェクトのクラスから rmic ツールを使って事前に生成される) がロードされ、そのスタブクラスのインスタンスが次のようにして構築されます。
  • 「ルートクラス」が次のようにして決定されます。リモートオブジェクトのクラスが Remote を拡張したインタフェースを直接実装している場合、そのリモートオブジェクトのクラスがルートクラスになります。それ以外の場合、リモートオブジェクトのクラスのスーパークラスのうち、Remote を拡張したインタフェースを直接実装している最上位のクラスが、ルートクラスになります。
  • ロードするスタブクラスの名前を決定するために、ルートクラスのバイナリ名と接尾辞 "_Stub" が連結されます。
  • 指定した名前のスタブクラスがルートクラスのクラスローダーを使ってロードされます。そのスタブクラスは RemoteStub を拡張しており、かつ RemoteRef 型のパラメータを 1 つ受け取る public コンストラクタを備えている必要があります。
  • 最後に、スタブクラスのインスタンスが RemoteRef を使って構築されます。
• 適切なスタブクラスが見つからなかった場合、スタブクラスをロードできなかった場合、あるいはスタブインスタンスの作成時に問題が発生した場合は、StubNotFoundException がスローされます。

• その他の方法でエクスポートする場合の手順は、次のとおりです。
  • リモートオブジェクトのスタブクラス (定義は上記を参照) をロードできなかったか、システムプロパティー java.rmi.server.ignoreStubClasses が "true" (大文字小文字の区別なし) に設定されていた場合、次のような特性を持つ Proxy インスタンスが構築されます。
    • プロキシのクラスは、リモートオブジェクトのクラスのクラスローダーによって定義される
    • プロキシは、リモートオブジェクトのクラスが実装しているリモートインタフェースのすべてを実装する
    • プロキシの呼び出しハンドラは、RemoteRef を使って構築された RemoteObjectInvocationHandler インスタンスになる。
    • プロキシを作成できなかった場合は、StubNotFoundException がスローされる。

  • そうでない場合、リモートオブジェクトの (前述した) スタブクラスのインスタンスがスタブとして使用されます。

導入されたバージョン:

JDK1.1

関連項目:

直列化された形式

フィールドのサマリー

クラス java.rmi.server.RemoteObject から継承されるフィールド

ref

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

コンストラクタ

修飾子	コンストラクタと説明
protected	UnicastRemoteObject() 匿名ポートを使用して、新しい UnicastRemoteObject オブジェクトの作成とエクスポートを行います。
protected	UnicastRemoteObject(int port) 指定されたポートを使用して、新しい UnicastRemoteObject オブジェクトの作成とエクスポートを行います。
protected	UnicastRemoteObject(int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) 指定されたポートとソケットファクトリを使用して、新しい UnicastRemoteObject オブジェクトの作成とエクスポートを行います。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
Object	clone() 元のオブジェクトと明確に区別できるリモートオブジェクトの複製を返します。
static RemoteStub	exportObject(Remote obj) リモートオブジェクトをエクスポートして、着信呼び出しの受信に使用できるようにします。匿名ポートを使用します。
static Remote	exportObject(Remote obj, int port) リモートオブジェクトをエクスポートして、着信呼び出しの受信に使用できるようにします。指定されたポートを使用します。
static Remote	exportObject(Remote obj, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf) リモートオブジェクトをエクスポートして、着信呼び出しの受信に使用できるようにします。指定されたソケットファクトリによって特定されたトランスポートを使用します。
static boolean	unexportObject(Remote obj, boolean force) RMI ランタイムからリモートオブジェクト obj を削除します。

クラス java.rmi.server.RemoteServer から継承されるメソッド

getClientHost, getLog, setLog

クラス java.rmi.server.RemoteObject から継承されるメソッド

equals, getRef, hashCode, toString, toStub

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

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

コンストラクタの詳細

UnicastRemoteObject

protected UnicastRemoteObject()
                       throws RemoteException

匿名ポートを使用して、新しい UnicastRemoteObject オブジェクトの作成とエクスポートを行います。

例外:

RemoteException - オブジェクトのエクスポートが失敗した場合

導入されたバージョン:

JDK1.1

UnicastRemoteObject

protected UnicastRemoteObject(int port)
                       throws RemoteException

指定されたポートを使用して、新しい UnicastRemoteObject オブジェクトの作成とエクスポートを行います。

パラメータ:

port - リモートオブジェクトが呼び出しを受信するポートの番号。port がゼロの場合は、匿名ポートが選択される

例外:

RemoteException - オブジェクトのエクスポートが失敗した場合

導入されたバージョン:

1.2

UnicastRemoteObject

protected UnicastRemoteObject(int port,
                   RMIClientSocketFactory csf,
                   RMIServerSocketFactory ssf)
                       throws RemoteException

指定されたポートとソケットファクトリを使用して、新しい UnicastRemoteObject オブジェクトの作成とエクスポートを行います。

パラメータ:

port - リモートオブジェクトが呼び出しを受信するポートの番号。port がゼロの場合は、匿名ポートが選択される

csf - リモートオブジェクトの呼び出しに使用する、クライアント側ソケットファクトリ

ssf - リモート呼び出しを受信する、サーバー側ソケットファクトリ

例外:

RemoteException - オブジェクトのエクスポートが失敗した場合

導入されたバージョン:

1.2

メソッドの詳細

clone

public Object clone()
             throws CloneNotSupportedException

元のオブジェクトと明確に区別できるリモートオブジェクトの複製を返します。

オーバーライド:

clone、クラス: Object

戻り値:

新しいリモートオブジェクト

例外:

CloneNotSupportedException - 複製が RemoteException のために失敗した場合。

導入されたバージョン:

JDK1.1

関連項目:

Cloneable

exportObject

public static RemoteStub exportObject(Remote obj)
                               throws RemoteException

リモートオブジェクトをエクスポートして、着信呼び出しの受信に使用できるようにします。匿名ポートを使用します。

パラメータ:

obj - エクスポートするリモートオブジェクト

戻り値:

リモートオブジェクトスタブ

例外:

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

導入されたバージョン:

JDK1.1

exportObject

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

リモートオブジェクトをエクスポートして、着信呼び出しの受信に使用できるようにします。指定されたポートを使用します。

パラメータ:

obj - エクスポートするリモートオブジェクト

port - オブジェクトのエクスポート先のポート

戻り値:

リモートオブジェクトスタブ

例外:

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

導入されたバージョン:

1.2

exportObject

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

リモートオブジェクトをエクスポートして、着信呼び出しの受信に使用できるようにします。指定されたソケットファクトリによって特定されたトランスポートを使用します。

パラメータ:

obj - エクスポートするリモートオブジェクト

port - オブジェクトのエクスポート先のポート

csf - リモートオブジェクトの呼び出しに使用する、クライアント側ソケットファクトリ

ssf - リモート呼び出しを受信する、サーバー側ソケットファクトリ

戻り値:

リモートオブジェクトスタブ

例外:

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

導入されたバージョン:

1.2

unexportObject

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

RMI ランタイムからリモートオブジェクト obj を削除します。削除が成功すると、オブジェクトは RMI 着信呼び出しの受け付けのために使用できなくなります。パラメータ force が true に設定されていると、リモートオブジェクトへの保留状態の呼び出しがある場合や、進行中の呼び出しがある場合でも、オブジェクトは強制的にアンエクスポートされます。force パラメータに false を指定すると、保留状態の呼び出しや実行中の呼び出しがない場合に限り、オブジェクトはアンエクスポートされます。

パラメータ:

obj - アンエクスポートされるリモートオブジェクト

force - true の場合は、保留中または進行中の呼び出しがあっても、オブジェクトをアンエクスポートする。false の場合は、保留中または進行中の呼び出しがないときにだけ、オブジェクトをアンエクスポートする

戻り値:

オペレーションが成功した場合は true、そうでない場合は false

例外:

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

導入されたバージョン:

1.2