怎么在.Net Core WebAPI下給Swagger增加導(dǎo)出離線文檔功能,很多新手對此不是很清楚,為了幫助大家解決這個難題,下面小編將為大家詳細(xì)講解,有這方面需求的人可以來學(xué)習(xí)下,希望你能有所收獲。
站在用戶的角度思考問題,與客戶深入溝通,找到灞橋網(wǎng)站設(shè)計與灞橋網(wǎng)站推廣的解決方案,憑借多年的經(jīng)驗(yàn),讓設(shè)計與互聯(lián)網(wǎng)技術(shù)結(jié)合,創(chuàng)造個性化、用戶體驗(yàn)好的作品,建站類型包括:網(wǎng)站設(shè)計、成都做網(wǎng)站、企業(yè)官網(wǎng)、英文網(wǎng)站、手機(jī)端網(wǎng)站、網(wǎng)站推廣、域名與空間、虛擬空間、企業(yè)郵箱。業(yè)務(wù)覆蓋灞橋地區(qū)。
最近剛接觸到Swagger,在github上下載了它的源碼和demo學(xué)習(xí)了一遍,發(fā)現(xiàn)這個組件非常好用,不過不足的是它沒有導(dǎo)出離線文檔的功能,于是乎我就想給它加一個導(dǎo)出功能
Swagger Github開源地址
其實(shí)說白了api文檔就是一個html靜態(tài)頁面,html可以轉(zhuǎn)word或者pdf,那問題就變簡單了。
1.想辦法拿到swagger生成的api接口json數(shù)據(jù)。
2.將json轉(zhuǎn)化為html。
3.將html轉(zhuǎn)換成word或者pdf等文件。
1.首先我們要解決第一個問題,要給Swagger的頁面上加上導(dǎo)出按鈕,Swagger提供了接口,我們可以用這個接口將js和css注入進(jìn)去執(zhí)行,如圖:


效果如下:

2.拿到swagger生成的文檔數(shù)據(jù),我查閱了swagger github上的的源碼找到了他生成文檔的代碼,如下圖:

2.然后我們使用net core的ioc容器注入把這個對象注入到ioc容器中,以備后續(xù)使用它,如圖:

3.從ioc容器中取出對象使用,將json對象轉(zhuǎn)換為html,在將html轉(zhuǎn)換為需要導(dǎo)出的文件。
如圖:

這里用到了一個RazorEngine ,這是一個微軟封裝的模板引擎,最重要一點(diǎn)它可以脫離mvc使用,可以用它來定制自己的代碼生成器,個人認(rèn)為它比T4好用,吐槽一下,T4的語法看著是真的別扭。。再看RazorEngine語法看著舒服多了。

是不是很熟悉。
最終效果:

看完上述內(nèi)容是否對您有幫助呢?如果還想對相關(guān)知識有進(jìn)一步的了解或閱讀更多相關(guān)文章,請關(guān)注創(chuàng)新互聯(lián)行業(yè)資訊頻道,感謝您對創(chuàng)新互聯(lián)的支持。
網(wǎng)站名稱:怎么在.NetCoreWebAPI下給Swagger增加導(dǎo)出離線文檔功能
鏈接地址:http://chinadenli.net/article46/jhjihg.html
成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián),為您提供關(guān)鍵詞優(yōu)化、網(wǎng)站設(shè)計公司、靜態(tài)網(wǎng)站、網(wǎng)站改版、網(wǎng)站維護(hù)、微信小程序
聲明:本網(wǎng)站發(fā)布的內(nèi)容(圖片、視頻和文字)以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主,如果涉及侵權(quán)請盡快告知,我們將會在第一時間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場,如需處理請聯(lián)系客服。電話:028-86922220;郵箱:631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載,或轉(zhuǎn)載時需注明來源: 創(chuàng)新互聯(lián)