11.2. オプションの設定


Camel コンポーネントは、以下の 2 つのレベルで設定されます。

  • コンポーネントレベル
  • エンドポイントレベル

11.2.1. コンポーネントレベルのオプションの設定

コンポーネントレベルは最も高い設定レベルです。これには、すべてのエンドポイントの一般的な設定と共通設定が含まれています。

コンポーネントは、Component DSL を使用して、設定ファイル (application.properties|yaml) で、または直接 Java コードで設定できます。

コンポーネントによってはオプションが少ししかないものもあれば、多くのオプションを持つものもあります。コンポーネントには、セキュリティー設定、認証用の認証情報、ネットワーク接続の URL などが含まれます。

コンポーネントには通常、最も一般的なケースのデフォルトが事前設定されているため、オプションを設定する必要がなかったり、少し設定するだけだったりします。

11.2.2. コンポーネントオプション

AtlasMap コンポーネントは、4 つのオプションをサポートしています。

名前説明Commentデフォルトタイプ

lazyStartProducer (producer)

producer の Lazy start。

producer は最初のメッセージで起動します。

producer が起動に失敗し、ルートが失敗する状況で CamelContext およびルートの開始を可能にします。

Lazy start が有効になっている場合、Camel のルーティングエラーハンドラーを介してメッセージのルーティング中に障害を処理できます。

最初のメッセージが処理されると、producer の作成と起動により、合計処理時間が長くなる可能性があります。

false

boolean

atlasContextFactory (advanced)

AtlasContextFactory を使用する場合。これ以外の場合は、新しいエンジンが作成されます。

 

AtlasContextFactory

autowiredEnabled (advanced)

自動ワイヤリングが有効になっているかどうか。これは、コンポーネントで設定される一致するタイプのインスタンスが 1 つあるかどうかを検出するためにレジストリーを検索することで、自動ワイアリングオプションに使用されます (オプションは自動ワイアとマーク付けされる必要があります)。これは、JDBC データソース、JMS 接続ファクトリー、AWS クライアントなどの自動設定に使用できます。

true

boolean

propertiesFile (advanced)

AtlasContextFactory の初期化に使用されるプロパティーファイルの URI。

11.2.3. エンドポイントレベルオプションの設定

エンドポイントレベルでは、エンドポイント自体の設定が含まれます。

エンドポイントは、パスおよびクエリーパラメーターとしてエンドポイント URI で直接設定できます。Endpoint DSL および Data Format DSL を、Java でエンドポイントを設定する タイプセーフ な方法として使用することもできます。

エンドポイントには多くの場合、エンドポイントに必要な内容を設定するオプションが多数あります。

エンドポイントオプションは、consumer (from) または producer (to) としての使用、あるいはその両方での使用として分類されます。

オプションを設定する際のグッドプラクティスは、URL、ポート番号、および機密情報のハードコーディングされた設定の代わりに、プロパティープレースホルダー を使用することです。

プレースホルダーを使用してコードから設定を外部化し、より柔軟で再利用可能にします。

11.2.4. エンドポイントオプション

Apache Camel Component Reference エンドポイントは、パスとクエリーパラメーターを持つ URI 構文を使用して設定されます。

atlas:resourceUri

11.2.4.1. パスパラメーター(1 パラメーター)

名前

説明

デフォルト

タイプ

resourceUri (producer)

必須 リソースへのパス。classpathfilehttpref、または bean の接頭辞を付けることができます。

接頭辞 classpathfile、および http は、これらのプロトコルを使用してリソースをロードします。接頭辞 ref は、レジストリーでリソースを検索します。接頭辞 bean は、ドット (bean:myBean.myMethod) の後に指定される名前でリソースとして使用される Bean メソッドを呼び出します。

classpath

String

11.2.4.2. クエリーパラメーター (7 パラメーター)

名前

説明

コメント

デフォルト

タイプ

allowContextMapAll (producer)

すべてのコンテキストマップの詳細へのアクセスを許可します。

デフォルトでは、メッセージボディーとヘッダーへのアクセスのみが許可されます。

有効にすると、allowContextMapAll は現在の Exchange および CamelContext へのフルアクセスを許可します。これにより、CamelContext API の完全な機能へのアクセスが開かれるため、セキュリティーリスクが生じる可能性があります

false

boolean

contentCache (producer)

リソースコンテンツキャッシュを使用します。

 

false

boolean

forceReload (producer)

force reload モードを使用します。

これにより、すべての Exchange のファイルから ADM がロードされます。

デフォルトでは、ADM ファイルは最初の Exchange でのみファイルからロードされ、エンドポイントが再作成されるまで AtlasContext が再利用されます。

false

boolean

lazyStartProducer (producer)(advanced)

producer の Lazy start。

producer は最初のメッセージで起動します。

producer が起動に失敗し、ルートが失敗する状況で CamelContext およびルートの開始を可能にします。

Lazy start が有効になっている場合、Camel のルーティングエラーハンドラーを介してメッセージのルーティング中に障害を処理できます。

最初のメッセージが処理されると、producer の作成と起動により、合計処理時間が長くなる可能性があります。

false

boolean

sourceMapName (producer)

キーが AtlasMap ドキュメント ID である java.util.Map<String, Message> を保持するソースメッセージマップの Exchange プロパティー名。

AtlasMap は、メッセージボディーをソースドキュメントとして使用し、メッセージヘッダーをソースプロパティーとして使用します。ここでのスコープは、ドキュメント ID と同じです。

 

String

targetMapMode (producer)

複数のターゲットドキュメントが存在する場合の配信方法を指定する TargetMapMode 列挙値。

列挙値:

* MAP * MESSAGE_HEADER * EXCHANGE_PROPERTY

MAP: ドキュメントを java.util.Map に保存します。targetMapName が指定されている場合は、java.util.Map がエクスチェンジプロパティーに設定されます。それ以外の場合は、メッセージボディーに設定されます。MESSAGE_HEADER: それらをメッセージヘッダーに格納します。EXCHANGE_PROPERTY: エクスチェンジプロパティーに保存します。

MAP

TargetMapMode

Red Hat logoGithubRedditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.