Maven+portletBridge+seam+Gatein 之艰难的helloWord

本文记录了作者在使用Seam 2.2.1.Final与PortletBridge进行集成过程中遇到的问题及解决办法，包括解决jar包冲突、配置pom文件、web.xml设置等问题。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

在经历了艰难的版本选择后，我最终还是选了seam 2.2.1.Final 和其它与之配合的版本

然后用maven建立了一个空的portletbridge项目

mvn archetype:generate -DarchetypeCatalog=http://bit.ly/jbossportletbridge

一开始我建立的是seam的项目，但是建立的是一个ear项目，我想要的是war的，所以我又建立了一个war项目并参照seam的ear项目把seam加入进来，从这开始我就开始了艰难的过程

1.jar包冲突:

从我把我改好的项目部署到jboss开始就是一路的包冲突。。先是sax的一个xml解析器有冲突，再来是hibernate，后来还有，最后我才弄明白，原来jboss自已有很多jar包的，我再加就会引起冲突。就我现在所知，jboss已有hibernate,jsf等的jar包的，所以要在我的pom文件中使用exclusions 和 provided 去掉这些包，我最后的pom是这样的

<?xml version="1.0" encoding="UTF-8"?> <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>com.dgsoft</groupId> <artifactId>portals-cms</artifactId> <packaging>war</packaging> <version>1.0-SNAPSHOT</version> <name>JBoss Portlet Bridge - RichFaces Application</name> <url>http://www.mycompany.com</url> <properties> <jsf.version>1.2_13</jsf.version> <richfaces.version>3.3.3.Final</richfaces.version> <portletbridge.version>2.1.0.FINAL</portletbridge.version> <seam.version>2.2.1.Final</seam.version> </properties> <prerequisites> <maven>2.0.9</maven> </prerequisites> <licenses> <license> <name></name> <url></url> </license> </licenses> <scm> <connection></connection> <developerConnection></developerConnection> <url></url> </scm> <issueManagement> <system></system> <url></url> </issueManagement> <developers> <developer> <id></id> <name></name> <email></email> <timezone></timezone> </developer> </developers> <build> <defaultGoal>package</defaultGoal> <finalName>richfaces-basic</finalName> <plugins> <plugin> <artifactId>maven-compiler-plugin</artifactId> <version>2.0.2</version> <configuration> <source>1.5</source> <target>1.5</target> </configuration> </plugin> </plugins> </build> <repositories> <repository> <id>repository.jboss.org</id> <name>JBoss Public Maven Repository Group</name> <layout>default</layout> <url>https://repository.jboss.org/nexus/content/groups/public/</url> <releases> <enabled>true</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </repository> </repositories> <pluginRepositories> <pluginRepository> <id>codehaus.org</id> <name>CodeHaus Plugin Snapshots</name> <url>http://snapshots.repository.codehaus.org</url> <releases> <enabled>false</enabled> </releases> <snapshots> <enabled>true</enabled> </snapshots> </pluginRepository> </pluginRepositories> <dependencies> <dependency> <groupId>org.jboss.portletbridge</groupId> <artifactId>portletbridge-api</artifactId> <version>${portletbridge.version}</version> <exclusions> <exclusion> <artifactId>javax.faces</artifactId> <groupId>jsf-api</groupId> </exclusion> <exclusion> <artifactId>javax.faces</artifactId> <groupId>jsf-impl</groupId> </exclusion> </exclusions> </dependency> <dependency> <groupId>org.jboss.portletbridge</groupId> <artifactId>portletbridge-impl</artifactId> <version>${portletbridge.version}</version> <exclusions> <exclusion> <artifactId>javax.faces</artifactId> <groupId>jsf-api</groupId> </exclusion> <exclusion> <artifactId>javax.faces</artifactId> <groupId>jsf-impl</groupId> </exclusion> </exclusions> </dependency> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>3.8.1</version> <scope>test</scope> </dependency> <dependency> <groupId>javax.portlet</groupId> <artifactId>portlet-api</artifactId> <version>2.0</version> <scope>provided</scope> </dependency> <dependency> <groupId>javax.faces</groupId> <artifactId>jsf-api</artifactId> <version>${jsf.version}</version> <scope>provided</scope> </dependency> <dependency> <groupId>javax.faces</groupId> <artifactId>jsf-impl</artifactId> <version>${jsf.version}</version> <scope>provided</scope> </dependency> <dependency> <groupId>javax.el</groupId> <artifactId>el-api</artifactId> <version>1.0</version> <scope>provided</scope> </dependency> <dependency> <groupId>javax.servlet</groupId> <artifactId>servlet-api</artifactId> <version>2.5</version> <scope>provided</scope> </dependency> <dependency> <groupId>javax.servlet.jsp</groupId> <artifactId>jsp-api</artifactId> <version>2.1</version> <scope>provided</scope> </dependency> <dependency> <groupId>javax.servlet</groupId> <artifactId>jstl</artifactId> <version>1.2</version> </dependency> <dependency> <groupId>javax.annotation</groupId> <artifactId>jsr250-api</artifactId> <version>1.0</version> <scope>provided</scope> </dependency> <dependency> <groupId>javax.ejb</groupId> <artifactId>ejb-api</artifactId> <version>3.0</version> <scope>provided</scope> </dependency> <dependency> <groupId>javax.transaction</groupId> <artifactId>jta</artifactId> <version>1.0.1B</version> <scope>provided</scope> </dependency> <dependency> <groupId>javax.persistence</groupId> <artifactId>persistence-api</artifactId> <version>1.0</version> <scope>provided</scope> </dependency> <dependency> <groupId>com.sun.facelets</groupId> <artifactId>jsf-facelets</artifactId> <version>1.1.15.B1</version> </dependency> <dependency> <groupId>org.richfaces.framework</groupId> <artifactId>richfaces-impl</artifactId> <version>${richfaces.version}</version> </dependency> <dependency> <groupId>org.richfaces.framework</groupId> <artifactId>richfaces-api</artifactId> <version>${richfaces.version}</version> </dependency> <dependency> <groupId>org.richfaces.ui</groupId> <artifactId>richfaces-ui</artifactId> <version>${richfaces.version}</version> </dependency> <dependency> <groupId>org.jboss.seam</groupId> <artifactId>jboss-seam</artifactId> <version>${seam.version}</version> <type>ejb</type> </dependency> <dependency> <groupId>org.jboss.seam</groupId> <artifactId>jboss-seam</artifactId> <version>${seam.version}</version> <type>jar</type> </dependency> <dependency> <groupId>org.jboss.seam</groupId> <artifactId>jboss-seam-ui</artifactId> <version>${seam.version}</version> </dependency> <dependency> <groupId>org.jboss.seam</groupId> <artifactId>jboss-seam-ioc</artifactId> <version>${seam.version}</version> </dependency> <dependency> <groupId>org.jboss.seam</groupId> <artifactId>jboss-seam-debug</artifactId> <version>${seam.version}</version> </dependency> <dependency> <groupId>org.jboss.el</groupId> <artifactId>jboss-el</artifactId> <version>1.0_02.CR4</version> </dependency> <dependency> <groupId>org.hibernate</groupId> <artifactId>hibernate-commons-annotations</artifactId> <version>3.3.0.ga</version> <scope>provided</scope> </dependency> <dependency> <groupId>org.hibernate</groupId> <artifactId>hibernate-annotations</artifactId> <version>3.4.0.GA</version> <scope>provided</scope> <exclusions> <exclusion> <artifactId>xml-apis</artifactId> <groupId>xml-apis</groupId> </exclusion> </exclusions> </dependency> <dependency> <groupId>org.hibernate</groupId> <artifactId>hibernate-entitymanager</artifactId> <version>3.4.0.GA</version> <scope>provided</scope> </dependency> <dependency> <groupId>org.hibernate</groupId> <artifactId>hibernate-validator</artifactId> <version>3.1.0.GA</version> <scope>provided</scope> </dependency> <dependency> <groupId>org.hibernate</groupId> <artifactId>hibernate</artifactId> <version>3.2.6.ga</version> <scope>provided</scope> <exclusions> <exclusion> <artifactId>commons-collections</artifactId> <groupId>commons-collections</groupId> </exclusion> </exclusions> </dependency> <dependency> <groupId>commons-collections</groupId> <artifactId>commons-collections</artifactId> <version>3.2</version> </dependency> <dependency> <groupId>commons-lang</groupId> <artifactId>commons-lang</artifactId> <version>2.1</version> </dependency> <dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> <version>1.2.14</version> <scope>provided</scope> </dependency> </dependencies> <profiles> <profile> <id>jbossportal</id> <build> <plugins> <plugin> <artifactId>maven-war-plugin</artifactId> <configuration> <webResources> <resource> <filtering>false</filtering> <directory>${project.basedir}/src/main/jbossportal</directory> <targetPath>WEB-INF</targetPath> <includes> <include>jboss-*.xml</include> <include>portlet-instances.xml</include> <include>richfacesecho-object.xml</include> </includes> </resource> </webResources> </configuration> </plugin> </plugins> </build> </profile> </profiles> </project>

