Richfaces 3.3.3 中文组件详细指南

4星 · 超过85%的资源需积分: 12 120 浏览量更新于2024-07-26 收藏 2.21MB PDF 举报

《richfaces3.3.3中文使用手册》是一本详细介绍Richfaces 3.3.3版本中常用组件及其属性的中文指南。该手册主要针对开发人员在构建富客户端（Richfaces）应用时提供支持，帮助用户理解和掌握各种组件的正确使用方法。首先，手册分为三个主要部分： 1. **参考资料**：这部分为开发者提供了必要的背景知识和参考资料链接，以便于深入理解Richfaces框架和技术背景。 2. **一个简单的RichfacesWeb工程**：这部分介绍了如何创建和配置一个基础的Richfaces项目，包括基本的目录结构和设置，为后续组件的使用打下基础。 3. **Richfaces常用组件详解**： - **a4j组件**：这部分详细讲解了a4j（Ajax Push for RichFaces）组件，如`<a4j:actionparam>`用于传递参数，`<a4j:form>`管理表单提交，`<a4j:region>`定义区域更新等。每个组件都包含其关键属性和示例用法。 - **Rich组件**：这部分重点介绍Rich组件，如`<rich:ajaxValidator>`用于客户端验证，`<rich:column>`和`<rich:columnGroup>`用于数据展示，`<rich:tree>`实现树形数据结构等。这些组件通常与数据绑定和动态交互紧密相关。手册深入到各个组件的细节，包括`<a4j:status>`的实时状态更新，`<a4j:loadBundle>`和`<a4j:loadScript>`加载本地或远程资源，以及`<rich:modalPanel>`和`<rich:panel>`等UI容器组件。对于数据列表和表格处理，手册展示了`<rich:dataList>`, `<rich:dataTable>`, 和 `<rich:datascroller>`等组件，以及它们的高级版本如`<rich:extendedDataTable>`和`<rich:scrollableDataTable>`，用于实现分页和滚动功能。此外，手册还覆盖了其他辅助组件，如`<a4j:include>`用于动态插入内容，`<a4j:outputPanel>`进行区域刷新，`<a4j:queue>`处理异步请求队列，以及`<a4j:jsFunction>`定义JavaScript函数。通过阅读这本手册，开发者能够快速上手Richfaces 3.3.3，了解并掌握如何在实际项目中高效利用这些组件来创建响应式、功能强大的Web应用。无论是初次接触还是进阶开发者，都能从中获益匪浅。

- 14 -

<default-locale>en</default-locale>

<supported-locale>en</supported-locale>

<supported-locale>de</supported-locale>

<supported-locale>it</supported-locale>

</locale-config>

<message-bundle>demo.message</message-bundle>

</application>

Java 代码：

