北大青鸟襄樊华腾项目开发代码.pdfVIP

为什么需要编码规范?

有下面的几个理由：

1.提高代码的可读性

2.降低培训管理成本

3.促进组织的

文件名和位置（FileNamesandLocations）

文件命名给出法，让工具商和web容器决定文件类型并一致的解释它。下表列举了推荐的文件名

后缀和位置。

文件类型文件后缀推荐位置

JSP.jspcontextroot/subsystempath/

.jspcontextroot/subsystempath/

JSP片段

.jspfcontextroot/WEB-INF/jspf/subsystempath/

层叠样式单.csscontextroot/css/

JavaScript.jscontextroot/js/

HTML页面.htmlcontextroot/subsystempath/

web资源.gif,.jpg,etc.contextroot/images/

标记库描述.tldcontextroot/WEB-INF/tld/

注意：1contextroot是web应用的根(.war文件内的根).

2subsystempath用于将动态或静态的页面更精细地逻辑分组.

3.JSP片段是指被其它jsp页面包含的jsp页面.

文件的组织（FileOrganization）

一个良好结构的源代码文件不仅更易于阅读，而且更快的查找文件中的信息。这部分介绍jsp文件和标记

库描述文件的结构。

Jsp文件/jsp片段文件（JSPFile/JSPFragmentFile）

一个JSP文件按顺序有以下几个部分组成：

1.头注释

2.JSP页面指令

3.可选的标记库

4.可选的JSP

5.HTML和JSP代码

头注释（OpeningComments）

一个JSP和片段文件以一个服务器方风格的注释开头。

%--

-Author(s):

-Date:

-CopyrightNotice:

-@(#)

-Description:

--%

这个注释仅在服务端可见，因为在JSP页面转译是被删除。在注释里是作者，日期，一个供

web开发者使用的关于JSP页面的标识和描述。字符串组合@(#)可以被某些程序识别标识的

开始部分。而这样的程序是很少的但这留下这个字符串没有坏处。另外，有时这个组合加字串$Id$被一

些版本控制程序自动JSP页面作为标识信息。Description部分提供概要信息，描述该JSP页面的

目的，它不要分多段描述。

在有些情况下，头注释需要被保留，让客户端可见以示合法的目的。这时它可以被分割成两部分，第

一部分使用客户段注释风格：

!--

-Author(s):

-Date:

-CopyrightNotice:

--