非典那年记忆
- 2020 年 2 月 12 日
- 筆記
ABP core 的框架在过年期间，从1.0突然升级到2.0了，。 整个ABPCore 虽然版本变化 大，但使用流程基本不变吧， 我看官网上文档基本完毕了，官网文档有一个外国人视频，当时版本尚是0.18，总共有2小时吧。记录个学习笔记吧！
课程内容主要步骤记录：
【】所包含的是对应项目名
1、生成项目
abp new ,并编译全部
2、修改连接字符串：
【DbMigrator】修改连接字符串，并执行这个项目，就实现数据库的创建和写入种子数据. 这时可以启用【web】登录网站并修改密码
3、添加实体类，业务实体
【Domain】中添加Book, 继承自审计聚合根 auditedAggregateRoot类。 这个类本身实现了一系统接口
4、添加项目的全局的共有类
【domain.shared】中添加BookType的枚举类型。 它是整个解决方案共用的类型
5、在DBContext中注册实体类
【EFCore】中，DbContext中添加DbSet<Book> books;
DbContextModelCreatingExtensions 中添加表名，表属性，外键关系的配置
6、添加迁移文件
【EFC.DbMigrations】 执行add mirgrate "xxx"
7、添加 BookStoreDataSeedContributor
【Domain】中，添加一个类BookStoreDataSeedContributor ，继承自 IDataSeedContributor, ITransientDependency接口，实现SeedAsync方案
类中注入 Repository<Book,Guid> 和 GuidGenerator类型的两个对象， 借助它们来添加种子数据——三本书的信息Book
8、执行【DbMigrator】，更新数据库
不明白为什么第7步中添加的类会自动被识别，ABP应该有什么自动发现的机理。
9、添加DTO类
【Application.Contracts】添加BookDTO类，继承自AuditedEntityDTO<Guid> 。 所有属性和Book相同。
Contracts是协议合同的意思，表示这个对象是应用层的一个实体，用户交互数据的，所以叫Contracts
10，添加实体和DTO的映射关系
【Application】ApplicationAutoMapperProfile.cs文件中，加一句话： CreateMap(Book,BookDto)
11、创建CreateUpdateBookDTO类
【Application.Contracts】添加CreateUpdateBookDTO类。类不继承其它任何类， 成员变量上添加 DataAnnotation ，数据注解！
这个DTO类竟然没有ID这个字段，更新时到底会是什么个机制呢？？？
12、再添加实体和CreateUpdateBookDTO的映射关系
【Application】 再加一句： CreateMap(CreateUpdateBookDTO，Book)
13、添加第一个IService 接口
【Application.Contracts】 添加 IBookAppService。继承自： ICrudAppService 接口，比较复杂。它包含CRUD的几个方法
注意，视频中，继承的是IAsyncCrudAppService, 但官网示例代码是ICrudAppService。
14、编写IService的实现类
【Application】添加BookAppService的类文件： 构造函数中，注入了Book的仓储对象。
注意，视频中，继承的是AsyncCrudAppService, 但官网示例代码是CrudAppService。
15、浏览自动生成的Swagger 接口，动态JavaScript代理
运行【WEB】项目，浏览 /swagger/index.html ，可以看到通过服务，已经自动生成了相应接口
同时项目生成相应的前端js 代理，可以直接访问API接口
acme.bookStore.book.getList({}).done(function (result) { console.log(result); });
16、 添加Razor 的页面
【web】 添加页面 Pages/Books/index.cshtml ,页面继承了 @inherits Acme.BookStore.Web.Pages.BookStorePage
添加菜单 Menus/ BookStoreMenuContributor.cs 中添加
17、添加国际化的内容
【Domain.shared】中添加对应的键的显示内容!
18、编写一个基于 abp UI的表格
【web】 index.cshtml中，添加一组 <abp-*>的标签来写页面，tag-helpers简化页面
js文件中，用DataTable.js插件来生成表格。 第三方的表格插件已经内置，且abp写了许多辅助的东西来适配第三方的插件
abp.libs.datatables.createAjax是帮助ABP的动态JavaScript API代理跟Datatable的格式相适应的辅助方法.
