ABP+AdminLTE+Bootstrap Table權(quán)限管理系統(tǒng)一期
Github:https://github.com/Jimmey-Jiang/ABP-ASP.NET-Boilerplate-Project-CMS
前往博客園總目錄:ABP+AdminLTE+Bootstrap Table權(quán)限管理系統(tǒng)一期
一,控制器AbpController
說完了Swagger ui
我們再來說一下abp對(duì)控制器的處理和json的封裝.
首先我們定義一個(gè)控制器,在新增控制器的時(shí)候,控制器會(huì)自動(dòng)繼承自AbpController
,AbpController
對(duì)ASP.NET MVC Controllers
進(jìn)行了集成.
并且擁有了以前強(qiáng)大的功能.
我們看到AbpController封裝了很多方法,集成了很多東西,繼承自System.Web.Mvc.Controller,abp包含一下功能
1. 本地化
2. 異常處理
3. 對(duì)返回的JsonResult進(jìn)行包裝
4. 審計(jì)日志
5. 權(quán)限認(rèn)證([AbpMvcAuthorize]特性)
6. 工作單元(默認(rèn)未開啟,通過添加[UnitOfWork]開啟)
7. 錯(cuò)誤機(jī)制的響應(yīng).
AbpController定義了L方法簡化本地化插勤。
本地化:你需要設(shè)置LocalizationSourceName
才能使用L**方法沽瘦。你可以在控制器基類SimpleTaskSystemControllerBase里面設(shè)置,就可以在各個(gè)控制器里面調(diào)用了.這樣保證一些公共東西的代碼復(fù)用性.當(dāng)然L方法也可以在視圖地面調(diào)用,這樣在控制js版本等作用還是非常方便的.
同時(shí)在控制器里面也可以注入一些其他公共的東西,如你也可以使用預(yù)注如AbpSession,EventBus
,PermissionManager
,PermissionChecker
,SettingManager
,FeatureManager
,FeatureChecker
,LocalizationManager
,Logger
,CurrentUnitOfWork
基礎(chǔ)屬性等。
異常處理和結(jié)果包裝:
所有的異常都是自動(dòng)處理农尖、記錄并給客戶端返回一個(gè)合適的響應(yīng).如果返回類型時(shí)JsonResult
(或異步actions的Task<JsonResult>
)析恋, ABP會(huì)默認(rèn)包裝action的結(jié)果。你可以通過為controllers或actions或從全局的啟動(dòng)配置使用WrapResult和DontWrapResult特性來改變異常處理和包裝盛卡。
審計(jì)日志:
AbpMvcAuditFilter
用來集成審計(jì)日志系統(tǒng)助隧。它默認(rèn)記錄所有actions的所有請(qǐng)求(如果審計(jì)沒有被禁用)。你可以為actions和controllers使用Audited和DisableAuditing
特性來控制審計(jì)日志滑沧。
驗(yàn)證:
AbpMvcValidationFilter
自動(dòng)檢查ModelState.IsValid
喇颁,如果action沒通過驗(yàn)證則阻止其執(zhí)行.
授權(quán):
你可以給controllers或actions使用AbpMvcAutorize
特性來禁止未授權(quán)的用戶使用你的controllers和actions。如下:
工作單元:
AbpMvcUowFilter
用來集成工作單元系統(tǒng)嚎货。它自動(dòng)在action執(zhí)行前可以使一個(gè)工作單元并在action結(jié)束后完成工作單元(如果沒有異常拋出)。你可以使用UnitOfWork特性來控制action的UOW的行為蔫浆。你也可以使用啟動(dòng)配置來更改所有actions的默認(rèn)工作單元特性殖属。
模型綁定器:
AbpMvcDateTimeBinder
用來格式化DateTime(和Nullable<DateTime>
)輸入,它使用Clock.Normalize方法瓦盛。
二, abp中對(duì)json的封裝
Abp封裝了AbpJsonResult
繼承于JsonResult洗显,其中主要添加了兩個(gè)屬性:CamelCase 駝峰式命名 和Indented 是否縮進(jìn)并在AbpController
中重載了Controller的Json()方法外潜,強(qiáng)制所有返回的Json格式數(shù)據(jù)為AbpJsonResult類型,并提供了AbpJson()的虛方法挠唆。
其中result為代碼中指定返回的數(shù)據(jù)处窥。其他幾個(gè)鍵值對(duì)是ABP封裝的,包含了是否認(rèn)證玄组、是否成功滔驾、錯(cuò)誤信息,以及目標(biāo)Url俄讹。這幾個(gè)參數(shù)是不是很sweet哆致。也可以通過調(diào)用return AbpJson()
來指定參數(shù)進(jìn)行json格式化輸出。
所以開始如果我們直接獲取json字符串的時(shí)候,會(huì)發(fā)現(xiàn)與我們原來的json不一樣.如果在前端框架直接調(diào)用json()方法返回的時(shí)候,返回的不是json而是一個(gè)對(duì)象.當(dāng)不需要abp對(duì)json進(jìn)行封裝包裹怎么辦患膛?只需要在方法上標(biāo)記
[DontWrapResult]
特性標(biāo)簽即可摊阀。在
AbpResultFilter
和
AbpExceptionFilter
過濾器中會(huì)根據(jù)
WrapResultAttribute
、DontWrapResultAttribute
特性進(jìn)行相應(yīng)的過濾踪蹬。
就拿一個(gè)簡單的登錄頁來說,我們看看封裝前和封裝之后的代碼
{success: true, Msg: "登錄成功"}
封裝之后,
{
result: {success: true, msg: "登錄成功"},
"targetUrl": null,
"success": true,
"error": null,
"unAuthorizedRequest": false,
"__abp": true
}
還有就是有時(shí)候在請(qǐng)求JsonResult的時(shí)候時(shí)間的格式是這樣的:"2017-01-23T00:00:00",這種我們需要怎么處理呢?
查看AbpJsonReult
源碼發(fā)現(xiàn)調(diào)用的是Newtonsoft.Json序列化組件中的JsonConvert.SerializeObject(obj, settings);
進(jìn)行序列化胞此。查看Newtonsoft.Json
官網(wǎng)介紹,日期格式化輸出跃捣,需要指定IsoDateTimeConverter
的DateTimeFormat
對(duì)一這種時(shí)間格式我們怎么解決呢?
- 方法一:在服務(wù)器端將日期格式使用Select方法或LINQ表達(dá)式轉(zhuǎn)換后發(fā)到客戶端:
var studentSet =
students.Select
(
p => new { p.Name, Birthday = p.Birthday.ToString("yyyy-mm-dd") }
).ToList();
- 方法二:
在javascript中將"Birthday":"/Date(1391141532000)/"中的字符串轉(zhuǎn)換成javascript中的日期對(duì)象漱牵,可以將Birthday這個(gè)Key所對(duì)應(yīng)的Value中的非數(shù)字字符以替換的方式刪除,到到一個(gè)數(shù)字1391141532000枝缔,然后實(shí)例化一個(gè)Date對(duì)象布疙,將1391141532000毫秒作為參數(shù),得到一個(gè)javascript中的日期對(duì)象.
//在String對(duì)象中擴(kuò)展一個(gè)toDate方法愿卸,可以根據(jù)要求完善
String.prototype.toDate = function () {
var dateMilliseconds;
if (isNaN(this)) {
//使用正則表達(dá)式將日期屬性中的非數(shù)字(\D)刪除
dateMilliseconds =this.replace(/\D/igm, "");
} else {
dateMilliseconds=this;
}
//實(shí)例化一個(gè)新的日期格式灵临,使用1970 年 1 月 1 日至今的毫秒數(shù)為參數(shù)
return new Date(parseInt(dateMilliseconds));
};
-
方法三:
可以選擇一些第三方的json工具類,其中不乏有一些已經(jīng)對(duì)日期格式問題已處理好了的趴荸,常見的json序列化與反序列化工具
1.fastJSON.2.JSON_checker.3.Jayrock.4.Json.NET - LINQ to JSON.5.LitJSON.6.JSON for .NET.7.JsonFx.8.JSONSharp.9.JsonExSerializer.10.fluent-json11.Manatee Json
- 方法四:
其實(shí)MVC中也可以使用handler儒溉,但MVC中有專門針對(duì)服務(wù)器響應(yīng)為JSON的Action
namespace JSONDateMVC.Common
{
using System;
using System.Web;
using System.Web.Mvc;
using Newtonsoft.Json;
using Newtonsoft.Json.Converters;
public class JsonResultPro : JsonResult
{
public JsonResultPro(){}
public JsonResultPro(object data, JsonRequestBehavior behavior)
{
base.Data = data;
base.JsonRequestBehavior = behavior;
this.DateTimeFormat = "yyyy-MM-dd hh:mm:ss";
}
public JsonResultPro(object data, String dateTimeFormat)
{
base.Data = data;
base.JsonRequestBehavior = JsonRequestBehavior.AllowGet;
this.DateTimeFormat = dateTimeFormat;
}
/// <summary>
/// 日期格式
/// </summary>
public string DateTimeFormat{ get; set; }
public override void ExecuteResult(ControllerContext context)
{
if (context == null)
{
throw new ArgumentNullException("context");
}
if ((this.JsonRequestBehavior == JsonRequestBehavior.DenyGet) && string.Equals(context.HttpContext.Request.HttpMethod, "GET", StringComparison.OrdinalIgnoreCase))
{
throw new InvalidOperationException("MvcResources.JsonRequest_GetNotAllowed");
}
HttpResponseBase base2 = context.HttpContext.Response;
if (!string.IsNullOrEmpty(this.ContentType))
{
base2.ContentType = this.ContentType;
}
else
{
base2.ContentType = "application/json";
}
if (this.ContentEncoding != null)
{
base2.ContentEncoding = this.ContentEncoding;
}
if (this.Data != null)
{
//轉(zhuǎn)換System.DateTime的日期格式到 ISO 8601日期格式
//ISO 8601 (如2008-04-12T12:53Z)
IsoDateTimeConverter isoDateTimeConverter=new IsoDateTimeConverter();
//設(shè)置日期格式
isoDateTimeConverter.DateTimeFormat = DateTimeFormat;
//序列化
String jsonResult = JsonConvert.SerializeObject(this.Data,isoDateTimeConverter);
//相應(yīng)結(jié)果
base2.Write(jsonResult);
}
}
}
}
這樣就可以完全按自己的意思來設(shè)置日期格式了,但需要注意日期格式如平時(shí)的Format是有區(qū)別的发钝,如這里表示時(shí)間的H如果大寫表示24小時(shí)制顿涣,如果小寫表示12小時(shí)制。
- 方法五: js格式化
Date.prototype.format =function(format)
{
var o = {
"M+" : this.getMonth()+1, //month
"d+" : this.getDate(), //day
"h+" : this.getHours(), //hour
"m+" : this.getMinutes(), //minute
"s+" : this.getSeconds(), //second
"q+" : Math.floor((this.getMonth()+3)/3), //quarter
"S" : this.getMilliseconds() //millisecond
}
if(/(y+)/.test(format)) format=format.replace(RegExp.$1,
(this.getFullYear()+"").substr(4- RegExp.$1.length));
for(var k in o)if(new RegExp("("+ k +")").test(format))
format = format.replace(RegExp.$1,
RegExp.$1.length==1? o[k] :
("00"+ o[k]).substr((""+ o[k]).length));
return format;
}
以上代碼必須先聲明酝豪,然后在使用涛碑。使用方法:
var d =new Date().format('yyyy-MM-dd');
- 方法六:在Abp的
WepApiModule
(模塊)中指定JsonFormatter
的時(shí)間序列化時(shí)間格式
GlobalConfiguration.Configuration.Formatters.JsonFormatter.SerializerSettings.DateFormatString ="yyyy-MM-dd HH:mm:ss";
還有很多方法,我這里就推薦上面幾種.
返回簡書總目錄:ABP+AdminLTE+Bootstrap Table權(quán)限管理系統(tǒng)一期
前往博客園總目錄:ABP+AdminLTE+Bootstrap Table權(quán)限管理系統(tǒng)一期