寫在前面
請原諒我這個標(biāo)題黨,寫到了第100篇隨筆,說是深度優(yōu)化,其實也并沒有什么深度。源碼也沒怎么修改,如果你想使用WebApi Swagger文檔,請先移步到上一篇的中度優(yōu)化。
第一篇:ASP.NET WebApi 文檔Swagger中度優(yōu)化 http://www.cnblogs.com/tdws/p/6100126.html
第二篇:ASP.NET WebApi 文檔Swashbuckle.Core與SwaggerUI深度定制
1.文檔前后端分離
2.項目結(jié)構(gòu)
3.實現(xiàn)分Area(模塊)來篩選所需展示的Controller
文檔前后端分離
本篇文章提供源碼,下載鏈接: https://github.com/coderws/CustomSwagger (由于博客園只能上傳10MB,就放github上吧,不求star,只為了方便大家下載)
由于Swagger原版的swagger頁面和資源js css等文件被嵌入到dll當(dāng)中,雖然我們可以找到swagger UI的源碼,但用起來依然感到有些不便。所以使用了github上另一個開源項目sosoapi,它的文檔功能也是基于swagger的,不過為我們做好了一定得拓展,比如現(xiàn)成的中英切換一類的。并且資源完全與之前的嵌入性資源不同,直接分離出來一個swagger UI的文件夾,包括js,css,images,html等等,這樣的話,我們修改起來很方便呀,可以做到你想要的定制化,并且我將swagger的后臺處理源碼down下來,加到解決方案當(dāng)中,以后遇到問題,再也不用收到dll不能修改和新增功能的困擾??梢詫wagger作為你框架中的一部分。
項目結(jié)構(gòu)
你可以看到Swashbuckle.Core。就是Swagger的后臺源碼,展開Test項目,其中的Doc文件夾,就是全部的SwaggerUI的內(nèi)容啦,index.html就是我們的文檔首頁:
延伸閱讀
- ssh框架 2016-09-30
- 阿里移動安全 [無線安全]玩轉(zhuǎn)無線電——不安全的藍(lán)牙鎖 2017-07-26
- 消息隊列NetMQ 原理分析4-Socket、Session、Option和Pipe 2024-03-26
- Selective Search for Object Recognition 論文筆記【圖片目標(biāo)分割】 2017-07-26
- 詞向量-LRWE模型-更好地識別反義詞同義詞 2017-07-26
- 從棧不平衡問題 理解 calling convention 2017-07-26
- php imagemagick 處理 圖片剪切、壓縮、合并、插入文本、背景色透明 2017-07-26
- Swift實現(xiàn)JSON轉(zhuǎn)Model - HandyJSON使用講解 2017-07-26
- 阿里移動安全 Android端惡意鎖屏勒索應(yīng)用分析 2017-07-26
- 集合結(jié)合數(shù)據(jù)結(jié)構(gòu)來看看(二) 2017-07-26