実行 / デバッグ構成: GlassFish サーバー

アプリケーションサーバー

使用するサーバー構成を選択します。

構成 をクリックして新しいサーバー構成を作成するか、既存の構成を編集します。 (アプリケーションサーバーダイアログが開きます。)

起動後

サーバーを始動してアーティファクトを配備した後に Web ブラウザーを開始するには、このチェックボックスを選択します。

リストからブラウザーを選択します。 Shift+Enter をクリックして、Web ブラウザーを構成します。

JavaScript デバッガーを使用する

このチェックボックスをオンにすると、JavaScript デバッガーを有効にして Web ブラウザーが起動します。

JavaScript のデバッグは Firefox と Google Chrome でのみ利用可能です。 初めて Firefox で JavaScript をデバッグすると、JetBrains Firefox 拡張機能がインストールされます。

URL

サーバーの起動時にブラウザーが開く URL を指定します。 通常、この URL は Web アプリケーションのルートまたはその開始ページに対応します。

VM オプション(V)

アプリケーションの起動時に Java 仮想マシンに渡すオプション (-mx、 -verbose など) を指定します。

JVM オプションを指定するときは、次の規則に従ってください。

• スペースを使用して個々のオプションを区切ります。

• オプションの値にスペースが含まれる場合は、値または実際のスペースを二重引用符で囲みます。

• オプションに値の一部として二重引用符が含まれている場合は、バックスラッシュを使用して二重引用符をエスケープします。

• 環境変数値をカスタム Java プロパティに渡すことができます。

このフィールドでコード補完を使用できます: フラグの名前を入力し始めると、IDE は利用可能なコマンドラインオプションのリストを提案します。 これは -XX: および -X オプションと、IntelliJ IDEA で自動的に構成されていない一部の標準オプション（例えば、 -ea ）には機能しますが、 -cp や –release には機能しません。

このフィールドで指定された -classpath オプションは、モジュールのクラスパスをオーバーライドします。

'更新' アクション時

アプリケーションの更新機能（実行 または デバッグ ツールウィンドウの または Ctrl+F10 ）に必要なオプションを選択します。

更新オプションは、展開されたアーティファクトとパックされたアーティファクトでは異なります。

展開されたアーティファクトの場合、使用可能なオプションは次のとおりです。

• リソースの更新 HTML、JSP、JavaScript、CSS、イメージファイルなど、変更されたすべてのリソースを更新します。

• クラスとリソースの更新 変更されたリソースを更新し、変更された Java クラス（EJB、サーブレットなど）は再コンパイルされます。

  デバッグモードでは、更新されたクラスがホットスワップされます。 実行モードでは、IntelliJ IDEA は出力フォルダーの変更されたクラスを更新するだけです。 そのようなクラスが実行中のアプリケーションで実際に再ロードされるかどうかは、使用されるランタイムの機能によって決まります。

• 再デプロイ アプリケーションアーティファクトが再ビルドされ、再デプロイされます。

• サーバーの再起動 サーバーが再起動しました。 アプリケーションアーティファクトが再ビルドされ、再デプロイされます。

パックされたアーティファクトの場合、使用可能なオプションは次のとおりです。

• ホットスワップクラス 変更されたクラスは再コンパイルされ、実行時に再ロードされます。 このオプションはデバッグモードでのみ機能します。

• 再デプロイ アプリケーションアーティファクトが再ビルドされ、再デプロイされます。

• サーバーの再起動 サーバーが再起動しました。 アプリケーションアーティファクトが再ビルドされ、再デプロイされます。

ダイアログを表示

アプリケーションの更新 機能を使用するたびに 更新 ダイアログを表示したい場合は、このチェックボックスを選択してください。

更新 ダイアログは、実際にアプリケーションを更新する前に 更新 オプションを選択するために使用されます。

フレーム切り替え時

IDE から別のアプリケーション（Web ブラウザーなど）に切り替えるときに IntelliJ IDEA が何をすべきかを指定します。 (フレームの無効化とは、別のアプリケーションに切り替えることを意味します。)

