Java界面开发规范.docVIP

Java 界面开发规范 V1.0变更记录 更改序号 内容 人员 日期 文档说明 此文档描述了Java界面开发的时候需要遵守的一些规范及建议。这些规范包括了界面的开发规范，事务处理规范等。 在开发前必须详细阅读此规范。 定位 电子运维开发人员，及开发经理，质管。 开发规范 表现层 开发模式 表现层分两种不同的开发模式：不使用框架和使用框架。 初步建议比较复杂的界面不使用框架，采用最简单的开发方式JSP+Bean的开发方式。比较简单的界面可以尝试使用框架。具体哪些页面使用JSP+Bean开发，哪些页面使用框架开发这里不做详细定义 选用的开发框架 只使用Struts1.2+Spring，Hibernian不采用。所有的数据库访问都是通过自己编写服务完成。 界面使用的控件约定 界面可以使用的js控件： HTC 的Treegrid 控件，Tab控件。 使用系统规定的时间控件 Ext的Ajax访问控件。 Ext的Json解释控件。 其他的都使用标准的html控件。例如：edit，TextArea，Selecte，Div, table 等。 如果程序员提出使用新的控件，则需要通过审核才能使用，并且提供此控件的使用样例。 界面风格定义 界面颜色和风格以淡雅为主，切忌使用过多的颜色，显得花花绿绿。界面的表单及表格显示使用统一的CSS做样式定义，不能使用自己定义的CSS。除非用户有特殊的要求，这可以针对特别的界面设置CSS。 对于表格，标题靠右对齐，内容则左对齐。标题和内容使用不一样的颜色进行区分。 对于表单，必填项必须在后面加上型号，并在提交的时候对数据的合法性进行校验。 界面调整需要在1024x768的分辨率下进行。 内容分组显示 内用分组显示使用一下两种方式处理： 使用Tab页 使用Div进行分组内容的显示和隐藏。 注：详细内容可以参考给出的例子。 JSP编码规范 业务逻辑不要写在JSP页面里，统一由后台服务完成。JSP里不允许直接进行访问数据，特别是在JSP页面里写SQL语句。 页面编码统一使用gbk。 页面里不能写转码的代码，转码统一有过滤器完成。 JavaScript不要写在JSP页面里，应该用一个独立的文件存放。并且文件名应该能够体现文件的用途。简单的或少量的JavaScript才可以写在页面里，但当达到一定数量时则需要移植到独立的文件里。 JavaScript里必须与足够的注释供以后的维护者能够容易地读懂。 对CSS和JavaScript的引用不能使用绝对路径，应该使用相对路径或通过代码实时转换。 数据提交 一般建议使用post的方式提交数据，特别是有中文字符的统一用post方式提交。 Get方式的提交只用于参数少的、没有中文的。如果涉及敏感的数据则必须用post的方式提交。 其他的一些约定 代码必须进行格式化处理 无论是Java，JSP，JavaScript，SQL 都需要进行格式化处理。代码的缩进必须统一。 Java文件名称： 对于各种符号的定义，都有一个共通点，就是应该使用有实际意义的英文单词或英文单词的缩写，不要使用简单但没有意义的字串，尽可能不使用阿拉伯数字，更切忌使用中文拼音的首字母。如这样的名称是不提倡的：Value1,Value2,Value3,Value4 …。 例如：file(文件),code(编号),data(数据), faxcode(传真号) ,address(地址),bank(开户银行),……Java目录结构如下： ├─dao │ └─module │ └─impl ├─vo │ └─module ├─service │ └─module │ └─impl ├─struts │ └─module │ ├─action │ └─form └─util 2