Java语言规范中文版-产品规范.doc

软件产品命名规范 1.目的 为了确保公司各个软件产品及程序的正确性、统一性，确保各方面内容受到保护和修改控制，确保各项工作顺利进行，特此制定本公司软件产品命名规范，凡本公司设计开发的软件产品均应符合本规范.适用范围 本规定适用于公司所有软件产品和每一个可独立维护并受控的程序。 3.名词定义 程序：程序是一系列按照特定顺序组织的计算机数据和指令的集合。它可以是一个特定的程序，也可以是一组功能联系紧密，可以互相协作的程序的集合与这些程序相关的文档.软件产品标识 软件产品的标识由软件产品名称和软件产品的版本两部分参数组成。 4.1软件产品名称 软件产品一般都有中文名称、英文名称及简称三种方式的标识。公司所有软件产品在，软件产品名称按统一标准命名ynchronizes System(中文名称的英文全称) 4.1.3软件产品的简称 软件产品的简称也是由三部分组成：公司的标识、产品标志、英文名称的缩写（一般为各单词首字母组合）。 例如：TFRD Smart DSS 4.2软件产品版本 软件产品的版本直接体现在版本号的命名上，命名格式有两种： 主版本号 . 子版本号 . 变更版本号 当软件产品初版时，变更版本号和修正版本号都为0，可以忽略不计，所以采用第一种方式，只标识主版本号和子版本号； 主版本号和子版本号的修改标志这软件产品的升级开发，须提交立项申请，由立项评审委员会决定。 一般来说，前一位版本号变动时后一位的版本号自动清零。 4.2.1主版本号 1-2位数字，当功能模块有较大的变动，比如增加多个模块或者整体架构发生变化。 4.2.2子版本号 1-2位数字，当功能有一定的变化或者某一个分支。 4.2.3变更版本号 1-2位数字，产品的组成程序有的变更，例如修复一个严重的bug即可发布一个修订版。 4.3其他 另外，当软件产品用于一些特殊用途时，还可以在版本号后面加入其他版本标识： *?alpha?（α）内部测试版*?beta?（β）外部测试版 *?demo?演示版 .JAVA包的命令规范 Java包的名字都是由小写单词组成。但是由于Java面向对象编程的特性，每一名Java程序员都 可以编写属于自己的Java包，为了保障每个Java包命名的唯一性，在最新的Java编程规范中，要求程序员在自己定义的包的名称之前加上唯一的前缀。 由于互联网上的域名称是不会重复的，所以程序员一般采用自己在互联网上的域名称作为自己程序包的唯一前缀。? 5.2.2 JAVA程序的命名 由于JAVA程序导出的文件不带版本标识，因此要求发布的程序（JAR包和WAR包）文件名包括版本信息，版本标识方法见下节。 Jar程序 JAVA归档文件，能将许多文件组合成一个压缩文件JAR 文件格式ZIP 文件格式不仅用于压缩和发布，而且还用于部署封装库、组件和插件程序，可像编译器和 JVM 这样的工具直接使用用于发布和使用类库 用于打包与组件相关联的辅助资源作为应用程序和扩展的构建单元作为组件、applet 或者插件程序的部署单位命名要求如下： Tfrd_Webgis1.0.0 版本号 产品标识 公司标识 第三方JAR包可保留原名称。 War程序 网络应用程序文件是与平台无关的文件格式，它允许将许多文件组合成一个压缩文件。为 J2EE 应用程序创建的 JAR 文件是 EAR 文件（企业 JAR 文件）war专用在web方面 。 例如：TfrdDcity 1000. exe 6.公司名称属性的命名 对于所有具有“公司名称”属性的程序（如.dll、.exe文件等），要求统一将公司名称标识为“TFRD”。 7.第三方系统、数据库、开发与支持软件工具的编号 保留供应商所提供的系统、数据库、开发与支持软件工具编号。 软件产品命名规范 2 Tfrd.dcity.GPS.UI 公司标识 产品标识 组件 功能 cn.tfrd.dcity.gps.UI 公司标识 产品标识 组件 功能