何もしない 以外のオプションは、 更新 動作の場合と同じ意味を持ちます。

JRE

デフォルトでは、プロジェクト JDK はアプリケーションの実行に使用されます。 別の JDK または JRE をここで指定する場合は、ドロップダウンリストからその JDK または JRE を選択します。

サーバードメイン

使用するサーバードメインを選択して（アプリケーションをデプロイして実行する）

ユーザー名

IntelliJ IDEA がサーバーに接続するユーザの名前を指定します。

パスワード

ユーザー名フィールドで指定されたユーザーのパスワード。

再デプロイメントにまたがりセッションを保持

GlassFish サーバー 3 以降のバージョンの場合: このチェックボックスを選択すると、アプリケーションアーティファクトを再デプロイするときにアクティブな HTTP セッションが保持されます。

アプリケーションサーバー

使用するサーバー構成を選択します。 これはローカルサーバー構成であることに注意してください。 (リモートサーバーで作業する場合、同じサーバーバージョンをローカルで使用できる必要があります。)

構成 をクリックして新しいサーバー構成を作成するか、既存の構成を編集します。 (アプリケーションサーバーダイアログが開きます。)

起動後

サーバーに接続し、アーティファクトを配備した後に Web ブラウザーを開始するには、このチェックボックスを選択します。

リストからブラウザーを選択します。 Shift+Enter をクリックして、Web ブラウザーを構成します。

JavaScript デバッガーを使用する

このチェックボックスをオンにすると、JavaScript デバッガーを有効にして Web ブラウザーが起動します。

JavaScript のデバッグは Firefox と Google Chrome でのみ利用可能です。 初めて Firefox で JavaScript をデバッグすると、JetBrains Firefox 拡張機能がインストールされます。

URL

サーバーの起動時にブラウザーが開く URL を指定します。 通常、この URL は Web アプリケーションのルートまたはその開始ページに対応します。

ドメイン管理サーバーポート

GlassFish ドメイン管理サーバーポート。

ユーザー名

IntelliJ IDEA がサーバーに接続するユーザの名前を指定します。

パスワード

ユーザー名フィールドで指定されたユーザーのパスワード。

ターゲットのデプロイ

ターゲットサーバーに次の情報を指定します。

• ドメイン: サーバーがドメイン モードで動作する場合は、このオプションを選択します。

  仮想サーバー: ターゲット ドメイン内の特定の仮想サーバーにデプロイする場合、仮想サーバーの名前を指定してください。 それ以外の場合、アーティファクトはドメイン内のすべての仮想サーバーにデプロイされます。

• クラスター: サーバーがクラスター モードで動作する場合は、このオプションを選択します。

  クラスタ名 ターゲットクラスターの名前を指定してください。

  ドメイン管理サーバーホスト ドメイン管理サーバーホストの完全修飾ドメイン名または IP アドレスを指定します。

SSH 接続を使用

SSL を使用してサーバーに接続するには、このチェックボックスを選択します。

再デプロイメントにまたがりセッションを保持

GlassFish サーバー 3 以降のバージョンの場合: このチェックボックスを選択すると、アプリケーションアーティファクトを再デプロイするときにアクティブな HTTP セッションが保持されます。

GlassFish でアップロードする

GlassFish 管理コンソールを使用してアプリケーションアーティファクトをデプロイするには、このチェックボックスを選択します。 この場合、デプロイされたアーティファクトをリモートサーバーにデプロイできないことに注意してください (サーバーが実際に別のコンピューター上にある場合)。

このオプションを使用する場合は、リモートステージング設定を指定する必要はありません。

リモートステージング

このセクションには、 ステージング(英語)に関連する設定が含まれています。

タイプ

ローカルコンピューターからアプリケーションアーティファクトを転送するためにステージング環境またはホストにアクセスする方法を選択します。 (IntelliJ IDEA のユーザーインターフェースでは、この設定は 接続タイプとも呼ばれます。)

