1. 简单说明:
在JSP 2.0后, 你不再需要大刀阔斧地定义一堆TagSupport或BodyTagSupport, 使用JSP Tag Files技术可以实现功能强大的页面模板技术. 在这里抛砖引玉, 结合项目开发, 简单介绍Tag Files技术的应用. 至于详细教程与资料, 请大家参考Java EE Tutorial, 上面有详细的E文资料.
http://docs.oracle.com/javaee/5/tutorial/doc/bnama.html
2. 定义模板:/WEB-INF/tags/subView.tag
- <?xml version="1.0" encoding="UTF-8" ?>
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
- <!--
- <%@ tag language="java" pageEncoding="UTF-8" isELIgnored="false"%>
- <%@ taglib prefix="tags" tagdir="/WEB-INF/tags/"%>
- <%@ attribute name="id" required="true"%>
- <%@ attribute name="title" required="false"%>
- <%@ attribute name="headStyle" required="false" fragment="true"%>
- <%@ attribute name="headScript" required="false" fragment="true"%>
- <%@ attribute name="body" required="false" fragment="true"%>
- <%@ attribute name="footScript" required="false" fragment="true"%>
- -->
- <html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <tags:header />
- <!-- 自定义css部分 -->
- <jsp:invoke fragment="headStyle" />
- <!-- 自定义js部分 -->
- <jsp:invoke fragment="headScript" />
- </head>
- <body class="pbody" id="approveApply">
- <div class="mainhd">
- <p class="maintit">${title}</p>
- </div>
- <div id="__body__">
- <!-- 自定义body -->
- <jsp:invoke fragment="body" />
- </div>
- <jsp:invoke fragment="footScript" />
- <div id="__footer__">
- <tags:footer version="${version}" />
- </div>
- </body>
- </html>
复制代码
其中, <tags:header>是头部模板, <tags:footer>是底部模板, 小模板再整合到大的<tags:subView>模板
2. 继承模板, 实现具体页面: /view/deploy/approveApply.jsp
- <?xml version="1.0" encoding="UTF-8" ?>
- <%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
- <%@ taglib prefix="tags" tagdir="/WEB-INF/tags/"%>
- <%@ taglib prefix="app" uri="http://risecloud.com/app"%>
- <tags:subView id="approveApply" title="审核请求">
- <jsp:attribute name="body">
- <div id="mainGrid"></div>
- </jsp:attribute>
- <jsp:attribute name="footScript">
- <!-- 覆盖页面样式类 -->
- <script type="text/javascript" src="${pageContext.request.contextPath}/js/deploy/ApproveApplyGrid.js?${app:pageVersion()}"></script>
- <script type="text/javascript" src="${pageContext.request.contextPath}/js/deploy/ApproveApplyDialog.js?${app:pageVersion()}"></script>
- <script type="text/javascript">
- //<![CDATA[
- $(function() {
- var grid = ApproveApplyGrid.create({
- selector : '#mainGrid',
- url : window.getCctxUrl('/deploy/approveApply!listGameApply'),
- agree : function(ret) {
- alert('agree')
- },
- deny : function(ret, rec) {
- alert('agree')
- }
- });
- });
- //]]>
- </script>
- </jsp:attribute>
- </tags:subView>
复制代码
其中:
1. id, title, body, footScript等分别是在<tabs:subView>中的模板区域, 这里逐一替换.
2. ${app:pageVersion()}是自定义的JSP EL Function, 在新版本发布时, 可以迫使用户浏览器更新缓存. 具体定义为/WEB-INF/app.tld,
- <?xml version="1.0" encoding="UTF-8"?>
- <taglib xsi:schemaLocation="http://java.sun.com/xml/ns/javaee web-jsptaglibrary_2_1.xsd" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="2.1">
- <tlib-version>1.0</tlib-version>
- <jsp-version>2.1</jsp-version>
- <short-name>app</short-name>
- <uri>http://risecloud.com/app</uri>;
- <display-name>app</display-name>
- <function>
- <name>pageVersion</name>
- <function-class>com.yy.game.risecloud.taglib.RiseCloundFunctionLib</function-class>
- <function-signature>java.lang.String pageVersion()</function-signature>
- </function>
- </taglib>
复制代码
注意EL Function都必须static
3. 具体效果: 图中红线框外的是模板, 红线框内是继承模板的页面实现, 既统一, 又省事. 这不是你梦寐以求的么?
注意:
1. JSP Tag Files默认放在/WEB-INF/tags/目录, 使用文件名直接引用. 如果其他地方, 必须在web.xml中使用<jsp-config>声明!
2. JSP EL Functions的tld默认放在/WEB-INF/下面, 如果其他地方, 必须在web.xml中使用<jsp-config>声明!
这二者如果放在默认位置, 在Servlet容器启动时会自动加载. 无需再配置什么! 具体使用, 大家可以参考Java EE Tutorial