Spring 4 学习笔记-SpringRestFull接口整合Swagger

最新推荐文章于 2022-07-26 06:38:09 发布
最新推荐文章于 2022-07-26 06:38:09 发布
阅读量252 收藏
点赞数
文章标签： java 测试 开发工具
原文链接：https://my.oschina.net/TomXiao/blog/716664
版权

本项目是根据上一篇文档： Spring 4 学习笔记- SpringWeb MVC RestFul 项目搭建  项目基础上进行整合。其实很简单。 主要是记录配置过程中遇到的一些坑。

1. 在原有项目基础上，添加如下依赖库，及pom.xml文件中加入以下：

		<dependency>
			<groupId>com.mangofactory</groupId>
			<artifactId>swagger-springmvc</artifactId>
			<version>0.9.4</version>
		</dependency>
		<dependency>
			<groupId>com.wordnik</groupId>
			<artifactId>swagger-annotations</artifactId>
			<version>1.3.5</version>
		</dependency>
		<dependency>
			<groupId>com.wordnik</groupId>
			<artifactId>swagger-core_2.10</artifactId>
			<version>1.3.5</version>
		</dependency>
		<dependency>
			<groupId>org.codehaus.jackson</groupId>
			<artifactId>jackson-mapper-asl</artifactId>
			<version>1.9.2</version>
		</dependency>
		<dependency>
			<groupId>org.codehaus.jackson</groupId>
			<artifactId>jackson-core-asl</artifactId>
			<version>1.9.2</version>
		</dependency>
		<dependency>
			<groupId>com.mangofactory</groupId>
			<artifactId>swagger-models</artifactId>
			<version>0.9.4</version>
		</dependency>

2. 添加Swagger Java类配置文件。这里有些坑， 后面介绍。

/**
* @Project Spring 
* @author Xiaowentao
* @Time 2016年7月22日
*/
package tom.spring.config;

import org.springframework.beans.factory.annotation.Autowired;
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 com.mangofactory.swagger.configuration.SpringSwaggerConfig;
import com.mangofactory.swagger.models.dto.ApiInfo;
import com.mangofactory.swagger.plugin.EnableSwagger;
import com.mangofactory.swagger.plugin.SwaggerSpringMvcPlugin;

//@Configuration
@EnableSwagger
@EnableWebMvc
@ComponentScan("tom.spring.controller")
public class SwaggerConfig {
	
	@Autowired
	private SpringSwaggerConfig swaggerConfig;
	
	@Bean
	public SwaggerSpringMvcPlugin customImplementation() {
		
 		SwaggerSpringMvcPlugin swaggerSpringMvcPlugin = new SwaggerSpringMvcPlugin(swaggerConfig);
		swaggerSpringMvcPlugin.apiInfo(apiInfo());
		swaggerSpringMvcPlugin.swaggerGroup("group");
		swaggerSpringMvcPlugin.includePatterns(".*?");
 
		return swaggerSpringMvcPlugin;
	}
	private ApiInfo apiInfo() {
		ApiInfo apiInfo = new ApiInfo("My Apps API Title", "My Apps API Description", "My Apps API terms of service",
				"My Apps API Contact Email", "My Apps API Licence Type", "My Apps API License URL");
		return apiInfo;
	}
	public SpringSwaggerConfig getSwaggerConfig() {
		return swaggerConfig;
	}
	public void setSwaggerConfig(SpringSwaggerConfig swaggerConfig) {
		this.swaggerConfig = swaggerConfig;
	}
}

注： 1. 去掉@Configure 注解，网上很多都是写的Configure注解， 但是我写怎么也调试不通过，最后在XML中配置了一个自定义Configure的Bean。否则会出现以下错误：

