歡迎大家閱讀《朝夕Net社區(qū)技術(shù)?？返?期

我們致力于.NetCore的推廣和落地，為更好的幫助大家學(xué)習(xí)，方便分享干貨，特創(chuàng)此刊！很高興你能成為首期讀者，文末福利不要錯(cuò)過哦！本文通過3大部分進(jìn)行解讀：

01PARTCoreWebApi教程本地演示環(huán)境：

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

02PART配置Swagger：

詳解1

相信無論是前端還是后端開發(fā)，都或多或少地被接口文檔折磨過。前端經(jīng)常抱怨后端給的接口文檔與實(shí)際情況不一致。后端又覺得編寫及維護(hù)接口文檔會(huì)耗費(fèi)不少精力，經(jīng)常來不及更新。其實(shí)無論是前端調(diào)用后端，還是后端調(diào)用后端，都期望有一個(gè)好的接口文檔。但是這個(gè)接口文檔對于程序員來說，就跟注釋一樣，經(jīng)常會(huì)抱怨別人寫的代碼沒有寫注釋，然而自己寫起代碼起來，最討厭的，也是寫注釋。所以僅僅只通過強(qiáng)制來規(guī)范大家是不夠的，隨著時(shí)間推移，版本迭代，接口文檔往往很容易就跟不上代碼了。發(fā)現(xiàn)了痛點(diǎn)就要去找解決方案。解決方案用的人多了，就成了標(biāo)準(zhǔn)的規(guī)范，這就是Swagger的由來。

詳解2

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

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

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

2.?注冊服務(wù)：

引入swagger中間件

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

Swagger展示；swagger也可以調(diào)試接口；點(diǎn)擊try?it out按鈕即可；

03PART集成log4日志：

在系統(tǒng)開發(fā)中，所謂決不允許讓沒有任何監(jiān)控的系統(tǒng)上線；

log4net是.Net下一個(gè)非常優(yōu)秀的開源日志記錄組件。log4net記錄日志的功能非常強(qiáng)大。它可以將日志分不同的等級(jí)，以不同的格式，輸出到不同的媒介

下面就是集成log4的步驟

1.?nuget引入log4net程序包；當(dāng)前是2.0.8版本；

2.?引入Microsoft.Extensions.Logging.Log4Net.AspNetCore程序包；這個(gè)是個(gè)擴(kuò)展包；在Core里面很多都是擴(kuò)展方法實(shí)現(xiàn)；

3.?使用log4配置文件；可以聯(lián)系助教老師獲取，助教微信：ZhaoxiNet007，也可以直接在log4官網(wǎng)上下載；Xml格式配置文件；

Log4配置文件信息如下：配置文件加入以后，需要把文件屬性設(shè)置為始終復(fù)制

4.?調(diào)用方法使用配置文件使用log4；AddLog4Net方法如果調(diào)用無參數(shù)的，注意文件路徑問題；

5.?在控制器構(gòu)造函數(shù)注入即可使用；

下期預(yù)告

【朝夕Net社區(qū)技術(shù)?？康?期：

WebApi部署多服務(wù)器配置Nginx負(fù)載均衡

本期福利

如果看完本文讓你有所收獲，
別忘轉(zhuǎn)發(fā)擴(kuò)散，和更多人分享學(xué)習(xí)的快樂！
掃碼關(guān)注公眾號(hào)朝夕Net社區(qū)回復(fù)”第二期“
即可獲取本期配套教學(xué)視頻及課件！

《朝夕Net社區(qū)技術(shù)專刊》持續(xù)更新，歡迎掃碼關(guān)注！