ページの先頭行へ戻る
Interstage Studio ユーザーズガイド
Interstage

10.1.5 ビルドおよびデバッグ

問題ビューのフィルタ機能

問題ビューに多くの問題が表示されている場合には、ビューの右上のメニューより[フィルタ]を選択することで、表示内容をカスタマイズすることができます。
フィルタには、以下のような機能があります。

ビルド時のAntの呼び出し

Antスクリプトを記述して、以下のように設定することでビルド時にAntを呼び出すことができます。

  1. プロジェクトのプロパティから[ビルダ]を選択します。

  2. [新規]をクリックし、[構成タイプの選択]ダイアログボックスで[Antビルダ]を選択します。

  3. [メイン]の[ビルドファイル]に、使用するAntスクリプトファイルを指定します。

  4. Antスクリプトでワークスペース内のファイルを更新する場合には、[更新]タブでAntスクリプト実行後に最新化を行いたい資産を指定します。

  5. [ターゲット]タブでは、手動ビルド、自動ビルドなどビルドの仕方に合わせてターゲットを設定することができます。

  6. [プロパティ]タブでは、Antの実行に必要なプロパティを指定できます。

ポイント

Antスクリプトを選択して、コンテキストメニューから[デバッグ] > [Antビルド]を選択することで、Antスクリプトのデバッグをすることもできます。

クラスパスの追加

ワークスペース内にないJARファイルをクラスパスに追加する場合は、以下のどちらかの方法を使用すると環境依存の部分を吸収することができ、プロジェクト資産の可搬性が向上します。

クラスパス変数

設定ページの[Java] > [ビルドパス] > [クラスパス変数]で、名前とパスを対応付けて管理します。
クラスパスへの追加の際は、プロジェクトプロパティの[Javaのビルドパス]の[ライブラリ]タブの[変数の追加]ボタンから行い、表示されたダイアログボックスでクラスパス変数を選択し、[拡張]ボタンから、クラスパス変数に対応付けられているパスの配下のリソースを選択します。

ユーザライブラリ

設定ページの[Java] > [ビルドパス] > [ユーザライブラリ]で、名前と複数のJARファイルを対応付けて管理します。ライブラリ群を指定する場合に利用すると便利です。
指定したライブラリのクラスパスへの追加は、プロジェクトプロパティの[Javaのビルドパス]の[ライブラリ]タブの[ライブラリの追加]ボタンから行います。

ワークベンチを起動せずに、コマンドラインよりビルドする

ワークベンチを起動せずに、コマンドラインよりプロジェクトをビルドするには、ツール 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)を実行すると以下の順番でステップインが行われます。

  1. obj.getName()にステップイン

  2. obj.getValue()にステップイン

  3. addValue()にステップイン

もしaddValue()だけにステップインしたいのであれば、エディタ上で"addValue"を選択し、メニューから[選択項目にステップイン]を選択します。そうすると1.と2.は行われず、即座に3.が行われます。

式の評価

デバッグ中にオブジェクトの内容の確認だけでなく、メソッドを実行してみたい場合があります。
そのような場合には、表示ビューまたは変数ビューの詳細ペインに式を入力して選択し、コンテキストメニューから、[表示]、[インスペクション]、または[実行]を選択します。

ビルドやデバッグに使用するJavaのバージョンを指定するには

ビルドやデバッグに使用するJavaのバージョンは、プロジェクトのビルドパスに指定しているJREシステムライブラリによって決まります。プロジェクトのJREシステムライブラリを構成することでJavaのバージョンを指定できます。

JREシステムライブラリでJavaのバージョンを指定する方法には、以下の種類があります。

プロジェクトのJREシステムライブラリを構成するには、以下の手順で行います。

  1. パッケージエクスプローラビューなどからプロジェクトを選択します。

  2. コンテキストメニューから[プロパティ]を選択するか、メニューバーから[ファイル] > [プロパティ]を選択します。[プロパティ]ダイアログボックスが表示されます。

  3. 左のペインで[Javaのビルドパス]を選択します。[Javaのビルドパス]ページが表示されます。

  4. [ライブラリ]タブを選択します。

  5. 一覧[ビルドパス上のJARおよびクラスフォルダ]から、[JREシステムライブラリ]を選択し、[編集]をクリックします。[ライブラリの編集]ダイアログボックスが表示されます。

  6. システムライブラリから[ワークスペースのデフォルトJRE]か[代替JRE]を選択します。[代替JRE]を選択した場合は、コンボボックスで利用するインストール済みJREを選択します。

