IDEA类和方法注释模板设置

server/2024/11/14 8:55:55/

一、概述
        

        IDEA自带的注释模板不是太好用,我本人到网上搜集了很多资料系统的整理了一下制作了一份比较完整的模板来分享给大家,写这篇文章只是为了让大家省事。

     适用于通过在项目工具窗口中调用新建 | Java 类 | 类创建的新 Java 类。 此内置模板是可编辑的。 除了 Java 表达式和注释外,您还可以使用预定义变量(如下所列),这些变量随后将像宏一样被扩展为相应值。  您也可以指定自定义变量。 自定义变量使用以下格式:${VARIABLE_NAME},其中 VARIABLE_NAME是变量的名称(例如,${MY_CUSTOM_FUNCTION_NAME}) 。 在 IDE 创建包含自定义变量的新文件之前,您会看到一个对话框,您可以在其中定义模板中自定义变量的值。  通过使用 #parse 指令,可以包括 包含 标签页中的模板。 要包含模板,请在引号中将模板的全名指定为形参(例如,#parse("File Header.java"))。 
预定义变量接收以下值:
${PACKAGE_NAME}
 
在其中创建新类的软件包名称
${NAME}
 
您在创建新类对话框中指定的新类的名称
${USER}
 
当前用户的系统登录名
${DATE}
 
当前系统日期
${TIME}
 
当前系统时间
${YEAR}
 
当前年度
${MONTH}
 
当前月份
${MONTH_NAME_SHORT}
 
当前月份名称的前 3 个字母(Jan、Feb 等)
${MONTH_NAME_FULL}
 
当前月份的全名(January、February 等)。
${DAY}
 
当前月份的日期
${HOUR}
 
当前小时
${MINUTE}
 
当前分钟
${PROJECT_NAME}
 
当前项目名称

这里设置的注释模板采用Eclipse的格式,下面先贴出Eclipse的注释模板,我们就按照这种格式来设置:
类注释模板:

方法注释模板:

二、类注释模板


1、File–>settings–>Editor–>File and Code Templates–>Files

我们选择Class文件(当然你要设置接口的还也可以选择Interface文件)

(1)N A M E :设置类名,与下面的 {NAME}:设置类名,与下面的NAME:设置类名,与下面的{NAME}一样才能获取到创建的类名

(2)TODO:代办事项的标记,一般生成类或方法都需要添加描述

(3)U S E R 、 {USER}、USER、{DATE}、T I M E :设置创建类的用户、创建的日期和时间,这些事 I D E A 内置的方法,还有一些其他的方法在绿色框标注的位置,比如你想添加项目名则可以使用 {TIME}:设置创建类的用户、创建的日期和时间,这些事IDEA内置的方法,还有一些其他的方法在绿色框标注的位置,比如你想添加项目名则可以使用TIME:设置创建类的用户、创建的日期和时间,这些事IDEA内置的方法,还有一些其他的方法在绿色框标注的位置,比如你想添加项目名则可以使用{PROJECT_NAME}

(4)1.0:设置版本号,一般新创建的类都是1.0版本,这里写死就可以了

2、效果图展示


三、方法注释模板
1、创建模板
IDEA还没有智能到自动为我们创建方法注释,这就是要我们手动为方法添加注释,使用Eclipse时我们生成注释的习惯是

/**+Enter,这里我们也按照这种习惯来设置IDEA的方法注释

(1)File–>Settings–>Editor–>Live Templates

(2)新建组:命名为userGroup


(3)新建模板:命名为*

因为IDEA生成注释的默认方式是:/*+模板名+快捷键(比如若设置模板名为add快捷键用Tab,则生成方式为

/*add+Tab),如果不采用这样的生成方式IDEA中没有内容的方法将不可用,例如获取方法参数的methodParameters()、

获取方法返回值的methodReturnType()

(4)设置生成注释的快捷键


2、设置模板内容-IDEA格式模板
注意第一行,只有一个而不是/

在设置参数名时必须用参数名 {参数名}参数名的方式,否则第五步中读取不到你设置的参数名

注意:复制下面这段代码

**
 * @Author ShiShuMin
 * @Description //TODO $end$
 * @Date  $date$ $time$
 * @Param $param$
 * @return $return$
 **/


3、设置模板应用场景
点击模板页面最下方的警告,来设置将模板应用于那些场景,一般选择EveryWhere–>Java即可

(如果曾经修改过,则显示为change而不是define)

