Apworks框架实战（四）：使用Visual Studio开发面向经典分层架构的应用程序：从EasyMemo案例开始

时隔一年，继续我们的Apworks框架之旅。在接下来的文章中，我将逐渐向大家介绍如何在Visual Studio中结合Apworks框架，使用ASP.NET Web API和MVC来开发面向经典分层架构的应用程序。在这一讲中，我们首先了解一下分层架构的各个“层”，以及所涉及的Visual Studio项目，然后，我们从领域模型开始，在Visual Studio中开始我们的应用程序开发之旅。

说明：虽然现在微软已经发布了Visual Studio 2015，但为了照顾广大的老版本用户，本文及后续文章都会以Visual Studio 2013 with Update 4作为开发工具进行介绍。此外，在某些场景中，会需要用到Visual Studio 2013 Ultimate的部分功能，所以，如果您所使用的Visual Studio不是Ultimate版本的话，您将无法动手实践某些案例，但您仍然可以通过阅读文章来获取所需要的知识。

Apworks的近况

已经有一段时间没有向大家介绍Apworks框架的相关内容了，在最近的半年中，我对Apworks做了一些小的重构，具体内容如下：

1. 将支持的.NET Framework升级到4.5.1
2. 开始在IEntity接口上支持泛型ID，这也就意味着在经典分层架构的Apworks应用中，实体键可以开始支持多种原始数据类型了（组合键目前仍不支持），比如整形。这一改动不会对已有的框架产生任何影响，默认的实体键类型仍然是Guid
3. 开始在Unit Of Work的具体实现，也就是RepositoryContext上支持异步Commit的操作：可以使用CommitAsync来进行异步提交。后续版本会支持更多的异步方法
4. 更新所依赖的第三方框架到最新版本（当然，在写这篇文章时，这些第三方框架或许又有了版本更新）
5. 改善了NHibernate Repository的实现
6. 性能优化

您可以直接点击 https://github.com/daxnet/Apworks 进入Apworks框架的开源主页，也可以使用以下命令获取Apworks的源代码：

git clone https://github.com/daxnet/Apworks.git

案例：个人便签应用

我又一次试图从一个应用案例开始向大家介绍整个事情的来龙去脉，希望能够让大家看清楚并了解到问题的本质。我记得之前也有很多文章我也是举了不少例子，有的文章把例子讲解完了，有的又是半途而废，虎头蛇尾。好吧，不管怎么样，没有案例就无法一步步地将问题解释清楚。毕竟理论也是需要跟实践相结合的。

这个案例是一个个人便签应用。刚开始的时候，我把这个小标题称为《案例：一个简单的个人便签应用》，思索之后将“一个简单的”五个字去掉，我想，简单的东西不是大家想要的，简单的东西大家都会做，听起来似乎甚至不需要任何框架和工具的辅助，就能简简单单地把问题解决掉。我想向大家介绍的是一个完整的企业级应用，它不仅应该实现基本的领域逻辑，更应该包含诸如安全、性能等各个方面的内容，所以，综合起来，这事情就简单不了。

认识我的圈内朋友应该都知道我自己开发了一个基于云的个人笔记系统Cloud Notes，也有一些文章介绍Cloud Notes的技术和开发过程。不错，现在我打算使用的这个案例，它的业务背景跟个人笔记系统很像，但为了介绍技术部分，我会让其业务变得更为简单，也会介绍一些实现RESTful服务的最佳实践，因此，该案例会在技术架构层面与Cloud Notes类似，但也会有些细节上的差异。总而言之，尽量以简洁的形式来说明问题。

本案例涉及的部分包括用户和权限，从业务上看，每个用户可以管理自己的便签，内容就这么多。太复杂了会让人觉得头晕目眩，也会降低本文的可读性。OK，让我们给这个案例起个名字，就叫EasyMemo吧。

理论：分层架构与技术选型

在我以前的博客中，少不了对分层架构的介绍，尤其是在介绍领域驱动设计的时候，还介绍了与之异构的基于事件的命令查询职责分离（CQRS）架构。本案例采用经典分层架构进行开发。在此，我觉得还是有必要把架构图再简单画一下，并且标注我们将要使用的微软技术。这样做一方面可以让大家了解到我们使用了哪些技术，另一方面，在后续的介绍中，也可以让大家看到，我们目前是在讨论整个架构的哪个部分。请参见下图：

