获取单一功能

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 是与将对功能部件进行求值的实体相关的字符串标识。 例如，实体可能是在移动设备上运行的应用程序实例，在云上运行的微服务或运行该微服务的基础结构组件。 对于要与 App Configuration进行交互的任何实体，它必须提供唯一的实体标识。

• 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 是与将针对其对属性进行求值的实体相关的字符串标识。 例如，实体可能是在移动设备上运行的应用程序实例，在云上运行的微服务或运行该微服务的基础结构组件。 对于要与 App Configuration进行交互的任何实体，它必须提供唯一的实体标识。

• entityAttributes: entityAttributes 是类型为 map[string]interface{} 的映射，由属性名称及其定义指定实体的值组成。 如果属性未配置任何目标定义，那么这是可选参数。 如果配置了目标，那么必须为规则评估提供 entityAttributes。 属性是用于定义段的参数。 SDK 使用属性值来确定指定的实体是否满足目标规则，并返回相应的属性值。

获取私钥属性

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

• propertyID: propertyID 是唯一字符串标识，使用此标识，您将能够访存提供了访存私钥所必需的数据的属性。

• 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 是与将针对其对属性进行求值的实体相关的字符串标识。 例如，实体可能是在移动设备上运行的应用程序实例，在云上运行的微服务或运行该微服务的基础结构组件。 对于要与 App Configuration进行交互的任何实体，它必须提供唯一的实体标识。

• 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: 这将提供元数据和有效内容。
• detailedResponse: 这将提供包含 HTTP 响应头数据，元数据和有效内容的完整数据。
• 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()