IOS 常用第三方类整理

对于近期开发中用到的第三方类做了一些简单的整理, 分享...

AFNetworking

AFNetworking 是一个轻量级的网络请求API类库, 是以NSURLConnection, NSOperation和其他方法为基础的.

目前比较推荐的iOS网络请求组件, 默认网络请求时异步的, 通过block回调的方式对返回的数据进行处理.

需要注意的时AFNetworking对服务器返回的输数据类型ContentType要求比较严格, 默认支持application/json的返回. 所以可能需要添加对text/html返回的支持. 否则就无法获得返回的数据.

AFNetworking是异步的, 也可以使用同步的网络请求方法

常见问题：
1. AFNetworking作用都有哪些？
NSURLConnection提供了+sendAsynchronousRequest:queue:completionHandler:和+sendAsynchronousRequest:queue:completionHandler: ，但是AFNetworking提供了更好的功能
＊AFURLConnectionOperation和它的子类继承NSOperation的，允许请求被取消，暂停/恢复和由NSOperationQueue进行管理。
＊AFURLConnectionOperation也可以让你轻松得完成上传和下载，处理验证，监控上传和下载进度，控制的缓存。
＊AFHTTPRequestOperation和它得子类可以基于http状态和内容列下来区分是否成功请求了
＊AFNetworking可以将远程媒体数据类型（NSData）转化为可用的格式，比如如JSON，XML，图像和plist。
＊AFHTTPClient提供了一个方便的网络交互接口，包括默认头，身份验证，是否连接到网络，批量处理操作，查询字符串参数序列化，以及多种表单请求
＊的UIImageView+ AFNetworking增加了一个方便的方法来异步加载图像。

2. AFNetworking是否支持缓存？
可以，NSURLCache及其子类提供了很多高级接口用于处理缓存
如果你想将缓存存储再磁盘，推荐使用SDURLCache

3.如何使用AFNetworking上传一个文件？
NSData *imageData = UIImagePNGRepresentation(image);
NSURLRequest *request = [client multipartFormRequestWithMethod:@"POST" path:@"/upload" parameters:nil constructingBodyWithBlock: ^(id  formData) {
[formData appendPartWithFileData:imageData mimeType:@"image/png" name:@"avatar"];
}];

4.如何使用AFNetworking下载一个文件？
先创建一个AFURLConnectionOperation对象，然后再使用它的属性outputStream进行处理
operation.outputStream = [NSOutputStream outputStreamToFileAtPath:@"download.zip" append:NO];

5.如何解决：SystemConfiguration framework not found in project
请导入：
#import
#import

6.当应用程序退出时，如何保持持续的请求？
AFURLConnectionOperation有一个叫setShouldExecuteAsBackgroundTaskWithExpirationHandler:的方法用于处理在应用程序进入后台后，进行持续的请求
[self setShouldExecuteAsBackgroundTaskWithExpirationHandler:^{
}];

一些实例：
1.XML 请求
NSURLRequest *request = [NSURLRequest requestWithURL:[NSURL URLWithString:@"http://api.flickr.com/services/rest/?method=flickr.groups.browse&api_key=b6300e17ad3c506e706cb0072175d047&cat_id=34427469792@N01&format=rest"]];
AFXMLRequestOperation *operation = [AFXMLRequestOperation XMLParserRequestOperationWithRequest:request success:^(NSURLRequest *request, NSHTTPURLResponse *response, NSXMLParser *XMLParser) {
XMLParser.delegate = self;
[XMLParser parse];
} failure:nil];
[operation start];

2.图片请求：
UIImageView *imageView = [[UIImageView alloc] initWithFrame:CGRectMake(0.0f, 0.0f, 100.0f, 100.0f)];
[imageView setImageWithURL:[NSURL URLWithString:@"http://i.imgur.com/r4uwx.jpg"] placeholderImage:[UIImage imageNamed:@"placeholder-avatar"]];

3.图片上传处理，监测上传状态：
didiwei  17:28:57
NSURL *url = [NSURL URLWithString:@"http://api-base-url.com"];
AFHTTPClient *httpClient = [[AFHTTPClient alloc] initWithBaseURL:url];
NSData *imageData = UIImageJPEGRepresentation([UIImage imageNamed:@"avatar.jpg"], 0.5);
NSMutableURLRequest *request = [httpClient multipartFormRequestWithMethod:@"POST" path:@"/upload" parameters:nil constructingBodyWithBlock: ^(id formData) {
[formData appendPartWithFileData:imageData name:@"avatar" fileName:@"avatar.jpg" mimeType:@"image/jpeg"];
}];
AFHTTPRequestOperation *operation = [[AFHTTPRequestOperation alloc] initWithRequest:request];
[operation setUploadProgressBlock:^(NSUInteger bytesWritten, long long totalBytesWritten, long long totalBytesExpectedToWrite) {
NSLog(@"Sent %lld of %lld bytes", totalBytesWritten, totalBytesExpectedToWrite);
}];
[operation start];

