为MyEclipse添加注释模板(定制代码注释格式)
1.准备模板文件codetemplates.xml(将下面的内容复制到你的xml文件中即可使用):
* ${see_to_overridden}
*//**
*
*/
/**
***************************************************************
* <p>
* @CLASS : ${type_name}
* @DESCRIPTION :
* @AUTHOR : formice
* @VERSION : v1.0
* @DATE : ${date} ${time}
* </p>
*
* <p>
* @MODIFY LOG :
* @AUTHOR : formice
* @VERSION : v2.0
* @MODIFY DATE :
* </p>
****************************************************************
*//** * create a instance ${enclosing_type}.
* ${tags}
*//**
* @return the ${bare_field_name}
*/
/**
* @FILE : ${file_name}
* @PACKAGE : ${package_name}
* @COPYRIGHT : copyright(c) ${year},Rights Reserved
* @COMPANY :
* @DESCIPTION :
* @AUTHOR : formice
* @VERSION : v1.0
* @DATE : ${date} ${time}
*//**
* ${tags}
* ${see_to_target}
*//**
* @param ${param}
*//** * @description
* @author formice
* ${tags}
*/
2.将xml文件导入到MyEclipse中
Window->Preference->Java->Code Style->Code Templates,点击”Import”,导入你的注释模板文件。
3.生成注释
制的注释格式。也可以在以后写代码的时候使用自动添加注释功能,生成我们定制的注释格式。
注意:该注释模板文件在不同的电脑上模板的格式(比如缩进)可能有稍微的变动,选中Comments下的某一项,点击上面图片的,调整下就可以
了
MyEclipse设置Java代码注释模板
设置注释模板的入口:Window->Preference->Java->Code Style->Code Template 然后展开Comments节点就是所有需设置注释的元素啦。现就每一个元素逐一介绍: 文件(Files)注释标签: /** * @Title: ${file_name} * @Package ${package_name} * @Description: ${todo} * @author chenguang * @date ${date} ${time} * @version V1.0 */ 类型(Types)注释标签(类的注释): /** * 类功能说明 * 类修改者修改日期 * 修改说明 * Title: ${file_name} * Description:清大海辉科技开发平台 * Copyright: Copyright (c) 2006 * Company:北京清大海辉科技有限公司 * @author ${user} * @date ${date} ${time} * @version V1.0 */ 字段(Fields)注释标签: /** * @Fields ${field} : ${todo} */ 构造函数标签: /** * Title: * Description: * ${tags} */
方法(Constructor & Methods)标签: /** * 函数功能说明 * ${user} ${date} * 修改者名字修改日期 * 修改内容 * @param ${tags} * @return ${return_type} * @throws */ getter方法标签: /** * @return ${bare_field_name} */ setter方法标签: /** * @param ${param} ${bare_field_name} */ 加注释快捷键:选中你要加注释的方法或类,按Alt + shift + J。
Eclipse自动添加注释
Eclipse自动添加注释 我们在用Eclipse开发工具编写代码时,常常需要在类的头部加上一下注释,标明类的作者,创建时间等等。我们常用的做法是: 方式1:在新建类时勾选:Generate comments 如图1。 图1 创建类时指定生成注释 这种方式固然可以生成,但是只会是Eclipse默认的,仅有@author xxxx
方式2:快捷键生成 第二种就是我们生成类的时,也许忘了勾选。那么我们就会使用Eclipse提供的快捷键ctrl+alt+j 图2 快捷键添加注释 当然这种方式也需要开发者,现将鼠标定位类名行或者方法名行。然后生成对应的注释。那么如果我们想要自己定义自己的注释呢? 方式三:自动生成自定义注释 Eclipse最大好处就是很多东西都能让开发者自己来定义。下面说说如何自定义生成注释。 3.1首先自定义注释模板 打开:windows-->preference -->Java-->code style -->code templates --> code -->new java file 按照如上操作打开到相应对话框,如下图3
图3:注释模板对话框 当进入到这个对话框后,点击右侧“Edit”编辑按钮,进入到注释模板编辑对话框,如下图4:
图4 编辑自定义注释模板 在这个对话框中编辑你想要的注释模板,编辑完成后点击OK。 附:注释基本模板: 当点击OK退出模板编辑对话框后,勾选:automatically add comments for new methods and types,如图5
图5 设置自动添加注释 当然,你还可以设置很多注释,包括getter、setter等等的注释,都在这里,有兴趣的你都可以多试试。
JAVA开发规范
1.编程规范 (一)命名规范 1.【强制】所有编程相关的命名均不能以下划线或美元符号开始,也不能以下划线或美元符号结束 反例:_name / name_ / $name / name$ 正例:name 2.【强制】所有编程相关的命名严禁使用拼音与英文混合的方式,更不允许直接使用中文的方式。 说明:正确的英文拼写和语法可以让阅读者易于理解,避免歧义。注意,即使纯拼音命名方式也要避免采用。 反例:XingMing [姓名] /xingBie() [性别] 正例:name[姓名] sex[性别]等国际通用的名称,可视为英文。 3. 【强制】类名使用UpperCamelCase(第一个词的首字母,以及后面每个词的首字母都大写,叫做“大骆驼拼写法”) 风格,必须遵从驼峰形式,但以下情形例外:(领域模型的相关命名)DO / DTO / VO / DAO 等。正例:MarcoPolo / UserDO / XmlService / TcpUdpDeal / TaPromotion 反例:macroPolo / UserDo / XMLService / TCPUDPDeal / TAPromotion
4. 【强制】方法名、参数名、成员变量、局部变量都统一使用lowerCamelCase (第一个词的首字母小写,后面每个词的首字母大写,叫做“小骆驼拼写法”)风格,必须遵从驼峰形式。 正例: localValue / getHttpMessage() / inputUserId 5. 【强制】常量命名全部大写,单词间用下划线隔开,力求语义表达完整清楚,不要嫌名字长。 正例: MAX_STOCK_COUNT 反例: MAX_COUNT 6. 【强制】抽象类命名使用 Abstract或Base 开头;异常类命名使用 Exception结尾;测试类命名以它要测试的类的名称开始,以 Test 结尾。 7. 【强制】中括号是数组类型的一部分,数组定义如下:String[] args; 请勿使用String args[]的方式来定义 8. 【强制】POJO类中的任何布尔类型的变量,都不要加 is,否则部分框架解析会引起序列化错误。 反例:定义为基本数据类型 boolean isSuccess;的属性,它的方法也是isSuccess(),RPC框架在反向解析的时候,“以为”对应的属性名称是 success,导致属性获取不到,进而抛出异常。
Java文件上传类FileUploadUtil.java代码+注释
? 一个通用的Java文件上传类,支持上传图片,支持生成缩略图,设置最大上传文件字节数,不设置时默认10M,可接收来自表单的数据,当有多个文件域时, 只上传有文件的,忽略其他不是文件域的所有表单信息,支持用户对上传文件大小, 字节进行设置,本上传类可过滤掉以下文件类型:".exe", ".com", ".cgi", ".asp", ".php", ".jsp"等,你可自已添加过滤的文件后缀,上传文件时如果没有上传目录,则自动创建它。。。 ? package com.gootrip.util; import java.io.File; import java.util.*; import https://www.360docs.net/doc/a65864427.html,mons.fileupload.*; import javax.servlet.http.HttpServletRequest; import java.util.regex.Pattern; import java.io.IOException; import https://www.360docs.net/doc/a65864427.html,mons.fileupload.servlet.ServletFileUpload; import https://www.360docs.net/doc/a65864427.html,mons.fileupload.disk.DiskFileItemFactory; import java.util.regex.Matcher; /** * TODO 要更改此生成的类型注释的模板,请转至 * 窗口-首选项- Java -代码样式-代码模板 */ public class FileUploadUtil {
//当上传文件超过限制时设定的临时文件位置,注意是绝对路径 private String tempPath = null; //文件上传目标目录,注意是绝对路径 private String dstPath = null; //新文件名称,不设置时默认为原文件名 private String newFileName = null; //获取的上传请求 private HttpServletRequest fileuploadReq = null; //设置最多只允许在内存中存储的数据,单位:字节,这个参数不要设置太大 private int sizeThreshold = 4096; //设置允许用户上传文件大小,单位:字节 //共10M private long sizeMax = 10485760; //图片文件序号 private int picSeqNo = 1; private boolean isSmallPic = false; public FileUploadUtil(){ } public FileUploadUtil(String tempPath, String destinationPath){ this.tempPath = tempPath; this.dstPath = destinationPath; }
程序代码注释编写规范
程序代码注释编写规范 为提高控制程序的阅读性与可理解性,现制定相关代码程序代码注释编写的编写规范。 一般情况下,源程序有效注释量必须在20%以上,注释的原则是有助于对程序的阅读理解,在该加的地方都加了,注释不宜太多也不能太少,注释语言必须准确、易懂、简洁。 常规注释有以下两种方式。 单行:以"//"符号开始,任何位于该符号之后的本行文字都视为注释。 多行:以"/*"符号开始,以"*/"结束。任何介于这对符号之间的文字都视为注释。 一、说明性文件 说明性文件(如头文件.h文件、.inc文件、.def文件、编译说明文件.cfg等)头部应进行注释,注释必须列出:版权说明、版本号、生成日期、作者、内容、功能、与其它文件的关系、修改日志等,头文件的注释中还应有函数功能简要说明。 示例:下面这段头文件的头注释比较标准,当然,并不局限于此格式,但上述信息建议要包含在内。 /************************************************* COPYRIGHT (C), MicTiVo International. Co., Ltd. File NAME: // 文件 Author: Version: Date: // 作者、版本及完成日期 DESCRIPTION: // 用于详细说明此程序文件完成的主要功能,与其他模块 // 或函数的接口,输出值、取值范围、含义及参数间的控 // 制、顺序、独立或依赖等关系 Others: // 其它内容的说明 Function List: // 主要函数列表,每条记录应包括函数名及功能简要说明 1.... History: // 修改历史记录列表,每条修改记录应包括修改日期、修改 // 者及修改内容简述 1. Date: Author: Modification: 2. .. *************************************************/ 二、源文件头 源文件头部应进行注释,列出:版权说明、版本号、生成日期、作者、模块目的/功能、主要函数及其功能、修改日志等。 示例:下面这段源文件的头注释比较标准,当然,并不局限于此格式,但上述信息建议要包含在内。 /************************************************************ COPYRIGHT (C), MicTiVo International. Co., Ltd. FileName: Author:
java注释模板
采购订单范本.doc
采购订单 供方:订单号: 联系人: 联系人: 电话: 电话: 传真: 传真: 物料品名规格数量单位交期单价(¥) 合计(¥)备注 金额合计(大写):金额合计(小写): 交货地点: 一、交货原则: 1、供应商收到订单后,请检查单价、数量、产品规格、交货期,确认后回传,8小时内未回传视为默认; 2、供应商必须在采购周期内或因特殊原因由双方共同协商的期限内将货物交到需方处,每延迟半个工作日交货按货款总额30%赔 偿违约金,我司直接在货款中扣除;对因延误我司交期造成的其它损失,我司保留索赔权利; 供 3、供应商在规定时间内所送物料必须符合订单要求,送错料或送少料,应在一天内更换或补料,否则,所带来的损失由供应商全 部承担。 应 二、不良品处理: 条 1、不合格或不符合送样规格,我司一律拒收,同时,造成的误工误时误料以及我司客户的索赔,供应商须承担全部责任; 2、供应商必须在我司采购部书面或电话通知的时间内处理好供应物料的不良品,否则,48小时后我司将自行处理 例 四、付款原则: 1、结款前,供应商须在规定时间内传真对帐单到我公司对好帐; 2、结款时,须有加盖贵司公章的送货单回单(必须注明我司本厂订单号和采购单号)、收据及我司入库单。 1 特别提示:本协议仅供参考和学习使用,请使用者结合自 身实际情况进行合理的调整,如有需要可联系交流。鉴于法律及各地的法规 存在调整、变更及发布者自身时间安排限制等因素,发布者无法做到实时变更条款,建议阅看人在使用时及时的咨询专业律师,以确 保自身合法权益。
备 注1. 请供应商务必按照“供应条列”与我司合作,否则,所产生的后果由供应商自行解决 2. 请供应商务必开据送货单且在送货单上注明我司订单号码和所下单数量; 3. 谢谢合作! 采购员:批准:供应商加签: 日期:日期: 2 特别提示:本协议仅供参考和学习使用,请使用者结合自身实际情况进行合理的调整,如有需要可联系交流。鉴于法律及各地的法规 存在调整、变更及发布者自身时间安排限制等因素,发布者无法做到实时变更条款,建议阅看人在使用时及时的咨询专业律师,以确保自身合法权益。
软件总代码行数_软件注释率_分析
文档名称:软件总代码行数_软件注释 率分析 作者: 日期:
1. cncc 1.1 工具简介 度量工具名称cncc 网址https://www.360docs.net/doc/a65864427.html,/ 操作方式命令行 实现语言C++ 适用的操作系统Windows 可以度量的属性code-lines, empty-lines, comment-lines, total-lines 备注 1.2 工具优缺点总结 最新版本 cncc-1-3-1,在sourceforge中2004年已经停止更新。最大的优点是源代码全部存于一个cpp文件,便于集成。 缺点: 1.代码基本没有注释。 2.下载的代码编译有9个错误。 3.费了2个多小时也没搞定。 1.3 使用例程 无。 2. CodeCount 2.1 工具简介 度量工具名称CodeCount 网址https://www.360docs.net/doc/a65864427.html,/downloads421/sourcecode/windows
/control/detail1783204.html 操作方式GUI 实现语言C++ 适用的操作系统Windows 可以度量的属性total-lines, empty-lines, comment-lines, code-lines, 备注 2.2 工具优缺点总结 优点: 工具比较精简,统计源文件总行数、代码行数、空白行数、注释行数,代码有一定的注释。 缺点: 下载的源码是vc7工程,由于机器并没有vc7,利用工具进行工程类型转换,将vc7的工程转换为vc6的工作,编译出错。 核心代码如下: BOOL bCommentSet = FALSE; //注释行统计标识有"/*"时TRUE, "*/"时FALSE BOOL bQuatoSet = FALSE; //字符串统计标识首次一行有奇数个"时TRUE, 下一行有奇数个"时FALSE int nLength = (int)file.GetLength(); CString bufRead; int nLineCommentBegin = 0; while(file.ReadString(bufRead)!=FALSE) { BOOL bStatedComment = FALSE;//本行作为注释行是否已统计过 BOOL bStatedCode = FALSE; //本行作为代码行是否已统计过 nLines++; bufRead.TrimLeft(); //先将文件头的空格或制表符去掉 if(bufRead.GetLength()==0) //为空白行
参考文献与注释的编排方法.doc
参考文献与注释的编排方法 一、注释的标注方法 注释是对论著正文中某一特定内容的进一步解释或补充说明,以及未公开发表的私人通信、内部资料、书稿和仅有中介文献信息的"转引自"等类文献的引用著录,排印在该页地脚(数字加圆圈,如①、②...)。 二、参考文献的标注方法 参考文献是作者写作论著时所引用的已公开发表的文献书目,或有明确收藏地点的善本、档案,按照在正文中引用的顺序,用数字加方括号集中列表于文末。正文中的标注方法是:1.引用文献原文需要在正文中标出序号与页码(如:"资本主义生产的内在规律在竞争中是以颠倒的形式表现出来的"[1]251),文后参考文献中不出现页码项;2.引用参考文献中的观点可以只标出序号或者序号与页码同时标注(如:生产力决定生产关系[3]);3.文中多次引用同一参考文献内容,在文后参考文献表中只出现一次,其中不注页码;在正文中标注首次引用的文献序号,并在序号的角标外著录引文页码;4.参考文献的编排格式见附注。 例文 国内外现有的竞争理论文献,或者忽略了马克思的竞争理论,或者只把它作为竞争理论发展的一个阶段或众多竞争理论中的一个流派,停留在马克思对市场竞争过程的描述上。然而,马克思指出:"资本主义生产的内在规律在竞争中是以颠倒的形式表现出来的"[1]251。"只有了解了资本的内在本性,才能对竞争进行科学的分析,正像只有认识了天体的实际的、
但又直接感觉不到的运动的人,才能了解天体的表面运动一样。"[2]352 ...... ......而且可以说明,当时政治经济学没有理解的"关于资本主义竞争的基本规律,即调节一般利润率和由它决定的所谓生产价格的规律,也是建立在商品价值和商品成本价格之间的这种差别之上的,建立在由此引起的商品低于价值出售也能获得利润这样一种可能性之上的"[1]45。 ...... ......随着许多偶然的改进,产品系列趋于增大,零件数量趋于增加,会产生大量的多样化成本。[3] 参考文献: [1] 马克思.资本论(第3卷)[M].北京:人民出版社,1975. [2] 马克思.资本论(第1卷)[M].北京:人民出版社,1975. [3] 安德森·派恩二世.21世纪企业竞争的新前沿——大规模定制模式下的敏捷产品开发[M].北京:机械工业出版社,1999. 附注: 一、参考文献著录项目 1. 主要责任者 (专著作者、论文集主编、学位申报人、专利申请人、报告撰写人、期刊文章作者、析出文章作者)。多个责任者之间以","分隔,注意在本项数据中不得出现缩写点"."。主要责任者只列姓名,其后不加"著"、"编"、"主编"、"合编"等责任说明。 2.文献题名; 3.文献类型及载体类型标识;
Zdeveloper代码规范模板
Zdeveloper2.x代码规范1 ZDeveloper命名规范 常见JAVA包命名(以platform插件为例)。 2 公共包 plugins存放所有插件配置文件; lang存放所有插件国际化配置文件; JAVA存放所有插件java类文件; DB目录存放zdm文件。
3 一般情况java包 *.ui子包存放本插件所属UI类(*.ui省略前面的com.zving.platform,下同); *.service子包存放本插件所属扩展服务类; *.service.impl子包存放扩展服务项实现类; *.extend子包存放本插件扩展相关的类( 扩展点接口类或抽象类) ; *.extend.impl子包存放本插件扩展实现类( 扩展行为或其它扩展实现类) ; *.bl子包存放本插件所属后台业务逻辑类。 4 特殊扩展服务用到java包 *.code子包存放本插件所属扩展代码管理扩展服务的扩展项类; *.privilege子包存放本插件扩展菜单权限服务的扩展项类; *.config子包存放本插件扩展配置项扩展服务的扩展项类; *.properties子包存放本插件扩展栏目或站点配置项相关的扩展服务的扩展项类; *.tag子包存放本插件扩展标签服务的扩项类; *.tempalte子包存放本插件扩展模板服务的扩展项类;
( 插件包的命名参展以上方式, 项目需要能够酌情添加有一定意义的子包) 5 插件包 插件包统一以”com.zving.”+插件名称来命名(公司名称域名+插件名称)。 6 插件类 插件名称+”Plugin”, 位于插件所属包根目录下。 7 插件配置文件 ”com.zving.”+插件名称+”.plugin”。 8 UI类 页面名称+”UI”, 类存放位置为”com.zving.”+插件名称+”.ui”子包。
【IT专家】给AndroidStudio加上类注释,方法注释模板
给AndroidStudio加上类注释,方法注释模板2016/09/27 0 给AndroidStudio加上Eclipse一样的注释模板:首先添加方法注释:File- Settings- Editor(展开)- Live Templates(如图示:)然后继续点击图示的加号,这次选择第一个,选择输入的cmt表示在方法前输入cmt回车就会自动添加上注释模板在方法上面输入cmt回车自动可引入模板注释 ?================2016年9月27日23:21:41===================== ?然后是类创建的时候生成的注释模板: ?新建Class类的时候会自动生成: ?方法说明:地址:https://jetbrains/help/idea/2016.2/edit-template-variables-dialog.html ?我的类注释: ?/** * @name ${PROJECT_NAME} * @class name:${PACKAGE_NAME} * @class describe * @anthor ${USER} QQ:1032006226 * @time ${DATE} ${TIME} * @change * @chang time * @class describe */方法注释模板: ?/** * @author $user$ * @time $date$ $time$ * @describe $param$ */ /** * description :* project name:${PROJECT_NAME} * author : ${USER} * creation date: ${DATE} ${TIME} * @version 1.0 */我只是写在这里,免得重复写,看官自便?tips:感谢大家的阅读,本文由我司收集整编。仅供参阅!
采购订单范本
采购订单范本 篇一:采购订单模板 采购订单 合同编号:日期:项目名称:行业属性:甲方(购货方):乙方(供货方): 一、合同标的 二、质量要求、技术标准、乙方对质量的条件和期限:。 三、清算方式及期限 。 四、交货时间及地点 1、交货时间:。 2、交货地点:。 七、设计联络、试验、检验:按合同及甲方要求免费实施。乙方为甲方提供全方面的售前、售中、售后服务,以及各种技术咨询等,技术咨询服务电话:。 甲方:(盖章)代表人(签字):日期:地址: 电话:收货联系人: 收货人电话: 乙方:(盖章)代表人(签字):日期:开户行:账号:税号:地址:电话: 1 / 1 篇二:外贸采购订单双语版
采购订单Purchase Order 采购订单号:订单日期: 申请人:审核: 注:Remark Please click our requirements of the invoice issued corresponding tax rate, invoice note column must indicate the order number and the corresponding our your company's delivery order number. 1.请按我司要求开具相应税率的发票,发票备注栏内必须注明我司对应的订单号码和贵司的送货单号码。 2.贵司送货时出示的送货单必须正确无误地填写我司的订单号码、规格、数量。 When sending your company produce the delivery note should be correct and fill in we order number, specification, quantity. When sending to each product must make proper and packaging, packaging to indicate this product in the drawing number, name, and the corresponding number Please strict quantity to quality, on time delivery if because of your company quality, quantity, delivery time and so on the force majeure cause influence our, our company has right to pursue responsibility;For our losses to your company, our company have the right to claim for compensation. The goods sent to us by our inspection, and get our purchasing
idea,注释模板
竭诚为您提供优质文档/双击可除 idea,注释模板 篇一:idea快捷键 一常用快捷键 alt+回车导入包,自动修正,当引入的类需要异常捕获的时候 ctrl+shift+space自动补全代码,“new”字符,还可以引入强制转换的ctrl-alt-space可以自动导import类名或接口名提示,以及new后面的提示ctrl+n查找类 ctrl+shift+n查找文件 ctrl+shift+alt+n查找类中的方法或变量 ctrl+shift+alt+s:打开projectstructure ctrl+shift+F7选中文本,高亮显示所有该文本,按esc 高亮消失。ctrl+shift+F9编译类 ctrl+shift+F10运行类 crtl+shift++打开所有关闭的方法,crtl++打开当前关闭的方法 输入/**即可自(idea,注释模板)动写上该方法参数的注释
ctrl-shift-j快捷键把两行合成一行并把不必要的空 格去掉以匹配你的代码格式。ctrl-shift-V快捷键可以将最近使用的剪贴板内容选择插入到文本。使用时系统会弹出一个含有剪贴内容的对话框,从中你可以选择你要粘贴的部分。 ctrl+shift+up/down代码向上/下移动。 ctrl+shift+t自动创建测试类 ctrl+alt+s:打开settings ctrl+alt+l格式化代码 ctrl+alt+o优化导入的类和包 ctrl+alt+V快速为后面生成变量,如new或者方法的返回类型。ctrl+alt+left/right返回至上次浏览的位置ctrl-alt-b可以导航到一个抽象方法的实现代码。 ctrl-alt-t,选中某段代码,可以快速包围用if,try 等。在options|Filetemplates|codetab中你还可以自己定制产生捕捉块的模板。 alt+insert生成代码(如get,set方法,构造函数等) alt+shift+up/down代码向上/下移动。 alt+up/down在方法与类属性间快速移动定位 alt+F1查找代码所在位置 alt+1快速打开或隐藏工程面板 alt+left/right切换代码视图 alt+F3,选中文本,逐个往下查找相同文本,并高亮显
java注释规范总结大全
在软件开发的过程中总是强调注释的规范,但是没有一个具体的标准进行说明,通常都是在代码编写规范中简单的描述几句,不能作为一个代码注释检查的标准和依据,做什么都要有一个依据吗:),现在我特整理了一个《Java的注释规范》,内容来自网络、书籍和自己的实际积累。 JA V A注释规范 版本/状态作者版本日期 1.0 ghc 2008-07-02 一、背景 1、当我们第一次接触某段代码,但又被要求在极短的时间内有效地分析这段代码,我们需要什么样的注释信息? 2、怎么样避免我们的注释冗长而且凌乱不堪呢? 3、在多人协同开发、维护的今天,我们需要怎么样的注释来保证高质、高交的进行开发和维护工作呢? 二、意义 程序中的注释是程序设计者与程序阅读者之间通信的重要手段。应用注释规范对于软件本身和软件开发人员而言尤为重要。并且在流行的敏捷开发思想中已经提出了将注释转为代码的概念。好的注释规范可以尽可能的减少一个软件的维护成本, 并且几乎没有任何一个软件,在其整个生命周期中,均由最初的开发人员来维护。好的注释规范可以改善软件的可读性,可以让开发人员尽快而彻底地理解新的代码。好的注释规范可以最大限度的提高团队开发的合作效率。长期的规范性编码还可以让开发人员养成良好的编码习惯,甚至锻炼出更加严谨的思维能力。 三、注释的原则 1、注释形式统一 在整个应用程序中,使用具有一致的标点和结构的样式来构造注释。如果在其他项目组发现他们的注释规范与这份文档不同,按照他们的规范写代码,不要试图在既成的规范系统中引入新的规范。 2、注释的简洁 内容要简单、明了、含义准确,防止注释的多义性,错误的注释不但无益反而有害。 3、注释的一致性 在写代码之前或者边写代码边写注释,因为以后很可能没有时间来这样做。另外,如果有机会复查已编写的代码,在今天看来很明显的东西六周以后或许就不明显了。通常描述性注释先于代码创建,解释性注释在开发过程中创建,提示性注释在代码完成之后创建。修改代码的同时修改相应的注释,以保证代码与注释的同步。 4、注释的位置 保证注释与其描述的代码相邻,即注释的就近原则。对代码的注释应放在其上方相邻或右方的位置,不可放在下方。避免在代码行的末尾添加注释;行尾注释使代码更难阅读。不过在批注变量声明时,行尾注释是合适的;在这种情况下,将所有行尾注释要对齐。 5、注释的数量 注释必不可少,但也不应过多,在实际的代码规范中,要求注释占程序代码的比例达到20%左右。注释是对代码的“提示”,而不是文档,程序中的注释不可喧宾夺主,注释太多了会让人眼花缭乱,注释的花样要少。不要被动的为写注释而写注释。 6、删除无用注释
7IDEA类和方法注释模板设置--wRitchie
IDEA类和方法注释模板设置 作者:wRitchie 来源:https://www.360docs.net/doc/a65864427.html, IDEA自带的注释模板不是太好用,整理了一下制作了一份比较完整的模板,这里设置的注释模板采用Eclipse的格式,下面先贴出Eclipse的注释模板,我们就按照这种格式来设置: 类注释模板: 方法注释模板: 一、首先我们来设置IDEA中类的模板: 设置类注释模板 1.选择File–>Settings–>Editor–>File and Code Templates–>Includes–>File Header.
2、效果图展示 IDEA没有智能到自动创建方法注释,需手动为方法添加注释,使用Eclipse时我们生成注释的习惯是/**+Enter,也按照这种习惯来设置IDEA的方法注释 1、File-->Settings-->Editor-->Live Templates
(1)新建组:命名为wRitchie (2)新建模板:命名为*
注:因为IDEA生成注释的默认方式是:/*+模板名+快捷键(例:若设置模板名为add,快捷键用Tab,则生成方式为/*add+Tab)若不采用这样的生成方式,IDEA中没有内容的方法将不可用,例如:获取方法参数的methodParameters()、获取方法返回值的methodReturnType() (3)设置生成注释的快捷键 (4)设置模板 模板内容如下,注意第一行,只有一个“*”而不是“/*”,在设置参数名时必须用:${参数名}$的方式,否则第五步中读取不到你设置的参数名 * * @Author: wRitchie * @Description: $description$ * @Param: $params$ * @return: $returns$ * @Date: $date$ $time$
论文要求及注释格式
《**文学》课程论文布置 总体要求: 1.以小论文方式完成; 2.为让同学认真准备,有足够时间完成,第10周即5月6号统一提交论文; 3.须交手写稿,不交电子稿。请学委按班级学号顺序统一整理后提交给教师; 4.教师阅读后会就作业进行课堂讲解; 5.期中成绩占期末总成绩的30%。请同学认真完成,如果对本次安排有意见或建议, 请及时提出,以便进行修改与改进。 评论**的小说《***》 说明与具体要求: 1.具体题目自行拟定。论文不必过于忧虑写得好坏,重在通过自己的努力,尝试了解、学习论文写作的基本规范与要求,为将来从事论文写作打下基础。 2.要探讨的论题主题不宜太大,要考虑可行性,尽量选一个角度深入研究。尤其注意 言之有据、充实而不发空论。不要写成读后感、作品欣赏或导读。 3.论文篇幅不少于2500字。 4.论文可以借鉴他人,但不能抄袭,用自己的语言和构思。 5.论文格式请参照我在网络教学平台教学材料中上传的学术论文,或者自行查找学习 知网上或图书馆、资料室专业杂志的论文。论文大体包括题目、摘要、关键词、主体、注释、参考文献等几个部分。 6.注意区别注释与参考文献。注释是指在文章中,具体引用了他人的观点、材料处的 注解。注释体例分文内注(在某处加括号的形式注明)、文末注、页脚注。本科生论文一般 以后两种为多,可以任选一种。参考文献一般指整篇文章曾经借鉴而不能或不必具体指出某 处的著作或文章。一般放在整篇论文后面。 7.以下附注释方式。大体可以作两种选择(以下以注释例说明),请根据自己的习惯选 择与学习。 注释方式一: 著作: 作者、著作名、出版者、出版年份、页码(这些要素的位置可以变动,但要求齐全并全文统一)
java《注解解析》
Java注解(Annotation)
(1) Annotation(注释)是JDK5.0及以后版本引入的。它可以用于创建文档,跟踪代码中的依赖性,甚至执行基本编译时检查。注释是以‘@注释名’在代码中存在的,根据注释参数的个数,我们可以将注释分为:标记注释、单值注释、完整注释三类。它们都不会直接影响到程序的语义,只是作为注释(标识)存在,我们可以通过反射机制编程实现对这些元数据的访问。另外,你可以在编译时选择代码里的注释是否只存在于源代码级,或者它也能在class文件中出现。 元数据的作用 如果要对于元数据的作用进行分类,目前还没有明确的定义,不过我们可以根据它所起的作用,大致可分为三类: 编写文档:通过代码里标识的元数据生成文档。 代码分析:通过代码里标识的元数据对代码进行分析。 编译检查:通过代码里标识的元数据让编译器能实现基本的编译检查。 基本内置注释 @Override Java代码 1. package com.iwtxokhtd.annotation; 2. /** 3. * 测试Override注解 4. * @author Administrator 5. * 6. */ 7. public class OverrideDemoTest { 8. 9. //@Override 10. public String tostring(){ 11. return "测试注释"; 12. } 13. } package com.iwtxokhtd.annotation; /** * 测试Override注解 * @author Administrator * */ public class OverrideDemoTest { //@Override
合同(订单采购)范本
合同编号:【】 采购合同 甲方:【】 联系人:【】 地址/邮编:【】 电话/传真:【】 乙方:【】 联系人:【】 地址/邮编:【】 电话/传真:【】 (甲方与乙方在本合同中单独称为“一方”,合称为“双方”) 甲、乙双方根据《中华人民共和国合同法》及相关法律法规规定,本着友好合作、协商一致的原则,就甲方向乙方采购【】(下称“货物”)事宜达成一致意见,并签订本合同,以兹共同遵守。 一、合同期限 本合同有效期自【】年【】月【】日起至【】年【】月【】日止。甲方将于合同期内以订单(订单格式见附件一)形式向乙方采购货物。 二、货物价格 本合同项下货物价格(详见附件二:报价单)为包干单价,该价格已包括货物制造/销售、包装、运输、保险【、安装调试】等全部成本费用及应得利润、所有税费等。 三、质量要求、技术标准、乙方对质量负责的条件和期限 1、本合同项下货物应为原厂生产,质量符合国家、行业标准(以最新国家执行标准为准)及本合同约定,否则,乙方应负责更换;如更换后仍不能达到本合同约定标准,甲方有权退货。
2、乙方承诺所提供货物符合国家环保有关规定,且不能对甲方的正常使用人员造成任何人身损害,否则,乙方应承担由此造成的全部损失。 3、乙方所供应所有货物其规格、型号均按采购要求提供,未经甲方允许不得以任何形式进行调整或更换。 4、货物的复试、检验所产生的费用由乙方承担,若发生试验不合格并以投入使用,所引起的直接经济损失由乙方承担。 5、乙方在交付货物时,应随车送达并下甲方提交【】: (1)产品合格证、质保卡; (2)产品检验报告; (3)产品使用说明书; (4)产地来源证明; (5)厂方生产证明; (6)重要部件清单、产地、品牌(尤其是进口部件); (7)维修手册或保养说明书; (8)安装手册; (9)其他有关所供货物的文件。 乙方提供了任何上述文件并不当然地减轻或免除乙方在本合同内的其他责任。如因乙方没有提供相应的合格证明造成甲方任何损失的,由此造成的损失由乙方承担。 6、本合同项下货物质保期为【】年,自货到甲方、【安装调试完毕】并经验收合格之日起计算。质保期内,如货物出现质量问题或者不能达到使用要求,甲方可以要求乙方在24小时内进行退换,乙方应予退换,并承担因此而产生的一切费用和甲方遭受的一切损失。 四、交货期限 甲方根据实际需要向乙方发出订单,乙方在收到订单后的【】日内交货【并安装调试完毕】;如甲方有紧急需要的,乙方同意按订单上甲方要求时间交货【并安装调试完毕】。 五、包装 乙方应为货物提供适宜货物运输的包装方式,包装上应根据货物实际情况注明防潮、防湿、防震、防锈等,对由于包装不良所发生的损失及因采用不充分或
java注释规范
设置注释模板的入口: Window->Preference->Java->Code Style->Code Template 然后展开Comments 节点就是所有需设置注释的元素啦。现就每一个元素逐一介绍: 文件(Files)注释标签: /** * @Project: ${project_name} * @Title: ${file_name} * @Package ${package_name} * @Description: ${todo} * @author jeffshaw jeff_chon@https://www.360docs.net/doc/a65864427.html, * @date ${date} ${time} * @Copyright: ${year} https://www.360docs.net/doc/a65864427.html, Inc. All rights reserved. * @version V1.0 */ 类(Types)注释标签(类的注释): /** * @ClassName: ${type_name} * @Description: ${todo} * @author jeffshaw jeff_chon@https://www.360docs.net/doc/a65864427.html, * @date ${date} ${time} * * ${tags} */ 字段(Fields)注释标签: /** * @Fields ${field} : ${todo} */ 构造函数标签: /** * Title: * Description:
* ${tags} */ 方法(Constructor & Methods)标签: /** * @Title: ${enclosing_method} * @Description: ${todo} * @param ${tags} 设定文件 * @return ${return_type} 返回类型* @throws */ 覆盖方法(Overriding Methods)标签: /* (非 Javadoc) * Title: ${enclosing_method} * Description: * ${tags} * ${see_to_overridden} */ 代表方法(Delegate Methods)标签: /** * ${tags} * ${see_to_target} */ getter方法标签: /** * @return ${bare_field_name} */