maven依賴自動配置

額,看了前面第一種配置方式,是不是感覺有點麻煩呢?我也覺得,到時候去掉的時候,還需要進行刪除配置啊,一大堆,還有可能到時候根本不知道.
所以,我決定自己寫個讓它自己就可以完成配置的東東,嗯,說干就干

這里我就不一一講解了,具體的源碼我已上傳碼云.碼云地址maven自動配置地址

1. 在pom.xml 添加maven依賴

這里需要說明一下,因為我還沒有上傳中央存儲庫,所以,直接依賴是找不到的,所以,你就下載下來,地址是(https://gitee.com/xiangyue520/swagger2), 然后進入我的這個項目根目錄mvn clean install 一下,輸入下面這個依賴就可以了

<dependency>
    <groupId>com.wanggan</groupId>
    <artifactId>swagger-spring-boot-starter</artifactId>
    <version>1.0.0</version>
</dependency>

2. 配置

在這里我給大家提供了很多自由化的配置了,當然你也可以不用配置,因為所有的選項都是可選的

注意:如果你要進行自定義配置的話,需要默認加上前綴:swagger.來配置屬性,給個demo吧,配置的地方是application.properties或者application.yml,參數那么多,我就不一個個來了哈,可以自己配置來看看效果,其實,我都沒配置完過,哈哈,要是有問題的話,請大家及時指出,以便即時更正.

swagger.title = Swagger API Demo
swagger.description = This is swagger api describle demo
swagger.version = 1.1.1

配置參數

• title(可選) 接口的標題,具體就不多說了吧,可以自己試著玩,默認是Swagger Restful API

• description(可選) 接口的描述,默認是This is a swagger api desc

• version(可選) 接口的版本,默認是1.0.0

• groupName(可選) 接口所屬的組,默認沒有,當然,你可以自己寫下試試

• basePackage(可選) 掃描的包路徑,默認沒有,掃描下面的所有的@Controller和@RequestMapping的映射

• termsOfService(可選) 服務條款的地址,默認沒有

• contactName(可選) 聯系人,默認沒有

• contactUrl(可選) 聯系的url,默認沒有

• contactEmail(可選) 聯系的email,默認沒有

• licenseName(可選) 證書名,默認沒有

• licenseUrl(可選) 證書的url,默認沒有

3. 啟動和使用
   啟動的話,和前面沒什么區別,使用也是和前面的那種方法是一樣的,打開瀏覽器訪問 http://localhost:端口號/swagger-ui.html

4. 移除依賴

   額,這個嘛,看你項目使用profile沒有,如果有的話,就一般放在dev里面,還是一樣來個demo吧

<profiles>
    <profile>
        <id>dev</id>
        <dependencies>
            <dependency>
                <groupId>com.wanggan</groupId>
                <artifactId>swagger-spring-boot-starter</artifactId>
                <version>1.0.0</version>
            </dependency>
        </dependencies>
    </profile>
</profiles>

或者直接就放在整個pom.xml的依賴里面也行,但是一般為了減少依賴包的大小,推薦上面那種啦,這個整體的依賴就不用給demo了吧?相信你一定會的.

刪除的話,就把上面這個依賴選中,刪除就搞定了,要是你想以后用呢,選擇注釋掉也可以,看你怎么開心怎么弄.

5. 后續

經歷了上面的一波操作,如果還是有問題的話,就請聯系我吧,嘿嘿,不是經常看,所以可能回復的比較慢,不過,應該不會遇到什么問題的,一般的問題的話,百度一下,你就知道啦.

如果你想再看看前面的自己配置的話,給個友情鏈接吧,Spring boot+Swagger配置無侵入式Restful接口(一)