规则

注意点: 良好的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$
*/

快速生成类注释 方法注释 接口文档(一键生成)

快速生成类注释 方法注释 接口文档(一键生成)

相关文章: