取り込まれた接続情報のカスタマイズコードでの使用
このセクションでは、captureExternalConnection ユーティリティを使用して取り込まれたエンドポイント情報を統合の例のカスタマイズコードで使用する方法について説明します。
• captureExternalConnections ユーティリティを使用して取り込まれた接続情報には、統合の例のカスタマイズコードで CustomIntegrationHelper クラスを使用してアクセスします。
• 次のコードスニペットは、CustomIntegrationHelper クラスを使用して接続情報を取得する方法を示しています。
public String getPartNumber() throws Exception {
URI apiUrl = customIntegrationHelper.getNamedEndpointURI("get_material_number");
Map<String, String> map = customIntegrationHelper.getSecretsMap();
String bearerToken = map.get("bearer_token");
SSLContext sslContext = customIntegrationHelper.getInitializedSSLContext();
String uniqueNo = performGetRequest(apiUrl, sslContext, bearerToken);
if (log.isDebugEnabled()) {
log.debug("API URL for fetching part number: " + apiUrl);
log.debug("Unique number returned from API Client :" + uniqueNo);
}
return uniqueNo;
}
URI apiUrl = customIntegrationHelper.getNamedEndpointURI("get_material_number");
Map<String, String> map = customIntegrationHelper.getSecretsMap();
String bearerToken = map.get("bearer_token");
SSLContext sslContext = customIntegrationHelper.getInitializedSSLContext();
String uniqueNo = performGetRequest(apiUrl, sslContext, bearerToken);
if (log.isDebugEnabled()) {
log.debug("API URL for fetching part number: " + apiUrl);
log.debug("Unique number returned from API Client :" + uniqueNo);
}
return uniqueNo;
}
情報の取り込みに使用した JSON および customization/integrations/main/src/com/acme/ext/APIClient.java にあるカスタマイズコードを確認して、CustomIntegrationHelper を使用して接続情報にアクセスする方法について理解します。以下のテーブルで、クライアント証明書チェーンとサーバー証明書チェーンを使用して生成されたベース URL、ベアラートークン、および SSL コンテキストが、CustomIntegrationHelper のオブジェクトインスタンスを使用してカスタマイズコードに読み込まれたことを確認します。
|
captureExternalConnections ユーティリティを介してサブミットされた接続情報
|
CCD ユーティリティを介してサブミットされたカスタマイズコード
|
|---|---|
|
"material_api": {
"baseurl": "replace with your base-url", "url_fragments": { "get_material_number": "/api/material", "get_material_data_stream": "/api/materialData/stream" }, "secrets": { "client_cert": "replace with path to clientcertchain", "bearer_token": "Bearer replace with your bearer token" }, "server_cert": "replace with path to clientcertchain" } |
CustomIntegrationHelper customIntegrationHelper
= new CustomIntegrationHelper("material_api"); public String getPartNumber() throws Exception { URL apiUr1 = customIntegrationHelper.getNamedEndpointURL("get_material_number"); Map<String, String> map = customIntegrationHelper.getSecretsMap(); String bearerToken = map.get("bearer_token"); SSLContext sslContext = customIntegrationHelper.getInitializedSSLContext(); . . . } |
 |
bearer_token は予約済みのキーワードではなく、サンプル実装でのベアラートークン認証に対する特定の処理はありません。基本的には、関連する外部エンドポイントのリクエストを構築する際にカスタマイズコードが識別して利用できるその他の文字列を使用できます。
|