使用可能なオプションは以下のとおりです。

• 同じファイルシステム ターゲットサーバーがローカルコンピューターにインストールされている場合は、このオプションを選択してください。 この場合、アーティファクトはローカルでデプロイされるため、リモートホストへ転送する必要はありません。

• ftp File Transfer Protocol または Secure FTP が使用されます。

• ローカルまたはマウント済みフォルダー ステージング環境はローカルフォルダーまたは マウントされたフォルダーとしてアクセスされます。

リストが空の場合、対応する機能をサポートする FTP/SFTP 接続プラグインを有効にするが必要です。

ホスト

タイプ に対して 同じファイルシステム が選択されている場合、 ホスト のオプションは 同じファイルシステム のみです。

それ以外の場合、リストには選択したタイプの既存の構成が含まれます。 各構成は、個々の (S)FTP 接続、またはローカルフォルダーまたはマウントされたフォルダーに対応します。

既存の構成を選択するか、新しい構成を作成します。

新しい設定を作成するには:

1. リストの右側にある をクリックします。

2. デプロイダイアログで、 をクリックします。

3. サーバーの追加 ダイアログで、構成名を指定し、タイプを選択して、 OK をクリックします。

4. 接続タブでは、 プロジェクトファイルのアップロード / ダウンロード セクションで設定を指定します。

   残りの設定は関係ありません。

5. デプロイ ダイアログで OK をクリックします。

ステージング

リモートホストにデプロイすると、アプリケーションアーティファクトが GlassFish サーバーにアクセス可能なステージングフォルダーに配置されます。 このセクションの設定によって、このステージングフォルダーの場所が定義されます。

タイプ および ホスト に対して 同じファイルシステム が選択されている場合は、このセクションの設定を指定する必要はありません。

ルートからのパス

ローカルまたはマウントされたフォルダーまたは (S)FTP ホストのルートに関連するステージングフォルダーへのパス。

を使用して、 ターゲットパスの選択 ダイアログでフォルダーを選択することができます。

マップ

リモートホストのローカルファイルシステム内のステージングフォルダーへの絶対パス。

リモート接続設定

デプロイされたアプリケーションにアクセスするための設定。

ホスト

GlassFish サーバーホストの完全修飾ドメイン名または IP アドレス。 ターゲットサーバーがクラスタモードで動作している場合、これはデバッガーが接続する GlassFish サーバーインスタンスのホストです。

ポート

サーバーの HTTP ポート、またはクラスタの場合は、対応する GlassFish サーバーインスタンスの HTTP ポート。

または Alt+Insert

アーティファクトまたは外部リソースをリストに追加します。

または Alt+Delete

選択したアーティファクトと外部リソースをリストから削除します。

または F4

選択したアーティファクトを設定します。 プロジェクト構造ダイアログ の アーティファクトページが開きます。

カスタムコンテキストルートを使用する

特定の コンテキストルート(英語)をアーティファクトまたは外部リソースに割り当てる場合は、アーティファクトまたはリソースを選択し、チェックボックスをオンにして、チェックボックスのフィールドに目的のコンテキストルートを指定します。

アクティブ

この列のチェックボックスを選択すると、ログエントリが 実行ツールウィンドウ 、または デバッグツールウィンドウ の対応するタブに表示されます。

ログファイルエントリ

この列の読み取り専用フィールドには、表示するログファイルの一覧が表示されます。 リスト

• 特定のファイルへのフルパス。

• Ant パターン(英語)は、表示されるファイルの範囲を定義します。

• 完全なパスやパターンを代用する別名。 これらのエイリアスは、対応するログファイルが表示されているタブのヘッダーにも表示されます。

  ログエントリパターンで複数のファイルが定義されている場合、タブヘッダーにはログエントリエイリアスではなくファイルの名前が表示されます。

内容のスキップ

選択したログの以前の内容をスキップするには、このチェックボックスを選択します。

