クラスjava.rmi.RemoteExceptionの使用(Java Platform SE 8)

RemoteExceptionを使用しているパッケージ
パッケージ	説明
java.rmi	RMIパッケージを提供します。
java.rmi.activation	RMIオブジェクト起動をサポートします。
java.rmi.dgc	RMI分散ガベージ・コレクション(DGC)に対するクラスとインタフェースを提供します。
java.rmi.registry	RMIレジストリ用として1つのクラスと2つのインタフェースを提供します。
java.rmi.server	サーバー側のRMIをサポートするクラスとインタフェースを提供します。
javax.activity	非整列化中にORB機構によってスローされるActivityサービス関連の例外が含まれています。
javax.management.remote.rmi	RMIコネクタは、RMIを使ってクライアント要求をリモートMBeanサーバーへ転送する、JMXリモートAPI用のコネクタです。
javax.rmi	RMI-IIOPのユーザーAPIを含みます。
javax.rmi.CORBA	RMI-IIOP用の移植可能なAPIを含みます。
javax.transaction	非整列化中にORB機構によってスローされた3つの例外が含まれています。

java.rmiでのRemoteExceptionの使用

java.rmiでのRemoteExceptionのサブクラス
修飾子と型	クラスと説明
`class`	`AccessException` `AccessException`は、`java.rmi.Naming`クラスの特定のメソッド(具体的には`bind`、`rebind`、`unbind`)および`java.rmi.activation.ActivationSystem`インタフェースのメソッドによってスローされ、メソッド呼出しによって要求された処理を実行するアクセス権が呼出し側にないことを示します。
`class`	`ConnectException` `ConnectException`は、リモート・メソッド呼出しでリモート・ホストへの接続が拒否された場合にスローされます。
`class`	`ConnectIOException` `ConnectIOException`は、リモート・メソッド呼出しでリモート・ホストに接続しようとしているときに`IOException`が発生した場合にスローされます。
`class`	`MarshalException` `MarshalException`は、リモート・メソッド呼出しでリモート呼出しのヘッダー、引数、または戻り値を整列化しているときに`java.io.IOException`が発生した場合にスローされます。
`class`	`NoSuchObjectException` `NoSuchObjectException`は、リモート仮想マシンにもう存在していないオブジェクトに対してメソッドを呼び出そうとした場合にスローされます。
`class`	`ServerError` `ServerError`はリモート・メソッド呼出しの結果としてスローされます。この例外がスローされた場合は、サーバー上でその呼出しが処理されているとき、つまり、引数の非整列化、リモート・メソッドの実行、または戻り値の整列化が行われているときに、`Error`がスローされています。
`class`	`ServerException` `ServerException`はリモート・メソッド呼出しの結果としてスローされます。この例外がスローされた場合は、サーバー上でその呼出しが処理されているとき、つまり、引数の非整列化またはリモート・メソッドの実行中に、`RemoteException`がスローされています。
`class`	`ServerRuntimeException` 非推奨。代替はありません。
`class`	`StubNotFoundException` `StubNotFoundException`は、エクスポート時に、有効なスタブ・クラスがリモート・オブジェクトで見つからない場合にスローされます。
`class`	`UnexpectedException` `UnexpectedException`は、リモート・メソッド呼出しのクライアントが、呼出しの結果として、リモート・インタフェースのメソッドの`throws`節で宣言されているチェック例外の型とは異なるチェック例外を受信した場合にスローされます。
`class`	`UnknownHostException` `UnknownHostException`は、リモート・メソッド呼出しのためにリモート・ホストとの接続を確立している間に`java.net.UnknownHostException`が発生した場合にスローされます。
`class`	`UnmarshalException` `UnmarshalException`は、リモート・メソッド呼出しのパラメータまたは結果を非整列化しているときに、次の条件のどれかが成立した場合にスローされることがあります。呼出しヘッダーを非整列化しているときに例外が発生した場合、戻り値のプロトコルが無効な場合、パラメータ(サーバー側)または戻り値(クライアント側)を非整列化しているときに`java.io.IOException`が発生した場合

RemoteExceptionをスローするjava.rmiのメソッド
修飾子と型	メソッドと説明
`static void`	Naming.`bind(String name, Remote obj)` 指定された`name`をリモート・オブジェクトにバインドします。
`static String[]`	Naming.`list(String name)` レジストリ内のバインドされている名前の配列を返します。
`static Remote`	Naming.`lookup(String name)` 指定された`name`に関連したリモート・オブジェクトの参照(スタブ)を返します。
`static void`	Naming.`rebind(String name, Remote obj)` 指定された名前を新しいリモート・オブジェクトにバインドし直します。
`static void`	Naming.`unbind(String name)` リモート・オブジェクトに関連した指定された名前に対するバインディングを破棄します。

