ASP.NET API(MVC) 对APP接口(Json格式)接收数据与返回数据的统一管理

话不多说，直接进入主题。

需求：基于Http请求接收Json格式数据，返回Json格式的数据。

整理：对接收的数据与返回数据进行统一的封装整理，方便处理接收与返回数据，并对数据进行验证，通过C#的特性对token进行验证，并通过时间戳的方式统一处理接收与返回的时间格式。

请求Json格式：

{
"Cmd": "login",
"Token": "",
"PageNo": 0,
"OnePageNum": 0,
"Params": {
"UserName": "emrys",
"Pwd":"123456"
}
}

返回Json格式

{
"Cmd": "login",
"Result": 0,
"ResultNote": "Success",
"TotalRecordNum": 0,
"Pages": 0,
"PageNo": 0,
"Detail": {
"UserName": "lining",
"Email":"123456789@qq.com",
"Age":"20"
}
}

关于代码会免费开源，所以不做详讲，下面主要是简单的应用。

一、新建新接口

　　直接新建类名与请求的接口Cmd名称一致，继承BaseAPIService，并在名称后加上APIService，最后实现抽象方法 Process

public override APIResult Process()
{
// 1、获取参数
// 1.1、所有参数均在Request里，Request可以获取封装以后所有的接收数据
string cmd = Reqeust.cmd;
int pageNo = Reqeust.pageNo;
object paramses = Reqeust.Params;

// 1.2、在Params可以获取所有Params里所有的数据
string userName = Convert.ToString(Params["UserName"]);

// 1.3、可以通过方法获取数据
string userName2 = GetParams<string>("UserName");
string pwd = GetParams<string>("Pwd");
int age = GetParams<int>("Age");

// 1.4、通过GetParams的第二个参数，可以设置参数是否是必须传入的参数，默认为必须传入的参数
string userName3 = GetParams<string>("UserName", false); // UserName不是必须需要传入的参数
string userName4 = GetParams<string>("UserName", true); // UserName是必须需要传入的参数

// 1.5、时间格式做了统一的处理 传入格式为long类型的时间戳 如：1466871403000
DateTime time = GetParams<DateTime>("Time");

// 1.6、如传入的参数有很多，通过方法GetParams一个一个获取则比较麻烦，所以如果遇到参数较多的情况下，需要新建一个Class，属性与Params参数一致即可,如LoginRequestModel，通过方法ConvertToModel则可把参数全部封装到类中，方便使用参数。
LoginRequestModel login = ConvertToModel<LoginRequestModel>();

// 1.7、可以在传入参数Class中上和类的属性上标记特性[APIRequired]来标记参数是否是必须的参数。

// 2、设置返回值
// 2.1、 直接设置返回值
//return APIJson(new { name = "emrys" });

// 2.2、 返回String
//return APIContext("xxxxxxxxxxxxxx");

// 2.3、返回对象
//  return APIJson(new LoginRequestModel { });

// 2.4 直接返回需要的对象值
//return new APIResultJson { resultNote = "xxxxxxx" };

return APIJson(new { name = "emrys" });
}

二、设置验证每个请求的权限

如果需要对每个请求做登录的验证，则只需要在Main类中60行继续实现验证的部分代码即可，如果不需要验证的请求则在类上加上特性APINotNeedToken。

　　　　　　if (nt == null || (!nt.NotNeedToken))
{
// 如果需要验证

//  根据token获取用户信息
var user = GetUser(req.token) ;
if (user == null)
{
// 判断Token是否失效
throw new APIException(200, "Token失效。");
}
req.APIWorkContext = new APIWorkContext();
req.APIWorkContext.UserId = Convert.ToInt32(user.user_id);
req.APIWorkContext.UserEmail = user.email;

}

然后可以在每个接口类中的Process方法中获取到UserId，UserEmail等

　　　　　　// 3 获取登录信息
int userId = WorkContext.UserId;

三、实现不同的时间格式

如果需要实现不同的时间格式，如不用时间戳，自定义格式为：yyyy-MM-dd HH:mm:ss，继承类DateTimeConverterBase，并实现ReadJson和WriteJson两个方法。并在返回时设置时间格式。

1、在代码Main中的100行中更改代码

　　　　　　　　 // 设置时间格式
var jsonSettings = new JsonSerializerSettings { NullValueHandling = NullValueHandling.Ignore };
// 设置过滤null值为不显示
jsonSettings.Converters.Add(new UnixDateTimeConverter());UnixDateTimeConverter为自定义时间类型。

return JsonConvert.SerializeObject(res, jsonSettings);

源码地址：https://github.com/Emrys5/Emrys.API