Пользовательский компонент Facelet в JSF
Можно ли создать собственный JSF-компонент Facelet? Что-то вроде <custom:composition>
из <ui:composition>
, или же <custom:include>
за <ui:include>
Было бы полезно, если бы кто-то мог рассказать мне о шагах.
Заранее спасибо,
Kaushal
1 ответ
Решение
Это принципиально taghandlers. Т.е. классы расширяются от TagHandler
,
Вот теговый обработчик Hello World.
com.example.HelloTagHandler
public class HelloTagHandler extends TagHandler {
public HelloTagHandler(TagConfig config) {
super(config);
}
@Override
public void apply(FaceletContext context, UIComponent parent) throws IOException {
// Do your job here. This example dynamically adds another component to the parent.
if (ComponentHandler.isNew(parent)) {
UIOutput child = new HtmlOutputText();
child.setValue("Hello World");
parent.getChildren().add(child);
}
nextHandler.apply(context, parent); // Delegate job further to first next tag in tree hierarchy.
}
}
/WEB-INF/my.taglib.xml
<?xml version="1.0" encoding="UTF-8"?>
<facelet-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-facelettaglibrary_2_0.xsd"
version="2.0"
>
<namespace>http://example.com/my</namespace>
<tag>
<tag-name>hello</tag-name>
<handler-class>com.example.HelloTagHandler</handler-class>
</tag>
</facelet-taglib>
/WEB-INF/web.xml
(примечание: эта часть не является обязательной, когда my.taglib.xml
в /META-INF
папка файла JAR внутри /WEB-INF/lib
как с библиотеками компонентов JSF):
<context-param>
<param-name>javax.faces.FACELETS_LIBRARIES</param-name>
<param-value>/WEB-INF/my.taglib.xml</param-value>
</context-param>
Использование в /some.xhtml
<html ... xmlns:my="http://example.com/my">
...
<my:hello />
Чтобы увидеть исходный код реализации Mojarra <ui:composition>
а также <ui:include>
нажмите на ссылку.