How to update springboot configuration Swagger3

1. Introduce dependencies, version 3.0.0 only needs to introduce one

<dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-boot-starter</artifactId>
            <version>3.0.0</version>
        </dependency>

2. Configuration class SwaggerConfig

package org.fh.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.oas.annotations.EnableOpenApi;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;

/**
 * 说明：Swagger 接口API生成
 * 作者：FH Admin
 * from fhadmin.cn
 */
@Configuration
@EnableOpenApi
public class SwaggerConfig {

    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.OAS_30)
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.basePackage("org.fh.controller"))    // 为当前包路径
                .paths(PathSelectors.any())
                .build();
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("FH Admin Swagger3 RESTful API")     // 页面标题
                .version("3.0")                                // 版本号
                .description("fhadmin.org")                    // 描述
                .build();
    }

}

3.Swagger interception configuration

package org.fh.config;

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.ViewControllerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

/**
 * 说明：Swagger 拦截配置
 * 作者：FH Admin
 * from fhadmin.cn
 */
@Configuration
public class WebMvcConfig implements WebMvcConfigurer {

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.
                addResourceHandler("/swagger-ui/**")
                .addResourceLocations("classpath:/META-INF/resources/webjars/springfox-swagger-ui/")
                .resourceChain(false);
    }

    @Override
    public void addViewControllers(ViewControllerRegistry registry) {
        registry.addViewController("/swagger-ui/")
                .setViewName("forward:/swagger-ui/index.html");
    }
}

4.访问 127.0.0.1:8081/swagger-ui/index.html

5.接口说明案例

处理类上加注解，比如
@Api("用户注册登录接口")

在方法上加注解，比如
@ApiOperation(value = "登录", notes="校验登录是否成功")
@ApiImplicitParam(name = "KEYDATA", value = "用户名密码混淆码组合", paramType = "query", required = true, dataType = "String")

workflow Module----------------------------------www.fhadmin.cn

1. Model management: web online Process designer, import and export xml, copy process, deploy process

2. Process management: import and export process resource files, view flow charts, reflect process models based on process instances, activate suspension

3. Running process: view process information, current task node, current flow chart, void and pause process, assign to-do person, free jump

4. Historical process: view process information, process time, Process status, view task initiator information

5. To-do tasks: View my personal tasks and tasks under this role, handle, reject, void, and assign an agent

6. Already Handle tasks: Check the tasks you have handled, as well as process information, flow charts, and process status (cancellation and rejection are completed normally)

When handling tasks, you can select users to copy, which means sending an in-site message notification to the person being copied. Current approval opinions and remark information

Note: When the current task is completed, the person to be done with the next task will receive a new task message reminder via instant messaging. When the task is canceled and completed,

The task initiator will receive an in-site message notification

The above is the detailed content of How to update springboot configuration Swagger3. For more information, please follow other related articles on the PHP Chinese website!