- 1、原创力文档(book118)网站文档一经付费(服务费),不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。。
- 2、本站所有内容均由合作方或网友上传,本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺!文档内容仅供研究参考,付费前请自行鉴别。如您付费,意味着您自己接受本站规则且自行承担风险,本站不退款、不进行额外附加服务;查看《如何避免下载的几个坑》。如果您已付费下载过本站文档,您可以点击 这里二次下载。
- 3、如文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“版权申诉”(推荐),也可以打举报电话:400-050-0827(电话支持时间:9:00-18:30)。
- 4、该文档为VIP文档,如果想要下载,成为VIP会员后,下载免费。
- 5、成为VIP后,下载本文档将扣除1次下载权益。下载后,不支持退款、换文档。如有疑问请联系我们。
- 6、成为VIP后,您将拥有八大权益,权益包括:VIP文档下载权益、阅读免打扰、文档格式转换、高级专利检索、专属身份标志、高级客服、多端互通、版权登记。
- 7、VIP文档为合作方或网友上传,每下载1次, 网站将根据用户上传文档的质量评分、类型等,对文档贡献者给予高额补贴、流量扶持。如果你也想贡献VIP文档。上传文档
查看更多
网络在线考试系统软件实现
软件实现网络在线考试系统姓 名: 班级:计科1201学号:121110011 引言1.1目的和作用衡量一个程序的质量,主要有两个方面:运行质量和代码质量。一个稳定运行的程序并不等同于优良的程序,有可能其源代码可读性极差,不具有低成本的可维护性,以后的升级或者新员工接手时都会非常困难,对公司来说,意味着更高的资源投入,对工程师来说,意味着精力时间的浪费,甚至会引起对程序的抵制情绪,导致推翻重新实现,降低了软件复用度。当然,程序的运行质量是必须保证的,否则代码再规范也是一个废品。事实上,程序的不良书写风格和错误的写法往往是滋生错误的温床,而且很大一部分反复出现的错误是同一个原因造成的。本文档结合一些常见的错误或者危险的代码,规定了编码的规范,按照规范上的要求编码,不仅可以使不同人写的代码看起来很统一,降低了交流的障碍和工作转接的成本,而且能够规避很多反复出现的程序错误。1.2 文档概述该规范定义了良好的编程风格,内容涉及排版,可读性,可维护性,可测性等方面。2 编码规范2.1 文件组织每个Java源文件包含一个单独的Public类接口或接口。当private类和接口与某个Public类有关部门时,可以把他们放在同一源文件中作为Public类。Public类应为文件中第一个类或接口。Java源文件中有下列顺序:(1)开头注释;(2)包和引用声明,如:package u.lms.utils;import java.sql.Connection;import java.sql.DriverManager;(3)类和接口定义下面表格按序定义了一个类或接口的定义的各个部分。表5.1类和接口定义序号类/接口定义部分说明1类/接口文档注释(/**….*/)见注释2类/接口声明3类/接口执行注释可选,需包含不在类/接口文档注释的关于类/接口的所有信息4类静态变量先是Public类变量,再protected,再private5实例变量同上6构造函数7方法按功能排序2.2 文件格式标准2.2.1 缩排缩排的单位,逻辑Tab键,统一缩进为4个字符。2.2.2换行当一个表示不能在一行内写完时,按以下规则断行:在逗号后断行。在操作符前断行。宁可选择较高级别(higher-level)的断开,而不是较低级别(lower-level)的断开。新的一行应该与上一行同一级别表达式的开头处对齐。如果以上规则导致代码混乱或者使代码都堆挤在右边,那就代之缩进8个空格。2.2.3空白应谨慎使用空行来突出代码。例:在循环和条件块前后至少有一个空行。函数间至少有一个空行。注释前至少有一个空行。2.2.4 行长度尽量避免一行的长度超过80个字符,因为很多终端和工具不能很好处理之。注意:用于文档中的例子应该使用更短的行长,长度一般不超过70个字符。2.2.5数值语句不要用硬性代码数值。用符号常量。例:nTimeout = 3000; //BAD!!NTimeout = MAX_ABC_DURATION; //Good2.3 注释注释是帮助程序读者的一种手段。最好的注释是简洁地点明程序的突出特征,或是提供一种概观,帮助别人理解程序。Java程序有两类注释:实现注释(implementation comments)和文档注释(document comments)。实现注释使用/ * …… * / 和//界定的注释。文档的注释(被称为“doc comments”)是Java独有的,并由/* * …… */界定。文档注释可以通过javadoc工具转换 HTML文件。2.3.1 文件头注释一个文件由被空行隔开的节和可选的标识节的注释组成。一个包声明和接口声明需用至少一个空行隔开。每个文件需在开头包括一个注释块,提供以下信息:版权声明,修改历史。/**数据库连接管理类 * @author WangLiyun * @version1.0 */2.3.2类注释每个源文件需在类声明前包含一个注释,提供以下信息:作者,版本。/* **pre * Window win = new window(parent); * win.show(); */pre **@author Sami Shaic *version % I %,% G % *see java.awt.BaseWindow *see java.awt.Button */ class window extends BaseWindow{… }2.2.3 方法头注释每个函数要在开头提供一个注释,包含以下信息:描述做了什么,如何完成的;假设,前提,限制;输入输出,包括返回值。/** * 用户登录 * * @param mapping * @param form * @param request * @param response * @
文档评论(0)