spring boot 集成swagger并且使用攔截器的配置問(wèn)題

fsmStudy 發(fā)布于2019-08-16 16:46 / 3239人閱讀

摘要：另外的解決方案網(wǎng)上還有另外一種說(shuō)法，可以實(shí)現(xiàn)接口，代碼如下用于添加攔截規(guī)則，先把所有路徑都加入攔截，再一個(gè)個(gè)排除自定義規(guī)則，如果遇到，則把泛型類(lèi)轉(zhuǎn)成通用服務(wù)易?？萍嫉沁@種配置想要生效，必須加注解，不然不起作用。

最近同事問(wèn)我，spring boot集成了swagger，但是在使用攔截器的時(shí)候遇到了問(wèn)題，頁(yè)面無(wú)法訪問(wèn)。經(jīng)過(guò)研究解決了這個(gè)問(wèn)題。

配置問(wèn)題解決

集成swagger就不啰嗦了，網(wǎng)上到處都是，直接看配置。

同事從網(wǎng)上找到的配置：

import com.xxx.xxxx.xxx.xxx.LoginInterceptor;
import com.fasterxml.classmate.TypeResolver;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.ResponseEntity;
import org.springframework.web.context.request.async.DeferredResult;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
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.schema.WildcardType;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

import java.util.Collections;

import static springfox.documentation.schema.AlternateTypeRules.newRule;

@Configuration
@EnableSwagger2
public class Swagger2Config extends WebMvcConfigurationSupport {
    @Autowired
    private TypeResolver typeResolver;

    @Bean
    public Docket productApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.xxx.xxx.controller"))
                .paths(PathSelectors.any())
                .build()
                .apiInfo(metaData())
                .alternateTypeRules( //自定義規(guī)則，如果遇到DeferredResult，則把泛型類(lèi)轉(zhuǎn)成json
                        newRule(typeResolver.resolve(DeferredResult.class,
                                typeResolver.resolve(ResponseEntity.class, WildcardType.class)),
                                typeResolver.resolve(WildcardType.class)))
                ;
    }

    private ApiInfo metaData() {
        return new ApiInfoBuilder()
                .title("通用服務(wù) APIs")
                /*.description(""REST API for Online Store"")*/
                .version("1.0.0")
               /* .license("Apache License Version 2.0")
                .licenseUrl("https://www.apache.org/licenses/LICENSE-2.0"")*/
                .contact(new Contact("易保科技", "", "mail@mail"))
                .build();
    }

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("swagger-ui.html")
                .addResourceLocations("classpath:/META-INF/resources/");
        registry.addResourceHandler("/webjars/**")
                .addResourceLocations("classpath:/META-INF/resources/webjars/");
        super.addResourceHandlers(registry);
    }
}

這是他從網(wǎng)上找到的攔截器的配置：

@Configuration
public class WebMvcConfig extends WebMvcConfigurationSupport {
    

    public void addInterceptors(InterceptorRegistry registry) {

        registry.addInterceptor(new LoginInterceptor())
                // addPathPatterns 用于添加攔截規(guī)則 ， 先把所有路徑都加入攔截， 再一個(gè)個(gè)排除
                .addPathPatterns("/**")
                .excludePathPatterns(Collections.singletonList("/swagger-ui.html"));
        super.addInterceptors(registry);
    }

}

現(xiàn)在的測(cè)試結(jié)果就是，打開(kāi)http://host:port/path/swagger-ui.html，就是一個(gè)空白頁(yè)面，無(wú)法使用，現(xiàn)在要解決的就是這個(gè)問(wèn)題。

打開(kāi)谷歌瀏覽器的調(diào)試控制臺(tái)，查看network，如圖：

可以明顯看出，頁(yè)面加載數(shù)據(jù)的時(shí)候，并沒(méi)有報(bào)什么錯(cuò)誤，只是加載的資源都被攔截器攔截了，無(wú)法加載資源，可想而知，資源都被攔截器攔截了。

我分析了一下，加載資源的路徑，修改了一下攔截器資源配置：

 @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(loginInterceptor)
                // addPathPatterns 用于添加攔截規(guī)則 ， 先把所有路徑都加入攔截， 再一個(gè)個(gè)排除
                .addPathPatterns("/**")
                .excludePathPatterns("/swagger-ui.html")
                .excludePathPatterns("/swagger-resources/**")
                .excludePathPatterns("/error")
                .excludePathPatterns("/webjars/**");
    }

另外兩個(gè)類(lèi)實(shí)際是同一個(gè)作用，所以合并兩個(gè)類(lèi)：

@Configuration
@EnableSwagger2
public class TestMVCConfig extends WebMvcConfigurationSupport {

