Apache Camel XML DSL入門

〜見える・伝わる・共有できるルート定義〜

はじめに

Apache Camel では、メッセージルーティングの定義に DSL（Domain Specific Language） を使います。

DSLには主に以下の3種類があり、目的やチーム構成によって選択できます：

Java DSL：コードベースで柔軟に記述可能。最も自由度が高い
XML DSL：構造が明確で読みやすく、共有や保守に強い
YAML DSL：GUIツールと併用しやすく、視覚的に設計しやすい

前回は「Java DSL」を紹介しましたが、今回はその対になる存在、XML DSL を紹介します。

XML DSLは、Camelルートを構造的かつ宣言的に記述できる形式です。
Java DSLほどの自由度はないものの、「見やすさ」「レビューのしやすさ」「共有のしやすさ」で強みを発揮します。

XML DSLとは？

XML DSL は、Camel のルートを XMLファイル（通常は camel-context.xml） に記述するスタイルです。
Spring Boot などの環境でも広く利用されており、構成と処理を分離しやすいのが大きな特長です。

<route id="errorLogRoute">
  <from uri="kafka:logs"/>
  <filter>
    <simple>${body.level} == 'ERROR'</simple>
    <to uri="log:errorLogger"/>
  </filter>
</route>

XML DSL のここがすごい

〜見えて、伝わって、保守に強い〜

XMLは構造を表現するのに特化した形式。ルートの全体像が視覚的に把握しやすい
Javaを知らなくても「なんとなく何をしているかが読める」
構成情報として扱いやすく、設計書・レビュー資料としても使える
GUI支援ツール（Camel Designer）との親和性も高く、視覚的な設計・確認も可能
行単位での編集や保守がしやすい。差分が明確なので Git 上でも追いやすい
Hawtio によるビジュアライズにも対応。ルート全体を可視化しながら補完的に確認できる

デバッグについて（Java DSLとの違い）

Java DSL の場合は、IDE（例：VS Code）で configure() メソッドにブレイクポイントを置いて 通常のJavaコードとしてステップ実行が可能です。
一方、XML DSL はコードそのものではないため IDEでのブレイクポイントによるデバッグは直接できません。
ただし、Hawtio を使えばルートの状態確認・各処理のステップ・履歴が視覚的に追えるため、実行時の確認をGUIで補完できます。

※つまり、コード単位で止めることはできないが、ルート単位で状況確認・監視は可能です。実運用ではこの組み合わせが多く採用されています。

XML DSL が向いているケース

チーム開発でルート構成を見える形で共有・レビューしたい場合
設計資料や構成ファイルとしてルートを扱いたい場合
非Javaユーザーやインフラ・業務側メンバーとのやり取りが多い場合

必要なスキル

ロール	必要スキル
実装者	XML（中級）、Java、Spring Boot、Camelの基本構文
レビュー担当	ルート構造の読み方、Camelの基本EIPの理解
運用・テスト	XMLが読めれば誰でも追いやすい構成

開発環境とおすすめ拡張機能

エディタ候補：

Visual Studio Code
IntelliJ IDEA（Ultimate）

VS Code のおすすめ拡張機能：

Extension Pack for Apache Camel
Apache Camel Tooling for XML
XML Language Support by Red Hat
Camel Designer（XMLルートをビジュアル表示）

XML DSL のメリットまとめ

構造が見える！：ツリー構造でルートが明確
設計書になる！：そのまま資料化・共有できる
レビューしやすい！：差分も追いやすく、構成変更が明示的
GUI支援と相性◎！：Camel Designer や Hawtio で設計・確認が可能
行単位での編集がしやすい！：局所的な修正が簡単
改行・コメント・description属性で可読性を高められる！：日本語コメントを埋め込んで共有性も向上できる

XML DSL のデメリット

Java DSL に比べて柔軟性は低い（複雑な処理はProcessorに逃がす）
タグが多く冗長に見えることがあるが、改行・インデント・コメント・description属性を活用すれば十分に補える
ロジック処理は記述できないため、Javaと併用が前提
IDE補完はあるが、Java DSLのようなデバッグブレイクポイントは効かない（代わりに Hawtio で追跡）

サンプルルート：条件分岐 + ログ出力

<route id="errorLogRoute" description="ERRORレベルのログだけ抽出して記録するルート">
  <from uri="kafka:logs"/>
  <filter>
    <!-- body.level が ERROR の場合にログ出力 -->
    <simple>${body.level} == 'ERROR'</simple>
    <to uri="log:errorLogger"/>
  </filter>
</route>

おわりに

XML DSL は Camel において構成の明確さと保守性に優れた記述方法です。
ルート全体が「見える」ことは、チーム開発や長期運用において非常に大きな価値になります。

処理が複雑になる場面では Java Processor などと併用する設計が基本になりますが、
記述が冗長になりがちな点は、整理された構造や日本語コメントによって補完可能であり、
工夫次第で読みやすく美しいルート設計ができます。

次回は、GUI支援を前提とした YAML DSL 編を予定しています！