JSF2.0系列-复合组件（1）

最新推荐文章于 2025-11-26 16:57:48 发布

原创最新推荐文章于 2025-11-26 16:57:48 发布 · 1.8k 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#jsf #action #xhtml #servlet #encoding #html

企业应用与设计同时被 2 个专栏收录

18 篇文章

订阅专栏

java

17 篇文章

订阅专栏

本文介绍如何使用JSF2.0的复合组件功能来自定义分页组件，包括创建分页组件页面、编写自定义组件描述文件及加载自定义组件等步骤。

在JSF2.0开发中，通常我们会遇到某个标签无法满足要求，或者某些代码老是重复的写，而重复写同一个代码就已经违反了[不重复自己]的原则，为了减轻这样的“症状”，我们利用复合组件来简化我们的操作。

首先我们来看看以下一个分页的代码，平常我们分页主要有两种方式，一是在页面上使用标签进行判断显示，另外一种是使用在代码中写好固定的内容，其中第一种方式由于JSP模板功能需要其他的支持，而写在java代码中的分页代码更不方便更改，幸好JSF2.0中提供了符合组件的功能，我们可以通过复合组件的方式自定义一个组件标签，通过标签的方式来使用可以大大简化我们的操作。

使用步骤如下：

1：建立一个分页组件页面，我们取名为page.xhtml，代码如下

<?xml version='1.0' encoding='UTF-8' ?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xmlns:h="http://java.sun.com/jsf/html" xmlns:ui="http://java.sun.com/jsf/facelets" xmlns:c="http://java.sun.com/jsp/jstl/core"> <ui:composition> <c:if test="${not empty backBean}"> <h:inputHidden value="#{backBean.pageNo}" /> <h:inputHidden value="#{backBean.pageSize}" /> <h:commandLink action="#{backBean.first}"> <h:graphicImage value="/resources/firstpage.gif" /> </h:commandLink> <h:commandLink action="#{backBean.preview}"> <h:graphicImage value="/resources/prevpage.gif" /> </h:commandLink> <h:commandLink action="#{backBean.next}"> <h:graphicImage value="/resources/nextpage.gif" /> </h:commandLink> <h:commandLink action="#{backBean.last}"> <h:graphicImage value="/resources/lastpage.gif" /> </h:commandLink> </c:if> </ui:composition> </html>

说明：<ui:composition>表示在其内的内容是一个复合组件的内容，里面的代码是普通的JSF标签+JSTL的标签，没有很特别的东西，但是请注意里面的值#{backBean.pageNo}，backBean是从外部传入的对象，属于变量,它是PageBean的实例（具体代码后面再介绍）。

2：编写自定义组件的描述文件

建立好分页组件页面后，必须要注册此组件，而这个任务交给一个叫自定义组件描述文件来完成，它是一个xml文件，文件名称为myTag.xml内容如下：

<?xml version="1.0"?> <!DOCTYPE facelet-taglib PUBLIC "-//Sun Microsystems, Inc.//DTD Facelet Taglib 1.0//EN" "facelet-taglib_1_0.dtd"> <facelet-taglib> <namespace>http://mytag/jsf</namespace> <tag> <tag-name>page</tag-name> <source>page.xhtml</source> </tag> </facelet-taglib>

说明：<facelet-taglib>是表示这个描述的内容是facelets的标签，也就是说自定义复合组件就是标签的定义；<namespace>指定一个命名空间，我们在页面上引用的时候就需要使用到它，这个我们后面再讲

3：加载自定义组件

在自定义组件完成后我们就必须让容器加载它，打开WEB-INF目录下的web.xml文件，加入一个初始化参数，代码如下：

<context-param> <param-name>javax.faces.FACELETS_LIBRARIES</param-name> <param-value> /WEB-INF/tags/myTag.xml </param-value> </context-param>

说明：javax.faces.FACELETS_LIBRARIES是一个JSF Servlet的初始化搜索变量，如果此值存在的话，就会加载指定值的内容，也就是加载我们自定义组件的描述文件。