Seam配置和Seam应用程序打包之二

将Seam与你的EJB容器集成
我们需要将 SeamInterceptor 用于我们的Seam组件。 在整个程序中完成这个的最简单方式是在 ejb-jar.xml 中增加以下拦截器配置：

<interceptors>
    <interceptor>
        <interceptor-class>org.jboss.seam.ejb.SeamInterceptor</interceptor-class>
    </interceptor>
</interceptors>

<assembly-descriptor>
    <interceptor-binding>
        <ejb-name>*</ejb-name>
        <interceptor-class>org.jboss.seam.ejb.SeamInterceptor</interceptor-class>
    </interceptor-binding>
</assembly-descriptor>

Seam需要知道在JNDI中到哪里去寻找会话Bean。其中一种方法是在每个会话Bean Seam组件中指定 @JndiName注解。 然而，这样相当乏味。更好的一种方式是指定一种模式，Seam可以根据这个模式从EJB名称里推算出JNDI的名称。 不幸的是，在EJB3规范里面，没有定义到全局JNDI的标准映射，所以这个映射是特定于供应商的。 我们通常在 components.xml 中指定这个选项。

对于JBoss AS，以下的模式是正确的：

<core:init jndi-name="myEarName/#{ejbName}/local" />
myEarName就是部署Bean所在EAR的名称。

在一个EAR的外面（当使用嵌入式的JBoss的EJB3容器时），以下模式就是要用到的那个：

<core:init jndi-name="#{ejbName}/local" />
你不得不尝试着去找到其他应用程序服务器的正确配置。 注意有些服务器（比如GlassFish）要求你为所有EJB组件直接（而且很乏味地）指定JNDI名称。 在这种情况下，你可以选择你自己的模式。:-)

在一个EJB3的环境中，我们建议给事务管理使用一个特殊的内建组件，它完全知道容器事务，并且可以正确地处理用 Events 组件注册的事务成功事件。 如果你没有在你的 components.xml 文件中增加这几行，Seam就不会知道容器管理的事务什么时候结束:

<transaction:ejb-transaction/>
切记！
还有最后一点你要知道的。你必须在部署你的Seam组件的每个压缩文档中（即使空的属性文件也要这样），放置一个 seam.properties、META-INF/seam.properties 或META-INF/components.xml文件。 在启动时，Seam将会根据 seam.properties 文件扫描所有压缩档案寻找Seam组件。

在一个Web压缩档案（WAR）文件中，如果在 WEB-INF/classes 目录下，包含有任何Seam组件，你必须在该目录中放置一个 seam.properties文件。

这就是为什么所有的Seam示例程序都有一个空的 seam.properties 文件的原因。 你不能删掉这些文件，还期待一切仍然正常运行！

你可能会觉得这很愚蠢，并且框架的设计者做一个空文件来影响他们的软件该是多么的白痴啊？ 当然，这是针对Java虚拟机的限制所采取的一种权宜之计 — 如果我们不使用这个机制，那么我们的下一个最佳选项将逼迫你显式地在 components.xml 中列出所有的组件，就像其他某些竞争框架所做的那样！我想你会喜欢更喜欢我们这种方式。

在Java EE 5中配置Seam

如果你是在Java EE 5的环境下运行，这就是开始使用Seam所需的全部配置！

打包
一旦你将所有这些东西都打包到一个EAR文件中，该压缩文档看起来就会像这样：

my-application.ear/
    jboss-seam.jar
    lib/
        jboss-el.jar
    META-INF/
        MANIFEST.MF
        application.xml
    my-application.war/
        META-INF/
            MANIFEST.MF
        WEB-INF/
            web.xml
            components.xml
            faces-config.xml
            lib/
                jsf-facelets.jar
                jboss-seam-ui.jar
        login.jsp
        register.jsp
        ...
    my-application.jar/
        META-INF/
            MANIFEST.MF
            persistence.xml
        seam.properties
        org/
            jboss/
                myapplication/
                    User.class
                    Login.class
                    LoginBean.class
                    Register.class
                    RegisterBean.class
                    ...