点击模板页面最下方的警告,来设置将模板应用于那些场景,一般选择EveryWhere–>Java即可

(如果曾经修改过,则显示为change而不是define)


4、设置参数
选择右侧的Edit variables按钮

PS:第4步和第5步顺序不可颠倒,否则第5步将获取不到方法

(1) IDEA格式的模板只需要为每个参数选择对应的方法即可

(2) parma和return自定义函数

获取参数实现方式:

groovyScript("if(\"${_1}\".length() == 2) {return '';} else {def result=''; def params=\"${_1}\".replaceAll('[\\\\[|\\\\]|\\\\s]', '').split(',').toList();for(i = 0; i < params.size(); i++) {if(i==0){result+='* @param ' + params[i] + '  '}else{result+='\\n' + ' * @param ' + params[i] + '  '}}; return result;}", methodParameters())    
1
返回值实现方式:

groovyScript("def returnType = \"${_1}\"; def result = '* @return {@link ' + returnType + ' }'; return result;", methodReturnType())
1
设置的位置如下图:


5、效果图
创建方法,在方法上面写:/*+Enter

IDEA格式的注释效果图:


http://www.ppmy.cn/server/121782.html

相关文章

C 字符串操作

strcpy char *strcpy(char *dest, const char *src) 把 src 所指向的字符串复制到 dest。 #include <stdio.h> #include <stdlib.h> #include <string.h>char* my_strcpy(char *dst, char *src) {if(dst NULL || src NULL){return NULL;}char *ret dst…

2024最新Linux发行版,Kali Linux迎来劲敌,零基础入门到精通,收藏这一篇就够了

概念简介 Parrot OS 是一款基于 Debian 的 Linux 发行版&#xff0c;专门为安全研究、渗透测试、开发以及隐私保护而设计。由 Frozenbox 团队开发的 Parrot OS&#xff0c;结合了现代安全工具、用户友好的环境以及出色的隐私保护特性&#xff0c;成为网络安全从业者、开发人员…

2024.9.24 Python与C++面试八股文

1.extern extern关键字用于在多个文件中引用同一个全局变量的声明 在一个头文件中&#xff0c;如果这个变量声明了&#xff0c;但是在cpp文件中没找到他的定义&#xff0c;那么编译就会报错&#xff0c;但是如果加了extern&#xff0c;编译器就不会给头文件报错&#xff0c;而…

中序遍历二叉树全过程图解

文章目录 中序遍历图解总结拓展&#xff1a;回归与回溯 中序遍历图解 首先看下中序遍历的代码&#xff0c;其接受一个根结点root作为参数&#xff0c;判断根节点是否为nil&#xff0c;不为nil则先递归遍历左子树。 func traversal(root *TreeNode,res *[]int) {if root nil …

【数据库】sqlite

文章目录 1. 基本概述2. 主要特点3. 应用场景4. 优缺点5. 基本使用示例6. 在编程语言中的使用连接到 SQLite 数据库&#xff08;如果文件不存在会自动创建&#xff09;创建表插入数据提交事务查询数据关闭连接 7. 总结 SQLite 是一个轻量级的关系型数据库管理系统&#xff08;R…

linux 下的静态库与动态库

目录 一、介绍 1、静态库 2、动态库 二、操作 1、静态库 2、动态库 3、使用库文件 &#xff08;1&#xff09;方法一 &#xff08;2&#xff09;方法二 &#xff08;3&#xff09;方法三 一、介绍 1、静态库 静态链接库实现链接操作的方式很简单&#xff0c;即程序文…

JAVA同城生活新引擎外卖跑腿团购到店服务多合一高效系统小程序源码

&#x1f680;同城生活新风尚&#xff01;一站式高效系统&#xff0c;让日常更便捷&#x1f6cd;️ &#x1f37d;️【开篇&#xff1a;同城生活&#xff0c;一触即发】&#x1f37d;️ 在这个快节奏的时代&#xff0c;同城生活的便利性与效率成为了我们追求的新风尚。想象一下…

5个月的编程记录

不知不觉间&#xff0c;我已经在计算机这条道路上走过了五个月。从五个月前第一次翻开《C Primer Plus》开始&#xff0c;我便对编程产生了浓厚的兴趣。这门学科与我高中所学的死板知识截然不同&#xff0c;每个问题都有千变万化的解法&#xff0c;让我感到无比新鲜。 几天后&a…