我们的一个团队在开发一个项目时,遇到的问题是,每个人的注释格式都是不同的,例如函数头的注释类的注释等;下面是我们项目中实施的办法,我认为很值得借鉴,所以贴过来分享一下。
=================================================================================================
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.
*
*/
${package_declaration}
${typecomment}
${type_declaration}
=================================================================================================
2.类的注释格式及设置步骤如下:
=================================================================================================
Eclipse -> Window -> Preferences -> Java -> Code Style -> Code Templates -> Comments -> Types -> Edit ->把注释格式设置为:
/**
* This class is used for ...
*
* @version
* 1.0, ${date} ${time}
* @author Jiang Haiying
*/
-> OK 设置完毕。
把@author改为自己的名字拼音即可. 自动生成的代码如下:
/**
* This class is used for ...
*
* @version 1.0, Apr 22, 2010 10:05:00 AM
* @author Jiang Haiying
*/
若有需要参考别的类或方法时可以加上@see标注,例如:
/**
* This class is used for ...
*
* @version 1.0, Apr 22, 2010 10:05:00 AM
* @author Jiang Haiying
* @see com.founder.mcpm.crt.dao.IBatchCompoundAnalysisDAO
*/
在生成的JavaDoc中会生成 ” 另请参见com.founder.mcpm.crt.dao.IBatchCompoundAnalysisDAO“ 的链接。
=================================================================================================
3.类的方法注释格式设置方式:
=================================================================================================
Eclipse -> Window -> Preferences -> Java -> Code Style -> Code Templates -> Comments -> Methods -> Edit ->把注释格式设置为:
/**
* ${tags}
* @author Jiang Haiying
*/
把 @author 修改为自己的品拼音名字,生成的格式如下:
/**
* @param value
* @return
* @throws Exception
* @author Jiang Haiying
*/
public String add(String value) throws Exception {
....
}
=================================================================================================
4.注意事项
=================================================================================================
<a>.对已经存在的类,若没有版权声明注释要加上版权注释。
<b>.若对已有的类修改或增强功能,在 @author 之后再添加自己的名字并用英文逗号隔开。
例如:
/**
* This class is used for ...
*
* @version 1.0, Apr 22, 2010 10:05:00 AM
* @author Jiang Haiying, Lisa
*/
<c>.当创建新的Class时,把Generate comments选中,Eclipse会自动生成类的版权注释及类的注释,否则不会生成(需要手工修改)。
=================================================================================================
5. 接口及实现类的注释样例代码
=================================================================================================
================
接口
================
/**
* Gets total count of rows by sql string.
*
* @param sql the sql string is the filter and sort condition.
* @return return 0 if there is no data.
* @throws DAOException if it occurs an error, it will throw a DAOException exception.
* @author Jiang Haiying
*/
Integer getTotalRowCount(String sql) throws DAOException;
================
实现类
================
/*
* @see com.founder.bcimp.core.dao.IBCIMPUserDAO#getTotalRowCount(java.lang.String)
*/
@Override
public Integer getTotalRowCount(String sql) throws DAOException {
return null;
}
注意:
方法异常签名时,在@throws 之后加上异常类型 DAOException
如: @throws DAOException .......
分享到:
相关推荐
"MyEclipse代码格式化"功能就是为了解决这个问题,帮助开发者统一代码风格。 在MyEclipse中,你可以自定义代码格式化规则,或者直接导入已经设定好的代码风格配置文件。这个过程非常简单,只需要按照以下步骤操作:...
总之,通过自定义代码模板,MyEclipse使得在项目中保持一致的注释风格变得简单。无论是个人使用还是团队协作,这都是提高代码质量和团队效率的有效工具。掌握这一技巧,可以使你的编程工作更加高效和愉快。
本篇文章将深入探讨如何在Eclipse和MyEclipse中设置个性化代码注释和排版模板。 首先,我们需要了解代码注释的重要性。注释是代码的一部分,它们解释了代码的功能、用法和设计思路,有助于其他开发者理解代码。个性...
《myEclipse代码样式文件详解》 在编程领域,代码风格和格式的统一性对于团队协作至关重要。myEclipse作为一款强大的Java集成开发环境(IDE),提供了丰富的代码样式配置功能,帮助开发者定制个人或团队的代码规范...
注释文件通常包含预定义的代码注释模板,如类、方法、变量等的注释模板,它们可以极大地提高开发效率,使代码注释更规范、更一致。而“格式文件”则指的是代码格式化规则,例如缩进、空格、换行等,它能确保团队成员...
在编程世界中,良好的代码注释是至关重要的,它能帮助开发者理解代码的功能,提高团队协作效率。MyEclipse和Eclipse作为Java开发的两大神器,都提供了强大的代码注释和格式化工具。本文将深入探讨MyEclipse的Code ...
首先,编码规范是为了保证代码质量、提高团队合作效率而制定的一系列规则,包括命名约定、注释规则、代码结构等。在MyEclipse中,这些规则可以通过设置代码模板(Code Templates)和代码格式化器(Formatter)来实现...
总之,MyEclipse中的CVS版本控制提供了一种有效的方式来管理和协调团队开发,通过遵循最佳实践,可以确保代码的一致性,提高开发效率,减少因版本冲突导致的问题。在实际使用中,不断熟悉和掌握CVS的操作和规则,将...
在MyEclipse这款强大的Java集成开发环境中,对代码进行格式化、注释模板的设定以及保存时自动格式化是提升开发效率和代码质量的重要手段。下面将详细介绍这三个方面的设置方法。 首先,我们来探讨如何设置代码格式...
2. 注释模板:在开发过程中,注释是必不可少的,它们能清晰地解释代码的功能和用途。MyEclipse的注释模板支持方法、类、接口等多种级别的注释,可以快速生成标准的Javadoc格式注释。本资源中的注释模板可能是预先...
在团队协作中,推荐所有成员使用相同的代码模板和格式化规则,以降低沟通成本,提高代码的可读性和一致性。 总的来说,Eclipse和MyEclipse的代码内容模板和格式化功能是提升开发效率、保证代码质量的重要手段。合理...
在Eclipse和MyEclipse中,你可以为不同的代码类型(如类、方法、变量)创建自定义的注释模板。例如,你可以设定一个类注释模板,包含作者、日期、版权等信息,只需简单地输入快捷键或通过菜单选择,就能自动插入完整...
总结来说,通过以上步骤,你可以在MyEclipse中有效地管理`.class`文件,避免它们被提交到SVN仓库,并确保本地代码与仓库保持一致。同时,这也是一种良好的团队协作习惯,因为源代码比字节码更易于理解和审查。在进行...
前者主要用于控制代码的缩进、换行等格式化规则,后者则用于自动生成特定类型的代码结构,如类的注释、方法的注释等。 3. **导入代码模板**: 在提供的压缩包中,`nutz-eclipse-java-code-format-1.0.xml`和`nutz-...
设置完成后,可以在MyEclipse中通过"Source"菜单下的"Format"选项,一键应用这些规则到当前选中的代码或整个项目。 其次,`codetemplates.xml`文件则涉及到代码模板的定制,主要用于自动完成和生成特定的代码段。...
- 注释规则:强制添加类、方法的Javadoc,以及注释的格式。 - 缩进与空格:控制代码的缩进方式,空格的使用等。 - 空行与制表符:规定代码中空行的数量,禁止使用制表符等。 - 代码复杂度:限制方法的长度和深度,...
使用JAutodoc,开发者可以在新建或已有的源代码中插入Javadoc注释。只需选择相应的元素(类、方法、接口等),然后应用预设的模板或者自定义模板,Javadoc注释就会自动填充到相应的位置。这种方式避免了手动编写...
1. **代码风格检查**:Checkstyle 可以检测代码中的缩进、空格、命名约定、注释格式等,确保代码风格的一致性。这对于团队开发尤其重要,因为它可以减少因个人编码习惯不同而产生的冲突。 2. **错误预防**:插件会...