首先使用JBossTools工具生成项目，在生成项目的向导中，如果项目类型选择ear，则会生成四个项目，分别对应war、ear、ejb、test，觉得这样太过繁琐，还是选择war类型，又想要不使用tomcat作为运行服务器吧，因为JBoss也不太熟悉。没想到这一试倒试出问题来了，如果完全使用向导生成项目，选择tomcat作为运行服务器，则项目根本无法运行起来，总是提示缺少这个jar，那个jar。好，又换回JBoss，没问题了。仔细看了一下，原来在自动生成项目的WebContent/WEB-INF/lib目录中，只有大概十几个jar，连Hibernate的jar都没有，而在JBoss的Server/default/lib目录下则什么jar都有，怪不得不出错。

第一个教训：还是先使用JBoss作为运行环境，等整个Seam都搞熟了，再配一个Tomcat的运行环境。

    继续，将原来项目中的一个通用DAO和一个UserService拷贝过来，代码如下，启动服务器报错。分别为如下错误信息：

第二个错误解决：Caused by: java.lang.IllegalArgumentException: @PersistenceContext may only be used on session bean or message driven bean components: genericDao

    既然提示@PersistenceContext只能用在SessionBean中，因为原来的代码是使用的Spring框架，想了好长时间，在WebContent/WEB-INF/component.xml中看到这么一段，那么是不是通过@In来注入entityManager呢，修改@PersistenceContext为@In，编辑器自动提示没有发现名称为em的Component（这点好像不错），于是再修改为@In("entityManager") ，重启服务器，该问题解决。

第三个错误解决：Caused by org.jboss.seam.RequiredException with message: "@In attribute requires non-null value: userService.genericDao"

    将UserService中的@In修改为@In(create = true, required = true)解决此问题。

    解决上述几个问题后，自己的例子终于运行起来了 :-)

    下一篇关于Seam In Action中对JSF的介绍及Seam如何增强JSF。

-------------------------------------------------------------------------------------------------

    项目生成的代码被分为两个目录，分别为Action和Model目录，检查JBoss中项目部署的目录，发觉Action目录下的代码编译生成的class文件被存放至WEB-INF/dev目录下，Model目录下的代码编译生成的class文件被存放至WEB-INF/classes目录下，google了一下，发现在Seam Reference中提到这是Seam的增量式重部署，支持对JavaBean组件的增量重部署，可以加快编辑/编译/测试的速度。

代码如下：

public interface GenericDao {
    public Object get(Class clazz, Serializable id);
    public void save(Object object);
    public void update(Object object);
    public void remove(Class clazz, Serializable id);
    public void remove(Object obj);
   
}

@Name("genericDao")
public class GenericDaoImpl implements GenericDao {
    @PersistenceContext  ---->   @In("entityManager")
    private EntityManager em;

    public Object get(Class clazz, Serializable id) {
        if (id == null)  return null;
        else return em.find(clazz, id);
    }
   
}

public interface UserService {
    public void findAllUsers();
}

@Name("userService")
public class UserServiceImpl implements UserService, SecurityUserService {

    @In ----> @In(create = true, required = true)
    protected GenericDao genericDao;
    private List<User> resultList = null;

    public List<User> getResultList() {
        if (resultList == null) {
            this.findAllUsers();
        }
        return resultList;
    }

    public void setResultList(List<User> resultList) {
        this.resultList = resultList;
    }

    public void findAllUsers() {
        String hql = "from User order by userCode";
        resultList = this.genericDao.query(hql);
    }
}

// 实体类
@Entity
@Table(name = "USER")
public class User implements IUser, Serializable {
    // 用户编码
    @Id
    private String userCode;

    // 用户姓名
    private String userName;
}

通过这个实践，小结一下：

1、发觉Seam确实简化了JSF开发，但由于它涉及的新东西相对较多，与传统的SSH走的路线不太一致，还是觉得其学习曲线比较陡峭，需要对Seam熟练掌握后（包括开发环境的搭建等）才能真正提高开发效率。

