IDEA类和方法注释模板设置(非常详细)

所属分类: 软件编程 / java 阅读数: 19
收藏 0 赞 0 分享

idea 模版之自定义类与方法注释

很多公司都有要求的代码注释规范,我们每新建类或者方法的时候从新复制粘贴很麻烦,而且容易粘错。

当然自定义模板还可以用到很多地方,比如系统自带的 sout就是system.out.print(); 当你输入某文本的时候,系统会自动替换成目标文本。

1定义java文件头部的注释

2给java类中的方法添加上注释

      2.1第一步勾选Enable Live  Templates

      2.2第二步新建一个Group

      2.3第三步新建一个Template

      2.4第四步点击Define按钮

      2.5第五步填写注释模板

1、定义java文件头部的注释

打开设置面板,然后填写注释模板:

File  => setting  => editor =>  File and Code Templates

如图:

2、给java类中的方法添加上注释

2.1、第一步勾选Enable  Live  Templates

首先要在上一章节的图中勾选中 Enable  Live  Templates

如图:

2.2、第二步新建一个Group

其次要打开LiveTemplates 然后新建一个Group

如图:

    

在弹窗口中输入你想要的group名称,例如我取名叫chenjieGroup

如图:


点击OK,你已经新建了一个模板组,名称叫chenjieGroup

如图:

2.3、第三步新建一个Template

选中新建的group,也就是选中chenjieGroup,在这个group下新建一个LiveTemplate

如图:

上图中点击Live Template之后,将会新建一个模板,并且光标定位到了需要你输入快捷键的方框中

如图:


我输入了cjm意思是当我在java文件的某个方法内部,连续输入cjm后,intellij将会在该方法的头上为我自动生成注释(根据我接下来定义的模板来生成)。

2.4、第四步点击Define按钮

点击上图中的Ok按钮左上方的define

如图:

在弹出的下拉框内选择作用域,这里选择java文件

如图:

2.5、第五步填写注释模板

 在第四步完成后,Templatetext框内的内容可以编辑了,在Template text 内写入模板,例如我敲入的模板是:

/**

 *@描述 

 *@参数 $params$

 *@返回值 $return$

 *@创建人 chenjie

 *@创建时间 $date$

 *@修改人和其它信息

 */

如图:


说明:在此步骤中,模板内容你可以自己写,两个$号内部是参数名称,都有哪些参数呢,你可以点击Editvariables,然后在弹窗口中自己查看和选择

点击Edit variables会弹出框

如图:

弹出框

如图:

上图中,Name这一列是你可以设置的参数名称,Expression这一列是你可以选择的表达式,点击Expression这一列的单元格,即可出现下拉框

如图:

例如我依次给params、return、date这三个变量设置了表达式

如图:


点击OK(两个窗口上的OK都要点击) 

好了,现在可以验证了。

新建一个Utils类

如图:

取名Utils

如图:

可以看到,文件头部的注释已经有了

如图:

新建一个方法,内容如下:

 public static String sayHello(String userName)
{
   return "hello "+userName; 
}

如图:

在上图画红框的地方输入我们刚才设置的快捷键cmj即可看到intellij给我们添加的注释

如图:

快捷键需要在方法内部,也就是花括号内部,至于是不是在红框的位置都可以,例如在return语句的后面或者其他地方也可以,只要是在sayHello方法内部即可。我输入cjm然后就可以得到提示

如图:

好了,敲回车后,intellij将我输入的cjm替换为了方法的注释(根据我们上一步设置的模板来生成注释)

 如图:


说明:此时有点2,还需要自己把注释剪切到方法外部去,不过总比我们手动敲注释好多了。快捷键可以在方法外部敲,也可以生成注释,但是参数和返回值就没法给你生成了,因为参数和返回的值只有在函数作用域内,intellij才能找到,所以快捷键最好还是在方法内部敲,我刚才的cjm就是在方法内部敲的。

以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持脚本之家。

更多精彩内容其他人还在看

Java数据类型的规则

这篇文章主要介绍了Java数据类型的规则的相关资料,非常不错,具有参考借鉴价值,需要的朋友可以参考下
收藏 0 赞 0 分享

Spring整合TimerTask实现定时任务调度

这篇文章主要介绍了Spring整合TimerTask实现定时任务调度的相关资料,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
收藏 0 赞 0 分享

详解SpringMVC使用MultipartFile实现文件的上传

本篇文章主要介绍了SpringMVC使用MultipartFile实现文件的上传,本地的文件上传到资源服务器上,比较好的办法就是通过ftp上传。这里是结合SpringMVC+ftp的形式上传的,有兴趣的可以了解一下。
收藏 0 赞 0 分享

SpringMVC上传文件的三种实现方式

本篇文章主要介绍了SpringMVC上传文件的三种实现方式,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
收藏 0 赞 0 分享

微信公众帐号开发-自定义菜单的创建及菜单事件响应的实例

本篇文章主要介绍了微信公众帐号开发-自定义菜单的创建及菜单事件响应的实例,具有一定的参考价值,感兴趣的小伙伴们可以参考一下。
收藏 0 赞 0 分享

浅析Java中的继承与组合

本文将介绍组合和继承的概念及区别,并从多方面分析在写代码时如何进行选择。文中通过示例代码介绍的很详细,有需要的朋友可以参考借鉴,下面来一起看看吧。
收藏 0 赞 0 分享

利用反射获取Java类中的静态变量名及变量值的简单实例

下面小编就为大家带来一篇利用反射获取Java类中的静态变量名及变量值的简单实例。小编觉得挺不错的,现在就分享给大家,也给大家做个参考。一起跟随小编过来看看吧
收藏 0 赞 0 分享

java启动线程的3种方式对比分析

这篇文章主要为大家对比分析了java启动线程的3种方式,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
收藏 0 赞 0 分享

SpringMVC上传和解析Excel方法

这篇文章主要介绍了SpringMVC上传和解析Excel方法,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
收藏 0 赞 0 分享

JAVA中String类与StringBuffer类的区别

这篇文章主要为大家详细介绍了JAVA中String类与StringBuffer类的区别,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
收藏 0 赞 0 分享
查看更多