222.3. Spring Boot Auto-Configuration
コンポーネントは、以下に記載される 24 個のオプションをサポートします。
名前 | 説明 | デフォルト | タイプ |
---|---|---|---|
camel.component.milo-client.application-name | デフォルトのアプリケーション名 | String | |
camel.component.milo-client.application-uri | デフォルトのアプリケーション URI | String | |
camel.component.milo-client.default-configuration.allowed-security-policies | 許可されたセキュリティーポリシー URI のセット。デフォルトでは、すべてを受け入れて最高のものを使用します。 | Set | |
camel.component.milo-client.default-configuration.application-name | アプリケーション名 | Eclipse Milo 用の Apache Camel アダプター | String |
camel.component.milo-client.default-configuration.application-uri | アプリケーション URI | String | |
camel.component.milo-client.default-configuration.channel-lifetime | チャネルの有効期間 (ミリ秒) | Long | |
camel.component.milo-client.default-configuration.client-id | 新しい接続インスタンスの作成を強制するための仮想クライアント ID | String | |
camel.component.milo-client.default-configuration.discovery-endpoint-suffix | 検出時のエンドポイント URI の接尾辞 | String | |
camel.component.milo-client.default-configuration.discovery-endpoint-uri | 別の検出 URI | String | |
camel.component.milo-client.default-configuration.key-alias | キーストアファイル内のキーの名前 | String | |
camel.component.milo-client.default-configuration.key-password | キーのパスワード | String | |
camel.component.milo-client.default-configuration.key-store-password | キーストアのパスワード | String | |
camel.component.milo-client.default-configuration.key-store-type | キーストアのタイプ | String | |
camel.component.milo-client.default-configuration.max-pending-publish-requests | 保留中の公開リクエストの最大数 | Long | |
camel.component.milo-client.default-configuration.max-response-message-size | 応答メッセージの最大バイト数 | Long | |
camel.component.milo-client.default-configuration.override-host | サーバーが報告したエンドポイントホストを、エンドポイント URI のホストでオーバーライドします。 | false | Boolean |
camel.component.milo-client.default-configuration.product-uri | 製品の URI | String | |
camel.component.milo-client.default-configuration.request-timeout | リクエストのタイムアウト (ミリ秒) | Long | |
camel.component.milo-client.default-configuration.session-name | セッション名 | String | |
camel.component.milo-client.default-configuration.session-timeout | ミリ秒単位のセッションタイムアウト | Long | |
camel.component.milo-client.enabled | milo-client コンポーネントを有効にします | true | Boolean |
camel.component.milo-client.product-uri | デフォルトの製品 URI | String | |
camel.component.milo-client.reconnect-timeout | デフォルトの再接続タイムアウト | Long | |
camel.component.milo-client.resolve-property-placeholders | 起動時にコンポーネントがプロパティープレースホルダーを解決するかどうか。String タイプのプロパティーのみがプロパティープレースホルダーを使用できます。 | true | Boolean |
222.3.1. 検出
サーバーが専用の検出エンドポイント (/discovery
など) を使用し、別の (安全性の低い) セキュリティーポリシーをサポートしている場合、endpointUri
に追加されるパラメーター discoveryEndpointSuffix
を介してこれを利用できます。または、明示的な discoveryEndpointUri
を使用します。
222.3.2. ホスト名のオーバーライド
クライアントは、サーバーから照会されたエンドポイント情報からのホスト情報を使用します。ただし、状況によっては、このエンドポイント URI が異なる場合があり、接続しているクライアントの観点から見ると間違っている場合があります (内部ホスト名など)。
この場合、パラメーター overrideHost
を true
に設定できます。これにより、検出されたエンドポイント情報が取得されますが、ホスト情報は元の URI の値で上書きされます。
222.3.3. Node ID
ターゲットノードを定義するには、名前空間とノード ID が必要です。以前のバージョンでは、これは nodeId
と namespaceUri
または namespaceIndex
のいずれかを指定することで可能でした。ただし、これは文字列ベースのノード ID の使用のみを許可していました。この設定はまだ可能ですが、新しい方が優先されます。
新しいアプローチは、完全な名前空間とノード ID を ns=1;i=1
の形式で指定することです。これにより、他のノード ID 形式 (数値、GUID/UUID、不透明など) も使用できます。node
パラメーターを使用する場合、古いものは使用しないでください。このノード形式の構文は、セミコロン (;
) で区切られた key=value
のペアのセットです。
正確に 1 つの名前空間と 1 つのノード ID キーを使用する必要があります。設定可能なキーについては、次の表を参照してください。
キー | タイプ | 説明 |
---|---|---|
ns | namespace | 数値ネームスペースインデックス |
nsu | namespace | 名前空間 URI |
s | node | 文字列ノード ID |
i | node | 数値ノード ID |
g | node | GUID/UUID ノード ID |
b | node | 不透明なノード ID の Base64 でエンコードされた文字列 |
構文によって生成された値は透過的に URI パラメーター値にエンコードできないため、エスケープする必要があります。ただし、Camel では実際の値を RAW(…)
内にラップできるため、エスケープが不要になります。以下に例を示します。
milo-client:tcp://user:password@localhost:12345?node=RAW(nsu=http://foo.bar;s=foo/bar)
222.3.4. メソッド ID
OPC UA ノードでメソッド呼び出しを実行できます。パラメーター method
がメソッド呼び出しのノード ID に設定されている場合 (この場合、ノード ID は親オブジェクトに設定する必要があります)、書き込み操作の代わりにメソッド呼び出しが実行されます。
入力パラメーターはボディーから取得されます。
-
本文が null の場合、空の
Variant
が使用されます -
ボディーが
Variant[]
の場合、そのまま使用されます -
ボディーが
Variant
の場合、Variant[]
配列にラップされます -
それ以外の場合、ボディーは
Variant
に変換され、Variant[]
の配列にラップされます。
222.3.5. セキュリティーポリシー
許可するセキュリティーポリシーを設定する場合、既知の OPC UA URI (例: http://opcfoundation.org/UA/SecurityPolicy#Basic128Rsa15
) を使用するか、Milo 列挙型リテラル (例: None
) を使用できます。不明なセキュリティーポリシーの URI または列挙を指定するとエラーになります。
既知のセキュリティーポリシー URI と列挙型リテラルは、SecurityPolicy.java で確認できます。
注記: いずれの場合も、セキュリティーポリシーでは大文字と小文字が区別されると見なされます。