java项目开发规范文档,java开发文档编写规范

发布时间：2022-11-17

本文目录一览：

  1. Java项目开发标准
  2. 一套完整的JAVA项目包括哪些部分？
  3. java 项目需求文档要怎么写？
  4. java软件开发的代码规范
  5. 如何书写Java项目的开发文档
  6. 北大青鸟java培训：Java编程开发规范及其技巧？

Java项目开发标准

你可以看一个东西，叫做cmmi。 CMMI全称是Capability Maturity Model Integration，即能力成熟度模型集成（也有称为：软件能力成熟度集成模型），是美国国防部的一个设想，1994年由美国国防部（United States Department of Defense）与卡内基-梅隆大学（Carnegie-Mellon University）下的软件工程研究中心（Software Engineering Institute，SEISM）以及美国国防工业协会（National Defense Industrial Association）共同开发和研制的，他们计划把现在所有现存实施的与即将被发展出来的各种能力成熟度模型，集成到一个框架中去，申请此认证的前提条件是该企业具有有效的软件企业认定证书。 其目的是帮助软件企业对软件工程过程进行管理和改进，增强开发与改进能力，从而能按时地、不超预算地开发出高质量的软件。其所依据的想法是：只要集中精力持续努力去建立有效的软件工程过程的基础结构，不断进行管理的实践和过程的改进，就可以克服软件开发中的困难。CMMI为改进一个组织的各种过程提供了一个单一的集成化框架，新的集成模型框架消除了各个模型的不一致性，减少了模型间的重复，增加透明度和理解，建立了一个自动的、可扩展的框架。因而能够从总体上改进组织的质量和效率。CMMI主要关注点就是成本效益、明确重点、过程集中和灵活性四个方面。 CMMI 是现在来说最为规范的项目开发标准。一般上点规模的公司都起码要过cmmi3级才行。

一套完整的JAVA项目包括哪些部分？

  1. 项目启动
    1. 项目组成立（公司成员、客户成员）
    2. 制定项目预期目标
    3. 制定项目计划周期
    4. 建立好项目组成员沟通机制
  2. 需求调研
    1. 创建调研计划、协调调研时间
    2. 收集客户资料，获取客户需求 所有的资料都需要保留一份，资料中存疑的需要及时询问
    3. 编写需求文档 重点描述出客户的业务流程和性能要求。 采用Word、Excel、Rose等形式。
    4. 需求变更记录
    5. 确定开发环境和运行环境
    6. 扩展性要求
    7. 与旧系统的接驳要求。
    8. 估算出项目工作量 本阶段需要一套需求管理系统来进行需求的管理。本阶段的需求文档也是用户测试的依据。
  3. 系统设计/详细设计 一个系统可以分为基础平台和应用模块两部分。
    1. 选择基础平台，无论是采用第三方平台还是自行开发平台，都需要深入了解，查看是否符合要求。
    2. 应用模块设计（针对业务流程）
    3. 中间件的采用或自行开发，需要深入了解。
    4. 用户界面的设计 如果用户界面设计完毕并确认，即可初步写出用户使用手册、管理员使用手册。
    5. 变更记录 本阶段的系统设计是集成测试的依据。
  4. 程序开发 创建开发任务计划表、开发计划日程表
    1. 优先编写测试用例
    2. 按照编码规范编写代码
    3. 按照文档注释规范注释 以上形成开发文档。本阶段需要一套版本管理系统。本阶段的测试用例也是单元测试的依据。 如果能做到，最好每日构建。
  5. 测试 本阶段需要一套Bug管理系统，形成需求、设计、开发、测试互动。
    1. 编写测试计划和测试方案
    2. 功能测试 单元测试、集成测试
    3. 性能测试 集成测试、压力测试 如果能做到，最好能进行自动化测试。 如果能做到，做分析统计工作。最后形成测试报告。
  6. 试用、培训、维护 本阶段需要解决：
    1. 解决异地修改和公司修改的同步问题。
    2. 用户测试中的Bug修改问题，按照级别分为 a. 程序Bug b. 设计变更 c. 需求变更 尽量按照a b c的顺序来进行修改，尽量避免b、c级的修改。最后形成安装手册、维护记录。