2、Seam提供了IOC的功能，有时需要跳出Spring，从一个新的角度去审视Seam。

1、生成Sem web项目

2、输入项目的相关信息，如下图：

      注意，如果是第一次使用Eclipse，需要配置Target Runtime和Target Server。

3、然后一路next，到最后一步时，如果是第一次使用，也要注意配置Seam Runtime和Connection Profile，如下图。最后点击finish按钮，即可创建Seam项目。

4、生成项目后，在Eclipse中共出现了四个项目，如下：

• seamfirst （web项目）
• seamfirst-ear （ear项目，集成web和ejb）
• seamfirst-jar （ejb项目）
• seamfirst-test （测试项目，进行单元测试）

      此时运行JBossServer服务器，访问http://localhost:8080/seamfirst链接，出现如下图页面，此时Seam帮我们生成了一个框架，包含了基本的登录和退出功能，还有一个首页。

5、继续！使用Seam生成单表的CRUD操作。本步骤前提，有一个mysql数据库，数据库中有一个Customer表，该表有ID（int类型）、customername（varchar2类型）、customerdesc（varchar2类型）、createdate（date类型）、email（varchar2类型）五个字段。在seamfirst项目上点击右键，选择Seam Generate Entities菜单，弹出界面如下图：

      单击finish按钮后，再运行JBoss Server服务器，访问http://localhost:8080/seamfirst，发觉菜单栏上多了一个Customer List菜单，单击此链接，即可进行Customer的添加、删除、修改、查询操作，虽然生成的界面不是很好看，也不是很符合我自己的操作习惯，但是功能倒是完备。

      以后若是修改了Seam提供的代码自动生成的模板，然后再使用该功能，想必生成的页面就符合自己的项目要求了，记下一笔，先不管它。

生成的代码分析：

生成的代码主要有两部分，一部分为Java代码，一部分为页面代码。

Java代码包括如下三个类：

• Customer.java ---- 实体类，映射到数据库中的Customer表。
• CustomerHome.java ---- SessionBean，提供了Customer类的创建、更新、删除功能。继承了org.jboss.seam.framework.EntityHome类，EntityHome类中提供创建、更新、删除等基本功能。
• CustomerList.java ---- SessionBean，提供了Customer类的查询功能。继承了org.jboss.seam.framework.EntityQuery类，EntityQuery类中提供了查询功能。

      CustomerHome和CustomerList类中都使用了@Name annotation，这样在页面中就可以直接访问Session Bean中的方法了，达到了Seam将表现层和业务层直接融合的目标。

页面代码包括如下文件：

• Customer.xhtml
• Customer.page.xml
• CustomerEdit.xhtml
• CustomerEdit.page.xml
• CustomerList.xhtml
• CustomerList.page.xml

      刚开始看这段代码时，困惑我的有两个地方

• 一个是CustomerList.xhtml中rich:dataTable的value为"#{customerList.resultList}"，customerList我明白指的是CustomerList SessionBean，但是我看遍了其代码，也没有发现有resultList属性，后来仔细一看，才发觉该属性在其父类EntityQuery中。
• 另一个是每一个xhtml文件都有一个对应的page.xml文件，想了半天也没整明白这是怎么回事，后来只好继续看Seam in Action的第三章，看着看着终于明白了，原来这是Seam对JSF的一个扩展，增强了JSF的功能，具体含义后面详细解释。

至此第一个使用JBossTools生成的Seam例子完成了，好像很简单 :-)

Exception during request processing:

Caused by java.lang.IllegalStateException with message: "No phase id bound to current thread (make sure you do not have two SeamPhaseListener instances installed)"

