Seam 的一些必备知识

Seam 的一些必备知识

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

JSF的教程可以参考Sang Shinsang.shin@sun.com)的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>

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值