【朝夕Net社區技術專刊】Core3.1 WebApi集羣實戰專題-Corre3.1WebApi配置集成日誌/配置Swagger...

歡迎大家閱讀《朝夕Net社區技術專刊》第2期

我們致力於.NetCore的推廣和落地，爲更好的幫助大家學習，方便分享乾貨，特創此刊！很高興你能成爲首期讀者，文末福利不要錯過哦！本文通過3大部分進行解讀：

01

PART

CoreWebApi教程本地演示環境：

Visual Studio2019 --- Vsersion：16.4.4   +  NetCore3.1.2

02

PART

配置Swagger：

詳解1

相信無論是前端還是後端開發，都或多或少地被接口文檔折磨過。前端經常抱怨後端給的接口文檔與實際情況不一致。後端又覺得編寫及維護接口文檔會耗費不少精力，經常來不及更新。其實無論是前端調用後端，還是後端調用後端，都期望有一個好的接口文檔。但是這個接口文檔對於程序員來說，就跟註釋一樣，經常會抱怨別人寫的代碼沒有寫註釋，然而自己寫起代碼起來，最討厭的，也是寫註釋。所以僅僅只通過強制來規範大家是不夠的，隨着時間推移，版本迭代，接口文檔往往很容易就跟不上代碼了。發現了痛點就要去找解決方案。解決方案用的人多了，就成了標準的規範，這就是Swagger的由來。

詳解2

通過這套規範，你只需要按照它的規範去定義接口及接口相關的信息。再通過Swagger衍生出來的一系列項目和工具，就可以做到生成各種格式的接口文檔，生成多種語言的客戶端和服務端的代碼，以及在線接口調試頁面等等。這樣，如果按照新的開發模式，在開發新版本或者迭代版本的時候，只需要更新Swagger描述文件，就可以自動生成接口文檔和客戶端服務端代碼，做到調用端代碼、服務端代碼以及接口文檔的一致性。

下面就來帶大家配置一下swagger

1. nuget 管理安裝程序包：Swashbuckle.AspNetCore，或者Nuget控制檯命令安裝：Install-Package SwashBuckle.AspNetCore -Version 5.0.0-rc4;注意；

2. 註冊服務：

引入swagger中間件

3. 訪問Ip:端口/swagger/index.html

Swagger展示；swagger也可以調試接口；點擊try it out按鈕即可；

03

PART

集成log4日誌：

在系統開發中，所謂決不允許讓沒有任何監控的系統上線；

log4net是.Net下一個非常優秀的開源日誌記錄組件。log4net記錄日誌的功能非常強大。它可以將日誌分不同的等級，以不同的格式，輸出到不同的媒介

下面就是集成log4的步驟

1. nuget引入log4net程序包；當前是2.0.8版本；

2. 引入Microsoft.Extensions.Logging.Log4Net.AspNetCore程序包；這個是個擴展包；在Core裏面很多都是擴展方法實現；

3. 使用log4配置文件；可以聯繫助教老師獲取，助教微信：ZhaoxiNet007，也可以直接在log4官網上下載；Xml格式配置文件；

Log4配置文件信息如下：配置文件加入以後，需要把文件屬性設置爲始終複製；

 4. 調用方法使用配置文件使用log4；AddLog4Net方法如果調用無參數的，注意文件路徑問題；

5. 在控制器構造函數注入即可使用；

下期預告

【朝夕Net社區技術專刊】第3期：

WebApi部署多服務器配置Nginx負載均衡

本期福利

如果看完本文讓你有所收穫，
別忘轉發擴散，和更多人分享學習的快樂！
掃碼關注公衆號朝夕Net社區回覆」第二期「
即可獲取本期配套教學視頻及課件！

《朝夕Net社區技術專刊》持續更新，歡迎掃碼關注！