public class ChangeLocale {

public String germanAction() {

FacesContext context = FacesContext.getCurrentInstance();

context.getViewRoot().setLocale(Locale.GERMAN);

return null;

}

public String englishAction() {

FacesContext context = FacesContext.getCurrentInstance();

context.getViewRoot().setLocale(Locale.ENGLISH);

return null;

}

public String italianAction() {

FacesContext context = FacesContext.getCurrentInstance();

context.getViewRoot().setLocale(Locale.ITALIAN);

return null;

}

页面代码：

<h:form>

<a4j:loadBundle var="msg" basename="demo.message"/>

<h:outputText id="messageBundle" value="#{msg.greeting}"/>

<a4j:commandLink value="De" action="#{changeLocale.germanAction}" reRender="messageBundle" />

<a4j:commandLink value="Eng" action="#{changeLocale.englishAction}" reRender="messageBundle" />

<a4j:commandLink value="It" action="#{changeLocale.italianAction}" reRender="messageBundle" />

</h:form>

3.1.9 <a4j:loadScript>

<a4j:loadScrip>与<script>相似，但它能从其他资源加载脚本，比如 jar 包。

Example 从 web content 加载：

<a4j:loadScript src="/js/richTable.js" />

“/”表明相对于 web 根路径，而使用<script>标签时，若用绝对路径则需增加 application 前缀。

Example 从资源中加载：

如脚本文件在 jar 包中，路径为/org/mycompany/assets/script/focus.js，加载方式如下：

<a4j:loadScript src="resource:///org/mycompany/assets/script/focus.js" />

上例中，使用 resource://前缀来访问使用 RichFaces 资源框架的脚本文件。"src"属性将值传给应用

- 15 -

ViewHandler（如使用 Facelet 时，则为 com.sun.facelets.FaceletViewHandler）的 getResourceURL()方法，通

过 ExternalContext 的 encodeResourceURL()方法传回结果。

加载 scriptaculous(在 richfaces-impl 包内)：

<a4j:loadScript src="resource:///org/richfaces/renderkit/html/scripts/scriptaculous/scriptaculous.js"/>

使用别名加载

可以在静态脚本或动态生成的脚本中注册别名，然后使用别名加载文件。如加载 richfaces-impl 包内的

jquery、prototype：

<a4j:loadScript src="resource://jquery.js"/>(实际路径：/org/richfaces/renderkit/html/scripts/jquery/jquery.js)

<a4j:loadScript src="resource://prototype.js" />(实际路径：/org/ajax4jsf/javascript/scripts/prototype.js)

注：如果在页面中使用了 ajax 功能，prototype.js 已经自动加载到页面，不必再显式加载。

3.1.10 <a4j:loadStyle>

<a4j:loadStyle>与标准 style 标签相似，但它能从其他资源加载样式表，比如 jar 包。

Example 从 web content 加载：

<a4j:loadStyle src="/css/css.css"/>

Example 从资源中加载：

<a4j:loadStyle src="resource:///org/mycompany/assets/css/common.css" />

3.1.11 <a4j:keepAlive>

<a4j:keepAlive>标签允许在请求之间维持 bean 的状态。

如果 managed bean 被声明为 request 作用域，那么这个 bean 实例的生命期只对当前请求是有效的。在请

求结束后，任何试图引用该 bean 实例，服务器都会抛出一个非法参数异常。要避免这类异常，使用<a4j:keepAlive>

来维持整个 bean 对象在后续请求间的状态。

可以用 session作用域解决上述问题，但从架构观点看这可能是不适当的（在 seam 中可以使用 page scope）。

Example:

<a4j:keepAlive beanName = "#{myClass.testBean}"/>

"beanName"属性定义你希望重用的请求域 bean 的名字。注意这个属性必须指向一个合法 JSF EL 表达式，

它解析管理的 bean 实例。

3.1.12 <a4j:include>

<a4j:include>组件用来在一个视图中插入另一个视图，功能与<ui:include>相似，但它提供了 Ajax 模式的

局部页面导航功能。

<a4j:include viewId="/richfaces/include/examples/wstep1.xhtml" />，viewId 应使用完整的上下文关联资源

路径。

<a4j:include>包含的内容与整个页面并不是孤立的，在其中可以使用 reRender 指向页面的其他部分。当导

航执行后，只是组件树的局部被替换。

Example 向导页面:

主页面：

<h:panelGrid width="100%" columns="2" columnClasses="col1,col2">

<a4j:keepAlive beanName="profile" />

<rich:panel styleClass="wizard">

<f:facet name="header">

- 17 -

<h:panelGrid columns="3" columnClasses="wfcol1,wfcol2,wfcol3">

<h:outputText value="Notes:" />

<h:inputTextarea cols="20" rows="4" id="notes" value="#{profile.notes}" label="Notes" required="true" />

<rich:message for="notes" />

</h:panelGrid>

<a4j:commandButton value="<<Previous" style="float:left" immediate="true" action="previous"/>

<a4j:commandButton value="Next >>" style="float:right" action="next"/>

</div>

</ui:composition>

导航规则：

<navigation-rule>

<from-view-id>/richfaces/include/examples/wstep1.xhtml</from-view-id>

<navigation-case>

<from-outcome>next</from-outcome>

<to-view-id>/richfaces/include/examples/wstep2.xhtml</to-view-id>

</navigation-case>

</navigation-rule>

<navigation-rule>

<from-view-id>/richfaces/include/examples/wstep2.xhtml</from-view-id>

<navigation-case>

<from-outcome>previous</from-outcome>

<to-view-id>/richfaces/include/examples/wstep1.xhtml</to-view-id>

</navigation-case>

<navigation-case>

<from-outcome>next</from-outcome>

<to-view-id>/richfaces/include/examples/finalStep.xhtml</to-view-id>

</navigation-case>

</navigation-rule>

注意：当包含局部页面时，要使<a4j:include>（以及 Facelets <ui:include>标签）正常工作，检查被包含的

页面不要产生额外的 HTML <!DOCTYPE>, <html>, <body>标签。

3.1.13 <a4j:outputPanel>

<a4j:outputPanel>用来群组 Ajax 输出区。

当一个或多个组件要一起被更新时，可以用<a4j:outputPanel>将这些组件包裹起来，这样在"reRender"属

性中就不必指定逗号分隔的列表了。

特别，当 reRender 指向一个有 rendered 属性的组件，reRender 时将不能更新页面，这种情况下 reRender

应指向这个组件的父组件，或将这个组件用<a4j:outputPanel>包裹起来。

Example:

<a4j:support reRender="mypanel"/>

...

<a4j:outputPanel id="mypanel">

- 18 -

<h:panelGrid rendered="#{not empty foo.bar}">

...

</h:panelGrid>

</a4j:outputPanel>

"layout"属性

默认<a4j:outputPanel>页面输出为<span>标签，利用”layout”属性可以改变输出方式：

