获取单一功能

const feature = appConfigClient.getFeature('feature_id'); // feature can be null incase of an invalid feature id

if (feature !== null) {
   console.log(`Feature Name ${feature.getFeatureName()} `);
   console.log(`Feature Id ${feature.getFeatureId()} `);
   console.log(`Feature Type ${feature.getFeatureDataType()} `);
   if (feature.isEnabled()) {
      // feature flag is enabled
   } else {
      // feature flag is disabled
   }
}

获取所有功能

const features = appConfigClient.getFeatures();
const feature = features['feature_id'];

if (feature !== null) {
   console.log(`Feature Name ${feature.getFeatureName()} `);
   console.log(`Feature Id ${feature.getFeatureId()} `);
   console.log(`Feature Type ${feature.getFeatureDataType()} `);
   console.log(`Is feature enabled? ${feature.isEnabled()} `);
}

功能评估

您可以使用 feature.getCurrentValue(entityId, entityAttributes) 方法来评估功能标志的值。 此方法返回一个 JSON 对象，其中包含已评估的值，已启用的功能部件标志状态和评估详细信息。

const entityId = '<entityId>';
const entityAttributes = {
  city: 'Bangalore',
  country: 'India',
};

const result = feature.getCurrentValue(entityId, entityAttributes);
console.log(result.value); // Evaluated value of the feature flag. The type of evaluated value will match the type of feature flag (Boolean, String, Numeric).
console.log(result.isEnabled); // enabled status.
console.log(result.details); // a JSON object containing detailed information of the evaluation.

// the `result.details` will have the following
console.log(result.details.valueType); // a string value. Example: DISABLED_VALUE
console.log(result.details.reason); // a string value. Example: Disabled value of the feature flag since the feature flag is disabled.
console.log(result.details.segmentName); // (only if applicable, else it is undefined) a string value containing the segment name for which the feature flag was evaluated.
console.log(result.details.rolloutPercentageApplied); // (only if applicable, else it is undefined) a boolean value. True if the entityId was part of the rollout percentage evaluation, false otherwise.
console.log(result.details.errorType); // (only if applicable, else it is undefined) contains the error.message if any error was occured during the evaluation.

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

• entityAttributes: 由属性名称及其定义指定实体的值组成的 JSON 对象。 如果未使用任何目标定义配置功能标志，那么这是可选参数。 如果配置了目标，那么应该为规则评估提供 entityAttributes。 属性是用于定义段的参数。 SDK 使用属性值来确定指定的实体是否满足目标规则，并返回相应的功能标志值。

获取单个属性

const property = appConfigClient.getProperty('property_id'); // property can be null incase of an invalid property id

if (property != null) {
  console.log(`Property Name ${property.getPropertyName()} `);
  console.log(`Property Id ${property.getPropertyId()} `);
  console.log(`Property Type ${property.getPropertyDataType()} `);
}

获取所有属性

const properties = appConfigClient.getProperties();
const property = properties['property_id'];

if (property != null) {
  console.log(`Property Name ${property.getPropertyName()} `);
  console.log(`Property Id ${property.getPropertyId()} `);
  console.log(`Property Type ${property.getPropertyDataType()} `);
}

评估属性

您可以使用 property.getCurrentValue(entityId, entityAttributes) 方法来评估属性的值。 此方法返回包含求值和求值详细信息的 JSON 对象。

const entityId = '<entityId>';
const entityAttributes = {
  city: 'Bangalore',
  country: 'India',
};

const result = property.getCurrentValue(entityId, entityAttributes);
console.log(result.value); // Evaluated value of the property. The type of evaluated value will match the type of property (Boolean, String, Numeric).
console.log(result.details); // a JSON object containing detailed information of the evaluation. See below

// the `result.details` will have the following
console.log(result.details.valueType); // a string value. Example: DEFAULT_VALUE
console.log(result.details.reason); // a string value. Example: Default value of the property.
console.log(result.details.segmentName); // (only if applicable, else it is undefined) a string value containing the segment name for which the property was evaluated.
console.log(result.details.errorType); // (only if applicable, else it is undefined) contains the error.message if any error was occured during the evaluation.

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

• entityAttributes: 由属性名称及其定义指定实体的值组成的 JSON 对象。 如果属性未配置任何目标定义，那么这是可选参数。 如果配置了目标，那么应该为规则评估提供 entityAttributes。 属性是用于定义段的参数。 SDK 使用属性值来确定指定的实体是否满足目标规则，并返回相应的属性值。

获取私钥属性

用于获取存储在 App Configuration中的私钥引用的显式方法。

const secretPropertyObject = appConfigClient.getSecret(propertyId, secretsManagerObject);

其中，

• propertyID: propertyID 是唯一字符串标识，通过使用此标识，您可以访存将提供必需数据来访存私钥的属性。

• secretsManagerObject: secretsManagerObject 是用于在私钥属性求值期间获取私钥的 Secrets Manager 客户机对象。 有关如何创建 Secrets Manager 客户机对象的更多信息，请参阅 此处。

评估私钥属性

使用 secretPropertyObject.getCurrentValue(entityId, entityAttributes) 方法来评估私钥属性的值。 此方法调用的输出与使用功能部件和属性对象启动的 getCurrentValue 不同。 此方法返回使用来自 Secrets Manager 的响应进行解析的 Promise，或者返回带有错误的拒绝。 解析值是求值的私钥引用的实际私钥值。 响应包含主体，头，状态码和状态文本。 如果使用 async 或 await，请使用 try 或 catch 来处理错误。

const entityId = 'john_doe';
const entityAttributes = {
   city: 'Bangalore',
   country: 'India',
};
try {
   const res = await secretPropertyObject.getCurrentValue(entityId, entityAttributes);
   console.log(JSON.stringify(res, null, 2)); // view entire response.
   console.log('Resulting secret:\n', res.result.resources[0].secret_data.payload); // the actual secret value.
} catch (err) {
   // handle the error
}

其中，

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

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