取得單一特性

feature, err := appConfigClient.GetFeature("online-check-in")
if err == nil {
   fmt.Println("Feature Name", feature.GetFeatureName())
   fmt.Println("Feature Id", feature.GetFeatureID())
   fmt.Println("Feature Type", feature.GetFeatureDataType())

   if (feature.IsEnabled()) {
      // feature flag is enabled
   } else {
      // feature flag is disabled
   }
}

取得所有特性

features, err := appConfigClient.GetFeatures()
if err == nil {
   feature := features["online-check-in"]

   fmt.Println("Feature Name", feature.GetFeatureName())
   fmt.Println("Feature Id", feature.GetFeatureID())
   fmt.Println("Feature Type", feature.GetFeatureDataType())
   fmt.Println("Is feature enabled?", feature.IsEnabled())
}

特性評估

您可以使用 feature.GetCurrentValue(entityId, entityAttributes) 方法來評估特性旗標的值。GetCurrentValue 會根據評估傳回其中一個「已啟用」、「已停用」或「已置換」值。

entityId := "john_doe"
entityAttributes := make(map[string]interface{})
entityAttributes["city"] = "Bangalore"
entityAttributes["country"] = "India"

featureVal := feature.GetCurrentValue(entityId, entityAttributes)

• entityId: entityId 是與將對其評估特性之「實體」相關的字串 ID。 例如，實體可能是在行動式裝置上執行的應用程式實例、在雲端上執行的微服務，或執行該微服務之基礎架構的元件。 若要讓任何實體與 App Configuration互動，它必須提供唯一實體 ID。

• entityAttributes: entityAttributes 是 map[string]interface{} 類型的對映，由定義指定實體的屬性名稱及其值組成。 如果特性旗標未配置任何目標定義，則這是選用參數。 如果已配置目標，則必須提供 entityAttributes 以進行規則評估。 屬性是用來定義區段的參數。 SDK 使用屬性值來判斷指定的實體是否滿足目標規則，並傳回適當的特性旗標值。

取得單一內容

property, err := appConfigClient.GetProperty("check-in-charges")
if err == nil {
   fmt.Println("Property Name", property.GetPropertyName())
   fmt.Println("Property Id", property.GetPropertyID())
   fmt.Println("Property Type", property.GetPropertyDataType())
}

取得所有內容

properties, err := appConfigClient.GetProperties()
if err == nil {
   property := properties["check-in-charges"]

   fmt.Println("Property Name", property.GetPropertyName())
   fmt.Println("Property Id", property.GetPropertyID())
   fmt.Println("Property Type", property.GetPropertyDataType())
}

內容評估

您可以使用 property.GetCurrentValue(entityId, entityAttributes) 方法來評估內容的值。GetCurrentValue 會根據評估傳回預設內容值或其置換值。

entityId := "john_doe"
entityAttributes := make(map[string]interface{})
entityAttributes["city"] = "Bangalore"
entityAttributes["country"] = "India"

propertyVal := property.GetCurrentValue(entityId, entityAttributes)

• entityId: entityId 是與將對其評估內容的實體相關的字串 ID。 例如，實體可能是在行動式裝置上執行的應用程式實例、在雲端上執行的微服務，或執行該微服務之基礎架構的元件。 若要讓任何實體與 App Configuration互動，它必須提供唯一實體 ID。

• entityAttributes: entityAttributes 是 map[string]interface{} 類型的對映，由定義指定實體的屬性名稱及其值組成。 如果內容未配置任何目標定義，則這是選用參數。 如果已配置目標，則必須提供 entityAttributes 以進行規則評估。 屬性是用來定義區段的參數。 SDK 會使用屬性值來判斷指定的實體是否滿足目標規則，並傳回適當的內容值。

取得密鑰內容

secretPropertyObject, err := appConfiguration.GetSecret(propertyID, secretsManagerObject)

• propertyID: propertyID 是唯一字串 ID，使用此 ID 您將能夠提取內容，該內容提供提取密鑰所需的資料。