java 项目需求文档要怎么写？

对于产品经理来说，产品需求文档（PRD文档）是工作的核心产出。一份严谨、优秀的产品需求文档能够给项目的其他人员，包括设计师，开发工程师，测试工程师，运营人员等带来很大的帮助。但对于产品经理来说，撰写一份完整的产品需求文档往往需要花费相当多的时间和精力。 今天我们一起来看看，如何提升产品需求文档的撰写效率。

为什么要写产品需求文档?

对于稍微大一点的产品开发团队来说，产品经理未必能向所有团队成员准确传达产品开发需求，这时就需要一份完整的产品需求文档供项目参与人员阅读。 首先，产品经理可以根据项目的阶段运营目标提出合理需求，通过PRD文档阐述产品整体设计需求背景，设计思路，功能范围，交互逻辑，页面细节及其他信息。 其次，团队的相关人员可以快速获取自己需要的信息，节省反复沟通的时间成本，更好地开展工作。 最后，产品需求文档也是一个产品项目投入开发前的重要附件之一。团队领导可以根据产品需求文档清晰了解为什么需要开发这样一款产品。项目的其他相关方也可以随时参阅需求文档，了解项目的基本信息。 总的来说，产品需求文档有三个核心作用：

  • 传达产品开发需求；
  • 保证团队成员沟通顺畅；
  • 制定产品质量控制标准。 产品需求文档的在项目中的重要性已经不言而喻。那么对于产品经理来说，有哪些技巧可以更好地完成产品需求文档的撰写呢？

产品需求文档包含哪些内容？

通过下图，我们可以简单了解产品需求文档需要呈现的基本内容。 请点击输入图片描述

  1. 产品概述 产品需求文档的第一部分，首先需要对整个项目的研发背景及整体规划进行说明，让阅读者可以快速理解需求背景和产品定位。其次是对产品需求文档本身进行阐述，在每一次修订后都需要进行记录，方便阅读者了解产品需求文档的修订更新。这一部分主要包括以下内容：
    • 项目概述
    • 词汇表
    • 文档修订历史
    • 版本说明等
  2. 功能范围 这一部分需结合用户、业务规则及市场环境，对产品的用户和市场需求进行分析梳理，找出差异性和优势，制定业务流程和需求清单。可通过业务逻辑图、流程图、产品结构图等图表，让产品逻辑和功能以最简单的方式陈列出来，团队成员可根据这一部分了解用户信息、行为信息等，也有助于对产品进行进一步的理解。
  3. 功能详情和原型 首先是列举功能总表，将产品功能进行逐条梳理，每一条功能都能对应前面的产品目标。 其次是功能详情展示，通过Mockplus等原型工具快速绘制原型，配合关键部分的批注说明，详细描述业务模块的展示、交互和数据逻辑，以供开发人员查看和理解。
  4. 全局说明 这一部分包括设计规范、数据统计、通用规则说明等信息，方便设计师和开发人员查看产品细节信息。
  5. 测试需求 产品一般在正式上线前都有BETA版本或者内测版本，产品经理需要定制测试产品的功能或者性能。
  6. 非功能性需求 非功能需求为用户常规操作产品时的极端情况，涉及很多内容，包括产品性能、安全性、可靠性、拓展性等方面。
  7. 产品运营和市场分析 完成产品开发并不是终点，产品的最终目的是要赢得市场。产品上线后如何运营？建议的推广策略是什么？产品经理和运营人员该如何协作？等等问题。

产品需求文档撰写技巧

如何高效完成产品需求文档的撰写？我们可以从以下四个方面展开说明：

  • 理清文档结构
  • 详尽叙述每一个细节
  • 语义明确，没有歧义
  • 搭配原型图或设计稿进行说明

理清文档结构

一份产品需求文档的内容往往多而复杂，因此，产品经理在撰写产品需求文档时，必须理清文档的结构，才能提升产品需求文档的可读性，让阅读者可以快速了解文档的思路和查阅重要信息。 将一份产品需求文档看做一个产品，首先需要梳理出它的结构，如上文中所呈现的文档内容，然后再按顺序进行撰写，这样才能写出结构清晰，层次分明的产品需求文档。

详尽叙述每一个细节

