WebAPI实例--第一个API

时间:2022-03-17 23:09:09
WebAPI实例--第一个API

今天终于做了第一个任务,学习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进行测试。