JAVA编码规范_日企编码规范
第 版
2009年4月16日
修订履历
修订日
内容
担当
2009/4/16
初版。
目录
1. 前言 4
2. HTML开发规范 5
HTML的记述 5
3. JavaScript开发规范 8
基本方针 8
命名标准 9
注释 10
JavaScript的记述 11
4. JSP开发规范 12
基本方针 12
命名标准 14
注释 14
JSP的记述 15
5. JAVA开发规范 16
命名标准 17
注释 21
JAVA的记述 26
字符集 38
6. SQL开发规范 39
SQL的记述 40
前言
本书展示的是基于JAVA语言开发的项目,编程应遵循的编码规范和记述规则。其目的是便于制作出具有良好可读性、可维护性,且在形式上统一的程序。
本书记述了HTML以及CSS(层叠式样式表)、JavaScript、JSP、JAVA语言的规范。
HTML开发规范
以下为HTML的开发规范。
HTML的记述
以下为HTML的记述方法。
所有记述方法
元素、属性的书写方法
元素名称全部采用大写的半角英文字母。
属性名、属性值(中文除外)全部采用小写的半角英文和数字。
但是、属性的值为路径名、文件名、类选择器等时,记述本来的值(记述例1)。
不使用前缀。属性变更后需修改所有相应的地方,很有可能产生错误,所以不使用前缀。
记述例1:
<IMG src="/mon/gif/" border="0">
属性值使用””(引号)围起来。
转义符的使用
对特殊符号,使用文字转义符或数值转义符。
以下为主要的文字转义符:
文字转义符
表示符号
<
<
>
>
&
&
"
“
(空白)
®
®
HTML基本信息
文档型声明(DOCTYPE声明)
记录所使用的HTML的版本号。
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML Transitional//EN">
字符集指定
为防止在浏览器上出现乱码,指定以下字符集。
<META http-equiv="Content-Type" content="text/html;charset= GB2312" >
标题
各画面的标题组成中要添加功能名。
标题长度为20个字符以内。
链接
指定链接名
指定链接名以便明了链接地址的内容。
指定内容标题、一览页的标题等。
指定A元素的标题属性
在A元素里、通过标题属性来说明连接地址。
记述例:
<A href=”” title="TTNI"> TTNI-C</A>
使用<A>时,</A>不换行,且记述在作为链接对象的字符串和图标后。
图片
图片文件的种类
使用GIF、JPEG、PNG的其中一种。
字体
指定字体
指定标准字体为浏览器的默认字体,不指定不同机种的字体。
字体的大小、粗体、斜体、颜色等,根据样式表来指定。
JavaScript开发规范
以下为JavaScript的开发规范。
基本方针
适用场合
JavaScript基本上在实现以下功能的场合下使用。
指定业务流程的迁移位置。
指定从错误画面返回时的迁移位置。
子画面的打开关闭。
确认、选择对话框的显示。
复选框的ON/OFF控制等。
显示MESSAGE等。
输入项目的检查等。
其他特殊操作等。
命名标准
以下为JavaScript的命名标准。
变量名
遵循Java开发规范的类变量、实例变量的命名。
函数名
遵循Java开发规范的方法的命名。
注释
以下为JavaScript的注释标准。
注释的开始位置,要与相应程序的记述位置对齐。
程序部分,要记述每个处理单位的处理概要。
程序部分的注释,要写在程序执行的前一行。
为了在浏览器的源代码显示中不显示出注释,作为JSP的注释来记述。
JavaScript脚本文件中记述的头注释,如下所示。
记述例:
//==============================================================
// 项目行追加函数
// 【输入】projectCd 项目代码
// projectNm 项目名
// 【返回值】false
// 【制作者】
// 【制作日】2008/09/01
// 【更新者】
// 【更新日】
//===
JAVA编码规范 日企 来自淘豆网m.daumloan.com转载请标明出处.