当我们站在产品经理的角度思考问题时，往往会出现这样的误区：产品的这一功能模块逻辑非常简单，业内常见，开发人员也一定能懂，不用再进行单独说明。 产品经理对于产品的功能及逻辑往往非常了解，但如果从开发或测试人员的角度来看，往往对于许多产品的细节和逻辑关系都不太了解。因此产品经理在撰写产品需求文档时，一定要做到事无巨细。不仅需要详尽叙述页面逻辑、交互逻辑、数据逻辑等所有细节，还需要从开发、测试等角度检查是否有遗漏或错误，才能保证后续开发工作有条不紊。

语义明确，没有歧义

在撰写产品需求文档时，要做到语义明确，不能出现让阅读者产生歧义的词汇或语句，如：大概、可能、似乎等词语。另一方面，对于产品定义的表述方式，必须做到全文统一。比如在撰写一份APP的产品需求文档时，前文写了“首页轮播图”，后文就不能再使用“首页Banner”、“横幅”等名称。

搭配原型图或设计稿进行说明

产品需求文档往往包含大量文字描述，团队其他成员在阅读某些功能细节时，往往无法完全理解文字内容。此时如果使用原型图或设计稿进行说明，就可以补充文字内容很难描述的信息，帮助阅读者快速理解产品功能和内在逻辑。因此产品经理在撰写产品需求文档时，需要配合原型图或设计稿进行说明。 一款产品的原型图或设计稿通常会进行反复修改，产品需求文档必须同步更新，才能让阅读者及时了解到项目的最新动态。但如果每修改一次原型图或设计稿，产品经理都必须手动去替换文档中的配图内容，那效率就太低了！其实，使用高效的产品需求文档撰写神器即可解决这一难题。

产品需求文档撰写神器

随着产品开发流程的不断发展，Office等传统办公软件已无法满足产品文档的撰写需求。今天为大家推荐的，是一款专门面向产品经理的文档工具——摹客：网页链接。除了上述图文同步的难题外，摹客还能解决审阅沟通、版本管理等产品需求文档的写作困境，让产品经理可以更高效地创建专业的产品文档。一起来看看~

富文本撰写，充分表达产品需求

摹客全新的富文本在线写作模式，符合产品经理日常编辑习惯，可以快速完成文档撰写。撰写内容自动保存，可随时查看历史版本，方便对比修改。此外，产品经理也可以直接上传本地产品文档，会自动解析目录，并生成文档树，方便查阅。 请点击输入图片描述

与原型图、设计稿深度结合，相互说明论证

产品经理在撰写产品需求文档时可插入设计稿，当对设计稿进行了更新修改，可在文档中设置内容同步，无需重复插入。另外，团队成员在设计稿上打点评论时，也可以引用文档进行说明，让团队成员可以一目了然地查看相关信息。 请点击输入图片描述

实时审阅，高效沟通

文档编辑完成后可以通过链接一键分享给团队成员，团队成员可选中文字增加评论，对文档进行在线审阅，清晰表达项目意见，实现产品开发团队的高效沟通。 请点击输入图片描述

追踪修改记录，备份历史版本

通常，产品需求文档的写作不会一步到位，往往会根据团队成员的评审意见进行反复修改，因此会产生大量的迭代版本，对于产品经理来说，如何管理产品需求文档的历史版本，是一个很大的难题。在摹客 撰写产品文档，每一次修改都可以自动生成历史版本，可以随时跳转查看和恢复，管理便捷。 请点击输入图片描述

在线预览、分享更便捷

在摹客中在线撰写或上传的产品需求文档，可通过链接快速分享给团队成员，团队成员获得链接后可自由查看，当产品需求文档有修改时，团队成员仍可通过链接查看最新版本。 请点击输入图片描述 使用摹客等高效便捷的产品文档撰写工具，可以简化产品文档撰写流程，提升产品经理的文档撰写能力，让产品经理事半功倍。

总结

产品需求文档作为产品开发团队的重要沟通文档，文档的质量好坏会直接影响到各部门是否能够明确产品的功能和逻辑。一份简洁易懂、逻辑清晰的产品需求文档，可以让团队沟通更加高效，从而有效提高产品开发团队的工作效率。