还有一个jar（javassist）包是ear项目中有的，但是和jpa的冲突见：http://topic.youkuaiyun.com/u/20100112/17/58beb62e-25c0-41a6-ad3b-7c90bf7e8c66.html

再还就是web.xml的配置问题了。。。这东东。要把这几样东东联接起来就是它了，我的web.xml：

<?xml version="1.0" encoding="UTF-8"?> <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd" version="2.5"> <description>RichFacesPortlet</description> <context-param> <param-name>org.ajax4jsf.VIEW_HANDLERS</param-name> <param-value>org.jboss.portletbridge.application.FaceletPortletViewHandler</param-value> </context-param> <context-param> <param-name>javax.portlet.faces.renderPolicy</param-name> <param-value>ALWAYS_DELEGATE</param-value> </context-param> <context-param> <param-name>org.ajax4jsf.RESOURCE_URI_PREFIX</param-name> <param-value>rfRes</param-value> </context-param> <context-param> <param-name>org.richfaces.LoadStyleStrategy</param-name> <param-value>DEFAULT</param-value> </context-param> <context-param> <param-name>org.richfaces.LoadScriptStrategy</param-name> <param-value>DEFAULT</param-value> </context-param> <context-param> <param-name>org.ajax4jsf.COMPRESS_SCRIPT</param-name> <param-value>false</param-value> </context-param> <context-param> <param-name>org.jboss.portletbridge.WRAP_SCRIPTS</param-name> <param-value>true</param-value> </context-param>       <context-param> <param-name>org.ajax4jsf.handleViewExpiredOnClient</param-name> <param-value>true</param-value> </context-param> <listener> <listener-class> org.jboss.seam.servlet.SeamListener </listener-class> </listener> <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> <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> <servlet-name>Faces Servlet</servlet-name> <dispatcher>FORWARD</dispatcher> <dispatcher>REQUEST</dispatcher> <dispatcher>INCLUDE</dispatcher> </filter-mapping> <context-param> <param-name>javax.faces.DEFAULT_SUFFIX</param-name> <param-value>.xhtml</param-value> </context-param> <context-param> <param-name>facelets.DEVELOPMENT</param-name> <param-value>false</param-value> </context-param> <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>/faces/*</url-pattern> </servlet-mapping> <servlet-mapping> <servlet-name>Faces Servlet</servlet-name> <url-pattern>*.seam</url-pattern> </servlet-mapping> <session-config> <session-timeout>10</session-timeout> </session-config>   <context-param> <param-name>org.ajax4jsf.SKIN</param-name> <param-value>renewal</param-value> </context-param> </web-app>

还有几个问题没弄明白：

1.seam的项目中不在有a4j的listener了，而加了一个seam的listener，是不是不再需要了（已查证，在seam的listener中已函此过滤器，只要a4j在你的classpath中）。

2. <context-param> <param-name>org.ajax4jsf.VIEW_HANDLERS</param-name> <param-value>org.jboss.portletbridge.application.FaceletPortletViewHandler</param-value> </context-param>

这个在ear的seam中也是没有的，是我后加的，不知道是不是可以不加。

3.portletbridge的异常处理设置：

<context-param> <param-name>org.jboss.portletbridge.ExceptionHandler</param-name> <param-value> org.jboss.portletbridge.SeamExceptionHandlerImpl </param-value> </context-param>

这个配置的本意是要让portla也就是gatein来处理和显示portlet的异常，但是我这加上这个后出现问题：在项目出现异常时出现以下错误