Idea 设置自动注释,并解决自动注释的@param和@return为null的问题

本文详细介绍如何在IntelliJ IDEA中自定义类和方法的注释模板,包括设置作者、日期、描述和版本信息,以及如何快速生成方法注释。

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

File------>settings----------->Editor---------------->File and Code Templates--------->class
在这里插入图片描述
在public class ${NAME} 上边输入你想要设置的注释, 这里是我的设置

/**
* @author HuangHaiyang
* @date ${YEAR}-${MONTH}-${DAY} ${HOUR}:${MINUTE}
* @description:${description}
* @version:     $version
*/

注意:当你设置 @description:${description} 和 @version: versionversionversion 时每次新建类都会 出现在这里插入图片描述
不想每次都输入的话,可以不设置 ${description} 和 $version
设置完成点击apply.
现在每次新建类都会自动生成注释

/**
 * @author HuangHaiyang
 * @date 2020-05-07 22:45
 * @description:这是一个测试类
 * @version: 1.0.0
 */
public class Test {

}

设置自动生成方法的注释
live Templates--------->点击+ --------------->选择 Template Group 这时会弹出一个框,输入一个名字,我的叫MyGroup
在这里插入图片描述
在这里插入图片描述
Abbreviation 快捷生成注释 随便写 最好设置为* 比较简单
Description 描述,随便写
Template text 就是你要生成的模板
这是我的配置

注意
第一个/不是我漏掉了,只要写上第一个/,你的@param和@return都会为null
千万不要写上第一个/
千万不要写上第一个/
千万不要写上第一个/

**
 * create time: $date$ $time$
 $params$
 * @return $return$
 */

下边有一行勾选,可以选everyone 也可以只选java
在这里插入图片描述
点击 Edit variables
在这里插入图片描述
我的配置
date
date(“yyyy-MM-dd”)
time
time(“HH:mm”)
params
groovyScript(“def result=’’; def params=”${_1}".replaceAll(’[\\[|\\]|\\s]’, ‘’).split(’,’).toList(); for(i = 0; i < params.size(); i++) {if(params[i] == ‘’) return result;if(i==0) result += ‘\n’; result+=’ * @param ’ + params[i] + ((i < params.size() - 1) ? ‘\n’ : ‘’)}; return result", methodParameters())
(注意 这个写在default value)
return
methodReturnType()

点击ok apply ok

最重要的一步
在你要生成注释的地方输入 / 再加上tab*
如果你之前设的Abbreviation不是 ,你要输入 / 你的Abbreviation的值 再加上tab*


/**
 * @author HuangHaiyang
 * @date 2020-05-07 22:45
 * @description:这是一个测试类
 * @version: 1.0.0
 */
public class Test {
    /**
     * create time: 2020-05-07 23:05
     * @param null
     * @return 
     */
    private int age;
    private String name;
    /**
     * create time: 2020-05-07 23:05
     * @param age
     * @param name
     * @return 
     */
    public Test(int age, String name) {
        this.age = age;
        this.name = name;
    }

    public int getAge() {
        return age;
    }
    /**
     * create time: 2020-05-07 23:05
     * @param age
     * @return void
     */
    public void setAge(int age) {
        this.age = age;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }
}

完成

### 编写查询车牌是否有待缴费账单记录的方法 为了实现查询车牌是否存在待缴费账单记录的功能,可以创建一个名为 `BillService` 的服务类,定义一个方法来执行此操作。以下是具体实现: #### 方法签名设计 考虑到功能需求,建议采用如下参数列表: - 输入参数:车牌号 (String licensePlate),用于唯一标识车辆。 - 返回值类型:boolean 或者自定义的结果对象。 #### 完整代码示例 ```java /** * 提供关于未支付停车费账单的服务接口. */ public class BillService { /** * 查询指定车牌号码下是否存在未付款项. * * @param licensePlate 车牌编号字符串表示形式;不能为白字符. * 此处假设输入已经过验证处理. * @return 如果存在至少一笔未结清的费用,则返回 true; * 否则返回 false 表明无欠款情况发生. * @throws IllegalArgumentException 当传入无效(/白)的licensePlate时抛出异常. */ public boolean hasOutstandingBills(String licensePlate) throws IllegalArgumentException { if (licensePlate == null || licensePlate.trim().isEmpty()) { throw new IllegalArgumentException("License plate cannot be empty or blank."); } // 假设此处调用了数据库或其他外部资源进行实际的数据检索逻辑... // 这里仅作为演示用途模拟数据访问过程 return !getUnpaidRecordsFor(licensePlate).isEmpty(); } private List<BillRecord> getUnpaidRecordsFor(String licensePlate){ // 实现获取特定车牌对应的未付账单列表的具体业务逻辑 // ... return Collections.emptyList(); // 模拟返回集合 } } ``` 上述代码展示了如何利用 Javadoc 注释清晰描述方法的目的、参数含义及可能产生的异常状况[^1]。通过这种方式不仅提高了代码可读性维护性,同时也便于其他开发人员理解该函数的作用范围与预期行为[^2]。 对于集成开发环境的支持,在 IntelliJ IDEA 中可以通过配置全局模板使得每次新建 Java 文件都会自动应用这些注释样式[^3]。
评论 1
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值