開發自定義JSF組件(5) 在JSP中用JSF組件

時間 2019-11-08

標籤開發自定義 jsf 組件 jsp 中用欄目 JSP 简体版

原文原文鏈接

完整的教材： html

開發自定義JSF組件(1) HelloWorldjava

開發自定義JSF組件(2) 使用Render渲染器web

開發自定義JSF組件(3) 使用綁定變量架構

開發自定義JSF組件(4) 保存狀態與恢復狀態jsp

開發自定義JSF組件(5) 在JSP中用JSF組件ide

採用JSF架構的應用，也有不少項目是使用jsp而不是facelets。若是要在JSP裏使用JSF組件，還得編寫jsp的標籤庫，不過與JSP標籤又不盡相同，下面我再次重構HelloWorld項目，看看JSP頁面如何使用<ida:hellWorld />標籤。測試

開發環境：ui

Windows 7this

IntelliJ IDEA 12.1.2spa

jboss-6.1.0.Final

JSF 1.2

HelloWorld的重構過程：

一、新建HelloWorldTag，JSF1.2繼承UIComponentELTag，網上不少教材都是JSF1.1版本的，繼承的是UIComponentTag，這個類在JSF1.2已過期。

public class HelloWorldTag extends UIComponentELTag {
    private static final String COMPONENT_TYPE = "com.regaltec.faces.HelloWorld";

    private static final String RENDERER_TYPE = "com.regaltec.faces.render.HelloWorld";

    private ValueExpression name;

    public ValueExpression getName() {
        return name;
    }

    public void setName(ValueExpression name) {
        this.name = name;
    }

    @Override
    protected void setProperties(UIComponent component) {
        super.setProperties(component);
        component.setValueExpression("name", name);
    }

    @Override
    public void release() {
        super.release();
        name = null;
    }

    @Override
    public String getComponentType() {
        return COMPONENT_TYPE;
    }

    @Override
    public String getRendererType() {
        return RENDERER_TYPE;
    }
}

HelloWorldTag的屬性與UIHelloWorld相似，事實上HelloWorldTag在這裏只是作一個適配。HelloWorldTag必須重載setProperties、getComponentType、getRendererType這3個方法，getComponentType、getRendererType這2個方法用來肯定一個視圖渲染器，而setProperties方法就是將tag裏的屬性轉換UIComponent組件中了。

注：使用a4j的reRender時，是不會調HelloWorldTag這個類的，這跟jsf生命週期有關。

二、在WEB-INF目錄下新建uicomponent.tld，這是JSP標籤庫描述文件。

<?xml version="1.0" encoding="ISO-8859-1"?>
<taglib xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-jsptaglibrary_2_1.xsd" version="2.1">
    <tlib-version>1.0</tlib-version>
    <short-name>ida</short-name>
    <uri>http://www.regaltec.com/ida40</uri>
    <tag>
        <name>helloWorld</name>
        <tag-class>com.regaltec.faces.taglib.HelloWorldTag</tag-class>
        <body-content>empty</body-content>
        <attribute>
            <name>name</name>
            <required>false</required>
            <deferred-value>
                <type>java.lang.String</type>
            </deferred-value>
        </attribute>
    </tag>
</taglib>

三、就這樣咱們就完成重構工做了，但重構前咱們的web應用都是跑facelets頁面的，爲了跑jsp頁面，還得從新配置web.xml及faces-config.xml這2個文件。

刪除web.xml的facelets配置

<context-param>
    <param-name>javax.faces.DEFAULT_SUFFIX</param-name>
    <param-value>.xhtml</param-value>
</context-param>
<context-param>
    <param-name>facelets.LIBRARIES</param-name>
    <param-value>/WEB-INF/uicomponent.taglib.xml</param-value>
</context-param>

刪除faces-config.xml的facelets配置

<view-handler>com.sun.facelets.FaceletViewHandler</view-handler>

四、新建jsp頁面進行測試，這裏簡單的將helloWorld.xhtml轉換爲helloWorld.jsp頁面。

<!DOCTYPE html>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@ taglib prefix="h" uri="http://java.sun.com/jsf/html" %>
<%@ taglib prefix="f" uri="http://java.sun.com/jsf/core" %>
<%@ taglib prefix="a4j" uri="http://richfaces.org/a4j" %>
<%@ taglib prefix="ida" uri="http://www.regaltec.com/ida40" %>
<html>
<f:view>
<head>
    <title>Hello World JSP</title>
</head>
<body>
    <a4j:form>
        <h:panelGrid columns="3">
            <h:outputText value="姓名：" />
            <h:inputText value="#{helloWorldBean.name}" />
            <a4j:commandButton value="肯定" reRender="out" />
        </h:panelGrid>
    </a4j:form>
    <h:panelGroup id="out">
        <ida:helloWorld name="#{helloWorldBean.name}" />
    </h:panelGroup>
</body>
</f:view>
</html>

啓動jboss打開應用，以下圖，在文本輸入框裏敲入世界點擊肯定，文本框下方顯示你好，世界！。

以上代碼在jboss-6.1.0.Final調試經過，感謝百度雲網盤提供源碼下載。