Facelets介绍,第二部分 -

lxcaoxin

浏览: 127898 次
性别:
来自: 南宁

最近访客更多访客>>

kikidu1pick

devcang

zcf58030

huhua2

博主相关

博客

微博

相册

留言

关于我

文章分类

社区版块

存档分类

Facelets介绍,第二部分

博客分类：

JBOSS

这是关于Facelets文章系列的第二篇，Facelets是用来建立JSF应用程序时的一个可供选择的表现层技术。第一篇文章提供了Facelets的介绍。在这篇文章中，Jacob将会告诉你如何在JSF应用中开始使用Facelets。

准备开始
Facelets是作为JSF的一个ViewHandler实现的，可以被简便的配置到你的应用程序中。使用Facelets很简单，确保Facelets Jar(jsf-facelets.jar)在你项目的classpath中，并且对你的faces-config.xml文件做一个简单的修改就可以了。
<faces-config> <application>  <view-handler>com.sun.facelets.FaceletViewHandler</view-handler> </application> </faces-config>
JavaServer Faces默认使用JSP文件定义视图(*.jsp)。你需要在你的WEB-INF/web.xml中修改该类型。

<context-param> <param-name>javax.faces.DEFAULT_SUFFIX</param-name> <param-value>.xhtml</param-value> </context-param>
依照上面定义的context-param，你就可以开始写Facelets并且将他们保存为以.xhtml类型的文档。你现在可以开始使用Facelets了。

内建类库
Facelets使用JavaServer Faces API 中所有UIComponents的方法和你在JSP中使用的方法一样。这就意味着你可以在线的JSF的tag类库文档。

也有一个简单的JSTL的核心库提供给你<c:forEach/> 和 <c:if/>。

最后，Facelets内建了一个UI标签库提供了模板化和重用性。关于这方面更多的资料在本文的第三篇文章中。

建立一个Facelet
Facelets仅仅需要严格的XML格式。他们不依赖于XHTML语法，可以被使用到VML，SVG，甚至SOAP中。使用JSP，你通常反复的引用标签库，而Facelets只需要在编译期间找到命名空间即可，和JSPX类似。这里是一个XHTML文档的开始部分：

<html xmlns="http://www.w3.org/1999/xhtml" xmlns:h="http://java.sun.com/jsf/html" xmlns:f="http://java.sun.com/jsf/core"> <head> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> <title>My First Facelet</title> </head> <body>  Hello #{param.name}! </body> </html>
你可以把这段代码保存为test.xhtml然后即刻请求test.jsf?name=Jacob（如果你的FacesServlet被map到*.jsf）。这是一个很好的用来确保你已经正确设置Facelets的测试。

使用EL
Facelets使用JSF中新的EL-API规范。这就意味着你可以交替使用${ } 或者 #{ }，而不像是JSP。如上例所示，表达式可以内嵌正则文本。

如果你使用JSF1.2，你可以添加你自己定义的ELResolvers来整合诸如Spring，EJB，JNDI等等。－－全部都可以如果你需要的话。你甚至可以拥有适合你应用程序对象的ELResolvers。

EL-API是JSP2.1规范的一部分，但是不依赖于JSP或者JSF。这就意味着它可以和Facelets一起被应用到任何部署中。

使用组件
在上面的test.xhtml实例中，你发现了额外的命名空间被申明。这些和JavaServer Faces API中内建的JSP标签库的命名空间相同。再次，Facelets期望建立在常见的领域和文档之外。

当你使用Facelets中内建的JSF组件，有一个标签库文档是一件很好的事。

既然我们已经有了test.xhtml作为开始，让我们来创建一个简单的表单。将下面的代码加入你页面的body中：

<h:form> <h:inputText value="#{person.name}"/> <h:commandButton action="#{person.action}"/> </h:form>
下面的步骤将是创建你自己的backingbean(BB)并修改faces-config.xml。

别名组件（jsfc）
前面的方法使用了特殊的标签，而使得他们在一个HTML编辑器工具（比如Dreamweaver）中不是特别好看。Facelets提供了一种不同的方法，使用标准HTML元素的jsfc属性来指定你页面中的组件（非常类似于Tapestry 和 Struts Shale 的 Clay plugin）

Facelets编译器寻找文档中所有组件的jsfc属性。jsfc属性的值是页面设计者用来在该页面中取代此元素值的别名。

<input type="text" jsfc="h:inputText" value="#{foo.bar}"/>
Facelets在编译的时候将会生成一个h:inputText组件，同时将会自动配置所有合适的属性。

别名组件允许设计工具看到正常的HTML input标签，而编程人员可以将之看成是一个在jsfc属性中定义的JSF组件。

Facelet 编译
如第一篇文中提到的，Facelets只编译规范的XML。这些文件可以只有一行或者三行，唯一的要求就是它必须是合法的XML文档。

Facelets使用SAX来将文档编译成拥有TagHandlers的无状态树包含在一个Facelet对象中。Facelets是线程安全的并且可以被简单的应用在一次多请求的大规模部署中。Facelets在编译期间提供在JSF中使用到类库及视图操作的警告消息和报告。

执行Facelets编译是简单的，如下所示：

// grab our FaceletFactory and create a Facelet FaceletFactory factory = FaceletFactory.getInstance(); Facelet f = factory.getFacelet(viewToRender.getViewId()); // populate UIViewRoot f.apply(context, viewToRender);
更多关于Facelet的体系架构将会在稍后的文章中提供。

