增加 swagger 包配置和一些接口文档注释

src/main/java/com/ygj/yuemum/component/DruidConfiguration.java

@@ -0,0 +1,60 @@
+package com.ygj.yuemum.component;
+
+import com.alibaba.druid.pool.DruidDataSource;
+import com.alibaba.druid.support.http.StatViewServlet;
+import com.alibaba.druid.support.http.WebStatFilter;
+import org.springframework.boot.autoconfigure.jdbc.DataSourceBuilder;
+import org.springframework.boot.context.properties.ConfigurationProperties;
+import org.springframework.boot.web.servlet.FilterRegistrationBean;
+import org.springframework.boot.web.servlet.ServletRegistrationBean;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.context.annotation.Primary;
+
+import javax.sql.DataSource;
+import java.sql.SQLException;
+
+//@Configuration//在项目启动时可以初始化配置
+public class DruidConfiguration {
+  @Bean
+  public ServletRegistrationBean staViewServlet(){
+    ServletRegistrationBean servletRegistrationBean = new ServletRegistrationBean(new StatViewServlet(),
+        "/druid/*");
+    //白名单为空允许任何ip访问
+    servletRegistrationBean.addInitParameter("allow","127.0.0.1");
+    //ip黑名单(存在共同时，deny优先于allow)：如果满足deny的即提示：Sorry you are not permitted...
+    servletRegistrationBean.addInitParameter("deny","127.0.0.2");
+    //登录查看信息的账号密码
+    servletRegistrationBean.addInitParameter("loginUsername","druid");
+    servletRegistrationBean.addInitParameter("loginPassword","druid");
+    //是否能够重置数据
+    servletRegistrationBean.addInitParameter("resetEnable","true");
+    return servletRegistrationBean;
+  }
+ 
+  @Bean
+  public FilterRegistrationBean statFilter(){
+    FilterRegistrationBean filterRegistrationBean = new FilterRegistrationBean(new WebStatFilter());
+    //添加过滤规则
+    filterRegistrationBean.addUrlPatterns("/*");
+    //添加不需要忽略的格式信息
+    filterRegistrationBean.addInitParameter("exclusions","*.js,*.gif,*.jpn,*.png,*.css,*.ico,/druid/*");
+    return filterRegistrationBean;
+  }
+ 
+  //配置数据库的基本连接信息
+  @Bean
+  @Primary
+  @ConfigurationProperties(prefix = "spring.datasource")//在application.properties中读取配置信息注入到DruidDataSource里
+  public DataSource dataSource(){
+    DruidDataSource druidDataSource = (DruidDataSource) DataSourceBuilder.create().type(DruidDataSource.class).build();
+    druidDataSource.setInitialSize(3);//初始化物理连接的数量
+    try {
+      druidDataSource.addFilters("stat,wall");//stat是sql监控，wall是防火墙(如果不添加则监控无效)，不能添加log4j不然会出错
+    } catch (SQLException e) {
+      e.printStackTrace();
+    }
+    return druidDataSource;
+  }
+ 
+}

src/main/java/com/ygj/yuemum/component/SwaggerConfigure.java

