SiteMesh使用说明.doc

SiteMesh 开发说明文档：阿1. 在工程中引入SiteMesh必要的Jar包。-/pthl/doc/lib/sitemesh-2.4.1.jarSITEMESH 官方： /sitemesh/2. 修改你的工程的web.xml,在里面加入sitemesh的过滤器，示例代码如下 sitemesh com.business.sitemesh.filter.PageFilter !- debug.pagewriter true - !- encoding utf-8 - sitemesh CentralServlet注：对于SiteMesh的Filter请使用com.business.sitemesh.filter.PageFilter，SiteMesh本身的Filter 处理虚拟URL存在无法过滤的问题，且在Weblogic8.X下存在中文乱码的情况。3. 从 E:PTHLnvqdbsrcnvqdbAppWEB-INF 目录中复制 sitemesh.xml配置文件至工程WEB-INF目录中。 注： SiteMesh.xml主要用于配置SiteMesh装饰处理信息，如对页面的解析、装饰器的配置等等, 一般采用默认即可。该配置文件中page-parsers请使用com.business.sitemesh.parser.HTMLPageParser解析器，应SiteMesh中HTMLPageParser在Weblogic 中存在中文乱码的问题。4. 装饰模板decorators.xml文件配置，在工程目录的 WEB-INF 目录加入 decorators.xml文件，该文件主要用于配置SITEMESH 装饰规则。decorators.xml有两个主要的节点： decorator结点指定了模板的位置和文件名，通过pattern来指定哪些URL引用哪个模板 excludes结点则指定了哪些路径的请求不使用任何模板； 另外还有一点要注意的是：decorators结点的defaultdir属性指定了模板文件存放的目录;示例配置如下： 从如上图可以看出，共为分四组装饰配置，我这里主要是根据角色来进行分组，具体可根据其业务要求制定规则。如访问的URL是 http:/localhost:8080/nvqdbApp/command/mingtichu/ecQLUserList。可看出该URL匹配符合如上配置规则，SITEMESH将为该页面采用 /jsp/template/tiku/mingtichu/main.jsp模板页。 5. 模板页面定义。未例代码如下：说明：1. 这里的示例将与Include 的方式进行结合，主要是为页面的维护更加方便且及于管理。2. 模板页的目的主要是将功能页中通用的、与业务功能不相关的代码的进行分离，以便统一管理，更好的达到代码重用。如页面布局、引入CSS、JS等。3. 以上这就是个简单的模板，页面的头和脚及菜单都由模板里的INCLUDE 引入决定了，主页面区域用的是标签；也就是说凡是能进入过滤器的请求生成的页面都会默认加上模板上的Include页面，然后页面自身的内容将自动放到标签所在位置；：读取被装饰页面的标题，并给出了默认标题。：读取被装饰页面的中的内容；：读取被装饰页面的中的内容；关于更多标签及模板特性的介绍可参阅： /sitemesh/ 5使用SiteMesh常见问题。 1) 在运行过程中出现无法显示模板页。 解决：查看decorators.xml 配置文件URL规则是否匹配；查看Web.xml 中 Filter 配置是否采用的是 “com.business.sitemesh.filter.PageFilter”；查看WBE-INF/sitemesh.xml配置： decorators.xml路径是否指定正确。 2) 无法显示功能页页，只显示模板页的情况。 解决：查看模板页中是否引用标签且位置是否放置正确；查看功能页代码是否规范(HTML基本结构)； 3) 在WEBLOGIC 中出现中文乱码问题。 解决：查看WEB-INF/sitemesh.xml 配置文