JavaTM 2
Platform
Std. Ed. v1.4.0

クラス
java.rmi.RemoteException の使用

RemoteException を使用しているパッケージ
java.rmi RMI (Remote Method Invocation) のパッケージを提供します。 
java.rmi.activation RMI オブジェクト起動をサポートします。 
java.rmi.dgc RMI 分散ガベージコレクション (DGC) で使うクラスとインタフェースを提供します。 
java.rmi.registry RMI レジストリに使うクラスと 2 つのインタフェースを提供します。 
java.rmi.server RMI のサーバ側をサポートするクラスおよびインタフェースを提供します。 
javax.rmi RMI-IIOP のユーザ API が含まれています。 
javax.rmi.CORBA RMI-IIOP 用の移植可能な API が含まれています。 
javax.transaction 非整列化中に ORB 機構によってスローされた 3 つの例外が含まれています。  
 

java.rmi での RemoteException の使用
 

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

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

java.rmi.activation での RemoteException の使用
 

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

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

RemoteException をスローする java.rmi.activation のコンストラクタ
ActivationGroup(ActivationGroupID groupID)
          指定された起動グループ識別子を持つ起動グループを構築します。
Activatable(String location, MarshalledObject data, boolean restart, int port)
          指定されたポートにオブジェクトを登録およびエクスポートするために使うコンストラクタです。
Activatable(String location, MarshalledObject data, boolean restart, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf)
          指定されたポートにオブジェクトを登録およびエクスポートするために使うコンストラクタです。
Activatable(ActivationID id, int port)
          指定されたポート上でオブジェクトを起動またはエクスポートするために使うコンストラクタです。
Activatable(ActivationID id, int port, RMIClientSocketFactory csf, RMIServerSocketFactory ssf)
          指定されたポート上でオブジェクトを起動またはエクスポートするために使うコンストラクタです。
 

java.rmi.dgc での RemoteException の使用
 

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

java.rmi.registry での RemoteException の使用
 

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

java.rmi.server での RemoteException の使用
 

java.rmi.server での RemoteException のサブクラス
 class ExportException
          ExportException は、リモートオブジェクトのエクスポートが失敗した場合にスローされる RemoteException です。
 class SkeletonMismatchException
          推奨されていません。 代替はありません。スケルトンは、Java 2 プラットフォーム 1.2 以降のバージョンのリモートメソッド呼び出しでは必要ありません。
 class SkeletonNotFoundException
          推奨されていません。 代替はありません。スケルトンは、Java 2 プラットフォーム 1.2 以降のバージョンのリモートメソッド呼び出しでは必要ありません。
 class SocketSecurityException
          UnicastRemoteObject クラスまたは java.rmi.activation.Activatable クラスのコンストラクタまたは exportObject メソッドの明示的な呼び出しによってリモートオブジェクトをエクスポートしているコードが、リモートオブジェクトのエクスポート時に指定したポート番号で java.net.ServerSocket を作成する権限を持たない場合にスローされます。
 

RemoteException をスローする java.rmi.server のメソッド
static RemoteStub UnicastRemoteObject.exportObject(Remote obj)
          リモートオブジェクトをエクスポートして、入接続呼の受信に使用できるようにします。
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 形式のスタブは、このメソッドを使用しません。スタブのリモート参照で一連のメソッド呼び出し (newCallinvoke、および done) を使う代わりに、スタブはリモート参照で invoke(Remote, Method, Object[], int) メソッドだけを使って、パラメータの整列化、リモートメソッドの実行、および戻り値の非整列化を実行します。

JDK 1.2 のスタブは、rmic -v1.2 を使って生成されます。デフォルトでは、rmic は JDK 1.1 および Java 2 SDK と互換性のあるスタブを生成します。互換性のあるスタブは、rmic -vcompat を使っても生成できます。

 void RemoteRef.done(RemoteCall call)
          推奨されていません。 JDK 1.2 形式のスタブは、このメソッドを使用しません。リモート参照で一連のメソッド呼び出し (newCallinvoke、および done) を使う代わりに、スタブはリモート参照で invoke(Remote, Method, Object[], int) メソッドだけを使ってパラメータの整列化、リモートメソッドの実行、および戻り値の非整列化を実行します。

JDK 1.2 のスタブは、rmic -v1.2 を使って生成されます。デフォルトでは、rmic は JDK 1.1 および Java 2 SDK と互換性のあるスタブを生成します。互換性のあるスタブは、rmic -vcompat を使っても生成できます。

 

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

javax.rmi での RemoteException の使用
 

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

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

javax.rmi.CORBA での RemoteException の使用
 

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

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

javax.transaction での RemoteException の使用
 

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


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.