46.7. Spring Boot 自動設定
Spring Boot で servlet を使用する場合は、自動設定をサポートするために、次の Maven 依存関係を必ず使用してください。
<dependency>
<groupId>org.apache.camel.springboot</groupId>
<artifactId>camel-servlet-starter</artifactId>
<version>3.14.5.redhat-00032</version>
<!-- Use your Camel Spring Boot version -->
</dependency>
コンポーネントは、以下に記載される 15 のオプションをサポートします。
| Name | 説明 | デフォルト | タイプ |
|---|---|---|---|
| camel.component.servlet.allow-java-serialized-object | リクエストが context-type=application/x-java-serialized-object を使用する場合に Java シリアル化を許可するかどうか。これは、デフォルトでオフになっています。これを有効にすると、Java が受信データをリクエストから Java にデシリアライズし、セキュリティー上のリスクが生じる可能性があることに注意してください。 | false | ブール値 |
| camel.component.servlet.attachment-multipart-binding | Camel エクスチェンジで multipart/form-data を添付ファイルとして自動的にバインドするかどうか。オプション attachmentMultipartBinding=true と disableStreamCache=false は一緒に使用できません。AttachmentMultipartBinding を使用するには、disableStreamCache を削除します。サーブレットの使用時にこれを有効にするには、サーブレット固有の設定が必要になる場合があるため、これはデフォルトでオフになっています。 | false | ブール値 |
| camel.component.servlet.autowired-enabled | 自動ワイヤリングが有効になっているかどうか。これは、コンポーネントで設定される一致するタイプのインスタンスが 1 つあるかどうかを検出するためにレジストリーを検索することで、自動ワイアリングオプションに使用されます (オプションは自動ワイアとマーク付けされる必要があります)。これは、JDBC データソース、JMS 接続ファクトリー、AWS クライアントなどの自動設定に使用できます。 | true | ブール値 |
| camel.component.servlet.bridge-error-handler | コンシューマーの Camel ルーティングエラーハンドラーへのブリッジを許可します。よって、コンシューマーが受信メッセージなどの取得を試行している間に発生した例外は、メッセージとして処理され、ルーティングエラーハンドラーによって処理されます。デフォルトでは、コンシューマーは org.apache.camel.spi.ExceptionHandler を使用して例外に対応し、WARN または ERROR レベルでログに記録され、無視されます。 | false | ブール値 |
| camel.component.servlet.enabled | サーブレットコンポーネントの自動設定を有効にするかどうか。これはデフォルトで有効になっています。 | ブール値 | |
| camel.component.servlet.file-name-ext-whitelist | アップロードされたファイルを受け入れるための受け入れられたファイル名拡張子のホワイトリスト。複数の拡張子は、txt、xml のようにコンマで区切ることができます。 | String | |
| camel.component.servlet.header-filter-strategy | カスタムの org.apache.camel.spi.HeaderFilterStrategy を使用して、Camel メッセージとの間でヘッダーをフィルターします。このオプションは org.apache.camel.spi.HeaderFilterStrategy タイプです。 | HeaderFilterStrategy | |
| camel.component.servlet.http-binding | カスタム HttpBinding を使用して、Camel メッセージと HttpClient との間のマッピングを制御します。オプションは org.apache.camel.http.common.HttpBinding タイプです。 | HttpBinding | |
| camel.component.servlet.http-configuration | 共有 HttpConfiguration を基本設定として使用するには、以下を行います。オプションは org.apache.camel.http.common.HttpConfiguration タイプです。 | HttpConfiguration | |
| camel.component.servlet.http-registry | カスタム org.apache.camel.component.servlet.HttpRegistry を使用します。オプションは org.apache.camel.http.common.HttpRegistry タイプです。 | HttpRegistry | |
| camel.component.servlet.mute-exception | 有効にすると、エクスチェンジがコンシューマー側で処理に失敗した場合、レスポンスの本文には例外のスタックトレースが含まれません。 | false | ブール値 |
| camel.component.servlet.servlet-name | 使用するサーブレットのデフォルト名。デフォルト名は CamelServlet です。 | CamelServlet | String |
| camel.servlet.mapping.context-path | 自動マッピングのためにサーブレットコンポーネントによって使用されるコンテキストパス。 | /camel/* | String |
| camel.servlet.mapping.enabled | サーブレットコンポーネントの Spring Web コンテキストへの自動マッピングを有効にします。 | true | ブール値 |
| camel.servlet.mapping.servlet-name | Camel サーブレットの名前。 | CamelServlet | String |