swaggerConfig(add)

pom.xml

@@ -14,7 +14,7 @@
     <name>payment</name>
     <description>Demo project for Spring Boot</description>
     <properties>
-        <java.version>17</java.version>
+        <java.version>1.8</java.version>
     </properties>
     <dependencies>
         <dependency>
@@ -27,6 +27,26 @@
             <artifactId>spring-boot-starter-test</artifactId>
             <scope>test</scope>
         </dependency>
+
+        <dependency>
+            <groupId>com.alibaba</groupId>
+            <artifactId>druid</artifactId>
+            <version>1.2.3</version>
+        </dependency>
+        <dependency>
+            <groupId>mysql</groupId>
+            <artifactId>mysql-connector-java</artifactId>
+            <!--<scope>runtime</scope>-->
+        </dependency>
+
+        <!--swagger-->
+        <dependency>
+            <groupId>com.github.xiaoymin</groupId>
+            <artifactId>knife4j-spring-boot-starter</artifactId>
+            <version>3.0.2</version>
+        </dependency>
+
+
     </dependencies>
 
     <build>

src/main/java/com/mmc/payment/config/SwaggerConfig.java

+package com.mmc.payment.config;
+
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.core.io.ClassPathResource;
+import org.springframework.web.servlet.handler.SimpleUrlHandlerMapping;
+import org.springframework.web.servlet.resource.PathResourceResolver;
+import org.springframework.web.servlet.resource.ResourceHttpRequestHandler;
+import org.springframework.web.util.UrlPathHelper;
+import springfox.documentation.builders.ApiInfoBuilder;
+import springfox.documentation.builders.PathSelectors;
+import springfox.documentation.builders.RequestHandlerSelectors;
+import springfox.documentation.spi.DocumentationType;
+import springfox.documentation.spring.web.plugins.Docket;
+import springfox.documentation.swagger2.annotations.EnableSwagger2WebMvc;
+
+import javax.servlet.ServletContext;
+import java.util.Arrays;
+import java.util.HashMap;
+import java.util.Map;
+
+/**
+ * @Author small
+ * @Date 2023/5/23 17:44
+ * @Version 1.0
+ */
+@Configuration
+@EnableSwagger2WebMvc
+public class SwaggerConfig {
+
+    @Bean(value = "defaultApi2")
+    public Docket defaultApi2() {
+        return new Docket(DocumentationType.SWAGGER_2)
+                .apiInfo(
+                        new ApiInfoBuilder()
+                                .title("产品管理系统API")
+                                .description("产品管理系统API")
+                                .termsOfServiceUrl("")
+                                .version("0.0.1")
+                                .build())
+                // 分组名称
+                .groupName("开发版本")
+                .select()
+                // 这里指定Controller扫描包路径0
+                .apis(RequestHandlerSelectors.basePackage("com.mmc.payment"))
+                .paths(PathSelectors.any())
+                .build();
+    }
+
+    public static final String DEFAULT_PATH = "swagger";
+
+    /**
+     * SwaggerUI资源访问，自定义访问路径前缀
+     *
+     * @param servletContext
+     * @param order
+     * @return
+     * @throws Exception
+     */
+    @Bean
+    public SimpleUrlHandlerMapping swaggerUrlHandlerMapping(
+            ServletContext servletContext, @Value("${swagger.mapping.order:10}") int order)
+            throws Exception {
+        SimpleUrlHandlerMapping urlHandlerMapping = new SimpleUrlHandlerMapping();
+        Map<String, ResourceHttpRequestHandler> urlMap = new HashMap<>();
+        {
+            PathResourceResolver pathResourceResolver = new PathResourceResolver();
+            pathResourceResolver.setAllowedLocations(
+                    new ClassPathResource("META-INF/resources/webjars/"));
+            pathResourceResolver.setUrlPathHelper(new UrlPathHelper());
+
+            ResourceHttpRequestHandler resourceHttpRequestHandler = new ResourceHttpRequestHandler();
+            resourceHttpRequestHandler.setLocations(
+                    Arrays.asList(new ClassPathResource("META-INF/resources/webjars/")));
+            resourceHttpRequestHandler.setResourceResolvers(Arrays.asList(pathResourceResolver));
+            resourceHttpRequestHandler.setServletContext(servletContext);
+            resourceHttpRequestHandler.afterPropertiesSet();
+            // 设置新的路径
+            urlMap.put(DEFAULT_PATH + "/webjars/**", resourceHttpRequestHandler);
+        }
+        {
+            PathResourceResolver pathResourceResolver = new PathResourceResolver();
+            pathResourceResolver.setAllowedLocations(new ClassPathResource("META-INF/resources/"));
+            pathResourceResolver.setUrlPathHelper(new UrlPathHelper());
+
+            ResourceHttpRequestHandler resourceHttpRequestHandler = new ResourceHttpRequestHandler();
+            resourceHttpRequestHandler.setLocations(
+                    Arrays.asList(new ClassPathResource("META-INF/resources/")));
+            resourceHttpRequestHandler.setResourceResolvers(Arrays.asList(pathResourceResolver));
+            resourceHttpRequestHandler.setServletContext(servletContext);
+            resourceHttpRequestHandler.afterPropertiesSet();
+            // 设置新的路径
+            urlMap.put(DEFAULT_PATH + "/**", resourceHttpRequestHandler);
+        }
+        urlHandlerMapping.setUrlMap(urlMap);
+        // 调整DispatcherServlet关于SimpleUrlHandlerMapping的排序
+        urlHandlerMapping.setOrder(order);
+        return urlHandlerMapping;
+    }
+}