@@ -0,0 +1,191 @@
+package com.ygj.yuemum.component;
+
+import com.fasterxml.classmate.TypeResolver;
+import com.google.common.collect.Multimap;
+import com.ygj.yuemum.dao.swagger.SwaggerDao;
+import com.ygj.yuemum.domain.swagger.ColumnInfo;
+import org.apache.commons.lang.StringUtils;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.boot.ApplicationArguments;
+import org.springframework.boot.ApplicationRunner;
+import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.context.request.async.DeferredResult;
+import springfox.documentation.builders.ParameterBuilder;
+import springfox.documentation.builders.PathSelectors;
+import springfox.documentation.builders.RequestHandlerSelectors;
+import springfox.documentation.schema.Model;
+import springfox.documentation.schema.ModelProperty;
+import springfox.documentation.schema.ModelRef;
+import springfox.documentation.schema.WildcardType;
+import springfox.documentation.service.*;
+import springfox.documentation.spi.DocumentationType;
+import springfox.documentation.spi.service.contexts.SecurityContext;
+import springfox.documentation.spring.web.DocumentationCache;
+import springfox.documentation.spring.web.plugins.Docket;
+import springfox.documentation.swagger.web.ApiKeyVehicle;
+import springfox.documentation.swagger.web.SecurityConfiguration;
+import springfox.documentation.swagger.web.UiConfiguration;
+import springfox.documentation.swagger2.annotations.EnableSwagger2;
+
+import java.lang.reflect.Field;
+import java.lang.reflect.Modifier;
+import java.time.LocalDate;
+import java.util.*;
+
+import static com.google.common.collect.Lists.newArrayList;
+import static springfox.documentation.schema.AlternateTypeRules.newRule;
+
+@Configuration
+@EnableSwagger2
+@ConditionalOnProperty(name = "swagger.enable", havingValue = "true")
+public class SwaggerConfigure implements ApplicationRunner {
+
+    @Bean
+    public Docket petApi() {
+        return new Docket(DocumentationType.SWAGGER_2)
+                .select()
+                .apis(RequestHandlerSelectors.basePackage("com.ygj.yuemum.controller"))
+                .paths(PathSelectors.any())
+                .build()
+                .pathMapping("/")
+                .directModelSubstitute(LocalDate.class,
+                            String.class)
+                .genericModelSubstitutes(ResponseEntity.class)
+                .alternateTypeRules(
+                        newRule(typeResolver.resolve(DeferredResult.class,
+                                typeResolver.resolve(ResponseEntity.class, WildcardType.class)),
+                                typeResolver.resolve(WildcardType.class)))
+                .useDefaultResponseMessages(false)
+//                .globalResponseMessage(RequestMethod.GET,
+//                        newArrayList(new ResponseMessageBuilder()
+//                                .code(500)
+//                                .message("500 message")
+//                                .responseModel(new ModelRef("Error"))
+//                                .build()))
+                .securitySchemes(newArrayList(apiKey()))
+                .securityContexts(newArrayList(securityContext()))
+                .enableUrlTemplating(false)
+                .globalOperationParameters(
+                        newArrayList(new ParameterBuilder()
+                                .name("token")
+                                .description("请求token")
+                                .modelRef(new ModelRef("string"))
+                                .parameterType("query")
+                                .required(false)
+                                .build()))
+                .tags(new Tag("Pet Service", "All apis relating to pets"))
+                ;
+    }
+
+    @Autowired
+    private TypeResolver typeResolver;
+
+    @Autowired
+    private DocumentationCache documentationCache;
+
+    @Autowired
+    private SwaggerDao swaggerDao;
+
+    private ApiKey apiKey() {
+        return new ApiKey("Authorization", "token", "header");
+    }
+
+    private SecurityContext securityContext() {
+        return SecurityContext.builder()
+                .securityReferences(defaultAuth())
+                .forPaths(PathSelectors.regex("/anyPath.*"))
+                .build();
+    }
+
+    List<SecurityReference> defaultAuth() {
+        AuthorizationScope authorizationScope
+                = new AuthorizationScope("global", "accessEverything");
+        AuthorizationScope[] authorizationScopes = new AuthorizationScope[1];
+        authorizationScopes[0] = authorizationScope;
+        return newArrayList(
+                new SecurityReference("Authorization", authorizationScopes));
+    }
+
+    @Bean
+    SecurityConfiguration security() {
+        return new SecurityConfiguration(
+                "test-app-client-id",
+                "test-app-client-secret",
+                "test-app-realm",
+                "test-app",
+                "apiKey",
+                ApiKeyVehicle.HEADER,
+                "api_key",
+                "," /*scope separator*/);
+    }
+
+    @Bean
+    UiConfiguration uiConfig() {
+        return new UiConfiguration(
+                "validatorUrl",// url
+                "none",       // docExpansion          => none | list
+                "alpha",      // apiSorter             => alpha
+                "schema",     // defaultModelRendering => schema
+                UiConfiguration.Constants.DEFAULT_SUBMIT_METHODS,
+                true,        // enableJsonEditor      => true | false
+                true,         // showRequestHeaders    => true | false
+                60000L);      // requestTimeout => in milliseconds, defaults to null (uses jquery xh timeout)
+    }
+
+    @Override
+    public void run(ApplicationArguments applicationArguments) throws Exception{
+        Map<String, String> columnInfo = getTableInfo();
+        Documentation documentation = documentationCache.documentationByGroup(Docket.DEFAULT_GROUP_NAME);
+        Multimap<String, ApiListing> apiListings = documentation.getApiListings();
+        Collection<ApiListing> listings = apiListings.values();
+        for (ApiListing apiListing:listings) {
+            //controller
+            for (ApiDescription apiDescription:apiListing.getApis()) {
+                List<Operation> optionals = apiDescription.getOperations();
+                for (Operation operation:optionals) {
+                    List<Parameter> parameters = operation.getParameters();
+                    for (Parameter parameter:parameters) {
+                        String comment = columnInfo.get(parameter.getName());
+                        if (StringUtils.isNotBlank(comment)) {
+                            Field nameField = Parameter.class.getDeclaredField("description");
+
+                            Field modifiersField = Field.class.getDeclaredField("modifiers"); //①
+                            modifiersField.setAccessible(true);
+                            modifiersField.setInt(nameField, nameField.getModifiers() & ~Modifier.FINAL); //②
+
+                            nameField.setAccessible(true);
+                            nameField.set(parameter, comment);
+                        }
+                    }
+                }
+            }
+            //model
+            for (Model model:apiListing.getModels().values()) {
+                for (ModelProperty modelProperty:model.getProperties().values()) {
+                    String comment = columnInfo.get(modelProperty.getName());
+                    if (StringUtils.isNotBlank(comment)) {
+                        Field nameField = ModelProperty.class.getDeclaredField("description");
+
+                        Field modifiersField = Field.class.getDeclaredField("modifiers"); //①
+                        modifiersField.setAccessible(true);
+                        modifiersField.setInt(nameField, nameField.getModifiers() & ~Modifier.FINAL); //②
+
+                        nameField.setAccessible(true);
+                        nameField.set(modelProperty, comment);
+                    }
+                }
+            }
+        }
+    }
+
+    private Map<String ,String> getTableInfo() {
+        List<String> tableNames = swaggerDao.getTablesName();
+        List<ColumnInfo> columnInfos = swaggerDao.getColumns(tableNames);
+        Map<String, String> columnInfoMap = new HashMap<>();
+        columnInfos.forEach(columnInfo -> columnInfoMap.put(columnInfo.getName(),columnInfo.getComment()));
+        return columnInfoMap;
+    }
+}

