|
这个东东真是不错！！！ （翻译的不好，见谅！）
一、RichFaces (3.1.x) 技术需求
1.JDK 1.5 或更高版本；
2.支持的 JSF 实现：
Sun JSF 1.1 RI - 1.2
MyFaces 1.1.1 - 1.1.5
Facelets JSF 1.1.1 - 1.2
3.支持的应用服务器：
Apache Tomcat 4.1 - 6.0
IBM WebSphere 5.1 - 6.0
BEA WebLogic 8.1 - 9.0
Oracle AS/OC4J 10.1.3
Resin 3.0
Jetty 5.1.X
Sun Application Server 8 (J2EE 1.4)
Glassfish (J2EE 5)
JBoss 3.2 - 4.0.x
Sybase EAServer 6.0.1
4.支持的浏览器：
Internet Explorer 5.5 - 7.0
Firefox 1.5 - 2.0
Opera 8.5 - 9.0
Netscape 7.0
Safari 2.0
二、安装配置
1.解压下载的压缩包文件，复制其中的“richfaces-api-3.1.0.jar”，“richfaces-impl-3.1.0.jar”，“richfaces-ui-3.1.0.jar”文件到应用程序 "WEB-INF/lib" 目录下。
2.添加如下内容到应用程序“WEB-INF/web.xml”文件中。
<context-param>
<param-name>org.richfaces.SKIN</param-name>
<param-value>blueSky</param-value>
</context-param>
<filter>
<display-name>RichFaces Filter</display-name>
<filter-name>richfaces</filter-name>
<filter-class>org.ajax4jsf.Filter</filter-class>
</filter>
<filter-mapping>
<filter-name>richfaces</filter-name>
<servlet-name>Faces Servlet</servlet-name>
<dispatcher>REQUEST</dispatcher>
<dispatcher>FORWARD</dispatcher>
<dispatcher>INCLUDE</dispatcher>
</filter-mapping>
3.添加如下几行到应用程序 JSP 页面中：
<%@ taglib uri="http://richfaces.org/a4j" prefix="a4j" %>
<%@ taglib uri="http://richfaces.org/rich" prefix="rich" %>
对于 XHTML 页面：
<xmlns:a4j="http://richfaces.org/a4j" />
<xmlns:rich="http://richfaces.org/rich" />
三、web.xml 中的 Richfaces 参数
I、初始化参数（<context-param>）
1.org.richfaces.SKIN
默认值：DEFAULT
其它八种预定义的皮肤：
DEFAULT
plain
emeraldTown
blueSky
wine
japanCherry
ruby
classic
deepMarine
其值为在应用中使用的皮肤的名字。其值可用一个精确（大小写）的字符串做为皮肤名字，或指向一个字符串属性的 EL 表达式（#{...}），或 org.richfaces.framework.skin 类型的一个属性。
2.org.ajax4jsf.LOGFILE
默认值：none
这是一个指向应用程序或容器日志文件的 URL （如果有日志文件的话）。如果设置了这个参数，那么日志文件的内容将会作为一个调试错误页面在框架（iframe）窗口中显示。
3.org.ajax4jsf.VIEW_HANDLERS
默认值：none
这是一个由逗号分隔的自定义 ViewHandler 实例的序列，用于插入到 Handlers 链路上。Handlers 按照给定的顺序被插入到 RichFaces viewhandlers 之前。例如，在 facelets 应用程序中，这个参数必须包含 com.sun.facelets.FaceletViewHandler，来代替在 faces-onfig.xml 文件中的声明。
4.org.ajax4jsf.CONTROL_COMPONENTS
默认值：none
这是一个逗号分隔的名字序列，用于将一个组件作为一个特殊的控制情形，例如资源文件加载器，别名（alias）bean 组件等等。这是一个从 COMPONENT_TYPE 静态属生反射得到的一个组件类型。对于这样类型组件的编码方法常常在呈现的 Ajax 响应中被调用，尽管这个组件不在被更新部分中。
5.org.ajax4jsf.ENCRYPT_RESOURCE_DATA
默认值：false
为了生成的资源，例如加密生成的数据，它会在资源的 URL 上被编码加密。例如，URL 指向一个由 mediaOutput 组件生成的图片，而 mediaOutput 组件包含一个生成方法的名字，那么对于一个黑客的攻击来说，他很可能创建一个对于任何 JSF baked beans 或其它属性的请求。为了避免这样的攻击，在重要的应用程序中设置这个参数为“true”（应用于 JRE > 1.4）。
6.org.ajax4jsf.ENCRYPT_PASSWORD
默认值：random
用于资源数据加密的一个密码。如果没有设置，将使用一个随机的密码。
7.org.ajax4jsf.COMPRESS_SCRIPT
默认值：true
不允许框架重新格式化 JavaScript 文件（使其不利于调试）
II、org.ajax4jsf.Filter 初始化参数
1.log4j-init-file
这是一个指向 log4j.xml 配置文件的路径（相对于应用程序上下文），log4j.xml 可用于创建每个应用程序的自定义日志信息。
2.enable-cache
默认值：true
启用框架所生成资源（JavaScript，CSS，images，等等）的缓存。为了调试开发自定义的 JavaScript 或 Style(css) 目的，应避免在浏览器中使用旧的缓存数据。
3.forceparser
默认值：true
通过一个 HTML 语法检查器强制解析每一个 JSF 页面。如果为“false”，只有 Ajax 响应才被语法检查器解析且被转换为规范的 XML。设置为“false”除了提高了性能，还为 Ajax 更新提供视觉的效果。
四、其他
因为本人现在使用的是 Myfaces，所以下面列出了有关 Myfaces 与 RichFaces 集成的问题：
问题在于 web.xml 文件中所定义的多个不同的过滤器之间存在冲突。为了避免这些问题，RichFaces 过滤器在配置文件中的位置必须被定义在其它过滤器之上。
当使用 MyFaces + Seam 时，还有其它问题。如果使用这个组合，那么应该在 <f:view> 标签内部使用 <a4j:page> 标签，然后再在 <a4j:page> 标签中包含其它内容，因为 Myfaces 中的 <f:view> 实现存在一些问题。
这个问题可能在不久的将来被攻克。
五、其他技术问题，可参见：
http://labs.jboss.com/file-access/default/members/jbossrichfaces/freezone/docs/devguide/en/html/SettingsForDifferentEnvironments.html
|
RichFaces 安装配置（整/译）
一共有 3 条评论
这句话是什么意思？
为什么我把这句话去掉，在有facelet的页面中就出现乱码了？