JavaTM Platform
Standard Ed. 6

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 メソッドの場合、エクスポートするリモートオブジェクトのスタブは、次のようにして取得されます。

導入されたバージョン:
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

JavaTM Platform
Standard Ed. 6

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

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。