ICEfaces Note(3)

ICEfaces Note(3)

一、使用ICEfaces的Auto-Complete Component
自动完成组件（Auto-Complete Component）实际上就是ice:selectInputText组件。这个组件提供了一个带有自动完成功能的增强的文本输入组件。一旦用户输入文本到组件中，组件将提供一个可能匹配的弹出列表供用户选择。
这个组件在用户还没有完成输入时预测了用户想要键入的短语。这个组件需要开发者在backing bean实现匹配搜索算法。
下面给了使用该组件的例子。
1、selectInputText组件能产生两种类型的列表（list）：
1）字符串数据的列表；
2）任意复杂的子组件列表。
－－－－－－－－－－－－－－－－－－－－－－－－－－
<ice:selectInputText rows="10" width="300" valueChangeListener="#{autoCompleteBean.updateList}">
    <f:selectItems value="#{autoCompleteBean.list}"/>
</ice:selectInputText>
－－－－－－－－－－－－－－－－－－－－－－－－－－
上面的代码将显示一个下拉列表引用来匹配输入的文本。
rows属性定义了当输入文本时，有多少结果项被列出；
width属性定义了输入文本框和下拉列表框的宽度；
valueChangeListener属性链接backing bean，来控制当输入列表改变时相应列表的改变。
f:selectItems是JSF的标签，它链接到backing bean，列出所有的有效值。

下面的代码将展示怎样使用组件来产生任意子组件的列表：
－－－－－－－－－－－－－－－－－－－－－－－－－－

< ice:selectInputText  rows ="6"  width ="300"  listVar ="city"  
    valueChangeListener ="#{autoCompleteBean.updateList}"
    listValue ="#{autoCompleteBean.list}" >
     < f:facet  name ="selectInputText" >
         < ice:panelGrid  columns ="3"  style ="margin-bottom:-20px;"
            columnClasses ="cityCol,stateCol,zipCol" >
             < ice:outputText  value ="#{city.city}" />
             < ice:outputText  value ="#{city.state}" />
             < ice:outputText  value ="#{city.zip}" />
         </ ice:panelGrid >
     </ f:facet >
</ ice:selectInputText >

－－－－－－－－－－－－－－－－－－－－－－－－－－
这个例子显示了输入城市名的部分单词，则下拉列表中显示出匹配的城市名、州名、邮政编码。

2、创建Backing Beans
在例子中我们使用三个主要的backing beans：
（1）AutoCompleteBean：从AutoCompleteDictionary类存储收集到的值。其包含的方法是更新列表和从字典列表中得到匹配。
（2）AutoCompleteDictionary：从文件系统中的一个文件得到字典列表。
（3）City：基本类，作为字典列表的对象。
1）创建字典
对于自动完成组件要工作，必须有一个字典，让backing beans能查询和得到匹配的变量列表。如下：
－－－－－－－－－－－－－－－－－－－－－－－－－－

< java  version ="1.4.2_08"  class ="java.beans.XMLDecoder" >
     < object  class ="java.util.ArrayList" >
         < void  method ="add" >
             < object  class ="com.icesoft.icefaces.tutorial.component.autocomplete.City" >
                 < void  property ="areaCode" >
                     < string > 631 </ string >
                 </ void >
                 < void  property ="city" >
                     < string > Holtsville </ string >
                 </ void >
                 < void  property ="country" >
                     < string > Suffolk </ string >
                 </ void >
                 < void  property ="state" >
                     < string > New York </ string >
                 </ void >
                 < void  property ="stateCode" >
                     < string > NY </ string >
                 </ void >
                 < void  property ="zip" >
                     < string > 00501 </ string >
                 </ void >
             </ object >
         </ void >
     </ object >
</ java >

 

－－－－－－－－－－－－－－－－－－－－－－－－－－
这个文件可能相当大，因此我们可以zip这个xml文件以节省空间。