パースペクティブのデバッグ

ColdFusion デバッグパースペクティブ（起動するには、実行／デバッグの構成／パースペクティブを選択）には、ColdFusion アプリケーションおよびクライアントサイドのアプリケーションをデバッグするためのツールが含まれています。コードへのブレークポイントの追加、関数へのステップインやステップオーバーまたはコード内の式の確認や評価を行うことのできる様々なビューがあります。エディターとデバッグツールを組み合わせて使用すると、修正が必要なコード行を検索して強調表示することができます。

A. 変数ビュー B. デバッグ出力バッファービュー C. ブレークポイントビュー D. 式ビュー E. 概要ビュー F. デバッグビュー G. 編集ビュー H. サーバービュー I. コンソールビュー J. 問題ビュー K. TailView ビュー

ColdFusion デバッグパースペクティブには次のビューがあります。

デバッグビュー

デバッグビューには、各デバッグセッションの結果が表示されます。デバッグビューには、ブレークポイントでページの実行が中断したとき、またはコードにステップインまたはステップオーバーしたときのスタックトレースが表示されます。

デバッグツールバーには、（左から右の順に）次のボタンがあります。

アプリケーションのデバッグ

デバッグでは、アプリケーションを調べてトラブルシューティングできます。デバッグ中には、コード内の特定のポイントでアプリケーションを停止するかどうかを制御できます。また、重要な変数を監視したり、コードをテストすることもできます。デバッグでは、アプリケーションの起動方法を制御するための設定が使用されます。アプリケーションをデバッグするときは、デバッグ版のアプリケーションファイルを実行します。

ColdFusion Builder バージョン 2.0 では ColdFusion のサーバーサイドのデバッグがサポートされていましたが（ColdFusion Markup Language のシンタックスに限定）、ColdFusion Builder 3 では、ColdFusion 11 での <cfclient> タグの導入に伴って、クライアントサイド JavaScript コードをデバッグするためのクライアントサイドのデバッグが可能になりました。

ColdFusion デバッガーを使用したサーバーサイドのデバッグ

ColdFusion デバッガーを使用する前に、次の作業をおこなってください。

デバッガーを使用するための ColdFusion の設定

デバッガーを使用する前に、次のことを確認します。

• デバッグ対象のプロジェクト、またはデバッグ対象のファイルを含むプロジェクトにサーバーが関連付けられているかどうかを確認します。

• ColdFusion サーバーで RDS を有効にし、ColdFusion Builder で RDS の設定情報が正しく指定されていることを確認します。
• ColdFusion Administrator でデバッグが有効になっていることを確認します。

この問題を回避するには、デバッガーサーバーが使用するポート番号を固定的に指定し、このポートの使用をファイアウォールで許可します。デバッガーサーバーのポート番号を固定的に設定するには、ColdFusion Administrator の Java と JVM ページ（または J2EE アプリケーションサーバーの適切なセクション）で、次の JVM 引数を指定します。portNumber の部分は、実際に使用するポート番号に置き換えてください。
-DDEBUGGER_SERVER_PORT=portNumber

1. ColdFusion を再起動します。J2EE 設定の ColdFusion を実行している場合は、指定のデバッグポートを使用してデバッグモードでサーバーを再起動します。

J2EE 設定の ColdFusion におけるデバッグのセットアップ

サーバー設定の ColdFusion を実行していない場合は、実行するアプリケーションサーバーの設定ファイルまたはスタートアップスクリプトで Java デバッグパラメーターを指定します。パラメーターは次のようになります。

-Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=<port_number>

ColdFusion Administrator のデバッガーの設定ページで指定したのと同じポート番号を指定する必要があります。

サーバー設定の ColdFusion を実行している場合は、ColdFusion Administrator のデバッガーの設定ページを使用すると、ColdFusion によってこれらのデバッグパラメーターが jvm.config ファイルに書き込まれます。

ColdFusion Builder でのデバッガー設定の指定