ADF_236：使用AutoSuggest Behavior实现自动提示功能

开发运行环境：JDeveloper 11.1.2.4 + Oracle Database XE 11gR2

自动提示功能是页面上非常常见的一个功能。
本文以InputText组件为例，来说明如何实现自动提示功能。与网上的其它实现不同，本文介绍的实现方式具有一定的普遍性。

需求很简单：实现Employee的JobId字段的自动提示功能。

1. 选择Departments、Employees、Jobs表生成EO和VO。

2. 在JobsView上增加一个View Criteria：queryJobsByJobIdViewCriteria，根据JobId查询Jobs。

3. 定制JobsViewImpl.java，增加一个方法：queryJobsByJobId，并暴露到Client。

    public void queryJobsByJobId(String partOfJobIdStr) {

        this.setApplyViewCriteriaNames(null);

        ViewCriteria criteria = this.getViewCriteria("QueryJobsByJobIdViewCriteria");

        this.setRangeSize(10);

        this.applyViewCriteria(criteria);

        this.setbv_JobId(partOfJobIdStr);

        this.executeQuery();

    }

4. 拖放Employees Data Control生成Form

（1）在JobId上增加AutoSuggest Behavior

（2）设置AutoSubmit=true

完成后的代码如下：

<af:inputText value="#{bindings.JobId.inputValue}" label="#{bindings.JobId.hints.label}"

              required="#{bindings.JobId.hints.mandatory}"

              columns="#{bindings.JobId.hints.displayWidth}"

              maximumLength="#{bindings.JobId.hints.precision}"

              shortDesc="#{bindings.JobId.hints.tooltip}" autoSubmit="true" id="it6">

    <f:validator binding="#{bindings.JobId.validator}"/>

    <af:autoSuggestBehavior maxSuggestedItems="10"

                            suggestItems="#{viewScope.myBackingBean.onJobIdSuggest}"/>

</af:inputText>

（3）对应的Managed Bean中的方法：onJobIdSuggest，代码如下：

    public List onJobIdSuggest(FacesContext facesContext, AutoSuggestUIHints autoSuggestUIHints) {

        String param = autoSuggestUIHints.getSubmittedValue();

        OperationBinding binding = ADFUtils.findOperation("queryJobsByJobId");

        binding.getParamsMap().put("partOfJobIdStr", param);

        binding.execute();

        DCIteratorBinding it = ADFUtils.findIterator("JobsView1Iterator");

        it.setRangeSize(10);

        Row[] allRowsInRange = it.getAllRowsInRange();

        ArrayList selectItems = new ArrayList();

        for (Row o : allRowsInRange) {

            String var = (String)o.getAttribute("JobId");

            String desc = (String)o.getAttribute("JobTitle");

            selectItems.add(new SelectItem(var, var + " " + desc));

        }

        return selectItems;

    }

5. 修改页面的Bindings
（1）手工在Executables中增加Iterator：JobsView1Iterator

 （2）手工在Bindings中增加methodAction：queryJobsByJobId

6. 运行
当修改JobId时，会根据用户的输入自动提示相应的下拉选项。

Project 下载：ADF_AutoComplete.7z