第三方苹果开发库之ASIHTTPRequest（翻译版）

在服务器请求凭据前向服务器发送凭据

[requestsetAuthenticationScheme:(NSString*)kCFHTTPAuthenticationSchemeBasic];

[requestsetShouldPresentCredentialsBeforeChallenge:NO];

ASIHTTPRequest-HTTP授权-流程图

ASIHTTPRequest-Cookie的使用

持久化cookie

[ASIHTTPRequestsetSessionCookies:nil];

自己处理cookie

//创建一个cookie
NSDictionary*properties=[[[NSMutableDictionaryalloc]init]autorelease];
[propertiessetValue:[@"TestValue"encodedCookieValue]forKey:NSHTTPCookieValue];
[propertiessetValue:@"ASIHTTPRequestTestCookie"forKey:NSHTTPCookieName];
[propertiessetValue:@".dreamingwish.com"forKey:NSHTTPCookieDomain];
[propertiessetValue:[NSDatedateWithTimeIntervalSinceNow:60*60]forKey:NSHTTPCookieExpires];
[propertiessetValue:@"/asi-http-request/tests"forKey:NSHTTPCookiePath];
NSHTTPCookie*cookie=[[[NSHTTPCookiealloc]initWithProperties:properties]autorelease];//这个url会返回名为'ASIHTTPRequestTestCookie'的cookie的值
url=[NSURLURLWithString:@"http://www.dreamingwish.com/"];
request=[ASIHTTPRequestrequestWithURL:url];
[requestsetUseCookiePersistence:NO];
[requestsetRequestCookies:[NSMutableArrayarrayWithObject:cookie]];
[requeststartSynchronous];//将会打印:Ihave'TestValue'asthevalueof'ASIHTTPRequestTestCookie'
NSLog(@"%@",[requestresponseString]);

ASIHTTPRequest-数据压缩

使用gzip来处理压缩的响应数据

怎样设置apache的mod_deflate来使用gzip压缩数据

在ASIHTTPRequest中使用gzip

-(IBAction)grabURL:(id)sender
{
NSURL*url=[NSURLURLWithString:@"http://www.dreamingwish.com"];
ASIHTTPRequest*request=[ASIHTTPRequestrequestWithURL:url];
//默认为YES,你可以设定它为NO来禁用gzip压缩
[requestsetAllowCompressedResponse:YES];
[requeststartSynchronous];
BOOL*dataWasCompressed=[requestisResponseCompressed];//响应是否被gzip压缩过？
NSData*compressedResponse=[requestrawResponseData];//压缩的数据
NSData*uncompressedData=[requestresponseData];//解压缩后的数据
NSString*response=[requestresponseString];//解压缩后的字符串
}

相应数据的实时解压缩

使用gzip压缩request数据

ASIHTTPRequest-断点续传（下载）

-(IBAction)resumeInterruptedDownload:(id)sender
{
NSURL*url=[NSURLURLWithString:
@"http://www.dreamingwish.com/wp-content/uploads/2011/10/asihttprequest-auth.png"];
ASIHTTPRequest*request=[ASIHTTPRequestrequestWithURL:url];NSString*downloadPath=@"/Users/ben/Desktop/asi.png";//当request完成时，整个文件会被移动到这里
[requestsetDownloadDestinationPath:downloadPath];//这个文件已经被下载了一部分
[requestsetTemporaryFileDownloadPath:@"/Users/ben/Desktop/asi.png.download"];
[requestsetAllowResumeForFileDownloads:YES];
[requeststartSynchronous];//整个文件将会在这里
NSString*theContent=[NSStringstringWithContentsOfFile:downloadPath];
}

ASIHTTPRequest-直接读取磁盘数据流的请求体

ASIFormDataRequests

NSURL*url=[NSURLURLWithString:@"http://www.dreamingwish.com/"];
ASIFormDataRequest*request=[ASIFormDataRequestrequestWithURL:url];
[requestsetPostValue:@"foo"forKey:@"post_var"];
[requestsetFile:@"/Users/ben/Desktop/bigfile.txt"forKey:@"file"];
[requeststartSynchronous];

普通ASIHTTPRequest

[requestsetShouldStreamPostDataFromDisk:YES];

NSURL*url=[NSURLURLWithString:@"http://www.dreamingwish.com/"];
ASIHTTPRequest*request=[ASIHTTPRequestrequestWithURL:url];
[requestsetShouldStreamPostDataFromDisk:YES];
[requestappendPostData:myBigNSData];
[requestappendPostDataFromFile:@"/Users/ben/Desktop/bigfile.txt"];
[requeststartSynchronous];

NSURL*url=[NSURLURLWithString:@"http://www.dreamingwish.com"];
ASIHTTPRequest*request=[ASIHTTPRequestrequestWithURL:url];
[requestsetRequestMethod:@"PUT"];
[requestsetPostBodyFilePath:@"/Users/ben/Desktop/another-big-one.txt"];
[requestsetShouldStreamPostDataFromDisk:YES];
[requeststartSynchronous];

ASIHTTPRequest-使用downloadcache

[ASIHTTPRequestsetDefaultCache:[ASIDownloadCachesharedCache]];

ASIHTTPRequest*request=[ASIHTTPRequestrequestWithURL:url];
[requestsetDownloadCache:[ASIDownloadCachesharedCache]];