    @Resource
    private TypeResolver typeResolver;


    @Resource
    private LoginInterceptor loginInterceptor;


    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("swagger-ui.html")
                .addResourceLocations("classpath:/META-INF/resources/");
        registry.addResourceHandler("/webjars/**")
                .addResourceLocations("classpath:/META-INF/resources/webjars/");
    }

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(loginInterceptor)
                // addPathPatterns 用于添加攔截規(guī)則 ， 先把所有路徑都加入攔截， 再一個(gè)個(gè)排除
                .addPathPatterns("/**")
                .excludePathPatterns("/swagger-ui.html")
                .excludePathPatterns("/swagger-resources/**")
                .excludePathPatterns("/error")
                .excludePathPatterns("/webjars/**");
    }


    @Bean
    public Docket productApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.xxx.xxx.controller"))
                .paths(PathSelectors.any())
                .build()
                .apiInfo(metaData())
                .alternateTypeRules( //自定義規(guī)則，如果遇到DeferredResult，則把泛型類(lèi)轉(zhuǎn)成json
                        newRule(typeResolver.resolve(DeferredResult.class,
                                typeResolver.resolve(ResponseEntity.class, WildcardType.class)),
                                typeResolver.resolve(WildcardType.class)))
                ;
    }

    private ApiInfo metaData() {
        return new ApiInfoBuilder()
                .title("通用服務(wù) APIs")
                /*.description(""REST API for Online Store"")*/
                .version("1.0.0")
                /* .license("Apache License Version 2.0")
                 .licenseUrl("https://www.apache.org/licenses/LICENSE-2.0"")*/
                .contact(new Contact("易保科技", "", "mail@mail"))
                .build();
    }
}

這樣就沒(méi)有問(wèn)題了。

另外的解決方案

網(wǎng)上還有另外一種說(shuō)法，可以實(shí)現(xiàn)WebMvcConfigurer接口，代碼如下：

@Configuration
@EnableWebMvc
@EnableSwagger2
public class WebMVCConfig implements WebMvcConfigurer{

    @Resource
    private TypeResolver typeResolver;

    @Resource
    private LoginInterceptor loginInterceptor;

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("swagger-ui.html")
                .addResourceLocations("classpath:/META-INF/resources/");
        registry.addResourceHandler("/webjars/**")
                .addResourceLocations("classpath:/META-INF/resources/webjars/");
    }

    @Override
    public void addInterceptors(InterceptorRegistry registry) {

        List excludePathPatterns = new ArrayList<>();
        excludePathPatterns.add("/swagger-ui.html");
        excludePathPatterns.add("/swagger-resources/**");
        excludePathPatterns.add("/error");
        excludePathPatterns.add("/webjars/**");

        // addPathPatterns 用于添加攔截規(guī)則 ， 先把所有路徑都加入攔截， 再一個(gè)個(gè)排除
        registry.addInterceptor(loginInterceptor)
                .addPathPatterns("/**")
                .excludePathPatterns(excludePathPatterns);
    }

    @Bean
    public Docket productApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.xx.sss.controller"))
                .paths(PathSelectors.any())
                .build()
                .apiInfo(metaData())
                .alternateTypeRules( //自定義規(guī)則，如果遇到DeferredResult，則把泛型類(lèi)轉(zhuǎn)成json
                        newRule(typeResolver.resolve(DeferredResult.class,
                                typeResolver.resolve(ResponseEntity.class, WildcardType.class)),
                                typeResolver.resolve(WildcardType.class)))
                ;
    }


    private ApiInfo metaData() {
        return new ApiInfoBuilder()
                .title("通用服務(wù) APIs")
                /*.description(""REST API for Online Store"")*/
                .version("1.0.0")
                /* .license("Apache License Version 2.0")
                 .licenseUrl("https://www.apache.org/licenses/LICENSE-2.0"")*/
                .contact(new Contact("易保科技", "", "mail@mail"))
                .build();
    }
}

但是這種配置想要生效，必須加@EnableWebMvc注解，不然不起作用。為什么？
官方源碼注釋?zhuān)?/p>