org.jboss.seam.contexts.PageContext.getPhaseId(PageContext.java:163)
org.jboss.seam.contexts.PageContext.isBeforeInvokeApplicationPhase(PageContext.java:175)
org.jboss.seam.contexts.PageContext.getCurrentWritableMap(PageContext.java:91)
org.jboss.seam.contexts.PageContext.remove(PageContext.java:105)
org.jboss.seam.Component.newInstance(Component.java:2102)
org.jboss.seam.Component.getInstance(Component.java:1987)
org.jboss.seam.Component.getInstance(Component.java:1966)
org.jboss.seam.Component.getInstance(Component.java:1960)
org.jboss.seam.Component.getInstance(Component.java:1933)
org.jboss.seam.Component.getInstance(Component.java:1928)
org.jboss.seam.faces.FacesPage.instance(FacesPage.java:92)
org.jboss.seam.core.ConversationPropagation.restorePageContextConversationId(ConversationPropagation.java:84)
org.jboss.seam.core.ConversationPropagation.restoreConversationId(ConversationPropagation.java:57)
org.jboss.seam.jsf.SeamPhaseListener.afterRestoreView(SeamPhaseListener.java:389)
org.jboss.seam.jsf.SeamPhaseListener.afterServletPhase(SeamPhaseListener.java:228)
org.jboss.seam.jsf.SeamPhaseListener.afterPhase(SeamPhaseListener.java:194)
com.sun.faces.lifecycle.Phase.handleAfterPhase(Phase.java:175)
com.sun.faces.lifecycle.Phase.doPhase(Phase.java:114)
com.sun.faces.lifecycle.RestoreViewPhase.doPhase(RestoreViewPhase.java:104)
com.sun.faces.lifecycle.LifecycleImpl.execute(LifecycleImpl.java:118)
javax.faces.webapp.FacesServlet.service(FacesServlet.java:265)
org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:290)
org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:206)
org.jboss.seam.servlet.SeamFilter$FilterChainImpl.doFilter(SeamFilter.java:83)
org.jboss.seam.web.IdentityFilter.doFilter(IdentityFilter.java:38)
org.jboss.seam.servlet.SeamFilter$FilterChainImpl.doFilter(SeamFilter.java:69)
org.jboss.seam.web.MultipartFilter.doFilter(MultipartFilter.java:90)
org.jboss.seam.servlet.SeamFilter$FilterChainImpl.doFilter(SeamFilter.java:69)
org.jboss.seam.web.ExceptionFilter.doFilter(ExceptionFilter.java:64)
org.jboss.seam.servlet.SeamFilter$FilterChainImpl.doFilter(SeamFilter.java:69)
org.jboss.seam.web.RedirectFilter.doFilter(RedirectFilter.java:45)
org.jboss.seam.servlet.SeamFilter$FilterChainImpl.doFilter(SeamFilter.java:69)
org.ajax4jsf.webapp.BaseXMLFilter.doXmlFilter(BaseXMLFilter.java:177)
org.ajax4jsf.webapp.BaseFilter.handleRequest(BaseFilter.java:267)
org.ajax4jsf.webapp.BaseFilter.processUploadsAndHandleRequest(BaseFilter.java:380)
org.ajax4jsf.webapp.BaseFilter.doFilter(BaseFilter.java:507)
org.jboss.seam.web.Ajax4jsfFilter.doFilter(Ajax4jsfFilter.java:56)
org.jboss.seam.servlet.SeamFilter$FilterChainImpl.doFilter(SeamFilter.java:69)
org.jboss.seam.web.LoggingFilter.doFilter(LoggingFilter.java:58)
org.jboss.seam.servlet.SeamFilter$FilterChainImpl.doFilter(SeamFilter.java:69)
org.jboss.seam.debug.hot.HotDeployFilter.doFilter(HotDeployFilter.java:54)
org.jboss.seam.servlet.SeamFilter$FilterChainImpl.doFilter(SeamFilter.java:69)
org.jboss.seam.servlet.SeamFilter.doFilter(SeamFilter.java:158)
org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:235)
org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:206)
org.jboss.web.tomcat.filters.ReplyHeaderFilter.doFilter(ReplyHeaderFilter.java:96)
org.apache.catalina.core.ApplicationFilterChain.internalDoFilter(ApplicationFilterChain.java:235)
org.apache.catalina.core.ApplicationFilterChain.doFilter(ApplicationFilterChain.java:206)
org.apache.catalina.core.StandardWrapperValve.invoke(StandardWrapperValve.java:230)
org.apache.catalina.core.StandardContextValve.invoke(StandardContextValve.java:175)
org.jboss.web.tomcat.security.SecurityAssociationValve.invoke(SecurityAssociationValve.java:182)
org.apache.catalina.authenticator.AuthenticatorBase.invoke(AuthenticatorBase.java:432)
org.jboss.web.tomcat.security.JaccContextValve.invoke(JaccContextValve.java:84)
org.apache.catalina.core.StandardHostValve.invoke(StandardHostValve.java:127)
org.apache.catalina.valves.ErrorReportValve.invoke(ErrorReportValve.java:102)
org.jboss.web.tomcat.service.jca.CachedConnectionValve.invoke(CachedConnectionValve.java:157)
org.apache.catalina.core.StandardEngineValve.invoke(StandardEngineValve.java:109)
org.apache.catalina.connector.CoyoteAdapter.service(CoyoteAdapter.java:262)
org.apache.coyote.http11.Http11Processor.process(Http11Processor.java:844)
org.apache.coyote.http11.Http11Protocol$Http11ConnectionHandler.process(Http11Protocol.java:583)
org.apache.tomcat.util.net.JIoEndpoint$Worker.run(JIoEndpoint.java:446)
java.lang.Thread.run(Thread.java:619)

