【续前。。。。。。】

九、步骤三：编写标签库描述符

前文多次提到，用户在JSP文件中写入<x:repeatText...>这样的标签，当JSP引擎读到这个标签时，将翻译为对的标签处理器类 StrRepeatTag的调用。我们的问题是，标签名称repeatText和标签处理器类名称StrRepeatTag完全不同，JSP引擎是如何正确地找到与标签名称对应的标签处理器类的呢？这正是标签描述库要做的。

标签库描述符的后缀为tld，实际上是一个xml文件，其中定义了与标签名对应的标签处理器类名。程序清单 9所示是一号组件的标签描述符的部分内容：

程序清单 9 一号组件的标签描述符文件的内容节选

?

   <tag>
       <name>repeatText</name>
       <tag-class>customcomponent1.StrRepeatTag</tag-class>
       <attribute>
           <name>text</name>
       </attribute>
       <attribute>
           <name>number</name>
       </attribute>
   </tag>

我们感兴趣的内容被在<tag>元素内，其中可见包含在<name>元素内的标签名repeatText和<tag- class>元素内的标签处理器类名customcomponent1.StrRepeatTag。标签和标签处理器类之间的对应关系就是这样建立的。

除了给标签和标签处理器类配对外，标签库描述符还用来定义标签的属性，例如上面例子用<attribute>元素分别定义了text和number两个属性。这里的定义主要是供JSP引擎使用的。JSP引擎将根据标签属性定义对用户在JSP文件中写入的内容进行格式检查，如果用户写入既非text亦非number的属性名，则JSP引擎将报错。

NetBeans对标签库描述符的编写提供了工具支持。我们可以用如下步骤为一号组件创建标签库描述符：

1.??? 在NetBeans新建一个文件，“类别”选择“Web”，“文件类型”选择“标记库描述符”；
2.??? NetBeans打开“新建标记库描述符”对话框，在其中输入文件名如mytld；
3.??? 在根元素<taglib>内添加一个<tag>元素；
4.??? 在<tag>元素内，用<name>元素定义标签名，用<tag-class>元素定义标签处理器类，用<attribute>元素定义标签属性。

图 9显示了NetBeans的“新建标记库描述符”对话框。图中有一个值得注意的点是URI。当我们有许多来自不同厂商的标签库描述符文件时，这些文件可能包含有相同名称的标签，甚至连标签库描述符文件本身的名称都可能相同（当然，放在不同的目录或者Jar文件中）为每个标签库描述符定义一个唯一的URI，可以用来区分不同的标签库描述符。因此，URI必须是唯一的，通常用厂商的域名来命名，例如http://java.sun.com/jsf/core或者http://jsf.madihe.com/my/custom等等。我们的例子中，只有一个标签库，因此，我们接受NetBeans给出的默认 URI即/WEB-INF/tlds/mytld，不做修改。
?

?

图 9 NetBeans的新建标记库描述符对话框

NetBeans中一号组件标签库描述符mytld.tld的完整代码如图 10所示。图中我们折叠了所有注释内容。

?

图 10 NetBeans中一号组件标签库描述符mytld.tld的完整代码

十、步骤四：配置自定义UI组件

经过前面三个步骤，可以说JSF自定义UI组件的编写过程已经基本完成，现在我们有一个组件类StrRepeat.java用来定义一号组件的特征和行为，一个标签处理器类StrRepeatTag.java用来处理相应的JSP标签，还有一个标签库描述符mytld.tld用来建立JSP标签<x:repeatText>和标签处理器类StrRepeatTag之间的联系，当JSP引擎遇到<x:repeatText>这样的标签时，将会其翻译为StrRepeatTag类的实例化代码。

但是StrRepeatTag并不是我们所需要的，因为UI逻辑不在StrRepeatTag类上，而是在组件类StrRepeat上，只有这个类才包含了我们定义的UI逻辑，即在其方法encodeEnd()中以指定的次数重复输出指定字符串。

可见，标签处理器类StrRepeatTag不是我们的最终目的，组件类StrRepeat才是。因此，在StrRepeatTag的父类 UIComponentELTag中，包含了实例化组件类并给其赋值的代码。StrRepeatTag类继承了这些代码，所以我们不必自己动手编写。

那么，UIComponentELTag是如何知道应该实例化哪个类的呢？记得上文我们曾经提到StrRepeatTag类覆盖了父类的 getComponentType()的方法，这个方法简单地返回一个称为“组件类型”的字符串。这个组件类型字符串正是定位组件类的依据。

图 11以一号组件为例，示出了JSP标签、标签处理器类、组件类是如何通过标签库描述符和组件类型进行关联的。从图中可见，标签库描述符“粘合”了JSP标签和标签处理器类，而组件类型则“粘合”了标签处理器类和组件类，这样，我们在JSP页面上写下的标签<x:repeatText>最终变成了组件类StrRepeat的一个实例。

?

图 11 标签库描述符和组件类型的“粘合”作用

在 JSF中，UI组件的生成是由一个专门的类负责的，这个类称为Application类。UIComponetELTag从 getComponentType()方法中获得组件类型，以这个组件类型为参数调用Applic