このトピックでは、System.outおよびSystem.errをコンソール・ウィンドウにリダイレクトするデバッグを支援する、Javaコンソールについて説明します。このコンソールは、Java Plug-inで動作するアプレットや、Java Web Startで動作するアプリケーションで使用できます。
このトピックの内容は次のとおりです。
図22-1に、アプレットおよびJava Web StartアプリケーションをデバッグするためにJavaコンソールで使用可能なオプションを示します。
オプションは、Javaコンソール・ウィンドウがフォーカスを持っているときに該当の文字または数字を入力することによって選択します。表22-1では、オプションを説明します。
表22-1 Javaコンソールのデバッグ・オプション
キー | 説明 |
---|---|
c: |
Javaコンソール・ウィンドウをクリアします。 |
f: |
ファイナライズ・キュー内のオブジェクトのファイナライズをトリガーしてから、メモリー情報を表示します。Memoryは、JREが使用する現在のヒープ・サイズを表します。Freeは、ヒープ内で使用していない使用可能なメモリーです。パーセント(xx%)は、全ヒープ・サイズに占める空き記憶領域の割合です。 |
g: |
ガベージ・コレクションをトリガーし、上記と同様のメモリー情報を表示します。 |
h: |
ここで説明しているのと同じヘルプ・メッセージを表示します。 |
l: |
Java Plug-inのキャッシュされた |
m: |
上記と同様、ヒープ・メモリーの使用率を表示します。 |
o: |
ロギングをトリガーし、Java Plug-inコンソールからログ・ファイルへの出力を指示します。 |
p: |
プロキシ構成を再ロードします。 |
q: |
Javaコンソールをメイン画面から消します。 |
r: |
ポリシー構成を再ロードします。 |
s: |
システム・プロパティを出力します。これは、主にデバッグに使用します。 |
t: |
既存のスレッド・グループをすべて出力します。最初に示されるグループは |
x: |
キャッシュ内のすべての あらかじめJavaコンソールに「x」と入力して、クラス・ローダー・キャッシュをクリアしておくと、アプレットの含まれているページをリフレッシュするか、そのページにふたたび戻ったときに、変更されたJARファイルがサーバーからダウンロードされます。 |
0-5: |
22.2項「トレースおよびロギング」22.2項「トレースおよびロギング」で説明されているように、トレース・レベル・オプションを設定します。 |
トレースとは、Javaコンソールでの任意の出力をトレース・ファイルにリダイレクトする機能です。トレースと同様に、ロギングとはJavaコンソールでの任意の出力を、Java Logging APIを使用してログ・ファイルにリダイレクトする機能のことです。
Java Plug-inおよびJava Web Start用のトレースを有効にするには、deployment.trace
プロパティをtrue
に設定します。このプロパティにより、Java Plug-inおよびJava Web Start内部のすべてのトレース機能が有効になります。より詳細なトレースを有効にするには、deployment.trace.level
プロパティを使用できます。deployment.trace.level
プロパティには、次の値のいずれかを使用できます。
basic
cache
net
security
ext
liveconnect
drs
すべてのトレース・レベルを使用するには、deployment.trace.level
をall
に設定します。
実行中にトレースを有効にするには、Javaコンソールでトレース・レベル・オプション(0-5)を設定できます。これらのオプションには次の意味があります。
0: オフ
1: 基本
2: ネットワーク、キャッシュおよび基本
3: セキュリティ、ネットワークおよび基本
4: 拡張機能、セキュリティ、ネットワークおよび基本
5: LiveConnect、拡張機能、セキュリティ、ネットワーク、temp、基本およびデプロイメント・ルール・セット
詳細は、22.1項「Javaコンソールでのデバッグ・オプション」を参照してください。
詳細にトレースを設定するもう1つの方法は、Javaコントロール・パネルを使用することです。たとえば、すべてのトレースを有効にする(前述のオプション5)には、「Javaランタイム・パラメータ」テキスト・フィールドに次のオプションを入力します。
-Ddeployment.trace=true -Ddeployment.trace.level=all
詳細は、20.3.2項「Javaランタイム・パラメータ」を参照してください。
コントロール・パネルで設定したトレースはJava Plug-inまたはJava Web Startの起動時に有効になりますが、Java Plug-inまたはJava Web Startの実行中にコントロール・パネルで行った変更は再起動するまで有効になりません。
ロギングを有効にするには、次のアクションを行います。
「Javaコントロール・パネル」を開きます
「詳細」タブをクリックします。
「デバッグ」オプションの「ロギングを有効にする」を選択します
plugin<random-number>.trace
- Java Plug-in用のトレース・ファイルの名前。
plugin<random-number>.log
- Java Plug-in用のログ・ファイルの名前。
javaws<random-number>.trace
- Java Web Start用のトレース・ファイルの名前。
javaws<random-number>.log
- Java Web Start用のログ・ファイルの名前。
jcp.trace
- Javaコントロール・パネルの実行時に作成されるトレース・ファイルの名前。
<random-number>
は、ファイルの作成時に生成される番号です。
トレースとログ・ファイルのデフォルト位置(ディレクトリ)を次に示します。
<user.home>/.java/deployment/log
(SolarisおよびLinuxの場合)
~/Library/Application Support/Oracle/Java/Deployment/log
(OS Xの場合)
<User Application Data Folder>\Sun\Java\Deployment\log
(Windowsの場合)
環境変数USER_JPI_PROFILE
が<user plugin home>
に設定されている場合、トレースおよびログ・ファイルは次の場所に書き込まれます。
<user plugin home>/.java/deployment/log
(SolarisおよびLinuxの場合)
<user plugin home>/Library/Application Support/Oracle/Java/Deployment/log
(OS Xの場合)
<user plugin home>\Sun\Java\Deployment\log
(Windowsの場合)