src/main/java/com/ygj/yuemum/controller/admin/BranchesController.java

@@ -3,6 +3,7 @@ package com.ygj.yuemum.controller.admin;
 
 import com.ygj.yuemum.domain.admin.Branches;
 import com.ygj.yuemum.service.admin.BranchesService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestParam;
@@ -10,6 +11,7 @@ import org.springframework.web.bind.annotation.RestController;
 
 import java.util.List;
 
+@Api(value = "门店信息")
 @RestController
 public class BranchesController {
 

src/main/java/com/ygj/yuemum/controller/admin/CertificateController.java

@@ -3,11 +3,13 @@ package com.ygj.yuemum.controller.admin;
 
 import com.ygj.yuemum.service.admin.CertificateService;
 import com.ygj.yuemum.domain.admin.Certificate;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
 
+@Api(tags = "证书相关接口")
 @RestController
 public class CertificateController {
 

src/main/java/com/ygj/yuemum/controller/admin/ConstellationController.java

@@ -3,12 +3,13 @@ package com.ygj.yuemum.controller.admin;
 
 import com.ygj.yuemum.domain.admin.Constellation;
 import com.ygj.yuemum.service.admin.ConstellationService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RestController;
 
 import java.util.List;
-
+@Api(tags = "星座相关接口")
 @RestController
 public class ConstellationController {
 

src/main/java/com/ygj/yuemum/controller/admin/ImageUploadController.java

@@ -10,6 +10,7 @@ import com.ygj.yuemum.service.admin.PhotoService;
 import com.ygj.yuemum.service.admin.ResumeService;
 import com.ygj.yuemum.service.maternitymatron.JlServiceUserService;
 import com.ygj.yuemum.service.pay.CustomerPayVoucherService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.core.io.ResourceLoader;
 import org.springframework.util.ResourceUtils;
@@ -23,7 +24,7 @@ import java.text.SimpleDateFormat;
 import java.util.Date;
 import java.util.List;
 
-
+@Api(tags = "图片、简历相关接口")
 @RestController
 public class ImageUploadController {
     @Autowired

src/main/java/com/ygj/yuemum/controller/admin/JlAdminPermissionController.java

@@ -2,16 +2,17 @@ package com.ygj.yuemum.controller.admin;
 
 
 import com.ygj.yuemum.service.admin.JlAdminPermissionService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
-
+@Api(tags = "权限相关接口")
 @RestController
 public class JlAdminPermissionController {
 
     @Autowired
-    private JlAdminPermissionService jlAdminPermissionService;
+    private JlAdminPermissionService jlAdminPermissionService   ;
     @GetMapping("/getAdminPermission")
     public String getAdminPermission(@RequestParam("rolename") Integer rolename) {
         String jso = jlAdminPermissionService.getAdminPermission(rolename);

src/main/java/com/ygj/yuemum/controller/admin/JlAdminRoleController.java

@@ -4,12 +4,13 @@ package com.ygj.yuemum.controller.admin;
 import com.alibaba.fastjson.JSONObject;
 import com.ygj.yuemum.domain.admin.JlAdminRole;
 import com.ygj.yuemum.service.admin.JlAdminRoleService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
 import java.util.Map;
-
+@Api(tags = "角色相关接口")
 @RestController
 public class JlAdminRoleController {
 

src/main/java/com/ygj/yuemum/controller/admin/JlAdminRolePermissionController.java

@@ -2,11 +2,12 @@ package com.ygj.yuemum.controller.admin;
 
 
 import com.ygj.yuemum.service.admin.JlAdminRolePermissionService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
-
+@Api(tags = "角色权限关联相关接口")
 @RestController
 public class JlAdminRolePermissionController {
 

src/main/java/com/ygj/yuemum/controller/admin/JlAdminUserController.java

@@ -3,6 +3,7 @@ package com.ygj.yuemum.controller.admin;
 import com.alibaba.fastjson.JSONObject;
 import com.ygj.yuemum.domain.admin.JlAdminUser;
 import com.ygj.yuemum.service.admin.JlAdminUserService;
+import io.swagger.annotations.Api;
 import org.apache.shiro.SecurityUtils;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
@@ -10,7 +11,7 @@ import org.springframework.web.bind.annotation.*;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
-
+@Api(tags = "管理员相关接口")
 @RestController
 public class JlAdminUserController {
 

src/main/java/com/ygj/yuemum/controller/admin/JlEthnicgroupController.java

@@ -3,12 +3,13 @@ package com.ygj.yuemum.controller.admin;
 
 import com.ygj.yuemum.domain.admin.JlEthnicgroup;
 import com.ygj.yuemum.service.admin.JlEthnicgroupService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RestController;
 
 import java.util.List;
-
+@Api(tags = "民族相关接口")
 @RestController
 public class JlEthnicgroupController {
 

src/main/java/com/ygj/yuemum/controller/admin/JlRegionController.java

@@ -5,6 +5,7 @@ import com.alibaba.fastjson.JSONObject;
 import com.ygj.yuemum.domain.admin.JlRegion;
 import com.ygj.yuemum.service.admin.JlRegionService;
 import com.ygj.yuemum.utils.IDcard;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestParam;
@@ -13,7 +14,7 @@ import org.springframework.web.bind.annotation.RestController;
 import java.util.HashMap;
 import java.util.List;
 import java.util.Map;
-
+@Api(tags = "省份相关接口")
 @RestController
 public class JlRegionController {
 

src/main/java/com/ygj/yuemum/controller/admin/JlServiceUserLogController.java

@@ -4,11 +4,12 @@ package com.ygj.yuemum.controller.admin;
 import com.alibaba.fastjson.JSONObject;
 import com.ygj.yuemum.domain.admin.JlServiceUserLog;
 import com.ygj.yuemum.service.admin.JlServiceUserLogService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.Map;
-
+@Api(tags = "操作相关接口")
 @RestController
 public class JlServiceUserLogController {
 

src/main/java/com/ygj/yuemum/controller/admin/PhotoController.java

@@ -3,11 +3,12 @@ package com.ygj.yuemum.controller.admin;
 
 import com.ygj.yuemum.domain.admin.Photo;
 import com.ygj.yuemum.service.admin.PhotoService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
-
+@Api(tags = "照片相关接口")
 @RestController
 public class PhotoController {
 

src/main/java/com/ygj/yuemum/controller/admin/ResumeController.java

@@ -3,11 +3,12 @@ package com.ygj.yuemum.controller.admin;
 
 import com.ygj.yuemum.domain.admin.Resume;
 import com.ygj.yuemum.service.admin.ResumeService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
-
+@Api(tags = "简历相关接口")
 @RestController
 public class ResumeController {
 

src/main/java/com/ygj/yuemum/controller/admin/TrainController.java

@@ -4,12 +4,13 @@ package com.ygj.yuemum.controller.admin;
 import com.alibaba.fastjson.JSONObject;
 import com.ygj.yuemum.domain.admin.Train;
 import com.ygj.yuemum.service.admin.TrainService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
 import java.util.Map;
-
+@Api(tags = "培训相关接口")
 @RestController
 public class TrainController {
 

src/main/java/com/ygj/yuemum/controller/admin/ZodiacController.java

@@ -3,12 +3,13 @@ package com.ygj.yuemum.controller.admin;
 
 import com.ygj.yuemum.domain.admin.Zodiac;
 import com.ygj.yuemum.service.admin.ZodiacService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RestController;
 
 import java.util.List;
-
+@Api(tags = "属相相关接口")
 @RestController
 public class ZodiacController {
 

src/main/java/com/ygj/yuemum/controller/bizobject/BizObjectController.java

@@ -2,11 +2,13 @@ package com.ygj.yuemum.controller.bizobject;
 
 
 import com.ygj.yuemum.service.bizobject.BizObjectApiService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
 
+@Api(tags = "加载氚云信息接口")
 @RestController
 public class BizObjectController {
 

src/main/java/com/ygj/yuemum/controller/coupon/CouponBatchController.java

@@ -5,12 +5,14 @@ import com.alibaba.fastjson.JSONObject;
 import com.ygj.yuemum.domain.coupon.CouponBatch;
 import com.ygj.yuemum.service.coupon.CouponBatchService;
 import com.ygj.yuemum.service.coupon.CouponCreateService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
 import java.util.Map;
 
+@Api(tags = "代金券组相关接口")
 @RestController
 public class CouponBatchController {
 

src/main/java/com/ygj/yuemum/controller/coupon/CouponController.java

@@ -4,12 +4,13 @@ package com.ygj.yuemum.controller.coupon;
 import com.alibaba.fastjson.JSONObject;
 import com.ygj.yuemum.domain.coupon.Coupon;
 import com.ygj.yuemum.service.coupon.CouponService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
 import java.util.Map;
-
+@Api(tags = "代金券相关接口")
 @RestController
 public class CouponController {
 

src/main/java/com/ygj/yuemum/controller/coupon/CouponCreateController.java

@@ -4,12 +4,13 @@ package com.ygj.yuemum.controller.coupon;
 import com.alibaba.fastjson.JSONObject;
 import com.ygj.yuemum.domain.coupon.CouponCreate;
 import com.ygj.yuemum.service.coupon.CouponCreateService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
 import java.util.Map;
-
+@Api(tags = "代金券创建相关接口")
 @RestController
 public class CouponCreateController {
 

src/main/java/com/ygj/yuemum/controller/coupon/CouponLogController.java

@@ -4,12 +4,13 @@ package com.ygj.yuemum.controller.coupon;
 import com.alibaba.fastjson.JSONObject;
 import com.ygj.yuemum.domain.coupon.CouponLog;
 import com.ygj.yuemum.service.coupon.CouponLogService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
 import java.util.Map;
-
+@Api(tags = "代金券日志相关接口")
 @RestController
 public class CouponLogController {
 

src/main/java/com/ygj/yuemum/controller/customer/CustomerBookingController.java

@@ -4,12 +4,13 @@ package com.ygj.yuemum.controller.customer;
 import com.alibaba.fastjson.JSONObject;
 import com.ygj.yuemum.domain.customer.CustomerBooking;
 import com.ygj.yuemum.service.customer.CustomerBookingService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
 import java.util.Map;
-
+@Api(tags = "客户预约相关接口")
 @RestController
 public class CustomerBookingController {
 

src/main/java/com/ygj/yuemum/controller/customer/CustomerCouponController.java

@@ -6,12 +6,13 @@ import com.ygj.yuemum.domain.customer.CustomerCoupon;
 import com.ygj.yuemum.domain.customer.CustomerCouponQuery;
 import com.ygj.yuemum.domain.customer.CustomerCouponUpdate;
 import com.ygj.yuemum.service.customer.CustomerCouponService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
 import java.util.Map;
-
+@Api(tags = "客户代金券相关接口")
 @RestController
 public class CustomerCouponController {
 

src/main/java/com/ygj/yuemum/controller/distributionchannel/DcIntroduceExtractController.java

@@ -4,12 +4,13 @@ package com.ygj.yuemum.controller.distributionchannel;
 import com.alibaba.fastjson.JSONObject;
 import com.ygj.yuemum.domain.distributionchannel.DcIntroducerExtract;
 import com.ygj.yuemum.service.distributionchannel.DcIntroducerExtractService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
 import java.util.Map;
-
+@Api(tags = "介绍提现相关接口")
 @RestController
 public class DcIntroduceExtractController {
 

src/main/java/com/ygj/yuemum/controller/distributionchannel/DcIntroduceLogController.java

@@ -5,12 +5,13 @@ import com.alibaba.fastjson.JSONObject;
 import com.ygj.yuemum.domain.distributionchannel.DcIntroduceLog;
 import com.ygj.yuemum.domain.distributionchannel.DcQueryReport;
 import com.ygj.yuemum.service.distributionchannel.DcIntroduceLogService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
 import java.util.Map;
-
+@Api(tags = "介绍日志相关接口")
 @RestController
 public class DcIntroduceLogController {
 

src/main/java/com/ygj/yuemum/controller/distributionchannel/DcIntroducerApplicantController.java

@@ -5,11 +5,12 @@ import com.alibaba.fastjson.JSONObject;
 import com.ygj.yuemum.domain.distributionchannel.DcIntroducerApplicant;
 import com.ygj.yuemum.service.distributionchannel.DcIntroducerApplicantService;
 import com.ygj.yuemum.service.wxmini.WXUserService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.Map;
-
+@Api(tags = "介绍审核相关接口")
 @RestController
 public class DcIntroducerApplicantController {
 

src/main/java/com/ygj/yuemum/controller/distributionchannel/DcIntroducerController.java

@@ -4,12 +4,13 @@ package com.ygj.yuemum.controller.distributionchannel;
 import com.alibaba.fastjson.JSONObject;
 import com.ygj.yuemum.domain.distributionchannel.DcIntroducer;
 import com.ygj.yuemum.service.distributionchannel.DcIntroducerService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
 import java.util.Map;
-
+@Api(tags = "介绍人信息相关接口")
 @RestController
 public class DcIntroducerController {
 

src/main/java/com/ygj/yuemum/controller/distributionchannel/DcIntroducerRelationController.java

@@ -3,9 +3,10 @@ package com.ygj.yuemum.controller.distributionchannel;
 
 import com.ygj.yuemum.domain.distributionchannel.DcIntroducerRelation;
 import com.ygj.yuemum.service.distributionchannel.DcIntroducerRelationService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
-
+@Api(tags = "介绍人关联相关接口")
 @RestController
 public class DcIntroducerRelationController {
 

src/main/java/com/ygj/yuemum/controller/equipment/EquipmentInfoController.java

@@ -4,12 +4,13 @@ package com.ygj.yuemum.controller.equipment;
 import com.alibaba.fastjson.JSONObject;
 import com.ygj.yuemum.domain.equipment.EquipmentInfo;
 import com.ygj.yuemum.service.equipment.EquipmentInfoService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
 import java.util.Map;
-
+@Api(tags = "设备类型相关接口")
 @RestController
 public class EquipmentInfoController {
 

src/main/java/com/ygj/yuemum/controller/equipment/EquipmentLogController.java

@@ -4,13 +4,14 @@ package com.ygj.yuemum.controller.equipment;
 import com.alibaba.fastjson.JSONObject;
 import com.ygj.yuemum.domain.equipment.EquipmentLog;
 import com.ygj.yuemum.service.equipment.EquipmentLogService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.ModelAttribute;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RestController;
 
 import java.util.Map;
-
+@Api(tags = "设备编号相关接口")
 @RestController
 public class EquipmentLogController {
 

src/main/java/com/ygj/yuemum/controller/equipment/EquipmentReturnController.java

@@ -3,11 +3,12 @@ package com.ygj.yuemum.controller.equipment;
 
 import com.ygj.yuemum.domain.equipment.EquipmentReturn;
 import com.ygj.yuemum.service.equipment.EquipmentReturnService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
-
+@Api(tags = "设备返还相关接口")
 @RestController
 public class EquipmentReturnController {
 

src/main/java/com/ygj/yuemum/controller/equipment/EquipmentTypeController.java

@@ -3,13 +3,14 @@ package com.ygj.yuemum.controller.equipment;
 
 import com.ygj.yuemum.domain.equipment.EquipmentType;
 import com.ygj.yuemum.service.equipment.EquipmentTypeService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
 
 import java.util.List;
-
+@Api(tags = "设备类型相关接口")
 @RestController
 public class EquipmentTypeController {
 

src/main/java/com/ygj/yuemum/controller/equipment/EquipmenteHireDetailController.java

@@ -4,12 +4,13 @@ package com.ygj.yuemum.controller.equipment;
 import com.alibaba.fastjson.JSONObject;
 import com.ygj.yuemum.domain.equipment.EquipmenteHireDetail;
 import com.ygj.yuemum.service.equipment.EquipmenteHireDetailService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
 import java.util.Map;
-
+@Api(tags = "设备租赁相关接口")
 @RestController
 public class EquipmenteHireDetailController {
 

src/main/java/com/ygj/yuemum/controller/equipment/EquipmenteHireHeadController.java

@@ -4,11 +4,12 @@ package com.ygj.yuemum.controller.equipment;
 import com.alibaba.fastjson.JSONObject;
 import com.ygj.yuemum.domain.equipment.EquipmenteHireHead;
 import com.ygj.yuemum.service.equipment.EquipmenteHireHeadService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.Map;
-
+@Api(tags = "设备租赁顾客相关接口")
 @RestController
 public class EquipmenteHireHeadController {
 

src/main/java/com/ygj/yuemum/controller/global/WeChatInfoController.java

@@ -3,12 +3,13 @@ package com.ygj.yuemum.controller.global;
 
 import com.ygj.yuemum.domain.customer.CustomerBooking;
 import com.ygj.yuemum.service.global.WeChatInfoService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
 import java.io.IOException;
 import java.util.Map;
-
+@Api(tags = "微信相关接口")
 @RestController
 public class WeChatInfoController {
 

src/main/java/com/ygj/yuemum/controller/ocr/BaiDuInfoController.java

@@ -1,10 +1,12 @@
 package com.ygj.yuemum.controller.ocr;
 
 import com.ygj.yuemum.service.ocr.BaiDuInfoServices;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 import org.springframework.web.multipart.MultipartFile;
 
+@Api(tags = "百度验证信息")
 @RestController
 public class BaiDuInfoController {
     @Autowired

src/main/java/com/ygj/yuemum/controller/order/YSOrderController.java

@@ -5,12 +5,13 @@ import com.alibaba.fastjson.JSONObject;
 import com.ygj.yuemum.domain.order.YSOrder;
 import com.ygj.yuemum.domain.order.YSOrderServiceLog;
 import com.ygj.yuemum.service.order.YSOrderService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
 import java.util.Map;
-
+@Api(tags = "月嫂订单相关接口")
 @RestController
 public class YSOrderController {
 

src/main/java/com/ygj/yuemum/controller/order/YSOrderReturnController.java

@@ -3,9 +3,10 @@ package com.ygj.yuemum.controller.order;
 
 import com.ygj.yuemum.domain.order.YSOrderReturn;
 import com.ygj.yuemum.service.order.YSOrderReturnService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
-
+@Api(tags = "月嫂退单相关接口")
 @RestController
 public class YSOrderReturnController {
 

src/main/java/com/ygj/yuemum/controller/order/YSOrderServiceLogController.java

@@ -3,13 +3,14 @@ package com.ygj.yuemum.controller.order;
 
 import com.alibaba.fastjson.JSONObject;
 import com.ygj.yuemum.service.order.YSOrderServiceLogService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
 
 import java.util.Map;
-
+@Api(tags = "月嫂服务日志相关接口")
 @RestController
 public class YSOrderServiceLogController {
 

src/main/java/com/ygj/yuemum/controller/pay/CustomerPayController.java

@@ -3,11 +3,12 @@ package com.ygj.yuemum.controller.pay;
 
 import com.ygj.yuemum.domain.pay.CustomerPay;
 import com.ygj.yuemum.service.pay.CustomerPayService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
-
+@Api(tags = "支付订单相关接口")
 @RestController
 public class CustomerPayController {
 

src/main/java/com/ygj/yuemum/controller/pay/DiscountChannelController.java

@@ -3,12 +3,13 @@ package com.ygj.yuemum.controller.pay;
 
 import com.ygj.yuemum.domain.pay.DiscountChannel;
 import com.ygj.yuemum.service.pay.DiscountChannelService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RestController;
 
 import java.util.List;
-
+@Api(tags = "支付渠道相关接口")
 @RestController
 public class DiscountChannelController {
 

src/main/java/com/ygj/yuemum/controller/pay/PayMentsController.java

@@ -3,12 +3,13 @@ package com.ygj.yuemum.controller.pay;
 
 import com.ygj.yuemum.domain.pay.PayMents;
 import com.ygj.yuemum.service.pay.PayMentsService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RestController;
 
 import java.util.List;
-
+@Api(tags = "支付配置相关接口")
 @RestController
 public class PayMentsController {
 

src/main/java/com/ygj/yuemum/controller/promotion/PromotionDCController.java

@@ -3,13 +3,14 @@ package com.ygj.yuemum.controller.promotion;
 
 import com.ygj.yuemum.domain.promotion.PromotionDC;
 import com.ygj.yuemum.service.promotion.PromotionDCService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
 
 import java.util.List;
-
+@Api(tags = "活动相关接口")
 @RestController
 public class PromotionDCController {
 

src/main/java/com/ygj/yuemum/controller/promotion/PromotionDCUserInfoController.java

@@ -4,13 +4,14 @@ package com.ygj.yuemum.controller.promotion;
 import com.alibaba.fastjson.JSONObject;
 import com.ygj.yuemum.domain.promotion.PromotionDCUserInfo;
 import com.ygj.yuemum.service.promotion.PromotionDCUserInfoService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.ModelAttribute;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RestController;
 
 import java.util.Map;
-
+@Api(tags = "活动参与人相关接口")
 @RestController
 public class PromotionDCUserInfoController {
 

src/main/java/com/ygj/yuemum/controller/promotion/PromotionOfflineController.java

@@ -4,12 +4,13 @@ package com.ygj.yuemum.controller.promotion;
 import com.alibaba.fastjson.JSONObject;
 import com.ygj.yuemum.domain.promotion.PromotionOffline;
 import com.ygj.yuemum.service.promotion.PromotionOfflineService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
 
 import java.util.List;
 import java.util.Map;
-
+@Api(tags = "线下活动相关接口")
 @RestController
 public class PromotionOfflineController {
 

src/main/java/com/ygj/yuemum/controller/promotion/PromotionTestController.java

@@ -5,13 +5,14 @@ import com.ygj.yuemum.domain.promotion.PromotionDC;
 import com.ygj.yuemum.domain.promotion.PromotionTest;
 import com.ygj.yuemum.service.promotion.PromotionDCService;
 import com.ygj.yuemum.service.promotion.PromotionTestService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
 
 import java.util.List;
-
+@Api(tags = "活动问卷相关接口")
 @RestController
 public class PromotionTestController {
 

src/main/java/com/ygj/yuemum/controller/promotion/PromotionTestResultController.java

@@ -3,13 +3,14 @@ package com.ygj.yuemum.controller.promotion;
 
 import com.ygj.yuemum.domain.promotion.PromotionTestResult;
 import com.ygj.yuemum.service.promotion.PromotionTestResultService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
 
 import java.util.List;
-
+@Api(tags = "活动问卷结果相关接口")
 @RestController
 public class PromotionTestResultController {
 

src/main/java/com/ygj/yuemum/controller/promotion/PromotionTestResultShowController.java

@@ -3,13 +3,14 @@ package com.ygj.yuemum.controller.promotion;
 
 import com.ygj.yuemum.domain.promotion.PromotionTestResultShow;
 import com.ygj.yuemum.service.promotion.PromotionTestResultShowService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.GetMapping;
 import org.springframework.web.bind.annotation.RequestParam;
 import org.springframework.web.bind.annotation.RestController;
 
 import java.util.List;
-
+@Api(tags = "活动展示相关接口")
 @RestController
 public class PromotionTestResultShowController {
 

src/main/java/com/ygj/yuemum/controller/promotion/PromotionTestUserScoreController.java

@@ -4,9 +4,10 @@ package com.ygj.yuemum.controller.promotion;
 import com.ygj.yuemum.domain.promotion.PromotionTestUserScore;
 import com.ygj.yuemum.domain.promotion.PromotionUserInfo;
 import com.ygj.yuemum.service.promotion.PromotionTestUserScoreService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.*;
-
+@Api(tags = "活动测评结果关接口")
 @RestController
 public class PromotionTestUserScoreController {
 

src/main/java/com/ygj/yuemum/controller/promotion/PromotionUserInfoController.java

@@ -4,13 +4,14 @@ package com.ygj.yuemum.controller.promotion;
 import com.alibaba.fastjson.JSONObject;
 import com.ygj.yuemum.domain.promotion.PromotionUserInfo;
 import com.ygj.yuemum.service.promotion.PromotionUserInfoService;
+import io.swagger.annotations.Api;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.ModelAttribute;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RestController;
 
 import java.util.Map;
-
+@Api(tags = "活动问卷结果相关接口")
 @RestController
 public class PromotionUserInfoController {
 

src/main/java/com/ygj/yuemum/controller/swagger/SwaggerController.java

@@ -0,0 +1,14 @@
+package com.ygj.yuemum.controller.swagger;
+
+import org.springframework.stereotype.Controller;
+import org.springframework.web.bind.annotation.RequestMapping;
+
+@Controller
+public class SwaggerController {
+
+    @RequestMapping("/swagger")
+    public String getSwaggerHtml() {
+        return "swagger-ui";
+    }
+
+}

src/main/java/com/ygj/yuemum/dao/swagger/SwaggerDao.java

@@ -0,0 +1,14 @@
+package com.ygj.yuemum.dao.swagger;
+
+import com.ygj.yuemum.domain.swagger.ColumnInfo;
+import org.springframework.stereotype.Repository;
+
+import java.util.List;
+
+@Repository
+public interface SwaggerDao {
+
+    List<String> getTablesName();
+
+    List<ColumnInfo> getColumns(List<String> list);
+}

src/main/java/com/ygj/yuemum/domain/swagger/ColumnInfo.java

@@ -0,0 +1,23 @@
+package com.ygj.yuemum.domain.swagger;
+
+public class ColumnInfo {
+
+    private String name;
+    private String comment;
+
+    public String getName() {
+        return name;
+    }
+
+    public void setName(String name) {
+        this.name = name;
+    }
+
+    public String getComment() {
+        return comment;
+    }
+
+    public void setComment(String comment) {
+        this.comment = comment;
+    }
+}

src/main/java/com/ygj/yuemum/shiro/ShiroConfig.java

@@ -42,6 +42,19 @@ public class ShiroConfig {
         // 设置拦截器
         Map<String, String> filterChainDefinitionMap = new LinkedHashMap<>();
 
+        //druid
+        filterChainDefinitionMap.put("/druid/login.html", "anon");
+        filterChainDefinitionMap.put("/druid/**", "anon");
+
+
+        //swagger
+        filterChainDefinitionMap.put("/swagger-ui.html", "anon");
+        filterChainDefinitionMap.put("/swagger-resources", "anon");
+        filterChainDefinitionMap.put("/swagger-resources/**", "anon");
+        filterChainDefinitionMap.put("/v2/api-docs", "anon");
+        filterChainDefinitionMap.put("/webjars/springfox-swagger-ui/**", "anon");
+        filterChainDefinitionMap.put("/swagger", "anon");
+
         //小程序开放权限
         filterChainDefinitionMap.put("/addEquipmenteHireDetail", "anon");
         filterChainDefinitionMap.put("/addEquipmenteHireHeadOnline", "anon");

src/main/resources/application.yml

@@ -154,6 +154,8 @@ college:
   LMP: 43
   AGE: 12
   MAXSCHOLARSHIPS: 12000
+swagger:
+  enable: false
 
 
 

src/main/resources/mybatis/mapper/swagger/SwaggerMapper.xml

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8" ?>
+<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd" >
+<mapper namespace="com.ygj.yuemum.dao.swagger.SwaggerDao" >
+
+    <!--获取所有表名-->
+    <select id="getTablesName" resultType="java.lang.String">
+        SELECT
+            table_name
+        FROM
+            information_schema. TABLES
+        WHERE
+            table_schema = 'yuemum'
+        AND table_type = 'base table';
+    </select>
+
+    <select id="getColumns" resultType="com.ygj.yuemum.domain.swagger.ColumnInfo">
+        SELECT
+            column_name as name,
+            column_comment as comment
+        FROM
+            information_schema.COLUMNS
+        WHERE
+            table_name in
+        <foreach item="item" index="index" collection="list"
+                 open="(" separator="," close=")">
+            #{item}
+        </foreach>
+    </select>
+
+</mapper>