欢迎您访问程序员文章站本站旨在为大家提供分享程序员计算机编程知识!
您现在的位置是: 首页  >  IT编程

IDEA代码规范插件P3C+代码注释模板配置方法

程序员文章站 2022-06-25 11:26:34
idea配置阿里规范插件p3c进入idea -》file -》 settings -》plugins到搜索框中搜索:alibaba java coding guidelines 下载安装插件,安装之后...

idea配置阿里规范插件p3c

进入idea -》file -》 settings -》plugins

IDEA代码规范插件P3C+代码注释模板配置方法

到搜索框中搜索:alibaba java coding guidelines 下载安装插件,安装之后重启idea ,进入你的编辑器右击会发现多

了,检查规范和关闭检查。

IDEA代码规范插件P3C+代码注释模板配置方法

检查会发现你这个java文件是否存在问题并给出提示如:

IDEA代码规范插件P3C+代码注释模板配置方法

也常常遇到类是 class 或者方法上面缺少 javadoc注解 如:

  • 所有的类都必须添加创建者信息
  • 所有的抽象方法(包括接口中的方法)必须要用javadoc注释、除了返回值、参数、异常说明外,还必须指出该方法做什么事情,实现什么功能。

通过添加java 类 、方法注释模板来满足这些需求

  • 开发工具 :idea
  • 代码格式化模板 : 阿里格式化模板
  • 注释模板样例
/**
 * 类模板样例
 * demo class (描述)
 * 
 * @author keriezhang
 * @date 2016/10/31 20:07
 */
 public class codenotedemo {
 }
/**
 * 方法模板样例
 * fetch data by rule id (描述)
 * 
 * @author keriezhang
 	 * @date 2016/10/31 20:07
 * @param ruleid rule id
 * @param page page number
 * @param jsoncontext json format context
 * @return result<xxxxdo>
 */
 result<xxxxdo> fetchdatabyruleid(long ruleid, integer page, string jsoncontext);

idea配置模板步骤

配置全局userhelp->edit custom vm options...配置全局user,用于填充自动生成的注释中的作者@author属性。添加一行 -duser.name=xxx (xxx为名称)

IDEA代码规范插件P3C+代码注释模板配置方法

配置类注释模板 settings->editor->file and code templates->files->class

IDEA代码规范插件P3C+代码注释模板配置方法

增加注释模板内容:

/**
 * ${description}
 * @author ${user}
 * @date ${year}/${month}/${day} ${hour}:${minute}
 **/

新创建java文件时,会提示输入类描述description,生成的文件格式如下:

package tuan.press.test;

/**
 * 测试类
 * @author keriezhang
 * @date 2016/10/31 20:07
 **/
public class mytests {
}

配置方法注释 editor->live template->java 新建live template,进行如下配置:

IDEA代码规范插件P3C+代码注释模板配置方法

第5步,适用场景配置如下:

IDEA代码规范插件P3C+代码注释模板配置方法

第6步,模板变量配置如下:

IDEA代码规范插件P3C+代码注释模板配置方法

配置参数

  • 缩写abbreviation:*
  • 模板template text:
*
 * 
 * @author $user$
 * @date $data$ $time$$param$
 * @return $return$ 
 */

变量配置

  • user:user()
  • date: date("yyyy/mm/dd")
  • time:time("hh:mm")
  • param:groovyscript("if(\"${_1}\".length() == 2) {return '';} else {def result=''; def params=\"${_1}\".replaceall('[\\\\[|\\\\]|\\\\s]', '').split(',').tolist();for(i = 0; i < params.size(); i++) {result+='\\n' + ' * @param ' + params[i] + ' '}; return result;}", methodparameters());
  • return:methodreturntype()

方法注释使用
在java方法上输入/**后,按下tab键,即可在方法上方生成方法注释,如下:

/**
 * (①方法描述)
 * @author keriezhang
 * @date 2016/05/07 10:07
 * @param message (②参数描述)
 * @param name (②参数描述)
 * @return java.lang.string (③返回值描述)
 */
public string mytest(string message,string name){
 return "";
}

到此这篇关于idea代码规范插件p3c+代码注释模板配置方法的文章就介绍到这了,更多相关idea代码规范插件p3c内容请搜索以前的文章或继续浏览下面的相关文章希望大家以后多多支持!