取得單一特性

Feature feature = appConfigClient.getFeature("online-check-in");

if (feature != null) {
    System.out.println("Feature Name : " + feature.getFeatureName());
    System.out.println("Feature Id : " + feature.getFeatureId());
    System.out.println("Feature Type : " + feature.getFeatureDataType());
    System.out.println("Is feature enabled? : " + feature.isEnabled());
}

取得所有特性

HashMap<String, Feature> features = appConfigClient.getFeatures();

特性評估

您可以使用 feature.getCurrentValue(entityId, entityAttributes) 方法來評估特性旗標的值。 您必須傳遞唯一的 entityId 作為特性旗標評估的參數。 如果特性旗標配置了 App Configuration 服務中的區段，您可以將屬性值設為 JSONObject。

String entityId = "john_doe";
JSONObject entityAttributes = new JSONObject();
entityAttributes.put("city", "Bangalore");
entityAttributes.put("country", "India");

String value = (String) feature.getCurrentValue(entityId, entityAttributes);

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

• entityAttributes: JSON 物件，由定義指定實體的屬性名稱及其值組成。 如果特性旗標未配置任何目標定義，則這是選用參數。 如果已配置目標，則應該提供 entityAttributes 以進行規則評估。 屬性是用來定義區段的參數。 SDK 會使用屬性值來判斷指定的實體是否滿足目標規則，並傳回適當的特性旗標值。

取得單一內容

Property property = appConfigClient.getProperty("check-in-charges");

if (property != null) {
    System.out.println("Property Name : " + property.getPropertyName());
    System.out.println("Property Id : " + property.getPropertyId());
    System.out.println("Property Type : " + property.getPropertyDataType());
}

取得所有內容

HashMap<String, Property> property = appConfigClient.getProperties();

內容評估

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

String entityId = "john_doe";
JSONObject entityAttributes = new JSONObject();
entityAttributes.put("city", "Bangalore");
entityAttributes.put("country", "India");

String value = (String) property.getCurrentValue(entityId, entityAttributes);

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

• entityAttributes: JSON 物件，由定義指定實體的屬性名稱及其值組成。 如果內容未配置任何目標定義，則這是選用參數。 如果已配置目標，則應該提供 entityAttributes 以進行規則評估。 屬性是用來定義區段的參數。 SDK 會使用屬性值來判斷指定的實體是否滿足目標規則，並傳回適當的內容值。

內容

Property property = appConfigClient.getProperty("json-property");
if (property != null) {
   property.getPropertyDataType();     // STRING
   property.getPropertyDataFormat();   // JSON
   property.getCurrentValue(entityId, entityAttributes); // JSONObject or JSONArray is returned
}

// Example Below
// input json :- [{"role": "developer", "description": "do coding"},{"role": "tester", "description": "do testing"}]
// expected output :- "do coding"

JSONArray tar_val = (JSONArray) property.get_current_value(entityId, entityAttributes);
String expected_output = (String) ((JSONObject) tar_val.get(0)).get('description');

// input json :- {"role": "tester", "description": "do testing"}
// expected output :- "tester"

JSONObject tar_val = (JSONObject) property.get_current_value(entityId, entityAttributes);
String expected_output = (String) tar_val.get('role');

Property property = appConfigClient.getProperty("yaml-property");
if (property != null) {
   property.getPropertyDataType();     // STRING
   property.getPropertyDataFormat();   // YAML
   property.getCurrentValue(entityId, entityAttributes); // Yaml String is returned
}

設定特性或內容變更的接聽器

SDK 提供當特性旗標或內容的配置變更時，即時通知您的機制。 您可以使用相同的appConfigClient訂閱配置變更。

appConfigClient.registerConfigurationUpdateListener(new ConfigurationUpdateListener() {
   @Override
   public void onConfigurationUpdate() {
      System.out.println("Received updated configurations");
      // **add your code**
      // To find the effect of any configuration changes, you can call the feature or property related methods

      // Feature feature = appConfigClient.getFeature("numeric-feature");
      // Integer newValue = (Integer) feature.getCurrentValue(entityId, entityAttributes);
   }
});

提取最新資料

appConfigClient.fetchConfigurations();