`
Clayz
  • 浏览: 293394 次
  • 性别: Icon_minigender_1
  • 来自: 东京
社区版块
存档分类
最新评论

JSP模板应用指南

    博客分类：
  • Java
JSPBeanHTMLServletXML 
阅读更多
Window 工具包提供了一种典型的布局机制，比如说在一个容器中确定部件元素的位置。在AWT 和 Swing都有布局管理器，而在VisualWorks Smalltalk中有wrapper。本文将介绍一种JSP模板机制，它允许布局被封装和重新利用。JSP模板最小化了布局改变所造成的影响，这里我们 将鼓励大家采用封装模块化设计。

尽管 Web开发工具的改进非常迅速，但是它们仍然落后于图形用户界面(GUI)工具包（Swing 和 VisualWorks Smalltalk）。例如，在传统的GUI工具包中提供了布局管理器，在一个窗体或另一个窗体中，允许布局运算被封装和重新利用。本文介绍的这种JSP 模板机制，就象布局管理器一样，可以封装布局，所以它能够被重新利用而不只是复制使用。

由于在布局的发展过程中出现了许多的变化，而对功能的封装是非常重要的一步，它能够被自如修改而做到对其他应用的影响最小。

JSP没有提供对封装布局的直接支持，所以具有统一格式的网页通常可以复制布局代码；例如，在图1中，显示了一个网页，它包含了标题、页脚、工具条以及页面的主要内容。

在图1中显示的网页布局将以HTML表格标签来执行：

例1.包含内容：
xml 代码
 
  1. < html > < head > < title > JSPtemplates </ title > </ head >   
  2. < body   background = 'graphics/background.jpg' >   
  3. < table >   
  4. < tr   valign = 'top' > < td > < %@include  file = 'sidebar.html' % > </ td >   
  5. < td > < table >   
  6. < tr > < td > < %@include  file = 'header.html' % > </ td > </ tr >   
  7. < tr > < td > < %@include  file = 'introduction.html' % > </ td > </ tr >   
  8. < tr > < td > < %@include  file = 'footer.html' % > </ td > </ tr >   
  9. </ table >   
  10. </ td >   
  11. </ tr >   
  12. </ table >   
  13. </ body > </ html >   

在上面的例子中，包括了JSP include 命令，它允许页面内容改变——通过改变包含的文件——无须修改网页自身。不过，由于布局是很难被编码的，布局改变需要对网页进行修改。如果一个网站有多个 相同格式的页面，那么一般情况下甚至简单布局的改变也涉及到整个页面的修改。

为了减少布局改变所造成的影响，我们需要一种仅仅只包含布局的机制；采用这种机制，布局和内容都可以在不修改文件的情况下分开进行修改。这种机制就是JSP模板。

使用模板

模板是一种JSP文件，它包含了参数化了的内容。这里所讨论的模板使用的是一套定制化标签来执行的：template:get，template: put和template:insert。template:get 标签访问参数化的内容，就象在例 2.a中的一样，它将和图 1一样的格式来生成网页。

例 2.a.一个模板
xml 代码
 
  1. < %@taglib  uri = '/WEB-INF/tlds/template.tld'   prefix = 'template'  % >   
  2. < html > < head > < title > < template:get   name = 'title' /> </ title > </ head >   
  3. < body   background = 'graphics/background.jpg' >   
  4. < table >   
  5. < tr   valign = 'top' > < td > < template:get   name = 'sidebar' /> </ td >   
  6. < td > < table >   
  7. < tr > < td > < template:get   name = 'header' /> </ td > </ tr >   
  8. < tr > < td > < template:get   name = 'content' /> </ td > </ tr >   
  9. < tr > < td > < template:get   name = 'footer' /> </ td > </ tr >   
  10. </ table >   
  11. </ td >   
  12. </ tr >   
  13. </ table >   
  14. </ body > </ html >   

例 2.a几乎与例1完全一样，不过在例2.a中我们使用了template:get 取代了例1中的include 命令.让我们来分析一下template:get 如何运行。

template:get 使用了一个专门的名字（在请求的范围内）来对一个Java Bean进行修改。Bean包含了URI (统一资源标志符，网页的一个组件，它包含在template:get中)。例如，在例 2.a的模板列表中，template:get 获得了一个URI——header.html——从一个名为header 的Bean中（在请求的范围内）。接着在template:get 中包含了header.html。

template:put 把Bean放到请求的范围内（此范围将在后面被template:get修改）。 模板包含在template:insert中。 例 2.b中举例说明了put 和 insert 标签的用法：

例 2.b. 从例2.a中使用模板
xml 代码
 
  1. < %@taglib  uri = '/WEB-INF/tlds/template.tld'   prefix = 'template'  % >   
  2. < template:inserttemplate template:inserttemplate = '/articleTemplate.jsp' >   
  3. < template:put   name = 'title'   content = 'Templates'   direct = 'true' />   
  4. < template:put   name = 'header'   content = '/header.html'   />   
  5. < template:put   name = 'sidebar'   content = '/sidebar.jsp'   />   
  6. < template:put   name = 'content'   content = '/introduction.html' />   
  7. < template:put   name = 'footer'   content = '/footer.html'   />   
  8. </ template:  insert >   

在insert 开头标签指定了被包含的模板，在这个例子里，模板在例2.a中。每一个put 标签在请求范围内存储了一个Bean，而在insert 结尾标签包含了模板。模板接着象上面所描述的那样访问Bean。

direct 的属性能够为template:put指定；如果direct 设置为true， 和标签相关联的内容将不包含在template: get中。

一个网站包含了多页相同格式的页面，这样就可以使用一个模板，比如在例 2.a中列出了一个模板，在许多的JSP网页（例2.b）中，都用到了这个模板。

使用模板的另一个好处是可以进行模块化设计。例如，例2.b中列出的JSP 文件中包含了header.html，让我们再来看下面的例2.c。

例2.c. header.html
xml 代码
 
  1. < table >   
  2. < tr >   
  3. < td > < img   src = 'graphics/java.jpg' /> </ td >   
  4. < td > < img   src = 'graphics/templates.jpg' /> </ td >   
  5. </ tr >   
  6. </ table > < hr >   

由于header.html 是被包含的内容，所以它不必在需要显示标头的页面中复制其代码。而且，尽管header.html 是一个HTML文件，但是在文件中并没有使用一般的起始HTML标签（比如<html>或<body>），因为这些标签都将被模 板定义。由于在模板中包含了header.html，这些标签在header.html就可以不必再使用了。

注意：JSP提供了 两种方式来包含内容：静态方式，使用include命令；动态方式，使用include action。include命令包含了目标页面的引用源，这和C语言中的#include和Java中的import相似。include action 包含了在运行时间内目标所产生的响应。

与JSP include action一样，模板包含有动态内容。所以，尽管在例1和例2.b中的JSP网页在功能上是一致的，但是前面包含的静态内容被后面动态的包含了。

可选内容

所有的模板内容都是可选的，模板的内容可以很容易的在更多的网页中使用。例如，在图 2.a和图 2.B中显示了两个页面——登录和清单——它们使用的是同一个模板。两个页面中都包含一个标头、页脚和主要内容。清单页面中有一个编辑Panel (这是登陆页面所缺乏的)用来改变清单。

下面，你会发现模板将被登录和清单页面共用：
xml 代码
 
  1. < %@taglib  uri = 'template.tld'   prefix = 'template'  % >   
  2. ……  
  3. < table   width = '670' >   
  4. < tr > < td   width = '60' > </ td >   
  5. < td > < template:get   name = 'header' /> </ td > </ tr >   
  6. < tr > < td   width = '60' > </ td >   
  7. < td > < template:get   name = 'main-content' /> </ td > </ tr >   
  8. < tr > < td   width = '60' > </ td >   
  9. < td > < template:get   name = 'editPanel' /> </ td > </ tr >   
  10. < tr > < td   width = '60' > </ td >   
  11. < td > < template:get   name = 'footer' /> </ td > </ tr >   
  12. </ table >   
  13. ……  

清单页面使用了上面的模板以及专门用于编辑Panel的内容:
xml 代码
 
  1. < %@taglib  uri = 'template.tld'   prefix = 'template'  % >   
  2. < %@taglib  uri = 'security.tld'   prefix = 'security'  % >   
  3. < template:inserttemplate template:inserttemplate = '/template.jsp' >   
  4. ……  
  5.   
  6. < template:put   name = 'editPanel'   content = '/editPanelContent.jsp' />   
  7. ……  
  8. </ template:insert >   

与上面相对照，登录页面没有专门用于编辑Panel的内容:
xml 代码
 
  1. < %@taglib  uri = 'template.tld'   prefix = 'template'  % >   
  2. < template:inserttemplate template:inserttemplate = '/template.jsp' >   
  3. < template:put   name = 'title'   content = 'Login'   direct = 'true' />   
  4. < template:put   name = 'header'   content = '/header.jsp' />   
  5. < template:put   name = 'main-content'   content = '/login.jsp' />   
  6. < template:put   name = 'footer'   content = '/footer.jsp' />   
  7. </ template:insert >   

由于登录页面中没有专门用于编辑Panel的内容，所以它没有包括。

基于Role的内容

Web应用程序常常会基于不同的用户生成不同的内容。 例如，相同的 JSP模板，只有当用户为管理员的时候才出现编辑Panel，下面是得出的两个不同的页面（如图3.a和3.b.）

在图3.a和3.b中的模板使用了template:get的 role 属性:
xml 代码
 
  1. < %@taglib  uri = 'template.tld'   prefix = 'template'  % >   
  2. ......  
  3. < table >   
  4. ......  
  5. < td > < template:get   name = 'editPanel'   role = 'curator' /> </ td > </ tr >   
  6. ......  
  7. </ table >   
  8. ......  

get 标签仅仅在用户的Role 与Role属性相匹配的时候才包含内容。让我们来看看标签handler是如何使用Role属性的：
java 代码
 
  1. public   class  GettagextendstagSupport {  
  2. private  String name =  null ， role =  null ;  
  3. ......  
  4. public   void  setRole(String role) {  this .role = role; }  
  5. ......  
  6. public   int  doStartTag()  throws  JspException {  
  7. ......  
  8. if (param !=  null ) {  
  9. if (roleIsValid()) {  
  10. // include or print content ......   
  11. }  
  12. }  
  13. ......  
  14. }  
  15.   
  16. private   boolean  roleIsValid() {  
  17. return  role ==  null  ||  // valid if role isn't set   
  18. ((javax.Servlet.http.HttpServletRequest)  
  19. pageContext.getRequest()).isUserInRole(role);  
  20. }  
  21. } 

执行模板

这里所讨论的模板将在三种定制标签下执行:

Template: insert

Template: put

Template: get

insert 标签中包含一个模板，但是在包含之前，put 标签存储有一些信息——name， URI和Boolean 值（用来指定将内容是包含还是直接显示）——关于模板所包含的内容。在template:get中包含（或显示）了指定的内容，随后将访问这些信息。

template:put 把Bean 存储在请求区域（但并不直接存储），因为如果两个模板使用了相同的内容名，一个嵌套模板就将覆盖封装模板中的内容。

为了保证每一个模板能够只存取它自己的信息，template:insert 保留了一个hashtable堆栈。每一个insert 开始标签建立一个 hashtable并把它放入堆栈。封装的put 标签建立bean并把它们保存到最近建立的hashtable中。随后，在被包含模板中的 get 标签访问hashtable中的bean。图 4 显示了堆栈是如何被保留的。

在图 4中每一个模板访问正确的页脚、footer.html 和footer_2.html。如果 bean被直接存储在请求区域，图 4中的step 5将覆盖在step 2中指定的footer bean。

模板标签执行

接下来我们将分析三个模板标签的执行: insert， put和get。我们先从图 5开始。这个图表说明了当一个模板被使用时，insert和put标签事件的执行顺序。

如果一个模板堆栈已经不存在，insert 开始标签就会建立一个并把它放置到请求区域。随后一个hashtable也被建立并放到堆栈中。

每一个 put 开始标签建立一个PageParameter bean，并存储在由封装的insert标签建立的hashtable中。

插入 end 标签包含了这个模板。这个模板使用get标签来访问由put标签建立的bean。在模板被处理以后，由insert 开始标签建立的hashtable就从堆栈中清除。

模板标签列表

标签handler很简单。在例 3.a中列出了Insert标签类——标签handler。

例 3.a. InsertTag.java
java 代码
 
  1. packagetags.templates;  
  2. import  java.util.Hashtable;  
  3. import  java.util.Stack;  
  4. import  javax.servlet.jsp.JspException;  
  5. import  javax.servlet.jsp.PageContext;  
  6. import  javax.servlet.jsp.tagext.TagSupport;  
  7. public   class  InserttagextendstagSupport {  
  8.   
  9. private  Stringtemplate;  
  10. private  Stack stack;  
  11. // setter method fortemplate 属性   
  12. public   void  setTemplate(Stringtemplate) {  
  13. this .template =template;  
  14. }  
  15.   
  16. public   int  doStartTag()  throws  JspException {  
  17. stack = getStack(); // obtain a reference to thetemplate stack   
  18. stack.push(new  Hashtable());  // push new hashtable onto stack   
  19. return  EVAL_BODY_INCLUDE;  // pass tagbody through unchanged   
  20. }  
  21.   
  22. public   int  doEndTag()  throws  JspException {  
  23. try  {  
  24. pageContext.include(template); // includetemplate   
  25. }  
  26.   
  27. catch (Exception ex) {  // IOException or ServletException   
  28. throw   new  JspException(ex.getMessage());  // recast exception   
  29. }  
  30.   
  31. stack.pop(); // pop hashtable off stack   
  32. return  EVAL_PAGE;  // evaluate the rest of the page after the tag   
  33. }  
  34.   
  35. // taghandlers should always implement release() because   
  36. // handlers can be reused by the JSP container   
  37.   
  38. public   void  release() {  
  39. template = null ;  
  40. stack = null ;  
  41. }  
  42.   
  43. public  Stack getStack() {  
  44. // try to get stack from request scope   
  45. Stack s = (Stack)pageContext.get属性(  
  46. "template-stack" ，  
  47. PageContext.REQUEST_SCOPE);  
  48. // if the stack's not present， create a new one和   
  49. // put it into request scope   
  50. if (s ==  null ) {  
  51. s = new  Stack();  
  52. pageContext.set属性("template-stack" ， s，  
  53. PageContext.REQUEST_SCOPE);  
  54. }  
  55. return  s;  
  56. }  
  57. }  

例 3.b 列出了 Put标签类和标签handler:

例 3.b. PutTag.java
java 代码
 
  1. packagetags.templates;  
  2. import  java.util.Hashtable;  
  3. import  java.util.Stack;  
  4. import  javax.servlet.jsp.JspException;  
  5. import  javax.servlet.jsp.tagext.TagSupport;  
  6. import  beans.templates.PageParameter;  
  7. public   class  PuttagextendstagSupport {  
  8. private  String name， content， direct= "false" ;  
  9. // setter methods for Put tag attributes   
  10. public   void  setName(String s) { name = s; }  
  11. public   void  setContent(String s) {content = s; }  
  12. public   void  setDirect(String s) { direct = s; }  
  13. public   int  doStartTag()  throws  JspException {  
  14. // obtain a reference to enclosing insert tag   
  15. Inserttagparent = (InsertTag)getAncestor("tags.templates.InsertTag" );  
  16. // puttags must be enclosed in an insert tag   
  17. if (parent ==  null )  
  18. throw   new  JspException( "PutTag.doStartTag(): "  +  "No Inserttagancestor" );  
  19. // gettemplate stack from insert tag   
  20. Stacktemplate_stack = parent.getStack();  
  21. //template stack should never be null   
  22. if (template_stack ==  null )  
  23. throw   new  JspException( "PutTag: notemplate stack" );  
  24. // peek at hashtable on the stack   
  25. Hashtable params = (Hashtable)template_stack.peek();  
  26. // hashtable should never be null either   
  27. if (params ==  null )  
  28. throw   new  JspException( "PutTag: no hashtable" );  
  29. // put a new PageParameter in the hashtable   
  30. params.put(name， new  PageParameter(content， direct));  
  31. return  SKIP_BODY;  // not interested in tagbody， if present   
  32. }  
  33.   
  34. // taghandlers should always implement release() because   
  35. // handlers can be reused by the JSP container   
  36. public   void  release() {  
  37. name = content = direct = null ;  
  38. }  
  39.   
  40. // convenience method for finding ancestor names with   
  41. // a specific class name   
  42. privatetagSupport getAncestor(String className) throws  JspException {  
  43. Class klass = null ;  // can't name variable "class"   
  44. try  {  
  45. klass = Class.forName(className);  
  46. }  
  47. catch (ClassNotFoundException ex) {  
  48. throw   new  JspException(ex.getMessage());  
  49. }  
  50. return  (TagSupport)findAncestorWithClass( this ， klass);  
  51. }  
  52. }  

PutTag.doStarttag建立了一个 PageParameter bean – 在例 3.c中列出——然后存储到请求区域。

例 3.c. PageParameter.java
java 代码
 
  1. package  beans.templates;  
  2. public   class  PageParameter {  
  3. private  String content， direct;  
  4. public   void  setContent(String s) {content = s; }  
  5. public   void  setDirect(String s) { direct = s; }  
  6. public  String getContent() {  return  content;}  
  7. public   boolean  isDirect() { 
分享到：
| 用Java Mail发送带图片附件
评论
发表评论

您还没有登录,请您登录后再发表评论

相关推荐

    JSP模板应用指南（上）

    本文将介绍一种JSP模板机制，它允许布局被封装和重新利用。JSP模板最小化了布局改变所造成的影响，这里我们将鼓励大家采用封装模块化设计。 尽管 Web开发工具的改进非常迅速，但是它们仍然落后于图形用户界面(GUI)...

    JSP模板应用指南（下）

    执行模板 这里所讨论的模板将在三种定制标签下... template:put 把Bean 存储在请求区域（但并不直接存储），因为如果两个模板使用了相同的内容名，一个嵌套模板就将覆盖封装模板中的内容。 为了保证每一个模板能够只

    Velocity 模板使用指南

    当Velocity应用于web开发时，界面设计人员可以和java程序开发人员同步开发一个遵循MVC架构的web站点，也就是说，页面设计人员可以只 关注页面的显示效果，而由java程序开发人员关注业务逻辑编码。Velocity将java...

    velocity模板使用指南中文版

    velocity是一个很实用的页面工具，相对于jsp更便于开发维护，本文档是他的一个基础使用工具，便于比更快学习使用velocity！

    OpenCMS内容管理入门指南.pdf

    OpenCms是一个J2EE的产品，它是用Java写成的。它和Tomcat捆绑在一起。但是也能够使用ATG Dynamo、WebLogic和WebSphere。...新版本提供了一个新的模板引擎，JSP支持，一种新的连接管理系统，提高了稳定性

    Freemarker使用指南_中文版文档

    FreeMarker 是一个用Java语言编写的模板引擎，它基于模板输出文本。FreeMarker 与 Web 容器无关，即在Web运行时，它并不知道 Servlet 或 HTTP。它不仅可以用作表现层的实现技术，而且还可以用于生成XML，JSP或Java ...

    J2EE中文版指南 CHM格式 带全文检索

    谁应该使用这指南 13 关于例子 13 理解例子的准备工作 13 例子下载 13 如何编译并运行例子 13 相关信息 14 第1章 总 括 14 一．分布式得多层应用程序 14 J2EE组件 15 J2EE客户端 15 网络浏览器 15 小程序 15 应用...

    Spring开发指南

    Web 应用中模板技术与 JSP 技术的对比 输入验证与数据绑定 异常处理 国际化支持 WebWork2 & Spring Quick Start WebWork 高级特性 Action 驱动模式 XWork 拦截器体系 输入校验 国际化支持 Webwork2...

    Velocity学习指南（中文版）.rar

    Velocity用户指南旨在帮助页面设计者和内容提供者了解Velocity和其简单而又强大的脚本语言（Velocity Template Language (VTL)）。本指南中有很多示例展示了用Velocity来讲动态内容嵌入到网站之中，但是所有的VTL ...

    springboot参考指南

    使用Spock测试Spring Boot应用 iv. 35.4. 测试工具 i. 35.4.1. ConfigFileApplicationContextInitializer ii. 35.4.2. EnvironmentTestUtils iii. 35.4.3. OutputCapture iv. 35.4.4. TestRestTemplate xv. 36. ...

    ExtJS Web应用程序开发指南(1-10)

    本书增强型模板介绍了ExtJS与数据交互重要的数据模型、ExtJS的JSP标签库ExtTLD和ExtJS高级组件。考虑到 ExtJS与主流服务端框架的整合也越来越紧密，本书还特意讲解了Struts和Struts2框架的整合与配置。本书全面细致...

    ExtJS Web应用程序开发指南(10-15)完毕

    本书增强型模板介绍了ExtJS与数据交互重要的数据模型、ExtJS的JSP标签库ExtTLD和ExtJS高级组件。考虑到 ExtJS与主流服务端框架的整合也越来越紧密，本书还特意讲解了Struts和Struts2框架的整合与配置。本书全面细致...

    FreeMarker 学习资料

    FreeMarker是一个模板引擎，一个基于模板生成文本输出的通用工具，使用纯Java编写 ...l FreeMarker更适合作为Model2框架（如Struts）的视图组件，你也可以在模板中使用JSP标记库 l FreeMarker是免费的

    Jakarta+Struts+编程[扫描版][中文]

    本书利用大量使用了标准JSP标记库和Struts附加程序的实际例子，研究了Struts环境中的JSP编程技术。用户还将掌握多层应用程序编程，从Struts应用程序同EJB交互，利用Struts提供的包和工具处理复杂验证和登录。无论你...

    FreeMarker技术指南

    二、FreeMarker与JSP、Velocity的对比 三、一个简单的FreeMarker Demo 四、FreeMarker的数据模型 五、模板的常用指令 六.常用的FTL标记 七、内建函数： 八、FreeMarker macro(宏)的使用 九、通过Struts2设置type来...

    structs程序设计从入门到精通word文档

    1.3 JSP流行模板Struts的安装配置 8 1.4Struts 用户指南 8 1.5 你的第一个struts应用程序 8 第2章深入Struts结构 8 2.1人介绍应用框架 mvc和model2 8 2.2 Struts原理、开发及项目实施 8 2.3使用STRUST控制流 8 2.4...

    Spring, SpringMVC, MyBatis, JDBC, MySQL, JSP, Servlet, Bootstrap

    项目经理和架构师：这些项目可以作为参考和模板，帮助您更好地规划和设计实际业务场景中的Java项目。 四、下载与使用 下载：所有项目均提供下载，您只需在平台上注册并登录即可获取。 安装与部署：每个项目都提供了...

    Jakarta Struts编程（中英文双版版电子书part2）

    Struts映射到Model 2设计模式的完整介绍 ， 详细论述利用JSP使用Struts的知识，包括Struts标记库 Struts异常处理、验证和登录 Struts应用程序的国际化和本地化 完整论述新StrutsTiles模板库 ...

Magicbox
Global site tag (gtag.js) - Google Analytics