开发手册 欢迎您!
软件开发者资料库

RichFaces - 基本概念

RichFaces基本概念 - 从简单和简单的步骤学习RichFaces从基本到高级概念,包括概述,环境设置,体系结构,基本概念,丰富的外观,输入组件,输出组件,迭代组件,选择组件,菜单组件,富树,错误处理。

在本章中,我们将看到RichFaces的一些基本概念,我们将了解RichFaces如何处理AJAX请求和许多其他功能.

处理AJAX请求

如前所述,RichFaces提供了丰富的UI组件,即使不实现任何AJAX代码,也可以在Web应用程序中启用AJAX功能.所有这些AJAX功能都是通过 a4:j 标记库引入的. < A4J:commandLink> ,< a4j:commandButton>,< a4j:support> < a4j:poll> 是帮助开发人员在Web应用程序中包含AJAX功能的四个标记.我们将在后续章节中详细了解标记库.

部分树处理

在传统的AJAX应用程序中,将处理所有输入字段然而,在RichFaces中,我们可以选择部分提交树节点并验证必需的字段.

让我们考虑一个例子来了解更多相关信息.假设HTML中总共有五个元素 - "姓名","员工ID","员工薪水","员工地址"和"员工部门".现在,您只想验证或处理Employee id,这可以使用RichFaces,但不能使用AJAX.您需要将整个表单提交给服务器. RichFaces提供了一个execute属性,可以识别特定组件并对其进行处理.以下是可用的不同执行属性级别.

  • @all : 此属性将处理您的所有数据.

  • @none : 当您不想处理任何数据时,可以使用此功能.

  • @this : 这将仅处理请求组件.

  • @form : 这将处理包含请求组件的整个表单.

  • @region : 这将处理网页的特定区域.

部分视图更新

与输入字段类似,RichFaces提供类似的选项来更新不同的视图.开发人员可以根据自己的选择自定义视图.与execute属性一样,有一个与execute属性类似的render属性.所有这些属性都基于网页的ID标识符工作.

以下是可用的渲染属性的不同级别.

  • @all : 这将更新整个组件.

  • @none : 这不会更新您的任何组件.

  • @this : 这将仅更新请求组件.

  • @from : 这将更新包含请求数据的表单.

  • @region : 这将更新网页的特定区域.

其他a4j标签

直到现在,我们已经讨论了有关RichFaces应用程序的概念属性.在本节中,我们将通过动手实例详细了解它们.

< a4j:AJAX>

这是其中一个RichFaces提供的核心组件.这只是JSF2.0 f:AJAX标记的扩展部分.只要在网页中发生JS事件,此标记就会触发AJAX请求.以下示例详细介绍了此标记.在网页文件夹下创建一个"xhtml"页面,并将其命名为"a4jAJAXExample.xhtml".然后,粘贴以下代码.

                   a4j:AJAX Tag Example                                                                                       

我们还需要创建一个托管bean来保存来自网页的输入.继续在源包目录下创建一个java类.以下是 managedbean.java 类代码.

import javax.faces.bean.ManagedBean;   import javax.faces.bean.RequestScoped;   @ManagedBean   @RequestScoped   public class managedBean {      String message;      public String getMessage() {         return message;      }      public void setMessage(String message) {         this.message = message;      }   }

保存文件并运行,这将在浏览器中产生以下输出.

Hello Buddy

< a4j:param>

a4j:param是f:param标签的扩展.它用于为属性或实例变量赋值.此标记能够永久地将值分配给实例变量.以下是"a4jparamExample.html"代码.

                  Param tag example                                                                                                                                                                               

以下是相应的托管bean类代码.