java软件开发的代码规范

  1. 组织与风格 (1). 关键词和操作符之间加适当的空格。 (2). 相对独立的程序块与块之间加空行 (3). 较长的语句、表达式等要分成多行书写。 (4). 划分出的新行要进行适应的缩进，使排版整齐，语句可读。 (5). 长表达式要在低优先级操作符处划分新行，操作符放在新行之首。 (6). 循环、判断等语句中若有较长的表达式或语句，则要进行适应的划分。 (7). 若函数或过程中的参数较长，则要进行适当的划分。 (8). 不允许把多个短语句写在一行中，即一行只写一条语句。 (9). 函数或过程的开始、结构的定义及循环、判断等语句中的代码都要采用缩进风格。 注：如果大家有兴趣可以到安安DIY创作室博客，有相关说明性的文章和解释。
  2. 注解 Java 的语法与 C++ 及为相似，那么，你知道 Java 的注释有几种吗？是两种？ 
    // 注释一行
/* ...... */ 注释若干行
    不完全对，除了以上两种之外，还有第三种，文档注释： 
    /** ...... */ 注释若干行，并写入 javadoc 文档
    注释要简单明了。 
    String userName = null; //用户名
    边写代码边注释，修改代码同时修改相应的注释，以保证注释与代码的一致性。 在必要的地方注释，注释量要适中。注释的内容要清楚、明了，含义准确，防止注释二义性。 保持注释与其描述的代码相邻，即注释的就近原则。 对代码的注释应放在其上方相邻位置，不可放在下面。对数据结构的注释应放在其上方相邻位置，不可放在下面；对结构中的每个域的注释应放在此域的右方； 同一结构中不同域的注释要对齐。 变量、常量的注释应放在其上方相邻位置或右方。 全局变量要有较详细的注释，包括对其功能、取值范围、哪些函数或过程存取它以及存取时注意事项等的说明。 在每个源文件的头部要有必要的注释信息，包括：文件名；版本号；作者；生成日期；模块功能描述（如功能、主要算法、内部各部分之间的关系、该文件与其它文件关系等）；主要函数或过程清单及本文件历史修改记录等。 
    /**
 * Copy Right Information : Neusoft IIT
 * Project : eTrain
 * JDK version used : jdk1.3.1
 * Comments : config path
 * Version : 1.01
 * Modification history :2003.5.1
 * Sr Date Modified By Why What is modified
 * 1. 2003.5.2 Kevin Gao new
 */
    在每个函数或过程的前面要有必要的注释信息，包括：函数或过程名称；功能描述；输入、输出及返回值说明；调用关系及被调用关系说明等 
    /**
 * Description :checkout 提款
 * @param Hashtable cart info
 * @param OrderBean order info
 * @return String
 */
public String checkout(Hashtable htCart,
                       OrderBean orderBean)
        throws Exception{
}
    javadoc注释标签语法
    • @author 对类的说明 标明开发该类模块的作者
    • @version 对类的说明 标明该类模块的版本
    • @see 对类、属性、方法的说明 参考转向，也就是相关主题
    • @param 对方法的说明 对方法中某参数的说明
    • @return 对方法的说明 对方法返回值的说明
    • @exception 对方法的说明 对方法可能抛出的异常进行说明
  3. 命名规范 定义这个规范的目的是让项目中所有的文档都看起来像一个人写的，增加可读性，减少项目组中因为换人而带来的损失。（这些规范并不是一定要绝对遵守，但是一定要让程序有良好的可读性）较短的单词可通过去掉元音形成缩写；要不然最后自己写的代码自己都看不懂了，那可不行。 较长的单词可取单词的头几发符的优先级，并用括号明确表达式的操作顺序，避免使用默认优先级。 使用匈牙利表示法 Package 的命名 Package 的名字应该都是由一个小写单词组成。 
    package com.neu.util
    Class 的命名 Class 的名字必须由大写字母开头而其他字母都小写的单词组成,对于所有标识符，其中包含的所有单词都应紧靠在一起，而且大写中间单词的首字母。 
    public class ThisAClassName{}
    Class 变量的命名 变量的名字必须用一个小写字母开头。后面的单词用大写字母开头 
    userName , thisAClassMethod
    Static Final 变量的命名 static Final 变量的名字应该都大写，并且指出完整含义。 
    /**
 *DBConfig PATH
 **/
