Seam 的一些必备知识

Seam框架本身基于JSF和EJB3.0，所以JSF和EJB3是必须要了解的内容，为了更好的使用JSF还需要了解Facelets（JSF和JSP相关）。

JSF的教程可以参考Sang Shin（[email protected]）的J2EE的教程

http://www.javapassion.com/j2ee/

EJB3 和 JPA 还可以参考这个教程：

http://www.javapassion.com/j2ee/

上面两个教程唯一的缺点是：是英文写的；但是也是优点，很原汁原味，不过过分偏重了Sun（个人观点）。

Facelets可以参考ibm上面的文章：《Facelets 非常和是 JSF》

http://www.ibm.com/developerworks/cn/java/j-facelets/

开发工具，我喜欢使用IDEA，部署和构建依赖Ant，现在还没有研究Maven怎么使用Seam。

但是最好Maven能支持Seam，做一个Seam Starter的Maven插件，像Struts2 的插件那样好用。

Facelets

Facelets配置

我们这里主要讲如何让使用Facelets功能的应用程序在JBoss-4.2.2GA中运行。

Facelets的版本为1.1.14

目录结构：

facelets-number-guess

│ guess.xhtml
│ index.jsp
│ response.xhtml
│ template.xhtml
│
└─WEB-INF
│ faces-config.xml
│ web.xml
│
├─classes
│ └─tutorial
│ NumberBean.class
│
└─lib
jsf-facelets.jar

lib库中的文件都是从C:/Seam/facelets-1.1.13/lib目录中拷贝而来的，这里需要注意一点，当如下文件：

el-api-1.0.jar
el-impl-1.0.jar
jsf-api-1.2_04-p02.jar
servlet-api-2.4.jar

在WEB-INF/lib目录下时在JBoss下无法正常运行，原因是JBoss已经提供了这些API的类库，一旦重复发现，JBoss无法加载这些类库而出错。

web.xml的内容为：

<?xml version="1.0" encoding="UTF-8"?>

<web-app xmlns="http://java.sun.com/xml/ns/javaee"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://java.sun.com/xml/ns/javaee

http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"

version="2.5">

<context-param>

<param-name>javax.faces.DEFAULT_SUFFIX</param-name>

<param-value>.xhtml</param-value>

</context-param>

<context-param>

<param-name>facelets.DEVELOPMENT</param-name>

<param-value>true</param-value>

</context-param>

<context-param>

<param-name>com.sun.faces.validateXml</param-name>

<param-value>true</param-value>

</context-param>

<context-param>

<param-name>com.sun.faces.verifyObjects</param-name>

<param-value>true</param-value>

</context-param>

<servlet>

<servlet-name>Faces Servlet</servlet-name>

<servlet-class>javax.faces.webapp.FacesServlet</servlet-class>

<load-on-startup>1</load-on-startup>

</servlet>

<servlet-mapping>

<servlet-name>Faces Servlet</servlet-name>

<url-pattern>*.jsf</url-pattern>

</servlet-mapping>

</web-app>

上述黑体部分的内容为facelets的配置，稍后说明用途。

faces-config.xml的内容为：

<?xml version='1.0' encoding='UTF-8'?>

<!DOCTYPE faces-config PUBLIC

"-//Sun Microsystems, Inc.//DTD JavaServer Faces Config 1.0//EN"

"http://java.sun.com/dtd/web-facesconfig_1_0.dtd">

<faces-config>

<application>

<view-handler>

com.sun.facelets.FaceletViewHandler

</view-handler>

</application>

<managed-bean>

<managed-bean-name>NumberBean</managed-bean-name>

<managed-bean-class>tutorial.NumberBean</managed-bean-class>

<managed-bean-scope>session</managed-bean-scope>

<managed-property>

<property-name>min</property-name>

<value>1</value>

</managed-property>

<managed-property>

<property-name>max</property-name>

<value>10</value>

</managed-property>

</managed-bean>

<navigation-rule>

<from-view-id>/guess.xhtml</from-view-id>

<navigation-case>

<from-outcome>success</from-outcome>

