Swagger配置

https://doc.xiaominfo.com/docs/quick-start

一.maven依赖

		<dependency>
			<groupId>com.github.xiaoymin</groupId>
			<artifactId>knife4j-spring-boot-starter</artifactId>
			<version>2.0.9</version>
			<version>4.4.0</version>
		</dependency>

二.增加config配置

package cc.eslink.df.config;

import io.swagger.annotations.ApiOperation;
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.service.ApiInfo;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2WebMvc;

/**
 * Swagger 配置
 * @author wxj
 * @date 2021/7/21 15:11
 **/
@Configuration
@EnableSwagger2WebMvc
public class SwaggerConfiguration {

    @Bean(value = "defaultApi3")
    public Docket defaultApi3() {
        Docket docket=new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .groupName("前置")
                .select()
                .apis(RequestHandlerSelectors.withMethodAnnotation(ApiOperation.class))
                .paths(PathSelectors.any())
                .build();
        return docket;
    }
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("前置在线文档")
                .description("前置在线文档")
                .version("1.0")
                .build();
    }
}

三.修改启动类

package cc.eslink;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.builder.SpringApplicationBuilder;
import org.springframework.boot.web.servlet.support.SpringBootServletInitializer;
import org.springframework.context.ConfigurableApplicationContext;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.FilterType;
import org.springframework.core.env.Environment;

import java.net.InetAddress;
import java.net.UnknownHostException;

/**
 * @author WangXionJun
 */
@SpringBootApplication
public class DataFrontServerApp extends SpringBootServletInitializer {

    private static Logger log = LoggerFactory.getLogger(DataFrontServerApp.class);

    public static void main(String[] args) throws UnknownHostException {
        ConfigurableApplicationContext application=SpringApplication.run(DataFrontServerApp.class, args);
        //Swagger访问路径打印
        Environment env = application.getEnvironment();
        log.info("\n----------------------------------------------------------\n\t" +
                        "Application '{}' is running! Access URLs:\n\t" +
                        "Local: \t\thttp://localhost:{}\n\t" +
                        "External: \thttp://{}:{}\n\t" +
                        "DocHtml: \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"));
    }

    @Override
    protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
        return builder.sources(DataFrontServerApp.class);
    }

}

package cc.eslink.ds.controller.income;

import cc.eslink.common.base.BaseResponse;
import cc.eslink.ds.controller.base.DataScreenBaseController;
import cc.eslink.ds.domain.income.*;
import cc.eslink.ds.dto.income.req.IncomeBaseReq;
import cc.eslink.ds.dto.income.req.WaterMeterReq;
import cc.eslink.ds.dto.income.req.WaterStationTotalReq;
import cc.eslink.ds.dto.income.resp.*;
import cc.eslink.ds.service.IncomeService;
import cc.eslink.util.OrikaUtil;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;

import javax.annotation.Resource;
import java.math.BigDecimal;
import java.util.List;

/**
 * 经营大屏
 *
 * @Author : wxj
 * @Date : 2021/12/29 10:09
 */
@Api(tags = "经营")
@RestController
@RequestMapping("/screen/income")
public class IncomeController extends DataScreenBaseController {

    @Resource
    IncomeService incomeService;

    @ApiOperation(value = "缴费")
    @PostMapping("/paymentMethod")
    public BaseResponse<?> paymentMethod(@Validated IncomeBaseReq req) {
        PaymentMethodDto dto = incomeService.queryPaymentMethod(req);
        return new BaseResponse<>(dto);
    }

}