NET Core & Entity Framework Core

ABP 教程文档 1-1 手把手引进门之 ASP.NET Core & Entity Framework Core（官方教程翻译版 版本3.2.5）

本文是ABP官方文档翻译版，翻译基于 3.2.5 版本

官方文档分四部分

一、 教程文档

二、ABP 框架

三、zero 模块

四、其他（中文翻译资源）

本篇是第一部分的第一篇。

第一部分分三篇

1-1 手把手引进门

1-2 进阶

1-3 杂项 （相关理论知识）

第一篇含两个步骤。

1-1-1 ASP.NET Core & Entity Framework Core 后端（内核）含两篇 （第二篇链接）

1-1-2 ASP.NET MVC, Web API, EntityFramework & AngularJs 前端

现在进入正文

使用 ASP.NET Core, Entity Framework Core 和 ASP.NET Boilerplate 创建N层Web应用

土牛语录：Halil ibrahim Kalkan, 30 Jul 2017

以下是手把手引进门教程，基于 ASP.NET Core， Entity Framework Core ，ABP 框架 创建Web 应用， PS： 自带自动的测试模块哦。

样例下载 （上 github 的请自便）

本文目录如下：

介绍

　　前期准备

创建应用

正式开发

　　创建任务实体 Entity

　　将任务添加到数据库上下文 DbContext

　　创建第一个数据迁移

　　创建数据库

　　编写任务服务

　　测试任务服务

　　任务列表展示

　　　　添加菜单

　　　　创建任务 Controller 和 视图模型

　　　　任务列表页面

　　　　本地化

　　　　任务过滤

　　　　任务列表页面的自动化测试

其他相关内容

文章修改历史

版权所有

介绍

这是系列文章的第一部分：使用 ASP.NET Core, Entity Framework Core 和 ASP.NET Boilerplate 创建N层Web应用

在本文中，我将指导大家创建一个样例（跨平台的多层Web应用），该样例会用到如下工具（请读者提前准备）：

Net Core 跨平台应用的基础开发框架

ASP.NET Boilerplate (ABP) 开发的基础框架模板

ASP.NET Core web开发框架

Entity Framework Core ORM 数据框架

Twitter Bootstrap HTML&CSS 前端开发框架

jQuery 客户端 AJAX/DOM 类库

xUnit 和 Shouldly 服务端测试工具（单元测试/集成测试）

ABP 框架中会默认使用 Log4Net 和 AutoMapper 。

我们同时还会使用以下技术：

Layered Architecture 分层架构

Domain Driven Design (DDD) DDD领域模型

Dependency injection (DI) DI 依赖注入

Integration Testing 集成测试

演示的开发项目是一个简单的任务管理应用，用于将任务分配出去。我不会一层一层的进行开发，而是随着应用的拓展直接切换所需的层次。随着应用的推拓展，我将会介绍所需的ABP和其他框架的特性。

前期准备

开发样例时需要以下工具，请提前在你的机器上进行安装：

Visual Studio 2017

SQL Server (你可以更改连接字符串为 localdb)

Visual Studio Extensions:

Bundler & Minifier

Web Compiler

创建应用

首先使用ABP模版（http://www.aspnetboilerplate.com/Templates）创建一个web应用项目，命名为"Acme.SimpleTaskApp" 。创建模板时可以设置自己的公司名称（比如Acme）。

本样例使用MPA（Multi Page Web Application）多页面模式（注：即使用MVC和Razor技术）进行开发，本文不使用SPA（注：土牛的SPA是使用Angular）单页面模式。同时为了使用最基础的开发模板功能，本文不使用Module Zero模块。

View Code

Task 实体从 ABP 的 Entity 基类继承，Entity 基类默认ID属性是 int 类型。如果主键类型为非 int 类型，也可以选择范型版本的 Entity<TPrimaryKey>.

IHasCreationTime 是一个简单的接口，只定义了 CreationTime 属性 （统一规范 CreationTime 的名字）

Task 实体定义了一个必填的 Title 和 非必填的 Description

TaskState 是一个简单枚举，定义了 Task 任务的状态

Clock.Now 返回默认的 DateTime.Now 。但它提供了一个抽象方法，使得我们可以在将来有需要的时候很轻松就可以转换为 DateTime.UtcNow 。在 ABP 框架中总是使用Clock.Now 而不使用 DateTime.Now 。