Exceptions & Debugging
Facelets注重了错误操作的解决。举个例子，有次你不小心的打错了一个属性的表达式，Facelets将会在编译期间自动生成一条如下的错误信息：

greeting.xhtml @18,97 <input action="#{success[}"> Error Parsing: #{success[}
正如你所看到的，Facelets为你提供了错误消息来告诉你什么文件哪一行哪一列发生了错误。它甚至提供了发生错误的元素及属性。

Facelets也使用java.util.logging包来打印出排错消息。你可以阅读这里来了解如何在你的JRE中设置日值。

自定义组件
Facelets允许你使用一个XML文件或者Java代码来自定义你自己的组件库，但是在此篇文中我将只会涉及使用XML配置，因为XML配置是更好的选择。

<facelet-taglib> <namespace>http://www.mycompany.com/jsf</namespace> <tag> <tag-name>bar</tag-name> <component> <component-type>javax.faces.Data</component-type> <renderer-type>com.mycompany.Bar</renderer-type> </component> </tag> </facelet-taglib>
这就是你整合你的组件到Facelets中所要做的全部工作。这些XML文档可以使用下面两种方法参考。
（译注：关于在Facelets中如何使用Tomahawk组件，可在此查阅）

Reference them in a ";" delimitted list within your web.xml under the init-param "facelets.LIBRARIES". These files are relative to your application, just like referencing Struts configuration files.
在你的web.xml的init-param?facelets.LIBRARIES?中引用，使用?；?分隔不同XML配置文件。这些文档和你的应用程序有关，就如同引用Struts的配置文件一样。
Package them in your JAR's META-INF folder with a file extension of ".taglib.xml". Facelets will automatically pick these up for compilation just as with JSP tld files.
将它们打包到你的JAR文件中的META-INF文件夹中，使用一个以?.taglib.xml?结尾的文件。Facelets将会自动将这些读入编译，就好像JSP的tld文件。
在facelet-taglib文件中，你也可以指定转换器，验证器，和自定义的TagHandler来获取文件处理的的最终控制。

自定义验证器和转换器
验证器和转换器可以在Facelet中通过同一个facelet-taglib文档描述。

<facelet-taglib> <namespace>http://www.jsfcentral.com/public</namespace> <tag> <tag-name>validateRegExp</tag-name> <validator> <validator-id>foo.bar.RegExp</validator-id> </validator> </tag> <tag> <tag-name>convertUtilDate</tag-name> <converter> <converter-id>foo.bar.UtilDate</converter-id> </converter> </tag> </facelet-taglib>
再次，由于Facelets和JavaServer Faces的API整合的很紧密，这些就是你所要定义的全部。Facelets将会自动装配这些属性到你的Converter或者是Validator对象中。

自定义组件
好的，我还没有想到但是你想在Facelets中添加你的自定义组件。这就包含了你想要为UIComponents，Validators，Converters装配各自的属性。

Facelets提供了许多基本类来使得你的工作更简单。让我们来看看<c:if>的源码，或许能给你一些好主意：

public final class IfHandler extends TagHandler { protected final TagAttribute test; protected final TagAttribute var; public IfHandler(TagConfig config) { super(config); this.test = this.getRequiredAttribute("test"); this.var = this.getAttribute("var"); } public void apply(FaceletContext ctx, UIComponent parent) throws IOException, FacesException, ELException { boolean b = this.test.getBoolean(ctx); if (this.var != null) { ctx.setAttribute(var.getValue(ctx), new Boolean(b)); } if (b) { this.nextHandler.apply(ctx, parent); } } }
这就是了！你将发现当文档被编译的时候Facelets使用了?好居民?法则和构造函数注入的方法。Facelets和全部标签都是无状态的，而不像JSP（添加入了tag handler对象）。更多技术方面的细节将会在一篇不同的文档中提供，所以现在酒描述tag里面是如何进行的。

TagHandler，<c:if> 继承的，是一个很好的让你可以使用开发自定义标签的基本类示例。将TagHandler想象成JSP的TagSupport或者BodyTagSupport。

在构造函数中，该Tag的表现被传递，转达了该文档的结构包含的：位置，子标签，和属性。

TagAttributes是XML文档中属性的表现。他们有众多方法来处理EL表达式和高压方法到你需要的类型中。他们也是无状态的，他们的方法必须要传递到FaceletContext中以提供当前的状态。

最后一点比较有趣的就是子元素被部分变量nextHandler表现。你可以在<c:if>的情况下添加任意多的子元素或者根本不添加。

我们自定义的组件已经写了出来，你可以继续将它添加到facelet-taglib文档中：

<facelet-taglib> <namespace>http://www.jsfcentral.com/public</namespace> <tag> <tag-name>if</tag-name> <handler-class>com.jsfcentral.IfHandler</handler-class> </tag> </facelet-taglib>
总结
这仅仅是使用Facelets框架的一个简短介绍。接下来将会有更多关于模板化，特色和定制Facelets的详细文章。

分享到：

seam3 登陆验证 | Facelets介绍,第一部分

2011-10-14 13:56
浏览 1246
评论(0)
分类:Web前端
查看更多

发表评论

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

最近访客更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论

Facelets介绍,第二部分

评论

发表评论

相关推荐

最近访客 更多访客>>

博主相关

文章分类

社区版块

存档分类

最新评论

Facelets介绍,第二部分

评论

发表评论

相关推荐

调用webservice出现javax.xml.bind.UnmarshalException解决办法

Facelets介绍,第一部分

最近访客更多访客>>