salesforce零基础学习（八十）使用autoComplete 输入内容自动联想结果以及去重实现

项目中，我们有时候会需要实现自动联想功能，比如我们想输入用户或者联系人名称，去联想出系统中有的相关的用户和联系人，当点击以后获取相关的邮箱或者其他信息等等。这种情况下可以使用jquery ui中的autoComplete实现。

此篇需求为在输入框中输入检索词对数据库中User表和Contact表的Name字段进行检索，符合条件的放在联想列表中，当用户选择相应的名称后，输入框中显示此名称对应的邮箱地址。

实现此功能可以整体分成三步：

1.通过输入内容检索相关表中符合条件的数据；

2.对检索的数据进行去重以及封装；

3.前台绑定autoComplete实现自动联想功能。

一.通过输入内容检索相关表中符合条件的数据

因为要对两个表进行操作，使用SOQL需要对两个表进行查询，并对搜索结果进行拼接，这种方式使用SOQL只能对每个字符进行like操作。比如输入中行大连，使用SOQL需要拆分成 where name like '%中%行%大%连%'。此种检索搜索出来的结果可能会搜索出用户不想搜索出来的结果，比如 ‘行连大中’。而且对多个表操作推荐使用SOSL，所以此处使用SOSL进行检索操作。

SOSL的操作以及检索封装可以参看：salesforce零基础学习（七十五）浅谈SOSL（Salesforce Object Search Language），此篇使用封装的方法作为Util。

二.对检索的数据进行去重以及封装

对于搜索结果，我们需要三部分内容：

• 搜索的数据中对象的名称：objName;
• 搜索的数据类型，属于User还是Contact: objType;
• 搜索的数据中对象的邮箱：objEmail

所以我们封装一下这个结果集的类，包含三个字段。因为我们最终需要的是用户/联系人邮箱，如果用户/联系人名称和用户/联系人邮箱完全相同，则我们假定他们是相同的数据。所以我们重写一下equals()和hashCode()方法，定义一下两条数据相同的规则。定义后，可以先使用Set接受结果集进行去重，然后转换成List进行结果返回。代码如下：

public without sharing class AutoRetrieveController {

    public String content{get;set;}

    @RemoteAction
    public static List<ObjWrapper> retrieveUsersOrContacts(String name) {
        //返回的结果集
        List<ObjWrapper> results;
        //用于去重的set，去除名称和email相同的数据
        Set<ObjWrapper> resultSet = new Set<ObjWrapper>();
        //封装数据查询曾
        SOSLController.RetrieveWrapper wrapper = new SOSLController.RetrieveWrapper();
        wrapper.retrieveKeyword = name;
        wrapper.searchGroup = 'NAME FIELDS';
        wrapper.objName2FieldsMap = new Map<String,List<String>>();
        List<String> userFields = new List<String>{'Name','Email'};
        List<String> contactFields = new List<String>{'Name','Email'};
        wrapper.objName2FieldsMap.put('user',userFields);
        wrapper.objName2FieldsMap.put('contact',contactFields);
        //获取结果显示列表
        List<SOSLController.SearchResultWrapper> searchResultList = SOSLController.search(wrapper);
        //迭代，数据转换以及去重处理
        if(searchResultList!= null && searchResultList.size() > 0) {
            for(SOSLController.SearchResultWrapper temp : searchResultList) {
                ObjWrapper tempWrapper = new ObjWrapper();
                tempWrapper.objType = temp.objName;
                Map<String,Object> fieldsMap = temp.objFieldName2Value;
                if(fieldsMap.get('Name') != null) {
                    tempWrapper.objName = (String)fieldsMap.get('Name');
                }
                if(fieldsMap.get('Email') != null) {
                    tempWrapper.objEmail = (String)fieldsMap.get('Email');
                }
                resultSet.add(tempWrapper);
            }
        }
        if(resultSet.size() > 0) {
            results = new List<ObjWrapper>(resultSet);
        } else {
            results = new List<ObjWrapper>();
        }
        return results;
    }

    public class ObjWrapper {
        public String objName{get;set;}
        public String objEmail{get;set;}
        public String objType{get;set;}

        public Boolean equals(Object o){
            Boolean result = false;
            if(o instanceof ObjWrapper) {
                ObjWrapper obj = (ObjWrapper)o;
                if(objEmail != null && objName != null) {
                    if(objEmail.equalsIgnoreCase(obj.objEmail) && objName.equalsIgnoreCase(obj.objName)) {
                        result = true;
                    }
                }
                
            }
            return result;
        }

        public Integer hashCode() {
            return 1;
        }
    }
}

三.前台绑定autoComplete实现自动联想功能

使用jquery ui的autoComplete功能，需要下载jquery ui 的js以及css文件，页面使用了jquery，所以也需要使用jquery的js文件。下载后压缩成zip包，上传到static resource便可以引用了。

此处为将三个文件放在了jquery的文件夹下，上传了zip包名称为JqueryUI。页面代码如下：

<apex:page controller="AutoRetrieveController">

    <apex:includeScript value="{!URLFOR($Resource.JqueryUI, 'jquery/jquery.js')}" />
    <apex:includeScript value="{!URLFOR($Resource.JqueryUI, 'jquery/jquery-ui.min.js')}" />
    <apex:stylesheet value="{!URLFOR($Resource.JqueryUI, 'jquery/jquery-ui.min.css')}" />
    <apex:form>
        <apex:inputText id="content" value="{!content}" onmousedown="autoCompleteList()" styleClass="contentWidth"/>
    </apex:form>


    <script>

        j$ = jQuery.noConflict();

        function autoCompleteList(){
            var contentDom = j$("input[id$=content]");
            if (contentDom.size() == 0) {
                return ;
            }
            contentDom.autocomplete({
                minLength: 2,
                autoFocus: true,
                source: function(request, response) {
                    queryTerm =  request.term;
                    console.log(queryTerm);
                    if(queryTerm != '') {
                        AutoRetrievController.retrieveUsersOrContacts(
                            queryTerm,
                            function(result, event) {
                                if (event.type == 'exception') {
                                } else {
                                    sObjects = result;
                                    if (0 == sObjects.length) {
                                        response(null);
                                    } else {
                                        response(sObjects);
                                    }
                                }
                        });
                    }
                },
                focus: function(event, ui) {
                    return false;
                },

                select: function(event, ui) {
                    this.value = ui.item.objEmail;
                    return false;
                },
            }).data("uiAutocomplete")._renderItem = function(ul, item) {
                    var entry = item.objName +'\t\t' + item.objType;
                    entry = entry.replace(queryTerm, "<b>" + queryTerm + "</b>");
                    return j$( "<li></li>" )
                            .data( "item.autocomplete", item )
                            .append( "<a>" + entry + "</a>" )
                            .appendTo( ul );
            };
        }

    </script>
</apex:page>

效果展示：

总结：联想功能在开发中还是比较常用的，autoComplete功能有好多相关的方法，可以去官网或者其他渠道了解相关方法进行UI的美化。篇中只是对基础功能进行抛砖引玉。

还有好多功能点需要优化，比如对数据检索没有进行相关limit的限制，去重方法写的过于简单，没有分别考虑null的处理等等。有兴趣的小伙伴可以继续完善。