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) |
必須 リソースへのパス。
接頭辞 |
| String |
11.2.4.2. クエリーパラメーター (7 パラメーター)
名前 | 説明 | コメント | デフォルト | タイプ |
allowContextMapAll (producer) | すべてのコンテキストマップの詳細へのアクセスを許可します。 デフォルトでは、メッセージボディーとヘッダーへのアクセスのみが許可されます。 |
有効にすると、 | 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 である | AtlasMap は、メッセージボディーをソースドキュメントとして使用し、メッセージヘッダーをソースプロパティーとして使用します。ここでのスコープは、ドキュメント ID と同じです。 | String | |
targetMapMode (producer) |
複数のターゲットドキュメントが存在する場合の配信方法を指定する 列挙値: * MAP * MESSAGE_HEADER * EXCHANGE_PROPERTY |
|
| TargetMapMode |