4.在线流媒体请求
NSURLRequest *request = [NSURLRequest requestWithURL:[NSURL URLWithString:@"http://localhost:8080/encode"]];
AFHTTPRequestOperation *operation = [[AFHTTPRequestOperation alloc] initWithRequest:request];
operation.inputStream = [NSInputStream inputStreamWithFileAtPath:[[NSBundle mainBundle] pathForResource:@"large-image" ofType:@"tiff"]];
operation.outputStream = [NSOutputStream outputStreamToMemory];
[operation start];

SDWebImage

SDWebImage作为i图片处理工具, 为开发者提供了丰富完善的网络图片处理, 通常用于解决最占内存的图片缓存问题.

SDWebImage的常用方法

1. sd_setImageWithURL：

//图片缓存的基本代码，就是这么简单
[self.image1 sd_setImageWithURL:imagePath1];
2. sd_setImageWithURL:  completed:

//用block 可以在图片加载完成之后做些事情
[self.image2 sd_setImageWithURL:imagePath2 completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) {

NSLog(@"这里可以在图片加载完成之后做些事情");

}];
3. sd_setImageWithURL:  placeholderImage:

1
2
//给一张默认图片，先使用默认图片，当图片加载完成后再替换
[self.image1 sd_setImageWithURL:imagePath1 placeholderImage:[UIImage imageNamed:@"default"]];
4. sd_setImageWithURL:  placeholderImage:  completed:

//使用默认图片，而且用block 在完成后做一些事情
[self.image1 sd_setImageWithURL:imagePath1 placeholderImage:[UIImage imageNamed:@"default"] completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) {

NSLog(@"图片加载完成后做的事情");

}];
5. sd_setImageWithURL:  placeholderImage:  options:

//options 选择方式

[self.image1 sd_setImageWithURL:imagePath1 placeholderImage:[UIImage imageNamed:@"default"] options:SDWebImageRetryFailed];

SDWebImage 内部实现原理

入口 setImageWithURL:placeholderImage:options: 会先把 placeholderImage 显示，然后

SDWebImageManager 根据 URL 开始处理图片.

进入 SDWebImageManager-downloadWithURL:delegate:options:userInfo:，交给 SDImageCache 从缓存查找图片是否已经下载 queryDiskCacheForKey:delegate:userInfo:.

先从内存图片缓存查找是否有图片，如果内存中已经有图片缓存，SDImageCacheDelegate 回调 imageCache:didFindImage:forKey:userInfo: 到 SDWebImageManager。

SDWebImageManagerDelegate 回调 webImageManager:didFinishWithImage: 到 UIImageView+WebCache 等前端展示图片。

如果内存缓存中没有，生成 NSInvocationOperation 添加到队列开始从硬盘查找图片是否已经缓存。

根据 URLKey 在硬盘缓存目录下尝试读取图片文件。这一步是在 NSOperation 进行的操作，所以回主线程进行结果回调 notifyDelegate:

如果上一操作从硬盘读取到了图片，将图片添加到内存缓存中（如果空闲内存过小，会先清空内存缓存）。SDImageCacheDelegate 回调 imageCache:didFindImage:forKey:userInfo:。进而回调展示图片。

如果从硬盘缓存目录读取不到图片，说明所有缓存都不存在该图片，需要下载图片，回调 imageCache:didNotFindImageForKey:userInfo:。

共享或重新生成一个下载器 SDWebImageDownloader 开始下载图片。

图片下载由 NSURLConnection 来做，实现相关 delegate 来判断图片下载中、下载完成和下载失败。

connection:didReceiveData: 中利用 ImageIO 做了按图片下载进度加载效果。

connectionDidFinishLoading: 数据下载完成后交给 SDWebImageDecoder 做图片解码处理。

图片解码处理在一个 NSOperationQueue 完成，不会拖慢主线程

UI。如果有需要对下载的图片进行二次处理，最好也在这里完成，效率会好很多。

在主线程 notifyDelegateOnMainThreadWithInfo: 宣告解码完成，imageDecoder:didFinishDecodingImage:userInfo: 回调给 SDWebImageDownloader。

imageDownloader:didFinishWithImage: 回调给 SDWebImageManager 告知图片下载完成。

