このセクションでは、次のトピックについて説明します。
このドキュメントの目的は、アプレットのデバッグを簡略化することです。ここでは、Java Plug-in でアプレットを開発する上で役立つ技術や提案を提供します。また、アプレット開発で発生しがちなエラーについても説明します。
アプレットは、Java デバッガユーティリティー jdb を使用してデバッグするようにしてください。javac で .java ファイルをコンパイルするとき、必ず -g オプションを付けることも必要です。アプレットのデバッグを開始するには、次の操作を実行します。
-agentlib:jdwp=transport=dt_shmem,address=jdbconn,server=y,suspend=n
デバッグに使用可能な実行時パラメータの詳細は、「JPDA の接続および呼び出し」を参照してください。
jdb -attach jdbconnJava デバッガ (jdb) の詳細は、「Java デバッガ」を参照してください。
Java Plug-in でアプレットのデバッグを行う場合、一度に 1 つの接続アドレスを使用してデバッグを行うのは、ブラウザの 1 つのインスタンスだけであることを確認してください。このようにしない場合、ブラウザの各インスタンスの Java Runtime が接続アドレスへの排他的なアクセスを試みるため、競合が発生します。Internet Explorer とサポートされている Mozilla ブラウザの両方でアプレットをデバッグする場合、Java Plug-in とともに Internet Explorer またはサポートされている Mozilla ブラウザのどちらかを実行するようにします。ただし、一度に両方を実行しないでください。
アクティブデスクトップ環境で Java Plug-in のアプレットをデバッグすることは推奨されていません。これは、ユーザーセッションの期間中、Internet Explorer のインスタンスが常にデスクトッププロセスで実行されているためです。
jdb の代わりに、Borland 社の JBuilder や Symantec 社の VisualCafe など、IDE からほかのデバッガを使用できます。デバッガを使用するには、これらの IDE のプロジェクトオプションを変更し、同じマシンまたはリモートマシンのブラウザプロセス内の Java Plug-in を追加する必要があります。Java コントロールパネルに、別の Java 実行時のパラメータを設定することが必要な場合もあります。詳細は、Java デバッガまたは IDE マニュアルを参照してください。
Java コンソールは、System.out および System.err メッセージをすべてリダイレクトする単純なコンソールウィンドウです。コンソールウィンドウは、デフォルトで無効になっています。Java コントロールパネルまたはタスクバーで有効にすることができます。コンソールを有効にすると、ブラウザ内で Java Plug-in を使用する際にコンソールウィンドウが表示されます。Java コンソールの詳細は、Java コンソールのドキュメントを参照してください。
Java コンソールの詳細は、「配備ガイド」の「Java コンソール」セクションを参照してください。
Java Plug-in のトレースファイルは、すべてのデバッグ、System.out、および System.err メッセージを記録します。トレースファイルはデフォルトでは無効に設定されていますが、Java コンソールが有効になると、自動的にトレースファイルも有効になります。トレースファイルは、デフォルトで、C:\Documents and Settings\<username>\Application Data\Sun\Java\Deployment\log の user.dir に格納されます。トレースファイルの命名規則は、.plugin<version>.trace です。<version> は、システムにインストールされている Java のバージョンです。
user.dir ディレクトリには、さまざまなログファイルおよびトレースファイルがあります。Windows 2000 および Windows XP では、このファイルは次の場所にあります。C:\Documents and Settings\<username>\Application Data\Sun\Java\Deployment
Application Data フォルダとその内容は、Windows ではデフォルトで非表示になっています。
javaplugin.trace プロパティーこのプロパティーは、Java Plug-in が実行時にトレースメッセージを出力するかどうかを制御します。これは、アプレットの開発者が Java Plug-in 内で起きていることを知るのに役立ちます。トレースを有効にするには、次の手順に従います。
java.security.debug プロパティーこのプロパティーは、Java Runtime Environment のセキュリティーシステムが、実行時にトレースメッセージを出力するかどうかを制御します。これは、アプレット内でセキュリティー例外がスローされた場合、または署名付きアプレットが動作しない場合に有用です。サポートされるオプションは次のとおりです。
access — checkPermission の結果をすべて出力するjar — jar の検証情報を出力するpolicy — ポリシー情報を出力するscl — SecureClassLoader が割り当てたアクセス権を出力する access には、次のオプションを指定できます。
stack — スタックトレースを含むdomain — コンテキスト内のすべてのドメインをダンプするfailure — 例外をスローする前に、アクセス権を保持しないスタックおよびドメインをダンプする たとえば、checkPermission の結果をすべて出力し、コンテキスト内のすべてのドメインをダンプするには、次の手順を実行します。
-Djava.security.debug=access:stack と入力します。 Java Plug-in の提供するドキュメントは、開発者が Java Plug-in のさまざまな機能を使用する上で役に立ちます。ドキュメント内の FAQ には、開発者がしばしば尋ねる質問が掲載されています。アプレットを開発する前に、これらのドキュメントを読んで理解しておくと、デバッグに費やす時間を大幅に節約できる場合があります。
Java Plug-in は Internet Explorer およびサポートされている Mozilla ブラウザ内で 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 の Bug Database に移動してください。バグレポートを送信する前に BugParade を検索して、同じバグがすでに報告されているかどうかを確認してください。場合によっては、回避方法が示されていることもあります。バグレポートが未提出であることを確認したら、新規バグレポートを Java Plug-in チームに送信してください。バグレポートには、次の情報を含めてください。
appletviewer で問題が発生するかどうか機能要求を送信する場合は、「Report A Bug or Request a Feature」のページから行います。送信に際しては、次の情報が含まれていることを確認してください。
Java Plug-in フィードバックエイリアス java-plugin-feedback@sun.com の目的は、カスタマが製品機能および製品全般に関するフィードバックを提出することです。このエイリアスは、バグレポートを送信するためのものではありません。バグレポートの送信は、前述の手順に従って実行してください。