可以看到，在整个案例的介绍过程中，我们将会使用Entity Framework 6作为数据存储ORM，后台数据库选用Microsoft SQL Server，领域模型层适配Apworks框架，应用层任务协调使用Apworks框架，而通过ASP.NET Web API 2向外界提供RESTful服务。表现层采用ASP.NET MVC 4加上AngularJS实现，当然会用到Twitter Bootstrap的一些特性，毕竟在标准的ASP.NET MVC模板中，默认安装了Bootstrap的包。

基本架构就这样，接下来，让我们一起动手开始在Visual Studio 2013中搭建我们的EasyMemo项目吧。

实践：开始搭建解决方案

打开Visual Studio 2013，当然，目前我们还不需要使用Ultimate版本，因为解决方案的搭建过程不会涉及任何与Visual Studio 2013 Ultimate相关的特性。为了能让解决方案中各项目的组织更为合理，建议首先在Visual Studio 2013中新建一个空白的解决方案，.NET Framework版本请选择4.5.1，因为今后要用的Apworks框架是基于4.5.1的：

单击“确定”按钮后，Visual Studio就会在【解决方案资源管理器】中显示一个空白的解决方案。接下来，我们就相继往该解决方案中创建以下新项目：

• EasyMemo.Common：提供包括公共类型以及基础结构层的那些可以适用于其它各层的类型和组件
• EasyMemo.Domain：包含领域模型的类型，以及这些类型的扩展方法
• EasyMemo.Repositories：仓储实现库，提供与领域模型对象仓储相关的类型定义以及实现
• EasyMemo.Services：一个ASP.NET Web API应用程序，用以向外界提供RESTful服务。在【新建项目】对话中选择【Visual C# –> Web】分类，在该分类中选择【ASP.NET Web应用程序】，在弹出的【新建ASP.NET项目】对话框中，选择【Empty】，在【为以下对象添加文件夹和核心引用】分组中，选择Web API：
  
  
  
• EasyMemo.Web：EasyMemo的主页网站，向用户提供操作界面，接收用户请求，并将请求转发到RESTful服务。在【新建项目】对话中选择【Visual C# –> Web】分类，在该分类中选择【ASP.NET Web应用程序】，在弹出的【新建ASP.NET项目】对话框中，选择【MVC】：
  
  
  

创建完成后，EasyMemo的解决方案中应该包含如下5个项目，每个项目中都只包含了Visual Studio项目模板自带的默认类型：

 

为了能够在编译整个解决方案的时候，让Visual Studio自动下载每个项目所依赖的NuGet包，强烈建议在EasyMemo解决方案上单击鼠标右键，选择【启用NuGet程序包还原】选项：

 

现在，我们就从领域模型的设计开始，一步步地完成整个应用程序的开发。

迈向领域建模的第一步

首先，在EasyMemo.Domain项目上，单击鼠标右键，选择【管理NuGet程序包】，在弹出的对话框的【搜索联机】文本框中，输入关键字【Apworks】，然后在程序包列表中选择【Apworks】并单击【安装】按钮：

在安装时会提示许可协议对话框，单击【我接受】按钮即可。

然后，在EasyMemo.Domain上再新增一个AggregateRoot抽象类，使其实现Apworks中的IAggregateRoot接口：

using System;
using Apworks;

public abstract class AggregateRoot : IAggregateRoot
{
    public Guid ID { get; set; }
}

再新建一个Account类，使其继承AggregateRoot类，它表示在EasyMemo整个应用程序中的“用户账户”的概念，为了今后的实现更为方便快捷，Account类仅提供以下属性：

/// <summary>
/// 表示EasyMemo中“用户账户”的概念
/// </summary>
public class Account : AggregateRoot
{
    /// <summary>
    /// 获取或设置账户名。
    /// </summary>
    public string Name { get; set; }

    /// <summary>
    /// 获取或设置账户密码。
    /// </summary>
    public string Password { get; set; }

    /// <summary>
    /// 获取或设置邮箱地址。
    /// </summary>
    public string Email { get; set; }

    /// <summary>
    /// 获取或设置显示名称。
    /// </summary>
    public string DisplayName { get; set; }

    /// <summary>
    /// 获取或设置账户创建日期。
    /// </summary>
    public DateTime DateCreated { get; set; }

    /// <summary>
    /// 获取或设置最近一次登录日期。
    /// </summary>
    public DateTime? DateLastLogon { get; set; }
}

编译EasyMemo.Domain，编译通过，表示我们已经正常安装并引用Apworks程序包了，可以继续对领域模型进行设计了。在下一讲中，我将介绍EasyMemo领域模型的设计。