import javax.faces.bean.ManagedBean;   import javax.faces.bean.RequestScoped;   @ManagedBean   @RequestScoped   public class managedBean {      String message;      public String getMessage() {         return message;      }      public void setMessage(String message) {         System.out.println("This method is getting called with"+message);             // we have added this line in order to check how the AJAX call       // happens to the class methods without any direct communication        this.message = message;      }   }

继续运行该文件.以下是浏览器中的输出.

Richface Tutorials

现在,在服务器控制台中,您将看到以下输出,它证明xhtml文件正在与托管bean通信,以便在运行时设置实例变量.

Apache Tomcat

< a4j:commandButton>

我们已经使用了命令按钮标签上一个例子.它用于在xhtml页面内创建一个按钮,该按钮将生成AJAX引擎并与之通信以处理特定请求.它需要输入并处理相同的内容并在Web浏览器中呈现输出.

在前面的示例中,我们创建了两个按钮 - "TutorialsPoint"和"RichFace Tutorials".我们的命令按钮标记在内部与托管bean通信,并设置所需的实例变量.它还负责呈现值.

< a4j:commandLink>

命令链接的作用类似于< h:commandlink> JSF 2.0的组件.只要命令链接对JS click事件起作用,命令按钮就会生成基于提交的AJAX请求.这是我们在命令按钮和命令链接中唯一的区别.以下示例将帮助您更好地理解标记库.创建"a4jCommandLink.xhtml"文件并将以下代码粘贴到其中.

                  Example of command Link                                                                                                                                  

无需更改托管bean类中的任何内容.运行此文件,以下将是浏览器中的输出.

Click Me

< a4j:outputPanel>

输出面板作为HTML页面的范围.它用于对网页的不同组件进行分组,而不是单独指定它们.在前面的示例中,我们使用输出面板来显示输入文本框中提供的消息.以下是输出面板的语法.

     

< a4j:region>

这是RichFaces的关键功能,它允许处理某些部分来自的网页.使用此标记,RichFaces中会发生部分树处理.它主要用于增加渲染过程.以下示例将帮助您详细了解这一点.请使用以下代码创建"a4jregionExample.xhtml"文件.

                 Region Example                                                                                                                             

除了这个xhtml页面,请相应地更新我们的managedBean.

import javax.faces.bean.ManagedBean;   import javax.faces.bean.RequestScoped;   @ManagedBean   @RequestScoped   public class managedBean {      String message;     String job;       public String getMessage() {         return message;      }      public void setMessage(String message) {         System.out.println("setMessage method is getting called with--"+message);       this.message = message;      }    public String getJob() {       return job;    }    public void setJob(String job) {       System.out.println("setJob method is getting called with--"+job);       this.job = job;    } }

上面的代码将在浏览器中产生以下输出.

One Two

每当点击命令链接"one"时,它将处理整个表单,但是,当我们单击命令链接"two"时,只会处理消息实例,因为它包含在区域标记中.类似地,如果我们将命令链接'one'包含在另一个region标记中,那么它将只处理前两个输入参数.以下是服务器控制台的屏幕截图,只要点击命令链接"两个".

Link Two

每当点击命令链接"one"时,以下将是输出.

Link Two

< a4j:repeat>

重复标记与< ui:repeat>完全相似JSF的标签.它有助于迭代网页中的列表.在下面的"a4jRepeat.xhtml"文件示例中,我们将遍历托管bean类中的列表.

                                                                                 
  •                                          
  •                                                   
        

    在浏览器中运行此特定文件后,您将获得以下输出.

    A4重复

    < a4j:status>

    顾名思义,这个标签是在您想要在前端显示AJAX请求的状态时非常有用.您可以根据自己的选择包含普通文本消息或gif或基于图像的状态.对于如下的小应用程序,您将看到前端的状态,但是,无论何时运行复杂的AJAX请求,此状态都非常明显.请修改"a4jregionExample.xhtml",如下所示.

                     Region Example                                                                                                                                                                               

    每当您运行此应用程序时,您都可以看到"工作......"和"完成"这两种状态的一瞥.只要请求完成,这些状态就会自动消失.

    < a4j:include>/< a4j:keepAlive>

    Include和keepAlive,这两个标签都是在RichFaces 3.0中引入的,但在RichFaces 4中,这些标签是折旧的,因为使用Facelets中使用的不同其他标签可以轻松实现这些功能,例如< ui:include>和< ui:insert>.顾名思义,引入了include以将一个页面包含到另一个页面中,并引入了keepAlive来控制与JSF页面相关的托管bean关联的范围.建议使用任何软件API的更新版本,并使用< UI>实现业务目标的组件和"注释"实现.

    < a4j:log>

    顾名思义,这个a4j组件有助于生成日志信息到Web浏览器.以下示例详细介绍了此标记.按以下方式编辑"a4jregionExample.xhtml"文件.

                     Region Example                                                                                                                                                                                           

    现在在浏览器中运行上面的代码,以下将是输出. a4j:log会在需要时生成所有级别的所需日志.

    A4:log

    < a4j:jsFunction>

    这是RichFaces最先进的功能,可以在没有任何JavaScript代码的情况下创建自动JS功能. CDK将基于任何JS事件生成自动JavaScript代码.

    在下面的示例中,我们创建了一个JavaScript函数,只要我们将鼠标悬停在指定值上,就会调用它.

                     Example of JS Function                                                                            BackEnd developer                                                 Database Admin                                                 Front End Developer                                                         You need to know:                                                                                                                          

    上面的代码将在浏览器中生成以下输出.根据JS事件,CDK将覆盖名为"showMySkill()"的方法,并且将在浏览器中打印所需的值.

    JS事件

    < a4j:AJAXListener>

    当您想在渲染之前执行特定侦听器时使用此标记结果到浏览器.此标记在RichFaces 4中不可用,因为

        Using a4j:actionListener                

    在上面的例子中,点击"提交"按钮,将创建一个JS事件,它将调用里面实现的"区域"方法bean类和相应的结果将作为结果呈现.