swagger

选中Dependencies,点上边那个按钮，出现下图 依赖图太小了，根本没法看啊？好办，点击鼠标右键，呼出右键菜单栏，然后点击 Actual Size ： 如果我们仔细观察上图，会发现在项目依赖图中，有一些红色标记的线，实际上，这些红色标记出来的线所指向的 jar 包，就是项目中冲突的 jar 包！且在我们点击 jar 包之后，还会显示出多条指向 jar 包的红色虚线，其代表着该 jar 包被多次引用，及具体引用路径 解决方案 方案1、点击冲突的 jar 包，右键呼出菜单栏，点击 Exclude 选项。 在排除冲突的 jar 包之后， pom.xml 文件会自动更新，添加排除语句。 方案2、排除所有，在外提供一个最高版本的依赖 例如 com.google.guava冲突了 在引入swagger的maven依赖时 <!-- swagger --> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.7.0</version> <exclusions> <exclusion> <groupId>com.google.guava</groupId> <artifactId>guava</artifactId> </exclusion> <

功能 自动的在代码中分析REST接口，生成REST接口描述JSON。这个JSON又可以被客户端生成文档，以及测试用的WEB页。 例如： 我有这么一个接口： @RequestMapping(value="/{name}", method = RequestMethod.GET)@ResponseBodypublic Movie getMovie(@PathVariable String name) swagger加入以后，会自动生成这样的描述： { "apiVersion": "1.0", "swaggerVersion": "1.0", "basePath": "http://localhost:8080", "resourcePath": "/movie", "apis": [ { "path": "/movie/{name}", "description": "", "operations": [ { "httpMethod": "GET", "summary": "get Movie", "notes": "", "deprecated": false, "responseClass": "Movie", "nickname": "getMovie", "parameters": [ { "name": "name", "description": "name",

主要参考： http://blog.zenika.com/index.php?post/2013/07/11/Documenting-a-REST-API-with-Swagger-and-Spring-MVC http://www.3pillarglobal.com/insights/restful-api-documentation-using-swagger-and-spring-mvc 步骤： 先借一个Spring MVC的工程代码 http://www.mkyong.com/spring-mvc/spring-3-rest-hello-world-example/ 修改pom.xml 加入jetty <plugin> <groupId>org.eclipse.jetty</groupId> <artifactId>jetty-maven-plugin</artifactId> <version>9.2.2.v20140723</version> </plugin> mvn jetty:run试下可以跑起来 加入swagger-springmvc <dependency> <groupId>com.mangofactory</groupId> <artifactId>swagger-springmvc</artifactId> <version>0.5.2</version