今天终于做了第一个任务，学习API之后的第一个实例。销售设置开发API。
第一、层次结构
1.API各层
项目结构主要有五层，分别为API、BizModel、Data、DBModel、Logic。
2.各层作用
首先对于微服务架构来说，前后端分离，后端提供数据支撑，前端UI通过API获取数据。
API为controller接收参数，controller层不做任何逻辑处理，只是通过Model接收参数，调用Logic进行逻辑处理。
BizModel为对应前端UI的实体数据模型。我们都知道DBModel是对应数据库字段的实体数据模型，而BizModel对应UI控件。例如：一个User，包含ID、username、password、email等字段，而前端可能控件不只是对应填写User的字段，可能填写此User的同学、家人的信息，则DBModel就无法对应。所以BizModel为前端传递数据，可以对应多个DBModel中的字段。BizModel通过Logic分成DBModel再进行SQL动作。
Data层进行数据库读写动作。
DBModel为实体数据模型。
Logic为逻辑层，对BizModel分离为DBModel，调用Data层执行读写动作。
第二、API构建
1.对应数据表字段构建DBModel
查看需要进行操作的数据表，对应字段写入
public class PreferenceModel
{
public Guid AdminUserKey { get; set; }
public string MsCCode { get; set; }
public int ShippingAddressSource { get; set; }
public bool Audit1 { get; set; }
public bool Audit2 { get; set; }
public int AutoFeedBack { get; set; }
public int eBayMsgSHowlines { get; set; }
public bool DirectSalesAudit1 { get; set; }
public bool DirectSalesAudit2 { get; set; }
public bool NewTemplate { get; set; }
}
2.对应UI传参构建BizModel
public class PreferenceEntity
{
public Guid AdminUserKey { get; set; }
public string MsCCode { get; set; }
public int? ShippingAddressSource { get; set; }
public bool? Audit1 { get; set; }
public bool? Audit2 { get; set; }
public int? AutoFeedBack { get; set; }
public int? eBayMsgSHowlines { get; set; }
public bool? DirectSalesAudit1 { get; set; }
public bool? DirectSalesAudit2 { get; set; }
public bool? NewTemplate { get; set; }
}
3.Data层数据库读写方法
在此不做详细展示，自行处理即可。
4.Logic层处理逻辑，并调用Data层方法进行动作
这里讲一下更新的逻辑，在项目中销售设置分为两个页面，三个更新动作，对应同一个数据表。所以逻辑不是很复杂，但是想要更新不同数据，又不影响其他数据，只用一个API，就要进行一定处理。
原本我的想法是Data层三个方法分别进行更新，在Logic层进行区分，这种方法不是不可以，但是本着精简易维护的原则，只使用一个方法更新，逻辑层进行处理。所以思路是controller接收参数调用Logic，将参数通过Entity传递给Logic，然后在Logic判断如果某一字段的参数并未传递新值，则使用原数据值进行更新。思路正确，下一步实施。
遇到问题int、bool类型字段不能判断非空，所以不知道int型默认的0和bool型默认的false是不是传递过来的值。
解决方法：在BizModel将bool和int定义为bool?和int?，使用隐形，就可以判断变量是否为空，如果不为空，再将参数强制转换，进行数据更新。
5.Controller定义
API只有GET、PUT、POST、DELETE方法，为了规范，Controller命名必须规范。Controller接收参数，调用Logic返回数据。
至此，API的主要构建已完成，接下来Build查看是否有错误，无错误试运行，进入Swagger测试。
测试成功后发布，发布完成使用Postman进行测试。