Asp.netCore RESTful WebApi 小结

上篇文章记录了WebApi的概念以及简单的认知WebApi ，今天来探究下它的适用场景以及怎么去用它。

　　先简单聊一下WebApi与用得比较多的WCF、WebService各自的特点：

　　一、WebService是一种可以接收从Internet或者Intranet上的其它系统中传递过来的请求，轻量级的独立的通讯技术，它的特点有：

  　　1、基于SOAP协议的，数据格式是XML；

 　　 2、web Service 最大的优势便是跨平台的可互操作性；

　　  3、支持Http协议Xml技术的设备即可拥有并且访问web Service，但只能部署在IIS上 ；

　　  4、一些只需要与本机上的其余程序通讯的应用程序则不适合用web Service，理由并非技术上无法实现，而是消耗过大没有任何好处。

　　二、WCF是提供统一的，可用于建立安全、可靠的面向服务的应用的高效开发平台，其特点有：

　　  1、基于SOAP协议的，数据格式是XML；

　　  2、可以支持各种各样的协议,比如TCP，HTTP，HTTPS，Json等；

　　  3、与其前辈web Service相比，WCF不仅可以部署在IIS上还可以部署在应用程序中或者Windows服务中；

　　  4、只要支持标准的web service,可以跨进程、跨机器甚至于跨平台的通信。

　　三、WebApi的特点：

　　  1、需要通过URI信息来指定端点，每一个URI代表1种资源；

　　  2、可通过不同的http动作表达不同的含义,客户端使用GET、POST、PUT、DELETE4个表示操作方式的动词对服务端资源进行操作：GET用来获取资源，POST用来新建资源（也可以用于更新资源），PUT用来更新资源，DELETE用来删除资源；

　　  3、通过请求来实现对资源的资源，资源的表现形式大多是XML或者HTML（亦或其它），请求的回复通过Http Status Code表达不同含义，并且客户端可以通过Accept header来与服务器协商格式，例如希望服务器返回JSON格式还是XML格式亦或者其他扩展格式；

　　  4、支持跨平台、CORS跨域调用WebApi,如通过前端js或者直接在后台调用它，部署时支持Self-host或者IIS。；

　　  5、客户端与服务端之间的交互在请求之间是无状态的，从客户端到服务端的每个请求都必须包含理解请求所必需的信息。

　　聊完它们的特点，那么如何物尽其用呢？(参考链接：https://blog.csdn.net/u013043518/java/article/details/51793294)

　　  1、当你想创建一个支持消息、消息队列、双工通信的服务时，你应该选择WCF

　　  2、当你想创建一个服务，可以用更快速的传输通道时，像TCP、NamedPipes或者甚至是UDP（在WCF4.5中）,在其他传输通道不可用的时候也可以支持HTTP。

　　  3、当你想创建一个基于HTTP的面向资源的服务并且可以使用HTTP的全部特征时（比如URIs、request/response头，缓存，版本控制，多种内容格式），你应该选择WebAPI

　　  4、当你想让你的服务用于浏览器、手机、iPhone和平板电脑时，你应该选择Web API

　  前面在聊WebApi特点的时候有提到可以通过前端或者在后台去调用它，看下具体如何调用：

　　  例1： 通过HttpClient类调Api。在Web API发布的同时，.NET提供了两个程序集：System.Net.Http和System.Net.Http.Formatting。这两个程序集中最核心的类是HttpClient (在这里只讨论如何调WebApi，思路为打磨一个通用的工具类，其余部分各位看官自由发挥)：

public class CallAPI
{
private static string uri = "http://localhost:5000/";
private HttpClient client = new HttpClient();

/// <summary>
/// 简单查询
/// </summary>
/// <param name="resource">目标资源</param>
public void GetData(string resource)
{
　　client.BaseAddress = new Uri(uri);

　　// 为JSON格式添加一个Accept报头
　　client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
　　HttpResponseMessage responseMessage = client.GetAsync(resource).Result;//获取查询结果
　　if (responseMessage.IsSuccessStatusCode)
　　{
　　　　var ds = responseMessage.Content.ReadAsStringAsync().Result;
　　　　string content = JsonConvert.SerializeObject(ds, Newtonsoft.Json.Formatting.Indented);//转换为你想要的格式如xml,json等，定义通用的转换类这里就不介绍了，请自行打造
　　}
}

/// <summary>
/// 带参查询
/// </summary>
/// <param name="resource">目标资源</param>
/// <param name="id">ID</param>
public void GetDataWithParam(string resource)
{
　　client.BaseAddress = new Uri(uri);

　　client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
　　HttpResponseMessage responseMessage = client.GetAsync(resource).Result;
　　if (responseMessage.IsSuccessStatusCode)
　　{
　　　　var ds = responseMessage.Content.ReadAsStringAsync().Result;
　　　　string content = JsonConvert.SerializeObject(ds, Newtonsoft.Json.Formatting.Indented);
　　}

}


/// <summary>
/// put请求更新资源
/// </summary>
/// <param name="resource"></param>
/// <returns></returns>
public bool PutData(string resource)
{
　　bool bol = false;
　　//创建和webapi对应的类
　　var content = new FormUrlEncodedContent(new Dictionary<string, string>()
　　{
　　　　{"ID","382accff-57b2-4d6e-ae84-a61e00a3e3b5"},
　　　　{"Name","Name" },
　　　　{"QZH","111"}
　　});
　　HttpResponseMessage response = client.GetAsync(resource).Result;
　　response = client.PostAsync(resource, content).Result;
　　if (response.IsSuccessStatusCode)
　　{
　　　　bol = true;
　　　　var result = response.Content.ReadAsStringAsync().Result;
　　}
　　return bol;
}

}

  　   例2：基于mvc+dotnet core WebApi，通过前端ajax来调用，下面直接贴几段不同调用类型的代码（由于Put 请求与Post请求类似就不再举例贴代码）：

　　  片段1：基础类型作为参数

　前端ajax代码：
$.ajax({
type: "get",
url: "http://localhost:27221/api/Charging/GetAllChargingData",
data: { id: 1, name: "Jim", bir: "1988-09-11"},
success: function (data, status) {
if (status == "success") {
$("#div_test").html(data);
}
}
});
Controller层代码：
[HttpGet]
public string GetAllChargingData(interestingid，string name, DateTime bir)
{return "ChargingData" + id;}

　　  片段2：实体类型作为参数

前端ajax代码：　
　$.ajax({
type: "get",
url: "http://localhost:27221/api/Charging/GetByModel",
contentType: "application/json",
data: { strQuery: JSON.stringify({ ID: "1", NAME: "Jim", CREATETIME: "1988-09-11" }) },
success: function (data, status) {
if (status == "success") {
$("#div_test").html(data);
}
}
});
Controller层代码一（先序列化，再在后台反序列的方式）：
[HttpGet]
public string GetByModel(string strQuery)
{
TB_CHARGING oData=Newtonsoft.Json.JsonConvert.DeserializeObject<TB_CHARGING>(strQuery));
return "Charging" + oData.ID;
}
Controller层代码二（在参数里面加上[FromUri]）：
[HttpGet]
[HttpGet]
public string GetAllChargingData([FromUri]TB_CHARGING obj)
{
return "ChargingData" + obj.ID;
}