 "inline" （默认）- 输出标签为<span>

 "block" – 输出标签为<div>

 "none" – 由被包裹组件的"rendered"属性决定，当rendered="false"时，子组件不被渲染，<a4j:outputPanel>

输出一个display:none样式的<span>标签，并且ID为子组件ID；当rendered="true"时，<a4j:outputPanel>

根本不会出现在最终代码中。

Example:

<a4j:support reRender="mypanel"/>

...

<a4j:outputPanel layout="none">

<h:panelGrid id="mypanel" rendered="#{not empty foo.bar}">

...

</h:panelGrid>

</a4j:outputPanel>

注意：上面代码reRender指向了"mypanel"。

"ajaxRendered"属性

当<a4j:outputPanel>在任何ajax响应后都需重新渲染时，使用此属性（ajaxRendered="true"）。

Example:

<a4j:outputPanel ajaxRendered="true">

<h:messages/>

</a4j:outputPanel>

3.1.14 <a4j:queue>

<a4j:queue>组件排队从客户端发送的Ajax请求，内建Ajax支持的Richfaces组件能引用这个队列来优化Ajax

请求。

Richfaces队列有四种不同的类型：全局默认队列（global default）、视图默认队列（view scoped default）、

视图命名队列（view scoped named）和表单默认队列（form-based default）。

默认，Richfaces不排队Ajax请求，同时产生的事件将同时到达服务器。JSF实现不能保证先到的请求会先被

处理。这种情况下，服务端处理数据的顺序是不可预知的。使用队列可以排除几个Ajax请求在同时发送时产生冲

突，仅一个请求被处理，其余的要排队。在请求延迟内的类似请求，仅最后一个被发送，减少了请求数量，降低

了服务器负载。

在使用Richfaces开发页面时，常遇见这种情况：表单中多个组件在很短的一段时间内都产生ajax请求并重新

渲染部分页面元素，往往呈现出错乱的页面，这时就需要使用队列了。

全局默认队列

在web.xml内定义，不需可见或明显的设置将影响应用内所有视图的行为。全局默认队列名字为

"org.richfaces.queue.global"，默认是禁用的，因为页面中的所有Ajax请求都人工序列化将严重影响预期的行为。

全局默认队列将使所有异步的JavaScript和XML请求变成同步的。可配置如下参数启用：

<context-param>

<param-name>org.richfaces.queue.global.enabled</param-name>

剩余112页未读，继续阅读

uu101lgq

粉丝: 0
资源: 1

Richfaces 3.3.3 中文组件详细指南

RichFaces_3.3.3标签库手册

Richfaces3.3.3常用组件使用手册，非常全

Richfaces 3.3.3精华组件详析与教程

Richfaces3.3.3组件详解：a4j与Rich组件使用

Richfaces 3.3.3组件详解：从a4j到rich组件

Richfaces组件使用指南

Pytorch版代码幻灯片.zip

Jupyter_Chat甄嬛是利用甄嬛传剧本中所有关于甄嬛的台词和语句基于ChatGLM2进行LoRA微调得到的模仿甄.zip

高效甘特图模板下载-精心整理.zip

伯克利大学机器学习-5Dimensionality reduction [Percy Liang]

最新资源