使用 ADF Faces 对话框架 (ADF Faces EA15)

配置 Faces 以利用对话框架

首先，我们需要配置 JSF 项目，以使用 Oracle 的 ADF Faces 组件库提供的内置对话框架。要指定一个启动流程或对话的规则，只需指定一个命令组件输出和一个以“ process:”开头的导航规则。请看以下代码示例：

    <af:commandLink id="cmdLink" text="New user?"
  
                              
                        action="process:newAccount" 
useDialog="true"/>
                            

  <navigation-rule>
<from-view-id>/login.jspx</from-view-id>
<navigation-case>
  
                              
     <from-outcome>process:newAccount</from-outcome>
      <to-view-id>/new_account.jspx</to-view-id>
</navigation-case>
                            

当用户单击“New User” commandLink 时，这将在对话中显示“ / new_account .jspx”页。注意，我们还将 commandLink 上的“ partialSubmit”设置为“ true”；强烈建议您在启动对话的按钮/链接上使用此选项，这是因为它可以避免在对话启动后闪现出主页。

图 2：登录屏幕

图 3：“新帐户”对话从登录页启动。

用代码实现对话框架使用

可以使用 ADF Faces 命令组件中的硬编码输出，但与任何“ action”一样，您还可以编程方式确定是否要显示普通“操作”方法中的对话（或要显示什么对话）。例如，某个操作可能检查用户是否使用错误的口令进行了登录，如果是，则显示一个错误对话，而不是继续正常导航。

    <af:commandButton id="cmdBtn" text="Login"
  
                                
                  action="#{backing_login.commandButton_action}"
              useDialog="true"
                  windowHeight="200"
              windowWidth="500"/>
                              

  public String commandButton_action()
  {
String retValue;

    retValue = "orders";
_cust = getListCustomer();

    if (_cust == null || !password.equals(_cust.getPassword()))
    {
  
                              
     retValue = "process:error";
    }
return retValue;
  }
                            

以上的代码示例是由登录 commandButton 调用的 commandButton_action() 方法。此方法将缺省输出设置为“ orders”并获取尝试登录的客户。如果“数据库”中不存在用户，或输入的口令无效，则将输出重置为“ process:error”。此输出再加上我们在 Login 按钮上定义的 useDialog 属性将启动错误对话。参阅图 1：示例应用程序页面流。

所有这些技术都要求您使用“ process:”输出定义了导航规则。

<navigation-rule>
<from-view-id>/login.jspx</from-view-id>
<navigation-case>
  
                              
     <from-outcome>process:newAccount</from-outcome>
      <to-view-id>/new_account.jspx</to-view-id>
</navigation-case>
<navigation-case>
  
                              
     <from-outcome>process:error</from-outcome>
      <to-view-id>/error.jspx</to-view-id>
</navigation-case>
<navigation-case>
                            

在所有这些情况中，当您使用的是支持启动对话所需所有特性的 Web 浏览器时，将显示一个包含此对话的新窗口。但如果使用某个其他 Web 浏览器或不满足我们的需要的设备（如 PDA），您的对话框代码将仍然起作用！ADF Faces 并不启动一个新窗口，而只是在自动保留当前页面的所有状态后在当前窗口中向您显示对话页面。

图 4：与图 3 中显示的页面相同，但这次显示在 Palm 6.0.1 模拟器中

处理返回值并将值传递给对话

当流程结束时（有关它的含义的更多信息），命令组件将获取一个传递到 ReturnListener 的 ReturnEvent （如果您使用 addReturnListener 或使用“ returnListener”属性注册了一个 ReturnListener ）。此对话可以向您返回一个值，如果它返回了值，它将作为 ReturnEvent 的属性自动传递给您。

                  <af:commandLink id="cmdLink" text="New user?"
action="process:newAccount" useDialog="true"
  
                                
                                 returnListener="#{backing_login.handleReturn}"
                                  partialSubmit="true" windowHeight="200"
windowWidth="500"/>
                              

   public void handleReturn(ReturnEvent event)
   {
  
                              
    if (event.getReturnValue() != null)
     { 
                            

       Customer cst;     
String name;
String psw; 

                               
      cst = (Customer)event.getReturnValue();
       CustomerList.getCustomers().add(cst);
name = cst.getFirstName();
psw = cst.getPassword();
                            

                               
      inputText1.setSubmittedValue(null);
       inputText1.setValue(name);
inputText2.setSubmittedValue(null);
inputText2.setValue(psw); 
                            

     }
   }