コンソール出力をファイルに保存する

コンソール出力を指定した場所に保存するには、このチェックボックスを選択します。 パスを手動で入力するか、参照ボタンをクリックして 開いたダイアログ で目的の場所を指定します。

メッセージが標準出力ストリームに出力されたときにコンソールを表示する

関連付けられているプロセスが Standard.out に書き込んだ場合は、このチェックボックスをオンにして出力コンソールをアクティブにして前面に表示します。

メッセージがエラー出力ストリームに出力されたときにコンソールを表示する

関連付けられているプロセスが Standard.err に書き込んだ場合は、このチェックボックスをオンにして出力コンソールをアクティブにして前面に表示します。

このボタンをクリックすると ログファイルエイリアスの編集ダイアログが開き、新しいログエントリを選択してエイリアスを指定できます。

このボタンをクリックすると、 ログファイルエイリアスの編集ダイアログの選択したログファイルエントリのプロパティを編集できます。

選択したログエントリをリストから削除するには、このボタンをクリックします。

コードカバレッジランナーを選択する

希望のコードカバレッジランナーを選択します。

サンプリング

最小限のスローダウンでコードカバレッジを測定するには、このオプションを選択します。

トレース

正確なブランチカバレッジを収集するには、このオプションを選択します。 このモードは、IntelliJ IDEA コードカバレッジランナーでのみ使用できます。

テストカバレッジごとに追跡する

このチェックボックスを選択すると、1 つのテストでカバーされている行と、すべての行に含まれている行を検出できます。

コードカバレッジデータを記録するためのパッケージとクラス

必要に応じて、測定するクラスとパッケージを指定します。

または を使用して、クラスまたはパッケージをリストに追加します。

リストからクラスまたはパッケージを削除するには、対応するリスト項目を選択し、 をクリックします。

テストフォルダーでカバレッジを使用可能にする。

コードカバレッジ分析にテストソースフォルダーを含めるには、このチェックボックスを選択します。

実行 /

デバッグ /

カバレッジ

実行、デバッグ、コードカバレッジモードの設定を切り替えるために使用します。

スタートアップスクリプト

サーバーの起動に使用するスクリプトを指定します。

デフォルトを使用する:

• このチェックボックスを選択すると、デフォルトスクリプトが使用されます。

  この場合、 は、 スタートアップスクリプト フィールドの内容を示す デフォルト起動スクリプト ダイアログを開きます（読み取り専用）。

• スクリプトに渡されるパラメーターを変更したり、別のスクリプトを指定するには、このチェックボックスをオフにします。

  • スクリプトを指定するには、 をクリックし、 開いたダイアログ で目的のスクリプトを選択します。

  • パラメーターを指定するには、 をクリックし、 VM とプログラムパラメーターの構成 ダイアログでスクリプトパラメーターと VM オプションを指定します。

    パラメーターとオプションを指定するときは、次の規則に従ってください。

    • スペースを使用して、個々のパラメーターとオプションを区切ります（例: -client -ea -Xmx1024m）。

    • パラメーターまたはオプションにスペースが含まれている場合は、空白を含むスペースまたは引数を二重引用符で囲みます（例: some" "arg または "some arg"）。

    • パラメーターやオプションに二重引用符（たとえば、引数の一部として）が含まれている場合は、二重引用符をバックスラッシュ（例: -Dmy.prop=\"quoted_value\" ）でエスケープします。

シャットダウンスクリプト

サーバーの停止に使用するスクリプトを指定します。

デフォルトを使用する:

• このチェックボックスを選択すると、デフォルトスクリプトが使用されます。

  この場合、 は、 シャットダウンスクリプト フィールドの内容を示す デフォルトの停止スクリプト ダイアログを開きます（読み取り専用）。

