生成Api文档不再发愁,Swagger升级版Knife4j来啦

1
2
3
4
    knife4j是为Java MVC框架集成Swagger生成Api文档的增强解决方案,前身是swagger-bootstrap-ui,取名
kni4j是希望她能像一把匕首一样小巧,轻量,并且功能强悍!
    ps:太懒了，直接baidu复制的，hiahia

1
2
3
4
5
6
7
8
	<knife4j.version>3.0.2</knife4j.version>    -->使用同一版本管理的看这里
	
	<dependency>
        <groupId>com.github.xiaoymin</groupId>
        <artifactId>knife4j-spring-boot-starter</artifactId>
        <version>${knife4j.version}</version>
    </dependency>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
	package com.uwooz.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.service.ApiInfo;
	import springfox.documentation.spi.DocumentationType;
	import springfox.documentation.spring.web.plugins.Docket;
	
	
	/**
	* Knife4j配置文件
	**/
	@Configuration
	public class Knife4jConfig {
		@Bean
		public Docket createRestApi() {
		return new Docket(DocumentationType.SWAGGER_2)
			.apiInfo(apiInfo())
			.select()
			.apis(RequestHandlerSelectors.basePackage("com.demo.controller"))
			.paths(PathSelectors.any())
			.build();
	}
	
	
	private ApiInfo apiInfo() {
		return new ApiInfoBuilder()
			.title("标题")
			.version("1.0.0")
			.description("介绍")
			.build();
		}
	}
			

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
package com.uwooz.entity;

import com.baomidou.mybatisplus.annotation.FieldFill;
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId;
import com.uwooz.entity.enums.AdminStateEnum;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import lombok.EqualsAndHashCode;
import lombok.experimental.Accessors;

import java.io.Serializable;
import java.time.LocalDateTime;

/**
 * admin表
 */
@Data
@EqualsAndHashCode(callSuper = false)
@Accessors(chain = true)
@ApiModel(value = "Admin对象", description = "")
public class Admin implements Serializable {

    private static final long serialVersionUID = 1L;

    @ApiModelProperty(value = "管理员表id")
    @TableId(type = IdType.ASSIGN_UUID)
    private String id;

    @ApiModelProperty(value = "用户名")
    private String adminName;

    @ApiModelProperty(value = "密码")
    private String password;

}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
package com.uwooz.controller;

import com.uwooz.common.ApiResult;
import com.uwooz.common.Result;
import com.uwooz.entity.Admin;
import com.uwooz.pojo.dto.admin.AddAdminDTO;
import com.uwooz.pojo.dto.admin.ModifyAdminDTO;
import com.uwooz.service.AdminService;
import com.uwooz.utils.ApiResultUtil;
import com.uwooz.utils.PageBean;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiImplicitParam;
import io.swagger.annotations.ApiImplicitParams;
import io.swagger.annotations.ApiOperation;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import javax.validation.Valid;

/**
 * 管理员
 */
@RestController
@Api(tags = "管理员管理")
@RequestMapping("/admin")
public class AdminController {

    @Autowired
    private AdminService adminService;

    @PostMapping("/save")
    @ApiOperation(value = "新增管理员")
    public Void save(@Valid @RequestBody Admin admin) {
    
    	//本代码只做Knife4j演示作用，不涉及业务
        adminService.addAdmin(admin);
        
    }
    
    @GetMapping("/list")
    @ApiOperation(value = "跟据名称模糊查询管理员列表")
    @ApiImplicitParams({
            @ApiImplicitParam(name = "adminName", value = "管理员名称", dataType = "string"),
    })
    public List<Admin> listByName(String adminName) {
        return adminService.listByName(adminName);
    }
}