1.add swagger for user

luoo_common/src/main/java/entity/ResultVO.java

@@ -44,14 +44,14 @@ public class ResultVO<T>{
 	public void setMessage(String message) {
 		this.message = message;
 	}
-	public Object getData() {
+	public T getData() {
 		return data;
 	}
 	public void setData(T data) {
 		this.data = data;
 	}
 	
-	public static <E> ResultVO<E> success(E data){
+	public static <T> ResultVO<T> success(T data){
 		return new ResultVO<>(true,200,"操作成功", data);
 	}
 

luoo_user/pom.xml

@@ -56,6 +56,27 @@
 		  <groupId>org.springframework.boot</groupId>
 		  <artifactId>spring-boot-starter-actuator</artifactId>
 	  </dependency>
+	  <dependency>
+			<groupId>org.projectlombok</groupId>
+			<artifactId>lombok</artifactId>
+			<optional>true</optional>
+		</dependency>
+		<!--swagger -->
+		<dependency>
+			<groupId>io.springfox</groupId>
+			<artifactId>springfox-swagger2</artifactId>
+			<version>2.9.2</version>
+		</dependency>
+		<dependency>
+			<groupId>com.github.xiaoymin</groupId>
+			<artifactId>swagger-bootstrap-ui</artifactId>
+			<version>1.9.3</version>
+		</dependency>
+		<dependency>
+			<groupId>com.apifan.common</groupId>
+			<artifactId>common-random</artifactId>
+			<version>1.0.21</version>
+		</dependency>
   </dependencies>
 	<build>
 		<finalName>app</finalName>

luoo_user/src/main/java/com/luoo/user/UserApplication.java

@@ -1,18 +1,40 @@
 package com.luoo.user;
+import java.net.InetAddress;
+import java.net.UnknownHostException;
+
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
 import org.springframework.boot.SpringApplication;
 import org.springframework.boot.autoconfigure.SpringBootApplication;
 import org.springframework.cloud.netflix.eureka.EnableEurekaClient;
+import org.springframework.context.ConfigurableApplicationContext;
+import org.springframework.core.env.Environment;
 import org.springframework.context.annotation.Bean;
+import org.springframework.data.jpa.repository.config.EnableJpaAuditing;
 import org.springframework.security.crypto.bcrypt.BCryptPasswordEncoder;
 import util.IdWorker;
 import util.JwtUtil;
 
 @SpringBootApplication
 @EnableEurekaClient
+@EnableJpaAuditing
 public class UserApplication {
-
-	public static void main(String[] args) {
-		SpringApplication.run(UserApplication.class, args);
+	static Logger logger= LoggerFactory.getLogger(UserApplication.class);
+	public static void main(String[] args) throws UnknownHostException {
+		ConfigurableApplicationContext application=SpringApplication.run(UserApplication.class, args);
+		Environment env = application.getEnvironment();
+		logger.info("\n----------------------------------------------------------\n\t" +
+						"Application '{}' is running! Access URLs:\n\t" +
+						"Local: \t\thttp://localhost:{}\n\t" +
+						"External: \thttp://{}:{}\n\t"+
+						"Doc: \thttp://{}:{}/doc.html\n"+
+						"----------------------------------------------------------",
+				env.getProperty("spring.application.name"),
+				env.getProperty("server.port"),
+				InetAddress.getLocalHost().getHostAddress(),
+				env.getProperty("server.port"),
+				InetAddress.getLocalHost().getHostAddress(),
+				env.getProperty("server.port"));
 	}
 
 	@Bean

luoo_user/src/main/java/com/luoo/user/config/InterceptorConfig.java

@@ -4,6 +4,7 @@ import com.luoo.user.interceptor.JwtInterceptor;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.context.annotation.Configuration;
 import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
+import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
 import org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport;
 
 @Configuration
@@ -12,8 +13,19 @@ public class InterceptorConfig extends WebMvcConfigurationSupport {
     @Autowired
     private JwtInterceptor jwtInterceptor;
     protected void addInterceptors(InterceptorRegistry registry) {
+    	String[] excludePathPatterns = { "/user/login/**","/user/appLogin/**","/user/sendsms/**","/doc.html/**","/swagger-resources/**","/webjars/**","/v2/**"};
+    	
         registry.addInterceptor(jwtInterceptor).
                 addPathPatterns("/**").
-                excludePathPatterns("/**/login/**");
+                excludePathPatterns(excludePathPatterns);
+    }
+    
+    @Override
+    protected void addResourceHandlers(ResourceHandlerRegistry registry) {
+        registry.addResourceHandler("doc.html")
+                .addResourceLocations("classpath:/META-INF/resources/");
+        registry.addResourceHandler("/webjars/**")
+                .addResourceLocations("classpath:/META-INF/resources/webjars/");
+        super.addResourceHandlers(registry);
     }
 }

luoo_user/src/main/java/com/luoo/user/swagger/BaseSwaggerConfig.java

@@ -0,0 +1,55 @@
+package com.luoo.user.swagger;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.core.annotation.Order;
+import org.springframework.web.bind.annotation.RequestMethod;
+import springfox.documentation.builders.ApiInfoBuilder;
+import springfox.documentation.builders.PathSelectors;
+import springfox.documentation.builders.RequestHandlerSelectors;
+import springfox.documentation.builders.ResponseMessageBuilder;
+import springfox.documentation.schema.ModelRef;
+import springfox.documentation.service.*;
+import springfox.documentation.spi.DocumentationType;
+import springfox.documentation.spring.web.plugins.Docket;
+import java.util.ArrayList;
+import java.util.List;
+
+public abstract class BaseSwaggerConfig {
+
+    @Bean
+    @Order(value = 1)
+    public Docket createRestApi() {
+        List<ResponseMessage> responseMessageList =new ArrayList<>();
+        responseMessageList.add(new ResponseMessageBuilder().code(200).message("成功").responseModel(new ModelRef("成功")).build());
+        responseMessageList.add(new ResponseMessageBuilder().code(20001).message("失败").responseModel(new ModelRef("失败")).build());
+        responseMessageList.add(new ResponseMessageBuilder().code(20002).message("用户名或密码错误").responseModel(new ModelRef("用户名或密码错误")).build());
+        responseMessageList.add(new ResponseMessageBuilder().code(20003).message("无权访问").responseModel(new ModelRef("无权访问")).build());
+        responseMessageList.add(new ResponseMessageBuilder().code(20009).message("重复提交").responseModel(new ModelRef("重复提交")).build());
+        SwaggerProperties swaggerProperties = swaggerProperties();
+        return new Docket(DocumentationType.SWAGGER_2)
+                .globalResponseMessage(RequestMethod.GET, responseMessageList)
+                .globalResponseMessage(RequestMethod.POST, responseMessageList)
+                .globalResponseMessage(RequestMethod.PUT, responseMessageList)
+                .globalResponseMessage(RequestMethod.DELETE, responseMessageList)
+                .apiInfo(apiInfo(swaggerProperties))
+                .select()
+                .apis(RequestHandlerSelectors.basePackage(swaggerProperties.getApiBasePackage()))
+                .paths(PathSelectors.any())
+                .build();
+    }
+
+    private ApiInfo apiInfo(SwaggerProperties swaggerProperties) {
+        return new ApiInfoBuilder()
+                .title(swaggerProperties.getTitle())
+                .description(swaggerProperties.getDescription())
+                .contact(new Contact(swaggerProperties.getContactName(), swaggerProperties.getContactUrl(), swaggerProperties.getContactEmail()))
+                .version(swaggerProperties.getVersion())
+                .build();
+    }
+
+    /**
+     * 自定义Swagger配置
+     */
+    public abstract SwaggerProperties swaggerProperties();
+
+}

luoo_user/src/main/java/com/luoo/user/swagger/SwaggerConfig.java

@@ -0,0 +1,25 @@
+package com.luoo.user.swagger;
+
+import org.springframework.context.annotation.Configuration;
+
+import com.github.xiaoymin.swaggerbootstrapui.annotations.EnableSwaggerBootstrapUI;
+
+import springfox.documentation.swagger2.annotations.EnableSwagger2;
+
+@Configuration
+@EnableSwagger2
+@EnableSwaggerBootstrapUI
+public class SwaggerConfig extends BaseSwaggerConfig {
+
+    @Override
+    public SwaggerProperties swaggerProperties() {
+        return SwaggerProperties.builder()
+                .apiBasePackage("com.luoo.user.controller")
+                .title("luoo-user API")
+                .description("luoo-user 后端接口文档")
+                .contactName("何长庚")
+                .version("1.0")
+                .enableSecurity(false)
+                .build();
+    }
+}

luoo_user/src/main/java/com/luoo/user/swagger/SwaggerProperties.java

@@ -0,0 +1,47 @@
+package com.luoo.user.swagger;
+
+import lombok.Builder;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+
+/**
+ * Swagger自定义配置
+ * Created by macro on 2020/7/16.
+ */
+@Data
+@EqualsAndHashCode(callSuper = false)
+@Builder
+public class SwaggerProperties {
+    /**
+     * API文档生成基础路径
+     */
+    private String apiBasePackage;
+    /**
+     * 是否要启用登录认证
+     */
+    private boolean enableSecurity;
+    /**
+     * 文档标题
+     */
+    private String title;
+    /**
+     * 文档描述
+     */
+    private String description;
+    /**
+     * 文档版本
+     */
+    private String version;
+    /**
+     * 文档联系人姓名
+     */
+    private String contactName;
+    /**
+     * 文档联系人网址
+     */
+    private String contactUrl;
+    /**
+     * 文档联系人邮箱
+     */
+    private String contactEmail;
+}

luoo_user/src/main/java/com/luoo/user/vo/UserVO.java

@@ -0,0 +1,17 @@
+package com.luoo.user.vo;
+
+import io.swagger.annotations.ApiModel;
+import io.swagger.annotations.ApiModelProperty;
+import lombok.Data;
+@Data
+@ApiModel(value = "用户")
+public class UserVO {
+    @ApiModelProperty(value = "ID")
+    private String id;//ID
+    @ApiModelProperty(value = "昵称",notes="初次登录，随机生成")
+    private String nickname;//昵称
+    @ApiModelProperty(value = "头像",notes="初次登录，默认头像")
+    private String avatar;//头像
+    @ApiModelProperty(value = "TOKEN")
+    private String token;
+}