• secretsManagerObject: secretsManagerObject 是 Secrets Manager 變數或物件，將在密鑰內容評估期間用於取得密鑰。 如需如何建立 Secrets Manager 物件的相關資訊，請參閱 這裡。

評估密鑰內容

使用 secretPropertyObject.GetCurrentValue(entityId, entityAttributes) 方法來評估密鑰內容的值。GetCurrentValue 會根據評估傳回密鑰值。

entityId := "john_doe"
entityAttributes := make(map[string]interface{})
entityAttributes["city"] = "Bangalore"
entityAttributes["country"] = "India"

getSecretRes, detailedResponse, err := secretPropertyObject.GetCurrentValue(entityId, entityAttributes)

• entityId: entityId 是與將對其評估內容的實體相關的字串 ID。 例如，實體可能是在行動式裝置上執行的應用程式實例、在雲端上執行的微服務，或執行該微服務之基礎架構的元件。 若要讓任何實體與 App Configuration互動，它必須提供唯一實體 ID。

• entityAttributes: entityAttributes 是 map[string]interface{} 類型的對映，由定義指定實體的屬性名稱及其值組成。 如果內容未配置任何目標定義，則這是選用參數。 如果已配置目標，則必須提供 entityAttributes 以進行規則評估。 屬性是用來定義區段的參數。 SDK 會使用屬性值來判斷指定的實體是否滿足目標規則，並傳回適當的內容值。

如何從回應存取有效負載密碼資料

//make sure this import statement is added
import (sm "github.com/IBM/secrets-manager-go-sdk/secretsmanagerv1")

secret := getSecretRes.Resources[0].(*sm.SecretResource)
secretData := secret.SecretData.(map[string]interface{})
payload := secretData["payload"]

GetCurrentValue 將傳送這三個物件作為回應的一部分。

• getSecretRes: 這將提供 meta 資料和有效負載。
• detailedResponse: 這將提供整個資料，其中包括 http 回應標頭資料、meta 資料及有效負載。
• err: 如果要求無效或因某些原因而失敗，這會提供錯誤回應。

secretData["payload"] 會傳回 interface{}，因此會根據您執行類型強制轉型所需的資料。

跨其他模組提取 appConfigClient

SDK 初始化之後，就可以跨其他模組取得 appConfigClient，如下所示：

// **other modules**

import (
   AppConfiguration "github.com/IBM/appconfiguration-go-sdk/lib"
)

appConfigClient := AppConfiguration.GetInstance()
feature, err := appConfigClient.GetFeature("online-check-in")
if (err == nil) {
   enabled := feature.IsEnabled()
   featureValue := feature.GetCurrentValue(entityId, entityAttributes)
}

內容

property, err := appConfigClient.GetProperty("json-property")
if err == nil {
   property.GetPropertyDataType() // STRING
   property.GetPropertyDataFormat() // JSON

   // Example (traversing the returned map)
   result := property.GetCurrentValue(entityID, entityAttributes) // JSON value is returned as a Map
   result.(map[string]interface{})["key"] // returns the value of the key
}

property, err := appConfigClient.GetProperty("yaml-property")
if err == nil {
   property.GetPropertyDataType() // STRING
   property.GetPropertyDataFormat() // YAML

   // Example (traversing the returned map)
   result := property.GetCurrentValue(entityID, entityAttributes) // YAML value is returned as a Map
   result.(map[string]interface{})["key"] // returns the value of the key
}

接聽內容及特性變更

若要接聽資料變更，請在應用程式中新增下列程式碼:

appConfigClient.RegisterConfigurationUpdateListener(func () {
   // **add your code**
   // To find the effect of any configuration changes, you can call the feature or property related methods

   // feature, err := appConfigClient.GetFeature("json-feature")
   // newValue := feature.GetCurrentValue(entityID, entityAttributes)
})

提取最新資料

appConfigClient.FetchConfigurations()