Google了一下，有人讲是JBoss4.2.3GA版本的BUG，赶紧下载了JBoss4.2.2GA，再测试一切正常！

不知还会不会有其它莫名的BUG了......

• the registration example
• the messages example
• the todo list example
• the numberguess example

        又在满江红的网站上找了seam_reference2.0的中文文档，主要看了《the contextual component model》一章，看完以后感觉Seam最核心的地方就是其contextual component model了，不过看完这一章以后只是对Seam有个大概的了解，对其具体的内容，细节还缺乏进一步的了解，对其优点、缺点也缺乏进一步的认识。

        然后又找到了《Seam in Action》的电子书，看了一点之后还是觉得这本电子书写得好，内容组织的很好，不象seam_reference后面的章节仅仅是罗列seam的各项功能。

        今天把Seam in Action的第一章草草看了一遍，将第一章讲述的内容总结如下：

1、什么是Seam

        在Seam in Action中，没有将Seam称之为web framework，而是将其称为application stack。Seam将Java EE中的EJB3、JSF、JPA/Hibernate、JAAS等技术融合在一起，提供了更容易使用的方式，比如conversation、page flows、buisness precesses、rule-based security、JavaScript(Ajax) remoting、PDF rendering、email组合、charting、file uploads、Groovy integration等，用以简化web开发。

2、Seam的目标

        简化web开发

3、Seam如何集成各类技术

     Seam集成了JSF、JPA和POJO Component

在Seam中将EJB3.0中的Session Bean作为JSF的managed bean，直接将表现层和业务层衔接在一起，使得Session Bean可以直接访问web相关数据，比如request、session、application、JSF的FacesMessage、Component Tree等。而在不使用Seam时，一般都是使用JSF back bean来作为表现层和业务层之间的中介。

使用annotation中的@Name标注替代了JSF的faces-config.xml中关于managed bean的配置。

Seam不一定必须使用EJB和JPA，也可以使用POJO、Hibernate作为替代。如下图：

     上下文相关的组件模型（Seam中的核心概念）

Seam提供了7种类型的上下文，其中属于Seam特有的两种上下文类型分别为：Conversation Context、Business process Context。