java.rmi.activationでのRemoteExceptionの使用

java.rmi.activationでのRemoteExceptionのサブクラス
修飾子と型	クラスと説明
`class`	`ActivateFailedException` 起動可能なオブジェクトへのリモート呼出しで起動が失敗した場合に、RMIランタイムがこの例外をスローします。

RemoteExceptionをスローするjava.rmi.activationのメソッド
修飾子と型	メソッドと説明
`MarshalledObject<? extends Remote>`	Activator.`activate(ActivationID id, boolean force)` 起動識別子`id`に関連したオブジェクトを起動します。
`Remote`	ActivationID.`activate(boolean force)` 指定されたIDのオブジェクトを起動します。
`ActivationMonitor`	ActivationSystem.`activeGroup(ActivationGroupID id, ActivationInstantiator group, long incarnation)` グループが起動中であることを起動システムに通知するコールバックです。
`void`	ActivationMonitor.`activeObject(ActivationID id, MarshalledObject<? extends Remote> obj)` オブジェクトが起動したことを通知します。
`protected void`	ActivationGroup.`activeObject(ActivationID id, MarshalledObject<? extends Remote> mobj)` このprotectedメソッドは、サブクラスがグループのモニターに`activeObject`コールバックを行うために必要です。
`abstract void`	ActivationGroup.`activeObject(ActivationID id, Remote obj)` グループの`activeObject`メソッドは、オブジェクトがエクスポートされるときに呼び出されます。エクスポートは、`Activatable`オブジェクトの構築、あるいは`Activatable.exportObject`の明示的な呼出しによって実行されます。
`static Remote`	Activatable.`exportObject(Remote obj, ActivationID id, int port)` 起動可能なリモート・オブジェクトをRMIランタイムにエクスポートすることにより、着信呼出しの受け付けにオブジェクトを使用できるようにします。
`static Remote`	Activatable.`exportObject(Remote obj, ActivationID id, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf)` 起動可能なリモート・オブジェクトをRMIランタイムにエクスポートすることにより、着信呼出しの受け付けにオブジェクトを使用できるようにします。
`static ActivationID`	Activatable.`exportObject(Remote obj, String location, MarshalledObject<?> data, boolean restart, int port)` 指定したオブジェクトの起動記述子を(位置、データ、再起動モードを指定して)登録し、ポートを指定してそのオブジェクトをエクスポートします。
`static ActivationID`	Activatable.`exportObject(Remote obj, String location, MarshalledObject<?> data, boolean restart, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf)` 指定したオブジェクトの起動記述子を(位置、データ、再起動モードを指定して)登録し、ポートおよびクライアントとサーバー・ソケット・ファクトリを指定してそのオブジェクトをエクスポートします。
`ActivationDesc`	ActivationSystem.`getActivationDesc(ActivationID id)` 起動識別子が`id`であるオブジェクトの起動記述子を返します。
`ActivationGroupDesc`	ActivationSystem.`getActivationGroupDesc(ActivationGroupID id)` 起動グループ識別子が`id`であるグループの起動グループ記述子を返します。
`static boolean`	Activatable.`inactive(ActivationID id)` 対応する起動`id`のオブジェクトが現在停止していることをシステムに通知します。
`protected void`	ActivationGroup.`inactiveGroup()` このprotectedメソッドは、サブクラスがグループのモニターに`inactiveGroup`コールバックを行うために必要です。
`void`	ActivationMonitor.`inactiveGroup(ActivationGroupID id, long incarnation)` グループが停止していることを通知します。
`void`	ActivationMonitor.`inactiveObject(ActivationID id)` 起動グループは、グループ内のオブジェクトが停止したときに、グループのモニターの`inactiveObject`メソッドを呼び出します。
`boolean`	ActivationGroup.`inactiveObject(ActivationID id)` グループの`inactiveObject`メソッドは、`Activatable.inactive`メソッドの呼出しを介して間接的に呼び出されます。
`MarshalledObject`	ActivationGroup_Stub.`newInstance(ActivationID id, ActivationDesc desc)` `ActivationGroup.newInstance`のスタブ・メソッドです。
`MarshalledObject<? extends Remote>`	ActivationInstantiator.`newInstance(ActivationID id, ActivationDesc desc)` アクティベータは、インスタンシエータの`newInstance`メソッドを呼び出して、グループの中に、起動識別子が`id`で、記述子が`desc`のオブジェクトを作成し直します。
`static Remote`	Activatable.`register(ActivationDesc desc)` 起動可能なリモート・オブジェクトのオブジェクト記述子を登録して、要求に応じてリモート・オブジェクトを起動できるようにします。
`ActivationGroupID`	ActivationSystem.`registerGroup(ActivationGroupDesc desc)` 起動グループを登録します。
`ActivationID`	ActivationSystem.`registerObject(ActivationDesc desc)` `registerObject`メソッドは、起動記述子`desc`の登録、および起動可能なリモート・オブジェクトの起動識別子の取得に使います。
`ActivationDesc`	ActivationSystem.`setActivationDesc(ActivationID id, ActivationDesc desc)` 起動識別子が`id`であるオブジェクトの起動記述子`desc`を設定します。
`ActivationGroupDesc`	ActivationSystem.`setActivationGroupDesc(ActivationGroupID id, ActivationGroupDesc desc)` 起動グループ識別子が`id`であるオブジェクトの起動グループ記述子`desc`を設定します。
`void`	ActivationSystem.`shutdown()` 起動システムを停止します。
`static void`	Activatable.`unregister(ActivationID id)` `id`に関連した起動記述子の登録を取り消します。
`void`	ActivationSystem.`unregisterGroup(ActivationGroupID id)` 起動グループを削除します。
`void`	ActivationSystem.`unregisterObject(ActivationID id)` `ActivationSystem`で登録された起動ID、および関連した記述子を削除します。オブジェクトは、その起動IDで起動できなくなります。