将 Task 实体存储到数据库的 AppTasks 表中。

将任务添加到数据库上下文 DbContext

.EntityFrameworkCore 包含一个预定义的 [b]DbContext 。将 Task 实体的 DbSet 加到 [b][b]DbContext 里。[/b][/b][/b]

代码如下：

View Code

现在，EF core 知道我们有了一个 Task 的实体。

创建第一个数据迁移

我们将创建一个初始化数据库迁移文件，它会自动创建数据库和数据库表 AppTasks 。打开源管理器 Package Manager Console from Visual Studio , 执行 Add-Migration 命令（默认的项目必须是 .EntityFrameworkCore 项目），如图：

View Code
当我们执行数据库迁移命令时，这些代码会创建 AppTasks 表 （更多迁移相关信息请参照 entity framework documentation ）

[b]创建数据库

以上的迁移执行完毕后（注：Add-Migration 命令执行后），在包管理控制台中执行 Update-Database 命令，如下图：

View Code

我们推荐先定义接口，但不是非这样做不可。按照惯例，ABP 中所有的应用服务都需要实现 IApplicationService 接口 （它只是一个空的标记接口）。我们创建了一个 GetAll 方法去查询任务列表，同时，我们定义了如下的 DTOs ：

代码如下：

View Code

GetAllTasksInput DTO 为 GetAll 应用服务方法定义了一个输入参数 。 我们将 状态 state 定义为 DTO 对象 而不定义为方法的参数。 这样我们将来需要的时候可以在这个DTO增加其他的参数，同时兼容现有的客户端 （当然我们也可以在方法里加一个 state 参数）。

TaskListDto 用开返回任务数据。该Dto 从 EntityDto 继承，EntityDto 只是定义了 Id 属性（我们可以不继承 EntityDto ，直接自己将 Id 加到我们的Dto里）。我们定义了[AutoMapFrom] 特性来创建 AutoMapper 自动映射任务实体到任务列表Dto TaskListDto 。这个特性在 Abp.AutoMapper nuget 包里进行了定义。

ListResultDto 是一个简单的类，包含了一个列表（我们可以直接返回一个 List<TaskListDto> 列表）。

现在，我们可以实现 ITaskAppService 了。

代码如下：

View Code

TaskAppService 该类从 SimpleTaskAppAppServiceBase 继承，SimpleTaskAppAppServiceBase （从 ABP 的 ApplicationService 类继承）在模板里已经自动生成。 TaskAppService 不是必须从 SimpleTaskAppAppServiceBase 继承，应用服务可以是普通类。但是 ApplicationService 基类有一些预先注入的服务（就像这里使用的 ObjectMapper ）

我们使用依赖注入 dependency injection 来获取数据仓储 repository

Repositories 数据仓储用于为数据实体抽象数据库操作。ABP 为每个实体创建了预定义的数据库仓储（就像这里用到了 IRepository<Task> ）用于实现通用的任务。IRepository.GetAll() 方法用于查询数据实体，它返回了一个 IQueryable 接口。

WhereIf 这是 ABP 里的一个拓展方法，该方法提供了一个 IQueryable.Where 方法的简便条件语法。

ObjectMapper 用于将任务对象列表映射到任务列表Dto对象列表 （基于 Application Service 基类并默认实现 AutoMapper ）

测试任务服务

在创建用户接口钱，我们需要测试一下任务应用服务 TaskAppService 。 如果你对自动化测试不感兴趣的话，可以忽略这个部分。

我们的模板包含 .Tests 项目，这可以测试我们的代码。这个项目不使用 SQL Server数据库，而是使用EF core 的内存数据库。所以，我们可以不用真实数据库来进行单元测试。它为每个测试创建了单独的数据库。所以每个测试都是隔离的。我们需要在开始测试前使用 TestDataBuilder 类添加初始测试数据到内存数据库里。我修改了 TestDataBuilder 。

代码如下：

View Code
通过样例项目的源代码，你可以看懂 TestDataBuilder 在哪里用，具体怎么用。我们添加2个任务（其中一个已经完成）到数据库上下文 dbcontext 。我们可以假定数据库中有2个任务，开始编写测试用例。 第一个继承测试用来测试 TaskAppService.GetAll 方法。

