76 lines
2.0 KiB
Objective-C
76 lines
2.0 KiB
Objective-C
|
||
// SearchCoreManager.h
|
||
// APContact
|
||
//
|
||
// Created by 逆仞 on 14-3-22.
|
||
// Copyright (c) 2014年 Alipay. All rights reserved.
|
||
|
||
|
||
// CLASS DECLARATION
|
||
|
||
|
||
#define KSeparateWord '/'
|
||
#define KStringNull @""
|
||
|
||
@protocol APSearchDataProtocol <NSObject>
|
||
@required
|
||
- (NSString *)primarySearchData; //搜索主字段
|
||
@optional
|
||
- (NSString *)secondarySearchData; //搜索副字段
|
||
@end
|
||
|
||
/**
|
||
@brief 搜索字符串的回调
|
||
@param searchText: 搜索串
|
||
@param primaryMatchArrayWithPosition: 主字段匹配出来的数据，数组中的对象是APSearchPosition
|
||
@param secondaryMatchArray: 副字段的匹配出来的数据，数组中的对象是NSIndexPath
|
||
@param error:预留字段
|
||
*/
|
||
typedef void (^APSearchCallback) (NSString * searchText, NSMutableArray * primaryMatchArrayWithPosition, NSMutableArray * secondaryMatchArray ,NSError * error);
|
||
|
||
@interface APSearchManager :NSObject
|
||
|
||
@property (nonatomic , retain) NSString * separateWord;
|
||
@property (nonatomic , retain) NSString * matchFunction;
|
||
|
||
/**
|
||
@brief 获取字符串的拼音串
|
||
@param text: 输入的字符串
|
||
@return 返回拼音串(Ex:逆仞-NiRen)
|
||
*/
|
||
+ (NSString *)getPinYinWithText:(NSString *)text;
|
||
|
||
/**
|
||
@brief 建立搜索索引
|
||
@param dict: 实现协议的数据 (Ex: {A:[contact1,contact2,contact3], B:[contact4,contact5]})
|
||
@param indexChar: 数据Dictionary的有序keys Ex:[A,B]
|
||
*/
|
||
- (void)buildSearchIndexWithDataDict:(NSDictionary *)dict indexChar:(NSArray *)indexChar;
|
||
|
||
/**
|
||
@brief 建立搜索索引
|
||
@param array: 数据Array
|
||
*/
|
||
- (void)buildSearchIndexWithDataArray:(NSArray *)array;
|
||
|
||
/**
|
||
@brief 重置搜索索引
|
||
*/
|
||
- (void)resetSearchTree;
|
||
|
||
/**
|
||
@brief 搜索数据,优先主字段，主字段拼音匹配，主字段、副字段匹配数据不重复
|
||
@param searchText: 搜索串
|
||
@param owner: 调用的owner, 为取消使用
|
||
@param callBack: 搜索结果的回调
|
||
*/
|
||
- (void)search:(NSString*)searchText owner:(id)owner completionBlock:(APSearchCallback)callback;
|
||
|
||
/**
|
||
@brief 取消响应搜索操作
|
||
@param owner: 搜索方法调用者
|
||
*/
|
||
- (void)cancelSearchForOwner:(id)owner;
|
||
|
||
@end
|