springboot 整合 Lkadoc 强大的api接口文档自动生成

Java
344
0
0
2022-09-19
标签   SpringBoot

简介

Lkadoc是一款开源的接口文档自动生成工具,基于SpringBoot平台,拥有非常强大的接口文档管理功能。为解决Java后台开发人员编写接口文档、调试接口而生。同时提供了简洁、大气、功能丰富的接口文档UI操作界面,方便后端与前端之间的接口对接。

愿景

我们愿成为java开发人员最好的基友,从手动编写接口文档的痛苦中解救出来,丢弃难用的Postman,工作效率从此翻倍,不再加班,有更多的时间陪伴家人。

pom.xml文件中引入lkadoc的依赖

<!--Lkadoc包-->
<dependency> 
    <groupId>com.github.liukaitydn</groupId> 
    <artifactId>lkadoc-api</artifactId> 
    <version>1.4.0</version>
</dependency>
<dependency> 
    <groupId>com.github.liukaitydn</groupId> 
    <artifactId>lkadoc-annotations</artifactId> 
    <version>1.4.0</version>
</dependency>

在LkadocDemo项目启动类LkadocDemoApplication上加上@LKADocument注解

/**
 * 说明:启动类
 * 作者:FH Admin
 * from:fhadmin.cn
 */
@LKADocument(basePackages="org.fh.controller")
@SpringBootApplication
public class LkadocDemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(LkadocDemoApplication.class, args);
    }
}

在org.fh.controller包下面准备一个用户登录注册模块类-LKADemoController

/**
 * 说明:用户登录注册
 * 作者:FH Admin
 * from:fhadmin.cn
 */
@LKAType(value="用户登录注册模块")
@RestController
@RequestMapping("user")
public class LKADemoController {

    @LKAMethod(value="登录")
    @LKAParam(names= {"name","pwd"},values= {"用户名","密码"})
    @LKARespose(names= {"code","msg"},values= {"状态码","消息"})
    @PostMapping("login")
    public Map<String,Object> login(String name, String pwd) {
        Map<String,Object> map = new HashMap<>();
        map.put("code",200);
        map.put("msg","登录成功,欢迎"+name+"光临本系统");
        return map;
    }
}

启动项目,打开浏览器,输入地址 127.0.0.1:8080/lkadoc.html