src/main/java/com/mmc/payment/controller/SwaggerResourceController.java

+package com.mmc.payment.controller;
+
+import com.mmc.payment.config.SwaggerConfig;
+import org.springframework.beans.factory.InitializingBean;
+import org.springframework.http.ResponseEntity;
+import org.springframework.plugin.core.PluginRegistry;
+import org.springframework.stereotype.Controller;
+import org.springframework.web.bind.annotation.RequestMapping;
+import org.springframework.web.bind.annotation.RequestMethod;
+import org.springframework.web.bind.annotation.RequestParam;
+import org.springframework.web.bind.annotation.ResponseBody;
+import org.springframework.web.servlet.ModelAndView;
+import springfox.documentation.annotations.ApiIgnore;
+import springfox.documentation.spi.DocumentationType;
+import springfox.documentation.spring.web.DocumentationCache;
+import springfox.documentation.spring.web.json.Json;
+import springfox.documentation.spring.web.json.JsonSerializer;
+import springfox.documentation.swagger.web.ApiResourceController;
+import springfox.documentation.swagger.web.SecurityConfiguration;
+import springfox.documentation.swagger.web.SwaggerResource;
+import springfox.documentation.swagger.web.UiConfiguration;
+import springfox.documentation.swagger2.mappers.ServiceModelToSwagger2Mapper;
+import springfox.documentation.swagger2.web.Swagger2ControllerWebMvc;
+import springfox.documentation.swagger2.web.WebMvcSwaggerTransformationFilter;
+
+import javax.servlet.http.HttpServletRequest;
+import java.util.List;
+
+import static org.springframework.http.MediaType.APPLICATION_JSON_VALUE;
+
+/**
+ * @Author small
+ * @Date 2023/5/23 17:44
+ * @Version 1.0
+ */
+@Controller
+@ApiIgnore
+@RequestMapping(SwaggerConfig.DEFAULT_PATH)
+public class SwaggerResourceController implements InitializingBean {
+    private final ApiResourceController apiResourceController;
+    private final DocumentationCache documentationCache;
+    private final ServiceModelToSwagger2Mapper mapper;
+    private final JsonSerializer jsonSerializer;
+    private final PluginRegistry<WebMvcSwaggerTransformationFilter, DocumentationType>
+            transformations;
+    private static final String HAL_MEDIA_TYPE = "application/hal+json";
+    private Swagger2ControllerWebMvc swagger2ControllerWebMvc;
+
+    public SwaggerResourceController(
+            ApiResourceController apiResourceController,
+            DocumentationCache documentationCache,
+            ServiceModelToSwagger2Mapper mapper,
+            JsonSerializer jsonSerializer,
+            PluginRegistry<WebMvcSwaggerTransformationFilter, DocumentationType> transformations) {
+        this.apiResourceController = apiResourceController;
+        this.documentationCache = documentationCache;
+        this.mapper = mapper;
+        this.jsonSerializer = jsonSerializer;
+        this.transformations = transformations;
+    }
+
+    @Override
+    public void afterPropertiesSet() throws Exception {
+        swagger2ControllerWebMvc =
+                new Swagger2ControllerWebMvc(documentationCache, mapper, jsonSerializer, transformations);
+    }
+
+    /**
+     * Swagger API首页地址
+     *
+     * @return 首页地址
+     */
+    @RequestMapping
+    public ModelAndView index() {
+        return new ModelAndView("redirect:" + SwaggerConfig.DEFAULT_PATH + "/doc.html");
+    }
+
+    @RequestMapping("/swagger-resources/configuration/security")
+    @ResponseBody
+    public ResponseEntity<SecurityConfiguration> securityConfiguration() {
+        return apiResourceController.securityConfiguration();
+    }
+
+    @RequestMapping("/swagger-resources/configuration/ui")
+    @ResponseBody
+    public ResponseEntity<UiConfiguration> uiConfiguration() {
+        return apiResourceController.uiConfiguration();
+    }
+
+    @RequestMapping("/swagger-resources")
+    @ResponseBody
+    public ResponseEntity<List<SwaggerResource>> swaggerResources() {
+        return apiResourceController.swaggerResources();
+    }
+
+    @RequestMapping(
+            value = "/v2/api-docs",
+            method = RequestMethod.GET,
+            produces = {APPLICATION_JSON_VALUE, HAL_MEDIA_TYPE})
+    @ResponseBody
+    public ResponseEntity<Json> getDocumentation(
+            @RequestParam(value = "group", required = false) String swaggerGroup,
+            HttpServletRequest servletRequest) {
+        return swagger2ControllerWebMvc.getDocumentation(swaggerGroup, servletRequest);
+    }
+}

