读EntityFramework.DynamicFilters源码_心得_示例演示02

     上次对EntityFramework.DynamicFilters整体的项目结构有了一个认识，这次我们就通过阅读说明文档，示例项目，和单元测试，来动手构建一个我们的体验项目，通过对动态过滤器的使用，使得我们对过滤功能，在心理上有一个感性的认识，然后再一块深入学习代码内部的机理。

     首先,我们来看一下项目说明文档，项目的文档结构说明如下

　　

这是开源项目基础内容

1. CHANGELOG： 一个修改日志，为什么会有修改日志，是对历史发布版本内容的记录，也方便其他使用者，看到修改日志，知道修改了哪些功能，对自己当前的版本有什么影响，要不要升级，等问题．下面是修改日志的内容：

2.LICENSE：这个是做什么用的，打开看的时候，里面是什么法律责任，侵权等问题，去网上查了一下，　在开源项目创建时，还是得仔细考虑一下该用哪种License。要是以后你的项目火了，你就不会因为当初License没选对，而哑巴吃黄连——有苦说不出了。

特别说一下，很多新手（就像我）可能根本没有为自己的项目选择License。没有为项目选择License，意味着他人不能对你的项目进行散发、改动。但他人可以以个人的名义使或以商业用途使用你的软件。另外，如果你将没有License的项目传到了Github上，你就默认接受了Github的服务条款协议——别的用户可以查看或者fork你的项目。

这个网站介绍了各种license的区别：https://choosealicense.com/licenses/

3.Readme.md:第一次打开这个文档是下面这个样子的

去网上找了一下，那么md后缀的文件到底是个什么鬼呢，看这里：

http://www.kuqin.com/shuoit/20141125/343459.html

怎么打开呢，我在vs2015扩展里面，安装了一个插件：

再打开文档的时候，就是这个样子：

左边可以编辑，右边马上就显示了编辑的效果，确实不错

README 应该是介绍code source 的一个概览.其实这个静态文件是有约定成俗的规范.

1.项目介绍

2.代码实现了什么功能?

3.该如何使用? (系统环境参数,部署要素)

4.代码组织架构是什么样的?

5.版本更新重要摘要

如果你的README包括上面的内容,那么当使用者拿到代码,打开README后,基本就知道该如何下手了

下面是创建的体验项目：

第一步：新建控制台应用程序

第二步：通过nuget包管理器，引用：

               1.EntityFramework 6.1.2

         2.EntityFramework.DynamicFilters.2.6.0

第三步：添加dbContext,model

