如何添加RichFaces 3.3.x到Maven项目

首先参考这篇文章配置Maven去使用Jboss仓库

如果你正在使用旧版本(3.2.x, 3.1.x)，你需要意识到一些功能不能使用（皮肤、主题、验证）
基本依赖 (3.3.2.SR1 或之前的版本)

<dependency>
      <groupId>org.richfaces.ui</groupId>
      <artifactId>richfaces-ui</artifactId>
      <version>${richfaces.version}</version>
</dependency>

${richfaces.version} - 你的应用使用的实际Richfaces版本。

只需要添加richfaces-ui到依赖列表，api库和实现库会以传递依赖(transitive dependencies)的方式被添加. 各个 commons 库 - collections, beanutils, digester 和 logging 也会自动添加。

基本依赖 (3.3.3或之后的版本)
JSF1.2

    <dependency>
      <groupId>org.richfaces.framework</groupId>
      <artifactId>richfaces-impl</artifactId>
      <version>3.3.3.BETA1</version>
    </dependency>

JSF2

    <dependency>
      <groupId>org.richfaces.framework</groupId>
      <artifactId>richfaces-impl-jsf2</artifactId>
      <version>3.3.3.BETA1</version>
    </dependency>

主题和皮肤：
要添加Richfaces提供的皮肤，你在基本依赖之后添加以下配置：

 <dependency>
      <groupId>org.richfaces.samples</groupId>
      <artifactId>laguna</artifactId>
      <version>${richfaces.version}</version>
    </dependency>
    <dependency>
      <groupId>org.richfaces.samples</groupId>
      <artifactId>glassX</artifactId>
      <version>${richfaces.version}</version>
    </dependency>
    <dependency>
      <groupId>org.richfaces.samples</groupId>
      <artifactId>darkX</artifactId>
      <version>${richfaces.version}</version>
    </dependency>

注意: 皮肤(skins)是richfaces-impl的传递依赖项。 3.3.3版本默认包含3.3.3GA的依赖。所以如果你需要使用3.3.3版本和richfaces-impl-jsf2，你需要从skins排除它、或者重新定义作用域。 (So you have to exclude it from skins or redefine scope to provided in order to use 3.3.3 version with richfaces-impl-jsf2.)

添加以下配置获得主题：

        <dependency>
            <groupId>org.richfaces.samples</groupId>
            <artifactId>themes</artifactId>
            <version>${richfaces.version}</version>
        </dependency>    
        <dependency>
            <groupId>org.richfaces.samples</groupId>
            <artifactId>violetRays</artifactId>
            <version>${richfaces.version}</version>
        </dependency>    
        <dependency>

Bean验证
你应该添加依赖以便使用基于约束的验证(constraint based Validation)。访问Hibernate Validator项目主页获得更多信息。3.1.0实现和基于JSR-303的4.0.2实现需要添加不同的依赖。

各种第三方库
要使用NEKO过滤器，你需要在pom中添加如下配置：

<dependency>
      <groupId>nekohtml</groupId>
      <artifactId>nekohtml</artifactId>
      <version>${nekohtml.version}</version> 
      <scope>runtime</scope>
<dependency>

它会添加xerces的依赖。所以如果你需要改变xerces的版本，则需要排除(exclude)它，然后单独添加如下配置：

    <dependency>
      <groupId>xerces</groupId>
      <artifactId>xercesImpl</artifactId>
      <version>${xerces.version}</version>
    </dependency>

要使用rich:insert组建，需要添加jhighlight的依赖：

    <dependency>
      <groupId>com.uwyn</groupId>
      <artifactId>jhighlight</artifactId>
      <version>${jhighlight.version}</version>
    </dependency>