【ASP.NET Core】EF Core - “影子属性”

有朋友说老周近来博客更新较慢，确实有些慢，因为有些 bug 要研究，另外就是老周把部分内容转到直播上面，所以写博客的内容减少了一点。

老周觉得，视频直播可能会好一些，虽然我的水平一般，不过直播时，老周可以现场演示，可能会比看博客效果要好（因为现场演示，有时候会有失误，没办法，水平有限）。还有一个，就是.NET 的资料其实很多，毕竟也发展了十几年了，有些东西如果别人都写过了，那我也不好意思重复了。.NET Core 尽管是跨平台版本，但核心依然是.net 基础，我们不需要全新去学习，只要掌握一些新的变化就可以了。目前比较期待 .NET Core 3 的正式发布，等正式上线了，老周再挑一些有意义的内容写一下。

此外，老周也可能会写一写其他方面的博客，比如 Python、GO、Ruby、Typescript 等。老周并不是只会玩.NET ，只不过老周是主攻 .NET，在接触 .NET 之前，老周就学过很多东西，比如古老的 QBasic、Pascal ，老周在上初中时就学过。后来向 VB、C、C++ 进攻，顺便把 Ruby、Python、PB 也调戏一下，后来有一段时间，Delphi 和 E 语言也挺流行的，所以顺便也玩了两把。

再后来，学过 Java 和 PHP，抛 Java 而投 .NET 是因为 Java 太复杂，效率不高，没有深度把玩的兴趣。现在所谓的 Python 很热门纯属是商业炒作，Python 又不是什么新玩意儿，很古老了，当然相对于 C 来说，是新了一点，究其特点，就是一种脚本语言（虽然有人死要说它不是脚本语言）。现在网上更有些无知小辈，以为自己会写几行 Python 代码就到处去蹭热点，告诉你，老周当年学各种编程语言时，说不定你还没出生呢。所以，如果你真心喜欢 Python 的话，你用心去学就是了（其实老周也喜欢用 Python 来做图表），不必理会商业炒作。

记得去年 C 语言也被商业炒作了几个月，再往前几年，Javascript 和 Web 前端也被拼命炒作，说得好像 js 是万能的似的，吓得老周都不敢写前端了。最近几年，IT 界开始怀旧了，各种远古生物都被挖出来了，可能是现在计算机行业已经没什么可以创新的原因吧。现在说得较多的是人工智障，这个可以用，也可以不用，反正不痛不痒，算不上生产力革命（至少其震动效果比不上当年 Office 问世时对企业生产的影响大）。不过，人工智障在某些辅助领域还是有用的，比如现在有些小区的智能门，应用效果还可以。但是，漏洞也是百出的，总之，人类可以用它来进行辅助，但不能过于依赖它。它不能解决所有问题。

许多科幻小说都会说人类会被机器人消灭。机器人也是人创造出来的，机器不可能比人强，也不可能灭掉人类（除非机器人比奥特曼里面的超兽还牛逼）。如果人类真的智力在衰减，那么根源还是在人类自己。说白了就是，只有可能是人类自己灭掉自己。你也不用觉得太恐怖，其实只要你不要太依赖机器就好，不要失去你的本能和思考方式就行。

就像我们码农，老周也一样，天天跟计算机打交道，但老周一直坚持：用电脑，但不依赖电脑，多做些机器不能做的事。再加一句：科学只能解决数学和工程问题，而人的问题，需要哲学和美学来解决。

=============================================================================

好了，以上的都是 F 话，下面咱们聊正题。今天咱们耍一下 EF Core 中的影子属性。这个词翻译版本 TMD 多，有翻译为“卷影属性”的，现在的文档又改为“阴影属性”，这不好听，太有心理阴影了，故而，老周觉得，叫“影子属性”好一些。

不管叫什么，你只要知道它是个啥就行。老周喜欢一句话总结，所以，来一句话：

模型类中没有定义的，但数据表中存在的属性——即模型类与数据表中没有对应关系的属性。

老周就用一个简单的示例来说明一下吧。这个示例也是老周在视频直播时用的。

假设，有个模型类，叫 Student。

    public class Student
    {
        public int Id { get; set; }
        public string Name { get; set; }
        public int Age { get; set; }
    }

但我想要一个属性，用来记录数据记录被写进数据库的时间，即还有一个属性，叫 InsertTime，不过，这个属性在 Student 类中是没有定义的，但在数据表中是有这一字段的。

因此，在从 DbContext 类派生时，需要重写 OnModelCreating 方法，通过 Model Builder 来定义这个“隐藏”的属性。

        protected override void OnModelCreating(ModelBuilder modelBuilder)
        {
            modelBuilder.Entity<Student>().Property<DateTime>("InsertTime");
        }

这个 InsertTime 属性就成了影子属性了。

