简介
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;
}
}