项目中，我们有时候会需要实现自动联想功能，比如我们想输入用户或者联系人名称，去联想出系统中有的相关的用户和联系人，当点击以后获取相关的邮箱或者其他信息等等。这种情况下可以使用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的处理等等。有兴趣的小伙伴可以继续完善。