<to-view-id>/response.xhtml</to-view-id>

</navigation-case>

</navigation-rule>

<navigation-rule>

<from-view-id>/response.xhtml</from-view-id>

<navigation-case>

<from-outcome>success</from-outcome>

<to-view-id>/guess.xhtml</to-view-id>

</navigation-case>

</navigation-rule>

</faces-config>

上述黑体部分的内容为facelets的配置，上述两部分的配置内容结合在一起，可以得出如下结论：

单用户向服务器请求*.jsf的内容的时候，会被Facelets框架解释为对*.xhtml的处理，这是在这个解释的过程中完成了Facelets的功能。

Facelets的模板功能

Facelets的一个简单的功能是类似Tile的模板的功能，例如，我们有两个页面guess.xhtml和response.xhtml，我们需要使用共同的布局，那么我们可以设置一个共同的框架模板template.xhtml文件。

说明：xhtml文件为html文件的子集，必须满足xml的规范，是一个合式的xml文件

template.xhtml文件的内容为：

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"

"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml"

xmlns:ui="http://java.sun.com/jsf/facelets">

<head>

<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"/>

<title>Facelets: Number Guess Tutorial</title>

<style type="text/css">



</style>

</head>

<body>

<h1>

<ui:insert name="title">Default Title</ui:insert>

</h1>

<p>

<ui:insert name="body">Default Body</ui:insert>

</p>

</body>

</html>

其中内容的一些说明：

引入了facelets模板标签

定义了占位符，之后可以使用动态的内容替换。

guess.xhtml文件的内容

This text above will not be displayed.

<ui:composition template="/template.xhtml">

This text will not be displayed.

<ui:define name="title">

I'm thinking of a number from #{NumberBean.min} to #{NumberBean.max}. Can you guess it?

</ui:define>

This text will also not be displayed.

<ui:define name="body">

<h:form id="helloForm">

<h:inputText type="text" id="userNo" value="#{NumberBean.guess}" validator="#{NumberBean.validate}"/>

<br/>

<h:commandButton type="submit" id="submit" action="success" value="Submit"/>

<br/>

<h:message showSummary="true" showDetail="false" style="color: red; font-weight: bold;" id="errors1"

for="userNo"/>

</h:form>

</ui:define>

This text will not be displayed.

</ui:composition>

This text below will also not be displayed.

</body>

</html>

上述的内容相信大家会很容易理解，xmlns部分引入了Facelets标签合JSF的h类型的标签，<ui:define name="title"> ...部分和<ui:define name="body">...两部分定义了模板中的动态部分。

另外需要注意的是，黑体部分的内容不会作为输出。

response.xhtml文件内容：

<ui:composition template="/template.xhtml">

<ui:define name="title">
#{NumberBean.message}
</ui:define>

<ui:define name="body">
<form jsfc="h:form">
<input jsfc="h:commandButton" type="submit" id="back" value="Back" action="success"/>
</form>
</ui:define>

</ui:composition>

</body>
</html>

Facelets对模板的支持

Facelets可以使用HTML格式的标签处理JSF标签，这样可以方便设计人员的设计，例如可以使用Dreamwaver等工具设计，而在实行的时候按照JSF标签的方式自动的处理数据绑定和事件绑定。

例如上述response.xhtml中的标签内容：

上述代码在执行的时候会被翻译为如下的代码：

<h:from>

<h:commandButton type="submit" id="back" value="Back" action="success"/>

</h:from>

在上述的过程中jsfc属性起到了标志的作用。

另外使用facelets还支持部分的JSTL的标签，虽然并不全面，但是解决了JSF中标签欠缺的问题，Facelets支持的标签为：

<c:if/>
<c:forEach/>
<c:catch/>
<c:set/>

其中forEach标签解决了JSF中没有真正的循环标签的问题（dataTable不算是真正的循环标签）；

Facelets支持表达式语言（EL）

例如：

<span>Your Basket has ${basket.lineCount} Items</span>

转自：http://www.dojochina.com/?q=node/723

Seam 的一些必备知识

你可能感兴趣的:(seam)