ASP.NET Core模块化前后端分离快速开发框架介绍之2、快速创建一个业务模块

NetModular 实现快速开发有两个前提条件：

1、约定优于配置的开发原则

2、代码生成器

约定优于配置是现在到处可见的一种开发原则，比如ASP.NET MVC中的 HttpGet 、 HttpPost 等特性限制请求方式，比如控制器都以 Controller 结尾，比如SpringBoot中各种注解等，都属于约定优于配置，这种开发原则的好处在于可以减少开发人员需要做决定的次数，使开发变得简单、快速，只是这是对于老手来说的，对于新手则提高了学习成本。

基本上每个开源的框架都会有配套的代码生成器，而代码生成器其实就是以约定优于配置为基础的，只有先约定好了项目结构和开发规范，你才能实现一个代码生成器。与其它代码生成器不同， NetModular 的代码生成器不是根据数据库来生成代码，而是提供了一个单独的模块，可以很方便的集成到任何项目当中，通过Web的形式在线配置项目、实体、属性、模型、枚举等内容，然后可以一键生成项目代码并下载。

其实，我的最终目标是希望能够有一个强大的可视化编辑页面，可以灵活配置前端的视图页面以及后端的实体信息，最后直接在线编译并热加载到当前项目中。后端热加载还有点思路，但是前端因为要打包的原因，现在还没想好解决，以后努力~

三、模块的结构

上面说了，代码生成器是依赖与约定的，所以我们先来看下一个模块的项目结构

上图中的Blog目录，就是一个模块的示例，本身就是通过代码生成器生成后放到项目当中的(很多人第一眼看到以为是DDD架构的，其实不是，顶多就是个DDDLite~)，先说一下每层的作用

3、Application：应用服务层、包含所有的业务逻辑

每个实体对应一个目录，目录名称为 实体名称+Service
每个目录下包含有服务接口和实现、视图模型、对象映射配置、模型验证配置等信息

6、WebHost.Electron：客户端主机，用于启动基于 Electron.js 的客户端程序

以上就是 NetModular 框架中一个模块的结构，有了约定，那么接下来就演示一下如何通过代码生成器来创建项目吧。

四、代码生成

1、创建项目

已个人博客为例，项目需要填名称车和编码

2、添加枚举

因为文章有多媒体信息，所以先添加一个多媒体的枚举 MediaType

3、添加实体

添加文章 Article 、分类 Category 、标签 Tag 三个实体

4、配置实体属性

以文章 Article 为例

5、生成

在项目列表中，点击生成按钮生成代码并下载。

6、测试

打开生成的代码，进入 Blog/data 目录，按需创建数据库，因为模块默认依赖 Nm_Admin 模块，所以也要创建 Nm_Admin 的数据库

进入 Blog/src/WebHost/config 目录，打开 db.json 配置数据库连接

回到 Blog/src/WebHost 目录，代开命令行输入以下命令启动服务端

dotnet watch run --environment Development

进入 Blog/src/UI/nm-module-blog 目录，执行以下命令来启动前端代码

npm install

npm update

npm run serve

最后在浏览器中输入 http://localhost:6220 进行浏览

接口文档地址 http://localhost:6220/swagger/index.html

如果没有意外的话，应该可以了~