public static final String
DB_CONFIG_FILE_PATH =com.neu.etrain.dbconfig;
    参数的命名 参数的名字必须和变量的命名规范一致。 数组的命名 数组应该总是用下面的方式来命名： 
    byte[] buffer;
    而不是： 
    byte buffer[];
    方法的参数 使用有意义的参数命名，如果可能的话，使用和要赋值的字段一样的名字： 
    SetCounter(int size){
    this.size = size;
}
  4. 文件样式 所有的 Java(*.java) 文件都必须遵守如下的样式规则： 版权信息 版权信息必须在 java 文件的开头，比如： 
    /*
 * Copyright ? 2000 Shanghai XXX Co. Ltd.
 * All right reserved.
 */
    其他不需要出现在 javadoc 的信息也可以包含在这里。 Package/Imports package 行要在 import 行之前，import 中标准的包名要在本地的包名之前，而且按照字母顺序排列。如果 import 行中包含了同一个包中的不同子目录，则应该用 * 来处理。 
    package hotlava.net.stats;
import java.io.*;
import java.util.Observable;
import hotlava.util.Application;
    这里 java.io.* 使用来代替InputStream and OutputStream 的。 Class 接下来的是类的注释，一般是用来解释类的。 
    /**
 * A class representing a set of packet and byte counters
 * It is observable to allow it to be watched, but only
 * reports changes when the current set is complete
 */
    接下来是类定义，包含了在不同的行的 extends 和 implements 
    public class CounterSet
        extends Observable
        implements Cloneable
    Class Fields 接下来是类的成员变量： 
    /**
 * Packet counters
 */
protected int[] packets;
    public 的成员变量必须生成文档（JavaDoc）。protected、private和 package 定义的成员变量如果名字含义明确的话，可以没有注释。 存取方法 接下来是类变量的存取的方法。它只是简单的用来将类的变量赋值获取值的话，可以简单的写在一行上。 
    /**
 * Get the counters
 * @return an array containing the statistical data. This array has been
 * freshly allocated and can be modified by the caller.
 */
public int[] getPackets() { return copyArray(packets, offset); }
public int[] getBytes() { return copyArray(bytes, offset); }
public int[] getPackets() { return packets; }
public void setPackets(int[] packets) { this.packets = packets; }
    其它的方法不要写在一行上 构造函数 接下来是构造函数，它应该用递增的方式写（比如：参数多的写在后面）。 访问类型 (public, private 等.) 和 任何 static, final 或 synchronized 应该在一行中，并且方法和参数另写一行，这样可以使方法和参数更易读。 
    public
CounterSet(int size){
    this.size = size;
}
    克隆方法 如果这个类是可以被克隆的，那么下一步就是 clone 方法： 
    public
Object clone() {
    try {
        CounterSet obj = (CounterSet)super.clone();
        obj.packets = (int[])packets.clone();
        obj.size = size;
        return obj;
    }catch(CloneNotSupportedException e) {
        throw new InternalError(Unexpected CloneNotSUpportedException: +
                e.getMessage());
    }
}
    类方法 下面开始写类的方法： 
    /**
 * Set the packet counters
 * (such as when restoring from a database)
 */
protected final
void setArray(int[] r1, int[] r2, int[] r3, int[] r4)
        throws IllegalArgumentException
{
    //
    // Ensure the arrays are of equal size
    //
    if (r1.length != r2.length || r1.length != r3.length || r1.length != r4.length)
        throw new IllegalArgumentException(Arrays must be of the same size);
    System.arraycopy(r1, 0, r3, 0, r1.length);
    System.arraycopy(r2, 0, r4, 0, r1.length);
}
    toString 方法 无论如何，每一个类都应该定义 toString 方法： 
    public