インストール済みのJREにJDKを追加するには、以下の手順で行います。

  1. ワークベンチのメニューから[ウィンドウ] > [設定]を選択します。

  2. [設定]ダイアログボックスの左のペインで[Java] > [インストール済みのJRE]を選択します。

  3. 右の[インストール済みのJRE]画面で[追加]をクリックします。

  4. [JREの型]画面では"標準VM"を選択して[次へ]をクリックします。

  5. [JRE定義]画面の[JREホーム]に、JDKのインストールフォルダを指定します。[JRE名]に選択したフォルダ名に応じた名前が表示され、[JREシステムライブラリ]に指定したJDKのライブラリのJARファイルの一覧が表示されます。[完了]をクリックして画面を閉じます。

注意

  • システムライブラリの選択項目として[実行環境]がありますが、Interstage Studioでは使用できません。

  • コンパイラ準拠レベルは、JREシステムライブラリで指定されているJavaのバージョンより大きくしないでください。

ポイント

Javaコンパイルでは、JREシステムライブラリのほかに、クラスファイルの互換性やソースの互換性などのコンパイラ準拠レベルを指定できます。コンパイラ準拠レベルは、プロジェクトのプロパティの[Javaコンパイラ]ページ、もしくは、ワークスペースの設定の[Java] > [コンパイラ]ページで指定できます。

スタックトレースビュー

スタックトレースビューを使用することで、FJVMログまたはスレッドダンプツールで採取したスレッドダンプを読み込んで、そこに記録されているスレッドとスタックトレースの一覧を階層表示することができます。

スタックトレースビューは以下の手順で表示できます。

  1. メニューバーから[ウィンドウ] > [ビューの表示] >[その他]を選択します。

  2. [ビューの表示]ダイアログボックスで[Java] > [スタックトレース]を選択します。

参照

FJVMログの詳細については、"Interstage Application Server チューニングガイド"の"JDK/JREのチューニング"を参照してください。

スレッドダンプツールの詳細については、"Interstage Application Server トラブルシューティング集"の"Javaツール機能"の"スレッドダンプツール"を参照してください。

注意

  • Java EE 6ワークベンチではスタックトレースビューは使用できません。

  • スタックトレースビューで表示可能なスレッドダンプのファイルは、スレッドダンプツールのオプション "-f"(スレッドダンプの出力先の指定)を指定して出力されたファイルになります。標準出力やアプリケーションサーバのログファイルに記録されたスレッドダンプは表示できません。

スタックトレースビューには、以下の機能があります。

スレッドダンプにモニタの情報が記録されている場合には、[モニタの表示]をオンにすると以下のエレメントが表示されます。

エレメント

アイコン

説明

所有するモニタ

スレッドの子エレメントとして表示され、そのスレッドが所有しているモニタを表します。アイコンの右側にはモニタとなっているオブジェクトのクラス名とIDが表示されます。所有しているモニタが複数ある場合には、このエレメントが複数個表示されます。
モニタがデッドロック状態にある場合には右側のアイコンが表示されます。

モニタを待機中のスレッド

所有するモニタの子エレメントとして表示され、そのモニタを待機中のスレッドを表します。アイコンの右側にはスレッド名と、システムスレッドか否かが表示されます。待機中のスレッドが複数ある場合には、このエレメントが複数個表示されます。
スレッドがデッドロック状態にある場合には右側のアイコンが表示されます。

待機中のモニタ

スレッドの子エレメントとして表示され、そのスレッドが待機中のモニタを表します。アイコンの右側にはモニタとなっているオブジェクトのクラス名とIDが表示されます。
モニタがデッドロック状態にある場合には右側のアイコンが表示されます。

モニタを所有するスレッド

待機中のモニタの子エレメントとして表示され、そのモニタを所有しているスレッドを表します。アイコンの右側にはスレッド名と、システムスレッドか否かが表示されます。
スレッドがデッドロック状態にある場合には右側のアイコンが表示されます。

モニタのロック

スタックトレースの間に表示され、どの処理の間にモニタがロックされたかを表します。アイコンの右側にはモニタとなっているオブジェクトのクラス名とIDが表示されます。