Windows下構建ASP.NET Core+Code First+Docker

背景介紹

本文將會示范如何在Windows系統下基於ASP.NET Core構建跨平台服務，並通過Docker容器運行發布。 首先說一下為什么選擇這一套組合： 我本人和我們Code4Thought團隊關注一切具備生產力的技術和工具，話說有所了解才有所選擇，DotNet技術發展趨勢也值得我們關注和支持。基於DotNot Core我們可以構建跨平台服務，結合Entity Framework Core（微軟強大的ORM），MYSQL（免費），Docker（方便移植），Visual Studio 2015（宇宙最強IDE）這一系列技術和工具，不管從商業成本，可移植性，還是生產效率上，都具備很強的誘惑力。

開發環境

•  Windows 10 Professional or Enterprise 64-bit  CPU 開啟虛擬化
•  Docker for Windows 安裝包。https://download.docker.com/win/stable/InstallDocker.msi
•  DotNet Core 開發環境
•  MySQL 數據庫

創建項目

1，創建ASP.NET Core，可以通過.Net Core SDK提供的命令創建，當然在Windows環境下最佳選擇還是宇宙最強IDE：Visual Studio，本文使用2015 Update3 版本：

選擇Web 應用程序，創建成功后，VS會自動執行 dotnet restore 自動還原project.json 中的依賴項，項目結構如下:

介紹幾個變化項：

project.json：類似JAVA世界的Maven，管理了程序的依賴項，包括程序集，工具，配置等。

Program.cs：跟JAVA世界還是很像，程序會找到其中的Main方法做為啟動入口，模板代碼是通過微軟Microsoft.AspNetCore.Hosting 自托管當前Web程序。

Startup.cs:初始化應用程序服務，全局配置，服務注入等。

wwwroot:前端項目文件。

NuGet獲取依賴項

通過Nuget命令行或管理工具，獲取項目所需依賴程序集和工具：

• Microsoft.EntityFrameworkCore
• Microsoft.EntityFrameworkCore.Tools （還需要添加到tools內，后續需要使用Migrations命令）
• SapientGuardian.EntityFrameworkCore.MySql  或者 MySql.Data.EntityFrameworkCore（官方推薦的尚未發布正式版，https://docs.efproject.net/en/latest/providers/index.html）

Get成功之后，project.json如下：

 

Code First嘗試

下面我們使用Entity Framework Core試用Code First模式，結合領域驅動設計，快速構建領域模型，假設建模后的模型包含 “用戶“”和“物品“兩個實體，當然這種開發模式可以充分利用面向對象的設計理念，比如領域模型通過繼承獲取一些系統屬性：BaseEntity

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace WebApplication2.Domain.Model
{
    public class BaseEntity
    {

        public int Id { get; set; }

        public DateTime CreateTime { get; set; }

        public DateTime UpdateTime { get; set; }

    }
}

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace WebApplication2.Domain.Model
{
    public class UserEntity: BaseEntity
    {
    
        public string Name { get; set; }

        public long Age { get; set; }

        //其它屬性...

        public virtual ICollection<ProductEntity> Products { get; set; }


    }
}

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;

namespace WebApplication2.Domain.Model
{
    public class ProductEntity: BaseEntity
    {
        public String Name { get; set; }

        public virtual UserEntity Owner { get; set; }

        //其它屬性...

    }
}

 

構建DbContext：

using System;
using System.Linq;
using Microsoft.EntityFrameworkCore;
using WebApplication2.Domain.Model;

namespace WebApplication2.Domain
{
    public class MyDbContext: DbContext
    {

        public MyDbContext(DbContextOptions<MyDbContext> options)
            : base(options)
        { }
        public DbSet<UserEntity> UserEntity { get; set; }
        public DbSet<ProductEntity> ProductEntity { get; set; }
        //protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder)
        //{
        //}

        /// <summary>
        /// 配置屬性和模型關系等操作
        /// </summary>
        /// <param name="modelBuilder"></param>
        protected override void OnModelCreating(ModelBuilder modelBuilder)
        {
            modelBuilder.Entity<UserEntity>().HasMany(a => a.Products).WithOne(a => a.Owner);

        }

        /// <summary>
        /// 重寫SaveChanges 方法，添加一些自定義操作
        /// </summary>
        /// <returns></returns>
        public override int SaveChanges()
        {
            ChangeTracker.DetectChanges();

            SetSystemProperty();
           
            return base.SaveChanges();
        }