你要在 META-INF/application.xml 中将 jboss-seam.jar 声明为一个EJB模块。 jboss-el.jar 应该被放置在EAR的lib目录下（将它放在EAR的classpath中）。

如果你想使用jBPM或Drools，你必须在EAR的lib目录下包含所需要的jar文件。

如果你想使用Facelets（我们建议使用），你必须在WAR的 WEB-INF/lib 目录下包含 jsf-facelets.jar

如果你想使用Seam标签库（大多数Seam应用程序都这么做），你就必须在WAR的 WEB-INF/lib 目录下包含 jboss-seam-ui.jar。 如果你想用PDF或者Email标签库，则需要在 WEB-INF/lib 目录下放置 jboss-seam-pdf.jar 或 jboss-seam-mail.jar。

如果你想要使用Seam调试页面（只在使用Facelets的应用程序中有效），你必须在WAR的 WEB-INF/lib 目录下包含jboss-seam-debug.jar

Seam发行时包括几个示例程序，他们能在任何支持EJB 3.0的Java EE容器中部署。

在J2EE中配置Seam
Seam很有用，即使你还没有冒险尝试EJB 3.0。在这种情况下，你可以使用Hibernate3或者JPA代替EJB 3.0持久化技术，并用简单的JavaBeans代替会话Bean。 你可能会错过会话bean的某些很好的特性，但是当你准备好时，这将会很容易迁移到EJB 3.0，同时，你将能利用Seam独特的声明式状态管理架构。


Seam JavaBean组件不会像会话Bean那样提供声明式事务划分。你 可以 使用 JTA UserTransaction 手动管理你的事务，或者使用Seam的 @Transactional 标注声明。 但是当与JavaBean一起使用Hibernate时，大部分应用程序只会用到由Seam管理的事务。

Seam发行包里包括预订示例程序的一种使用Hibernate3和JavaBeans而不是EJB3的版本，以及另一种使用JPA和JavaBeans的版本。 这些示例程序可以随时部署到任何J2EE应用程序服务器中。

在Seam中引导Hibernate
如果你装载了一个内建的组件，Seam将会从你的 hibernate.cfg.xml 文件中引导一个 Hibernate SessionFactory：

<persistence:hibernate-session-factory name="hibernateSessionFactory"/>
如果你想要通过注入得到一个由Seam管理的Hibernate Session，还需要配置一个 managed session。

<persistence:managed-hibernate-session name="hibernateSessionFactory"
                            session-factory="#{hibernateSessionFactory}"/>
在Seam中引导JPA
如果你装载了一个内建的组件，Seam将会从你的 persistence.xml 文件中引导一个 JPA EntityManagerFactory：

<persistence:entity-manager-factory name="entityManagerFactory"/>
如果你想要通过注入得到一个由Seam管理的JPA EntityManager，还需要配置一个 managed persistence context。

<persistence:managed-persistence-context name="entityManager"
                            entity-manager-factory="#{entityManagerFactory}"/>
打包
我们可以将我们的应用程序按照以下结构打包成一个WAR文件：

my-application.war/
    META-INF/
        MANIFEST.MF
    WEB-INF/
        web.xml
        components.xml
        faces-config.xml
        lib/
            jboss-seam.jar
            jboss-seam-ui.jar
            jboss-el.jar
            jsf-facelets.jar
            hibernate3.jar
            hibernate-annotations.jar
            hibernate-validator.jar
            ...
            my-application.jar/
                META-INF/
                   MANIFEST.MF
                seam.properties
                hibernate.cfg.xml
                org/
                    jboss/
                        myapplication/
                            User.class
                            Login.class
                            Register.class
                            ...
    login.jsp
    register.jsp
    ...
如果我们想要将Hibernate部署在一个非EE的环境中（如Tomcat或TestNG），我们需要多做一些工作。