【转】ABP源码分析二十一：Feature

Feature是什么？Feature就是对function分类的方法，其与function的关系就比如Role和User的关系一样。

ABP中Feature具有以下属性：其中最重要的属性是name，用以表示feature的Identity,一个feature拥有一个name. 一个Feature可以有一组子Features，从而构成Feature树。

FeatureDictionary：其本身继承自Dictionary。其作用就是把一个Feature及其Child Features从树状结构加载加到Dictionary结构中（扁平化）。

IFeatureDefinitionContext/FeatureDefinitionContextBase : 这组接口和抽象类提供管理FeatureDictionary的方法, 例如：新建一个feature到FeatureDictionary中,和根据 name从 FeatureDictionary返回一个feature. 他们是Feature Manager的基类

IFeatureManager：该接口定义根据name返回Feature的一些方法

FeatureManager：通过调用继承自FeatureDefinitionContextBase中的方法来实现IFeatureManager中定义的方法。这个FeatureManager起到了一个类似适配器的作用，把IFeatureDefinitionContext适配成IFeatureManager。FeatureManager的另一个作用是初始化FeatureDictionary（其Features属性）。

FeatureProvider: 抽象基类，用于向IFeatureDefinitionContext对象（FeatureManager）中添加Feature. Abp框架只提供了抽象类，下面代码是一个简单的示例。实际项目中可以创建自定义FeatureProvider来从数据库中读取feature来填充到FeatureManager对象中。

IFeatureConfiguration/FeatureConfiguration: FeatureManager通过具体的FeatureProvider来初始化FeatureDictionary（其Features属性）。但是ABP核心模块处于项目的最底层，怎么能知道上层定义的FeatureProvider的类型呢？ FeatureConfiguration 为解决这个问题引入了FeatureProvider配置项。FeatureProvider就是一个Type 列表 (ITypeList<FeatureProvider>),注意是FeatureProvider的Type，不是实例。在需要FeatureProvider的地方，可以使用容器根据Type构造出实例。

IFeatureChecker/FeatureChecker: 提供检查特定的feture对于特定的tenant是否可用。首先FeatureChecker 根据Feature Name通过FeatureManager获取Featue,然后通过从IFeatureValueStore对象根据Feature Name和tenantId获取Feature的value值。然后判断value是否为“true”.

IFeatureValueStore: 接口定义了获取Feature值的方法。FeatureValueStore需要在子模块中实现。因为feature往往是存放在数据库中的。所以Abp底层框架是不会包含对数据库有依赖的逻辑.该接口已经完全实现在了 module-zero项目中。如果没有实现该接口，那么默认会使用NullFeatureValueStore对所有的功能返回null（此时使用默认的功能值）。

FeatureInterceptorRegistrar：用于给标注了RequiresFeatureAttribute特性的对象注册FeatureInterceptor拦截器。由AbpKernelModuel调用。

FeatureInterceptor：执行拦截器的逻辑，主要是IFeatureChecker完成feature的检查。一个标准的Castle 拦截器。

IFeatureDependency/SimpleFeatureDependency：如果某项功能要先进行feature检查，可以加上一个IFeatureDependency属性。IFeatureDependency对象通过调用IFeatureChecker对象完成真正的检查。具体用例，可查看MenuItemDefinition和UserNavigationManager的用法。

IFeatureDependencyContext/FeatureDependencyContext: 这个上下文类封装了IFeatureChecker 和 IResolver对象。被用于方法的形参。

MenuItemDefinition：

UserNavigationManager：

返回ABP源码分析系列文章目录

评论列表

#1楼 2016-04-12 10:02 struggle_new

FeatureProvider是用于设置feature功能，如果我要在一个类或者方法使用这个特性是否有如下两种方式
1、使用RequiresFeature进行检查这种只能对布尔功能
2、使用 FeatureChecker.GetValue在方法中进行判定这种更多的是对值功能
请问一下楼主是否可以这样理解

支持(0) 反对(0)

#2楼 [楼主] 2016-04-12 20:52 ZHK的博客

@ struggle_new
FeatureChecker.IsEnabled对布尔值Feature检查. FeatureChecker.GetValue你的理解是对的。

支持(0) 反对(0)

#3楼 2016-04-12 21:40 struggle_new

@ ZHK的博客
比如我有这么一个功能，某一个租户对用户只能添加100用户！
我基于feature能想到的是首先定一个用户启用功能为feature然后在为这个功能添加一个子feature叫用户最大数量，但是不明白怎么将用户最大数量限定在service或者mananger的方法上！

支持(0) 反对(0)

#4楼 [楼主] 2016-04-13 19:46 ZHK的博客

@ struggle_new
Applicationservice封装了featurechecker，通过它的getvalue方法不是可以获取到租户的这个feature的最大值么。不知道这是不是你想问的。

支持(0) 反对(0)

#5楼 2016-04-13 20:05 struggle_new

@ ZHK的博客
比如在applicationservice里有一个添加用户的方法，然后这个方法限定某一个租户或者版本(edition)添加用户的最大数不能超过我feature定的最大值