springmvc+swagger2

筆者最近拿springmvc4.x+swagger 2.8(最新版本)集成過(guò)程中碰到一些問(wèn)題,現(xiàn)在分享一下

1谭确、引入的包
swagger2 的包 maven倉(cāng)庫(kù)上找的最新版

    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-swagger2</artifactId>
        <version>2.8.0</version>
    </dependency>

    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-swagger-ui</artifactId>
        <version>2.8.0</version>
    </dependency>

2巴元、如果啟動(dòng)有報(bào)jackjson的錯(cuò)者蠕,請(qǐng)?jiān)僖雑ackjson的包

    <dependency>
        <groupId>com.fasterxml.jackson.core</groupId>
        <artifactId>jackson-databind</artifactId>
        <version>2.6.6</version>
    </dependency>

3檩奠、我看過(guò)很多版本的集成翁锡,有些是不引入swagger-ui包蔓挖,那么你就需要去自己下載swagger-ui 然后把 dist目錄下的文件全部拷貝到自己的靜態(tài)資源下。
我們需要把swagger的訪問(wèn)配置下靜態(tài)路徑
<mvc:resources mapping="swagger-ui.html" location="classpath:/META-INF/resources/"/>
<mvc:resources mapping="/webjars/**" location="classpath:/META-INF/resources/webjars/"/>

4馆衔、項(xiàng)目里配置swagger

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

/**
 * @Author zhangwenfeng
 * @Date 2018/1/17
 * @Description
 */
@EnableWebMvc
@EnableSwagger2
@Configuration
public class RestApiConfig extends WebMvcConfigurationSupport {

    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.basePackage("cn.zx.user.controller.api"))
                .paths(PathSelectors.any())
                .build();
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("用戶中心api")
                .termsOfServiceUrl("www.baidu.com")
                .contact("xxxx")
                .version("1.1")
                .build();
    }
}

5瘟判、最后一個(gè)注意點(diǎn),如果使用的是 fastjson 請(qǐng)把版本升級(jí)到1.2.15以上角溃。

6拷获、使用 swagger-ui包的 訪問(wèn)路徑為 http://{ip}:{port}:{project}/swagger-ui.html

7、在被掃描的controller里 加swagger注解减细,具體注解使用方式自行百度.

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末匆瓜,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌陕壹,老刑警劉巖,帶你破解...
    沈念sama閱讀 216,843評(píng)論 6 502
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件树埠,死亡現(xiàn)場(chǎng)離奇詭異糠馆,居然都是意外死亡,警方通過(guò)查閱死者的電腦和手機(jī)怎憋,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,538評(píng)論 3 392
  • 文/潘曉璐 我一進(jìn)店門又碌,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái),“玉大人绊袋,你說(shuō)我怎么就攤上這事毕匀。” “怎么了癌别?”我有些...
    開封第一講書人閱讀 163,187評(píng)論 0 353
  • 文/不壞的土叔 我叫張陵皂岔,是天一觀的道長(zhǎng)。 經(jīng)常有香客問(wèn)我展姐,道長(zhǎng)躁垛,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 58,264評(píng)論 1 292
  • 正文 為了忘掉前任圾笨,我火速辦了婚禮教馆,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘擂达。我一直安慰自己土铺,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,289評(píng)論 6 390
  • 文/花漫 我一把揭開白布板鬓。 她就那樣靜靜地躺著悲敷,像睡著了一般。 火紅的嫁衣襯著肌膚如雪穗熬。 梳的紋絲不亂的頭發(fā)上镀迂,一...
    開封第一講書人閱讀 51,231評(píng)論 1 299
  • 那天,我揣著相機(jī)與錄音唤蔗,去河邊找鬼探遵。 笑死,一個(gè)胖子當(dāng)著我的面吹牛妓柜,可吹牛的內(nèi)容都是我干的箱季。 我是一名探鬼主播,決...
    沈念sama閱讀 40,116評(píng)論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼棍掐,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼藏雏!你這毒婦竟也來(lái)了?” 一聲冷哼從身側(cè)響起作煌,我...
    開封第一講書人閱讀 38,945評(píng)論 0 275
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤掘殴,失蹤者是張志新(化名)和其女友劉穎赚瘦,沒(méi)想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體奏寨,經(jīng)...
    沈念sama閱讀 45,367評(píng)論 1 313
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡起意,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,581評(píng)論 2 333
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了病瞳。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片揽咕。...
    茶點(diǎn)故事閱讀 39,754評(píng)論 1 348
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖套菜,靈堂內(nèi)的尸體忽然破棺而出亲善,到底是詐尸還是另有隱情,我是刑警寧澤逗柴,帶...
    沈念sama閱讀 35,458評(píng)論 5 344
  • 正文 年R本政府宣布蛹头,位于F島的核電站,受9級(jí)特大地震影響嚎于,放射性物質(zhì)發(fā)生泄漏掘而。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,068評(píng)論 3 327
  • 文/蒙蒙 一于购、第九天 我趴在偏房一處隱蔽的房頂上張望袍睡。 院中可真熱鬧,春花似錦肋僧、人聲如沸斑胜。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,692評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)止潘。三九已至,卻和暖如春辫诅,著一層夾襖步出監(jiān)牢的瞬間凭戴,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 32,842評(píng)論 1 269
  • 我被黑心中介騙來(lái)泰國(guó)打工炕矮, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留么夫,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 47,797評(píng)論 2 369
  • 正文 我出身青樓肤视,卻偏偏與公主長(zhǎng)得像档痪,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子邢滑,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 44,654評(píng)論 2 354

推薦閱讀更多精彩內(nèi)容

  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見模式的工具(例如配置管理腐螟,服務(wù)發(fā)現(xiàn),斷路器,智...
    卡卡羅2017閱讀 134,652評(píng)論 18 139
  • Spring Boot 參考指南 介紹 轉(zhuǎn)載自:https://www.gitbook.com/book/qbgb...
    毛宇鵬閱讀 46,806評(píng)論 6 342
  • 一乐纸、前言 Swagger是一款RESTFUL接口文檔在線自動(dòng)生成+功能測(cè)試的工具軟件衬廷。Swagger是一個(gè)規(guī)范和完...
    JimmyGan閱讀 2,997評(píng)論 2 7
  • # Swagger2 SpringMVC集成(非SpringBoot) Swgger 做過(guò)手機(jī)端接口的同學(xué)們都有過(guò)...
    zhaovov閱讀 6,644評(píng)論 1 3
  • 媒體查詢的書寫模式@media 媒體類型 and (媒體特性){你的css樣式}媒體類型:screen(屏幕)pr...
    WangYatao閱讀 113評(píng)論 0 0