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 が 0 の場合は、匿名ポートが使用される

例外:

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

導入されたバージョン:

1.2

UnicastRemoteObject

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

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

パラメータ:

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

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

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

例外:

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

導入されたバージョン:

1.2

メソッドの詳細

clone

public Object clone()
             throws CloneNotSupportedException

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

オーバーライド:

クラス Object 内の clone

戻り値:

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

例外:

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