严重: Exception sending context initialized event to listener instance of class org.springframework.web.context.ContextLoaderListener
org.springframework.beans.factory.UnsatisfiedDependencyException: Error creating bean with name 'com.mangofactory.swagger.configuration.SpringSwaggerConfig#0': Unsatisfied dependency expressed through field 'handlerMappings': No qualifying bean of type [java.util.List] found for dependency [java.util.List<org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping>]: expected at least 1 bean which qualifies as autowire candidate for this dependency. Dependency annotations: {@org.springframework.beans.factory.annotation.Autowired(required=true)}; nested exception is org.springframework.beans.factory.NoSuchBeanDefinitionException: No qualifying bean of type [java.util.List] found for dependency [java.util.List<org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping>]: expected at least 1 bean which qualifies as autowire candidate for this dependency. Dependency annotations: {@org.springframework.beans.factory.annotation.Autowired(required=true)}
	at org.springframework.beans.factory.annotation.AutowiredAnnotationBeanPostProcessor$AutowiredFieldElement.inject(AutowiredAnnotationBeanPostProcessor.java:569)
	at org.springframework.beans.factory.annotation.InjectionMetadata.inject(InjectionMetadata.java:88)
	at org.springframework.beans.factory.annotation.AutowiredAnnotationBeanPostProcessor.postProcessPropertyValues(AutowiredAnnotationBeanPostProcessor.java:349)
	at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.populateBean(AbstractAutowireCapableBeanFactory.java:1214)
	at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.doCreateBean(AbstractAutowireCapableBeanFactory.java:543)
	at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.createBean(AbstractAutowireCapableBeanFactory.java:482)
	at org.springframework.beans.factory.support.AbstractBeanFactory$1.getObject(AbstractBeanFactory.java:306)
	at org.springframework.beans.factory.support.DefaultSingletonBeanRegistry.getSingleton(DefaultSingletonBeanRegistry.java:230)
	at org.springframework.beans.factory.support.AbstractBeanFactory.doGetBean(AbstractBeanFactory.java:302)
	at org.springframework.beans.factory.support.AbstractBeanFactory.getBean(AbstractBeanFactory.java:197)
	at org.springframework.beans.factory.support.DefaultListableBeanFactory.preInstantiateSingletons(DefaultListableBeanFactory.java:775)
	at org.springframework.context.support.AbstractApplicationContext.finishBeanFactoryInitialization(AbstractApplicationContext.java:861)
	at org.springframework.context.support.AbstractApplicationContext.refresh(AbstractApplicationContext.java:541)
	at org.springframework.web.context.ContextLoader.configureAndRefreshWebApplicationContext(ContextLoader.java:444)
	at org.springframework.web.context.ContextLoader.initWebApplicationContext(ContextLoader.java:326)
	at org.springframework.web.context.ContextLoaderListener.contextInitialized(ContextLoaderListener.java:107)
	at org.apache.catalina.core.StandardContext.listenerStart(StandardContext.java:4729)
	at org.apache.catalina.core.StandardContext.startInternal(StandardContext.java:5167)
	at org.apache.catalina.util.LifecycleBase.start(LifecycleBase.java:150)
	at org.apache.catalina.core.ContainerBase$StartChild.call(ContainerBase.java:1408)
	at org.apache.catalina.core.ContainerBase$StartChild.call(ContainerBase.java:1398)
	at java.util.concurrent.FutureTask.run(FutureTask.java:262)
	at java.util.concurrent.ThreadPoolExecutor.runWorker(ThreadPoolExecutor.java:1145)
	at java.util.concurrent.ThreadPoolExecutor$Worker.run(ThreadPoolExecutor.java:615)
	at java.lang.Thread.run(Thread.java:745)
Caused by: org.springframework.beans.factory.NoSuchBeanDefinitionException: No qualifying bean of type [java.util.List] found for dependency [java.util.List<org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerMapping>]: expected at least 1 bean which qualifies as autowire candidate for this dependency. Dependency annotations: {@org.springframework.beans.factory.annotation.Autowired(required=true)}
	at org.springframework.beans.factory.support.DefaultListableBeanFactory.raiseNoSuchBeanDefinitionException(DefaultListableBeanFactory.java:1403)
	at org.springframework.beans.factory.support.DefaultListableBeanFactory.doResolveDependency(DefaultListableBeanFactory.java:1056)
	at org.springframework.beans.factory.support.DefaultListableBeanFactory.resolveDependency(DefaultListableBeanFactory.java:1018)
	at org.springframework.beans.factory.annotation.AutowiredAnnotationBeanPostProcessor$AutowiredFieldElement.inject(AutowiredAnnotationBeanPostProcessor.java:566)
	... 24 more

 

3. 上一步中去掉了@Configure注解，需要再XML中配置一个Bean， 同时由于Spring中并没有配置SpringSwaggerConfig的Bean，而在自定义的Config中配置了添加自动注解赋值的，所以我们在XML配置中需要添加一个匿名Bean。Spring Bean配置如下：

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
	xmlns:context="http://www.springframework.org/schema/context" xmlns:p="http://www.springframework.org/schema/p"
	xmlns:aop="http://www.springframework.org/schema/aop" xmlns:tx="http://www.springframework.org/schema/tx"
	xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="  
        http://www.springframework.org/schema/beans   
        http://www.springframework.org/schema/beans/spring-beans-4.0.xsd   
        http://www.springframework.org/schema/context   
        http://www.springframework.org/schema/context/spring-context-4.0.xsd
		http://www.springframework.org/schema/aop
        http://www.springframework.org/schema/aop/spring-aop-4.0.xsd
        http://www.springframework.org/schema/tx
        http://www.springframework.org/schema/tx/spring-tx-4.0.xsd">

	<context:component-scan base-package="flare.core" />
	<bean class="tom.spring.config.SwaggerConfig" />
	<bean class="com.mangofactory.swagger.configuration.SpringSwaggerConfig" />

</beans>

4. 下载Swagger-UI， 地址：https://github.com/swagger-api/swagger-ui 。 将dist目录下所有文件拷贝到项目目录WEB_INF目录下（其他目录也可以）。

152936_mXZn_2285740.png

