java.rmi.server
クラス UnicastRemoteObject

java.lang.Object
  |
  +--java.rmi.server.RemoteObject
        |
        +--java.rmi.server.RemoteServer
              |
              +--java.rmi.server.UnicastRemoteObject

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

ActivationGroup

public class UnicastRemoteObject

extends RemoteServer

複製でないリモートオブジェクトを定義します。そのリモートオブジェクトの参照は、サーバプロセスが活動している間だけ有効になります。UnicastRemoteObject クラスは、TCP ストリームを使用してポイントツーポイントのアクティブなオブジェクト参照 (起動、パラメータ、および結果) をサポートします。

リモート動作を要求するオブジェクトは通常、UnicastRemoteObject を使用して RemoteObject を拡張する必要があります。UnicastRemoteObject の拡張クラスとして定義しない場合には、Object クラスから継承した hashCode、equals、および toString メソッドの正しいセマンティクスを、リモートオブジェクトに対して適切に動作させる責任が実装クラスに生じます。

導入されたバージョン:

JDK1.1

関連項目:

RemoteServer, RemoteObject, 直列化された形式

クラス 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 オブジェクトの作成とエクスポートを行います。

導入されたバージョン:

JDK1.1

UnicastRemoteObject

protected UnicastRemoteObject(int port)
                       throws RemoteException

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

パラメータ:

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

導入されたバージョン:

JDK1.2

UnicastRemoteObject

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

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

パラメータ:

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

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

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

導入されたバージョン:

JDK1.2

メソッドの詳細

clone

public Object clone()
             throws CloneNotSupportedException

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

戻り値:

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

例外:

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

オーバーライド:

クラス Object 内の clone

導入されたバージョン:

JDK1.1

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 - エクスポートに失敗した場合

導入されたバージョン:

JDK1.2

exportObject

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

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

パラメータ:

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

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

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

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

例外:

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

導入されたバージョン:

JDK1.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 - 現在、リモートオブジェクトがエクスポートされていない場合

導入されたバージョン:

JDK1.2