Idea最常用的注释模板,方法级、属性级、类级、类文件级注释

本文详细介绍了如何在IDEA中设置和使用方法级、属性级、类级及类文件级注释模板,包括参数和返回值的特殊处理,并提供了具体的Groovy脚本表达式。同时,针对@Copyright标签的格式问题给出了解决方案。通过设置模板和快捷键,可以快速生成符合规范的注释,提高开发效率。
摘要由CSDN通过智能技术生成

一、方法级注释 和 属性级注释

内容比较多,请仔细阅读,特别是图片上的说明,相信一定能帮上你。

1、方法级注释

在这里插入图片描述
在这里插入图片描述

在这里插入图片描述
下面给出我的模板内容:

**
 * @Title: $title$
 * @Description: $desc$
 $params$
 * @return: $return$
 * @throws: $throws$
 * @author: huangpeng
 * @Date: $date$ $time$
 */

EXpression表达式除 params 和 return 比较复杂,其余变量的表达式都可再图中看到(这些方法是系统内置的,可直接选,如果没有提示的话,照着图片输入即可),下面单独给出这两个变量的表达式:
(1)、params :

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 ' : '')}; return result", methodParameters())

(2)、return

groovyScript("def result=''; def params=\"${_1}\".replaceAll('[\\\\[|\\\\]|\\\\s]', '').split('<').toList(); for(i = 0; i < params.size(); i++) {if(i!=0){result+='<';};  def p1=params[i].split(',').toList();  for(i2 = 0; i2 < p1.size(); i2++) { def p2=p1[i2].split('\\\\.').toList();  result+=p2[p2.size()-1]; if(i2!=p1.size()-1){result+=','}  } ;  };  return result", methodReturnType())

唤出注释方式:按照图片上的设置的是 输入 /* 后按回车唤出方法注释。
注意:throws 的表达式获取异常,idea目前没有合适的表达式可做到,上面的方法是失效的。

2、属性注释

在这里插入图片描述
注释模板:

/**
 * $desc$
 */

只需保留有变量即可,desc可自行设置为其他名字,图中设置的通过按 tab 加 f 键唤出注释。

二、类级注释 和 类文件级注释

1、类文件级注释

在这里插入图片描述

下面给出注释模板:

/**
 * 创建人:  @author xxxxxx    
 * 创建时间:  ${YEAR}年${MONTH}月${DAY}日 ${HOUR}:${MINUTE}
 * 项目名称:  ${PROJECT_NAME}
 * 文件名称:  ${NAME}
 * 文件描述:  @Description: ${Description}
 * 公司名称:  xxxxxx
 *
 * All rights Reserved, Designed By xxxxxx 
 * @Copyright:  2021-${YEAR}
 *
 */

2、类级注释

在这里插入图片描述

下面给出注释模板:

/**
 * 包名称:${PACKAGE_NAME}
 * 类名称:${NAME}
 * 类描述:${Description}
 * 创建人:@author xxxxxx
 * 创建时间:${YEAR}年${MONTH}月${DAY}日 ${HOUR}:${MINUTE}
 */

三、效果展示

新建一个类后会有提示输入类描述内容,点ok后类注释和类文件注释会自动生成。

在这里插入图片描述
在这里插入图片描述
这里发现一个问题@Copyright 描述标签会自动换行,同时在公司名称下面的空内容会多出一个“尖括号p尖括号”,发现将idea的代码格式化的格式化注释,关掉就正常了:
在这里插入图片描述
在这里插入图片描述

在这里插入图片描述
希望能帮助大家,大家觉得有用的话别忘了点个赞!

  • 13
    点赞
  • 18
    收藏
    觉得还不错? 一键收藏
  • 2
    评论
IDEA中添加注释模板有几种方式。一种方式是通过勾选"Enable Live Templates"选项,并在内容框中填入注释模板信息,例如:/** * @创建人 qiemengyan * @创建时间 ${DATE} * @描述 */ 。另一种方式是使用IDEA自带的注释模板,默认的生成方式是/* 模板名 快捷键(比如若设置模板名为add快捷键用Tab,则生成方式为按下Tab键)。然而,有些用户认为IDEA自带的注释模板不太好用,因此他们会在网上搜集资料并整理制作一份比较完整的模板来使用,这样可以更加方便省事。所以,你可以选择其中一种方式添加注释模板,具体选择哪种方式取决于个人偏好。<span class="em">1</span><span class="em">2</span><span class="em">3</span> #### 引用[.reference_title] - *1* [IDEA设置注释模板](https://blog.csdn.net/qiemengyan/article/details/123813352)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v93^chatsearchT3_2"}}] [.reference_item style="max-width: 50%"] - *2* *3* [【转】IDEA方法注释模板设置(非常详细)](https://blog.csdn.net/mao_mao37/article/details/114629602)[target="_blank" data-report-click={"spm":"1018.2226.3001.9630","extra":{"utm_source":"vip_chatgpt_common_search_pc_result","utm_medium":"distribute.pc_search_result.none-task-cask-2~all~insert_cask~default-1-null.142^v93^chatsearchT3_2"}}] [.reference_item style="max-width: 50%"] [ .reference_list ]
评论 2
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值