前言
我們都知道WebApi是依賴於Asp.Net MVC的HttpRouteCollection進行路由 。
但WebApi和MVC之間是沒有依賴關系的， WebApi的基類ApiController繼承於IHttpController，而MVC的基類Controller 繼承於IController。
WebApi和MVC雖然都使用HttpRouteCollection進行路由，但WebApi經歷的通道是ServicesContainer，而MVC經歷通道還是原始的IHttpModule。
但用Visual Studio創建的MVC WebApi項目通常會帶很多功能，而這些功能，很多是我們並不想用的，或者我們想用其他開源控件代替它。
而直接創建空項目的WebApi又太原始。
所以，讓我們編寫一個簡潔版本的WebApi吧。
凈化版WebApi預覽
首先，我們先看下凈化版WebApi的結構。
如上圖所示，代碼結構很簡單，除開配置文件，整個Web項目只有2個文件；而需要被調用的WebApi都被封裝到了WebApi程序集中了。
接下來我們一起看下編寫這個凈化版WebApi的過程吧。
凈化版WebApi編寫
WebApiConfig
首先，引入必要的Dll，如下圖所示。
然后，我們編寫Web項目的寫WebApiConfig；代碼如下：
public static class WebApiConfig
{
public static void Register(HttpConfiguration config)
{
config.Filters.Add(new WebApiAttribute());
// 解決json序列化時的循環引用問題
config.Formatters.JsonFormatter.SerializerSettings.ReferenceLoopHandling = Newtonsoft.Json.ReferenceLoopHandling.Ignore;
// 對 JSON 數據使用混合大小寫。跟屬性名同樣的大小.輸出
config.Formatters.JsonFormatter.SerializerSettings.ContractResolver = new DefaultContractResolver();
// Web API 路由
config.MapHttpAttributeRoutes();
config.Routes.MapHttpRoute(
name: "DefaultApi",
routeTemplate: "webapi/{controller}/{id}",
defaults: new { id = RouteParameter.Optional }
);
}
}
可以看到WebApiConfig是個靜態類中，我們在其中創建了靜態注冊方法Register，在方法內，我們主要在做一件事，那就是為HttpConfiguration對象做配置。
而在配置中，我們將WepApi的路由配置成了webapi/{controller}/{id}，也就是說，我們的WebApi未來的訪問地址將為【http://localhost:5180/webapi/Login】這樣的模式。
在WebApiConfig類中，我們還用到了這樣一個類WebApiAttribute，我們在為HttpConfiguration對象的Filters屬性，添加了這個類的對象。
通過Filters屬性這個字樣，我們可以得出，這個類主要應用應該是過濾。
下面我們看一下這個類的代碼：
[AttributeUsage(AttributeTargets.Method | AttributeTargets.Class, Inherited = true, AllowMultiple = true)]
public class WebApiAttribute : ActionFilterAttribute
{
public override void OnActionExecuting(HttpActionContext actionContext)
{
//API執行前觸發
if (true)//當前設置，所有API都可以被調用
{
base.OnActionExecuting(actionContext);
}
else
{
throw new Exception("Error");
}
}
public override void OnActionExecuted(HttpActionExecutedContext actionExecutedContext)
{
//API執行后觸發 若發生例外則不在這邊處理
if (actionExecutedContext.Exception != null)
return;
base.OnActionExecuted(actionExecutedContext);
}
}
通過閱讀代碼，我們應該可以發現，這是一個AOP的過濾器。
在執行真正WebApi之前，會先進入這里進行過濾，過濾通過的API，才會調用 base.OnActionExecuting(actionContext)方法進行調用和執行。
結束調用同理，結束調用前，會在該類中進行攔截和過濾處理。
配置文件
WebApiConfig編寫結束了，現在，我們需要將這個靜態類注冊到項目中。
打開Global.asax文件，編寫如下代碼：
protected void Application_Start()
{
GlobalConfiguration.Configure(WebApiConfig.Register);
GlobalConfiguration.Configuration.Formatters.XmlFormatter.SupportedMediaTypes.Clear();//刪除XML格式 回應
}
可以看到，我們已通過Configure方法，將我們編寫好的WebApiConfig添加到了全局配置中了。
因為網站訪問都存在跨域問題，所以我們再向Global.asax中添加如下代碼處理：
protected void Application_BeginRequest(object sender, System.EventArgs e)
{
var req = System.Web.HttpContext.Current.Request;
if (req.HttpMethod == "OPTIONS")//過濾options請求，用於js跨域
{
Response.StatusCode = 200;
Response.SubStatusCode = 200;
Response.End();
}
}
到此Web項目的編寫就完成了，下面我們在WebApi程序集中，編寫個簡單的WebApi，代碼如下：
public class LoginController : BaseApiController
{
public BaseResult Get()
{
try
{
return new BaseResult() { IsSuccess=true };
}
catch (Exception ex)
{
throw ex;
}
}
}
public class BaseApiController : ApiController
{
public string Options()
{
return null;
}
}
然后我們運行網站，進行WebApi訪問。
如上圖所示，我們的WebApi訪問成功。
----------------------------------------------------------------------------------------------------
到此C#凈化版WebApi框架就介紹完了。
框架代碼已經傳到Github上了，歡迎大家下載。
Github地址：https://github.com/kiba518/WebApi
----------------------------------------------------------------------------------------------------
注：此文章為原創，任何形式的轉載都請聯系作者獲得授權並注明出處！
若您覺得這篇文章還不錯，請點擊下方的【推薦】，非常感謝！