下面是 DbContext 派生类的完整代码，我放出来是方便你去抄袭的，放心吧，无版权税的，尽管抄。

    public class MyContext : DbContext
    {
        public DbSet<Student> Students { get; set; }

        protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
        {
            optionsBuilder.UseSqlServer(@"server=(localdb)\MSSQLLocalDB;database=TestDb");
        }

        protected override void OnModelCreating(ModelBuilder modelBuilder)
        {
            modelBuilder.Entity<Student>().Property<DateTime>("InsertTime");
        }
    }

现在，到 Startup 类中，注册一下服务，让自定义的数据库上下文可以进行依赖注入。

        public void ConfigureServices(IServiceCollection services)
        {
            services.AddMvc();
            services.AddDbContext<MyContext>();
        }

刚刚在 MyContext 类中已经配置连接字符串了，所以注册服务时就不用指定连接字符串了。

按老周前面所写的博文，接下来是创建数据迁移，不过，这一次老周使用的是直接在运行的时候创建数据库，方法也是很简单的，找到 Main 入口点，把里面的代码改一下（项目模板默认生成的代码不进行大改）。

        public static void Main(string[] args)
        {
            var host = CreateWebHostBuilder(args).Build();
            using(IServiceScope scope= host.Services.CreateScope())
            {
                MyContext c = scope.ServiceProvider.GetService<MyContext>();
                c.Database.EnsureCreated();
            }
            host.Run();
        }

也就是在 host 运行之前，创建一个“作用域”级别的服务实例，创建数据库，这个实例是临时使用，不遵循服务容器的生命周期规则。EnsureCreated 方法会检测数据库是否存在，如果不存在，就创建，然后返回 true；如果数据库已经存在，不做任何处理并返回 false。

如果你不打算写入一些初始数据，可以不在乎方法的返回值，如果要写入初始数据，可以 if 一下，如果方法返回 true，就写一下数据进去（true 表示新数据库）。

接下来，咱们用一个 API 控制器来测试一下。

    [Route("api/[action]")]
    public class TestController : Controller
    {
        readonly  MyContext context;
        public TestController(MyContext c) => context = c;

        [HttpPost]
        public ActionResult AddNew([FromBody]Student stu)
        {
            ……
        }

        [HttpGet]
        public JArray GetList()
        {
            ……
        }
    }

数据库上下文的实例因为已经注册到服务容器中，所以通过构造函数可以得到其实例引用。这个控制器有两个 action，AddNew 方法用来提交数据，以 POST 方式访问。

        [HttpPost]
        public ActionResult AddNew([FromBody]Student stu)
        {
            // 添加实体
            context.Students.Add(stu);
            // 设置影子属性
            context.Entry(stu).Property<DateTime>("InsertTime").CurrentValue = DateTime.Now;
            context.SaveChanges();
            return Ok("操作成功");
        }

记得，参数要加上 FromBody 特性，因为它要从 HTTP 消息正文中提取，上次我直播时就是忘了写这个，所以提交不到数据。

这里要注意影子属性的赋值方法，因为它没有在 Student 类中公开，你不能通过访问成员来设置它，只能先通过 CurrentValue 属性来设置。

然后还有一个 GetList 方法，以 GET 方式来访问。有来返回所有 Student 数据。此处我用 JArray 以 JSON 数组格式返回。

        [HttpGet]
        public JArray GetList()
        {
            var q = from s in context.Students
                    select new
                    {
                        s.Id,
                        s.Name,
                        s.Age,
                        // 读取影子属性值
                        InsertTime = EF.Property<DateTime>(s, "InsertTime")
                    };
            JArray arr = new JArray();
            foreach (var s in q)
            {
                JObject obj = new JObject();
                obj.Add("id", new JValue(s.Id));
                obj.Add("name", new JValue(s.Name));
                obj.Add("age", new JValue(s.Age));
                obj.Add("add_time", new JValue(s.InsertTime));
                arr.Add(obj);
            }
            return arr;
        }

读取影子属性的方法是用 EF.Property 静态方法，第一个参数是实体模型类的实例，第二个参数是影子属性的名字。这个方法只能在 LINQ 树中使用，如果不在 LINQ 中用会发生异常。这里还有一个问题，就是在 select 子句中用 new 返回的匿名类型无法创建 JObject 对象，所以只好手动去构建。

现在可以测一下了，首先提交一下数据。

{
    "name":"李三跳",
    "age":
}

接着获取一下数据列表。

[
    {
        "id": ,
        "name": "什么鬼",
        "age": ,
        "add_time": "2018-11-26T11:15:38.2012809"
    },
    {
        "id": ,
        "name": "陈大扣",
        "age": ,
        "add_time": "2018-11-26T11:21:07.5374308"
    },
    {
        "id": ,
        "name": "李三跳",
        "age": ,
        "add_time": "2018-11-26T12:41:51.758849"
    }
]

好了，示例就完成了。

影子属性的典型用法就像刚刚这个例子这样，可以用来记录数据的添加时间或者更新时间，但这种数据，一般不需要在实体模型中公开。