在使用自己的tag时,首先需要在web.xml里面进行注册,注册方式是在web.xml开头加上:
<context-param>
<param-name>facelets.LIBRARIES</param-name>
<param-value>/WEB-INF/facelet-taglibs/echo.taglib.xml</param-value>
</context-param>
并且tag的模版都要在WEB-INF目录下,不然就会找不到
然后是开始定义这个tag, 建立/WEB-INF/facelet-taglibs/echo.taglib.xml
<?xml version="1.0"?>
<!DOCTYPE facelet-taglib PUBLIC
"-//Sun Microsystems, Inc.//DTD Facelet Taglib 1.0//EN"
"http://java.sun.com/dtd/facelet-taglib_1_0.dtd">
<?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://www.myfaces.com/facelets/tags</namespace>
<tag>
<tag-name>tree2</tag-name>
<source>../../tree2.xhtml</source>
</tag>
<tag>
<tag-name>datatable</tag-name>
<source>../../datatable.xhtml</source>
</tag>
</facelet-taglib>
注意的是, <source>tpl/echo.xhtml</source>, source标明的文件也要在WEB-INF里面.namespace可以随便命名, 这是给后来引用的.
最后是/pages/myecho.xhtml
<!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:tutorial="http://tutorial.facelets">
<body>
<tutorial:echo msg="#{param.message}"/>
</body>
</html>
ui composition
在web.xml添加context-param:
<context-param>
<param-name>javax.faces.DEFAULT_SUFFIX</param-name>
<param-value>.xhtml</param-value>
</context-param>
这里我们可以看到,我们之后使用的都将是xhtml而不是传统的jsp。
在faces-config.xml里面声明view-handler:
<application>
<view-handler>com.sun.facelets.FaceletViewHandler</view-handler>
</application>
那么当我们使用导航规则<navigation-rule>的时候,就会导航到.xhtml页面了。
Ok,配置完成。
二.如何使用facelet?
facelet布局强大的地方就是使用了模板,这个模板是一个xhtml文件,我们需要在这个xhtml里面设置一些<ui:insert>,例如我们先建一个template.xhtml:
<?xml version="1.0" encoding="UTF-8"?>
<html xmlns=http://www.w3.org/1999/xhtml
xmlns:ui="http://java.sun.com/jsf/facelets">
<head><meta> http-equiv="Content-Type" content="text/html;charset=UTF-8"/>
<title><ui:insert name="title">这里我们填写默认title</ui:insert></title>
</head>
<body>
Hi,facelet<br/>
<ui:insert name="content"></ui:insert>
<body>
</html>
这个xhtml很容易理解,首先设置xmlns命名空间,就是jsp的<@taglib>,ui就相当于<@taglib>的prefix,值就相当于<@taglib>的uri。我们使用到了facelet的<ui:insert>标签。这个标签表示使用这个模板的页面需要扩展的位置,位置名就是name属性的值啦。如果使用模板的页面没扩展这个位置,那么就使用默认值。
好,编写使用这个模板的页面composition.xhtml:
<?xml version="1.0" encoding="UTF-8"?>
<html xmlns=http://www.w3.org/1999/xhtml
xmlns:ui="http://java.sun.com/jsf/facelets"
xmlns:h="http://java.sun.com/jsf/html"
xmlns:f="http://java.sun.com/jsf/core">
<body>
<ui:composition template="template.xhtml">
<ui:define name="content"><h:outputText value="我们在这里扩展content啦" /></ui:define >
</ui:composition>
<body>
</html>
这个页面你可以看到我添加了JSF的自定义标签声明,也就相当于声明了<@taglib>。
然后ui:composition的template属性选择调用那个模板,ui:define的那么属性选择扩展哪个位置。
在这个页面,我没有扩展title位置,仅仅扩展了content位置,然后输出h:outputText的值。
Ok,测试一下,运行项目,然后去到composition.xhtml。
我们会看到页面的title显示“这里我们填写默认title”
页面里面则显示:
Hi,facelet
<ui:composition>是一个模版标签,它将一些可以被其他Facelets页面所包含的共有内容封装起来。
该标签的属性:
template 该属性不一定必需 意为:将在标签开始和结束之间显示的模版文件所在的路径
<ui:composition> 指定使用那个模版文件,然后通过<ui:define>对模版文件中每个可以供插入的<ui:insert>锚点进行定义。
在运行期,具体的内容将会被插入到<ui:composition> 中定义的锚点位置。
<ui:define>标签用于将命名的的内容插入到模版中,它在模版标签的(如:composition和decorate)内部使用,define的name属性必须和目标模版中的insert 的name属性相同。
该标签的name属性必须有,必须和insert标签的name属性相同。
define标签的内部的内容将插入到目标中的insert标签的name属性标签处,define标签外部内同将被忽略。
insert标签用于模版中指点的插入点,该点将会被define标签的内容所替代。
<ui:include>标签用来在文件中包含另一个facelets文件,它只要指定被包含的文件的位置,它就可以包含任何拥有<ui:component>或<ui:composition>等标签或简单的xhtml和xml代码片段文件。
该标签有一个必须属性src 属性值可以为简单的的值或EL表达式,用来指定所包含的的facelets文件的位置。可以是相对路径也可以是绝对路径。