通知所有的 downloadDelegates 下载完成，回调给需要的地方展示图片。

将图片保存到 SDImageCache 中，内存缓存和硬盘缓存同时保存。写文件到硬盘也在以单独

NSInvocationOperation 完成，避免拖慢主线程。

SDImageCache 在初始化的时候会注册一些消息通知，在内存警告或退到后台的时候清理内存图片缓存，应用结束的时候清理过期图片

SDWI 也提供了 UIButton+WebCache 和 MKAnnotationView+WebCache，方便使用。

SDWebImagePrefetcher 可以预先下载图片，方便后续使用。

FMDB

iOS 平台上的SQLite数据库框架, 以OC的方式封装了SQLit的C语言API, 使用起来更加面向对象, 省去了很多麻烦/冗余的C语言代码, 对比苹果自带的Core Data框架更加轻量级和灵活, 并且提供了多线程的数据库操作方法. 有效的防止了数据混乱 .

FMDB有三个主要的类:

FMDataBase 简介: 一个FMDataBase对象就代表一个单独的SQLite数据库

作用: 用来执行SQL语句

FMResultSet

作用: 使用FMDataBase执行查询后的结果集

FMDataBaseQueue

作用:用于在多线程中执行多个查询或者更新, 它是线程安全的:

FMDB的简单使用

通过SQLite数据库文件路径来创建FMDataBase对象

通过指定SQLite数据库文件路径来创建FMDatabase对象

打开数据库

FMDatabase *db = [FMDatabase databaseWithPath:path];
if (![db open]) {
NSLog(@"数据库打开失败！");
}

文件路径有三种情况
（1）具体文件路径
　　如果不存在会自动创建

（2）空字符串@""
　　会在临时目录创建一个空的数据库
　　当FMDatabase连接关闭时，数据库文件也被删除

（3）nil
　　会创建一个内存中临时数据库，当FMDatabase连接关闭时，数据库会被销毁

执行操作

打开数据库
//1 获取数据库文件路径
NSString *document  = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).lastObject;
NSString *fileName = [document stringByAppendingPathComponent:@"stu.sqlite"];
//2 获取数据库
FMDatabase *dataBase = [FMDatabase databaseWithPath:fileName];
//3 打开数据库
if ([dataBase open]) {
//4 创建表
BOOL result = [dataBase executeUpdate:@"create table if not exists t_student(id integer primary key autoinerement, name text not null , age integer not null)"];
if (result) {
NSLog(@"YES");
self.database = dataBase;
}else
{
NSLog(@"NO");
}
}

插入数据
NSString *name = [NSString stringWithFormat:@"%d",arc4random() % 10];
[self.database executeUpdate:@"insert into t_student (name, age) value(?,?);",name,@(arc4random_uniform(40))];

删除数据
BOOL result = [self.databaseexecuteUpdate:@"delete from t_student where name=4"];
NSLog(@"%d",result);

修改数据
BOOL result = [self.databaseexecuteUpdate:@"update t_student set name='ICE' where name = 3"];
NSLog(@"%d",result);

查询数据
FMResultSet *resultSet = [self.databaseexecuteQuery:@"select * from t_student"];
//便利结果
while ([resultSet next]) {
NSString *name = [resultSet stringForColumn:@"name"];
int age = [resultSet intForColumn:@"age"];
NSLog(@"%@\n%d",name,age);
}

MJRefresh

MKNetworkKit

MKNetworkKit 是一个使用十分方便，功能又十分强大、完整的iOS网络编程代码库，完全基于 ARC。它只有两个类, 它的目标是使用像AFNetworking这么简单，而功能像ASIHTTPRequest(已经停止维护)那么强大。

优点

1、高度的轻量级，仅仅只有2个主类；

2、自主操作多个网络请求；

3、更加准确的显示网络活动指标；

4、自动设置网络速度，实现自动的2G、3G、wifi切换；

5、自动缓冲技术的完美应用，实现网络操作记忆功能，当你掉线了又上线后，会继续执行未完成的网络请求；

6、可以实现网络请求的暂停功能；

7、准确无误的成功执行一次网络请求，摒弃后台的多次请求浪费；

8、支持图片缓冲；

9、支持ARC机制；

10、在整个app中可以只用一个队列（queue），队列的大小可以自动调整。

使用介绍

MKNetworkKit中主要有两个类：MKNetworkOperation和MKNetworkEngine。MKNetworkOperation是NSOperation的子类并且封装了请求相应类，我们需要为每一个网络请求创建一个MKNetworkOperation。MKNetworkEngine负责管理网络队列，对于简单的请求，我们应该直接使用MKNetworkEngine的方法，对于复杂的需求，我们可以子类化MKNetworkEngine。下面就介绍基本的网络实现，其中包括GET请求和POST请求：