RemoteExceptionをスローするjava.rmi.activationのコンストラクタ
コンストラクタと説明
`Activatable(ActivationID id, int port)` 指定されたポート上でオブジェクトを起動またはエクスポートするために使うコンストラクタです。
`Activatable(ActivationID id, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf)` 指定されたポート上でオブジェクトを起動またはエクスポートするために使うコンストラクタです。
`Activatable(String location, MarshalledObject<?> data, boolean restart, int port)` このオブジェクトの起動記述子を(位置、データ、再起動モードを指定して)登録し、ポートを指定してオブジェクトをエクスポートすることにより、起動可能なリモート・オブジェクトを構築します。
`Activatable(String location, MarshalledObject<?> data, boolean restart, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf)` このオブジェクトの起動記述子を(位置、データ、再起動モードを指定して)登録し、ポートおよびクライアントとサーバー・ソケット・ファクトリを指定してオブジェクトをエクスポートすることにより、起動可能なリモート・オブジェクトを構築します。
`ActivationGroup(ActivationGroupID groupID)` 指定された起動グループ識別子を持つ起動グループを構築します。

java.rmi.dgcでのRemoteExceptionの使用

RemoteExceptionをスローするjava.rmi.dgcのメソッド
修飾子と型	メソッドと説明
`void`	DGC.`clean(ObjID[] ids, long sequenceNum, VMID vmid, boolean strong)` cleanメソッドは、idsで表される各リモート・オブジェクト内の参照リストからvmidを削除します。
`Lease`	DGC.`dirty(ObjID[] ids, long sequenceNum, Lease lease)` dirtyメソッドは、配列idsに含まれるオブジェクト識別子に関連したリモート・オブジェクト参照の貸出しを要求します。

java.rmi.registryでのRemoteExceptionの使用

