UnicastRemoteObject (Java Platform SE 8)

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

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

Serializable, Remote

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

ActivationGroup
```
public class UnicastRemoteObject
extends RemoteServer
```
リモート・オブジェクトをJRMPを使ってエクスポートし、リモート・オブジェクトと通信するスタブを取得するために使用されます。スタブは、動的プロキシ・オブジェクトを使用して実行時に生成されるか、または通常はrmicツールを使用してビルド時に静的に生成されます。
非推奨: 静的スタブ。静的に生成されたスタブのサポートは非推奨です。これには、静的スタブを使用する必要があるこのクラス内のAPI、および静的スタブのロードに対する実行時サポートが含まれます。次に示すように、オブジェクトをエクスポートする非推奨でない5つの方法のいずれかを使用して、スタブを動的に生成することが推奨されます。rmicを実行して静的スタブ・クラスを生成しないでください。これは不要であり、また非推奨でもあります。
リモート・オブジェクトをエクスポートするには、次の6つの方法があります。
1. UnicastRemoteObjectのサブクラス化およびUnicastRemoteObject()コンストラクタの呼出し。
2. UnicastRemoteObjectのサブクラス化およびUnicastRemoteObject(port)コンストラクタの呼出し。
3. UnicastRemoteObjectのサブクラス化およびUnicastRemoteObject(port, csf, ssf)コンストラクタの呼出し。
4. exportObject(Remote)メソッドの呼出し。非推奨。
5. exportObject(Remote, port)メソッドの呼出し。
6. exportObject(Remote, port, csf, ssf)メソッドの呼出し。
4番目の手法であるexportObject(Remote)は、静的に生成されたスタブを常に使用するため、非推奨です。
それ以外の5つの手法ではすべて、次の方法が使用されます。java.rmi.server.ignoreStubClassesプロパティがtrue (大文字と小文字は区別されない)である場合、または静的スタブが見つからない場合、スタブはProxyオブジェクトを使用して動的に生成されます。それ以外の場合は、静的スタブが使用されます。
java.rmi.server.ignoreStubClassesプロパティのデフォルト値はfalseです。
静的に生成されたスタブは通常、rmicツールを使用してリモート・オブジェクトのクラスから事前生成されます。次に説明するように、静的スタブがロードされ、そのスタブ・クラスのインスタンスが構築されます。
- 「ルート・クラス」が次のようにして決定されます。リモート・オブジェクトのクラスがRemoteを拡張したインタフェースを直接実装している場合、そのリモート・オブジェクトのクラスがルート・クラスになります。それ以外の場合、リモート・オブジェクトのクラスのスーパー・クラスのうち、Remoteを拡張したインタフェースを直接実装している最上位のクラスが、ルート・クラスになります。
- ロードするスタブ・クラスの名前を決定するために、ルート・クラスのバイナリ名と接尾辞_Stubが連結されます。
- 指定した名前のスタブ・クラスがルート・クラスのクラス・ローダーを使ってロードされます。そのスタブ・クラスはRemoteStubを拡張しており、かつRemoteRef型のパラメータを1つ受け取るpublicコンストラクタを備えている必要があります。
- 最後に、スタブ・クラスのインスタンスがRemoteRefを使って構築されます。
- 適切なスタブ・クラスが見つからなかった場合、スタブ・クラスをロードできなかった場合、あるいはスタブ・インスタンスの作成時に問題が発生した場合は、StubNotFoundExceptionがスローされます。
スタブは、次の特性を持つProxyのインスタンスを構築することによって動的に生成されます。
- プロキシのクラスは、リモート・オブジェクトのクラスのクラス・ローダーによって定義される
- プロキシは、リモート・オブジェクトのクラスが実装しているリモート・インタフェースのすべてを実装する
- プロキシの呼出しハンドラは、RemoteRefを使って構築されたRemoteObjectInvocationHandlerインスタンスになる。
- プロキシを作成できなかった場合は、StubNotFoundExceptionがスローされる。
実装上の注意:

オブジェクトのエクスポートに使用されるコンストラクタまたは静的メソッドに応じて、ソケットの作成にRMISocketFactoryが使用される場合があります。デフォルトでは、RMISocketFactoryによって作成されるサーバー・ソケットはすべてのネットワーク・インタフェースで待機します。RMISocketFactoryクラスおよび『Java Remote Method Invocationの仕様』のセクション「RMIソケット・ファクトリ」を参照してください。

導入されたバージョン:

JDK1.1

関連項目:

直列化された形式

フィールドのサマリー
- クラス java.rmi.server.RemoteObjectから継承されるフィールド
  ref

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

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

メソッドのサマリー