/** * Defines callback methods to customize the Java-based configuration for * Spring MVC enabled via {@code @EnableWebMvc}. * *

{@code @EnableWebMvc}-annotated configuration classes may implement * this interface to be called back and given a chance to customize the * default configuration. *

通過(guò)@enableWebMVC啟用Spring MVC，自定義基于Java config 定義回調(diào)方法。
@EnableWebMVC帶注釋的配置類(lèi)可以實(shí)現(xiàn)這個(gè)接口自定義默認(rèn)配置。

當(dāng)然如果你覺(jué)得自己的配置沒(méi)問(wèn)題，但是仍然不起作用，這時(shí)候該怎么辦？請(qǐng)按照一下步驟debug：
1、找到InterceptorRegistration類(lèi)；
2、找到addInterceptor方法和excludePathPatterns方法，打上斷點(diǎn)；
3、debug模式啟動(dòng)項(xiàng)目；

如果沒(méi)有進(jìn)入斷點(diǎn)，那就說(shuō)明你的配置根本沒(méi)有起到作用，看看注解是否沒(méi)寫(xiě)。

如果進(jìn)入了斷點(diǎn)，就要看看斷點(diǎn)處傳進(jìn)來(lái)的參數(shù)是否是你配置的參數(shù)，不是那就是有問(wèn)題，這時(shí)候再根據(jù)參數(shù)查找問(wèn)題。

這樣基本就能解決問(wèn)題了。

總結(jié)

網(wǎng)上很多東西都是抄來(lái)抄去，也不知道有沒(méi)有驗(yàn)證，讓很多人摸不著頭腦。

文章版權(quán)歸作者所有，未經(jīng)允許請(qǐng)勿轉(zhuǎn)載,若此文章存在違規(guī)行為，您可以聯(lián)系管理員刪除。

轉(zhuǎn)載請(qǐng)注明本文地址：http://www.ezyhdfw.cn/yun/74168.html

發(fā)表評(píng)論

登陸后可評(píng)論

0條評(píng)論

fsmStudy

男|高級(jí)講師

我要關(guān)注我要私信

TA的文章

C++從0到1之命名空間

閱讀 3407·2021-11-25 09:43
立即更新您的Windows PC!微軟周二補(bǔ)丁修復(fù)易受主動(dòng)攻擊的0 Day漏洞!

閱讀 3083·2021-10-15 09:43
關(guān)于這個(gè)大一結(jié)束——————

閱讀 2037·2021-09-08 09:36
CSS相關(guān)面試題——三欄等高布局

閱讀 3028·2019-08-30 15:56
設(shè)置圖片水平垂直居中

閱讀 814·2019-08-30 15:54
浮動(dòng)及浮動(dòng)相關(guān)問(wèn)題(初次)

閱讀 2752·2019-08-30 15:54
反思：我使用ID選擇器時(shí)應(yīng)該考慮這些問(wèn)題

閱讀 3067·2019-08-30 11:26
004-盒模型及文本溢出

閱讀 1316·2019-08-29 17:27

亚洲中字慕日产2020,大陆极品少妇内射AAAAAA,无码av大香线蕉伊人久久,久久精品国产亚洲av麻豆网站

資訊專(zhuān)欄INFORMATION COLUMN

上云采購(gòu)季！| 2核2G4M爆款云服務(wù)器低至59元/年，更有多臺(tái)、長(zhǎng)期優(yōu)惠，快來(lái)選購(gòu)！

spring boot 集成swagger并且使用攔截器的配置問(wèn)題

相關(guān)文章

ApiBoot - ApiBoot Security Oauth 依賴(lài)使用文檔

**Java | Spring Boot Swagger2 集成REST ful API 生成接口文檔**

SpringCloud核心教程 | 第四篇：服務(wù)注冊(cè)與發(fā)現(xiàn) Consul篇

發(fā)表評(píng)論

0條評(píng)論

fsmStudy

男|高級(jí)講師

TA的文章

C++從0到1之命名空間

立即更新您的Windows PC!微軟周二補(bǔ)丁修復(fù)易受主動(dòng)攻擊的0 Day漏洞!

關(guān)于這個(gè)大一結(jié)束——————

CSS相關(guān)面試題——三欄等高布局

設(shè)置圖片水平垂直居中

浮動(dòng)及浮動(dòng)相關(guān)問(wèn)題(初次)

反思：我使用ID選擇器時(shí)應(yīng)該考慮這些問(wèn)題

004-盒模型及文本溢出

最新活動(dòng)

資訊專(zhuān)欄INFORMATION COLUMN

上云采購(gòu)季！| 2核2G4M爆款云服務(wù)器低至59元/年，更有多臺(tái)、長(zhǎng)期優(yōu)惠，快來(lái)選購(gòu)！

spring boot 集成swagger并且使用攔截器的配置問(wèn)題

相關(guān)文章

發(fā)表評(píng)論

0條評(píng)論

男|高級(jí)講師

TA的文章

最新活動(dòng)

上云采購(gòu)季！| 2核2G4M爆款云服務(wù)器低至59元/年，更有多臺(tái)、長(zhǎng)期優(yōu)惠，快來(lái)選購(gòu)！