云眼配置

云眼About 4 min

云眼配置

本主题介绍如何使用 EyeofcloudConfig 访问数据文件中的项目配置数据。

概述

全栈 SDK 打开一组定义明确的公共 API，隐藏所有实现详细信息。但是，某些客户端可能需要访问数据文件中的项目配置数据。

在本文档中，我们扩展了公共 API 以定义数据模型和访问方法，客户端可以使用这些模型和方法访问项目配置数据。

EyeofcloudConfig API

公共配置数据模型（EyeofcloudConfig）在下面定义为静态Eyeofcloud项目数据的结构化格式。

获取云眼配置

EyeofcloudConfig可以通过以下公共API调用从EyeofcloudClient（顶级）访问：

public EyeofcloudConfig GetEyeofcloudConfig()

getEyeofcloudConfig 返回一个实例，其中包括EyeofcloudConfig

环境键
开发工具包密钥
数据文件修订号
按其键值映射的所有实验
所有属性
所有受众
所有活动
按其键值映射的灰度发布（特性标帜）
检索项目配置（数据文件）的函数

📘 注意
当 SDK 数据文件更新时（客户端可以添加通知侦听器以获取通知），客户端应调用该方法以获取更新的 EyeofcloudConfig 数据。请参阅以下示例。EYEOFCLOUD_CONFIG_UPDATE

获取数据文件

若要确保多个 SDK 实例都从同一配置实例化（例如，在客户端/服务器方案中），可以在实例之间传递配置（数据文件）的 JSON 字符串表示形式。若要获取数据文件，请使用对象的方法。有关更多信息，请参阅与多个 SDK 实现共享数据文件。EyeofcloudConfig``GetDatafile

对象模型

下面显示了 EyeofcloudConfig 的对象模型。

C# - 对象模型

// EyeofcloudConfig is class describing the current project configuration data being used by this SDK instance. public class EyeofcloudConfig { public string Revision { get; private set; } public string SDKKey { get; private set; } public string EnvironmentKey { get; private set; } public EyeofcloudEvent[] Events { get; private set; } public EyeofcloudAudience[] Audiences { get; private set; } public EyeofcloudAttribute[] Attributes { get; private set; } // This experimentsMap is for experiments of legacy projects only. // For flag projects, experiment keys are not guaranteed to be unique // across multiple flags, so this map may not include all experiments // when keys conflict. public IDictionary<string, EyeofcloudExperiment> ExperimentsMap { get; private set; } public IDictionary<string, EyeofcloudFeature> FeaturesMap { get; private set; } public string GetDatafile { get; private set; } } // Entity.IdKeyEntity is an abstract class used for inheritance in EyeofcloudExperiment, EyeofcloudFeature, EyeofcloudVariation and EyeofcloudVariable classes. public abstract class IdKeyEntity : Entity, IEquatable<object> { public string Id { get; set; } public string Key { get; set; } } // EyeofcloudAttribute is a class describing attribute and inherited from Entity.IdKeyEntity. public class EyeofcloudAttribute : Entity.IdKeyEntity { } // EyeofcloudAudience is a class describing an audience. public class EyeofcloudAudience { public string Id { get; set; } public string Name { get; set; } public object Conditions { get; set; } } // EyeofcloudEvent is a class describing an event and inherited from Entity.IdKeyEntity. public class EyeofcloudEvent : Entity.IdKeyEntity { public string[] ExperimentIds { get; set; } } // EyeofcloudFeature is a class describing a feature flag and inherited from Entity.IdKeyEntity. public class EyeofcloudFeature : Entity.IdKeyEntity { public List<EyeofcloudExperiment> ExperimentRules { get; private set; } public List<EyeofcloudExperiment> DeliveryRules { get; private set; } public IDictionary<string, EyeofcloudVariable> VariablesMap { get; private set; } [Obsolete("Use experimentRules and deliveryRules.")] public IDictionary<string, EyeofcloudExperiment> ExperimentsMap { get; private set; } } // EyeofcloudExperiment is a class describing an experiment and inherited from Entity.IdKeyEntity. public class EyeofcloudExperiment : Entity.IdKeyEntity { public IDictionary<string, EyeofcloudVariation> VariationsMap { get; private set; } public string Audiences { get; private set; } } // EyeofcloudVariation is a class describing a variation in an experiment and inherited from Entity.IdKeyEntity. public class EyeofcloudVariation : Entity.IdKeyEntity { [JsonProperty(NullValueHandling = NullValueHandling.Ignore)] public bool? FeatureEnabled { get; private set; } public IDictionary<string, EyeofcloudVariable> VariablesMap { get; private set; } } // EyeofcloudVariable is a class describing a feature flag variable and inherited from Entity.IdKeyEntity. public class EyeofcloudVariable : Entity.IdKeyEntity { public string Type { get; private set; } public string Value { get; private set; } }

例子

EyeofcloudConfig可以从EyeofcloudClient（顶级）访问，如下所示：

云眼配置

# 云眼配置

#

# 📘 注意

#

#

云眼配置

📘 注意