すべてのメソッド staticメソッドインスタンス・メソッド具象メソッド非推奨のメソッド
修飾子と型	メソッドと説明
`Object`	`clone()` 元のオブジェクトと明確に区別できるリモート・オブジェクトの複製を返します。
`static RemoteStub`	`exportObject(Remote obj)` 非推奨。このメソッドは、静的スタブのみをサポートするため、非推奨になりました。代わりに`exportObject(Remote, port)`または`exportObject(Remote, port, csf, ssf)`を使用してください。
`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オブジェクトの作成とエクスポートを行います。
    オブジェクトは、RMISocketFactoryクラスを使用して作成されたサーバー・ソケットを使用してエクスポートされます。
    
    例外:
    
    RemoteException - オブジェクトのエクスポートが失敗した場合
    
    導入されたバージョン:
    
    JDK1.1
  - UnicastRemoteObject
```
protected UnicastRemoteObject(int port)
                       throws RemoteException
```
    指定されたポートを使用して、新しいUnicastRemoteObjectオブジェクトの作成とエクスポートを行います。
    オブジェクトは、RMISocketFactoryクラスを使用して作成されたサーバー・ソケットを使用してエクスポートされます。
    
    パラメータ:
    
    port - リモート・オブジェクトが呼出しを受信するポートの番号。portがゼロの場合は、匿名ポートが選択される
    
    例外:
    
    RemoteException - オブジェクトのエクスポートが失敗した場合
    
    導入されたバージョン:
    
    1.2
  - UnicastRemoteObject
```
protected UnicastRemoteObject(int port,
                              RMIClientSocketFactory csf,
                              RMIServerSocketFactory ssf)
                       throws RemoteException
```
    指定されたポートとソケット・ファクトリを使用して、新しいUnicastRemoteObjectオブジェクトの作成とエクスポートを行います。
    いずれかのソケット・ファクトリをnullにできます。この場合、RMISocketFactoryの対応するクライアントまたはサーバー・ソケット作成メソッドがかわりに使用されます。
    
    パラメータ:
    
    port - リモート・オブジェクトが呼出しを受信するポートの番号。portがゼロの場合は、匿名ポートが選択される
    
    csf - リモート・オブジェクトの呼出しに使用する、クライアント側ソケット・ファクトリ
    
    ssf - リモート呼出しを受信する、サーバー側ソケット・ファクトリ
    
    例外:
    
    RemoteException - オブジェクトのエクスポートが失敗した場合
    
    導入されたバージョン:
    
    1.2
- メソッドの詳細
  - clone
```
public Object clone()
             throws CloneNotSupportedException
```
    元のオブジェクトと明確に区別できるリモート・オブジェクトの複製を返します。
    
    オーバーライド:
    
    clone、クラス: Object
    
    戻り値:
    
    新しいリモート・オブジェクト
    
    例外:
    
    CloneNotSupportedException - 複製がRemoteExceptionのために失敗した場合。
    
    導入されたバージョン:
    
    JDK1.1
    
    関連項目:
    
    Cloneable
  - exportObject
```
@Deprecated
public static RemoteStub exportObject(Remote obj)
                                           throws RemoteException
```
    非推奨。このメソッドは静的スタブのみをサポートするため、非推奨です。代わりにexportObject(Remote, port)またはexportObject(Remote, port, csf, ssf)を使用してください。
    
    リモート・オブジェクトをエクスポートして、着信呼出しの受信に使用できるようにします。匿名ポートを使用します。このメソッドでは常に、静的に生成されたスタブが返されます。
    オブジェクトは、RMISocketFactoryクラスを使用して作成されたサーバー・ソケットを使用してエクスポートされます。
    
    パラメータ:
    
    obj - エクスポートするリモート・オブジェクト
    
    戻り値:
    
    リモート・オブジェクト・スタブ
    
    例外:
    
    RemoteException - エクスポートに失敗した場合
    
    導入されたバージョン:
    
    JDK1.1
  - exportObject
```
public static Remote exportObject(Remote obj,
                                  int port)
                           throws RemoteException
```
    リモート・オブジェクトをエクスポートして、着信呼出しの受信に使用できるようにします。指定されたポートを使用します。
    オブジェクトは、RMISocketFactoryクラスを使用して作成されたサーバー・ソケットを使用してエクスポートされます。
    
    パラメータ:
    
    obj - エクスポートするリモート・オブジェクト
    
    port - オブジェクトのエクスポート先のポート
    
    戻り値:
    
    リモート・オブジェクト・スタブ
    
    例外:
    
    RemoteException - エクスポートに失敗した場合
    
    導入されたバージョン:
    
    1.2
  - exportObject
```
public static Remote exportObject(Remote obj,
                                  int port,
                                  RMIClientSocketFactory csf,
                                  RMIServerSocketFactory ssf)
                           throws RemoteException
```
    リモート・オブジェクトをエクスポートして、着信呼出しの受信に使用できるようにします。指定されたソケット・ファクトリによって特定されたトランスポートを使用します。
    いずれかのソケット・ファクトリをnullにできます。この場合、RMISocketFactoryの対応するクライアントまたはサーバー・ソケット作成メソッドがかわりに使用されます。
    
    パラメータ:
    
    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

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスUnicastRemoteObject

フィールドのサマリー

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

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

メソッドのサマリー

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

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

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

コンストラクタの詳細

UnicastRemoteObject

UnicastRemoteObject

UnicastRemoteObject

メソッドの詳細

clone

exportObject

exportObject

exportObject

unexportObject