46.4. エンドポイントオプション
Netty エンドポイントは、URI 構文を使用して設定されます。
netty:protocol://host:port
netty:protocol://host:port
パスおよびクエリーパラメーターを使用します。
46.4.1. パスパラメーター (3 パラメーター) リンクのコピーリンクがクリップボードにコピーされました!
名前 | 説明 | デフォルト | タイプ |
---|---|---|---|
protocol (共通) | 必須 tcp または udp の使用するプロトコル。 列挙値:
| String | |
host (共通) | 必須 ホスト名。consumer の場合、ホスト名は localhost または 0.0.0.0 です。producer の場合、ホスト名は接続先のリモートホストです。 | String | |
port (共通) | 必須 ホストのポート番号。 | int |
46.4.2. クエリーパラメーター (71 パラメーター) リンクのコピーリンクがクリップボードにコピーされました!
名前 | 説明 | デフォルト | タイプ |
---|---|---|---|
disconnect (共通) | 使用直後に Netty Channel を切断 (クローズ) するかどうか。consumer と producer の両方に使用できます。 | false | boolean |
keepAlive (共通) | 非アクティブのためにソケットが閉じられないようにするための設定。 | true | boolean |
reuseAddress (共通) | ソケットの多重化を容易にするための設定。 | true | boolean |
reuseChannel (共通) | このオプションにより、producer と consumer (クライアントモード) は、エクスチェンジを処理するライフサイクルで同じ Netty チャネルを再利用できます。これは、Camel ルートでサーバーを複数回呼び出す必要があり、同じネットワーク接続を使用したい場合に便利です。これを使用すると、チャネルはエクスチェンジが完了するまで接続プールに返されません。または、切断オプションが true に設定されている場合は切断されます。再利用されたチャネルは、キー NettyConstants#NETTY_CHANNEL を持つエクスチェンジプロパティーとしてエクスチェンジに保存されます。これにより、ルーティング中にチャネルを取得して使用することもできます。 | false | boolean |
sync (共通) | エンドポイントを一方向または要求応答として設定する設定。 | true | boolean |
tcpNoDelay (共通) | TCP プロトコルのパフォーマンスを向上させるための設定。 | true | boolean |
bridgeErrorHandler (consumer) | consumer の Camel ルーティングエラーハンドラーへのブリッジを許可します。よって、consumer が受信メッセージなどの取得を試行している間に発生した例外は、メッセージとして処理され、ルーティングエラーハンドラーによって処理されます。デフォルトでは、consumer は org.apache.camel.spi.ExceptionHandler を使用して例外に対応し、WARN または ERROR レベルでログに記録され、無視されます。 | false | boolean |
broadcast (consumer) | UDP 経由のマルチキャストを選択するための設定。 | false | boolean |
clientMode (consumer) | clientMode が true の場合、netty consumer はアドレスを TCP クライアントとして接続します。 | false | boolean |
reconnect (consumer) | consumer の clientMode でのみ使用されます。これが有効になっている場合、consumer は切断時に再接続を試みます。 | true | boolean |
reconnectInterval (consumer) | 再接続し、clientMode が有効になっている場合に使用されます。再接続を試みる間隔 (ミリ秒)。 | 10000 | int |
backlog (consumer (上級)) | netty consumer (server) のバックログを設定できます。バックログは、OS によってはベストエフォートであることに注意してください。このオプションを 200、500、1000 などの値に設定すると、TCP スタックに受け入れキューの長さが通知されます。このオプションが設定されていない場合、バックログは OS の設定に依存します。 | int | |
bossCount (consumer (上級)) | netty が nio モードで動作する場合、Netty のデフォルトの BossCount パラメーターである 1 を使用します。ユーザーはこのオプションを使用して、Netty のデフォルトの BossCount をオーバーライドできます。 | 1 | int |
bossGroup (consumer (上級)) | NettyEndpoint を介してサーバー側の新しい接続を処理するために使用できる BossGroup を設定します。 | EventLoopGroup | |
disconnectOnNoReply (consumer (上級)) | 同期が有効になっている場合、このオプションは、返信がない場合に NettyConsumer を切断するかどうかを指定します。 | true | boolean |
exceptionHandler (consumer (上級)) | consumer によるカスタム ExceptionHandler の使用を許可します。bridgeErrorHandler オプションが有効な場合は、このオプションは使用されないことに注意してください。デフォルトでは、consumer は例外に対応し、WARN または ERROR レベルでログに記録され、無視されます。 | ExceptionHandler | |
exchangePattern (consumer (上級)) | consumer がエクスチェンジを作成する際に交換パターンを設定します。 列挙値:
| ExchangePattern | |
nettyServerBootstrapFactory (consumer (上級)) | カスタム NettyServerBootstrapFactory を使用するには。 | NettyServerBootstrapFactory | |
networkInterface (consumer (上級)) | UDP を使用する場合、このオプションを使用してネットワークインターフェイスをその名前で指定できます (マルチキャストグループに参加するための eth0 など)。 | String | |
noReplyLogLevel (consumer (上級)) | 同期が有効になっている場合、このオプションは NettyConsumer がログに記録するときに使用するログレベルを決定し、返信する応答がありません。 列挙値:
| WARN | LoggingLevel |
serverClosedChannelExceptionCaughtLogLevel (consumer (上級)) | サーバー (NettyConsumer) が java.nio.channels.ClosedChannelException をキャッチすると、このログレベルを使用してログに記録されます。これは、クローズドチャネル例外のログ記録を回避するために使用されます。これは、クライアントが突然切断され、Netty サーバーでクローズド例外のフラッドが発生する可能性があるためです。 列挙値:
| DEBUG | LoggingLevel |
serverExceptionCaughtLogLevel (consumer (上級)) | サーバー (NettyConsumer) が例外をキャッチすると、このログレベルを使用してログに記録されます。 列挙値:
| WARN | LoggingLevel |
serverInitializerFactory (consumer (上級)) | カスタム ServerInitializerFactory を使用するには。 | ServerInitializerFactory | |
usingExecutorService (consumer (上級)) | 順序付けられたスレッドプールを使用して、イベントが同じチャネルで順番に処理されるかどうか。 | true | boolean |
connectTimeout (producer) | ソケット接続が使用可能になるまで待機する時間。値はミリ秒単位です。 | 10000 | int |
lazyStartProducer (producer) | 最初のメッセージで producer をレイジーに起動すべきかどうか。レイジーに起動することで、起動時に producer が失敗し、それによりルートが失敗する可能性がある状況で、CamelContext およびルートの起動を許可します。レイジーな起動を延期すると、Camel のルーティングエラーハンドラー経由でメッセージのルーティング中に起動の失敗を処理できます。最初のメッセージが処理されるときに、producer の作成および起動に若干時間がかかり、合計処理時間が長くなる可能性があることに注意してください。 | false | boolean |
requestTimeout (producer) | リモートサーバーを呼び出すときに、Netty producer のタイムアウトを使用できるようにします。デフォルトでは、タイムアウトは使用されていません。値はミリ秒単位なので、たとえば 30000 は 30 秒です。requestTimeout は、Netty の ReadTimeoutHandler を使用してタイムアウトをトリガーしています。 | long | |
clientInitializerFactory (producer (上級)) | カスタム ClientInitializerFactory を使用するには。 | ClientInitializerFactory | |
correlationManager (producer (上級)) | カスタム相関マネージャーを使用して、netty producer で要求/応答を使用するときに、要求メッセージと応答メッセージがどのようにマップされるかを管理します。これは、要求メッセージと応答メッセージの両方に相関 ID がある場合など、要求を応答と一緒にマップする方法がある場合にのみ使用してください。これは、netty の同じチャネル (別名接続) で同時メッセージを多重化したい場合に使用できます。これを行う場合、リクエストメッセージと応答メッセージを相互に関連付ける方法が必要です。これにより、継続してルーティングされる前に、進行中の Camel エクスチェンジに正しい応答を格納できます。カスタム相関マネージャーを作成するときは、TimeoutCorrelationManagerSupport を拡張することをお勧めします。これにより、タイムアウトや他の方法で実装する必要があるその他の複雑さもサポートされます。詳細については、producerPoolEnabled オプションも参照してください。 | NettyCamelStateCorrelationManager | |
lazyChannelCreation (producer (上級)) | Camel producer の起動時にリモートサーバーが稼働していない場合は、例外を回避するためにチャネルを遅延作成できます。 | true | boolean |
producerPoolEnabled (producer (上級)) | producer プールが有効かどうか。重要: これをオフにすると、リクエスト/リプライを実行している場合にも、単一の共有接続が producer に使用されます。つまり、返信が順不同で戻ってきた場合、インタリーブされた応答に問題が生じる可能性があります。したがって、Camel でメッセージの処理を継続するロールを持つ Camel コールバックに応答を適切に関連付けることができるように、要求メッセージと応答メッセージの両方に相関 ID が必要です。これを行うには、NettyCamelStateCorrelationManager を相関マネージャーとして実装し、correlationManager オプションを介して設定する必要があります。詳細は、correlationManager オプションも参照してください。 | true | boolean |
producerPoolMaxIdle (producer (上級)) | プール内のアイドルインスタンス数の上限を設定します。 | 100 | int |
producerPoolMaxTotal (producer (上級)) | 特定の時間にプールによって割り当てられる (クライアントにチェックアウトされるか、チェックアウトを待機するアイドル) オブジェクトの数に上限を設定します。無制限の場合は負の値を使用します。 | -1 | int |
producerPoolMinEvictableIdle (producer (上級)) | アイドル状態のオブジェクト Evictor によるエビクションの対象となる前に、オブジェクトがプール内でアイドル状態になる最小時間 (ミリ単位の値) を設定します。 | 300000 | long |
producerPoolMinIdle (producer (上級)) | evictor スレッド (アクティブな場合) が新しいオブジェクトを生成する前に、producer プールで許可されるインスタンスの最小数を設定します。 | int | |
udpConnectionlessSending (producer (上級)) | このオプションは接続のない UDP 送信をサポートします。接続された udp send は、受信ポートでリッスンしている人がいない場合、PortUnreachableException を受け取ります。 | false | boolean |
useByteBuf (producer (上級)) | useByteBuf が true の場合、netty producer はメッセージ本文を送信する前に ByteBuf に変換します。 | false | boolean |
ホスト名検証 (セキュリティー) | SSLEngine でのホスト名検証を有効または無効にします。 | false | boolean |
allowSerializedHeaders (上級) | transferExchange が true の場合にのみ TCP に使用されます。true に設定すると、ヘッダーとプロパティーのシリアル化可能なオブジェクトが交換に追加されます。そうしないと、Camel はシリアル化できないオブジェクトを除外し、WARN レベルでログに記録します。 | false | boolean |
channelGroup (上級) | 明示的な ChannelGroup を使用するには。 | ChannelGroup | |
nativeTransport (上級) | NIO の代わりにネイティブトランスポートを使用するかどうか。ネイティブトランスポートはホストオペレーティングシステムを利用し、一部のプラットフォームでのみサポートされます。使用しているホストオペレーティングシステムの netty JAR を追加する必要があります。詳細については、を参照してください。 | false | boolean |
options (上級) | オプションを使用して、追加の netty オプションを設定できます。接頭辞として。たとえば、netty オプション child.keepAlive=false を設定するには、option.child.keepAlive=false とします。使用可能なオプションについては、Netty のドキュメントを参照してください。 | Map | |
receiveBufferSize (上級) | インバウンド通信中に使用される TCP/UDP バッファーサイズ。サイズはバイトです。 | 65536 | int |
receiveBufferSizePredictor (上級) | バッファーサイズプレディクターを設定します。詳細は、Jetty のドキュメントとこのメールスレッドを参照してください。 | int | |
sendBufferSize (上級) | アウトバウンド通信中に使用される TCP/UDP バッファーサイズ。サイズはバイトです。 | 65536 | int |
synchronous (上級) | 同期処理を厳密に使用するかどうかを設定します。 | false | boolean |
transferExchange (上級) | TCP にのみ使用されます。ボディーだけでなく、ネットワーク経由でエクスチェンジを転送することができます。In body、Out body、fault body、In ヘッダー、Out ヘッダー、Fault ヘッダー、exchange プロパティー、exchange 例外フィールドが転送されます。これには、オブジェクトがシリアライズ可能である必要があります。Camel はシリアル化できないオブジェクトを除外し、WARN レベルでログに記録します。 | false | boolean |
udpByteArrayCodec (上級) | UDP 専用です。Java シリアライゼーションプロトコルの代わりにバイト配列コーデックの使用を有効にした場合。 | false | boolean |
workerCount (上級) | netty が nio モードで動作する場合、Netty のデフォルトの workerCount パラメーター (cpu_core_threads x 2) を使用します。ユーザーはこのオプションを使用して、Netty のデフォルトの workerCount をオーバーライドできます。 | int | |
workerGroup (上級) | ボススレッドプールとして明示的な EventLoopGroup を使用するには。たとえば、スレッドプールを複数の consumer または producer と共有する場合などです。デフォルトでは、各 consumer または producer には、2 x CPU カウントのコアスレッドを備えた独自のワーカープールがあります。 | EventLoopGroup | |
allowDefaultCodec (codec) | netty コンポーネントは、encoder/decoder が null で textline が false の場合、デフォルトのコーデックをインストールします。allowDefaultCodec を false に設定すると、netty コンポーネントがデフォルトコーデックをフィルターチェーンの最初の要素としてインストールするのを防ぎます。 | true | boolean |
autoAppendDelimiter (codec) | テキストラインコーデックを使用して送信するときに、不足している終了区切り文字を自動追加するかどうか。 | true | boolean |
decoderMaxLineLength (codec) | テキストラインコーデックに使用する行の最大長。 | 1024 | int |
decoders (codec) | 使用するデコーダーのリスト。コンマで区切られた値を持つ文字列を使用して、値をレジストリーで検索することができます。Camel がルックアップする必要があることを認識できるように、値の前に # を付けることを忘れないでください。 | リスト | |
delimiter (codec) | テキストラインコーデックに使用する区切り文字。可能な値は LINE と NULL です。 列挙値:
| LINE | TextLineDelimiter |
encoders (codec) | 使用するエンコーダーのリスト。コンマで区切られた値を持つ文字列を使用して、値をレジストリーで検索することができます。Camel がルックアップする必要があることを認識できるように、値の前に # を付けることを忘れないでください。 | リスト | |
encoding (codec) | テキスト行コーデックに使用するエンコーディング (文字セット名)。指定しない場合、Camel は JVM のデフォルトの文字セットを使用します。 | String | |
textline (codec) | TCP にのみ使用されます。コーデックが指定されていない場合、このフラグを使用して、テキスト行ベースのコーデックを示すことができます。指定されていない場合、または値が false の場合、オブジェクトのシリアル化は TCP 経由であると想定されますが、デフォルトでシリアル化できるのは文字列のみです。 | false | boolean |
enabledProtocols (セキュリティー) | SSL を使用するときに有効にするプロトコル。 | TLSv1,TLSv1.1,TLSv1.2 | String |
keyStoreFile (セキュリティー) | 暗号化に使用されるクライアント側の証明書キーストア。 | File | |
keyStoreFormat (security) | ペイロードの暗号化に使用されるキーストア形式。設定されていない場合、デフォルトで JKS になります。 | String | |
keyStoreResource (security) | 暗号化に使用されるクライアント側の証明書キーストア。デフォルトではクラスパスからロードされますが、classpath:、file:、または http: をプレフィックとして指定して、異なるシステムからリソースをロードすることもできます。 | String | |
needClientAuth (security) | SSL の使用時にサーバーがクライアント認証を必要とするかどうかを設定します。 | false | boolean |
パスフレーズ (セキュリティー) | SSH を使用して送信されたペイロードを暗号化/復号化するために使用するパスワード設定。 | String | |
securityProvider (security) | ペイロードの暗号化に使用するセキュリティープロバイダー。設定されていない場合、デフォルトは SunX509 です。 | String | |
ssl (セキュリティー) | このエンドポイントに SSL 暗号化を適用するかどうかを指定する設定。 | false | boolean |
sslClientCertHeaders (security) | 有効で SSL モードの場合、Netty consumer は、サブジェクト名、発行者名、シリアル番号、有効な日付範囲などのクライアント証明書に関する情報を含むヘッダーで Camel メッセージを強化します。 | false | boolean |
sslContextParameters (security) | SSLContextParameters を使用してセキュリティーを設定する場合。 | SSLContextParameters | |
sslHandler (セキュリティー) | SSL ハンドラーを返すために使用できるクラスへの参照。 | SslHandler | |
trustStoreFile (セキュリティー) | 暗号化に使用されるサーバー側の証明書キーストア。 | File | |
trustStoreResource (security) | 暗号化に使用されるサーバー側の証明書キーストア。デフォルトではクラスパスからロードされますが、classpath:、file:、または http: をプレフィックとして指定して、異なるシステムからリソースをロードすることもできます。 | String |