代码如下：

View Code
我们创建2个不同的测试用例来测试 GetAll 方法。现在，我们打开测试浏览器（在VS主菜单的 Test\Windows\Test Explorer 菜单下）开始进行单元测试。

View Code
模板自带两个页面：首页和关于页，如上代码所示。我们也可以修改它们创建新的页面。但现在我们不修改首页和关于页，我们创建新的菜单项。

创建任务 Controller 和 视图模型

我们在 .Web 项目下创建一个新的 controller 类，命名为 TasksController 。

代码如下

View Code

TasksController 从 SimpleTaskAppControllerBase （ SimpleTaskAppControllerBase 从 AbpController 继承）继承，该类包含应用程序 Controllers 需要的通用基础代码。

我们反射了 ITaskAppService ， 以获取到所有的任务列表。

我们在 .Web 项目中创建了一个 IndexViewModel 类来将数据展示到视图上，这样可以不直接将 GetAll 方法的结果直接暴露到视图上。

代码如下

View Code
我们创建了一个简单的视图模型，在它的构造函数中，我们获取了一个任务列表（由 ITaskAppService 提供）。同时它还有一个 GetTaskLabel 方法，用于在视图中通过一个 选择 Bootstrap 标签来标示任务。

任务列表页面

最后，完成实际的 Index 视图。

代码如下

View Code
我们使用 Bootstrap 的 list group 组件和定义好的模型来渲染视图。我们使用 IndexViewModel.GetTaskLable() 方法来获得任务的标签类型。渲染后的界面如下图：

View Code
模板自带了大多数的文本，当然，它们可以删除掉。在上面的代码中我只是加了最后的三行。使用 ABP 的本地化是相当的简单，如果你想了解本地化系统更多的信息，请查阅文档 localization document

任务过滤

正如之前说过的，TaskController 实际上使用的是 GetAllTasksInput ，可以灵活的过滤任务。我们可以添加一个任务列表的下拉菜单来过滤任务。首先，我们添加一个下拉菜单到视图上（我们加到 header 里）：

代码如下

View Code
然后我修改了 IndexViewModel ， 增加了 SeletedTaskState 属性和 GetTaskStateSelectListItems 方法：

代码如下

View Code
我们也可以在 controller 里设置 SelectedTaskState ：

代码如下

View Code
现在，我们运行程序，可以看到视图的右上角有个下拉框，如图：

View Code
我们首先添加 [b]Bundler & Minifier 扩展程序（这是 ASP.NET Core 项目标配的压缩文件）来压缩脚本的大小， 然后开始在视图里编写 javascript ：

View Code
同时创建了 script 的压缩版本

View Code
至此，我们的视图将在开发环境下使用 index.js 包，而在生产环境中使用 index.min.js （压缩版本）包。这是在 ASP.Net Core MVC 项目中通用的做法。

任务列表页面的自动化测试

ASP.NET Core MVC 基础框架中集成了一个继承测试模块。我们可以完整的测试我们的服务端代码了。如果你对自动化测试不感兴趣的话，你可以忽略这个部分。

ABP 模板中自带 .Web.Tests 项目。我们创建一个普通的测试来请求 TaskController.Index ， 然后检查反馈内容：

代码如下

View Code
GetResponseAsStringAsync 和 GetUrl 是 ABP 的 AbpAspNetCoreIntrgratedTestBase 类中很有用的方法。使用这些快捷方法我们可以比较容易的创建请求，如果直接使用客户端请求（一个 HttpClient 的实例）会相对复杂一些。如果想深入了解，请参考 ASP.NET Core 的 integration testing documentation

当我们开始 debug 测试模块式，我们可以看到反馈的 HTML 如下图

View Code
你可以深入检查 HTML 的更多细节。但一般来说，检查基本的标签就够了。

其他相关内容

第二篇 Second article 接着开发这个应用服务。

（第二篇翻译链接）

文章修改历史

2017-07-30: 将文章中的 ListResultOutput 替换为 ListResultDto

2017-06-02: 将文章和解决方案修改为支持 .net core

2016-08-08: 添加 第二篇 的链接

2016-08-01: 第一次发布

版权所有

该文章和其中的任何源代码和文件的版权均归 The Code Project Open License (CPOL) 所有