knife4j swagger

Knife4j是swagger的增强方案，可以比swagger更友好地显示接口文档。

接口界面如下：

UI访问地址：http://localhost:80/doc.html

 

 

新建项目 一路next 

项目依赖

<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>knife4j-spring-boot-starter</artifactId>
    <version>2.0.4</version>
</dependency>
<dependency>
    <groupId>io.swagger</groupId>
    <artifactId>swagger-models</artifactId>
    <version>1.5.21</version>
</dependency>
<dependency>
    <groupId>javax.validation</groupId>
    <artifactId>validation-api</artifactId>
    <version>1.1.0.Final</version>
</dependency>

 

配置类  这里加了token认证，如用不到可以忽略

package com.dkx.swagger;

import com.github.xiaoymin.knife4j.spring.annotations.EnableKnife4j;
import io.swagger.annotations.ApiOperation;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Import;
import org.springframework.core.annotation.Order;
import springfox.bean.validators.configuration.BeanValidatorPluginsConfiguration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.ParameterBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.schema.ModelRef;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Parameter;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

import java.util.ArrayList;
import java.util.List;

/**
 * @Author: dkx
 * @Date: 17:41 2021/4/1
 * @Desc:
 */
@Configuration
@EnableKnife4j
@EnableSwagger2
@Import(BeanValidatorPluginsConfiguration.class)
public class SwaggerConfiguration {
        @Bean(value = "posApi")
        @Order(value = 1)
        public Docket groupRestApi() {
            return new Docket(DocumentationType.SWAGGER_2)
                    .apiInfo(groupApiInfo())
                    .globalOperationParameters(getGlobalOperationParameters())
                    .select()
                    .apis(RequestHandlerSelectors.withMethodAnnotation(ApiOperation.class))
                    .paths(PathSelectors.any())
                    .build();
        }

        private ApiInfo groupApiInfo(){
            return new ApiInfoBuilder()
                    .title("POS系统API文档")
                    .description("<div style='font-size:14px;color:red;'>POS系统API文档</div>")
                    .version("1.0")
                    .build();
        }

        private List<Parameter> getGlobalOperationParameters() {
            List<Parameter> pars = new ArrayList<>();
            ParameterBuilder parameterBuilder = new ParameterBuilder();
            parameterBuilder.name("Authorization").description("token").modelRef(new ModelRef("string")).parameterType("header").required(false);
            pars.add(parameterBuilder.build());
            return pars;
        }
}

 

启动项目，访问地址就可以了。。。。