59. XPages自定义控件（二）搜索视图
下面笔者用一个例子来展示用户控件的代码、使用和强大功能。在12. 如何在XPages中实现搜索视图里介绍的搜索视图的方法如果在每个需要搜索功能的页面上都做一遍，未免麻烦，也不易维护。于是，按照XPages提倡的做法，笔者将视图全文搜索的功能包含在一个SearchView用户控件里。打开数据库的全文检索，将这个控件放在任何含有标准视图控件的页面上，一个由一个输入框和搜索、清除两个按钮组成的具备下列功能的搜索条就准备就绪了。下面的代码片段包含一个SearchView用户控件和一个视图标准控件。
控件的功能包括：
1. 在文本框中输入要搜索的词，按回车键或搜索按钮，关联的视图将显示全文检索后包含输入的词的文档。
2. 按清除按钮，输入框被清空，视图恢复原始显示。
唯一要注意的是需要搜索的视图控件的数据源需要当场定义，而不能选择页面内已经定义好的数据源。即在源代码中，viewPanel的data属性被设置：
<xp:this.data><xp:dominoViewvar="view1"viewName="vwRecord"></xp:dominoView></xp:this.data>
而不是value属性被设置：
value="#{view2}"
这样搜索的代码才能获得这个数据源。控件源代码：
<?xml version="1.0" encoding="UTF-8"?><faces-config> <faces-config-extension> <namespace-uri>http://www.ibm.com/xsp/custom</namespace-uri> <default-prefix>xc</default-prefix> </faces-config-extension> <composite-component> <component-type>SearchView</component-type> <composite-name>SearchView</composite-name> <composite-file>/SearchView.xsp</composite-file> <composite-extension> <designer-extension> <in-palette>true</in-palette> </designer-extension> </composite-extension> <property> <property-name>viewPanel</property-name> <property-class>string</property-class> <display-name>viewPanel Id</display-name> <property-extension> <designer-extension> <editor>com.ibm.xsp.extlib.designer.tooling.editor.XPageControlIDEditor</editor> <default-value>viewPanel1</default-value> </designer-extension> </property-extension> </property> </composite-component></faces-config>