ASIDownloadCache*cache=[[[ASIDownloadCachealloc]init]autorelease];
[cachesetStoragePath:@"/Users/ben/Documents/Cached-Downloads"];//别忘了-你必须自己retaining你自己的cache!
[selfsetMyCache:cache];ASIHTTPRequest*request=[ASIHTTPRequestrequestWithURL:url];
[requestsetDownloadCache:[selfmyCache]];

cache策略

//每次都向服务器询问是否有新的内容可用，
//如果请求失败,使用cache的数据，即使这个数据已经过期了
[requestsetCachePolicy:ASIAskServerIfModifiedCachePolicy|ASIFallbackToCacheIfLoadFailsCachePolicy];

存储策略

ASIHTTPRequest*request=[ASIHTTPRequestrequestWithURL:url];
[requestsetCacheStoragePolicy:ASICachePermanentlyCacheStoragePolicy];

[[ASIDownloadCachesharedCache]clearCachedResponsesForStoragePolicy:ASICachePermanentlyCacheStoragePolicy];

其他cache相关的特性

//当你关闭shouldRespectCacheControlHeaders,cache对象会存储响应数据，而无视
//服务器的显式“请勿缓存”声明(例如：cache-control或者pragma:no-cache头)
[[ASIDownloadCachesharedCache]setShouldRespectCacheControlHeaders:NO];//可以设定request的secondsToCache来覆盖服务器设定的内容有效期,这时，响应数据
//会一直被缓存，直到经过secondsToCache秒
ASIHTTPRequest*request=[ASIHTTPRequestrequestWithURL:url];
[requestsetSecondsToCache:60*60*24*30];//缓存30天//当request开始执行后,如果响应数据是从缓存中取得的，didUseCachedResponse会返回YES
[requestdidUseCachedResponse];//向cache对象索取一个路径来存储相应数据.这是使用downloadcache的最有效率的方法,
//因为此时，当request完成后，数据不需要被复制到cache中.
[requestsetDownloadDestinationPath:
[[ASIDownloadCachesharedCache]pathToStoreCachedResponseDataForRequest:request]];

编写自己的cache

ASIHTTPRequest-流量控制

//这将会对WWAN连接下的request进行流量控制（控制到预定义的值）
//Wi-Fi连接下的request不会受影响
//这个方法仅在iOS上可用
[ASIHTTPRequestsetShouldThrottleBandwidthForWWAN:YES];//这将会对WWAN连接下的request进行流量控制（控制到自定义的值）
//这个方法仅在iOS上可用
[ASIHTTPRequestthrottleBandwidthForWWANUsingLimit:14800];//这将会控移动应用（mobileapplications）的流量到预定义的值.
//会限制所有requests,不管request是不是WiFi连接下的-使用时要注意
[ASIHTTPRequestsetMaxBandwidthPerSecond:ASIWWANBandwidthThrottleAmount];//记录每秒有多少字节的流量(过去5秒内的平均值)
NSLog(@"%qi",[ASIHTTPRequestaverageBandwidthUsedPerSecond]);

ASIHTTPRequest-客户端证书支持

有时服务器要求提供客户端证书，从1.8版本开始，你可以随request发送证书。

//Willsendthecertificateattachedtotheidentity(identityisaSecIdentityRef)
[requestsetClientCertificateIdentity:identity];//Addanadditionalcertificate(wherecertisaSecCertificateRef)
[requestsetClientCertificates:[NSArrayarrayWithObject:(id)cert]];

ASIHTTPRequest-使用代理连接

//手动设置代理服务器
NSURL*url=[NSURLURLWithString:@"http://www.dreamingwish.com"];
ASIHTTPRequest*request=[ASIHTTPRequestrequestWithURL:url];
[requestsetProxyHost:@"192.168.0.1"];
[requestsetProxyPort:3128];//另一种方法,使用代理配置脚本文件
//(最好使用本地pac文件)
[requestsetPACurl:[NSURLURLWithString:@"path/to/test.pac"]];

要求授权的proxy

手动为proxy指定凭据

NSURL*url=[NSURLURLWithString:@"http://www.dreamingwish.com"];
ASIHTTPRequest*request=[ASIHTTPRequestrequestWithURL:url];
[requestsetProxyHost:@"192.168.0.1"];
[requestsetProxyPort:3128];//为要求授权的proxy设置username和password
[requestsetProxyUsername:@"bencopsey"];
[requestsetProxyPassword:@"password"];//对于NTLMproxy,还要设置domain(NTLMproxy功能是未经测试的)
[requestsetProxyDomain:@"la.la.land"];

使用delegate来提供proxy凭据

[ASIHTTPRequestsetDefaultUserAgentString:@"MyApp1.0"]

[requestsetUserAgent:@"MyApp1.0"]

//iOS4以上
[requestsetShouldContinueWhenAppEntersBackground:YES];

//记录过去5秒的平均流量字节/秒
NSLog(@"%llu",[ASIHTTPRequestaverageBandwidthUsedPerSecond]);if([ASIHTTPRequestisNetworkInUse]){
//ASIHTTPRequest进程中有requests正在使用网络
}

[ASIHTTPRequestsetShouldUpdateNetworkActivityIndicator:NO];

[requestsetNumberOfTimesToRetryOnTimeout:2];

[requestsetRequestMethod:@"PUT"];
[requestsetShouldAttemptPersistentConnection:YES];

//设置持久连接的超时时间为120秒
[requestsetPersistentConnectionTimeoutSeconds:120];//彻底禁用持久连接
[requestsetShouldAttemptPersistentConnection:NO];

[requestsetUseHTTPVersionOne:YES];

[requestsetValidatesSecureCertificate:NO];