使JSF (ADF Faces) 支持动态导航

背景介绍
在使用标准的 JSF Navigation 时需要为 指定确定的 URL 地址。如果为其配置 EL expression 会在运行时找不到页面，究其原因是因为没有对 EL 进行相应的赋值转化，即没有转化为 EL 所指定的 URL 地址。

项目中遇到如下问题：需要使 ADF Faces （不想对这个东西做更多的介绍，如果不是很清楚可以去 google 一把 ）支持动态的导航，因为原有的好多导航链接都直接存放在了数据库中，而新系统必须依赖旧系统中的数据库（可以新添数据项，但不能删除已有的数据）。

实现原理
非常幸运地在网络上找到这篇文章 How to make JSF navigation rules more dynamic，其解决了基于 JSF 的解决方案，但是其针对的实现版本是 SUN 的官方实现。出于总结的目的，下文会把这篇文章的概要和实现在这里描述一下。

后来参读 JavaServer Faecs in Action （如想理解机制和原理，推荐这本书；如仅仅想快速进入开发，推荐 Core JavaServer Faces 2nd），发现原因主要集中在 ViewHandler 身上，因为在书中如此描述说明该类：
"The default Navigation-Handler instance selects a new view identifier based on the outcome and any configured navigation rules, uses the ViewHandler to create the new view, and sets it as the current view on the FacesContext. The selected view is then displayed by the ViewHandler during the Render Response phase of the Request Processing Lifecycle. The default ViewHandler handles this by forwarding the request to the web container, which processes the JSP page normally."
"The ViewHandler class is used internally by JSF to create new UIView-Root instances. This class is pluggable, so you can either decorate it or write an entirely new implementation—this is how JSF can support display technologies other than JSP."

现在明白了为什么 JSF 的 Navigation rules 中的 to-view-id 不支持 EL，原因是相应的 ViewHandler 不支持 EL expression 的解释。那么接下来的事情就简单了。

JSF （SUN version） - 这里的实现来自于上面的那篇文章，没有经过真正的测试

1. ViewHandler实现 - 继承 com.sun.facelets.FaceletViewHandler 并且 overwrite getActionURL().

java 代码

@Override
public String getActionURL(FacesContext context, String viewId)
{
    String result = viewId;
    if(Util.isVBExpression(viewId))
    {
        ValueBinding vb = context.getApplication().createValueBinding(viewId);
        result = vb.getValue(context).toString();
    }
        result = super.getActionURL(context, value);
    int queryStart = value.indexOf("?");
    if((queryStart > 0) && (result.indexOf("?") == -1))
    {
        result = result + value.substring(queryStart);
    }
    return result;
}

2. ViewHandler注册 - 注意体会 JSF 的 pluginable 机制的方便之处

xml 代码

<application>
    ...
    <view-handler>com.interactive_objects.jsf.crud.generic.DynamicViewHandler<!---->view-handler>
<!---->application>

3. Navigation配置

xml 代码

<navigation-rule>
    <from-view-id>/pages/organisation/*<!---->from-view-id>
    <navigation-case>
        <from-action>#{OrganisationBean.select}<!---->from-action>
        <from-outcome>selected<!---->from-outcome>
        <to-view-id>#{OrgansiationBean.computedRedirect}<!---->to-view-id>
        <redirect/>
    <!---->navigation-case>
<!---->navigation-rule>

ADF Faces 实现
ADF Faces 的实现和 JSF 的有所不同。在 SUN 的官方实现中，getActionURL 能够得到 to-view-id 的配置值，也就是说，无论你的配置值是什么，该方法都可以接受到。但是在 Oracle 的实现方法中，如果你的配置中包含有 EL expression，该方法是无法接受到配置值的，所以我们需要在 createView 方法中，实现上面的功能。

1. ViewHandler实现

java 代码

package com.xxx.xxx;

import oracle.adfinternal.view.faces.application.ViewHandlerImpl;

import javax.faces.application.ViewHandler;
import javax.faces.context.FacesContext;
import javax.faces.el.ValueBinding;
import javax.faces.component.UIViewRoot;

import com.sun.faces.util.Util;

/**
 * This class is a subcalss of oracle.adfinternal.view.faces.application.ViewHandlerImplViewHandlerImple.
 * This class will replace the ADF Faces default ViewHandler class to handle the function how to create the view based on
 * the element of the .
 *
 */
public class CeViewHandler extends ViewHandlerImpl {

    public CeViewHandler(ViewHandler viewHandler) {
        super(viewHandler);
    }

    @Override
    /**
     * This method gets the content of the  element.
     * Then if the content is an expression, the method will translate expression into the real value.
     */
    public UIViewRoot createView(FacesContext facesContext, String s) {
        // Delegate the super to get the rest work done.
        return super.createView(facesContext, parseExpression(facesContext, s));
    }
@Override
public String getActionURL(FacesContext facesContext, String s) {
 return super.getActionURL(facesContext, parseExpression(facesContext, s));
}

private String parseExpression(FacesContext facesContext, String s) {
        String result = s;

        // If the view-id element is expressin, get the real value.
        if (Util.isVBExpression(s)) {
            ValueBinding vb = facesContext.getApplication().createValueBinding(s);
            result = vb.getValue(facesContext).toString();
        }
return result;

}

}

接下来的步骤可以参考上面的 JSF 过程。

感觉 JSF 的 pluginable 机制还是有其某些方面的可取之处的，但是这个 server-state 的机制能够在走多远，我们只能拭目以待。（FYI: ADF Faces 可以实现 client-side state 了，绝不是广告，希望大家在用这个框架是三思，同时可以等 Apache Trinidad 发布正式版本后在去使用。）