RemoteExceptionをスローするjava.rmi.registryのメソッド
修飾子と型	メソッドと説明
`void`	Registry.`bind(String name, Remote obj)` このレジストリ内の特定の`name`にリモート参照をバインドします。
`static Registry`	LocateRegistry.`createRegistry(int port)` ローカル・ホスト上に、指定された`port`でリクエストを受け付ける`Registry`インスタンスを作成してエクスポートします。
`static Registry`	LocateRegistry.`createRegistry(int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf)` カスタム・ソケット・ファクトリを使用してそのインスタンスとの通信を行う`Registry`インスタンスを、ローカル・ホスト上で作成およびエクスポートします。
`static Registry`	LocateRegistry.`getRegistry()` デフォルトのレジストリ・ポートである1099番ポートを使用するローカル・ホスト用のリモート・オブジェクト`Registry`への参照を返します。
`static Registry`	LocateRegistry.`getRegistry(int port)` 指定された`port`を使用するローカル・ホスト用のリモート・オブジェクト`Registry`への参照を返します。
`static Registry`	LocateRegistry.`getRegistry(String host)` デフォルト・レジストリ・ポートである1099番ポートを使用し、指定された`host`上で動作するリモート・オブジェクト`Registry`への参照を返します。
`static Registry`	LocateRegistry.`getRegistry(String host, int port)` 指定された`port`を使用し、指定された`host`上で動作するリモート・オブジェクト`Registry`への参照を返します。
`static Registry`	LocateRegistry.`getRegistry(String host, int port, RMIClientSocketFactory csf)` 指定された`port`を使用し、指定された`host`上で動作するリモート・オブジェクト`Registry`への、ローカルに作成されたリモート参照を返します。
`String[]`	Registry.`list()` このレジストリ内にバインドされた名前の配列を返します。
`Remote`	Registry.`lookup(String name)` このレジストリ内の特定の`name`にバインドされているリモート参照を返します。
`void`	Registry.`rebind(String name, Remote obj)` このレジストリ内の特定の`name`へのバインディングを特定のリモート参照に置き換えます。
`Registry`	RegistryHandler.`registryImpl(int port)` 非推奨。代替はありません。Java 2プラットフォームv1.2以降は、RMIはレジストリの実装を取得するために`RegistryHandler`を使用しません。
`Registry`	RegistryHandler.`registryStub(String host, int port)` 非推奨。代替はありません。Java 2プラットフォームv1.2以降は、RMIはレジストリのスタブを取得するために`RegistryHandler`を使用しません。
`void`	Registry.`unbind(String name)` このレジストリの特定の`name`へのバインディングを削除します。

java.rmi.serverでのRemoteExceptionの使用

java.rmi.serverでのRemoteExceptionのサブクラス
修飾子と型	クラスと説明
`class`	`ExportException` `ExportException`は、リモート・オブジェクトのエクスポートの試みが失敗した場合にスローされる`RemoteException`です。
`class`	`SkeletonMismatchException` 非推奨。代替はありません。スケルトンは、Java 2プラットフォームv1.2以降のリモート・メソッド呼出しでは不要になりました。
`class`	`SkeletonNotFoundException` 非推奨。代替はありません。スケルトンは、Java 2プラットフォームv1.2以降のリモート・メソッド呼出しでは不要になりました。
`class`	`SocketSecurityException` 非推奨。このクラスは廃止されました。かわりに`ExportException`を使用してください。

RemoteExceptionをスローするjava.rmi.serverのメソッド
修飾子と型	メソッドと説明
`void`	RemoteRef.`done(RemoteCall call)` 非推奨。 JDK 1.2形式のスタブは、このメソッドを使用しなくなりました。リモート参照への一連のメソッド呼び出し(`newCall`、`invoke`、および`done`)を使用する代わりに、スタブはリモート参照で1つのメソッド`invoke(Remote, Method, Object[], int)`を使用して、パラメータの整列化、リモート・メソッドの実行、および戻り値の非整列化を実行します。
`static RemoteStub`	UnicastRemoteObject.`exportObject(Remote obj)` 非推奨。このメソッドは、静的スタブのみをサポートするため、非推奨になりました。代わりに`exportObject(Remote, port)`または`exportObject(Remote, port, csf, ssf)`を使用してください。
`static Remote`	UnicastRemoteObject.`exportObject(Remote obj, int port)` リモート・オブジェクトをエクスポートして、入接続呼の受信に使用できるようにします。指定されたポートを使用します。
`static Remote`	UnicastRemoteObject.`exportObject(Remote obj, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf)` リモート・オブジェクトをエクスポートして、入接続呼の受信に使用できるようにします。指定されたソケット・ファクトリによって特定されたトランスポートを使用します。
`RemoteStub`	ServerRef.`exportObject(Remote obj, Object data)` 非推奨。指定されたRemoteオブジェクトに対するクライアント・スタブ・オブジェクトを作成します。
`RemoteCall`	RemoteRef.`newCall(RemoteObject obj, Operation[] op, int opnum, long hash)` 非推奨。 JDK 1.2形式のスタブは、このメソッドを使用しなくなりました。スタブのリモート参照で一連のメソッド呼び出し(`newCall`、`invoke`、および`done`)を使う代わりに、スタブはリモート参照で1つのメソッド`invoke(Remote, Method, Object[], int)`を使用して、パラメータの整列化、リモート・メソッドの実行、および戻り値の非整列化を実行します。

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

javax.activityでのRemoteExceptionの使用

