C#凈化版WebApi框架

来源:https://www.cnblogs.com/kiba/archive/2019/03/26/10598626.html
-Advertisement-
Play Games

前言 我們都知道WebApi是依賴於Asp.Net MVC的 ,所以,想創建WebApi,就需要先創建一個Asp.Net MVC項目。 但用Visual Studio創建的MVC項目通常會帶很多功能,而這些功能,很多是我們並不想用的,或者我們想用其他開源控制項代替它。 而這樣雜亂的起始項目,對於我們這 ...


前言

我們都知道WebApi是依賴於Asp.Net MVC的 ,所以,想創建WebApi,就需要先創建一個Asp.Net MVC項目。

但用Visual Studio創建的MVC項目通常會帶很多功能,而這些功能,很多是我們並不想用的,或者我們想用其他開源控制項代替它。

而這樣雜亂的起始項目,對於我們這種有精神潔癖的開發者而言,簡直是折磨。

所以,讓我們編寫一個簡潔版本的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

----------------------------------------------------------------------------------------------------

註:此文章為原創,歡迎轉載,請在文章頁面明顯位置給出此文鏈接!
若您覺得這篇文章還不錯,請點擊下方的推薦】,非常感謝!

 


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 原文地址:http://www.entityframeworktutorial.net/EntityFramework-Architecture.aspx 下麵的圖形,展示了EF的總體架構: 讓我們來分別看看,每個組件都是啥吧: EDM(Entity Data Model)【實體數據模型】:EDM( ...
  • 今年來了新公司,公司沒有用什麼新技術,架構就簡單的前後分離,但是我推一下新的技術,在這基礎上我要培訓一下同事,讓他們能接受,對新技術不感到陌生,並且認可願意去學習。其實在這個過程中也能讓他們認同我這個人吧!老闆是一位曾經在9幾年寫過一段時間代碼的人,對新的技術什麼的不是很瞭解,我提的建議什麼的很難去 ...
  • 最近在做項目的時候遇到一種情:用C#程式以管理員許可權去執行一個bat文件,且此bat文件裡面有cd命令來進入文件的下一級目錄,比如: echo test begin cd test1 setup1.exe cd test2 setup2.exe echo test finished echo off ...
  • 規劃、梳理、構建電子化的流程系統平臺 梳理成企業的行政類、人事類、項目類、財務類。所有的流程都是企業管理制度的電子化表達,通過固化流程系統的構建支撐企業管理控制行落地 建立全新公司統一的工作流管理平臺,採用電子化的流程,突破各種邊界,進行胯部門,跨企業的及時溝通,構造協作的環境。系統支持自定義各種簡 ...
  • 一、背景 1.1 使用場景 一致性哈希演算法一般用於解決分散式系統當中的熱點問題,用於提升分散式系統的可擴展性與健壯性。 1.2 解決的問題 一般用於分散式緩存系統當中的緩存擊穿問題,簡單哈希在服務節點數量產生變化的時候,其緩存命中率很低,從而導致大量介面直接請求資料庫,造成緩存擊穿的情況。 例如我們 ...
  • Visual Studio 2019 發佈活動 2019 年 4 月 2 日,星期二 | 上午 9:00 (PT) 圍觀: https://visualstudio.microsoft.com/zh hans/vs2019 launch/ https://github.com/Microsoft/V ...
  • 上一篇曾說道我從2018年開始創業,是因為機緣巧合之下開發了一款電話機器人程式,我想嘗試能否做好一個小而美的軟體,就索性成立公司去做了。大家對接到許多推銷電話都感到厭煩,所以並不指望這個產品有大的發展,只希望它在適當的場景下能夠發揮一點的作用。在開發和優化這個軟體的過程中遇到了一些比較有意思技術問題 ...
  • C# 將object對象轉換為實體對象.代碼如下: 調用時: 是不是很簡單? ...
一周排行
    -Advertisement-
    Play Games
  • 移動開發(一):使用.NET MAUI開發第一個安卓APP 對於工作多年的C#程式員來說,近來想嘗試開發一款安卓APP,考慮了很久最終選擇使用.NET MAUI這個微軟官方的框架來嘗試體驗開發安卓APP,畢竟是使用Visual Studio開發工具,使用起來也比較的順手,結合微軟官方的教程進行了安卓 ...
  • 前言 QuestPDF 是一個開源 .NET 庫,用於生成 PDF 文檔。使用了C# Fluent API方式可簡化開發、減少錯誤並提高工作效率。利用它可以輕鬆生成 PDF 報告、發票、導出文件等。 項目介紹 QuestPDF 是一個革命性的開源 .NET 庫,它徹底改變了我們生成 PDF 文檔的方 ...
  • 項目地址 項目後端地址: https://github.com/ZyPLJ/ZYTteeHole 項目前端頁面地址: ZyPLJ/TreeHoleVue (github.com) https://github.com/ZyPLJ/TreeHoleVue 目前項目測試訪問地址: http://tree ...
  • 話不多說,直接開乾 一.下載 1.官方鏈接下載: https://www.microsoft.com/zh-cn/sql-server/sql-server-downloads 2.在下載目錄中找到下麵這個小的安裝包 SQL2022-SSEI-Dev.exe,運行開始下載SQL server; 二. ...
  • 前言 隨著物聯網(IoT)技術的迅猛發展,MQTT(消息隊列遙測傳輸)協議憑藉其輕量級和高效性,已成為眾多物聯網應用的首選通信標準。 MQTTnet 作為一個高性能的 .NET 開源庫,為 .NET 平臺上的 MQTT 客戶端與伺服器開發提供了強大的支持。 本文將全面介紹 MQTTnet 的核心功能 ...
  • Serilog支持多種接收器用於日誌存儲,增強器用於添加屬性,LogContext管理動態屬性,支持多種輸出格式包括純文本、JSON及ExpressionTemplate。還提供了自定義格式化選項,適用於不同需求。 ...
  • 目錄簡介獲取 HTML 文檔解析 HTML 文檔測試參考文章 簡介 動態內容網站使用 JavaScript 腳本動態檢索和渲染數據,爬取信息時需要模擬瀏覽器行為,否則獲取到的源碼基本是空的。 本文使用的爬取步驟如下: 使用 Selenium 獲取渲染後的 HTML 文檔 使用 HtmlAgility ...
  • 1.前言 什麼是熱更新 游戲或者軟體更新時,無需重新下載客戶端進行安裝,而是在應用程式啟動的情況下,在內部進行資源或者代碼更新 Unity目前常用熱更新解決方案 HybridCLR,Xlua,ILRuntime等 Unity目前常用資源管理解決方案 AssetBundles,Addressable, ...
  • 本文章主要是在C# ASP.NET Core Web API框架實現向手機發送驗證碼簡訊功能。這裡我選擇是一個互億無線簡訊驗證碼平臺,其實像阿裡雲,騰訊雲上面也可以。 首先我們先去 互億無線 https://www.ihuyi.com/api/sms.html 去註冊一個賬號 註冊完成賬號後,它會送 ...
  • 通過以下方式可以高效,並保證數據同步的可靠性 1.API設計 使用RESTful設計,確保API端點明確,並使用適當的HTTP方法(如POST用於創建,PUT用於更新)。 設計清晰的請求和響應模型,以確保客戶端能夠理解預期格式。 2.數據驗證 在伺服器端進行嚴格的數據驗證,確保接收到的數據符合預期格 ...