JavaTM 2
Platform
Std. Ed. v1.4.0

java.rmi.server
クラス UnicastRemoteObject

java.lang.Object
  |
  +--java.rmi.server.RemoteObject
        |
        +--java.rmi.server.RemoteServer
              |
              +--java.rmi.server.UnicastRemoteObject
すべての実装インタフェース:
Remote, Serializable
直系の既知のサブクラス:
ActivationGroup

public class UnicastRemoteObject
extends RemoteServer

UnicastRemoteObject クラスは、複製でないリモートオブジェクトを定義します。そのリモートオブジェクトの参照は、サーバプロセスが活動している間だけ有効になります。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 オブジェクトの作成とエクスポートを行います。

例外:
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

JavaTM 2
Platform
Std. Ed. v1.4.0

バグの報告と機能のリクエスト
これ以外の API リファレンスおよび開発者用ドキュメントについては、 Java 2 SDK SE 開発者用ドキュメントを参照してください。 開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、 およびコード実例が含まれています。

Java、Java 2D、および JDBC は米国ならびにその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.