Seam提供了统一的组件注册、annotation、异常配置、方法拦截、统一的EL表达式等功能。其中Seam对其管理的组件拦截过程如下图：

4、Seam的核心竞争力

    更好的JSF

增强的JSF

• Seam对JSF最被认可的改进就是消除了在配置文件中声明managed bean。
• Prerender page actions
• Managed request parameters (for a given page)
• Intelligent stateless and stateful navigation
• Transparent JSF data model and data model selection handling
• Fine-grained exception handling
• Page-level security (per view ID)
• 基于Annotation的表单验证
• Bookmarkable command links (solving the “everything is a POST” problem)
• Entity converter for pick lists
• Conversation controls
• Support for preventing lazy initialization exceptions and nontransactional data access in the view

消除了连接Bean（ELIMINATING CONNECTOR BEANS）

      用一幅图可以很好的说明这句话的含义

引入了有状态的变量范围（INTRODUCING STATEFUL VARIABLE SCOPES）

扩展的Persistence Context

      Spring中提供了The Session In View Filter，使得persistence manage可以在一个请求中存在，避免了常见的LazyInitializationException。在Seam中，扩展的Persistence Context可以跨越多个请求。其实扩展的Persistence Context是Conversation Context、Business Process Context的基础。

    get rich quick

        Seam提供了两种方式将Ajax集成到Seam应用中，一种是使用具有Ajax特性的JSF组件，如RichFaces和ICEFaces，另一种是可以在浏览器中使用JavaScript直接调用服务端的组件。

        Seam还提供了另外一种意义上的Rich，即将PDF、mail等功能集成到Seam应用中。

    提供了一个快速开发环境

代码自动生成

热部署

Seam调试页面

不部署即可以进行单元测试

从目前我个人的理解来看，Seam的作用与能力如下：

• Seam将EJB3与JSF整合在一起，消除了JSF与业务代码之间的间隙，直接将表现层与业务层衔接在一起
• Seam提出了Conversation Context的概念，将Stateful EJB引入到web开发中，直接与Conversation Context对应
• Seam提供了与Jbpm、itext、mail等一系列开源框架的整合，对于需要使用的相关功能的用户来说，提供了便利性
• 提供了开发工具的整合（Seam Gen与IDE），还可以自动生成部分代码

        但由于Seam整合了如此多的框架，带来的一个最大的缺点：学习曲线陡峭，在SSH非常流行的今天，需要面对很多新技术（JSF、EJB3、JPA等），对于一个新手来说难度比较大，如果想使Seam被更多的开发人员使用，必须加强它的文档，目前的文档还是太少了。

学习JBossSeam之前最好对相关技术有一定的了解，比如：

• JSF
• EJB3.0
• JPA

然后下载相关的软件，如下：

• jboss-seam-2.1.1.CR1
• jboss-4.2.3.GA
• JBossTools-3.0.0.Beta1-R200810311334-ALL-win32（开发环境）
• eclipse-jee-ganymede-SR1-win32（开发环境）
• apache-ant-1.7.0
• jdk1.6.0_06

环境的配置都比较简单，基本都是解压即可，有如下注意事项：

• 在系统的环境变量中设置JAVA_HOME、ANT_HOME
• JBossTools解压后需拷贝至eclipse解压后的目录中。
• jboss-seam-2.1.1.CR1解压后，需设置其bulid目录下的default.build.properties文件中的jboss.home为JBOSS_HOME（假定为jboss-4.2.3GA的安装目录）。

上述配置好后，启动JBoss Server，然后至SEAM_HOME（假定为Seam的安装目录）/examples/registration目录下，运行ant explode命令，即可编译部署registration应用至JBoss Server中，最后访问：http://localhost:8080/seam-registration 即可体验Seam提供的第一个example程序 :-)

http://www.javaworld.com.tw/roller/ingramchen/entry/2005_9_20_JBossSeamKingofStateful_