Web アプリケーションへの JavaServer Faces の統合

NetUI と JSF は 1 つの Web アプリケーションに完全に統合できます。以下に、この 2 つのフレームワークを連携させる最も一般的な方法を示します。

	@Jpf.Action(forwards = { @Jpf.Forward(name = "success", path = "myJSFPage.faces") } )
	public Forward navigate() {
		return new Forward("success");
	}

たとえば、NetUI コントローラ ファイルに以下のアクションがあると仮定します。

	@Jpf.Action(forwards = { @Jpf.Forward(name = "success", path = "myJSFPage.faces") } )
	public Forward navigate() {
		return new Forward("success");
	}

このアクションを JSF から起動するには、action 属性で navigate を参照します。

    <h:form>
    ...
        <h:commandButton action="navigate" value="Go"/>
    </h:form>

JSF バッキング Bean からの NetUI アクションの実行

navigate アクションがコントローラ クラスにあると仮定します。JSF バッキング Bean 内から navigate を起動するには、アノテーション セット @Jpf.CommandHandler/@Jpf.RaiseAction によって修飾されたコマンド ハンドラを使います。

    @Jpf.CommandHandler(
        raiseActions={
            @Jpf.RaiseAction(action="navigate")
        }
    )
    public String invokeNavigate()
    {
        return "navigate";
    }

JSF ページからのコマンド ハンドラへのバインドは、通常の方法で行います。

    <h:commandButton action="#{backing.invokeNavigate}" value="Go"

JSF バッキング Bean からのコントロールの呼び出し

Java クラスからコントロールを呼び出すように、バッキング Bean からコントロールを呼び出します。

最初に、クライアント Java クラスに対してコントロールを宣言します。

    import org.apache.beehive.controls.api.bean.Control;
    
	...
    
    @Control
    private CustomerControl customerControl;

次に、そのコントロールのメソッドを呼び出します。

    public Customer[] getCustomers() {
		return customerControl.someMethod();
	}

JSF ページと NetUI アクション間でのデータの受け渡し

<%@ page language="java" contentType="text/html;charset=UTF-8"%>
<%@ taglib prefix="h" uri="http://java.sun.com/jsf/html"%>
<%@taglib uri="http://beehive.apache.org/netui/tags-databinding-1.0" prefix="netui-data"%>

<netui-data:declarePageInput required="true" type="java.util.ArrayList<businessObjects.Customer>" name="getCustomersResult" />

...

    <h:dataTable value="#{pageInput.getCustomersResult}" var="item0" border="1">

        ...

    </h:dataTable>

参照は pageInput 暗黙的オブジェクトに制限されておらず、JSF スタイルの式を使えば任意の暗黙的オブジェクトを参照できます。たとえば、以下の式では、コントローラ クラスの foo フィールドを参照します。

    <h:outputText value="#{pageInput.foo}"/>

JSF ページから NetUI コントローラ クラスにデータを (フォーム Bean として) 送信することもできます。

フォーム Bean パラメータを持つアクションがあると仮定します。

	@Jpf.Action(forwards = { @Jpf.Forward(name = "success", path = "confirm.faces") } )
	public Forward getCustomers(Customer form) {
	    
		// 送信フォーム データに関して処理を行う...
		
		return new Forward("success");
	}

フォーム Bean は HTML フォームの Java 表現です。Bean プロパティは HTML フォームのフィールドに対応します。

public class Customer implements Serializable
{
    private String first = "";
    private String last = "";
   
    public Customer()
    {
    }
    
    public Customer(String first, String last)
    {
        this.first = first;
        this.last = last;
    }

    public void setFirst(String value)
    {
        first = value;
    }

    public String getFirst()
    {
        return first;
    }

    public String getLast()
    {
        return last;
    }

    public void setLast(String value)
    {
        last = value;
    }
} 

JSF ページからアクションにこのフォーム Bean を送信するには、JSF スタイルの式を使って bean を参照します。

    <h:form>
        <h:outputLabel value="First:" for="field1" />
        <h:inputText value="#{backing.custFormBean.first}" id="field1" />
        <h:outputLabel value="Last:" for="field2" />
        <h:inputText value="#{backing.custFormBean.last}" id="field2" />
        <h:commandButton action="getCustomers" value="Submit">
            <f:attribute name="submitFormBean" value="backing.custFormBean" />
        </h:commandButton>
    </h:form>

フォーム Bean は、バッキング Bean を介して参照される点に注意します。上記の斜体の式 #{backing.custFormBean.first}、#{backing.custFormBean.last}、および backing.custFormBean を確認してください。

これらの式が機能するためには、バッキング Bean にフォーム Bean をフィールドとして含める必要があります。そのフィールドに対しては適切なセッターおよびゲッター メソッドを指定します。

@Jpf.FacesBacking()
public class index extends FacesBackingBean {
 
    private Customer custFormBean = new Customer();
 
    public Customer getCustFormBean() {
        return custFormBean;
    }
 
    public void setCustFormBean(Customer bean) {
        this.custFormBean = bean;
    }
}