        private void SetSystemProperty()
        {
            //查詢模型添加和變更
            var modifiedSourceInfo = ChangeTracker.Entries()
               .Where(e => e.State == EntityState.Added || e.State == EntityState.Modified).ToList();

            DateTime currentTime = DateTime.Now;

            //設置系統屬性
            foreach (var entry in modifiedSourceInfo)
            {
                entry.Property("CreateTime").CurrentValue = currentTime;
                entry.Property("UpdateTime").CurrentValue = currentTime;
            }
            

        }

    }
}

 

通過Startup.cs 注冊MyDbContext，ASP.NET Core 默認設計了IOC容器管理服務對象

MySqlConnectionString 配置數據庫連接：

編寫業務邏輯實現（本文只是簡單示例所以直接寫到Controller），測試EF Core基本的增刪改查，基本都能用，但還有一些不完善，比如導航屬性還沒有實現。

using System;
using System.Collections.Generic;
using System.Linq;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Mvc;
using Microsoft.EntityFrameworkCore;
using WebApplication2.Domain;
using WebApplication2.Domain.Model;

namespace WebApplication2.Controllers
{
    public class HomeController : Controller
    {
        private MyDbContext _dbContext;
        //注入MyDbContext
        public HomeController(MyDbContext dbContext)
        {
            _dbContext = dbContext;
        }

        public IActionResult Index()
        {
            //查詢用戶
            var checkUser = _dbContext.UserEntity.FirstOrDefault(a => a.Name.Equals("flynn"));

            if (checkUser == null)
            {
                //測試創建用戶
                _dbContext.UserEntity.Add(new UserEntity()
                {
                    Age = 111,
                    Name = "flynn",
                    Products = new List<ProductEntity>() //用戶包含的物品
                    {
                        new ProductEntity()
                        {
                            Name = "prduct Name1",
                        },
                          new ProductEntity()
                        {
                            Name = "prduct Name2",
                        }
                    }
                });
                //持久化模型
                _dbContext.SaveChanges();
            }

            //再次查詢用戶,我們可以看到目前Entity Framework Core尚未支持Lazy Loading. 
            //通過提供Include 和 ThenInclude嵌套獲取導航屬性
            var reCheckUser = _dbContext.UserEntity
                .Include(a=>a.Products)
                .FirstOrDefault(a => a.Name.Equals("flynn"));

          
            var myProduct = reCheckUser.Products.ToList();

            return View();
        }

        public IActionResult About()
        {
            ViewData["Message"] = "Your application description page.";

            return View();
        }

        public IActionResult Contact()
        {
            ViewData["Message"] = "Your contact page.";

        

            return View();
        }

        public IActionResult Error()
        {
            return View();
        }
    }
}

測試跟蹤SQL語句執行過程

到此項目所有代碼已經開發完成，我相信在效率上還是有一定誘惑力，能快速構建和實現中小型項目。

數據遷移

微軟還給我們提供了一套數據遷移方案，打開Nuget 命令行，

執行命令 Add-Migration ，生成數據遷移代碼和歷史文件

執行命令：Update-Database ，更新和創建數據庫（如果數據庫不存在則創建，測試過程中，發現需要先創建一個空數據庫）

查看Mysql數據庫，數據表已經自動生成如下：

 

通過Docker部署

Docker的優勢本人不重復贅述，在Windows 下安裝Docker后，通過Windows Power Shell執行命令：

Docker --version

正常顯示如下：

 

在項目文件目錄，為項目創建Dockerfile，Dockerfile 內寫入Docker鏡像的創建過程和命令，注意Dockerfile不需要包含后綴名，文件內容如下：

 

FROM microsoft/dotnet:latest
COPY . /app
WORKDIR /app

RUN ["dotnet", "restore"]
RUN ["dotnet", "build"]

EXPOSE 5000/tcp
ENV ASPNETCORE_URLS http://*:5000

ENTRYPOINT ["dotnet", "run"]

 

文件邏輯： 獲取微軟提供的DotNet Core程序運行的官方鏡像，可直接運行到Linux，將當前文件夾文件拷貝並設置工作目錄到/app 文件夾，也就是會將剛才項目所有文件拷貝過去。

執行 dotnet 的restore 和 build 命令，最后執行dotnet run 命令啟動程序。

 

創建Docker鏡像，執行命令：

docker build -t test:codefirst .

會首先下載微軟官方鏡像，然后按Dockerfile 進行構建：

 

稍等下載和鏡像構建完成，通過命令運行鏡像：

docker run -d -p 8888:5000 -t test:codefirst

運行成功，可以直接訪問端口8888，訪問Docker運行的服務了。

 

 

結束語

 本文簡單介紹和嘗試了微軟一系列技術的可行性和真實開發效率，試用過程中，能明顯感受到微軟前所未有的開放度，希望大家多多指導，共同分享，共同改變。

 

 作者：Code4Thought 成員 Flynn Shu