如何实现请求

MKNetworkEngine *engine = [[MKNetworkEngine alloc] initWithHostName:@"www.***.net" customHeaderFields:nil];

MKNetworkOperation *op = [engine operationWithPath:@"json/conn.asp?id=235" params:nil httpMethod:@"GET"];

[op addCompletionHandler:^(MKNetworkOperation *completedOperation) {

NSLog(@"%@",[completedOperation responseString]);

} errorHandler:^(MKNetworkOperation *completedOperation, NSError *error) {

}];

MKNetworkEngine *engine = [[MKNetworkEngine alloc] initWithHostName:@"192.168.2.176:9502/api" customHeaderFields:nil];

NSMutableDictionary *dic = [[NSMutableDictionary alloc] init];

[dic setValue:@"admin" forKey:@"username"];

[dic setValue:@"123" forKey:@"password"];

MKNetworkOperation *op = [engine operationWithPath:@"user.do" params:dic httpMethod:@"POST"];

[op addCompletionHandler:^(MKNetworkOperation *completedOperation) {

NSLog(@"%@",[completedOperation responseString]);

} errorHandler:^(MKNetworkOperation *completedOperation, NSError *error) {

}];

MBProgressHUD

MBProgressHUD 是一个现实HUD窗口的第三方类库, 用于执行一些后台任务时, 在程序中显示一个进度的koading视图和两个可选的文本提示的HUD窗口. 我想最多是应用在加载网络数据的时候。其实苹果官方自己有一个带有此功能的类UIProgressHUD，只不过它是私有的，现在不让用。至于实际的效果，可以看看github上工程给出的几张图例(貌似我这经常无法单独打开图片，所以就不在这贴图片了)，也可以运行一下Demo。
具体用法我们就不多说了，参考github上的说明就能用得很顺的。本文主要还是从源码的角度来分析一下它的具体实现。

//方式1.直接在View上show
HUD = [[MBProgressHUD showHUDAddedTo:self.view animated:YES] retain];
HUD.delegate = self;

//常用的设置
//小矩形的背景色
HUD.color = [UIColor clearColor];//这儿表示无背景
//显示的文字
HUD.labelText = @"Test";
//细节文字
HUD.detailsLabelText = @"Test detail";
//是否有庶罩
HUD.dimBackground = YES;
[HUD hide:YES afterDelay:2];

//只显示文字
MBProgressHUD *hud = [MBProgressHUD showHUDAddedTo:self.view animated:YES];
hud.mode = MBProgressHUDModeText;
hud.labelText = @"Some message...";
hud.margin = 10.f;
hud.yOffset = 150.f;
hud.removeFromSuperViewOnHide = YES;
[hud hide:YES afterDelay:3];

//方式2.initWithView
//use block
HUD = [[MBProgressHUD alloc] initWithView:self.view];
[self.view addSubview:HUD];
HUD.labelText = @"Test";
[HUD showAnimated:YES whileExecutingBlock:^{
NSLog(@"%@",@"do somethings....");
[self doTask];
} completionBlock:^{
[HUD removeFromSuperview];
[HUD release];
}];

//圆形进度条
HUD = [[MBProgressHUD alloc] initWithView:self.view];
[self.view addSubview:HUD];
HUD.mode = MBProgressHUDModeAnnularDeterminate;
HUD.delegate = self;
HUD.labelText = @"Loading";
[HUD showWhileExecuting:@selector(myProgressTask) onTarget:self withObject:nil animated:YES];

//自定义view
HUD = [[MBProgressHUD alloc] initWithView:self.view];
HUD.customView = [[[UIImageView alloc] initWithImage:[UIImage imageNamed:@"37x-Checkmark.png"]] autorelease];
// Set custom view mode
HUD.mode = MBProgressHUDModeCustomView;
HUD.delegate = self;
HUD.labelText = @"Completed";
[HUD show:YES];
[HUD hide:YES afterDelay:3];
代理方法：

[cpp] view plaincopy
#pragma mark -
#pragma mark HUD的代理方法,关闭HUD时执行
-(void)hudWasHidden:(MBProgressHUD *)hud
{
[hud removeFromSuperview];
[hud release];
hud = nil;
}
二个task

[cpp] view plaincopy
-(void) doTask{
//你要进行的一些逻辑操作
sleep(2);
}

-(void) myProgressTask{
float progress = 0.0f;
while (progress < 1.0f) {
progress += 0.01f;
HUD.progress = progress;
usleep(50000);
}

}