2018 最新 spring boot 整合 swagger2 (swagger2 版本 2.8.0)
很久沒上了, 看到又有人回覆了. 我就來修改一下. 修改時間 2018年5月16日php
這回給你上全新版本. 至發稿時間,全部的包都是新版. html
注意: 高版本須要添加 jaxb-api 包, 不然會報錯. 最下面列出報錯信息java
2018年5月17日更新 jdk8 不須要添加 jaxb-apiweb
版本:spring
jdk 10apache
spring boot 2.0.2swift
swagger 2.8.0api
- pom.xml 包引入
-
<?xml version="1.0" encoding="UTF-8"?>
-
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-
xsi:schemaLocation=
"http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
-
<modelVersion>4.0.0
</modelVersion>
-
-
<groupId>com.example
</groupId>
-
<artifactId>swagger
</artifactId>
-
<version>0.0.1-SNAPSHOT
</version>
-
<packaging>jar
</packaging>
-
-
<name>swagger
</name>
-
<description>Demo project for Spring Boot
</description>
-
-
<!-- 華爲Maven鏡像 固然你也能夠用阿里的-->
-
<repositories>
-
<repository>
-
<id>huaweicloud
</id>
-
<url>https://repo.huaweicloud.com/repository/maven/
</url>
-
<!--<url>http://maven.aliyun.com/nexus/content/groups/public/</url>-->
-
<releases>
-
<enabled>true
</enabled>
-
</releases>
-
<snapshots>
-
<enabled>true
</enabled>
-
<updatePolicy>always
</updatePolicy>
-
<checksumPolicy>fail
</checksumPolicy>
-
</snapshots>
-
</repository>
-
</repositories>
-
-
<parent>
-
<groupId>org.springframework.boot
</groupId>
-
<artifactId>spring-boot-starter-parent
</artifactId>
-
<version>2.0.2.RELEASE
</version>
-
<relativePath/>
<!-- lookup parent from repository -->
-
</parent>
-
-
<properties>
-
<project.build.sourceEncoding>UTF-8
</project.build.sourceEncoding>
-
<project.reporting.outputEncoding>UTF-8
</project.reporting.outputEncoding>
-
<java.version>10
</java.version>
-
</properties>
-
-
<dependencies>
-
<dependency>
-
<groupId>org.springframework.boot
</groupId>
-
<artifactId>spring-boot-starter-web
</artifactId>
-
</dependency>
-
-
<dependency>
-
<groupId>org.springframework.boot
</groupId>
-
<artifactId>spring-boot-starter-test
</artifactId>
-
<scope>test
</scope>
-
</dependency>
-
-
<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>
-
-
<dependency>
-
<groupId>javax.xml.bind
</groupId>
-
<artifactId>jaxb-api
</artifactId>
-
<version>2.3.0
</version>
-
</dependency>
-
</dependencies>
-
-
<build>
-
<plugins>
-
<plugin>
-
<groupId>org.springframework.boot
</groupId>
-
<artifactId>spring-boot-maven-plugin
</artifactId>
-
</plugin>
-
</plugins>
-
</build>
-
-
-
</project>
先檢查Maven中包是否導入, 如下以idea爲列. 看是否有 swagger-ui 這個包app
如下爲代碼配置:maven
-
package net.ainio.config;
-
-
import org.springframework.context.annotation.Bean;
-
import org.springframework.context.annotation.Configuration;
-
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;
-
-
@
Configuration
-
@
EnableSwagger2
-
public
class SwaggerConfig {
-
@
Bean
-
public
Docket api() {
-
return new
Docket(
DocumentationType.
SWAGGER_2)
-
.apiInfo(apiInfo())
-
.select()
-
// 自行修改成本身的包路徑
-
.apis(
RequestHandlerSelectors.basePackage(
"net.ainio.controller"))
-
.paths(
PathSelectors.any())
-
.build();
-
}
-
-
private
ApiInfo apiInfo() {
-
return new
ApiInfoBuilder()
-
.title(
"api文檔")
-
.description(
"restfun 風格接口")
-
//服務條款網址
-
//.termsOfServiceUrl("http://blog.csdn.net/forezp")
-
.version(
"1.0")
-
//.contact(new Contact("帥呆了", "url", "email"))
-
.build();
-
}
-
}
測試controller
注意下這兩個的區別哦, 否則前臺會返回 404 錯誤
@RestController
@Controller
-
package net.ainio.controller;
-
-
import io.swagger.annotations.Api;
-
import io.swagger.annotations.ApiImplicitParam;
-
import io.swagger.annotations.ApiOperation;
-
import org.apache.catalina.User;
-
import org.springframework.web.bind.
annotation.*;
-
-
@Api(value="/test", tags="測試接口模塊")
-
@RestController
-
@RequestMapping("/test")
-
public
class TestSwaggerController {
-
@ApiOperation(value="展現首頁信息", notes = "展現首頁信息")
-
@GetMapping("/show")
-
public Object showInfo(){
-
return
"hello world";
-
}
-
-
@ApiOperation(value="添加用戶信息", notes = "添加用戶信息")
-
@ApiImplicitParam(name="user", value="User", required = true, dataType = "User")
-
@PostMapping("/addUser")
-
public Object addUser(
@RequestBody User user){
-
return
"success";
-
}
-
}
啓動後訪問
http://localhost:8080/swagger-ui.html
感謝 Michael_Zhan_Tcys 網友
下面列出, 不添加 jabx-api的報錯信息
Error starting ApplicationContext. To display the conditions report re-run your application with 'debug' enabled.
2018-05-16 23:16:20.452 ERROR 10220 --- [ restartedMain] o.s.boot.SpringApplication : Application run failed
org.springframework.beans.factory.BeanCreationException: Error creating bean with name 'xmlModelPlugin': Lookup method resolution failed; nested exception is java.lang.IllegalStateException: Failed to introspect Class [springfox.documentation.schema.XmlModelPlugin] from ClassLoader [jdk.internal.loader.ClassLoaders$AppClassLoader@4629104a]
at org.springframework.beans.factory.annotation.AutowiredAnnotationBeanPostProcessor.determineCandidateConstructors(AutowiredAnnotationBeanPostProcessor.java:262) ~[spring-beans-5.0.6.RELEASE.jar:5.0.6.RELEASE]
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.determineConstructorsFromBeanPostProcessors(AbstractAutowireCapableBeanFactory.java:1202) ~[spring-beans-5.0.6.RELEASE.jar:5.0.6.RELEASE]
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBeanInstance(AbstractAutowireCapableBeanFactory.java:1127) ~[spring-beans-5.0.6.RELEASE.jar:5.0.6.RELEASE]
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.doCreateBean(AbstractAutowireCapableBeanFactory.java:541) ~[spring-beans-5.0.6.RELEASE.jar:5.0.6.RELEASE]
at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBean(AbstractAutowireCapableBeanFactory.java:501) ~[spring-beans-5.0.6.RELEASE.jar:5.0.6.RELEASE]
at org.springframework.beans.factory.support.AbstractBeanFactory.lambda$doGetBean$0(AbstractBeanFactory.java:317) ~[spring-beans-5.0.6.RELEASE.jar:5.0.6.RELEASE]
at org.springframework.beans.factory.support.DefaultSingletonBeanRegistry.getSingleton(DefaultSingletonBeanRegistry.java:228) ~[spring-beans-5.0.6.RELEASE.jar:5.0.6.RELEASE]
at org.springframework.beans.factory.support.AbstractBeanFactory.doGetBean(AbstractBeanFactory.java:315) ~[spring-beans-5.0.6.RELEASE.jar:5.0.6.RELEASE]
at org.springframework.beans.factory.support.AbstractBeanFactory.getBean(AbstractBeanFactory.java:199) ~[spring-beans-5.0.6.RELEASE.jar:5.0.6.RELEASE]
at org.springframework.beans.factory.support.DefaultListableBeanFactory.preInstantiateSingletons(DefaultListableBeanFactory.java:760) ~[spring-beans-5.0.6.RELEASE.jar:5.0.6.RELEASE]
at org.springframework.context.support.AbstractApplicationContext.finishBeanFactoryInitialization(AbstractApplicationContext.java:869) ~[spring-context-5.0.6.RELEASE.jar:5.0.6.RELEASE]
at org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:550) ~[spring-context-5.0.6.RELEASE.jar:5.0.6.RELEASE]
at org.springframework.boot.web.servlet.context.ServletWebServerApplicationContext.refresh(ServletWebServerApplicationContext.java:140) ~[spring-boot-2.0.2.RELEASE.jar:2.0.2.RELEASE]
at org.springframework.boot.SpringApplication.refresh(SpringApplication.java:759) [spring-boot-2.0.2.RELEASE.jar:2.0.2.RELEASE]
at org.springframework.boot.SpringApplication.refreshContext(SpringApplication.java:395) [spring-boot-2.0.2.RELEASE.jar:2.0.2.RELEASE]
at org.springframework.boot.SpringApplication.run(SpringApplication.java:327) [spring-boot-2.0.2.RELEASE.jar:2.0.2.RELEASE]
at org.springframework.boot.SpringApplication.run(SpringApplication.java:1255) [spring-boot-2.0.2.RELEASE.jar:2.0.2.RELEASE]
at org.springframework.boot.SpringApplication.run(SpringApplication.java:1243) [spring-boot-2.0.2.RELEASE.jar:2.0.2.RELEASE]
at com.example.SwaggerApplication.main(SwaggerApplication.java:10) [classes/:na]
at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke0(Native Method) ~[na:na]
at java.base/jdk.internal.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:62) ~[na:na]
at java.base/jdk.internal.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) ~[na:na]
at java.base/java.lang.reflect.Method.invoke(Method.java:564) ~[na:na]
at org.springframework.boot.devtools.restart.RestartLauncher.run(RestartLauncher.java:49) [spring-boot-devtools-2.0.2.RELEASE.jar:2.0.2.RELEASE]
Caused by: java.lang.IllegalStateException: Failed to introspect Class [springfox.documentation.schema.XmlModelPlugin] from ClassLoader [jdk.internal.loader.ClassLoaders$AppClassLoader@4629104a]
at org.springframework.util.ReflectionUtils.getDeclaredMethods(ReflectionUtils.java:659) ~[spring-core-5.0.6.RELEASE.jar:5.0.6.RELEASE]
at org.springframework.util.ReflectionUtils.doWithMethods(ReflectionUtils.java:556) ~[spring-core-5.0.6.RELEASE.jar:5.0.6.RELEASE]
at org.springframework.util.ReflectionUtils.doWithMethods(ReflectionUtils.java:541) ~[spring-core-5.0.6.RELEASE.jar:5.0.6.RELEASE]
at org.springframework.beans.factory.annotation.AutowiredAnnotationBeanPostProcessor.determineCandidateConstructors(AutowiredAnnotationBeanPostProcessor.java:245) ~[spring-beans-5.0.6.RELEASE.jar:5.0.6.RELEASE]
... 23 common frames omitted
Caused by: java.lang.NoClassDefFoundError: javax/xml/bind/annotation/XmlType
at java.base/java.lang.Class.getDeclaredMethods0(Native Method) ~[na:na]
at java.base/java.lang.Class.privateGetDeclaredMethods(Class.java:3119) ~[na:na]
at java.base/java.lang.Class.getDeclaredMethods(Class.java:2268) ~[na:na]
at org.springframework.util.ReflectionUtils.getDeclaredMethods(ReflectionUtils.java:641) ~[spring-core-5.0.6.RELEASE.jar:5.0.6.RELEASE]
... 26 common frames omitted
Caused by: java.lang.ClassNotFoundException: javax.xml.bind.annotation.XmlType
at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:582) ~[na:na]
at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:190) ~[na:na]
at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:499) ~[na:na]
... 30 common frames omitted
Process finished with exit code 0
本文連接：https://blog.csdn.net/aPiFen/article/details/79397100
- 1. 2018 最新 spring boot 整合 swagger2 (swagger2 版本 2.8.0)
- 2. 二、SpringBoot 整合 swagger2 (swagger2 版本 2.8.0)
- 3. Spring Boot 整合Swagger2
- 4. spring boot 整合swagger2
- 5. Spring Boot整合Swagger2
- 6. Spring Boot 整合 Swagger2
- 7. Spring Boot整合swagger2
- 8. Spring boot 2.1.0 -- swagger2 整合
- 9. Spring Boot + Mybatis + Pagehelper+Swagger2整合
- 10. spring boot 整合mybatis + swagger2
- 更多相關文章...
- • MySQL的版本以及版本號 - MySQL教程
- • MyBatis與Spring的整合步驟 - MyBatis教程
- • Spring Cloud 微服務實戰(三) - 服務註冊與發現
- • Tomcat學習筆記（史上最全tomcat學習筆記）
-
每一个你不满意的现在，都有一个你没有努力的曾经。
- 1. 2018 最新 spring boot 整合 swagger2 (swagger2 版本 2.8.0)
- 2. 二、SpringBoot 整合 swagger2 (swagger2 版本 2.8.0)
- 3. Spring Boot 整合Swagger2
- 4. spring boot 整合swagger2
- 5. Spring Boot整合Swagger2
- 6. Spring Boot 整合 Swagger2
- 7. Spring Boot整合swagger2
- 8. Spring boot 2.1.0 -- swagger2 整合
- 9. Spring Boot + Mybatis + Pagehelper+Swagger2整合
- 10. spring boot 整合mybatis + swagger2