第4章 Camel のデバッグサポート
Apache Camel の VS Code エクステンションは開発サポートとしてリストされています。開発サポートの対象範囲の詳細は、Red Hat Build of Apache Camel の開発サポート対象範囲 を参照してください。
4.1. Apache Camel ルートのデバッグアダプターについて リンクのコピーリンクがクリップボードにコピーされました!
VS Code デバッグアダプターは、Java、Yaml、または XML DSL で記述された実行中の Camel ルートをデバッグするために使用できる Visual Studio Code 拡張機能です。
4.1.1. デバッグアダプターの特徴 リンクのコピーリンクがクリップボードにコピーされました!
Apache Camel エクステンション用 VS Code デバッグアダプターは、次の機能をサポートしています。
- XML のみの Camel Main モード。
- JMX URL を使用して Java、Yaml、または XML で記述された実行中の Camel ルートに Camel デバッガーを接続することによる Camel デバッガーの使用。
- PID を使用して、Java、Yaml、または XML で記述された実行中の Camel ルートに Camel デバッガーを接続することによる、Camel デバッガーのローカル使用。
- 単一の Camel コンテキストに使用可能。
- ブレークポイントの追加または削除。
- シンプルな言語による条件付きブレークポイント。
- 一時停止されたブレークポイント変数値の検査。
- 単一のルートインスタンスの再開および、すべてのルートインスタンスの再開。
- ルート定義が同じファイル内にある場合のステップ実行。
- Debugger スコープ、メッセージ本文、String 型のメッセージヘッダー、および String 型の Exchange プロパティー内の変数を更新可能に。
Run Camel Application with JBang and Debugコマンドのサポート。このコマンドを使用すると、簡単な場合にワンクリックで起動して Camel デバッグを行うことができます。このコマンドは次の方法で利用できます。
- コマンドパレット。現在のエディターで有効な Camel ファイルを開く必要があります。
-
ファイルエクスプローラーのコンテキストメニュー。これは、すべての
*.xml、*.java、*.yaml、および*.ymlに表示されます。 -
Camel ファイルの先頭にある Codelens (codelens のヒューリスティックは、
java、xml、およびyamlファイルに from と to またはログがあることを確認することです)。
Run Camel application with JBangコマンドのサポート。- エディターで開かれた Yaml DSL (.yaml|.yml) で定義された有効な Camel ファイルが必要です。
- Camel デバッガー起動設定の設定スニペット。
- JBang を使用した Camel デバッガー接続、または Camel Maven プラグインを使用した Maven を受け入れる準備ができた Camel アプリケーションを起動するための設定スニペット。
4.1.2. 要件 リンクのコピーリンクがクリップボードにコピーされました!
Apache Camel 拡張機能用の VS Code デバッグアダプターを使用する場合は、次の点を考慮する必要があります。
前提条件
Java ランタイム環境:
- 17 以降
-
com.sun.tools.attach.VirtualMachineがインストールされました。
Camel インスタンス:
- Camel バージョン 3.16 以降
-
クラスパスに
camel-debug -
JMXが有効です。
一部の機能では、CLI 環境で JBang が使用可能である必要があります。
4.1.3. Apache Camel 用の VS Code デバッグアダプターのインストール リンクのコピーリンクがクリップボードにコピーされました!
Apache Camel エクステンションの VS Code Debug Adapter は、VS Code Extension Marketplace および Open VSX Registry からダウンロードできます。Debug Adapter for Apache Camel 拡張機能を Microsoft VS Code に直接インストールすることもできます。
手順
- VS Code エディターを開きます。
- VS Code エディターで、View > Extensions を選択します。
- 検索バーに Camel Debug と入力します。検索結果から Debug Adapter for Apache Camel オプションを選択し、インストールをクリックします。
これにより、VS Code エディターに Apache Camel のデバッグアダプターがインストールされます。