String toString() {
    String retval = CounterSet: ;
    for (int i = 0; i data.length(); i++) {
        retval += data.bytes.toString();
        retval += data.packets.toString();
    }
    return retval;
}
    main 方法 如果main(String[]) 方法已经定义了, 那么它应该写在类的底部.
  5. 代码可读性
    • 避免使用不易理解的数字，用有意义的标识来替代。
    • 不要使用难懂的技巧性很高的语句。
    • 源程序中关系较为紧密的代码应尽可能相邻。
  6. 代码性能 在写代码的时候，从头至尾都应该考虑性能问题。这不是说时间都应该浪费在优化代码上，而是我们时刻应该提醒自己要注意代码的效率。比如：如果没有时间来实现一个高效的算法，那么我们应该在文档中记录下来，以便在以后有空的时候再来实现她。 不是所有的人都同意在写代码的时候应该优化性能这个观点的，他们认为性能优化的问题应该在项目的后期再去考虑，也就是在程序的轮廓已经实现了以后。 不必要的对象构造 不要在循环中构造和释放对象 使用 StringBuffer 对象 在处理 String 的时候要尽量使用 StringBuffer 类，StringBuffer 类是构成 String 类的基础。 String 类将 StringBuffer 类封装了起来，（以花费更多时间为代价）为开发人员提供了一个安全的接口。当我们在构造字符串的时候，我们应该用 StringBuffer 来实现大部分的工作，当工作完成后将 StringBuffer 对象再转换为需要的 String 对象。比如：如果有一个字符串必须不断地在其后添加许多字符来完成构造，那么我们应该使用StringBuffer 对象和她的 append() 方法。如果我们用 String 对象代替StringBuffer 对象的话，会花费许多不必要的创建和释放对象的 CPU 时间。大家可以来安安DIY创作室一起讨论。 避免太多的使用 synchronized 关键字 避免不必要的使用关键字 synchronized，应该在必要的时候再使用她，这是一个避免死锁的好方法。
  7. 编程技巧 byte 数组转换到 characters 为了将 byte 数组转换到 characters，你可以这么做： 
    Hello world!.getBytes();
    Utility 类 Utility 类（仅仅提供方法的类）应该被申明为抽象的来防止被继承或被初始化。 初始化 下面的代码是一种很好的初始化数组的方法： 
    objectArguments = new Object[] { arguments };
    枚举类型 JAVA 对枚举的支持不好，但是下面的代码是一种很有用的模板： 
    class Colour {
    public static final Colour BLACK = new Colour(0, 0, 0);
    public static final Colour RED = new Colour(0xFF, 0, 0);
    public static final Colour GREEN = new Colour(0, 0xFF, 0);
    public static final Colour BLUE = new Colour(0, 0, 0xFF);
    public static final Colour WHITE = new Colour(0xFF, 0xFF, 0xFF);
}
    这种技术实现了RED, GREEN, BLUE 等可以象其他语言的枚举类型一样使用的常量。 他们可以用 '==' 操作符来比较。 但是这样使用有一个缺陷：如果一个用户用这样的方法来创建颜色 BLACK new Colour(0,0,0) 那么这就是另外一个对象，'=='操作符就会产生错误。她的 equal() 方法仍然有效。由于这个原因，这个技术的缺陷最好注明在文档中，或者只在自己的包中使用。
  8. 编写格式 代码样式 代码应该用 unix 的格式，而不是 windows 的（比如：回车变成回车+换行） 文档化 必须用 javadoc 来为类生成文档。不仅因为它是标准，这也是被各种 java 编译器都认可的方法。使用 @author 标记是不被推荐的，因为代码不应该是被个人拥有的。 缩进 缩进应该是每行2个空格. 不要在源文件中保存Tab字符. 在使用不同的源代码管理工具时Tab字符将因为用户设置的不同而扩展为不同的宽度.如果你使用 UltrEdit 作为你的 Java 源代码编辑器的话，你可以通过如下操作来禁止保存Tab字符, 方法是通过 UltrEdit中先设定 Tab 使用的长度室2个空格，然后用 Format|Tabs to Spaces 菜单将 Tab 转换为空格。 页宽 页宽应该设置为80字符. 源代码一般不会超过这个宽度, 并导致无法完整显示, 但这一设置也可以灵活调整. 在任何情况下, 超长的语句应该在一个逗号或者一个操作符后折行. 一条语句折行后, 应该比原来的语句再缩进2个字符. {} 对 {} 中的语句应该单独作为一行. 例如, 下面的第1行是错误的, 第2行是正确的: 
    if (i0) { i ++ }; // 错误, { 和 } 在同一行
