Java™ RMI リリースノート
for JDK™ 6
Java™ SE Development Kit (JDK) 6 の拡張機能
- JDK 6 Update 45 での RMI への変更
JDK 6 Update 45 以降では、RMI プロパティー
java.rmi.server.useCodebaseOnlyがデフォルトでtrueに設定されています。以前のリリースでは、デフォルト値はfalseでした。このデフォルト値への変更により、RMI ベースのアプリケーションが予期せず停止することがあります。一般的な症状は、ネストされた
java.lang.ClassNotFoundExceptionを含むjava.rmi.UnmarshalExceptionを含んだスタックトレースです。詳細は、「JDK 7 の機能拡張」を参照してください。
java.rmi.MarshalledObjectがジェネリックになりました- クラス
MarshalledObjectに、格納されている直列化されたオブジェクトの型を表す型パラメータが用意されました。 - バグの修正: リモートオブジェクトのアンエクスポート後に明示的な TCP ポートが解放される (4457683)
- 以前のリリースでは、明示的な (匿名でない) TCP ポートでリモートオブジェクトがエクスポートされると、そのポートでエクスポートされたリモートオブジェクトのライフサイクルとは関係なく、そのポートにバインドされたサーバーソケットは、仮想マシンの有効期間中開いたままになっていました。このバグが修正され、指定された非匿名ポートでエクスポートされたすべてのリモートオブジェクトがアンエクスポートされると (明示的に、または分散ガベージコレクションによって)、関連するサーバーソケットが閉じるようになりました。匿名 TCP ポートの場合にも同様のバグ (6279965) があります。
- バグの修正: クライアントソケットファクトリのガベージコレクション (4486732)
- 以前のリリースでは、指定された仮想マシンで
nullでない RMIClientSocketFactory を含むリモートスタブでリモート呼び出しが行われると、そのファクトリオブジェクトまたは等価なファクトリオブジェクトは仮想マシンで永久にアクセス可能なままとなっていました。そのため、そのオブジェクト (およびそのオブジェクトを定義するクラスローダー) はガベージコレクトされませんでした。このバグが修正されました。リモートオブジェクトのエクスポートに使用されるソケットファクトリの場合にも同様のバグ (6332603) があります。 - デフォルトのガベージコレクション間隔が 1 時間に延長された (6200091)
- 以前のリリースでは、ライブなリモート参照またはエクスポートされたリモートオブジェクトが存在する間に、RMI 実装によってローカルヒープのガベージコレクタが行われる最大間隔 (システムプロパティー
sun.rmi.dgc.client.gcIntervalおよびsun.rmi.dgc.server.gcIntervalによって制御される) は、デフォルトで 1 分でした。デフォルトの間隔は 1 時間になり、特別な構成がなくても、アプリケーションでサイズの大きいヒープを利用しやすくなりました。
以前のリリースでの拡張機能と変更
- JDK 5 Update 45 での RMI への変更
JDK 5 Update 45 以降では、RMI プロパティー
java.rmi.server.useCodebaseOnlyがデフォルトでtrueに設定されています。以前のリリースでは、デフォルト値はfalseでした。このデフォルト値への変更により、RMI ベースのアプリケーションが予期せず停止することがあります。一般的な症状は、ネストされた
java.lang.ClassNotFoundExceptionを含むjava.rmi.UnmarshalExceptionを含んだスタックトレースです。詳細は、「JDK 7 の機能拡張」を参照してください。
- スタブクラスの動的な生成 (5.0 以降)
- このリリースでは、実行時にスタブクラスを動的に生成するためのサポートが追加されたので、リモートオブジェクト用のスタブクラスを事前に生成する Java Remote Method Invocation (Java RMI) スタブコンパイラ (
rmic) を使う必要がなくなりました。以前のバージョンで実行されるクライアントをサポートする必要があるリモートオブジェクトに対しては、rmicを使用して事前にスタブクラスを生成する必要があることに注意してください。コンストラクタ、または
java.rmi.server.UnicastRemoteObjectクラスまたはjava.rmi.activation.Activatableクラスの static メソッドexportObject1 を使用してアプリケーションがリモートオブジェクトをエクスポートしても、そのリモートオブジェクトのクラスに対応する生成済みスタブクラスが読み込まれない場合、リモートオブジェクトのスタブは、呼び出しハンドラとしてjava.rmi.server.RemoteObjectInvocationHandler付きのjava.lang.reflect.Proxyインスタンスとなります。そのクラスは、動的に作成されます。java.rmi.server.ignoreStubClassesシステムプロパティーを"true"に設定することで、動的に作成されたスタブクラスを既存のアプリケーションが無条件で使用するように配置できます。つまり、スタブクラスが事前に生成されていたかどうかにかかわらず使用できるということです。このプロパティーが"true"に設定されていると、生成済みスタブクラスが使用されることはありません。注:
- リモートオブジェクトがリリース 5.0 よりも前のクライアントを持っている場合、そのリモートオブジェクトは、
rmicで事前に生成されたスタブクラスを使う必要があります。または、クライアントがClassNotFoundExceptionを入手して、リモートオブジェクトのスタブの直列化を復元します。リリース 5.0 より前のクライアントは、動的に生成されたスタブクラスのインスタンスを読み込むことができません。このようなクラスにはRemoteObjectInvocationHandlerのインスタンスが含まれていますが、このリリースより前のバージョンでは利用できないからです。 - J2SE 5.0 リリースより前のバージョンでは、リモートオブジェクトをエクスポートする際にそのリモートオブジェクトのクラスに対応する生成済みスタブクラスを読み込むことができないと、
java.rmi.StubNotFoundExceptionがスローされます。動的に生成されたスタブクラスのサポートが追加されたため、生成済みのスタブクラスを持たないリモートオブジェクトをエクスポートしても、そのまま処理が続行されます。リリース 5.0 より前のバージョンをサポートするサーバーアプリケーションを配備しているユーザーは、エクスポート時にスタブクラスがなくてもエラーは報告されませんが、引き続きそのサーバーのリモートオブジェクトのクラスに対応するスタブクラスを必ず事前に生成する必要があります。代わりにこのようなエラーは、動的に生成されたスタブクラスの直列化を復元するときに、5.0 より前のリリースのクライアントに報告されます。
1 static メソッド
UnicastRemoteObject.exportObject(Remote)は、java.rmi.server.RemoteStubを返すように宣言されています。そのため、動的に生成されたスタブクラスをそれ自体のスタブとして使用するためにリモートオブジェクトをエクスポートする場合には使用できません。動的に生成されたスタブクラスのインスタンスは、java.lang.reflect.Proxyインスタンスであり、RemoteStubに割り当てられません。 - リモートオブジェクトがリリース 5.0 よりも前のクライアントを持っている場合、そのリモートオブジェクトは、
- 標準 SSL/TLS ソケットファクトリクラス (5.0 以降)
- 今回のリリースでは、標準の Java RMI ソケットファクトリクラスである
javax.rmi.ssl.SslRMIClientSocketFactoryとjavax.rmi.ssl.SslRMIServerSocketFactoryが追加されています。これらのクラスでは、Java Secure Socket Extension (JSSE) を使って、Secure Sockets Layer (SSL) プロトコルまたは Transport Layer Security (TLS) プロトコルを介して通信します。これらのソケットファクトリクラスでは、Java RMI で簡単に JSSE を使う方法が提供されるので、リモートメソッド呼び出しのための整合性、暗号化による機密性、サーバー認証、およびクライアント認証 (任意) を強化できます。Java RMI でのカスタムソケットファクトリの使い方の詳細は、「Java RMI によるカスタムソケットファクトリの使用」チュートリアルを参照してください。構成を含む JSSE の詳細は、「JSSE リファレンスガイド」を参照してください。 inetd/xinetdからrmidまたは Java RMI サーバーを起動する (5.0 以降)System.inheritedChannelメソッドにより提供される新しい機能によって、アプリケーションは、仮想マシン (VM) を起動したプロセスから継承されるチャネル (java.nio.channels.SocketChannelまたはjava.nio.channels.ServerSocketChannelなど) を取得することができます。この継承チャネルは、SocketChannelの場合は単一の着信接続を行うため、ServerSocketChannelの場合は複数の着信接続を受け入れるために使用できます。その結果、inetd(Solaris(TM) オペレーティングシステム) またはxinetd(Linux) によって起動された Java ネットワーキングアプリケーションは、inetd/xinetdから継承されたSocketChannelまたはServerSocketChannelを取得できるようになりました。この機能の追加によって、Java RMI 起動デーモン
rmidは、着信した接続要求を受け取ったときにのみrmidを起動できるように、inetd/xinetdからの起動をサポートするように拡張されました。この機能をサポートするためのrmidの拡張機能についての詳細は、rmid(Solaris オペレーティングシステム用) のツールページを参照してください。rmidを起動するようにinetdを構成する方法についての詳細は、「rmidを起動するinetdの構成」チュートリアルを参照してください。Java RMI を使用するアプリケーションは、
inetdまたはxinetdから起動されるように設計することもできます。この技法を実装する方法の例については、「inetdから起動されるサービスの設計」チュートリアルを参照してください。rmicの現在のデフォルトのスタブプロトコルのバージョン-v1.2(5.0 以降)- 生成されたクラスに使用される JRMP スタブプロトコルのバージョンを指定するオプションなしで
rmicが実行されると、前のリリースの-vcompatオプションの代わりに-v1.2オプションが指定されているかのように実行されます。つまり、この変更によって、デフォルトでは、
rmicはスケルトンクラスは生成せず、1.2 スタブプロトコルのバージョンだけを実装するスタブクラスを生成するようになりました。JDK 1.1 で実行されるクライアントをサポートするためにリモート実装クラスを構築する必要がある場合は、-vcompatオプションを明示的に指定する必要があります。(さらに、上記のようにリモート実装クラスがリリース 5.0 より前のバージョンで実行されるクライアントをサポートする必要がない場合は、そのようなクラスのためにrmicを実行する必要はありません。)これらのコマンド行オプションの詳細については、
rmicのツールドキュメント (Solaris および Linux 用、Windows 用) を参照してください。 rmicがクラスパス内の任意のソースファイルをコンパイルすることはない (5.0 以降)- 以前のリリースでは、入力クラスファイルの処理中に、クラスパス内にある任意の
.javaソースファイルをrmicがコンパイルしようとすることがありました。リリース 5.0 では、rmicは自ら生成したスタブ、スケルトン、またはタイクラス以外のソースファイルをコンパイルしようとすることはありません。rmicに渡されるリモート実装クラスは、そのクラスが依存しているすべてのクラスおよびインタフェースと同様に、rmicが実行される前にすでにjavacで正常にコンパイルされています。既存の構築手順が、一部のアプリケーションソースファイルをコンパイルするrmicの以前の動作に依存している場合、その構築手順を修正し、rmicを実行する前に、必要なすべてのクラスがjavacで正しくコンパイルされるようにしてください。 - サーバー側スタックトレースがリモートの例外に保持される (1.4 以降)
- Java RMI ランタイム実装が、以前のリリースで行なっていたようにクライアント側スタックトレースを記入するだけでなく、リモート呼び出しからスローされる例外のサーバー側スタックトレース情報を保持するようになりました。したがって、そのような例外がクライアントコードにアクセス可能になると、そのスタックトレースには、元のサーバー側トレースデータと、それに続くクライアント側トレースのすべてが含まれることになります。
この機能は、J2SE 1.4 の java.lang.Throwable の新しい「スタックトレース情報へのプログラムによるアクセス」機能によって可能になりました。これには、デフォルトの直列化形式の
Throwableのスタックトレースデータ部分の作成が含まれます。クライアント側 Java RMI ランタイム実装は、この機能と連携するために、以前のリリースのように単にクライアント側トレースで上書きするのではなく、クライアント側トレースを非整列化されたサーバー側トレースに追加します。特定のサーバーアプリケーションでは、パフォーマンスや機密上の理由により、J2SE 1.4 での例外のデフォルトの直列化形式の一部としてリモート呼び出しにより直列化される例外がサーバー側スタックトレースデータで発生しないようにする場合があります。そのような場合は、実装に固有のシステムプロパティーである
sun.rmi.server.suppressStackTraces
を「true」に設定すると、サーバー側 Java RMI ランタイム実装によって、リモートメソッドの呼び出しの結果、現在の仮想マシンからスローされたすべての例外のスタックトレースが消去されます。 RMIClassLoader用サービスプロバイダインタフェース (1.4 以降)java.rmi.server.RMIClassLoaderの一部の static メソッドの動作は、新しいサービスプロバイダインタフェースjava.rmi.server.RMIClassLoaderSpiのインスタンスに委譲されています。特定のアプリケーションに対する Java RMI 動的クラスのロード動作を拡張するようにサービスプロバイダを構成できます。デフォルトでは、サービスプロバイダは、RMIClassLoaderの static メソッドすべての標準動作を実装しています。詳細については、RMIClassLoaderおよびRMIClassLoaderSpiのクラスドキュメントを参照してください。- 動的なサーバーホスト名 (1.4 以降)
java.rmi.server.hostnameプロパティーが動的に更新され、そのあとのエクスポートで新しいホスト名を使用するように指示できるようになりました。したがって、新しいホスト名の値は、このプロパティーが更新されたあとにエクスポートされるオブジェクトのスタブに格納されます。- HTTP フォールバック構成の拡大 (1.4.1 以降)
- 実装固有のシステムプロパティー
sun.rmi.transport.proxy.eagerHttpFallbackが追加され、Java RMI のデフォルトのソケットファクトリが HTTP トンネリングにフォールバックする際により細かく制御できるようになりました。このプロパティーは、デフォルトのソケットファクトリを構成して、最初の (直接的な) 接続試行によってスローされた SocketException が HTTP トンネリングのトリガーになるようにします。より「積極的」になったこのフォールバック戦略は、承認されていないポートへの接続試行を無視するのではなく、拒否するファイアウォールに対処する場合に役に立つ場合があります。 java.rmi.Naming.listメソッドは返される名前にスキーマを付加することはない (1.4.1 以降)- 以前のリリースでは、
Naming.listメソッドは、返された文字列の配列に含まれる名前にスキーマrmi:を付加していました。現在の NNaming.listの実装はその仕様に合致しており、URL 形式の名前の配列を返しますが、スキームコンポーネントは含まれません。 java.rmi.activation.ActivationGroupDesc(1.3 以降)- グループのクラス名を返す
getClassNameメソッドが、システムのデフォルトグループ実装を示すnullを返すことが可能になりました。これまでは、記述子の構築時にデフォルトのグループ実装が選択された場合、getClassNameメソッドは内部の実装クラスの名前を返していました。この変更に対応するために、仮想マシン 1.3 で稼働するアプリケーションが新たな起動可能オブジェクトを
ActivationSystemに登録する場合、rmidも 1.3 を実行できるようにアップグレードする必要があります。これは、1.3 より前のrmidでは新たに登録された起動可能オブジェクトを起動できないためです。 - Java RMI スタブコンパイラ
rmic(1.3 以降) rmic(Solaris および Linux 用、Windows 用) では、スタブのデフォルトの生成先ディレクトリが、パッケージ名の付いた、現在の作業ディレクトリのサブディレクトリになりました。「-d」オプションを指定しない場合は、現在の作業ディレクトリ「.」が引数として指定されていると見なされます。デフォルトの生成先ディレクトリをオーバーライドするには、引き続き「-d」を使用できます。IDL および IIOP のスタブを生成するために、2 つの新しいオプション「
-idl」および「-iiop」が追加されました。- Java RMI 起動デーモン
rmid(1.3 以降) - デフォルトでは、
rmid(Solaris および Linux 用、Windows 用) は現在、セキュリティーポリシーファイルを要求します。 - リモートオブジェクトの直列化 (1.2.2 以降)
- 1.2.2 以前では、アンエクスポートされたリモートオブジェクトを RMI 呼び出しで渡そうとすると、
java.rmi.StubNotFoundExceptionが発生しました。リモートオブジェクトの実装を対応するスタブに置換しようとしている最中に RMI ランタイムがスタブオブジェクトを見つけられなかった場合に、この例外が発生しました。1.2.2 以降のリリースでは、アンエクスポートされたリモートオブジェクトが RMI 呼び出しで渡されても例外とはならず、スタブではなく、リモートオブジェクトが直列化されます。リモートオブジェクトの実装が直列化できない場合、アンエクスポートされたオブジェクトを RMI 呼び出しで渡そうとすると、java.rmi.RemoteExceptionとなります。この例外には、java.io.NotSerializableExceptionが入れ子にされています。