MyEclipse自动生成注释,修改注释模板
以下学习过程中的笔记,部分内容来自网络和书籍。一方便以后查阅,二希望能帮助到别人,三希望高手指点。
用Myeclipse开发项目是,自动生成注释十分方便快捷,但我们希望自动生成自己的名字和一些内容,同时团队开发过程中会出现每个人注释格式不一致等问题。
下面介绍如果通过修改Myeclipse注解模板解决问题。
本人Myeclipse常用的设置,可按需要作相应修改
-----------------------------------------------------
1. 类的版权注释格式及设置步骤方式:
Eclipse -> Window -> Preferences -> Java -> Code Style -> Code Templates -> Code -> New Java files -> Edit
- /*
- * Copyright (c) 2010-2020 Founder Ltd. All Rights Reserved.
- *
- * This software is the confidential and proprietary information of
- * Founder. You shall not disclose such Confidential Information
- * and shall use it only in accordance with the terms of the agreements
- * you entered into with Founder.
- *
- */
- ${filecomment}
- ${package_declaration}
- ${typecomment}
- ${type_declaration}
2.类的注释格式及设置步骤如下:
Eclipse -> Window -> Preferences -> Java -> Code Style -> Code Templates -> Comments -> Types -> Edit
- /**
- * This class is used for ...
- * @author jseven1989
- * @version
- * 1.0, ${date} ${time}
- */
3.类的方法注释格式设置方式:
Eclipse -> Window -> Preferences -> Java -> Code Style -> Code Templates -> Comments -> Methods -> Edit
- /**
- * ${tags}
- * @author jseven1989
- */
其他说明
---------------------------------------------------------------
JAVA注释具体实现
1、源文件注释
源文件注释采用 /** …… */,在每个源文件的头部要有必要的注释信息,包括:文件名;文件编号;版本号;作者;创建时间;文件描述包括本文件历史修改记录等。中文注释模版:
/**
* 文 件 名 :
* CopyRright (c) 2008-xxxx:
* 文件编号:
* 创 建 人:
* 日 期:
* 修 改 人:
* 日 期:
* 描 述:
* 版 本 号:
*/
2、类(模块)注释:
类(模块)注释采用 /** …… */,在每个类(模块)的头部要有必要的注释信息,包括:工程名;类(模块)编号;命名空间;类可以运行的JDK版本;版本号;作者;创建时间;类(模块)功能描述(如功能、主要算法、内部各部分之间的关系、该类与其类的关系等,必要时还要有一些如特别的软硬件要求等说明);主要函数或过程清单及本类(模块)历史修改记录等。
英文注释模版:
/**
* CopyRright (c)2008-xxxx: <展望软件Forsoft >
* Project: <项目工程名 >
* Module ID: <(模块)类编号,可以引用系统设计中的类编号>
* Comments: <对此类的描述,可以引用系统设计中的描述>
* JDK version used: <JDK1.6>
* Namespace: <命名空间>
* Author: <作者中文名或拼音缩写>
* Create Date: <创建日期,格式:YYYY-MM-DD>
* Modified By: <修改人中文名或拼音缩写>
* Modified Date: <修改日期,格式:YYYY-MM-DD>
* Why & What is modified <修改原因描述>
* Version: <版本号>
*/
如果模块只进行部分少量代码的修改时,则每次修改须添加以下注释:
//Rewriter
//Rewrite Date:<修改日期:格式YYYY-MM-DD> Start1:
/* 原代码内容*/
//End1:
将原代码内容注释掉,然后添加新代码使用以下注释:
//Added by
//Add date:<添加日期,格式:YYYY-MM-DD> Start2:
//End2:
如果模块输入输出参数或功能结构有较大修改,则每次修改必须添加以下
注释:
//Log ID:<Log编号,从1开始一次增加>
//Depiction:<对此修改的描述>
//Writer:修改者中文名
//Rewrite Date:<模块修改日期,格式:YYYY-MM-DD>
2、接口注释:
接口注释采用 /** …… */,在满足类注释的基础之上,接口注释应该包含描述接口的目的、它应如何被使用以及如何不被使用,块标记部分必须注明作者和版本。在接口注释清楚的前提下对应的实现类可以不加注释。
3、构造函数注释:
构造函数注释采用 /** …… */,描述部分注明构造函数的作用,不一定有块标记部分。
注释模版一:
/**
* 默认构造函数
*/
注释模版二:
/**
* Description : 带参数构造函数,
* 初始化模式名,名称和数据源类型
* @param schema: 模式名
* @param name: 名称
* @param type: 数据源类型
*/
4、函数注释:
函数注释采用 /** ……*/,在每个函数或者过程的前面要有必要的注释信息,包括:函数或过程名称;功能描述;输入、输出及返回值说明;调用关系及被调用关系说明等。函数注释里面可以不出现版本号(@version)。
注释模版一:
/**
* 函 数 名 :
* 功能描述:
* 输入参数: <按照参数定义顺序>
* <@param后面空格后跟着参数的变量名字
* (不是类型),空格后跟着对该参数的描述。>
*
* 返 回 值: - 类型 <说明>
* <返回为空(void)的构造函数或者函数,
* @return可以省略; 如果返回值就是输入参数,必须 * 用与输入参数的@param相同的描述信息; 必要的时* 候注明特殊条件写的返回值。>
* 异 常:<按照异常名字的字母顺序>
* 创 建 人:
* 日 期:
* 修 改 人:
* 日 期:
*/
注释模版二:
/**
* FunName: getFirstSpell
* Description : 获取汉字拼音首字母的字符串,
* 被生成百家姓函数调用
* @param: str the String是包含汉字的字符串
* @return String:汉字返回拼音首字母字符串;
* 英文字母返回对应的大写字母;
* 其他非简体汉字返回 '0';
* @Author: ghc
* @Create Date: 2008-07-02
*/
5、方法注释:
方法注释采用 /** …… */,对于设置 (Set 方法 ) 与获取 (Get 方法 ) 成员的方法,在成员变量已有说明的情况下,可以不加注释;普通成员方法要求说明完成什么功能,参数含义是什么且返回值什么;另外方法的创建时间必须注释清楚,为将来的维护和阅读提供宝贵线索。
6、方法内部注释:
控制结构,代码做了些什么以及为什么这样做,处理顺序等,特别是复杂的逻辑处理部分,要尽可能的给出详细的注释。
7、 全局变量注释:
要有较详细的注释,包括对其功能、取值范围、哪些函数或者过程存取以及存取时注意事项等的说明。
8、局部(中间)变量注释:
主要变量必须有注释,无特别意义的情况下可以不加注释。
9、实参/参数注释:
参数含义、及其它任何约束或前提条件。
10、字段/属性注释: 字段描述,属性说明。
11、常量:常量通常具有一定的实际意义,要定义相应说明。
原文来自:http://blog.csdn.net/ygzk123/article/details/7833588
MyEclipse自动生成注释,修改注释模板相关推荐
- Vs code自动生成Doxygen格式注释
前言 程序中注释的规范和统一性的重要性不言而喻,本文就推荐一种在用vscode编写代码时自动化生成标准化注释格式的方法,关于Doxygen规范及其使用可查看博文 代码注释规范之Doxygen. ...
- 用 Visual Studio 自动生成C/C++注释(Doxygen、XML)
文章目录 引言 方案一:用 Doxygen Comments 生成 Doxygen 风格注释 1. 在VS中安装 Doxygen Comments 扩展 2. 重启VS,启用扩展 3. 使用 Doxy ...
- Eclipse用法和技巧十四:自动生成的TODO注释2
前面介绍了自动生成的TODO注释含义,配置以及如何去除的方法,这里介绍下TODO常见的用途.工作中经常会遇到写代码写到一半,被叫过去开会推动沟通.o(╯□╰)o 一般都有写代码停下来一段时间,再回来就 ...
- Eclipse用法和技巧十三:自动生成的TODO注释1
使用eclipse的快捷键自动生成的代码,经常有这样的注释. 一眼看上去这个注释和一般的注释并无什么差别,不过TODO这个字符串的颜色不一样,应该有些内容.TODO是eclipse中提供的一种任务标签 ...
- 用MyEclipse自动生成hibernate映射文件和实体类
创建web工程,使用Hibernate的时候,在工程里一个一个创建实体类太麻烦,浪费时间,现在教大家如何用MyEclipse自动生成Hibernate映射文件及实体类 方法/步骤 1 创建数据库,创建 ...
- myeclipse 自动生成注释
1.新建类时候,生成注释: Window-->Preferences-->Java-->Code Style-->Code Templates-->Commonts--& ...
- VSCode自动生成Doxygen格式注释
Doxygen Documentation Generator插件使用及配置 安装插件后,File–Preferences–Settings-- 中打开用户 setting.json文件 初步设置后如 ...
- 修改自动生成get/set方法模板代码
今天看到 面对接口脏数据你还在V层if str==null else setText? 一文,觉着写得挺好,开发过程中多思考多动手,会带来意想不到的效果.底下评论大家也都说了各自的方法和见解,文中有一 ...
- (VBA)Word中对选中的行(代码行)自动编号并修改注释的颜色
说实话,CSDN的这个插入代码的控件很好用,特别是自动添加行号的功能. 下面这段VBA代码就是在Word中,对你编辑的代码添加行号和对"//"以后的注释部分加上颜色. 用法:选中你 ...
最新文章
- 算法与数据结构(冒泡排序,选择排序和插入排序的总结)
- Android之jni编译出现multiple definition of ‘××××ב
- 博客园添加鼠标粒子吸附特效
- 页面查询条件选框被隐藏的问题
- golang windows下杀进程
- 代码管理学:通过文档记录,实现工作传承
- linux 运行魂斗罗,如何在linux/freebsd下玩模拟器游戏_linux教程
- 股票模拟交易php,股票模拟图,股票交易记录生成器
- selenium模拟登陆12306
- 完整部署uniswap 合约、前端教程(可部署uniswap到bsc、heco)
- 利用css3实现3d立体特效--正方体
- CPU运算器、控制器、寄存器
- ROS中对URDF文件检查时出现的问题及解决方式
- Java入门之7:Java中的float和double类型的浮点数是怎么按照IEEE 754标准存储的?
- leyou商城day10 MQ介绍及详情静态页
- 网易互动直播2.0 开发 十八 双屏逻辑
- IEO大溃败进行时 |链捕手
- pycrypto下载
- 小虎对《人民的名义》小说人物人名研究V0.1
- java实现图片与base64字符串之间的转换(不适用SUN公司的sun.misc.BASE64Encoder)
热门文章
- Service简单介绍
- 【Skywalking】集成Sl4fj2报错:NoClassDefFoundError,com/lmax/disruptor/TimeoutBlockingWaitStrategy
- python成绩统计_用Python操作Excel,实现班级成绩的统计
- 【小白学爬虫连载(3)】--正则表达式详细介绍
- Lumerical学习2-使用脚本构建基础仿真结构
- 为什么要搭建独立商城系统,这7个理由说明一切
- Docker Toolbox下载安装运行镜像
- 最简易网络带宽测量(PING)
- 2023年第十五届计算机与自动化工程国际会议(ICCAE 2023)
- html幻灯片图片轮播w3,支持30+种类型幻灯片|轮播图|旋转木马的强大jQuery插件