当然，你需要一个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>

<servlet-mapping>
    <servlet-name>Faces Servlet</servlet-name>
    <url-pattern>*.seam</url-pattern>
</servlet-mapping>

（你可以调整URL模式以适合你的需要。）

另外，Seam需要在你的 web.xml 文件中有以下项：

<listener>
    <listener-class>org.jboss.seam.servlet.SeamListener</listener-class>
</listener>

这个listener负责引导Seam，以及销毁会话和应用程序。

有些JSF实现在服务器端状态保持方面实现得很差，它们会与Seam的对话传播发生冲突。 如果你在表单提交时遇到了对话传播的问题，就尝试着切换到客户端状态保持。在你的 web.xml 中需要有这些：

<context-param>
    <param-name>javax.faces.STATE_SAVING_METHOD</param-name>
    <param-value>client</param-value>
</context-param>

如果你愿意听从我们的建议，使用Facelets代替JSP，就需要在 faces-config.xml 中增加以下几行：

<application>
    <view-handler>com.sun.facelets.FaceletViewHandler</view-handler>
</application>

并将以下几行加到 web.xml 中：

<context-param>
    <param-name>javax.faces.DEFAULT_SUFFIX</param-name>
    <param-value>.xhtml</param-value>
</context-param>

Seam Resource Servlet提供资源，这些资源被Seam Remoting、captchas（请参考“安全”章节）和一些JSF UI控件所使用。 配置Seam Resource Servlet时，需要在 web.xml 中有以下项：

<servlet>
  <servlet-name>Seam Resource Servlet</servlet-name>
  <servlet-class>org.jboss.seam.servlet.SeamResourceServlet</servlet-class>
</servlet>

<servlet-mapping>
  <servlet-name>Seam Resource Servlet</servlet-name>
  <url-pattern>/seam/resource/*</url-pattern>
</servlet-mapping>

Seam的基本操作不需要任何Servlet过滤器。可是，有些功能依赖于过滤器的使用。 为了让一切对你来说更容易，Seam让你可以增加和配置Servlet过滤器，就像你配置其他内建Seam组件一样。 为了利用这个特性，我们必须首先在 web.xml 中装载一个主过滤器：

<filter>
    <filter-name>Seam Filter</filter-name>
    <filter-class>org.jboss.seam.servlet.SeamFilter</filter-class>
</filter>

<filter-mapping>
    <filter-name>Seam Filter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

Seam主过滤器 必须 是在 web.xml 中指定的第一个过滤器。这样就能保证它首先运行。

为了取消内建的过滤器，你可以在一个特定的过滤器中设置 disabled="true"

增加主过滤器使得以下内建过滤器可用。

<components xmlns="http://jboss.com/products/seam/components"
            xmlns:web="http://jboss.com/products/seam/web">

    <web:exception-filter url-pattern="*.seam"/>

</components>

<web:redirect-filter url-pattern="*.seam"/>

<web:multipart-filter create-temp-files="true"
                      max-request-size="1000000"
                      url-pattern="*.seam"/>

<web:character-encoding-filter encoding="UTF-16"
                               override-client="true"
                               url-pattern="*.seam"/>

<web:ajax4jsf-filter force-parser="true"
                     enable-cache="true"
                     log4j-init-file="custom-log4j.xml"
                     url-pattern="*.seam"/>

<components xmlns="http://jboss.com/products/seam/components"
            xmlns:web="http://jboss.com/products/seam/web">
    <web:logging-filter url-pattern="*.seam"/>
</components>

<web:context-filter url-pattern="/media/*"/>

@Startup
@Scope(APPLICATION)
@Name("org.jboss.seam.web.multipartFilter")
@BypassInterceptors
@Filter(within="org.jboss.seam.web.ajax4jsfFilter")
public class MultipartFilter extends AbstractFilter {

我们需要将 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 中列出所有的组件，就像其他某些竞争框架所做的那样！我想你会喜欢更喜欢我们这种方式。

一旦你将所有这些东西都打包到一个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容器中部署。

我真的希望这就是配置专题所要说的全部内容，可惜的是，我们只涉及到了它的三分之一。 如果你实在无法忍受所有这些关于配置的废话，尽管放心地跳过本节剩下的部分，以后再回来这里。

如果你装载了一个内建的组件，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将会从你的 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），我们需要多做一些工作。

为了让Seam应用程序在Tomcat上正确运行，必须将嵌入式JBoss装载到Tomcat中。 嵌入式的JBoss可以在 这里 下载。将嵌入式的JBoss安装到Tomcat 6的过程非常简单。首先，你必须将嵌入式JBoss的JAR和配置文件都拷贝到Tomcat中。

接下来，需要更新两个配置文件，用来增加嵌入式JBoss特有的功能。

关于更多的配置选项，请参考Tomcat集成嵌入式JBoss Wiki条目。

一个在Servlet引擎（如Tomcat）中基于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
            jsf-api.jar
            jsf-impl.jar
            ...
            my-application.jar/
                META-INF/
                    MANIFEST.MF
                    persistence.xml
                seam.properties
                org/
                    jboss/
                        myapplication/
                            User.class
                            Login.class
                            LoginBean.class
                            Register.class
                            RegisterBean.class
                            ...
    login.jsp
    register.jsp
    ...

绝大部分Seam示例程序可以通过运行 ant deploy.tomcat 部署到Tomcat中。

对于jBPM配置和流程／页面流定义文件，还没有任何明确的打包格式。 在Seam的示例程序中，我们决定简单地将所有这些文件打包到EAR的根目录下。在以后，我们可能设计其他一些标准的打包格式。 因此EAR看起来有点像这样：

my-application.ear/
    jboss-seam.jar
    lib/
       jboss-el.jar
       jbpm-3.1.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
                    ...
    jbpm.cfg.xml
    hibernate.cfg.xml
    createDocument.jpdl.xml
    editDocument.jpdl.xml
    approveDocument.jpdl.xml
    documentLifecycle.jpdl.xml