idea设置类和方法的注解模板

    

 

目录

一、设置类的注解模板

二、设置方法的注解模板


一、设置类的注解模板

1、IntelliJ IDEA-->Preferences-->Editor-->File and Code Templates-->Files

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

模板:

/**
 * @ClassName ${NAME}
 * @Description TODO
 * @Author boy
 * @Date ${DATE} ${TIME}
 */

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

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

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

设置后的模板如下如所示:

2、生成类的效果图展示

二、设置方法的注解模板

IDEA还没有智能到自动为我们创建方法注释,这就是要我们手动为方法添加注释,

1、IntelliJ IDEA-->Preferences-->Editor-->Live Templates

(1)新建组:命名为userDefine

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

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

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

获取方法返回值的methodReturnType()

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

    一般是 tab 键

(4)设置模板:模板内容如下

注意第一行,只有一个*而不是/*

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

*
 * @Author boy
 * @Description 
 * @Date $date$ $time$
 * @Param $param$
 * @return $return$
 */


如果使用/*生成的模板注释将会多一个/* 所以我们要去掉最前面的/*

(5)设置模板的应用场景

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

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

(6)设置参数的获取方式

选择右侧的Edit variables按钮

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

选择每个参数对应的获取方法(在下拉选择框中选择即可),网上有很多教程说获取param时使用脚本的方式,我试过使用脚本

的方式不仅麻烦而且只能在方法内部使用注释时才能获取到参数

(7)效果图

创建方法,在方法上面写:/*  

然后按tab键,得到如下结果:

  • 3
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
idea方法注释模板是编写代码时用于对方法进行注解的一种格式化规范。它的主要目的是提供给代码阅读者(包括自己和他人)关于方法功能、输入输出以及其他相关信息的快速概览。下面是一个常见的带注解idea方法注释模板示例: ``` /** * 方法名称:methodExample * 描述:这是一个示例方法,用于展示idea方法注释模板的使用。 * 参数: * - param1: 参数1的说明,型为xxx。 * - param2: 参数2的说明,型为xxx。 * 返回值:返回值的说明,型为xxx。 * 抛出异常: * - Exception1:异常1的说明。 * - Exception2:异常2的说明。 * 作者:作者的姓名 * 创建时间:方法创建的时间 * 版本:方法的版本信息 */ public returnType methodExample(param1, param2) throws Exception1, Exception2 { // 方法体 } ``` 在这个示例中,我们可以看到该注释模板的结构和内容。注释的开头是一个多行注释的开始符号(`/**`),接着是对方法名称的注释,然后是方法的描述,接下来是对参数、返回值和异常的注释,最后是对作者、创建时间以及版本的注释。 借助这个模板,我们可以清晰地了解一个方法的作用、输入输出、异常等重要信息。这对于自己回顾代码或者他人阅读、维护代码都非常有帮助。同时,注释模板也促使开发者在编写方法时思考清楚这些方面的内容,提高了代码的可读性和可维护性。 当然,一个好的注释模板可能因不同的团队、项目和个人而有所不同。因此,我们可以根据实际情况调整和定制这个模板,以适应自己团队和项目的需要。

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值