- 1、本文档共45页,可阅读全部内容。
- 2、原创力文档(book118)网站文档一经付费(服务费),不意味着购买了该文档的版权,仅供个人/单位学习、研究之用,不得用于商业用途,未经授权,严禁复制、发行、汇编、翻译或者网络传播等,侵权必究。
- 3、本站所有内容均由合作方或网友上传,本站不对文档的完整性、权威性及其观点立场正确性做任何保证或承诺!文档内容仅供研究参考,付费前请自行鉴别。如您付费,意味着您自己接受本站规则且自行承担风险,本站不退款、不进行额外附加服务;查看《如何避免下载的几个坑》。如果您已付费下载过本站文档,您可以点击 这里二次下载。
- 4、如文档侵犯商业秘密、侵犯著作权、侵犯人身权等,请点击“版权申诉”(推荐),也可以打举报电话:400-050-0827(电话支持时间:9:00-18:30)。
查看更多
由金·海伊冯,Java 技术顾问马克·罗斯,
JavaServerPages 2.0 说明 公司领导
2003年2月
作为JavaServer Pages(JSP)技术正变得被广泛地在网上的应用过程中采用, 很多JSP 程序员和从事于网络开发与维护这些网络用途的开发者面临着一个左右为难的窘境,这和许多JAVA程序员面临的窘境是一样的,就是:我们怎样组织JSP 代码,使它容易读写并且一贯保持?
在这篇文章里, 我们为写JSP 页(第1.1 版本和1.2)提出一套标准协定,那应该由使用网组成部分的一项典型的软件项目遵循。文章依据了一个JAVA程序语言模板的编码协定,这种协议用作鉴定各种各样的重要的元素, 那种元素应该被在一种编码的协定说明(对JSP 技术相关)过程中提出。 尤其, 它地址文件名字和组织,凹口,说明,指令,申明,scriptlets,表达方式,白色的空间,命名约定和编程惯例。 因为这在提出一套JSP编码约定时是我们的第一个尝试, 你对这些建议的任何反馈对于我们都十分感兴趣。 请把全部反馈送到jsp-codeconv-comments@。
JavaServer第2.0 页说明, 当有第1.2 版本完全向后相容时, 考虑到一种无书写的编程风格(如果没有申明,scriptlets和表达方式)和有许多新特征预计逐步形成这些约定。 可能的话,这篇文章选择将调控新JSP的约定为2.0个技术特征。
最后,我们假定你象已经为你的工程由你的组织采用的那样熟悉JSP 技术,Java 技术和Java 代码约定。 如果不,我们推荐你从在这里的Java 技术和在这里的JSP 技术开始。
为什么有代码约定?
代码约定的许多原因对程序员和网内容开发者来说是重要的:
他们改进软件人工制品的易读性,
他们降低训练管理和努力
他们的机构化的约定朝着标准化平衡
文件的名字和位置
命名文件给工具卖方和网络容器一种方法来决定文件的类型和相应的说明他们
下述表格列举我们建议的文件后缀和位置。
文件类型文件后缀推荐位置
JSP 技术 .jsp context root/subsystem path/
JSP碎片 .jspcontext root/subsystem path/
.jspfcontext root/WEB-INF/jspf/subsystem path/
级联样式表 .css context root/css/
JavaScript 技术 .js context root/js/
HTML网页 .html context root/subsystem path/
网络资源 .gif, .jpg, etc. context root/images/
标记库描述符 .tld context root/WEB-INF/tld/
当读上面的表格时,有一些事情记住。 首先,context root是网络应用(在一个.war 文件里面的根目录)的上下文的根。 其次,subsystem path用来提供精炼的动态和静止的网页内容的逻辑组。 对小型网络应用来说,这可能是一根空的串 。
第三,我们使用术语JSP碎片指的是能被归入另一JSP 网页的一JSP 网页。 在JSP 2.0 说明里注意到,术语JSP程序段被改为使用作为术语JSP碎片被超载。 JSP碎片能使用.jsp或者.jspf作为后缀, 并且能分别被安置或者在/WEB-INF/ jspf或者有其余静止内容。 并非整页总是使用那些后缀.jspf的JSP的碎片应该总能被安置在/WEB-INF/ jspf。第4, 虽然JSP 说明为JSP碎片建议.jspf和.jsp为可能的扩展, 我们推荐.jspf同.jsf可能被JavaServer Faces详细提出使用。
最后, 这是一个通常的方法通常,就是安置描述符库的描述符文件和任何其他非公众内容在WEB-INF/或者隶属于它的子目录之下的方法。 以这种方法,那些内容对于那些客户将越来越不易于接近和看不见 ,因为那些网络存储器将不为隶属于WEB-INF/的任何文件提供服务。
一个可选择的受欢迎的文件的名字, 象在部署描述符(web.xml)的受欢迎文件的要素里申明的那样, 如果将产生动态的内容,应该是index.jsp,或者如果受欢迎的页网是静止的,则是index.html。
当使JSP 文件国际化时,我们推荐你通过他们的地点把JSP 页把归类进目录。 例如,英文版的index.jsp将出现在下/en_US/ index.jsp而那些日本版本的相同文件的出现将在/ja _ JP / index.jsp下。 通常,Java指导课提供关于使Java 代码国际化的附加信息, 并且那些利用J2EE 平台预
文档评论(0)