Загрузочный Spring Swagger2 используется для создания мощного успокоительный (последний полного, нет ямы)

1: Описание

Слишком многие из этих статей в Интернете, поиск много, но знание либо слишком стары, не сказал название конфигурации ясно, ваш проект не может нормально функционировать в соответствии с его конфигурацией:

Таким образом, цель данной статьи: Конфигурация развязность 2, что развязность-не говорите мне об этом, я не чувствую никакой необходимости, действительно нужно строить или поддерживать старый проект к банку пакет способу, то обратитесь к следующей связи

https://github.com/swagger-api/swagger-ui/tree/2.x/dist   путь загрузки контента, зависимость от импорта может быть связано, не рекомендуется

 

2: развертывание swagger2 1

　　2.1: импорт Lib

<! - развязность -> 
<зависимость> 
    <идентификатор_группы> io.springfox </ идентификатор_группы> 
    <артефакта> springfox-swagger2 </ артефакта> 
    <версия> 2,9 . 2 </ версия> 
</ зависимость> 
<зависимость> 
    <идентификатор_группы> io.springfox </ идентификатор_группы> 
    <артефакта> springfox-чванство-щ </ артефакт> 
    <версия> 2.9 . 2 </ версия> 
</ зависимость>

 

　　2,2 2: Создание класса конфигурации

@Configuration 
@ EnableSwagger2 
общественный  класс Swagger2 { 
    @Bean 
    общественного Ярлык createRestApi () {
         возвращение  нового Ярлык (DocumentationType.SWAGGER_2) 
                .apiInfo (apiInfo ()) 
                .select () 
                // 扫描包路径 
                .apis (RequestHandlerSelectors.basePackage ( "ком. dgw.controller» ))
                 // 扫描@APi标记的класс
                 // .apis (RequestHandlerSelectors.withClassAnnotation (ApiOperation.class)) 
                .paths (PathSelectors.any ()) 
                .build (); 
    } 
    частнаяApiInfo apiInfo () {
         вернуть  новый ApiInfoBuilder () 
                .title ( "Swagger2构建RESTful API - интерфейсы" ) 
                .description ( "项目" ) 
                Контакта ( новый Контакт ( "DGW", «https://www.cnblogs.com/dgwblog/ », "[email protected]" )) 
                .version ( "1.0" ) 
                .build (); 
    } 
}

 

　　2.3 В основном здесь онлайн уроки, которые позволят вам начать HTTP: // локальный: 8080 / чванство-ui.html # доступ и представление API, чтобы уйти ли он не использовал перехватчики Spring Загрузочный доступа отображающие ваши проекты развития ?? это привет мир? ха-ха

　　Здесь необходимо настроить отображение ресурса Sping загрузки 2 в конфигурации в webmvcconfigurationsupport

/ ** 
 *支持webjars 
 * / 
registry.addResourceHandler ( "/ webjars / **" ) 
        .addResourceLocations ( "Путь к классам: / META-INF / ресурсы / webjars /" );
/ ** 
 *支持чванство 
 * / 
// 解决чванство 404报错 
registry.addResourceHandler ( "/ чванство-ui.html") addResourceLocations. ( "Путь к классам: / META-INF / ресурсы /");

 

　　2.4 Если ваш проект не используется, чтобы показать, что вы можете быть успешными перехватчики доступными, но это лучше знать, должно быть настроено перехватчик

registry.addInterceptor ( новый LoginIntercepter ()). addPathPatterns ( "/ **" ) 
        .excludePathPatterns ( "/ пользователь / Логин", "/", "/ индекс" )
            // чванство排除规则 
           .excludePathPatterns ( "/ чванство-щ .html» ) 
           .excludePathPatterns ( "/ чванство-ресурсы / **" ) 
           .excludePathPatterns ( "/ ошибка" ) 
           .excludePathPatterns ( "/ webjars / **");

 

 

Визит в это время: нет никаких проблем:

 

 

 

Кстати, если ваш проект использует  безопасность пружины также необходимо исключить следующую конфигурацию

@Configuration
 общественного  класс WebSecurityConfiguration расширяет WebSecurityConfigurerAdapter { 

    @Override 
    общественного  аннулируется конфигурирование (WebSecurity веб) бросает исключение { 
        web.ignoring (). AntMatchers ( "/ v2 / API-документы", "/ / конфигураций пользовательского интерфейса", "/ чванство-ресурсы" "/ конфигурация / безопасность", "/swagger-ui.html", "/ webjars / **" ); 
    } 

}

 

 

 

3: swagger2 рекомендация развертывания 2

　　Импорт Lib '

<- HTTPS: // mvnrepository.com/artifact/com.spring4all/swagger-spring-boot-starter -> 
<зависимость> 
    <идентификатор_группы> com.spring4all </ идентификатор_группы> 
    <артефакта> чванство-весна-загрузочные стартер </ артефакт> 
    <версия> 1.9.0.RELEASE </ версия> 
</ зависимость> 

<зависимость> 
    <идентификатор_группы> org.springframework.boot </ идентификатор_группы> 
    <артефакта> весна-загрузка-стартер-thymeleaf </ артефакт> 
</ зависимость>

 

application.xml конфигурации

 

swagger.title = весна-загрузка starter- чванство 
swagger.description = Стартер для чванства- .x 
swagger.version = 1.4.0 .RELEASE 
swagger.license = Apache License, версия 2.0 
swagger.licenseUrl = https: // www.apache .org / лицензии / ЛИЦЕНЗИЯ-2.0.html 
swagger.termsOfServiceUrl = https: // github.com/dyc87112/spring-boot-starter-swagger 
swagger.contact.name = Диди 
swagger.contact.url = https: // WWW. cnblogs.com/dgwblog/ 
swagger.contact.email = [email protected] 
#扫描包路径
swagger.base - пакет= Com.dgw.controller 
swagger.base -path = / **

 

Начало конфигурации сканирования чванство

@SpringBootApplication这个注解
@ EnableSwagger2Doc 
общественного  класс DemoApplication { 

    общественность  статический  недействительный основной (String [] агдз) { 
        SpringApplication.run (. DemoApplication класс , арг); 
    } 
}

 

 

Если есть предложение здесь, чтобы посмотреть предыдущую статью, то почему бы не думать о своем собственном доступе.

 

Тест Здесь пишут

@Controller 
@Api ( "接口说明" )
 общественный  класс HelloController { 
    @ApiOperation (значение = "привет方法", отмечает = "返回индекс" ) 
    @GetMapping ( "/ привет" )
     публичная строка привет () {
         возвращение   "индекс" ; 
    } 
}

 

Доступ к ней: