76 lines
2.0 KiB
C
76 lines
2.0 KiB
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
|