使用Sitemesh实现页面装饰器模式教程
需积分: 12 165 浏览量
更新于2024-07-31
收藏 538KB PDF 举报
"这篇教程介绍了如何使用Sitemesh这一页面装配器来简化Web应用的视图构建。Sitemesh利用Decorator模式，通过过滤器拦截HTTP请求和响应，将头部（head）、内容（content）、横幅（banner）等页面组件组合成统一的视图。传统方法是通过在每个JSP页面中包含header、stylesheet、scripts和footer，而现在借助Sitemesh，我们可以省去这些繁琐的操作。教程提供了一个简单的步骤指南，包括在`WEB-INF/web.xml`中添加Sitemesh过滤器的配置，将sitemesh-2.3.jar库引入项目，以及创建`WEB-INF/decorators.xml`文件来定义装饰器页面。"
详细内容：
Sitemesh是一个开源的Web应用框架，它主要用来帮助开发者管理Web页面的布局和装饰。在本教程中，我们将学习如何使用Sitemesh来实现复合视图模式，使得页面组件如头部、主要内容和横幅能够统一管理。
1. Sitemesh工作原理：
Sitemesh使用Decorator模式，这是一种设计模式，允许我们在不修改原有对象的基础上，增加新的行为或扩展功能。在Web开发中，它通过Filter拦截HTTP请求，然后将请求转发给目标页面处理，同时捕获响应内容，将其传递给装饰器进行包装，最后返回给客户端。这样，装饰器可以对多个页面共有的元素（如头部、底部等）进行统一处理，避免了在每个页面中重复编写这些代码。
2. 配置Sitemesh：
- 在`WEB-INF/web.xml`文件中，我们需要添加一个名为`sitemesh`的Filter，其Filter类为`com.opensymphony.module.sitemesh.filter.PageFilter`。这个配置告诉容器在所有请求到达目标页面之前先通过Sitemesh Filter。
```xml
<filter>
<filter-name>sitemesh</filter-name>
<filter-class>com.opensymphony.module.sitemesh.filter.PageFilter</filter-class>
</filter>
<filter-mapping>
<filter-name>sitemesh</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
```
这样设置后，Sitemesh会处理所有以`/*`匹配的URL。
3. 引入Sitemesh库：
需要将Sitemesh的jar包（例如sitemesh-2.3.jar）放入项目的`WEB-INF/lib`目录下，以便在运行时可以找到并加载Sitemesh的相关类。
4. 创建装饰器配置：
创建`WEB-INF/decorators.xml`文件，用于定义装饰器页面和它们所匹配的URL模式。例如，我们可以定义一个名为`main`的装饰器，它的页面为`main.jsp`，并且用`*`通配符匹配所有的URL。
```xml
<decorators defaultdir="/decorators">
<decorator name="main" page="main.jsp">
<pattern>*</pattern>
</decorator>
</decorators>
```
这意味着所有请求都将使用`main.jsp`作为装饰器页面，Sitemesh会在目标页面的内容周围插入`main.jsp`中定义的布局元素。
5. 装饰器页面：
装饰器页面（如`main.jsp`）通常包含固定的页面结构，如头部、侧边栏、底部等，而`<sitemesh:decorate>`标签则用于指定页面的主内容区域。例如：
```jsp
<%@ taglib prefix="sitemesh" uri="http://www.opensymphony.com/sitemesh" %>
<html>
<head>
<!-- 共享的头部元素 -->
</head>
<body>
<div id="header">
<!-- 头部内容 -->
</div>
<div id="content">
<sitemesh:decorate>
<!-- 目标页面的内容将被插入到这里 -->
</sitemesh:decorate>
</div>
<div id="footer">
<!-- 底部内容 -->
</div>
</body>
</html>
```
这样的设计让开发者能专注于页面的核心内容，而无需关心页面的布局细节，从而提高了开发效率和代码复用性。
总结：
Sitemesh提供了一种优雅的方式来管理和装饰Web应用的页面，通过简单几步配置，就可以实现页面的统一布局。通过本教程，你应该了解了如何设置Sitemesh，以及如何使用它来创建复合视图模式，使得页面组件的管理和更新更加高效。
<decorator:body />
<decorator:title />
<decorator:getProperty />
<decorator:usePage />
<page:param
<decorator:head/>
插入原始页面(被包装页面)的 head 标签中的内容(不包括 head 标签本身)。
<decorator:body/>
插入原始页面(被包装页面)的 body 标签中的内容。
<decorator:title[default="..."]/>
插入原始页面(被包装页面)的 title 标签中的内容，还可以添加一个缺省值。
例：
/decorator/main.jsp 中（装饰器页面）:<title><decorator:titledefault="却省 titlehello" />
附加标题</title>
/aaa.jsp 中 (原始页面)：<title>aaa 页面</title>
访问/aaa.jsp 的结果：<title>aaa 页面 附加标题</title>
<decorator:getProperty property="..." [ default="..." ]
[writeEntireProperty="..."]/>
在标签处插入原始页面(被包装页面)的原有的标签的属性中的内容，还可以添加一个缺省值。
sitemesh 文档中的例子很好理解：
The decorator:<body bgcolor="white"<decorator:getProperty
property="body.onload" writeEntireProperty="true" />>
Theundecoratedpage:<body onload="document.someform.somefield.focus();">
The decorated page:<body bgcolor="white"
onload="document.someform.somefield.focus();">
注意，writeEntireProperty="true"会在插入内容前加入一个空格。
<decorator:usePageid="..."/>
象 jsp 页面中的<jsp:useBean>标签一样，可以使用被包装为一个 Page 对象的页面。 (懒的用)
例 ： 可 用 <decorator:usePage id="page" /> ： <%=page.getTitle()%> 达 到
<decorator:title/>的访问结果。
<page:applyDecoratorname="..."[page="..."title="..."]>
<page:paramname="...">...</page:param>
<page:paramname="...">...</page:param>
</page:applyDecorator>
应用包装器到指定的页面上，一般用于被包装页面中主动应用包装器。这个标签有点不好理解，
我们来看一个例子：
包装器页面 /decorators/panel.jsp：<p><decorator:title /></p> ... <p><decorator:body
/></p>
并且在 decorators.xml 中有<decoratorname="panel"page="panel.jsp"/>
一个公共页面，即将被 panel 包装：/public/date.jsp:
...<%=newjava.util.Date()%> ...<decorator:getPropertyproperty="myEmail"/>
剩余28页未读，继续阅读
2021-09-30 上传
2011-10-25 上传
2024-01-31 上传
2023-04-27 上传
2023-05-16 上传
2023-09-11 上传
2023-05-27 上传
2023-07-15 上传
2023-05-30 上传
MIJNNFDSF786D
- 粉丝: 0
- 资源: 2
我的内容管理
展开
最新资源
- 明日知道社区问答系统设计与实现-SSM框架java源码分享
- Unity3D粒子特效包：闪电效果体验报告
- Windows64位Python3.7安装Twisted库指南
- HTMLJS应用程序：多词典阿拉伯语词根检索
- 光纤通信课后习题答案解析及文件资源
- swdogen: 自动扫描源码生成 Swagger 文档的工具
- GD32F10系列芯片Keil IDE下载算法配置指南
- C++实现Emscripten版本的3D俄罗斯方块游戏
- 期末复习必备：全面数据结构课件资料
- WordPress媒体占位符插件：优化开发中的图像占位体验
- 完整扑克牌资源集-55张图片压缩包下载
- 开发轻量级时事通讯活动管理RESTful应用程序
- 长城特固618对讲机写频软件使用指南
- Memry粤语学习工具：开源应用助力记忆提升
- JMC 8.0.0版本发布，支持JDK 1.8及64位系统
- Python看图猜成语游戏源码发布
