版权说明:本文档由用户提供并上传,收益归属内容提供方,若内容存在侵权,请进行举报或认领
文档简介
1、北京韩金网络技术有限公司Java项目开发规范(2015 版)北京韩金网络技术有限公司二。一五年十二月北京韩金网络技术有限公司审定:审核:编写:Java开发规范-18-目录第一章引言 4第一节编写目的 4第二节预期读者 4第三节本文的约定 5第四节本文的内容 5第五节适用范围 6第二章开发环境 7第一节操作系统环境 7第二节开发工具 7第三节版本管理工具 8第三章软件开发框架 9第一节整体结构规范 9第二节开发框架的使用 11第三节代码结构规范 11第四节模块命名规范 12第五节配置文件位置及规范 12第四章公共组件的选用 14第一节基础框架组件的选用 14第二节日志组件的选用 15第三节jqu
2、ery的选用 15第五章公司开发技术组件 16第六章公司开发模块 17第一节模块开发规范 17第二节模块应用规范 17第三节模块的使用 18第七章技术支持和信息反馈 19第一节信息反馈 19第二节技术支持 19第一章引言第一节编写目的本规范的目的是使本公司所有的软件开发部门能以统一的、规范的方式开发应用软件系统。通过建立编码规范,提高代码的可靠性、可读性、可修改性、 可维护性和一致性等,增进团队协作能力,保证软件产品的质量。通过建立统一的Java软件开发框架,树立公司清晰的、有远见的技术方向, 明确Java软件项目的基础构件和接口,减少基础框架研究和构建的成本,统一 的开发接口和规范还能保证公
3、司软件模块在不同的项目中可以共享,从而提供 开发效率和软件产品质量。同时本文也是一份J2EE开发指南,用于指导公司软 件工程师开发java软件项目。第二节预期读者本文预期读者为公司的参与软件项目开发的项目经理、开发人员及质量管 理部门相关人员。第三节本文的约定为了使本Java规范具有可操作、可用性、可持续等特性,本文做以下约 士7E:1 .统一公司Java开发技术,以公司软件资源共享、节省软件开发工作量、 提供工作效率和软件产品质量为目标;2 .本Java软件开发规范具有可操作性,软件框架要有一定的伸缩性和适应 性,能够在公司不同的Java项目中执行;3 .针对某一问题,技术实现有很多种方式,
4、并且各种技术方案都有自身的 优缺点,本文应该尽力选择最适合本公司应用的软件技术方案,一旦技术方案确定即成为公司技术规范的依据;4 .本文发布以后,应该对相关开发人员进行培训;5 .本文发布以后,技术研发一部负责收集大家反馈的问题和新需求,并在 必要时对Java规范进行修改和补充;6 .本开发规范应该根据公司的积累不断的补充,定期升级公司J2EE规范,并发布新版本。第四节本文的内容本文的内容比较宽泛,涉及公司Java项目各个方面,如开发工具选择、开 发框架的定义、组件的选择等方面,如下表所示:序号类别说明1开发环境定义Java开发软件环境、开发工具、及版 本管理工具。2软件开发框架定义Java软
5、件项目的结构规范。3公共组件1、定义框架组件的选用,如 SpringMVC、Mybits等组件的选用;2、定义常用组件的选用,如数据访问驱 动,文档上传组件的选用。4公司开发组件公司内部开发组件的规范和定义,如文件 上传、字符处理等组件。5公司开发模块公司开发各个模块的规范和定义,如权限 管理模块、短信模块。表1 java项目涉及到的主要方面本文定义的内容将根据需要,定期进行修订和补充。第五节适用范围本文规定的所有规范适用于公司所有 Java软件项目。对于特殊情况未能遵 守本规范的项目,请保留项目技术评审相关结果记录。第二章开发环境统一规定公司的所有软件项目的开发环境,使公司的所有软件项目都在
6、统 一的开发环境下进行开发,以便于软件项目的移植,同时也避免了因为环境不 一致而导致的软件项目不能共享和开发不能协作等问题。第一节操作系统环境Java开发操作系统环境为 Windows环境(32位或64位)。任何使用第三 方文本编辑系统的情况,请使用 UTF-8编码。第二节开发工具开发工具的指定,是从开发工具的版权、开发工具的功能以及软件的可扩展性等多方面进行考虑的,集成开发环境、JRE、应用服务器分别指定如下:集成开发环境:Eclipse EE5 (Eclipse Web开发版本)在Eclipse发行新版 本后,由公司统一升级版本。MyEclipse涉及版权问题,不作为公司指定开发工 具,只
7、能作为开发人员学习研究的工具。JRE: JDK 1.8.0 (对于指定JDK版本的项目,请使用指定版本的JDK, 应用服务器:Tomcat 7 (对于需要运行在指定应用服务器的项目,需要同时具 备指定应用服务器的运行环境)。开发工具、JRE、应用服务器都使用文件夹拷贝方式进行部署,最新的开 发工具部署包从技术研发一部获取。开发工具中已经集成部分本规范规定的插 件,如GIT插件、maven同步工具插件。第三节版本管理工具2.3.1 代码管理服务器公司所有软件项目采用统一的代码管理服务器存储,新建项目和分配权限 由项目经理提出申请,配置管理员操作执行。2.3.2 代码管理工具公司所有java项目开
8、发版本管理使用git版本控制工具。服务器端:GITSERVER该软件部署在公司的开发服务器上。客户端:source tree第三章软件开发框架本章主要阐述java项目目录结构的规定及各部分命名规范。关于框架的组 件选用将后面的章节给出规定。第一节整体结构规范java项目采用统一结构,以便于系统项目的维护以及多个项目之间共享资 源。该项目规范是指 maven Web应用的项目(客户端应用程序的结构规范属于 子集,即不包括app部分的规范)。项目整体目录结构规范如下:配置文件目录合Java代码目录测试用例目录webapp目录系统内库入口图1 Java项目基本结构图编号目录目录说明1Src/main
9、/javaJava代码目录,存放java代码2Src/main/ resources系统xml配置文件2Src/main/css样式文件存放目录,相应存储规则如下:1)所有公共样式文件存在根目录下;2)各个模块私有样式存在独立的目录,即在样式文件根目录下建立子目录,目录名和模块名称相同。3Src/main/images图片文件存放目录,相应存储规则如下:1)系统框架部分的图片存在图片文件根目录或根据需 要单独建立子目录;2)所有模块公用的目录存储在图片文件根目录或根据 需要单独建立子目录;3)各个模块私有的图片文件存储在独立的目录,即在图片文件根目录下建立子目录,目录名和模块名称相 同。4Sr
10、c/main/js脚本文件存放目录,相应存储规则如下:所有模块公用的脚本存储在脚本文件根目录;各个模块私有的脚本文件存储在独立的目录,即在脚本 文件根目录下建立子目录,目录名和模块名称相同。5Src/main/viewJsp文件存放目录6WEB-INF/lib系统库统一由 maven管理7Pom.xml系统库配置接口表2目录结构说明注:项目文档统一使用公司项目管理系统 一文档管理来实现,临时项目文 件由各项目经理自行安排存储与交换方式。第二节开发框架的使用项目开始开发(编码)时,项目组首先从代码服务器上获取最新版本的系 统框架,系统框架包括系统整体框架、相关组件包(jar包)、框架界面、登录
11、界面等。系统框架默认包括权限管理模块的最新版本,用于管理系统用户、模 块及权限。项目开发的下一步工作是按照项目需求加入公司已经开发完成的模块,以 及按照项目需求开发新的业务模块。第三节代码结构规范本文阐述公司java项目的目录及命名规范。其中java代码目录规范如下图所示:项目公共目录,存放 通用类和工具类Mybatis代病生成配置文件控制层Mybatis sql配置文件实体类业务层图2 J2EE代码结构编号持久埴名1com.hanjin.userconter. util项目通用包,用来存放项目工具类、通用类Md5util.java JsonUtil.java 等2com.hanjin.use
12、rconter.login.controller项目控制包,用来处理 dao页面跳转的实现类3com.hanjin.userconter.login. dao项目持久层包4com.hanjin.userconter.login. dao.sql配置sql的xml包5com.hanjin.userconter.login. model项目实体类包6com.hanjin.userconter.login .service项目业务层包,用来存放模块处理业务逻辑的实现类表3 java代码包结构说明基于java平台的项目,所有包名均以com.hanjin.业务模块,开头。命名规 则是:com.hanji
13、n.业务模块.模块名称,如用户登录模块名称为:com.hanjin.userconter.login第四节模块命名规范模块是指系统中的各个业务功能模块,各个模块在组织上和功能上相对独立。如:第五节 配置文件位置及规范java项目的配置文件主要涉及 SSM框架配置、日志组件配置文件及其他配 置文件。配置文件位置及命名规范,定义了各类配置文件存放的位置及这些文件如何命名:1)Spring配置文件位置及命名规范:Spring配置文件统一存储在src/main/ resources目录位置,命名为:applicationContext.xml, spring-servlet.xml, 系统默认公共的配
14、置文件为 applicationContext-common.xml。2)日志组件配置文件:日志组件配置文件统一规定为perties,存放 在 src/main/resources目录位置。3)数据库配置文件:数据库组件配置文件统一规定为perties,存放 在 src/main/resources目录位置。第四章公共组件的选用Java平台是个开放的平台,java开发有很多成熟的开发组件,同一类组件 不同的厂商有不同的实现方式。为了统一公司的开发技术,达到技术共享的目 的,本章规定了公共组件的选用。公共组件在本文中是指第三方提供的、J2EE开发通常使用的组件,
15、如数据访问组件(或框架)、日志组件、文件上传组件等 等。第一节基础框架组件的选用java项目基础框架组件选用当前流行的 SSM框架,所以模块的开发需要按 照SSM的开发模式进行。对于有特殊技术需要的项目在技术委员会评定确认以 后可以不采用SSM作为基础开发框架,但如果需要引用其他在该框架下开发的 模块,必须保留各框架组件的类库以保证系统能够正常运行。2015年版本的公司JAVA开发框架的SSM框架的各组件版本说明如下:编号组件版本组件用途1Spring MVC2Spring4.1.03Mybatis3.2.6表5 SSM框架组件原则上基础框架组件能够完成的技术实现不得采用其他同类组件来实现。S
16、SM应用还做了如下规范:1) Spring的配置文件可以基于注解和配置文件两种方式。在同一个项目中,注解和配置文件可以混合使用,但在同一模块中只允许使用其中一种方第二节 日志组件的选用日志组件使用10g4j组件,选用版本为1217。第三节 jquery 的选用一般情况下,避免使用ExtJs脚本组件。如果项目中需要使用jquery,统 使用jquery1.9.0版本。第五章公司开发技术组件相对于公共组件来说,公司开发的用于解决特定技术问题的组件,这些组 件如果没有现成的(或合适的)第三方组件可以替代,开发完成以后可以应用 到公司的多个项目中。编制中对于已经存在的组件,各项目组要充分利用已有组件资
17、源,不得重新单独 开发。第六章公司开发模块公司将逐渐开发和积累软件成果,软件成果以(业务或技术)模块的形式 存在,软件模块的复用是公司提高软件开发效率、节约开发成本、提高软件开 发质量的重要途径。公司开发模块的规范包括模块开发的规范以及模块应用的 规范。模块开发的规范是指开发各个模块应该遵循的规范,使开发完成的模块符 合J2EE开发规范,并且可以应用到其他项目中。这里要遵循的规范主要是目录 结构规范、使用技术规范、组件规范、版本规范等。模块的应用规范给出公司开发项目应该使用的成熟模块以及模块的接口和 应用条件等。模块的应用规范规定公司开发项目要使用的模块、选择合适的版 本、按照正确的方式来使用
18、。第一节模块开发规范编制中第二节模块应用规范公司启动新项目以后,一方面要使用本文所规定的软件框架和规范进行开 发,还要充分利用已经成熟的模块,不得单独重新开发。当碰到特殊业务需要时,如果公司已有模块不能满足需求,经过公司技术 委员会评估确认以后可以为特定项目单独开发某一模块。当开发过程碰到模块中不能满足系统需要的缺陷时,开发人员提交给软件 技术研发一部,由软件技术研发一部根据缺陷的严重程度和紧迫性立即更新软 件或者在模块的下一个版本中进行修复或改进。目前公司规定统一使用的模块如下表所列:编号模块版本模块说明1权限管理模块1.0.0用户管理、角色管理、分组管理、权限管理23表6公司规定统一使用的模块第三节模块的使用当开发项目需要使用到某个模块时,就需要从模块资源库中获取该模块的 相关资源(请与技术支持联系),包括模块程序代码、模块配置文件、模块相关 脚本等。一个模块的资源包括以下几个部分。编号资源资源说明1目录:src/com.
温馨提示
- 1. 本站所有资源如无特殊说明,都需要本地电脑安装OFFICE2007和PDF阅读器。图纸软件为CAD,CAXA,PROE,UG,SolidWorks等.压缩文件请下载最新的WinRAR软件解压。
- 2. 本站的文档不包含任何第三方提供的附件图纸等,如果需要附件,请联系上传者。文件的所有权益归上传用户所有。
- 3. 本站RAR压缩包中若带图纸,网页内容里面会有图纸预览,若没有图纸预览就没有图纸。
- 4. 未经权益所有人同意不得将文件中的内容挪作商业或盈利用途。
- 5. 人人文库网仅提供信息存储空间,仅对用户上传内容的表现方式做保护处理,对用户上传分享的文档内容本身不做任何修改或编辑,并不能对任何下载内容负责。
- 6. 下载文件中如有侵权或不适当内容,请与我们联系,我们立即纠正。
- 7. 本站不保证下载资源的准确性、安全性和完整性, 同时也不承担用户因使用这些下载资源对自己和他人造成任何形式的伤害或损失。
最新文档
- 荷花说课课件
- 2026年国家电网统招考试电工类专业知识考试模拟试题及答案(十五)
- (2026年)消防安全管理制度的建立和落实
- 2026年初级养老服务师资格考试养老服务实务应用模拟试卷及答案(共二十套)
- 初中八年级物理教学设计:神奇的物理学首课探究与核心素养培育
- 初中美术八年级上册 第5课 动漫故事会教学设计
- 高中政治选择性必修二《法律与生活》3.1《订立合同有学问》教学设计
- 高二信息技术选择性必修2 项目10 体验互联网+应用 了解创新网络服务 教学设计
- 高中数学选择性必修第一册1.3.1空间直角坐标系教学设计
- 高中生物学必修2高一年级DNA是主要的遗传物质教学设计
- 2025-2026学年姜堰市四下数学期中达标检测模拟试题含答案
- 2026中国铁电存储行业市场现状供需分析及投资评估规划分析研究报告
- 中医儿科积滞教学课件
- 2026产前筛查诊断人员资质考试历年参考题库含答案详解
- 《城市轨道交通工程浅层气地质勘察规范编制说明》
- 公路工程梁板运输与架设(架桥机、吊车)专项施工方案
- 慢性创伤性骨髓炎清创时机专家共识(2026版)
- 医学课件-经椎间孔入路治疗退变性腰椎疾病
- 2026年秋季学期新编小学五年级上册道德与法治教案 (全册)
- 2026秋小学新版苏教版数学四年级上册☆ 度量衡的故事《度量衡的发展》教学设计
- 2027年日历表含农历每月一页可编辑版
评论
0/150
提交评论