当对话完成时将调用此方法。如果返回值为空，则表示用户取消了对话，因此我们不必执行任何操作。否则，此方法将相应地处理返回的对象和流程，在本例中这意味着向现有用户列表中添加新用户，并使用新添加的信息填充用户名和口令的输入域，以方便最终用户。只调用输入组件上的 setValue() 是不够的。还必须调用包含空值的 setSubmittedValue() 以清除最初提交的任何值。

如何完成流程

可以像编写任何其他 JSF 页面那样编写流程本身。唯一的差别是需要调用特殊的方法（ AdfFacesContext.returnFromProcess() ）以通知 ADF Faces 流程已完成。不管对话中是否显示流程，都可以调用此方法；如果它是对话，则对话窗口将自动关闭。您也不必在显示的第一个页面中调用它 - 可以根据需要从流程中的第一个页面导航到许多页面，只需在最后时调用 returnFromProcess() 。此方法还允许您从流程发送回“返回值”。在本示例中，“新帐户”对话实际上是两个页面 - new_account.jspx 和 account_details.jspx。account_details.jspx 页面是对话流中的最后一页，并且是将要调用 returnFromProcess() 方法的页面。此页面包含两个按钮 - Cancel 和 Done。当最终用户按 cancel 按钮时，我们只需关闭对话窗口并返回到初始页面。

现在，让我们看一看使用该流程的 account_details.jspx 页面：

<?xml version = '1.0' encoding = 'windows-1252'?>
<jsp:root xmlns:jsp="http://java.sun.com/JSP/Page" version="2.0"
xmlns:f="http://java.sun.com/jsf/core"
xmlns:h="http://java.sun.com/jsf/html"
xmlns:af="http://xmlns.oracle.com/adf/faces/EA15"
xmlns:afh="http://xmlns.oracle.com/adf/faces/EA15/html">
<jsp:output omit-xml-declaration="true" doctype-root-element="HTML"
doctype-system="http://www.w3.org/TR/html4/loose.dtd"
doctype-public="-//W3C//DTD HTML 4.01 Transitional//EN"/>
<jsp:directive.page contentType="text/html;charset=windows-1252"/>
<f:view>
<afh:html>
<afh:head title="account_details">
<meta http-equiv="Content-Type"
content="text/html; charset=windows-1252"/>
</afh:head>
<afh:body>
<af:form>
<af:panelPage title="Account Details">
<af:messages/>
<afh:tableLayout>

...

              <afh:rowLayout>
<afh:cellFormat>
  
                              
                 <af:commandButton text="Cancel"
actionListener="#{backing_new_account.cancel}"/>
<af:commandButton text="Done"
actionListener="#{backing_new_account.done}"/>
                </afh:cellFormat>
</afh:rowLayout>
</afh:tableLayout>
</af:panelPage>
</af:form>
</afh:body>
</afh:html>
</f:view>
</jsp:root>
                            

每个按钮有两个方法 - cancel() 和 done()。以下代码演示了如何调用 returnFromProcess()。对于 cancel()，我们只返回空；对于 done()，我们首先检查用户是否为新帐户输入了有效口令，然后使用 returnFromProcess() 方法返回用户输入。但请注意，无论在哪个操作中我们都不知道该值将返回到何处 - 我们只是依靠 ADF Faces 框架指定将该值返回到何处。

  public void cancel(ActionEvent e)
  {
  
                              
   AdfFacesContext.getCurrentInstance().returnFromProcess(null);
  }
                            

  public void done(ActionEvent e) 
  {

                               
   AdfFacesContext afContext = AdfFacesContext.getCurrentInstance();
                            

...  

    if (!password.equals(confirmPassword))
    {
FacesMessage fm = new FacesMessage();
fm.setSummary("Confirm Password");
fm.setDetail("You have entered an incorrect password.Please verify that you entered correct password!");
FacesContext.getCurrentInstance().addMessage(null, fm); 
    }
else
    {
Customer cst = new Customer();
cst.setFirstName(firstname);
...
cst.setPassword(password);

                               
   afContext.getCurrentInstance().returnFromProcess(cst);
    afContext.getProcessScope().clear();
    }
  }
                            

    <af:commandLink id="cmdLink" text="New user?"
                    action="process:newAccount" useDialog="true"
  
                              
                        launchListener="#{backing_login.handleLaunch}" 
                        returnListener="#{backing_login.handleReturn}"
                    partialSubmit="true" windowHeight="200"
                    ++windowWidth="500"/>
                            

   ...

         <af:selectInputText label="Pick a number:"value="(Empty)"
action="process:chooseInteger"
windowWidth="300" windowHeight="200"/>