Merge pull request #2 from SpringForAll/master

同步一下

Author: larrykoo711

README.md

@@ -1,6 +1,6 @@
 # 简介
 
-[![Build Status](https://travis-ci.org/dyc87112/spring-boot-starter-swagger.svg?branch=master)](https://travis-ci.org/dyc87112/spring-boot-starter-swagger)
+[![Build Status](https://travis-ci.org/dyc87112/spring-boot-starter-swagger.svg?branch=1.5.0)](https://travis-ci.org/dyc87112/spring-boot-starter-swagger)
 
 该项目主要利用Spring Boot的自动化配置特性来实现快速的将swagger2引入spring boot应用来生成API文档，简化原生使用swagger2的整合代码。
 
@@ -9,7 +9,7 @@
   - 码云：https://gitee.com/didispace/spring-boot-starter-swagger
 - 使用样例：https://github.com/dyc87112/swagger-starter-demo
 - 我的博客：http://blog.didispace.com
-- 我们社区：http://spring4all.com
+- 我们社区：http://www.spring4all.com
 
 **小工具一枚，欢迎使用和Star支持，如使用过程中碰到问题，可以提出Issue，我会尽力完善该Starter**
 
@@ -26,12 +26,14 @@
 
 ```xml
 <dependency>
-	<groupId>com.didispace</groupId>
-	<artifactId>spring-boot-starter-swagger</artifactId>
-	<version>1.4.1.RELEASE</version>
+	<groupId>com.spring4all</groupId>
+	<artifactId>swagger-spring-boot-starter</artifactId>
+	<version>1.6.0.RELEASE</version>
 </dependency>
 ```
 
+**注意：从`1.6.0`开始，我们按Spring Boot官方建议修改了artifactId为`swagger-spring-boot-starter`，1.6.0之前的版本不做修改，依然为使用`spring-boot-starter-swagger` !**
+
 - 在应用主类中增加`@EnableSwagger2Doc`注解
 
 ```java
@@ -80,13 +82,24 @@ swagger.globalOperationParameters[1].description=some description two
 swagger.globalOperationParameters[1].modelRef=string
 swagger.globalOperationParameters[1].parameterType=body
 swagger.globalOperationParameters[1].required=false
+
+// 取消使用默认预定义的响应消息,并使用自定义响应消息
+swagger.apply-default-response-messages=false
+swagger.global-response-message.get[0].code=401
+swagger.global-response-message.get[0].message=401get
+swagger.global-response-message.get[1].code=500
+swagger.global-response-message.get[1].message=500get
+swagger.global-response-message.get[1].modelRef=ERROR
+swagger.global-response-message.post[0].code=500
+swagger.global-response-message.post[0].message=500post
+swagger.global-response-message.post[0].modelRef=ERROR
 ```
 
 ## 配置说明
 
 ### 默认配置
 
-```
+```properties
 - swagger.enabled=是否启用swagger，默认：true
 - swagger.title=标题
 - swagger.description=描述
@@ -142,7 +155,7 @@ swagger.exclude-path=/ops/**, /error
 
 具体配置内容如下：
 
-```
+```properties
 - swagger.docket.<name>.title=标题
 - swagger.docket.<name>.description=描述
 - swagger.docket.<name>.version=版本
@@ -190,7 +203,7 @@ swagger.docket.bbb.basePackage=com.yonghui
 
 说明：默认配置与分组配置可以一起使用。在分组配置中没有配置的内容将使用默认配置替代，所以默认配置可以作为分组配置公共部分属性的配置。`swagger.docket.aaa.globalOperationParameters[0].name`会覆盖同名的全局配置。
 
-### JSR-303校验注解支持
+### JSR-303校验注解支持（1.5.0 + 支持）
 
 支持对JSR-303校验注解的展示，如下图所示：
 
@@ -203,7 +216,68 @@ swagger.docket.bbb.basePackage=com.yonghui
 - `@Size`
 - `@Pattern`
 
+### 自定义全局响应消息配置（1.6.0 + 支持）
+
+支持 POST,GET,PUT,PATCH,DELETE,HEAD,OPTIONS,TRACE 全局响应消息配置，配置如下
+
+```properties
+// 取消使用默认预定义的响应消息,并使用自定义响应消息
+swagger.apply-default-response-messages=false
+swagger.global-response-message.get[0].code=401
+swagger.global-response-message.get[0].message=401get
+swagger.global-response-message.get[1].code=500
+swagger.global-response-message.get[1].message=500get
+swagger.global-response-message.get[1].modelRef=ERROR
+swagger.global-response-message.post[0].code=500
+swagger.global-response-message.post[0].message=500post
+swagger.global-response-message.post[0].modelRef=ERROR
+```
+
+### UI功能配置（1.6.0 + 支持）
+
+- 调试按钮的控制(try it out)
+
+```properties
+swagger.ui-config.submit-methods=get,delete
+```
+
+该参数值为提供调试按钮的HTTP请求类型，多个用,分割。
+
+如果不想开启调试功能，只需要如下设置即可：
+
+```properties
+swagger.ui-config.submit-methods=
+```
+
+- 其他配置
+
+```properties
+# json编辑器
+swagger.ui-config.json-editor=false
+# 显示请求头
+swagger.ui-config.show-request-headers=true
+# 页面调试请求的超时时间
+swagger.ui-config.request-timeout=5000
+```
+
+### ignoredParameterTypes配置（1.6.0 + 支持）
+
+```properties
+# 基础配置
+swagger.ignored-parameter-types[0]=com.didispace.demo.User
+swagger.ignored-parameter-types[1]=com.didispace.demo.Product
+
+# 分组配置
+swagger.docket.aaa.ignored-parameter-types[0]=com.didispace.demo.User
+swagger.docket.aaa.ignored-parameter-types[1]=com.didispace.demo.Product
+```
+
+> 该参数作用：
+> Q. Infinite loop when springfox tries to determine schema for objects with nested/complex constraints?
+> A. If you have recursively defined objects, I would try and see if providing an alternate type might work or perhaps even ignoring the offending classes e.g. order using the docket. ignoredParameterTypes(Order.class). This is usually found in Hibernate domain objects that have bidirectional dependencies on other objects.
+
 ## 贡献者
 
 - [程序猿DD-翟永超](https://github.com/dyc87112/)
 - [小火](https://renlulu.github.io/)
+- [泥瓦匠BYSocket](https://github.com/JeffLi1993)

pom.xml

@@ -4,12 +4,12 @@
          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.didispace</groupId>
-    <artifactId>spring-boot-starter-swagger</artifactId>
-    <version>1.4.1.RELEASE</version>
+    <groupId>com.spring4all</groupId>
+    <artifactId>swagger-spring-boot-starter</artifactId>
+    <version>1.6.0.RELEASE</version>
 
     <name>spring-boot-starter-swagger</name>
-    <url>https://github.com/dyc87112/spring-boot-starter-swagger</url>
+    <url>https://github.com/SpringForAll/spring-boot-starter-swagger</url>
     <description>starter for swagger2</description>
 
     <parent>
@@ -27,9 +27,9 @@
     </licenses>
 
     <scm>
-        <url>http://didispace.com</url>
-        <connection>[email protected]:dyc87112/spring-boot-starter-swagger.git</connection>
-        <developerConnection>https://github.com/dyc87112/spring-boot-starter-swagger</developerConnection>
+        <url>http://spring4all.com</url>
+        <connection>[email protected]:SpringForAll/spring-boot-starter-swagger.git</connection>
+        <developerConnection>https://github.com/SpringForAll/spring-boot-starter-swagger</developerConnection>
     </scm>
 
     <developers>
@@ -84,6 +84,11 @@
             <version>1.16.12</version>
             <scope>provided</scope>
         </dependency>
+        <dependency>
+            <groupId>org.springframework.boot</groupId>
+            <artifactId>spring-boot-starter-web</artifactId>
+            <optional>true</optional>
+        </dependency>
     </dependencies>
 
     <dependencyManagement>
@@ -113,4 +118,4 @@
             </plugin>
         </plugins>
     </build>
-</project>
+</project>

src/main/java/com/didispace/swagger/EnableSwagger2Doc.java renamed to src/main/java/com/spring4all/swagger/EnableSwagger2Doc.java

@@ -1,4 +1,4 @@
-package com.didispace.swagger;
+package com.spring4all.swagger;
 
 import org.springframework.context.annotation.Import;
 

src/main/java/com/didispace/swagger/Swagger2Configuration.java renamed to src/main/java/com/spring4all/swagger/Swagger2Configuration.java

@@ -1,4 +1,4 @@
-package com.didispace.swagger;
+package com.spring4all.swagger;
 
 import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
 import org.springframework.context.annotation.Configuration;