动作事件

JSF Gossip: 动作事件

JSF支持事件处理模型，虽然由于HTTP本身无状态（stateless）的特性，使得这个模型多少有些地方仍不太相同，但JSF所提供的事件处理模型已足以让一些传统GUI程序的设计人员，可以用类似的模型来开发程序。

在简单的导航中，我们根据动作方法（action method）的结果来决定要导向的网页，一个按钮系结至一个方法，这样的作法实际上即使JSF所提供的简化的事件处理程序，在按钮上使用action系结至一个动作方法（action method），实际上JSF会为其自动产生一个“默认的ActionListener”来处理事件，并根据其传回值来决定导向的页面。

如果您需要使用同一个方法来应付多种事件来源，并想要取得事件来源的相关讯息，您可以让处理事件的方法接收一个 javax.faces.event.ActionEvent事件参数，例如：

UserBean.java

package onlyfun.caterpillar;

import javax.faces.event.ActionEvent;

public class UserBean {
    private String name;
    private String password;
    private String errMessage;
    private String outcome;
   
    public void setName(String name) {
        this.name = name;
    }
   
    public String getName() {
        return name;
    }
   
    public void setPassword(String password) {
        this.password = password;
    }
   
    public String getPassword() {
        return password;
    }
   
    public void setErrMessage(String errMessage) {
        this.errMessage = errMessage;
    }
   
    public String getErrMessage() {
        return errMessage;
    }
   
    public void verify(ActionEvent e) {
        if(!name.equals("justin") ||
           !password.equals("123456")) {
            errMessage = "名称或密码错误" + e.getSource();
            outcome = "failure";
        }
        else {
            outcome = "success";
        }
    }

    public String outcome() {
        return outcome;
    }
}

在上例中，我们让verify方法接收一个ActionEvent对象，当使用者按下按钮，会自动产生ActionEvent对象代表事件来源，我们故意在错误讯息之后如上事件来源的字符串描述，这样就可以在显示错误讯息时一并显示事件来源描述。

为了提供ActionEvent的存取能力，您的index.jsp可以改写如下：

index.jsp

<%@ taglib uri="http://java.sun.com/jsf/core" prefix="f" %>
<%@ taglib uri="http://java.sun.com/jsf/html" prefix="h" %>
<%@page contentType="text/html;charset=Big5"%> 
<html>
<head>
<title>第一个JSF程序</title>
</head>
<body>
    <f:view>
        <h:form>
            <h3>请输入您的名称</h3>
            <h:outputText value="#{user.errMessage}"/><p>
           名称: <h:inputText value="#{user.name}"/><p>
           密码: <h:inputSecret value="#{user.password}"/><p> 
            <h:commandButton value="送出" 
                            actionListener="#{user.verify}"
                            action="#{user.outcome}"/>
        </h:form>
    </f:view>
</body>
</html>

主要改变的是按钮上使用了actionListener属性，这种方法可以使用一个ActionListener，JSF会先检查是否有指定的 actionListener，然后再检查是否指定了动作方法并产生默认的ActionListener，并根据其传回值导航页面。

如果您要注册多个ActionListener，例如当使用者按下按钮时，顺便在记录档中增加一些记录讯息，您可以实现 javax.faces.event.ActionListener，例如：

package onlyfun.caterpillar;

import javax.faces.event.ActionListener;
....

public class LogHandler implements ActionListener {
     public void processAction(ActionEvent e) {
         // 处理Log
     }
}

package onlyfun.caterpillar;

import javax.faces.event.ActionListener;
....

public class VerifyHandler implements ActionListener {
     public void processAction(ActionEvent e) {
         // 处理验证
     }
}

这么一来，您就可以使用<f:actionListener>标签向组件注册事件，例如：

<h:commandButton value="送出" action="#{user.outcome}">
<f:actionListener type="onlyfun.caterpillar.LogHandler"/>
<f:actionListener type="onlyfun.caterpillar.VerifyHandler"/>
</h:commandButton>

<f:actionListener>会自动产生type所指定的对象，并调用组件的addActionListener()方法注册 Listener。

大可制作：QQ群：31564239（asp|jsp|php|mysql）

JSF Gossip: 动作事件