• スクリプトに渡されるパラメーターを変更したり、別のスクリプトを指定するには、このチェックボックスをオフにします。

  • スクリプトを指定するには、 をクリックし、 開いたダイアログ で目的のスクリプトを選択します。

  • パラメーターを指定するには、 をクリックし、 VM とプログラムパラメーターの構成 ダイアログでスクリプトパラメーターと VM オプションを指定します。

    パラメーターとオプションを指定するときは、次の規則に従ってください。

    • スペースを使用して、個々のパラメーターとオプションを区切ります（例: -client -ea -Xmx1024m）。

    • パラメーターまたはオプションにスペースが含まれている場合は、空白を含むスペースまたは引数を二重引用符で囲みます（例: some" "arg または "some arg"）。

    • パラメーターやオプションに二重引用符（たとえば、引数の一部として）が含まれている場合は、二重引用符をバックスラッシュ（例: -Dmy.prop=\"quoted_value\" ）でエスケープします。

環境変数を渡す

GlassFish サーバーの起動方法は、環境変数を使用して変更することはできません。 代わりに、サーバー構成ファイル domain.xml を変更する必要があります。 このセクションで指定した内容は問題ではありません。

構成ファイルに必要な変更を加えるために、IntelliJ IDEA は迅速な修正を提供します。 ダイアログの下部で特定の設定が間違っているという警告が表示されたら、 修復 をクリックする必要があります。 その結果、 domain.xml に必要な変更が加えられました。

サンプル

タブの上部にある デバッグ を選択すると、その値を持つ変数 JAVA_OPTS があることがわかります

-agentlib:jdwp=transport=dt_socket,address=127.0.0.1:9009,suspend=y,server=n

前述のように、 JAVA_OPTS を使用して対応する設定を GlassFish Server JVM に渡すことはできません。

構成ファイル <domain_name>/config/domain.xml では、デフォルトで対応する値（<java-config> 要素の debug-options 属性）は次のようになります。

-agentlib:jdwp=transport=dt_socket,address=9009,server=y,suspend=n

そのため、ダイアログの下部に、 デバッグ設定が無効です…という警告が表示されます。

ここで、 修復 をクリックすると、 domain.xml の値が

-agentlib:jdwp=transport=dt_socket,address=9009,server=n,suspend=y

ポート

デバッガーポートを変更するには、このフィールドを使用します。

警告「デバッグ構成が無効です ...」が表示されたら、 修復 をクリックします。 これにより、GlassFish サーバー構成ファイル domain.xml のポート番号が変更されます。 実行 / デバッグ構成: GlassFish サーバー も参照してください。

デバッガー設定

このボタンをクリックすると、 設定ダイアログの デバッガーページのデバッガーオプションを編集できます。

実行 /

デバッグ

実行モードとデバッグモードの設定を切り替えます。 設定は、 実行する / デバッグする ... の領域に表示されます

リモートサーバー JVM を実行 / デバッグするには ...

サーバー JVM を起動するためのコマンドラインオプション。 これらは、GlassFish サーバー構成ファイル domain.xml で指定する必要があります。

トランスポート (とそれに付随するもの)

実行する / デバッグする ... の領域に示されているリモートデバッグコマンドラインオプションを生成するための GUI

名前(N)

実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。

複数のインスタンスを許可する(U)

この実行構成の複数のインスタンスを並行して実行できるようにします。

デフォルトでは無効になっており、別のインスタンスがまだ実行されているときにこの構成を開始すると、IntelliJ IDEA は実行中のインスタンスを停止して別のインスタンスを開始することを提案します。 これは、実行構成が多くのリソースを消費し、複数のインスタンスを実行する正当な理由がない場合に役立ちます。

プロジェクトファイルとして保存(S)

実行構成設定を含むファイルを保存して、他のチームメンバーと共有します。 デフォルトの場所は .idea/runConfigurations です。 ただし、 .idea ディレクトリを共有したくない場合は、プロジェクト内の他のディレクトリに構成を保存できます。

デフォルトでは無効になっており、IntelliJ IDEA は実行構成設定を .idea/workspace.xml に保存します。