Seam 的一些必备知识
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">
<!-- Use Documents Saved as *.xhtml -->
<context-param>
<param-name>javax.faces.DEFAULT_SUFFIX</param-name>
<param-value>.xhtml</param-value>
</context-param>
<!-- Special Debug Output for Development -->
<context-param>
<param-name>facelets.DEVELOPMENT</param-name>
<param-value>true</param-value>
</context-param>
<!-- Optional JSF-RI Parameters to Help Debug -->
<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>
<!-- Faces Servlet -->
<servlet>
<servlet-name>Faces Servlet</servlet-name>
<servlet-class>javax.faces.webapp.FacesServlet</servlet-class>
<load-on-startup>1</load-on-startup>
</servlet>
<!-- Faces Servlet Mapping -->
<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>
<!-- our NumberBean we just created -->
<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>
<!-- going from guess.xhtml to response.xhtml -->
<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>
<!-- going from response.xhtml to guess.xhtml -->
<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">
<!--
body {
font-family: Verdana, Arial, Helvetica, sans-serif;
font-size: small;
}
-->
</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文件的内容
<!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"
xmlns:h="http://java.sun.com/jsf/html">
<body>
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文件内容：
<!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"
xmlns:h="http://java.sun.com/jsf/html">
<body>
<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中的标签内容：
<form jsfc="h:form">
<input jsfc="h:commandButton" type="submit" id="back" value="Back" action="success"/>
</form>
上述代码在执行的时候会被翻译为如下的代码：
<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>