5. 修改Swagger文件中的index.html ， 将URL改为自己项目URL。 如下所示：

  <script type="text/javascript">
    $(function () {
      var url = window.location.search.match(/url=([^&]+)/);
      if (url && url.length > 1) {
        url = decodeURIComponent(url[1]);
      } else {
        url = "http://localhost:8080/Spring/api-docs/";
      }
     
    ......

6. 添加静态资源请求映射。 将以下内容添加的servlet配置文件中，其他配置与RestFul项目配置一样。 

	<mvc:resources mapping="/swagger/**" location="/WEB-INF/swagger/" />

7. 最后web.xml 文件配置如下所示：

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns="http://java.sun.com/xml/ns/javaee"
	xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
	version="3.0">
	<display-name>Spring Learn</display-name>
	<listener>
		<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
	</listener>

	<servlet>
		<servlet-name>dispatcher</servlet-name>
		<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
		<init-param>
			<param-name>contextConfigLocation</param-name>
			<param-value>classpath*:/servlet/*.xml</param-value>
		</init-param>
		<load-on-startup>1</load-on-startup>
	</servlet>
	<servlet-mapping>
		<servlet-name>dispatcher</servlet-name>
		<url-pattern>/</url-pattern>
	</servlet-mapping>
	
	<context-param>
		<description>Define Default DataSource Configure</description>
		<param-name>spring.profiles.default</param-name>
		<param-value>dev</param-value>
	</context-param>

	<context-param>
		<param-name>contextConfigLocation</param-name>
		<param-value>classpath*:/spring/*.xml</param-value>
	</context-param>

</web-app>

8. 修改之前的Controller， 添加API注解，如下所示：

/**
* @Project Spring 
* @author Xiaowentao
* @Time 2016年7月22日
*/
/**
 * 
 */
package tom.spring.controller;

import java.util.ArrayList;
import java.util.List;

import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import com.wordnik.swagger.annotations.Api;
import com.wordnik.swagger.annotations.ApiOperation;
import com.wordnik.swagger.annotations.ApiResponse;
import com.wordnik.swagger.annotations.ApiResponses;
import org.springframework.web.bind.annotation.RequestMethod;
/**
 * @author Xiaowentao
 *
 */
@Api(value="User", description = "用户管理相关接口")
@RestController
@RequestMapping("/user")
public class UserManagerController {
	
	@ApiOperation(value = "用户详细信息", notes = "检索用户的详细信息")
	@ApiResponses({ @ApiResponse(code = 200, message = "查询成功"), @ApiResponse(code = 400, message = "查询出错") })
	@RequestMapping(value="/messages", method=RequestMethod.GET)
	public List<String> getMessage(){
		
		List<String> result = new  ArrayList<String>(7);
	
		for(int i=0; i<7; i++){
			result.add("Tom "+i);
		}
		return result;
	}
	
	@ApiOperation(value = "用户user信息", notes = "检索user的详细信息")
	@ApiResponses({ @ApiResponse(code = 200, message = "查询成功"), @ApiResponse(code = 400, message = "查询出错") })
	@RequestMapping(value="/user",method=RequestMethod.GET)
	public String getUser(){	 
		return "user: Tom";
	}
}

注：1.  发现及时不添加这些 API注解， 最新版的Swagger 也能扫描到这个借口，并显示在接口列表中。 

    2. controller方法一定要注明求情类型，默认Swagger会创建6种方法映射的请求接口。

9. 访问swagger ui , 启动项目后输入以下地址： http://localhost:8080/Spring/swagger/index.html 得到如下所示请求接口：

154226_IA1d_2285740.png

 

10. Swagger UI也可以运行在nginx中，通过配置nginx代理实现。这个同一个Swagger 可以同时调用多个项目的api接口。 之后再写笔记。

11. 项目源代码和之前两个项目源代码一样，可以通过前面两个文章获取。 每个成功demo提交都有一个tag，自行切换。

 

12. 启动成功的log输出，一定可以看到 Swagger Listing的接口。

七月 23, 2016 3:41:23 下午 org.apache.tomcat.util.digester.SetPropertiesRule begin
警告: [SetPropertiesRule]{Server/Service/Engine/Host/Context} Setting property 'source' to 'org.eclipse.jst.jee.server:Spring' did not find a matching property.
七月 23, 2016 3:41:23 下午 org.apache.catalina.startup.VersionLoggerListener log
信息: Server version:        Apache Tomcat/8.0.26
七月 23, 2016 3:41:23 下午 org.apache.catalina.startup.VersionLoggerListener log
信息: Server built:          Aug 18 2015 11:38:37 UTC
七月 23, 2016 3:41:23 下午 org.apache.catalina.startup.VersionLoggerListener log
信息: Server number:         8.0.26.0
七月 23, 2016 3:41:23 下午 org.apache.catalina.startup.VersionLoggerListener log
信息: OS Name:               Windows 8.1
七月 23, 2016 3:41:23 下午 org.apache.catalina.startup.VersionLoggerListener log
信息: OS Version:            6.3
七月 23, 2016 3:41:23 下午 org.apache.catalina.startup.VersionLoggerListener log
信息: Architecture:          amd64
七月 23, 2016 3:41:23 下午 org.apache.catalina.startup.VersionLoggerListener log
信息: Java Home:             C:\Java\jdk1.7.0_79\jre
七月 23, 2016 3:41:23 下午 org.apache.catalina.startup.VersionLoggerListener log
信息: JVM Version:           1.7.0_79-b15
七月 23, 2016 3:41:23 下午 org.apache.catalina.startup.VersionLoggerListener log
信息: JVM Vendor:            Oracle Corporation
七月 23, 2016 3:41:23 下午 org.apache.catalina.startup.VersionLoggerListener log
信息: CATALINA_BASE:         D:\workspace\.metadata\.plugins\org.eclipse.wst.server.core\tmp2
七月 23, 2016 3:41:23 下午 org.apache.catalina.startup.VersionLoggerListener log
信息: CATALINA_HOME:         D:\apache-tomcat-8
七月 23, 2016 3:41:23 下午 org.apache.catalina.startup.VersionLoggerListener log
信息: Command line argument: -Dcatalina.base=D:\workspace\.metadata\.plugins\org.eclipse.wst.server.core\tmp2
七月 23, 2016 3:41:23 下午 org.apache.catalina.startup.VersionLoggerListener log
信息: Command line argument: -Dcatalina.home=D:\apache-tomcat-8
七月 23, 2016 3:41:23 下午 org.apache.catalina.startup.VersionLoggerListener log
信息: Command line argument: -Dwtp.deploy=D:\workspace\.metadata\.plugins\org.eclipse.wst.server.core\tmp2\wtpwebapps
七月 23, 2016 3:41:23 下午 org.apache.catalina.startup.VersionLoggerListener log
信息: Command line argument: -Djava.endorsed.dirs=D:\apache-tomcat-8\endorsed
七月 23, 2016 3:41:23 下午 org.apache.catalina.startup.VersionLoggerListener log
信息: Command line argument: -Dfile.encoding=UTF-8
七月 23, 2016 3:41:23 下午 org.apache.catalina.core.AprLifecycleListener lifecycleEvent
信息: Loaded APR based Apache Tomcat Native library 1.1.33 using APR version 1.5.1.
七月 23, 2016 3:41:23 下午 org.apache.catalina.core.AprLifecycleListener lifecycleEvent
信息: APR capabilities: IPv6 [true], sendfile [true], accept filters [false], random [true].
七月 23, 2016 3:41:24 下午 org.apache.catalina.core.AprLifecycleListener initializeSSL
信息: OpenSSL successfully initialized (OpenSSL 1.0.1m 19 Mar 2015)
七月 23, 2016 3:41:24 下午 org.apache.coyote.AbstractProtocol init
信息: Initializing ProtocolHandler ["http-apr-8080"]
七月 23, 2016 3:41:24 下午 org.apache.coyote.AbstractProtocol init
信息: Initializing ProtocolHandler ["ajp-apr-8009"]
七月 23, 2016 3:41:24 下午 org.apache.catalina.startup.Catalina load
信息: Initialization processed in 2207 ms
七月 23, 2016 3:41:24 下午 org.apache.catalina.core.StandardService startInternal
信息: Starting service Catalina
七月 23, 2016 3:41:24 下午 org.apache.catalina.core.StandardEngine startInternal
信息: Starting Servlet Engine: Apache Tomcat/8.0.26
七月 23, 2016 3:41:25 下午 org.apache.catalina.util.SessionIdGeneratorBase createSecureRandom
信息: Creation of SecureRandom instance for session ID generation using [SHA1PRNG] took [258] milliseconds.
七月 23, 2016 3:41:31 下午 org.apache.jasper.servlet.TldScanner scanJars
信息: At least one JAR was scanned for TLDs yet contained no TLDs. Enable debug logging for this logger for a complete list of JARs that were scanned but no TLDs were found in them. Skipping unneeded JARs during scanning can improve startup time and JSP compilation time.
七月 23, 2016 3:41:31 下午 org.apache.catalina.core.ApplicationContext log
信息: No Spring WebApplicationInitializer types detected on classpath
七月 23, 2016 3:41:31 下午 org.apache.catalina.core.ApplicationContext log
信息: Initializing Spring root WebApplicationContext
2016-07-23 15:41:31-INFO [localhost-startStop-1] org.springframework.web.context.ContextLoader.initWebApplicationContext(305)-Root WebApplicationContext: initialization started
2016-07-23 15:41:31-INFO [localhost-startStop-1] org.springframework.context.support.AbstractApplicationContext.prepareRefresh(581)-Refreshing Root WebApplicationContext: startup date [Sat Jul 23 15:41:31 CST 2016]; root of context hierarchy
2016-07-23 15:41:31-INFO [localhost-startStop-1] org.springframework.beans.factory.xml.XmlBeanDefinitionReader.loadBeanDefinitions(317)-Loading XML bean definitions from file [D:\workspace\.metadata\.plugins\org.eclipse.wst.server.core\tmp2\wtpwebapps\Spring\WEB-INF\classes\spring\applicationContext.xml]
2016-07-23 15:41:32-INFO [localhost-startStop-1] org.springframework.web.servlet.handler.AbstractHandlerMethodMapping$MappingRegistry.register(534)-Mapped "{[/ || /homepage],methods=[GET]}" onto public java.lang.String tom.spring.controller.HomeController.home()
2016-07-23 15:41:32-INFO [localhost-startStop-1] org.springframework.web.servlet.handler.AbstractHandlerMethodMapping$MappingRegistry.register(534)-Mapped "{[/user/messages],methods=[GET]}" onto public java.util.List<java.lang.String> tom.spring.controller.UserManagerController.getMessage()
2016-07-23 15:41:32-INFO [localhost-startStop-1] org.springframework.web.servlet.handler.AbstractHandlerMethodMapping$MappingRegistry.register(534)-Mapped "{[/user/user],methods=[GET]}" onto public java.lang.String tom.spring.controller.UserManagerController.getUser()
2016-07-23 15:41:32-INFO [localhost-startStop-1] org.springframework.web.servlet.handler.AbstractHandlerMethodMapping$MappingRegistry.register(534)-Mapped "{[/api-docs/{swaggerGroup}/{apiDeclaration}],methods=[GET]}" onto public org.springframework.http.ResponseEntity<com.mangofactory.swagger.models.dto.ApiListing> com.mangofactory.swagger.controllers.DefaultSwaggerController.getApiListing(java.lang.String,java.lang.String)
2016-07-23 15:41:32-INFO [localhost-startStop-1] org.springframework.web.servlet.handler.AbstractHandlerMethodMapping$MappingRegistry.register(534)-Mapped "{[/api-docs],methods=[GET]}" onto public org.springframework.http.ResponseEntity<com.mangofactory.swagger.models.dto.ResourceListing> com.mangofactory.swagger.controllers.DefaultSwaggerController.getResourceListing(java.lang.String)
2016-07-23 15:41:33-INFO [localhost-startStop-1] org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter.initControllerAdviceCache(539)-Looking for @ControllerAdvice: Root WebApplicationContext: startup date [Sat Jul 23 15:41:31 CST 2016]; root of context hierarchy
2016-07-23 15:41:34-INFO [localhost-startStop-1] com.mangofactory.swagger.plugin.SwaggerPluginAdapter.onApplicationEvent(33)-Context refreshed
2016-07-23 15:41:34-INFO [localhost-startStop-1] com.mangofactory.swagger.plugin.SwaggerPluginAdapter.onApplicationEvent(46)-Found custom SwaggerSpringMvcPlugins
2016-07-23 15:41:34-INFO [localhost-startStop-1] com.mangofactory.swagger.plugin.SwaggerPluginAdapter.onApplicationEvent(50)-initializing plugin bean customImplementation
2016-07-23 15:41:34-INFO [localhost-startStop-1] com.mangofactory.swagger.scanners.ApiListingReferenceScanner.scan(55)-Scanning for api listing references
2016-07-23 15:41:34-INFO [localhost-startStop-1] com.mangofactory.swagger.core.ClassOrApiAnnotationResourceGrouping.getResourceGroups(50)-Group for method home was home-controller
2016-07-23 15:41:34-INFO [localhost-startStop-1] com.mangofactory.swagger.scanners.ApiListingReferenceScanner.scanSpringRequestMappings(78)-Request mapping: home belongs to groups: [[ResourceGroup{groupName='home-controller', position=0}]] 
2016-07-23 15:41:34-INFO [localhost-startStop-1] com.mangofactory.swagger.scanners.ApiListingReferenceScanner.scanSpringRequestMappings(82)-Adding resource to group:ResourceGroup{groupName='home-controller', position=0} with description:Home Controller for handler method:home
2016-07-23 15:41:34-INFO [localhost-startStop-1] com.mangofactory.swagger.core.ClassOrApiAnnotationResourceGrouping.getResourceGroups(50)-Group for method getMessage was user
2016-07-23 15:41:34-INFO [localhost-startStop-1] com.mangofactory.swagger.scanners.ApiListingReferenceScanner.scanSpringRequestMappings(78)-Request mapping: getMessage belongs to groups: [[ResourceGroup{groupName='user', position=0}]] 
2016-07-23 15:41:34-INFO [localhost-startStop-1] com.mangofactory.swagger.scanners.ApiListingReferenceScanner.scanSpringRequestMappings(82)-Adding resource to group:ResourceGroup{groupName='user', position=0} with description:用户管理相关接口 for handler method:getMessage
2016-07-23 15:41:34-INFO [localhost-startStop-1] com.mangofactory.swagger.core.ClassOrApiAnnotationResourceGrouping.getResourceGroups(50)-Group for method getUser was user
2016-07-23 15:41:34-INFO [localhost-startStop-1] com.mangofactory.swagger.scanners.ApiListingReferenceScanner.scanSpringRequestMappings(78)-Request mapping: getUser belongs to groups: [[ResourceGroup{groupName='user', position=0}]] 
2016-07-23 15:41:34-INFO [localhost-startStop-1] com.mangofactory.swagger.scanners.ApiListingReferenceScanner.scanSpringRequestMappings(82)-Adding resource to group:ResourceGroup{groupName='user', position=0} with description:用户管理相关接口 for handler method:getUser
2016-07-23 15:41:34-INFO [localhost-startStop-1] com.mangofactory.swagger.core.RequestMappingEvaluator.hasIgnoredAnnotatedRequestMapping(74)-Excluding method as it contains the excluded annotation: interface com.mangofactory.swagger.annotations.ApiIgnore
2016-07-23 15:41:34-INFO [localhost-startStop-1] com.mangofactory.swagger.core.RequestMappingEvaluator.hasIgnoredAnnotatedRequestMapping(74)-Excluding method as it contains the excluded annotation: interface com.mangofactory.swagger.annotations.ApiIgnore
2016-07-23 15:41:34-INFO [localhost-startStop-1] com.mangofactory.swagger.scanners.ApiListingReferenceScanner.scanSpringRequestMappings(96)-Created resource listing Path: /group/home-controller Description: home-controller Position: 0
2016-07-23 15:41:34-INFO [localhost-startStop-1] com.mangofactory.swagger.scanners.ApiListingReferenceScanner.scanSpringRequestMappings(96)-Created resource listing Path: /group/user Description: user Position: 0
2016-07-23 15:41:34-INFO [localhost-startStop-1] com.mangofactory.swagger.readers.operation.OperationAuthReader.execute(64)-Authorization count home for method 0
2016-07-23 15:41:34-INFO [localhost-startStop-1] com.mangofactory.swagger.readers.operation.OperationAuthReader.execute(64)-Authorization count home for method 0
2016-07-23 15:41:34-INFO [localhost-startStop-1] com.mangofactory.swagger.readers.operation.OperationAuthReader.execute(64)-Authorization count getMessage for method 0
2016-07-23 15:41:34-INFO [localhost-startStop-1] com.mangofactory.swagger.readers.operation.OperationAuthReader.execute(64)-Authorization count getUser for method 0
2016-07-23 15:41:34-INFO [localhost-startStop-1] com.mangofactory.swagger.core.SwaggerApiResourceListing.initialize(87)-Added a resource listing with (2) api resources: 
2016-07-23 15:41:34-INFO [localhost-startStop-1] com.mangofactory.swagger.core.SwaggerApiResourceListing.initialize(92)-  Home Controller at location: /api-docs/group/home-controller
2016-07-23 15:41:34-INFO [localhost-startStop-1] com.mangofactory.swagger.core.SwaggerApiResourceListing.initialize(92)-  用户管理相关接口 at location: /api-docs/group/user
2016-07-23 15:41:34-INFO [localhost-startStop-1] org.springframework.web.context.ContextLoader.initWebApplicationContext(345)-Root WebApplicationContext: initialization completed in 2913 ms
七月 23, 2016 3:41:34 下午 org.apache.catalina.core.ApplicationContext log
信息: Initializing Spring FrameworkServlet 'dispatcher'
2016-07-23 15:41:34-INFO [localhost-startStop-1] org.springframework.web.servlet.FrameworkServlet.initServletBean(487)-FrameworkServlet 'dispatcher': initialization started
2016-07-23 15:41:34-INFO [localhost-startStop-1] org.springframework.context.support.AbstractApplicationContext.prepareRefresh(581)-Refreshing WebApplicationContext for namespace 'dispatcher-servlet': startup date [Sat Jul 23 15:41:34 CST 2016]; parent: Root WebApplicationContext
2016-07-23 15:41:34-INFO [localhost-startStop-1] org.springframework.beans.factory.xml.XmlBeanDefinitionReader.loadBeanDefinitions(317)-Loading XML bean definitions from file [D:\workspace\.metadata\.plugins\org.eclipse.wst.server.core\tmp2\wtpwebapps\Spring\WEB-INF\classes\servlet\dispatcher-servlet.xml]
2016-07-23 15:41:34-INFO [localhost-startStop-1] org.springframework.web.servlet.handler.AbstractHandlerMethodMapping$MappingRegistry.register(534)-Mapped "{[/ || /homepage],methods=[GET]}" onto public java.lang.String tom.spring.controller.HomeController.home()
2016-07-23 15:41:34-INFO [localhost-startStop-1] org.springframework.web.servlet.handler.AbstractHandlerMethodMapping$MappingRegistry.register(534)-Mapped "{[/user/messages],methods=[GET]}" onto public java.util.List<java.lang.String> tom.spring.controller.UserManagerController.getMessage()
2016-07-23 15:41:34-INFO [localhost-startStop-1] org.springframework.web.servlet.handler.AbstractHandlerMethodMapping$MappingRegistry.register(534)-Mapped "{[/user/user],methods=[GET]}" onto public java.lang.String tom.spring.controller.UserManagerController.getUser()
2016-07-23 15:41:34-INFO [localhost-startStop-1] org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter.initControllerAdviceCache(539)-Looking for @ControllerAdvice: WebApplicationContext for namespace 'dispatcher-servlet': startup date [Sat Jul 23 15:41:34 CST 2016]; parent: Root WebApplicationContext
2016-07-23 15:41:34-INFO [localhost-startStop-1] org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter.initControllerAdviceCache(539)-Looking for @ControllerAdvice: WebApplicationContext for namespace 'dispatcher-servlet': startup date [Sat Jul 23 15:41:34 CST 2016]; parent: Root WebApplicationContext
2016-07-23 15:41:34-INFO [localhost-startStop-1] org.springframework.web.servlet.handler.AbstractUrlHandlerMapping.registerHandler(341)-Mapped URL path [/swagger/**] onto handler 'org.springframework.web.servlet.resource.ResourceHttpRequestHandler#0'
2016-07-23 15:41:35-INFO [localhost-startStop-1] com.mangofactory.swagger.plugin.SwaggerPluginAdapter.onApplicationEvent(60)-Skipping SwaggerSpringMvcPlugin initialization already initialized!
2016-07-23 15:41:35-INFO [localhost-startStop-1] org.springframework.web.servlet.FrameworkServlet.initServletBean(506)-FrameworkServlet 'dispatcher': initialization completed in 867 ms
七月 23, 2016 3:41:35 下午 org.apache.coyote.AbstractProtocol start
信息: Starting ProtocolHandler ["http-apr-8080"]
七月 23, 2016 3:41:35 下午 org.apache.coyote.AbstractProtocol start
信息: Starting ProtocolHandler ["ajp-apr-8009"]
七月 23, 2016 3:41:35 下午 org.apache.catalina.startup.Catalina start
信息: Server startup in 10833 ms

 

转载于:https://my.oschina.net/TomXiao/blog/716664

chixin3206
关注
  • 0
    点赞
  • 踩
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
Spring4集成Swagger：真的只需要四步，五分钟速成
一个有点理想的博客
05-16 1万+
如果你所在的公司的还没有使用swagger甚至没有听说过swagger，赶快学习一下我的这篇博客吧，五分钟速成，傻瓜式的集成，但就是这么简单的应用一定会让他们震惊到的。 首先对swagger做一个简介吧：swagger是后台开发的神器，也是前后端交流的渠道。你可以用swagger做什么？首先，你以后基本可以告别单元测试了；其次，你不用再写接口文档了，也不需要写完之后再去对文档进行维护了。swagge
Spring4+swagger整合遇坑过程
zhekndang93的博客
07-04 469
Spring4+swagger整合配置发现问题解决问题代码演示 配置 我用的配置如下 Jdk7+spring4.x+swagger1.7.0 Mavaen 配置就不说了 发现问题 碰到的问题： http://localhost:8180/web/swagger-ui.html 打开发现不显示 （火狐） 换个ie 发现提示 还一直关不掉，WHAT 什么鬼。于是开始疯狂的百度与google 经过许久时...
基于springMvc4集成Swagger
Jeff_pk的博客
09-13 762
      本人在网上找了很多的关于SpringMvc整合的Swagger博客，但是按照操作或多或少出现一些问题，以下是本人SpringMVC真个好Swagger的具体步骤。      我的整合分为5个步骤，废话不多少，现在开始进入正题。 1.pom.xml文件修改         （1）导入swagger所需要的jar &lt;dependency&gt; ...
57.java项目-activiti实战项目(3)--swagger
weixin_45449911的博客
04-24 532
swagger 1.概况 Swagger 是最流行的 API 开发工具，它遵循 OpenAPI Specification（OpenAPI 规范，也简称 OAS）。 Swagger 可以贯穿于整个 API 生态，如 API 的设计、编写 API 文档、测试和部署。 Swagger 是一种通用的，和编程语言无关的 API 描述规范。 2.应用场景 如果你的 RESTful API 接口都开发完成了，...
IDEA报错之Failed to start bean ‘documentationPluginsBootstrapper‘问题及解决方案
m0_67402235的博客
06-03 1万+
笔者今日创建一个Spring Boot 项目准备做产品，基于IDEA搭建是非常容易的，但是万万没想到，居然一切顺理成章的创建之后，运行报错，非常痛惜，错误截图如下：核心错误： 测试经过：检查之前创建的框架结构，检查各种注解及相关代码，都正常，应该是没有问题的。把之前创建的Swagger2依赖移除，因为就这块代码配置是最后一步，想着从后往前的测试方法检查，至于这是什么，不必多讲，非常出名了，不过我还是喜欢2.7.0旧版，最新的应该2.9.2吧，比较扁平化点。 把依赖和相关的配置代码移除后，运行项目一切正常，看
spring boot 2整合swagger-ui过程解析
08-25
主要介绍了spring boot 2整合swagger-ui过程解析,文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
springboot - 2.7.3版本 - （三）整合Swagger3
09-22
整合完成后，访问`/swagger-ui/index.html`（根据项目配置可能会有所不同），就可以看到Swagger3生成的交互式文档。这个文档清晰地展示了所有API的信息，包括请求方法、URL、描述、参数以及示例，使得前端开发者可以...
spring boot-2.1.16整合swagger-2.9.2 含yml配置文件的代码详解
08-18
Spring Boot 整合 Swagger 2.9.2 含 YAML 配置文件的代码详解 本文主要介绍了如何将 Spring Boot 2.1.16 整合 Swagger 2.9.2，並使用 YAML 配置文件。 Swagger 是一个流行的 API 文档生成工具，可以帮助开发者快速...
spring boot-微服务项目整合框架含Swagger2
06-16
spring boot-微服务项目整合框架含Swagger2-大三下；springboot 2.3.9Released springcloud H...SR10 hystrix zuul swagger2 eureka
spring-boot-starter-swagger：自制的swagger 2.x弹簧启动器，来试试吧，很好用哦〜
01-30
简介 该项目主要利用Spring Boot的自动化配置特性来实现快速的将... < artifactId>swagger-spring-boot-starter < version>1.9.1.RELEASE 注意：从1.6.0开始，我们按Spring Boot官方建议修改了artifactId为swagger
解析jersey client api调用接口出现的A message body reader/writer was not found异常
KONG_S的专栏
06-15 1万+
在项目中使用jesey client api访问接口的时候，出现了2种异常信息。分别如下：com.sun.jersey.api.client.ClientHandlerException: A message body reader for Java class com.xxx.ResultData, and Java type class com.xxx.ResultData, and MIME...
Error creating bean with name的最佳解决方法
热门推荐
空山新雨后，天气晚来秋
09-12 22万+
一招解决你的Error creating bean with name
Failed to start bean ‘documentationPluginsBootstrapper‘
Imp_xingchen的博客
03-09 3317
这个错误是由Springfox的一个bug引起，解决这个问题的方式有多重，最简单的方法就是在配置文件yml中添加spring.mvc.pathmath.matching-strategy: ant_path_matcher即可解决这个问题
Java后端学习日记（五）：Springboot使用@ControllerAdvice捕获和处理异常
Yuc0114的博客
09-27 548
专栏目录 Java后端学习日记（一）：第一个Springboot应用——Hello World! Java后端学习日记（二）：POJO的基本概念，编写，转化和简化 Java后端学习日记（三）：Springboot整合Mybatis-Plus Java后端学习日记（四）：Springboot 2.X 整合Redis作为数据缓存 项目源码同步更新中 前言 作为后端，需要捕获和处理各式各样的异常，比如接口调用方传来了奇葩参数让后端出现异常了，或者说后端的代码逻辑出现错误了，等等。异常的捕获和处理在对前端，对用户
（已解决）Failed to start bean ‘documentationPluginsBootstrapper’
FFFPAG的博客
12-03 2万+
出现原因分析 本人的springboot版本是最新的2.6.1，swagger版本是2.9.2，按着网上的步骤进行环境配置，但在运行时却会出现Failed to start bean ‘documentationPluginsBootstrapper’的问题，在排查了多方原因后，我发现是springboot的版本更新，导致的swagger2的异常 解决方法 （本人的解决方法）在yml中新增配置 application.yml spring: mvc: pathmatch: match
Failed to start bean ‘documentationPluginsBootstrapper‘；解决方法
q1301966496的博客
07-26 806
springboot集成swagger3出现如下错误：Failed to start bean ‘documentationPluginsBootstrapper‘； nested exception 使用的spring-boot版本2.6.1 swagger2和swagger-ui都是2.9.2 在application.properties里配置里添加： spring.mvc.pathmatch.matching-strategy=ANT_PATH_MATCHER 原因： 这是因为Springfox
swagger使用及源码分析
走进技术的世界
09-17 1万+
Swagger 是一个用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。Swagger 让部署管理和使用功能强大的API从未如此简单。 下面会从基本原理、如何使用(基于spring-mvc)、常用注解 、源码分析四个部分进行分析.基本原理web开发过程中，api定义是前后端交互最基本也是最重要的信息，而在实践过程中，往往是更新了代码，而没有来得及更新aip，导致api与代码不对应
springfox 源码分析(五) web配置类Plugin插件的使用
八一菜刀的专栏
10-06 3636
时间：2019-5-23 14:46:50 地点：家中 前言 我们在上一篇文章,通过@EnableSwagger2注解,知道springfox使用开启Plugin注解的配置,注入了很多Plugin的配置类，结合我们第二篇针对Spring Plugin的使用文章介绍,该篇主要探索springfox中的各种不同Plugin的具体作用,以及声明了那些方法 插件 在SpringfoxWebMvc...
Spring Cloud学习笔记——请求合并及实现
notMoonHeart的博客
12-17 1713
一、什么是请求合并  首先先理解请求，请求是客户端发送给服务端的数据要求，指明客户端想要做什么或者想要什么样的数据的一个要求（请求），得到服务端的批准之后，服务端会把相应的客户端想要的数据返回给客户端（我们称之为响应）。举个例子：就是中午吃饭，点餐告诉餐厅你想要什么（这个过程为发送请求），然后餐厅给你端来你想要的东西也有可能是与你想要的不一样的（这个过程为返回响应）。 那么请求合并表面意思就是...
spring-boot-starter-swagger
最新发布
09-02
Spring Boot Starter Swagger是一个用于集成Swagger UI的Spring Boot Starter。Swagger是一个用于构建、文档化和测试RESTful Web服务的开源框架。它提供了一个可视化的界面，可以方便地查看API的信息，包括请求和...

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值