Red Hat SummitFuse 6 is no longer supported
As of February 2025, Red Hat Fuse 6 is no longer supported. If you are using Fuse 6, please upgrade to Red Hat build of Apache Camel.第95章 言語
言語
リンクのコピーリンクがクリップボードにコピーされました!
Camel 2.5 で利用可能
言語コンポーネントを使用すると、Camel でサポートされる言語によってスクリプトを実行するエンドポイントに エクスチェンジ を送信できます。http://camel.apache.org/language.html言語スクリプトを実行するコンポーネントを使用すると、より動的なルーティング機能が可能になります。たとえば、Routing SlipRouting Slip または Dynamic RouterDynamic Router EIP を使用すると、スクリプトが動的に定義される
言語 エンドポイントにメッセージを送信することができます。
このコンポーネントは
camel-core の追加設定なしで提供されるため、追加の JAR は必要ありません。Groovy や JavaScript 言語の使用など、選択の言語が義務付けられている場合にのみ、追加の Camel コンポーネントを含める必要があります。
Camel 2.11 以降では、Camel の他の 言語 でサポートされるのと同じ表記を使用するスクリプトの外部リソースを参照できます。
language://languageName:resource:scheme:location][?options]
language://languageName:resource:scheme:location][?options]URI 形式
リンクのコピーリンクがクリップボードにコピーされました!
language://languageName[:script][?options]
language://languageName[:script][?options]URI オプション
リンクのコピーリンクがクリップボードにコピーされました!
コンポーネントは以下のオプションをサポートします。
| 名前 | デフォルト値 | 型 | 説明 |
|---|---|---|---|
languageName
|
null
|
文字列
|
単純な、groovy、javascript など、使用する 言語 の名前。このオプションは必須です。
|
script
|
null
|
文字列
|
実行するスクリプト。 |
変換
|
true
|
boolean
|
スクリプトの結果を新しいメッセージボディーとして使用するかどうか。false に設定するとスクリプトが実行されますが、スクリプトの結果は破棄されます。
|
contentCache
|
true
|
boolean
|
Camel 2.9: リソースからロードされた場合にスクリプトをキャッシュするかどうか。注記： Camel 2.10.3 から、キャッシュされたスクリプトは clearContentCache 操作を使用して JMX 経由でランタイム時にリロードを強制できます。
|
cacheScript
|
false
|
boolean
|
Camel 2.13/2.12.2/2.11.3: コンパイルされたスクリプトをキャッシュするかどうか。このオプションを有効にすると、スクリプトはコンパイル/作成が 1 回のみ行われ、Camel メッセージの処理時に再利用されるため、パフォーマンスが向上します。ただし、これにより、以前の評価で残ったデータに対する副次的な影響が引き起こされ、同時実行の問題にも影響が及ぶ可能性があります。評価中のスクリプトがべき等である場合、このオプションはオンにすることができます。
|
binary
|
false
|
boolean
|
Camel 2.14.1: スクリプトがバイナリーコンテンツであるかどうか。これは、バイナリーファイルの読み込みなど、Constant 言語を使用してリソースを読み込むために使用されます。 |
メッセージヘッダー
リンクのコピーリンクがクリップボードにコピーされました!
以下のメッセージヘッダーを使用して、コンポーネントの動作に影響を与えることができます。
| ヘッダー | 説明 |
|---|---|
CamelLanguageScript
|
ヘッダーで提供される実行するスクリプト。エンドポイントに設定されたスクリプトよりも優先されます。 |
例
リンクのコピーリンクがクリップボードにコピーされました!
たとえば、Simple 言語を Message TranslatorMessage Translator a メッセージに使用できます。
String script = URLEncoder.encode("Hello ${body}", "UTF-8");
from("direct:start").to("language:simple:" + script).to("mock:result");
String script = URLEncoder.encode("Hello ${body}", "UTF-8");
from("direct:start").to("language:simple:" + script).to("mock:result");
メッセージボディーの型を変換する場合は、これも実行できます。
String script = URLEncoder.encode("${mandatoryBodyAs(String)}", "UTF-8");
from("direct:start").to("language:simple:" + script).to("mock:result");
String script = URLEncoder.encode("${mandatoryBodyAs(String)}", "UTF-8");
from("direct:start").to("language:simple:" + script).to("mock:result");
また、この例では、入力メッセージを 2 を乗算して、Groovy 言語を使用することもできます。
from("direct:start").to("language:groovy:request.body * 2").to("mock:result");
from("direct:start").to("language:groovy:request.body * 2").to("mock:result");
以下に示すように、スクリプトをヘッダーとして提供することもできます。ここでは、XPath 言語を使用して <
foo > タグからテキストを抽出します。
Object out = producer.requestBodyAndHeader("language:xpath", "<foo>Hello World</foo>", Exchange.LANGUAGE_SCRIPT, "/foo/text()");
assertEquals("Hello World", out);
Object out = producer.requestBodyAndHeader("language:xpath", "<foo>Hello World</foo>", Exchange.LANGUAGE_SCRIPT, "/foo/text()");
assertEquals("Hello World", out);リソースからのスクリプトの読み込み
リンクのコピーリンクがクリップボードにコピーされました!
Camel 2.9 以降で利用可能
エンドポイント URI または
Exchange.LANGUAGE_SCRIPT ヘッダーのいずれかでロードするスクリプトのリソース URI を指定できます。uri は、file:、classpath:、または http のいずれかのスキームで開始する必要があります。
たとえば、クラスパスからスクリプトを読み込むには、次のコマンドを実行します。
from("direct:start")
// load the script from the classpath
.to("language:simple:classpath:org/apache/camel/component/language/mysimplescript.txt")
.to("mock:result");
from("direct:start")
// load the script from the classpath
.to("language:simple:classpath:org/apache/camel/component/language/mysimplescript.txt")
.to("mock:result");
デフォルトでは、スクリプトは一度ロードされてキャッシュされます。ただし、
contentCache オプションを無効にして、評価ごとにスクリプトを読み込むことができます。たとえば、ディスク上のファイル myscript.txt が変更された場合は、更新されたスクリプトが使用されます。
from("direct:start")
// the script will be loaded on each message, as we disabled cache
.to("language:simple:file:target/script/myscript.txt?contentCache=false")
.to("mock:result");
from("direct:start")
// the script will be loaded on each message, as we disabled cache
.to("language:simple:file:target/script/myscript.txt?contentCache=false")
.to("mock:result");
Camel 2.11 以降では、以下のように resource
: と接頭辞を付けると、Camel の他の 言語 と同様のリソース を参照できます。
from("direct:start")
// load the script from the classpath
.to("language:simple:resource:classpath:org/apache/camel/component/language/mysimplescript.txt")
.to("mock:result");
from("direct:start")
// load the script from the classpath
.to("language:simple:resource:classpath:org/apache/camel/component/language/mysimplescript.txt")
.to("mock:result");- Routing SlipRouting Slip
- Dynamic RouterDynamic Router
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}