IDEA设置类注解和方法注解模板(绝对可用)

本文详细介绍如何在IntelliJ IDEA中配置类注解和方法注解模板,包括配置步骤及自定义模板内容。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

最近项目中为了统一自己和小伙伴们的注解风格,所以需要修改Idea的类注解和方法注解模板,在之前的项目中已经配置过了,但是没有写到博客中来,趁这个机会将注解模板配置步骤写成一篇文章,供日后查阅。

一、类注解模板配置

步骤一:打开Idea,在菜单栏中找到 File ->setting -> File and Code Templates 后点击,选择右侧的Class,出现以下界面:

步骤二:将类注解模板写到public class ${NAME}上方,这里我的自定义类注解模板,如下:

/**
 * @description:
 * @author: zhangzhixiang
 * @createDate: ${DATE}
 * @version: 1.0
 */

这里大家根据各自的项目要求来编写模板内容,需要使用到什么参数,如时间参数${DATE},在上图的Description中可以找到你需要的各种参数,在创建类时生成的类注解的效果图如下:

 到此类注解模板介绍完成。

二、方法注解模板配置

步骤一:打开Idea,在菜单栏中找到 File ->setting -> Live Templates 后点击,出现以下界面:

步骤二:此时我们需要创建自己的模板组,所以我们点击图中的 + 按钮(在右边),选择  Template Group...,输入我们自定义方法模板组的名称,我这里以我自己的名字命名,然后点击ok,效果图如下:

 步骤三:此时我们已经成功创建了自定义模板组,效果图如下:

此时选中模板组,然后再次点击右边的 + 按钮,选择 Live Template,效果图如下:

 我们通过修改图中的Abbreviation参数来设置我们自定义方法模板的快捷键,通过修改Description来标明模板用途,这里我使用我的姓名首字母 zzx 作为模板快捷键,同时我在 Template text 中自定义了我的方法注解模板,效果图如下:

模板内容如下:

*
 * 方法描述
 $params$
 * @return $returns$
 * @author zxzhang
 * @date $date$
 */

步骤四:此时我们点击图中最下方的  Define 按钮来设置模板作用的语言范围,这里我们选择Java,效果图如下:

步骤五:点击 Edit variables 按钮,弹出参数配置页面(参数是指我们模板中带有${}的变量)

此时我们将returns选择Expression,在下拉框中找到返回值的变量,date同理,效果图如下:

 这里我们需要重点说一下params的配置,如果我们想要的效果是多个入参能够一行一个的展示,我们需要通过groovy脚本语言来定义params中的Default value,如上图,将脚本语言粘贴进去就可以了,脚本语言内容如下:

groovyScript("def result=''; def params=\"${_1}\".replaceAll('[\\\\[|\\\\]|\\\\s]', '').split(',').toList(); for(i = 0; i < params.size(); i++) {result+='* @param ' + params[i] + ((i < params.size() - 1) ? '\\r\\n ' : '')}; return result", methodParameters())groovyScript("def result=''; def params=\"${_1}\".replaceAll('[\\\\[|\\\\]|\\\\s]', '').split(',').toList(); for(i = 0; i < params.size(); i++) {result+='* @param ' + params[i] + ((i < params.size() - 1) ? '\\n\\b' : '')}; return result", methodParameters())

 然后一路点击ok,我们就将方法注解模板配置成功了,此时我们通过在类的方法上输入模板名(这里我们输入的是 /*zzx),然后按下tab键(这个tab键是可以调成回车的),就能够得到我们想要的方法注解了,效果图如下:

到此类注解和方法注解模板介绍结束。

### 如何在 IntelliJ IDEA 中创建使用自定义注解 #### 创建自定义注解 要在 IntelliJ IDEA 中创建自定义注解,可以按照以下方式进行操作: 1. **定义注解** 使用 `@interface` 关键字来定义一个新的注解。例如: ```java import java.lang.annotation.ElementType; import java.lang.annotation.Retention; import java.lang.annotation.RetentionPolicy; import java.lang.annotation.Target; @Retention(RetentionPolicy.RUNTIME) // 定义注解的生命周期 @Target(ElementType.METHOD) // 定义注解的应用目标 public @interface CustomAnnotation { String value() default ""; // 定义注解属性 int count() default 0; // 默认值为0 } ``` 2. **解释关键部分** - `@Retention`: 指定注解的保留策略。可以选择 `SOURCE`(仅源码)、`CLASS`(编译后存在)或 `RUNTIME`(运行时可用)[^3]。 - `@Target`: 指定注解可应用的目标范围,如方法 (`ElementType.METHOD`) (`ElementType.TYPE`)。 --- #### 配置 IntelliJ IDEA 的 Live Templates 来快速生成自定义注解 为了提高开发效率,可以通过配置 Live Templates 实现一键生成自定义注解模板。 1. 打开设置对话框:`File -> Settings -> Editor -> Live Templates`。 2. 点击右上角的加号按钮 (+),选择 `Live Template`。 3. 输入缩写名称(如 `ca` 表示 custom annotation),并在模板区域输入如下代码: ```java @CustomAnnotation(value = "$value$", count = $count$) ``` 4. 设置变量 `$value$` `$count$` 的默认值,并启用 `Edit variables` 功能以便动态调整参数[^2]。 5. 将适用范围设定为 Java 文件中的 Method 型。 完成后,在编辑器中输入 `ca` 并按 Tab 键即可自动展开为指定的注解形式。 --- #### 使用自定义注解 一旦定义好注解并将其应用于代码中,还可以通过反射机制读取这些注解的信息。以下是具体实现方式: ```java public class AnnotationExample { @CustomAnnotation(value = "This is a test", count = 5) public void annotatedMethod() {} public static void main(String[] args) throws Exception { AnnotationExample example = new AnnotationExample(); // 获取方法上的注解实例 CustomAnnotation annotation = example.getClass() .getMethod("annotatedMethod") .getDeclaredAnnotation(CustomAnnotation.class); System.out.println("Value: " + annotation.value()); System.out.println("Count: " + annotation.count()); } } ``` 上述程序展示了如何利用反射技术获取注解的具体内容,并打印其属性值[^4]。 --- #### 常见注意事项 - 如果希望注解能够在运行时被解析,请务必设置 `RetentionPolicy.RUNTIME`[^1]。 - 当前版本的 IntelliJ IDEA 提供了强大的插件支持,某些情况下可以直接安装第三方工具简化流程[^5]。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

地表最强菜鸡

你的鼓励将是我创作最大的动力!

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

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

余额充值