　　  片段3：单个实体作为参数：（post请求默认是将表单里面的数据的key/value形式发送到服务，而我们的服务器只需要有对应的key/value属性值的对象就可以接收到。而如果使用application/json，则表示将前端的数据以序列化过的json传递到后端，后端要把它变成实体对象，还需要反序列化的过程）

方法一： （使用post请求的默认参数类型，前端直接传递json类型的对象）
前端ajax代码：
$.ajax({
type: "post",
url: "http://localhost:27221/api/Charging/SaveData",
data: { ID: "1", NAME: "Jim", CREATETIME: "1988-09-11" },
success: function (data, status) {}
});
方法二：（指定了contentType为application/json，需序列化待传递的对象）
前端ajax代码：
var postdata = { ID: "1", NAME: "Jim", CREATETIME: "1988-09-11" };
$.ajax({
type: "post",
url: "http://localhost:27221/api/Charging/SaveData",
contentType: 'application/json',
data: JSON.stringify(postdata),
success: function (data, status) {}
});
Controller层代码：
[HttpPost]
public bool SaveData(TB_CHARGING oData)
{
return true;
}

　　  片段4：实体和基础类型一起作为参数传递

前端ajax代码：
var postdata = { ID: "1", NAME: "Jim", CREATETIME: "1988-09-11" };
$.ajax({
type: "post",
url: "http://localhost:27221/api/Charging/SaveData",
contentType: 'application/json',
data: JSON.stringify({ NAME:"Lilei", Charging:postdata }),
success: function (data, status) {}
});
Controller层代码：
[HttpPost]
public object SaveData(dynamic obj)
{
var strName = Convert.ToString(obj.NAME);
var oCharging = Newtonsoft.Json.JsonConvert.DeserializeObject<TB_CHARGING>(Convert.ToString(obj.Charging));
return strName;
}

　　  片段5：基础类型数组作为参数传递

前端ajax代码：
    var arr = ["1", "2", "3", "4"];
    $.ajax({
        type: "post",
        url: "http://localhost:27221/api/Charging/SaveData",
        contentType: 'application/json',
        data: JSON.stringify(arr),
        success: function (data, status) { }
    });
Controller层代码：
        [HttpPost]
        public bool SaveData(string[] ids)
        {
            return true;
        }

　　  片段6：简单贴个Delete请求

    var arr = [
        { ID: "1", NAME: "Jim", CREATETIME: "1988-09-11" },
        { ID: "2", NAME: "Lilei", CREATETIME: "1990-12-11" },
        { ID: "3", NAME: "Lucy", CREATETIME: "1986-01-10" }
    ];
    $.ajax({
        type: "delete",
        url: "http://localhost:27221/api/Charging/OptDelete",
        contentType: 'application/json',
        data: JSON.stringify(arr),
        success: function (data, status) {}
    });
Controller层：
        [HttpDelete]
        public bool OptDelete(List<TB_CHARGING> lstChargin)
        {
            return true;
        }

　　总结：记录下个人的学习Asp.netCore RESTful WebApi的过程，不对之处欢迎指正。另：对于Controller层WebApi返回值的梳理建议参考官网文档（https://docs.microsoft.com/zh-cn/aspnet/core/web-api/action-return-types?view=aspnetcore-3.1）