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>

效果展示:

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

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

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

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

上一篇:html日历(2)


下一篇:C#语法基础_foreach