码迷,mamicode.com
首页 > Windows程序 > 详细

WebAPI实例--第一个API

时间:2018-04-24 19:03:26      阅读:235      评论:0      收藏:0      [点我收藏+]

标签:bsp   user   source   password   set   包含   思路   template   username   

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

WebAPI实例--第一个API

标签:bsp   user   source   password   set   包含   思路   template   username   

原文地址:https://www.cnblogs.com/luffyyang/p/8932471.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!