if (i0) {
    i ++
}; // 正确, { 单独作为一行
    } 语句永远单独作为一行.如果 } 语句应该缩进到与其相对应的 { 那一行相对齐的位置。 括号 左括号和后一个字符之间不应该出现空格, 同样, 右括号和前一个字符之间也不应该出现空格. 下面的例子说明括号和空格的错误及正确使用: 
    CallProc( AParameter ); // 错误
CallProc(AParameter); // 正确
    不要在语句中使用无意义的括号. 括号只应该为达到某种目的而出现在源代码中。下面的例子说明错误和正确的用法: 
    if ((I) = 42) { // 错误 - 括号毫无意义
if (I == 42) or (J == 42) then // 正确 - 的确需要括号
  9. 代码编译
    1. 编写代码时要注意随时保存，并定期备份，防止由于断电、硬盘损坏等原因造成代码丢失。
    2. 同一项目组内，最好使用相同的编辑器，并使用相同的设置选项。
    3. 合理地设计软件系统目录，方便开发人员使用。
    4. 打开编译器的所有告警开关对程序进行编译。
    5. 在同一项目组或产品组中，要统一编译开关选项。
    6. 使用工具软件（如Visual SourceSafe）对代码版本进行维护。如果大家有不明白的可以到安安DIY创作室留言。
  10. 可移植性 Borland Jbulider 不喜欢 synchronized 这个关键字，如果你的断点设在这些关键字的作用域内的话，调试的时候你会发现的断点会到处乱跳，让你不知所措。除非必须，尽量不要使用。 换行 如果需要换行的话，尽量用 println 来代替在字符串中使用\n。 你不要这样： 
    System.out.print(Hello,world!\n);
    要这样： 
    System.out.println(Hello,world!);
    或者你构造一个带换行符的字符串，至少要象这样： 
    String newline = System.getProperty(line.separator);
System.out.println(Hello world + newline);
    PrintStream PrintStream 已经被不赞成（deprecated）使用，用 PrintWrite 来代替它。

如何书写Java项目的开发文档

我现在公司是CMMI4认证的，最近我项目组在开始新产品，我负责了大部分文档编写。 人员流动是项目进行中比较让人头疼的事情。做好规范文档，可以让代码看起来比较像出自同一人之手。要做java开发文档得做不少功夫，有需求规格说明书、详细设计说明书、软件功能规格说明书、数据库设计说明书、编码规范等。比较重要的是 软件功能描述、数据库设计、编码规范，这样，及时有人员流动的话，新人看了文档，也能比较快的了解功能需求、数据库设计、编码规范，更快的上手项目。先看看你需要什么文档，然后去文库里搜索，就有相应的模板，找个适合自己项目的模板用。

北大青鸟java培训：Java编程开发规范及其技巧？

在用Java进行开发前，一定要牢牢遵守Java的开发规范，只有这样你的Java开发之路才能更加顺畅。 而掌握相应的Java开发技巧，则可以让你工作起来事半功倍。 那在编写代码时有什么开发规范和技巧呢？电脑培训给你详细介绍一下吧。

  1. 代码编写规范：代码编写遵守Java通用开发规范和必联代码开发规范；每个类及方法都要有合理的注释，并且对注释要持续维护；根据接口需求编写单元测试用例，再编写实现类使得单元测试通过，如此循环往复以使得所有的单元测试通过；要求每个Java方法的代码行数不能超过100行；代码编写按照功能划分，一个接口分为多个方法，每一个方法做什么事情，做到思路清晰；接口设计尽量做到多兼容性，方便后期开发。
  2. 数据库设计及SQL规范：不使用MySQL数据库外键约束，通过应用程序逻辑实现关联约束；适当建立索引，经常作为查询条件的字段、唯一性程度高、长度不是很长的、数量不宜太多，一般一个表的索引数目在5个以内；表名长度不能超过30个字符，表名最好选择一个单词，能够准确清晰明了地表示实体含义，若必须多个单词则以下划线“_”分隔，单词所有字母均小写；
推荐文章