SiteMesh2-sitemesh.xml的其它映射器的用法

在sitemesh.xml中做常用的三个映射器,总结如下:

映射器元素的顺序确定优先级。良好的应用程序应使用以下顺序,

  1. Parameter query = ParameterDecoratorMapper(URL参数)
  2. Page specific using meta tag = PageDecoratorMapper(页面meta标签)
  3. Pattern = ConfigDecoratorMapper(URL匹配)

请记住,映射器元素的性质可以覆盖开发人员设置的顺序。

例如,常见的错误是将ConfigDecoratorMapper放在PageDecoratorMapper之前。因为ConfigDecoratorMapper是如此通用,技术上所有页面请求将导致装载器被加载,因此PageDecoratorMapper从不被加载。即使在decorators.xml中有一个排除的情况,匹配也就是不应用装饰器,并且再次PageDecoratorMapper不会被加载。

下面将介绍其它映射器的用法,引用自http://wiki.sitemesh.org/wiki/display/sitemesh/DecoratorMappers

DecoratorMapper

描述 

AgentDecoratorMapper

可以确定请求页面的用户代理(即Web浏览器),并映射到合适的Decorator。

ConfigDecoratorMapper

DecoratorMapper的默认实现。从配置属性中读取装饰器和映射(默认'/WEB-INF/decorators.xml')。

CookieDecoratorMapper

将根据cookie值映射合适的装饰器。

EnvEntryDecoratorMapper

允许引用装饰器名称的Web应用程序环境条目,如果没有找到匹配的环境条目,则返回到ConfigDecoratorMapper的行为。

FileDecoratorMapper

将会将装饰器的名称视为使用的文件名(在Web应用程序的上下文中)。

FrameSetDecoratorMapper

当页面是HTMLPage的一个实例并且isFrameSet()返回true时,将使用指定的装饰器。该装饰器的名称应该在decorator属性中提供-如果没有提供decorator属性,则不会将装饰器应用于基于帧的页面。

InlineDecoratorMapper

用于在使用内联装饰器时确定正确的装饰器。

LanguageDecoratorMapper

可以确定浏览器中设置的首选语言请求页面,并映射到合适的Decorator(使用“Accept-Language”HTTP头)。

PageDecoratorMapper

实际页面决定要使用的装饰器。

页面的“meta.decorator”和“decorator”属性被访问,如果它们中的任何一个包含有效的Decorator的名称,那么该Decorator将被应用。

ParameterDecoratorMapper

将根据请求参数选择装饰器。

ParameterDecoratorMapper通过三个属性配置。

decorator.parameter-包含将要映射的装饰器名称的参数。默认为“装饰器”。

例如,如果decorator.parameter是“foobar”,那么myurl.jsp?foobar=mydecorator将映射到名为“mydecorator”的装饰器。

您还可以提供可选的“确认参数”。如果名为parameter.name的参数在请求URI中,并且该参数的值等于parameter.value属性,则只会映射装饰器。

例如,假设parameter.name=confirm和parameter.value=true,URI myurl.jsp?decorator=mydecorator&confirm=true将映射装饰器mydecorator。哪里的URI是myurl.jsp?decorator=mydecorator和myurl.jsp?decorator=mydecorator&confirm=false不会返回任何装饰器。

SessionDecoratorMapper

将查看一个会话属性来查找要使用的适当装饰器的名称。如果会话属性存在,则映射器将不会执行任何操作,并允许链中的下一个映射器选择装饰器。

默认情况下,它将查看“decorator”会话属性,但是可以通过使用“decorator.parameter”属性配置映射器来覆盖它。

PrintableDecoratorMapper

将检查“printable = true”是否作为请求参数提供,如果是,请使用指定的decorator。该装饰器的名称应在decorator属性中提供。

RobotDecoratorMapper

当请求者被识别为搜索引擎的机器人(也称为spider,crawler,ferret)时,将使用指定的装饰器。该装饰器的名称应在decorator属性中提供。

详细说明:https://web.archive.org/web/20071009180816fw_/http://www.opensymphony.com/sitemesh/api/com/opensymphony/module/sitemesh/mapper/package-frame.html

使用教程参考:

http://blog.csdn.net/nengyu/article/details/6736943

http://blog.csdn.net/caomiao2006/article/details/46463077

http://www.educity.cn/wenda/133329.html

posted @ 2017-06-28 01:35  EasonJim  阅读(484)  评论(0编辑  收藏  举报