このセクションでは、次のトピックについて説明します。
これまでは、Java Plug-in で Java アプレットのデバッグを行うことは簡単ではありませんでした。その理由の 1 つとして、アプレットが、Java 2 Runtime Environment、Java Plug-in、およびブラウザ自体の提供する多くのサービスおよび機能を利用することが挙げられます。アプレットが正常に動作しない場合、開発者は時間を費やして問題を分析する必要があります。
このドキュメントの目的は、デバッグ処理を簡略化することです。ここでは、Java Plug-in でアプレットを開発する上で役立つ技術や提案を提供します。また、アプレット開発で陥りがちな誤りについても説明します。
アプレットのデバッグを行うには、適切なバージョンの JDK がマシンにインストールされている必要があります。また、javac で .java ファイルをコンパイルするときは、必ず -g オプションを付ける必要があります。アプレットのデバッグを開始するには、次の操作を実行します。
-Djava.compiler=NONE -Xnoagent -Xdebug -Xrunjdwp:transport=dt_shmem,address= <connection-address>,server=y,suspend=n
<connection-address> には、java デバッガがあとで JVM への接続に使用する任意の文字列を指定できます。次に例を示します。
-Djava.compiler=NONE -Xnoagent -Xdebug -Xrunjdwp:transport=dt_shmem,address=2502,server=y,suspend=n
デバッグに使用可能な実行時パラメータの詳細は、「JPDA の接続および呼び出し」を参照してください。
>jdk-path> の JDK <version>」を選択します。ここで、<version> は Java Plug-in のバージョンを、<jdk-path> は JDK のインストールパスを表します。たとえば、「C:\jdk1.4 の JDK1.4 」のようになります。
javac で -g オプションを付けてコンパイルされていることを確認してください。
jdb -attach <connection address> を実行します。<connection address> には、ステップ 1 で説明した名前を指定してください。たとえば、<connection address> が 2502 の場合、実行するコマンドは次のようになります。
jdb -attach 2502Java デバッガ (jdb) の詳細は、「Java デバッガ」を参照してください。
Java Plug-in でアプレットのデバッグを行う場合、一度に 1 つの接続アドレスを使用してデバッグを行うのは、ブラウザの 1 つのインスタンスだけであることを確認してください。このようにしない場合、ブラウザの各インスタンスの Java Runtime が接続アドレスへの排他的なアクセスを試みるため、競合が発生します。Internet Explorer と Netscape Navigator の両方でアプレットをデバッグする場合、Java Plug-in とともに Internet Explorer または Netscape Navigator のどちらかを実行するようにします。ただし、一度に両方を実行しないでください。
アクティブデスクトップ環境で Java Plug-in のアプレットをデバッグすることは推奨されていません。これは、ユーザセッションの期間中、Internet Explorer のインスタンスが常にデスクトッププロセスで実行されているためです。
jdb の代わりに、Inprise 社の JBuilder や Symantac 社の VisualCafe など、他の Java 2 デバッガを使用できます。デバッガを使用するには、これらの IDE のプロジェクトオプションを変更し、同じマシンまたはリモートマシンのブラウザプロセス内の Java Plug-in を追加する必要があります。Java Plug-in コントロールパネルに、別の Java 実行時のパラメータを設定することが必要な場合もあります。詳細は、Java 2 デバッガまたは IDE マニュアルを参照してください。
Java Plug-in コンソールは、Java Plug-in の中でももっとも強力なツールの 1 つです。これは、System.outおよび System.err メッセージをすべてリダイレクトする単純なコンソールウィンドウです。コンソールウィンドウは、デフォルトでは無効に設定されていますが、Java Plug-in コントロールパネルまたはツールバーで有効にすることができます。コンソールを有効にすると、ブラウザ内で Java Plug-in を使用する際にコンソールウィンドウが表示されます。
このファイルは、Java Plug-in コンソールと同様、すべての System.out および System.err メッセージを記録します。トレースファイルはデフォルトでは無効に設定されていますが、Java Plug-in コンソールが有効になると、自動的にトレースファイルも有効になります。トレースファイルは、通常、.plugin<version>.trace という名前で user.dir に格納されます。たとえば、Windows NT の場合、このファイルは C:\WINNT\Profiles\<username>\.plugin<version>.trace に配置されます。
javaplugin.trace プロパティ このプロパティは、Java Plug-in が実行時にトレースメッセージを出力するかどうかを制御します。これは、アプレットの開発者が Java Plug-in 内で起きていることを知るのに役立ちます。設定可能な値は、true または false です。このプロパティのデフォルトは false です。このプロパティを有効にするには、Java Plug-in コントロールパネルの [詳細] パネルにある [Java 実行時のパラメータ] フィールドに -Djavaplugin.trace=true を設定します。
java.security.debug プロパティこのプロパティは、Java 2 Runtime Environment のセキュリティシステムが、実行時にトレースメッセージを出力するかどうかを制御します。これは、アプレット内でセキュリティ例外がスローされた場合、または署名付きアプレットが動作しない場合に有用です。サポートされるオプションは次のとおりです。
access — checkPermission の結果をすべて出力するjar — jar の検証情報を出力するpolicy — ポリシー情報を出力するscl — SecureClassLoader が割り当てたアクセス権を出力する access には、次のオプションを指定できます。
stack — スタックトレースを含むdomain — コンテキスト内のすべてのドメインをダンプするfailure — 例外をスローする前に、アクセス権を保持しないスタックおよびドメインをダンプする たとえば、checkPermission の結果をすべて出力し、コンテキスト内のすべてのドメインをダンプするには、Java Plug-in コントロールパネルの [詳細] パネルにある [Jave 実行時のパラメータ] フィールドに -Djava.security.debug=access:stack を設定します。
Java Plug-in の提供するドキュメントは、開発者が Java Plug-in のさまざまな機能を使用する上で役に立ちます。ドキュメント内の FAQ には、開発者がしばしば尋ねる質問が掲載されています。アプレットを開発する前に、これらのドキュメントを読んで理解しておくと、デバッグに費やす時間を大幅に節約できる場合があります。
Java Plug-in は Internet Explorer および Netscape Navigator 内で Java 2 Runtime Environment を提供するとはいえ、機能の大半は Java Plug-in ではなく、Java 2 Runtime 自体により提供されます。このため、Java Plug-in 内で問題が発生した場合、原因は Java Plug-in、Java 2 Runtime 自体、またはユーザエラーのいずれかにあります。バグの原因がどこにあるかを識別するのは、バグの評価および修正の速度に影響するため、非常に重要です。以下に、バグを分離するのに役立つ提案を示します。
appletviewer でアプレットを実行します。Java Plug-in は主に appletviewer から派生したものなので、appletviewer からの問題点も継承しています。この手順は、Java Plug-in の提供する特定のブラウザ機能 (HTTPS や RSA 署名など) をアプレットが必要としない場合にだけ実行してください。appletviewer で失敗する場合、問題は大抵 Java Plug-in にあるのではなく Java 2 Runtime Environment にある可能性があります。 appletviewer では失敗しない場合、Java Plug-in の問題かユーザエラーのどちらかの可能性があります。アプレットのコードを表示して、実行環境に関して何らかの前提条件が存在するかどうかを確認してください。たとえば、appletviewer では、カレントディレクトリが、appletviewer 起動時のシェル内のカレントディレクトリに設定されるのに対し、Java Plug-in のカレントディレクトリはブラウザのディレクトリに設定することが可能です。したがって、カレントディレクトリからのリソースのロードは appletviewer では実行できますが、Java Plug-in ではできません。バグレポートを送信するときは、Java Development Connection の BugParade に移動してください。バグレポートを送信する前に BugParade を検索して、同じバグがすでに報告されているかどうかを確認してください。場合によっては、回避方法が示されていることもあります。バグレポートが未提出であることを確認したら、新規バグレポートを Java Plug-in チームに送信してください。バグレポートには、次の情報を含めてください。
appletviewer で問題が発生するかどうか機能要求を送信する場合は、「Report A Bug or Request a Feature」のページから行います。送信に際しては、次の情報が含まれていることを確認してください。
Java Plug-in フィードバックエイリアス java-plugin-feedback@sun.com の目的は、カスタマが製品機能および製品全般に関するフィードバックを提出することです。このエイリアスは、バグレポートを送信するためのものではありません。バグレポートの送信は、前述の手順に従って実行してください。