javax.activityでのRemoteExceptionのサブクラス
修飾子と型	クラスと説明
`class`	`ActivityCompletedException` この例外は、Activityコンテキストにアクセスする任意のメソッドで、処理の継続が不可能であることを示す場合にスローされる可能性があります。
`class`	`ActivityRequiredException` この例外は、Activityコンテキストが必須のメソッドでActivityコンテキストを受け取れなかった場合にコンテナによってスローされます。
`class`	`InvalidActivityException` この例外は、Activityコンテキストがアクセスされ、試行された呼び出しまたはその呼出しに対応するActivityコンテキストがActivityの現在の状態と一致していない場合にスローされる可能性があります。

javax.management.remote.rmiでのRemoteExceptionの使用

RemoteExceptionをスローするjavax.management.remote.rmiのメソッド
修飾子と型	メソッドと説明
`String`	RMIServer.`getVersion()` このコネクタ・サーバーが認識するRMIコネクタ・プロトコルのバージョンです。
`String`	RMIServerImpl_Stub.`getVersion()`

javax.rmiでのRemoteExceptionの使用

RemoteExceptionをスローするjavax.rmiのメソッド
修飾子と型	メソッドと説明
`static void`	PortableRemoteObject.`connect(Remote target, Remote source)` リモート通信準備のできたリモート・オブジェクトを作成します。
`static void`	PortableRemoteObject.`exportObject(Remote obj)` サーバー・オブジェクトがリモート呼出しを受信できるようにします。

RemoteExceptionをスローするjavax.rmiのコンストラクタ
コンストラクタと説明
`PortableRemoteObject()` `exportObject(this)`を呼び出してオブジェクトを初期化します。

javax.rmi.CORBAでのRemoteExceptionの使用

RemoteExceptionを返すjavax.rmi.CORBAのメソッド
修飾子と型	メソッドと説明
`static RemoteException`	Util.`mapSystemException(SystemException ex)` SystemExceptionをRemoteExceptionへマップします。
`RemoteException`	UtilDelegate.`mapSystemException(SystemException ex)` `Util.mapSystemException(org.omg.CORBA.SystemException)`に対する委譲呼出しです。
`static RemoteException`	Util.`wrapException(Throwable orig)` 実装メソッドによってスローされた例外をラップします。
`RemoteException`	UtilDelegate.`wrapException(Throwable obj)` `Util.wrapException(java.lang.Throwable)`に対する委譲呼出しです。

RemoteExceptionをスローするjavax.rmi.CORBAのメソッド
修飾子と型	メソッドと説明
`void`	Stub.`connect(ORB orb)` このスタブをORBに接続します。
`void`	PortableRemoteObjectDelegate.`connect(Remote target, Remote source)` `PortableRemoteObject.connect(java.rmi.Remote, java.rmi.Remote)`に対する委譲呼出しです。
`void`	StubDelegate.`connect(Stub self, ORB orb)` `Stub.connect(org.omg.CORBA.ORB)`に対する委譲呼出しです。
`static Object`	Util.`copyObject(Object obj, ORB orb)` オブジェクトをコピーまたは接続します。
`Object`	UtilDelegate.`copyObject(Object obj, ORB orb)` `Util.copyObject(java.lang.Object, org.omg.CORBA.ORB)`に対する委譲呼出しです。
`static Object[]`	Util.`copyObjects(Object[] obj, ORB orb)` オブジェクトの配列をコピーまたは接続します。
`Object[]`	UtilDelegate.`copyObjects(Object[] obj, ORB orb)` `Util.copyObjects(java.lang.Object[], org.omg.CORBA.ORB)`に対する委譲呼出しです。
`void`	PortableRemoteObjectDelegate.`exportObject(Remote obj)` `PortableRemoteObject.exportObject(java.rmi.Remote)`に対する委譲呼出しです。
`static boolean`	Util.`isLocal(Stub stub)` `isLocal`メソッドが`RemoteException`をスローできることを除き、`ObjectImpl._is_local`と同じセマンティックスを持ちます。
`boolean`	UtilDelegate.`isLocal(Stub stub)` `Util.isLocal(javax.rmi.CORBA.Stub)`に対する委譲呼出しです。

javax.transactionでのRemoteExceptionの使用

javax.transactionでのRemoteExceptionのサブクラス
修飾子と型	クラスと説明
`class`	`InvalidTransactionException` この例外は、その要求によって無効なトランザクション・コンテキストが伝送されたことを示します。
`class`	`TransactionRequiredException` この例外は、ある要求によってnullのトランザクション・コンテキストが伝送されたが、ターゲット・オブジェクトにアクティブなトランザクションが必要なことを示します。
`class`	`TransactionRolledbackException` この例外は、要求の処理に関連付けられているトランザクションがロールバックされた、またはロールバックするようにマークされたことを示します。

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