src/main/resources/application-dev.yml

+spring:
+  datasource:
+    type: com.alibaba.druid.pool.DruidDataSource
+    driver-class-name: com.mysql.cj.jdbc.Driver
+    url: jdbc:mysql://mysql.default:3306/iuav_pms?characterEncoding=UTF-8&useSSL=false&serverTimezone=Asia/Shanghai
+    username: tmj
+    password: MMC@2022&MYSQL
+  redis:
+    database: 3
+    host: r-wz9ke310fs684hacn1pd.redis.rds.aliyuncs.com
+    port: 6379
+    password: MMC@2022&REDIS
+    jedis:
+      pool:
+        max-active: 2
+
+springfox:
+  documentation:
+    swagger-ui:
+      enabled: false
+    enabled: true #开启文档
+
+aliyun:
+  oss:
+    endpoint: oss-cn-shenzhen.aliyuncs.com
+    access-key-id: LTAI4FzCpyrA33PegnxWS6XV
+    access-key-secret: ILuNh3zJfRjg3iARSipMWBKCjglz3u
+    bucket: pad-video-x
+
+mmcflying:
+  download:
+    path: /ossservlet/upload/download/
+mount:
+  directory: D:@javaVolume@
+
+

src/main/resources/application-local.yml

+spring:
+  datasource:
+    type: com.alibaba.druid.pool.DruidDataSource
+    driver-class-name: com.mysql.cj.jdbc.Driver
+    url: jdbc:mysql://rm-wz9dd796t4j1giz6t2o.mysql.rds.aliyuncs.com:3306/iuav_pms?characterEncoding=UTF-8&useSSL=false&serverTimezone=Asia/Shanghai
+    username: tmj
+    password: MMC@2022&MYSQL
+  redis:
+    database: 3
+    host: r-wz9ke310fs684hacn1.redis.rds.aliyuncs.com
+    port: 6379
+    password: MMC@2022&REDIS
+    jedis:
+      pool:
+        max-active: 2
+
+springfox:
+  documentation:
+    swagger-ui:
+      enabled: false
+    enabled: true #开启文档
+
+aliyun:
+  oss:
+    endpoint: oss-cn-shenzhen.aliyuncs.com
+    access-key-id: LTAI4FzCpyrA33PegnxWS6XV
+    access-key-secret: ILuNh3zJfRjg3iARSipMWBKCjglz3u
+    bucket: pad-video-x
+
+mmcflying:
+  download:
+    path: /ossservlet/upload/download/
+mount:
+  directory: D:@javaVolume@
+
+

src/main/resources/application-prod.yml

+spring:
+  datasource:
+    type: com.alibaba.druid.pool.DruidDataSource
+    driver-class-name: com.mysql.cj.jdbc.Driver
+    url: jdbc:mysql://mysql.default:3306/iuav_pms?characterEncoding=UTF-8&useSSL=false&serverTimezone=Asia/Shanghai
+    username: tmj
+    password: MMC@2022&MYSQL
+  redis:
+    database: 3
+    host: r-wz9ke310fs684hacn1pd.redis.rds.aliyuncs.com
+    port: 6379
+    password: MMC@2022&REDIS
+    jedis:
+      pool:
+        max-active: 2
+
+springfox:
+  documentation:
+    swagger-ui:
+      enabled: false
+    enabled: true #开启文档
+
+aliyun:
+  oss:
+    endpoint: oss-cn-shenzhen.aliyuncs.com
+    access-key-id: LTAI4FzCpyrA33PegnxWS6XV
+    access-key-secret: ILuNh3zJfRjg3iARSipMWBKCjglz3u
+    bucket: pad-video-x
+
+mmcflying:
+  download:
+    path: /ossservlet/upload/download/
+mount:
+  directory: D:@javaVolume@

src/main/resources/application.properties

-

src/main/resources/application.yml

+server:
+  port: 8088
+  servlet:
+    context-path: /payment
+spring:
+  profiles:
+    active: local
+  application:
+    name: payment
+  mvc:
+    async:
+      request-timeout: 600000
+    pathmatch:
+      matching-strategy: ANT_PATH_MATCHER
+  jackson:
+    date-format: yyyy-MM-dd HH:mm:ss
+    time-zone: GMT+8
+logging:
+  level:
+    com:
+      mmc:
+        payment: DEBUG