规则
注意点: 良好的java doc 注释能生成更好的文档
1:插件如何生成属性备注 ,通过获得字段备注中的注释
/** * 年龄 */ private Integer age;
2:插件如何生成接口名称,通过接口上的注释,或者引用上的 注释
/**
* 通过ID查询
* @param id ID主键
* @return SysDept 部门信息
*/
@GetMapping("/{id}")
public R<SysDept> getById(@PathVariable Integer id) {
return R.ok();
}
3:Controller
/**
*@description 描述
*@menu 测试主页面(在yapi上面生成菜单)
*/
@RestController
public class UserController {
}
4:推荐生成注释插件(默认配置)
查看翻译不是太好,注意修改,只是生成规则
https://gitee.com/starcwang/easy_javadoc
idea商城中可以搜索easy_javadoc
5:idea配置模版
1.类上可以不用配置,但是Controller记得加@menu
方法上
/** * TODO 添加的注释吧。 * @Param: $param$ * @Return: $return$ * @Author: 自己的花名 * @Date: $data$ $time$ */