問題ビューに多くの問題が表示されている場合には、ビューの右上のメニューより[フィルタ]を選択することで、表示内容をカスタマイズすることができます。
フィルタには、以下のような機能があります。
範囲指定
例えば、[同一プロジェクト内の任意の要素]を指定することで、選択しているリソースを含むプロジェクトに限定することができます。
重度の指定
エラー、警告、情報のどれを表示するかを指定することができます。
問題のタイプの指定
ビルダやバリデータなどの問題のタイプを指定して、表示内容を限定することができます。
その他
特定の記述を含む/含まないを指定して、表示内容を限定することができます。
Antスクリプトを記述して、以下のように設定することでビルド時にAntを呼び出すことができます。
プロジェクトのプロパティから[ビルダ]を選択します。
[新規]をクリックし、[構成タイプの選択]ダイアログボックスで[Antビルダ]を選択します。
[メイン]の[ビルドファイル]に、使用するAntスクリプトファイルを指定します。
Antスクリプトでワークスペース内のファイルを更新する場合には、[更新]タブでAntスクリプト実行後に最新化を行いたい資産を指定します。
[ターゲット]タブでは、手動ビルド、自動ビルドなどビルドの仕方に合わせてターゲットを設定することができます。
[プロパティ]タブでは、Antの実行に必要なプロパティを指定できます。
ポイント
Antスクリプトを選択して、コンテキストメニューから[デバッグ] > [Antビルド]を選択することで、Antスクリプトのデバッグをすることもできます。
ワークスペース内にないJARファイルをクラスパスに追加する場合は、以下のどちらかの方法を使用すると環境依存の部分を吸収することができ、プロジェクト資産の可搬性が向上します。
ワークベンチを起動せずに、コマンドラインよりプロジェクトをビルドするには、ツール isstudiobld.exe を使用します。ツール isstudiobld.exe は、以下の場所にあります。
<ワークベンチのインストールフォルダ>\eclipse\isstudiobld.exe
以下にツール isstudiobld の使い方を説明します。
形式 | |
isstudiobld -data <workspace> [options] [target [target2] …] | |
パラメタ | |
-data <workspace> | ワークスペースフォルダ |
<target> | 実行するantのターゲットを指定する |
オプション | |
-f <buildfile> | ビルドファイル(antスクリプト)を指定する |
-verbose, -v | 詳細を表示する |
-D<property>=<value> | プロパティを指定する |
-propertyfile <name> | プロパティを指定されたファイルからロードする。 |
isstudiobld.exeはデフォルトで以下の場所にあるビルドファイル(Antスクリプト)を読み込んでいます。
<インストールフォルダ>\IDE\1100\etc\build\buildAll.xml
ビルドファイルをカスタマイズしたい場合はこのファイルをコピー、カスタマイズして-fオプションで指定してください。
注意
Java EE 6ワークベンチではツールisstudiobld.exeは使用できません。
プロジェクトをビルドするには eclipse.incrementalBuild antタスクを使います。
eclipse.incrementalBuild Antタスクの使い方は以下です。
属性 | 説明 |
---|---|
kind | ビルドの種類。incremetal,full,cleanのいずれかを指定する。デフォルト値はincremental。 |
project | ビルドするプロジェクトを指定する。省略した場合はワークスペースをビルドする。 |
例: ワークスペースをフルビルドする。
<eclipse.incrementalBuild kind="full" />
例: プロジェクト project1 をクリーンする。
<eclipse.incrementalBuild project="project1" kind="clean" />
ブレークポイントを多数設定していると余分な箇所での実行中断が多くなり、デバッグ効率が悪くなることがあります。
このような場合に、ブレークポイントを解除しないで一時的に無効にすることができます。ブレークポイントビューの右上のメニューから[グループ] > [<グループ化の方法>]を選択すると、ブレークポイントがグループ化されるので、グループ化されたブレークポイントをまとめて無効化することができます。
また、ブレークポイントビューのツールバー上から[すべてのブレークポイントをスキップ]を選択することで、すべてのブレークポイントを無効にすることもできます。
例外が発生したときにプログラムの実行を中断したい場合があります。このような場合には、例外ブレークポイントを利用します。メニューから[実行] > [Java例外ブレークポイントの追加]を用いて例外クラスを指定することで、その例外が発生した際に実行を中断するように設定することができます。
デバッグ時に、例えば
addValue(obj.getName(), obj.getValue());
のような文をステップイン実行する際に、単にステップイン(F5)を実行すると以下の順番でステップインが行われます。
obj.getName()にステップイン
obj.getValue()にステップイン
addValue()にステップイン
もしaddValue()だけにステップインしたいのであれば、エディタ上で"addValue"を選択し、メニューから[選択項目にステップイン]を選択します。そうすると1.と2.は行われず、即座に3.が行われます。
デバッグ中にオブジェクトの内容の確認だけでなく、メソッドを実行してみたい場合があります。
そのような場合には、表示ビューまたは変数ビューの詳細ペインに式を入力して選択し、コンテキストメニューから、[表示]、[インスペクション]、または[実行]を選択します。
ビルドやデバッグに使用するJavaのバージョンを指定するには
ビルドやデバッグに使用するJavaのバージョンは、プロジェクトのビルドパスに指定しているJREシステムライブラリによって決まります。プロジェクトのJREシステムライブラリを構成することでJavaのバージョンを指定できます。
JREシステムライブラリでJavaのバージョンを指定する方法には、以下の種類があります。
ワークスペースのデフォルトJRE
ワークスペースのデフォルトJREを使用します。ワークスペースのデフォルトJREは、メニューバー[ウィンドウ] > [設定]で表示される設定ダイアログボックスの[Java] > [インストール済みのJRE]ページでチェックされているインストール済みのJREです。ワークスペースのデフォルトJREを変更すると、各プロジェクトで使用されるJREシステムライブラリも変更されます。
代替JRE
Javaのバージョンをプロジェクトごとに指定する場合に使用します。インストール済みのJREの中から、ビルドやデバッグに使用するJavaを選択します。
プロジェクトのJREシステムライブラリを構成するには、以下の手順で行います。
パッケージエクスプローラビューなどからプロジェクトを選択します。
コンテキストメニューから[プロパティ]を選択するか、メニューバーから[ファイル] > [プロパティ]を選択します。[プロパティ]ダイアログボックスが表示されます。
左のペインで[Javaのビルドパス]を選択します。[Javaのビルドパス]ページが表示されます。
[ライブラリ]タブを選択します。
一覧[ビルドパス上のJARおよびクラスフォルダ]から、[JREシステムライブラリ]を選択し、[編集]をクリックします。[ライブラリの編集]ダイアログボックスが表示されます。
システムライブラリから[ワークスペースのデフォルトJRE]か[代替JRE]を選択します。[代替JRE]を選択した場合は、コンボボックスで利用するインストール済みJREを選択します。
インストール済みのJREにJDKを追加するには、以下の手順で行います。
ワークベンチのメニューから[ウィンドウ] > [設定]を選択します。
[設定]ダイアログボックスの左のペインで[Java] > [インストール済みのJRE]を選択します。
右の[インストール済みのJRE]画面で[追加]をクリックします。
[JREの型]画面では"標準VM"を選択して[次へ]をクリックします。
[JRE定義]画面の[JREホーム]に、JDKのインストールフォルダを指定します。[JRE名]に選択したフォルダ名に応じた名前が表示され、[JREシステムライブラリ]に指定したJDKのライブラリのJARファイルの一覧が表示されます。[完了]をクリックして画面を閉じます。
注意
システムライブラリの選択項目として[実行環境]がありますが、Interstage Studioでは使用できません。
コンパイラ準拠レベルは、JREシステムライブラリで指定されているJavaのバージョンより大きくしないでください。
ポイント
Javaコンパイルでは、JREシステムライブラリのほかに、クラスファイルの互換性やソースの互換性などのコンパイラ準拠レベルを指定できます。コンパイラ準拠レベルは、プロジェクトのプロパティの[Javaコンパイラ]ページ、もしくは、ワークスペースの設定の[Java] > [コンパイラ]ページで指定できます。
スタックトレースビューを使用することで、FJVMログまたはスレッドダンプツールで採取したスレッドダンプを読み込んで、そこに記録されているスレッドとスタックトレースの一覧を階層表示することができます。
スタックトレースビューは以下の手順で表示できます。
メニューバーから[ウィンドウ] > [ビューの表示] >[その他]を選択します。
[ビューの表示]ダイアログボックスで[Java] > [スタックトレース]を選択します。
参照
FJVMログの詳細については、"Interstage Application Server チューニングガイド"の"JDK/JREのチューニング"を参照してください。
スレッドダンプツールの詳細については、"Interstage Application Server トラブルシューティング集"の"Javaツール機能"の"スレッドダンプツール"を参照してください。
注意
Java EE 6ワークベンチではスタックトレースビューは使用できません。
スタックトレースビューで表示可能なスレッドダンプのファイルは、スレッドダンプツールのオプション "-f"(スレッドダンプの出力先の指定)を指定して出力されたファイルになります。標準出力やアプリケーションサーバのログファイルに記録されたスレッドダンプは表示できません。
スタックトレースビューには、以下の機能があります。
FJVMログ/スレッドダンプを開く
ビューに表示するFJVMログファイルまたはスレッドダンプを開きます。開いたファイルの内容はコンソールビューにも表示されます。
ファイルを閉じる
ビューに現在表示されているファイルを閉じます。
選択されたファイルの表示
ファイルを複数個開いている場合に、どのファイルを表示するかを選択します。
コンソールの表示
ビューに現在表示されているファイルの内容をコンソールビューに表示します。
ソート
スレッドをソート表示します。ボタンを押すたびにソートのオン/オフが切り替わります。
ソートがオンの場合には、先に通常のスレッドがスレッド名で昇順に表示され、次にシステムスレッドがスレッド名で昇順に表示されます。ソートがオフの場合には、ファイルに記録されている順番にスレッドが表示されます。
システムスレッドの表示
システムスレッドを表示します。コマンドを選択するたびにシステムスレッドの表示/非表示が切り替わります。
修飾名の表示
スタックトレースやモニタのエレメントに表示されるクラス名に修飾名(パッケージ名)を付けて表示します。
モニタの表示
モニタを表示します。スレッドダンプでデッドロック状態のスレッドやモニタがある場合には、それらは強調表示され、アイコンもデッドロック状態のものに変わります。
コマンドを選択するたびにモニタの表示/非表示が切り替わります。
エンコードの設定
FJVMログファイルやスレッドダンプファイルを読み込む際に使用するエンコードを指定します。デフォルトはUTF-8です。ファイルがUTF-8以外のエンコードで記録されている場合にだけこの設定を行ってください。
スレッドダンプにモニタの情報が記録されている場合には、[モニタの表示]をオンにすると以下のエレメントが表示されます。
エレメント | アイコン | 説明 | |
---|---|---|---|
所有するモニタ | スレッドの子エレメントとして表示され、そのスレッドが所有しているモニタを表します。アイコンの右側にはモニタとなっているオブジェクトのクラス名とIDが表示されます。所有しているモニタが複数ある場合には、このエレメントが複数個表示されます。 | ||
モニタを待機中のスレッド | 所有するモニタの子エレメントとして表示され、そのモニタを待機中のスレッドを表します。アイコンの右側にはスレッド名と、システムスレッドか否かが表示されます。待機中のスレッドが複数ある場合には、このエレメントが複数個表示されます。 | ||
待機中のモニタ | スレッドの子エレメントとして表示され、そのスレッドが待機中のモニタを表します。アイコンの右側にはモニタとなっているオブジェクトのクラス名とIDが表示されます。 | ||
モニタを所有するスレッド | 待機中のモニタの子エレメントとして表示され、そのモニタを所有しているスレッドを表します。アイコンの右側にはスレッド名と、システムスレッドか否かが表示されます。 | ||
モニタのロック | スタックトレースの間に表示され、どの処理の間にモニタがロックされたかを表します。アイコンの右側にはモニタとなっているオブジェクトのクラス名とIDが表示されます。 |