图文

IDEA 文档插件 DocView 版本更新:支持编辑文档注释

IDEA 文档插件 DocView 版本更新:支持编辑文档注释:原封面
文章目录2 节

本文发表已超过一年,部分内容可能已过时。

前言

IDEA 文档插件 Doc View 又更新了新版本,本次更新版本如下:

  1. 支持在方法右键菜单选择 Doc Editor 直接编辑文档
    1. 编辑接口文档名称
    2. 编辑接口描述
    3. 编辑字段是否必填
    4. 编辑字段注释说明
    5. 点击确定, 会回写到源文件的注释中
  2. 支持在 Entity 中通过邮件菜单选择Doc Editor 编辑字段信息
    1. 编辑字段是否必填
    2. 编辑字段注释说明
    3. 点击确定, 会回写到源文件的注释中
    4. 支持将 Entity 复制为 Json 字符串
    5. 复制 Json 字符串时, 支持 Entity 中包含对象的转换
  3. 从 Doc View 预览界面直接跳转到编辑界面

是不是看着挺多的,下面,咱们就了解下具体都是什么吧!

Doc Editor

在方法右键菜单

方法右键菜单中的 Doc Editor 入口

Doc Editor 接口名称、描述和请求路径编辑面板

Doc Editor 请求参数必填标记与描述编辑表格

弹起操作面板,可编辑参数如下:

  1. 接口名称:默认取方法名,当有注释且注释 tag 为 @docName 时,会取 @docName 对应的名称;
  2. 接口描述:取注释的描述内容;
  3. 请求/返回参数:请求返回参数的是否必填、描述。

下面使用动图演示:

Doc Editor 编辑接口注释的操作演示

在实体类右键菜单

在实体类中右键菜单,其实相当于方法中的请求/返回参数那一部分。

实体类字段信息编辑面板

操作面板操作如下:

  1. 是否必填:将使用注释 tag @required 作为是否必填的标识。当然也支持 javax.validation.constraints 的部分注解;
  2. 描述信息:描述内容为注释内容,修改后会回写到注释中;
  3. 复制为 Json 字符串,支持多级嵌套。

编辑实体字段注释与必填标记的操作演示

如果上述内容点击 Copy as Json 会将实体转换为 Json 字符串复制到剪贴板。

将实体复制为嵌套 JSON 字符串的操作演示

直接从预览界面跳转

当打开 Doc View 文档界面时,左下角可以通过编辑按钮跳转到 Doc Editor 界面。

Doc View 预览窗口中的编辑入口

总结

Doc View 本次更新介绍就到这里就结束了,有兴趣的小伙伴,可以自己安装体验。

欢迎小伙伴们提出 Issue 和 PR。

项目地址:https://github.com/liuzhihang/doc-view 插件地址:https://plugins.jetbrains.com/plugin/15305-doc-view

【广告】

为了方便沟通交流,我创建了一个技术交流群,在群里可以交流技术,聊天提问,有兴趣的小伙伴可以通过公众号加我好友,发送进群,我会拉你进群。 PS:事先说好哦,不准发广告。

打开原图

订阅更新,继续阅读新的实践记录

最近发布

评论

隐私提示

昵称、网址和评论内容会公开显示,邮箱不公开。请勿在评论中填写敏感信息。