363.4. オプション

Weather コンポーネントは、以下にリストされている 3 個のオプションをサポートしています。

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

geolocationAccessKey (Common)

位置情報サービスを使用するには accessKey が必要になりました

 

String

geolocationRequestHost IP (Common)

位置情報サービスは、使用している accessKey に関連付けられた IP を指定する必要があります

 

String

resolveProperty Placeholders (advanced)

起動時にコンポーネントがプロパティープレースホルダーを解決するかどうか。String タイプのプロパティーのみがプロパティープレースホルダーを使用できます。

true

boolean

Weather エンドポイントは、URI 構文を使用して設定されます。

weather:name

パスおよびクエリーパラメーターを使用します。

363.4.1. パスパラメーター (1 個のパラメーター):

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

name

必須 名前の値は使用されません。

 

String

363.4.2. クエリーパラメーター(45 個のパラメーター):

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

appid (common)

必須 APPID API サーバーに接続しているユーザーの認証に使用される ID

 

String

headerName (common)

メッセージボディーではなく、このヘッダーに天気の結果を格納します。これは、現在のメッセージボディーをそのまま保持したい場合に使用できます。

 

String

language (common)

応答の言語。

en

WeatherLanguage

mode (common)

気象データの出力形式。

JSON

WeatherMode

period (common)

null の場合、現在の天気が返されます。それ以外の場合は、5、7、14 日の値を使用します。予測期間の数値のみが実際に解析されるため、スペルや期間の大文字化はユーザー次第です (無視されます)。

 

String

units (common)

温度測定の単位。

 

WeatherUnits

weatherApi (common)

使用する API(潮流、予報/3 時間、日予報、駅)

 

WeatherApi

bridgeErrorHandler (consumer)

コンシューマーの Camel ルーティングエラーハンドラーへのブリッジを許可します。よって、コンシューマーが受信メッセージなどの取得を試行している間に発生した例外は、メッセージとして処理され、ルーティングエラーハンドラーによって処理されます。デフォルトでは、コンシューマーは org.apache.camel.spi.ExceptionHandler を使用して例外に対応し、WARN または ERROR レベルでログに記録され、無視されます。

false

boolean

sendEmptyMessageWhenIdle (consumer)

ポーリングコンシューマーがファイルをポーリングしなかった場合、このオプションを有効にして、代わりに空のメッセージ (ボディーなし) を送信できます。

false

boolean

exceptionHandler (consumer)

コンシューマーによるカスタム ExceptionHandler の使用を許可します。bridgeErrorHandler オプションが有効な場合は、このオプションは使用されないことに注意してください。デフォルトでは、コンシューマーは例外に対応し、WARN または ERROR レベルでログに記録され、無視されます。

 

ExceptionHandler

exchangePattern (consumer)

コンシューマーがエクスチェンジを作成する際に交換パターンを設定します。

 

ExchangePattern

pollStrategy (consumer)

プラグ可能な org.apache.camel.PollingConsumerPollingStrategy を使用すると、エクスチェンジが作成され、Camel でルーティングされる前に、通常はポーリング操作中に発生するエラー処理を制御するカスタム実装が提供できます。

 

PollingConsumerPoll Strategy

httpConnectionManager (advanced)

カスタム HttpConnectionManager を使用して接続を管理する場合

 

HttpConnectionManager

synchronous (advanced)

同期処理を厳密に使用するか、Camel が非同期処理を使用できるかどうかを設定します (サポートされている場合)。

false

boolean

backoffErrorThreshold (scheduler)

backoffMultipler が開始する前に発生する必要がある後続のエラーポーリング (エラーによって失敗した) の数。

 

int

backoffIdleThreshold (scheduler)

backoffMultipler が開始する前に発生する必要がある後続のアイドルポーリングの数。

 

int

backoffMultiplier (scheduler)

後続のアイドル状態/エラーが連続して発生した場合に、スケジュールされたポーリングコンシューマーのバックオフを許可します。乗数は、実際に次の試行が行われる前にスキップされるポーリングの数です。このオプションが使用されている場合は、backoffIdleThreshold や backoffErrorThreshold も設定する必要があります。

 

int

delay (scheduler)

次のポーリングまでの時間 (ミリ秒単位)。60s (60 秒)、5m30s (5 分 30 秒)、1h (1 時間) などの単位を使用して時間値を指定することもできます。

500

long

greedy (scheduler)

greedy が有効で、以前の実行が 1 つ以上のメッセージをポーリングした場合、ScheduledPollConsumer は即座に再度実行されます。

false

boolean

initialDelay (scheduler)

最初のポーリングが開始されるまでの時間 (ミリ秒単位)。60s (60 秒)、5m30s (5 分 30 秒)、1h (1 時間) などの単位を使用して時間値を指定することもできます。

1000

long

runLoggingLevel (scheduler)

コンシューマーはポーリング時に開始/完了のログ行を記録します。このオプションを使用すると、ログレベルを設定できます。

TRACE

LoggingLevel

scheduledExecutorService (scheduler)

コンシューマーに使用するカスタム/共有スレッドプールを設定できます。デフォルトでは、各コンシューマーに独自の単一スレッドのスレッドプールがあります。

 

ScheduledExecutor Service

scheduler (scheduler)

camel-spring または camel-quartz2 コンポーネントから cron スケジューラーを使用します。

none

ScheduledPollConsumer Scheduler

schedulerProperties (scheduler)

カスタムスケジューラーまたは Quartz2 や Spring ベースのスケジューラーを使用する場合に、追加のプロパティーを設定します。

 

Map

startScheduler (scheduler)

スケジューラーを自動起動するかどうか。

true

boolean

timeUnit (scheduler)

initialDelay および delay オプションの時間単位。

MILLISECONDS

TimeUnit

useFixedDelay (scheduler)

固定遅延または固定レートを使用するかどうかを制御します。詳細は、JDK の ScheduledExecutorService を参照してください。

true

boolean

cnt (filter)

検索結果の数

 

Integer

ids (filter)

都市/駅の ID のリスト。複数の ID をコンマで区切ることができます。

 

String

lat (filter)

ロケーションの緯度。場所の代わりに緯度と経度のオプションを使用できます。ボックス化されたクエリーの場合、これは下の緯度です。

 

String

location (filter)

null の場合、Camel は IP アドレスの地理位置情報を使用して現在の場所を特定しようとします。それ以外の場合は、都市、国を指定します。よく知られている都市名については、Open Weather Map が最適なものを判断しますが、複数の結果が返される場合があります。したがって、国も指定すると、より正確なデータが返されます。current を場所として指定すると、コンポーネントは現在の緯度と経度を取得し、それを使用して天気の詳細を取得しようとします。場所の代わりに緯度と経度のオプションを使用できます。

 

String

lon (filter)

場所の経度。場所の代わりに緯度と経度のオプションを使用できます。ボックス化されたクエリーの場合、これは左経度です。

 

String

rightLon (filter)

ボックス化されたクエリーの場合、これは正しい経度です。topLat および zoom と組み合わせて使用する必要があります。

 

String

topLat (filter)

ボックス化されたクエリーの場合、これは最高許容範囲です。rightLon および zoom と組み合わせて使用する必要があります。

 

String

zip (filter)

郵便番号、例: 94040,us

 

String

zoom (filter)

ボックス化されたクエリーの場合、これはズームです。rightLon および topLat と組み合わせて使用する必要があります。

 

Integer

proxyAuthDomain (proxy)

プロキシー NTLM 認証用のドメイン

 

String

proxyAuthHost (proxy)

プロキシー NTLM 認証用のオプションのホスト

 

String

proxyAuthMethod (proxy)

Basic、Digest、または NTLM のいずれかのプロキシーの認証方法。

 

String

proxyAuthPassword (proxy)

プロキシー認証のパスワード

 

String

proxyAuthUsername (proxy)

プロキシー認証用のユーザー名

 

String

proxyHost (proxy)

プロキシーホスト名

 

String

proxyPort (proxy)

プロキシーポート番号

 

Integer

geolocationAccessKey (security)

必須 位置情報サービスを使用するには accessKey が必要になりました

 

String

geolocationRequestHostIP (security)

必須 位置情報サービスは、使用している accessKey に関連付けられた IP を指定する必要があります

 

文字列

URI には、?option=value&option=value&…​ の形式でクエリーオプションを追加できます。