添加DemoContext：

 public class DemoContext: DbContext
    {
        public static Guid CurrentAccountID { get; set; }
        public DbSet<Account> Accounts { get; set; }
        public DbSet<BlogEntry> BlogEntries { get; set; }

        public DemoContext()
        {
            Database.SetInitializer(new ContentInitializer<DemoContext>());
            Database.Log = log => System.Diagnostics.Debug.WriteLine(log);
            Database.Initialize(false);
        }

        protected override void OnModelCreating(DbModelBuilder modelBuilder)
        {
            base.OnModelCreating(modelBuilder);
        }
    }

    public class ContentInitializer<T> : DropCreateDatabaseAlways<T>
       where T : DemoContext
    {
        protected override void Seed(T context)
        {
            System.Diagnostics.Debug.Print("Seeding db");

            //  Seeds 2 accounts with 9 blog entries, 4 of which are deleted

            var homer = new Account
            {
                UserName = "homer",
                BlogEntries = new List<BlogEntry>
                {
                    new BlogEntry { Body="Homer's first blog entry", IsDeleted=false, IsActive=true, StringValue="1"},
                    new BlogEntry { Body="Homer's second blog entry", IsDeleted=false, IsActive=true, StringValue="2"},
                    new BlogEntry { Body="Homer's third blog entry (deleted)", IsDeleted=true, IsActive=true, StringValue="3"},
                    new BlogEntry { Body="Homer's fourth blog entry (deleted)", IsDeleted=true, IsActive=true, StringValue="4"},
                    new BlogEntry { Body="Homer's 5th blog entry (inactive)", IsDeleted=false, IsActive=false, StringValue="5"},
                    new BlogEntry { Body="Homer's 6th blog entry (deleted and inactive)", IsDeleted=true, IsActive=false, StringValue="6"},
                }
            };
            context.Accounts.Add(homer);

            var bart = new Account
            {
                UserName = "bart",
                BlogEntries = new List<BlogEntry>
                {
                    new BlogEntry { Body="Bart's first blog entry", IsDeleted=false, IsActive=true, StringValue="7"},
                    new BlogEntry { Body="Bart's second blog entry", IsDeleted=false, IsActive=true, StringValue="8"},
                    new BlogEntry { Body="Bart's third blog entry", IsDeleted=false, IsActive=true, StringValue="9"},
                    new BlogEntry { Body="Bart's fourth blog entry (deleted)", IsDeleted=true, IsActive=true, StringValue="10"},
                    new BlogEntry { Body="Bart's fifth blog entry (deleted)", IsDeleted=true, IsActive=true, StringValue="11"},
                    new BlogEntry { Body="Bart's 6th blog entry (inactive)", IsDeleted=false, IsActive=false, StringValue="12"},
                    new BlogEntry { Body="Bart's 7th blog entry (deleted and inactive)", IsDeleted=true, IsActive=false, StringValue="13"},
                }
            };
            context.Accounts.Add(bart);

            context.SaveChanges();
        }
    }

添加两个实体：

 public class BlogEntry : ISoftDelete
    {
        [Key]
        [Required]
        [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
        public Guid ID { get; set; }

        public Account Account { get; set; }
        public Guid AccountID { get; set; }

        public string Body { get; set; }

        public bool IsDeleted { get; set; }

        public int? IntValue { get; set; }

        public string StringValue { get; set; }
        public DateTime? DateValue { get; set; }

        public bool IsActive { get; set; }
    }

    public interface ISoftDelete
    {
        bool IsDeleted { get; set; }
    }

    public class Account
    {
        [Key]
        [Required]
        [DatabaseGenerated(DatabaseGeneratedOption.Identity)]
        public Guid ID { get; set; }

        public string UserName { get; set; }

        public ICollection<BlogEntry> BlogEntries { get; set; }

        /// <summary>
        /// Column used to verify handling of Entity properties mapped to different conceptual property names.
        /// </summary>
        [Column("RemappedDBProp")]
        public bool RemappedEntityProp { get; set; }
    }

第四步：重写dbcontext里面 protected override void OnModelCreating(DbModelBuilder modelBuilder) 构建动态过渡器

protected override void OnModelCreating(DbModelBuilder modelBuilder)
        {
            base.OnModelCreating(modelBuilder);
            modelBuilder.Filter("BlogEntryFilter", (BlogEntry b, Guid accountID, bool isDeleted) => (b.AccountID == accountID) && (b.IsDeleted == isDeleted),
                                                () => CurrentAccountID, () => false);
        }

构造了一个过滤器，自动添加条件，查询数据没有被软件删除，且只属于当前登录用户的数据。

调用

var demoContext = new demo.DemoContext();
            var allBlogEntries = demoContext.BlogEntries.ToList();
            foreach (BlogEntry blogEntry in allBlogEntries)
            {
                Console.WriteLine(blogEntry.Body);
            }

通过阅读：开源项目里面的reademe.md文档，简单的把这个动态过滤器，用到ef实体的自动查询上。

公司用的rafy，当时只是知道怎么用rafy的过滤条件，现在想想应该也跟这种方式差不多，像rafy的幽灵插件，只是rafy想根据条件，配置动态查询条件是否方便，之前都只是单独添加插件，确实没有考虑动态的问题，现在ef的这个动态过滤从全局控制确实挺方便的。