Phase 事件


在 即時事 件 中我們提到，JSF的請求執行到回應，完整的過程會經過六個階段：
  • 回復畫面（Restore View）
依客戶端傳來的session資料或伺服端上的session資料，回復JSF畫面元件。
  • 套用請求值（Apply Request Values）
JSF畫面元件各自獲得請求中的值屬於自己的值，包括舊的值與新的值。
  • 執行驗證（Process Validations）
轉換為物件並進行驗證。
  • 更新模型值（Update Model Values）
更新Bean或相關的模型值。
  • 喚起應用程式（Invoke Application）
執行應用程式相關邏輯。
  • 繪製回應畫面（Render Response）
對先前的請求處理完之後，產生畫面以回應客戶端執行結果。

在每個階段的前後會引發javax.faces.event.PhaseEvent，如果您想嘗試在每個階段的前後捕捉這個事 件，以進行一些處理，則可以實作javax.faces.event.PhaseListener，並向 javax.faces.lifecycle.Lifecycle登記這個Listener，以有適當的時候通知事件的發生。

PhaseListener有三個必須實作的方法getPhaseId()、beforePhase()與afterPhase()，其中 getPhaseId()傳回一個PhaseId物件，代表Listener想要被通知的時機，可以設定的時機有：
  • PhaseId.RESTORE_VIEW
  • PhaseId.APPLY_REQUEST_VALUES
  • PhaseId.PROCESS_VALIDATIONS
  • PhaseId.UPDATE_MODEL_VALUES
  • PhaseId.INVOKE_APPLICATION
  • PhaseId.RENDER_RESPONSE
  • PhaseId.ANY_PHASE

其中PhaseId.ANY_PHASE指的是任何的階段轉換時，就進行通知；您可以在beforePhase()與afterPhase()中撰寫階段 前後撰寫分別想要處理的動作，例如下面這個簡單的類別會列出每個階段的名稱：
  • ShowPhaseListener.java
package onlyfun.caterpillar;

import javax.faces.event.PhaseEvent;
import javax.faces.event.PhaseId;
import javax.faces.event.PhaseListener;

public class ShowPhaseListener implements PhaseListener {

    public void beforePhase(PhaseEvent event) {
        String phaseName = event.getPhaseId().toString();
        System.out.println("Before " + phaseName);
    }

    public void afterPhase(PhaseEvent event) {
        String phaseName = event.getPhaseId().toString();
        System.out.println("After " + phaseName);
    }

    public PhaseId getPhaseId() {
        return PhaseId.ANY_PHASE;
    }
}

撰寫好PhaseListener後，我們可以在faces-config.xml中向Lifecycle進行註冊：
  • faces-config.xml
<?xml version="1.0"?>
<!DOCTYPE faces-config PUBLIC
 "-//Sun Microsystems, Inc.//DTD JavaServer Faces Config 1.0//EN"
 "http://java.sun.com/dtd/web-facesconfig_1_0.dtd">

<faces-config>
    <lifecycle>
        <phase-listener>
            onlyfun.caterpillar.ShowPhaseListener
        </phase-listener>
    </lifecycle>
    ......
</faces-config>

您可以使用這個簡單的類別，看看在請求任一個JSF畫面時所顯示的內容，藉此瞭解JSF每個階段的流程變化。