JSF自定义组件之三 JSF实现-Tag

    上篇已介绍了完整的HTML实现，从这篇开始，将前面介绍的功能逐步地用JSF组件来实现。

    分析前面的HTML页面，我们简单为该标签设置四个属性，分别为：valueList -- 下拉列表， value -- 值， image -- 下拉按钮图片， styleClass -- 用来指定文本框的格式。

    因此，继承类javax.faces.webapp.UIComponentELTag，生成DropdownListTag类，代码如下：

1. package net.moon.jsf.customer.tag;
3. import javax.el.ValueExpression;
4. import javax.faces.component.UIComponent;
5. import javax.faces.webapp.UIComponentELTag;
7. import net.moon.jsf.customer.component.HtmlDropdownList;
9. public class DropdownListTag extends UIComponentELTag {
10.     private static final String RENDER_TYPE = "net.moon.DropdownList";
11.     private static final String COMPONENT_TYPE = "DropdownList";
13.     private ValueExpression value;
14.     private ValueExpression valueList;
15.     private ValueExpression styleClass;
16.     private ValueExpression image;
17.     
18.     public void setValue(ValueExpression value) {
19.         this.value = value;
20.     }
22.     public void setValueList(ValueExpression valueList) {
23.         this.valueList = valueList;
24.     }
26.     public void setStyleClass(ValueExpression styleClass) {
27.         this.styleClass = styleClass;
28.     }
30.     public void setImage(ValueExpression image) {
31.         this.image = image;
32.     }
34.     @Override
35.     public String getComponentType() {
36.         // TODO Auto-generated method stub
37.         return COMPONENT_TYPE;
38.     }
40.     @Override
41.     public String getRendererType() {
42.         // TODO Auto-generated method stub
43.         return RENDER_TYPE;
44.     }
46.     @Override
47.     public void release() {
48.         // TODO Auto-generated method stub
49.         super.release();
50.         value = null;
51.         valueList = null;
52.         styleClass = null;
53.         image = null;
54.     }
56.     @Override
57.     protected void setProperties(UIComponent component) {
58.         // TODO Auto-generated method stub
59.         super.setProperties(component);
60.         
61.         HtmlDropdownList dropdown = (HtmlDropdownList) component;
63.         if (valueList != null) {
64.             if (!valueList.isLiteralText()) {
65.                 dropdown.setValueExpression("valueList", valueList);
66.             } else {
67.                 dropdown.setValueList(valueList.getExpressionString());
68.             }
69.         }
71.         if (value != null) {
72.             if (!value.isLiteralText()) {
73.                 dropdown.setValueExpression("value", value);
74.             } else {
75.                 dropdown.getAttributes().put("value", value);
76.             }
77.         }
79.         if (styleClass != null) {
80.             if (!styleClass.isLiteralText()) {
81.                 dropdown.setValueExpression("styleClass", styleClass);
82.             } else {
83.                 dropdown.getAttributes().put("class", styleClass);
84.             }
85.         }
87.         if (image != null) {
88.             if (!image.isLiteralText()) {
89.                 dropdown.setValueExpression("image", image);
90.             } else {
91.                 dropdown.setImage(image.getExpressionString());
92.             }
93.         }
95.     }
97.     public DropdownListTag() {
98.         super();
99.         // TODO Auto-generated constructor stub
100.     }
102.     
103. }

    另外，编写如下tld文件，描述标签：

1. <?xml version="1.0" encoding="UTF-8" ?>
2. <taglib
3.     xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-jsptaglibrary_2_1.xsd"
4.     xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
5.     version="2.1">
6.     <description>This is a custmoer component, include server site
7.         dropdown list, to make the large size drop down list can be shown not
8.         at the initial time, but when click the down button </description>
9.     <tlib-version>1.0</tlib-version>
10.     <short-name>moon</short-name>
11.     <uri>http://www.moonsnow.net/jsf</uri>
12.     <tag>
13.         <description>this is the drop down list tag</description>
14.         <name>dropdownList</name>
15.         <tag-class>net.moon.jsf.customer.tag.DropdownListTag</tag-class>
16.         <body-content>JSP</body-content>
17.         <attribute>
18.             <name>value</name>
19.             <required>false</required>
20.             <rtexprvalue>true</rtexprvalue>
21.             <deferred-value>
22.                 <type>java.lang.String</type>
23.             </deferred-value>
24.         </attribute>
25.         <attribute>
26.             <description>this is the list of string which you want to show
27.                 for this dropdown list</description>
28.             <name>valueList</name>
29.             <required>true</required>
30.             <deferred-value>
31.                 <type>java.util.List</type>
32.             </deferred-value>
33.         </attribute>
34.         <attribute>
35.             <description>the style class of the text box</description>
36.             <name>styleClass</name>
37.             <rtexprvalue>false</rtexprvalue>
38.             <type>java.lang.String</type>
39.         </attribute>
40.         <attribute>
41.             <description>the image for the drop down button</description>
42.             <name>image</name>
43.             <deferred-value>
44.                 <type>java.lang.String</type>
45.             </deferred-value>
46.         </attribute>
47.     </tag>
48. </taglib>

 

    其中，Tag类中的ComponentType和RendererType两个属性较为重要，在后面篇章中将综合介绍其具体配置方式。

 

    下一篇将介绍Component类的而开发。