NSURLConnection 下载数据

iPhone网络开发中如何使用NSURLConnection是本文要介绍的内容,这篇文章是翻译的苹果官方文档,想要看英文原版的可以到苹果网站查看,来看详细内容。

 

NSURLConnection 提供了很多灵活的方法下载URL内容也提供了一个简单的接口去创建和放弃连接,同时使用很多的delegate方法去支持连接过程的反馈和控制

 

如何创建一个连接呢?

 

为了下载url的内容,程序需要提供一个delegate对象,并且至少实现下面的方法

C代码   收藏代码
  1. - (void)connection:(NSURLConnection*)connection didReceiveResponse:(NSHTTPURLResponse*)response  
  2. - (void)connection:(NSURLConnection*)connection didReceiveData:(NSData*)data  
  3. - (void)connection:(NSURLConnection*)connection didFailWithError:(NSError*)error  
  4. - (void)connectionDidFinishLoading:(NSURLConnection *)connection  

 

NSURLConnect还提供了一个方便的类方法(class method) : sendSynchronousRequest:returningResponse:error: 可用来 同步地加载一个URL请求

C代码   收藏代码
  1. + (NSData *)sendSynchronousRequest:    (NSURLRequest *)request      returningResponse:   (NSURLResponse **)response    error:  (NSError **)error  
 

1. request 要装载的URL请求. 这个request 对象 作为初始化进程的一部分,被深度复制(deep-copied). 在这个方法返回之后, 再修改request, 将不会影响用在装载的过程中的request

2. reponse 输出参数, 由服务器返回的URL响应

3. error   输出参数, 如果在处理请求的过程中发生错误,就会使用.  无错误,就为NULL

 

举例一

 

1、先创建一个NSURL

2、在通过NSURL创建NSURLRequest,可以指定缓存规则和超时时间

3、创建NSURLConnection实例,指定NSURLRequest和一个delegate对象

 

如果创建失败,则会返回nil,如果创建成功则创建一个NSMutalbeData的实例用来存储数据

 

代码:

C代码   收藏代码
  1. NSURLRequest *theRequest=[NSURLRequest requestWithURL:    
  2.                   [NSURL URLWithString:@“http://www.sina.com.cn/”]    
  3.                  cachePolicy:NSURLRequestUseProtocolCachePolicy    
  4.                  timeoutInterval:60.0];    
  5. NSURLConnection *theConncetion=[[NSURLConnection alloc]         
  6.                    initWithRequest:theRequest delegate:self];    
  7. if(theConnection)    
  8. {    
  9. //创建NSMutableData    
  10.   receivedData=[[NSMutableData data] retain];    
  11. }else // 创建失败   

 

C代码   收藏代码
  1. NSURLRequestUseProtocolCachePolicy //NSURLRequest默认的cache policy, 是最能保持一致性的协议。  
  2. NSURLRequestReloadIgnoringCacheData  //忽略缓存直接从原始地址下载  
  3. NSURLRequestReturnCacheDataElseLoad  //只有在cache中不存在data时才从原始地址下载  
  4. NSURLRequestReturnCacheDataDontLoad  //允许app确定是否要返回cache数据,如果使用这种协议当本地不存在response的时候,创建NSURLConnection or NSURLDownload实例时将会马上返回nil;这类似于离线模式,没有建立网络连接;  
 

NSURLConnection还有几个初始化函数,有个初始化函数可以做到创建连接但是并不马上开始下载,而是通过start:开始

 

当收到initWithRequest: delegate: 消息时,下载会立即开始,在代理(delegate)收到connectionDidFinishLoading:或者 connection:didFailWithError:消息之前可以通过给连接发送一个cancel:消息来中断下载。

 

当服务器提供了足够客户程序创建NSURLResponse对象的信息时,代理对象会收到一个connection:didReceiveResponse:消息,在消息内可以检查NSURLResponse对象和确定数据的预期长途,mime类型,文件名以及其他服务器提供的元信息

 

要注意,一个简单的连接也可能会收到多个connection:didReceiveResponse:消息当服务器连接重置或者一些罕见的原因(比如多组mime文档),代理都会收到该消息这时候应该重置进度指示,丢弃之前接收的数据

C代码   收藏代码
  1. -(void)connection:(NSURLConnection *) connectiondidReceiveResponse:    
  2.                         (NSURLResponse*)response    
  3. {   
  4.    [receiveData setLength:0];    
  5. }  
 

当下载开始的时候,每当有数据接收,代理会定期收到connection:didReceiveData:消息代理应当在实现中储存新接收的数据,下面的例子既是如此

C代码   收藏代码
  1. -(void) connection:(NSURLConnection *) connection didReceiveData:    
  2.             (NSData *) data    
  3. {    
  4.    [receiveData appendData:data];    
  5.   
  6. }   
 

在上面的方法实现中,可以加入一个进度指示器,提示用户下载进度

 

当下载的过程中有错误发生的时候,代理会收到一个connection:didFailWithError消息,消息参数里面的NSError对象提供了具体的错误细节,它也能提供在用户信息字典里面失败的url请求(使用NSErrorFailingURLStringKey)

 

当代理接收到连接的connection:didFailWithError消息后,对于该连接不会在收到任何消息

 

举例

C代码   收藏代码
  1. -(void)connection:(NSURLConnection *)connection didFailWithError:(NSError *)error    
  2. {   
  3. [connection release];    
  4.   
  5.   [receivedData release];    
  6.    NSLog(@"Connection failed! Error - %@ %@",    
  7.           [error localizedDescription],    
  8.           [[error userInfo] objectForKey:NSErrorFailingURLStringErrorKey]);    
  9. }  
 

最后,如果连接请求成功的下载,代理会接收connectionDidFinishLoading:消息代理不会收到其他的消息了,在消息的实现中,应该释放掉连接

 

举例:

C代码   收藏代码
  1. -(void)connectionDidFinishLoading:(NSURLConnection *)connection    
  2. {  
  3.    //do something with the data    
  4.   NSLog(@"succeeded  %d byte received",[receivedData length]);   
  5.   
  6. [connection release];    
  7. [receivedData release];    
  8. }  
 

一个实现异步get请求的例子:

C代码   收藏代码
  1. NSString *url = [NSString stringWithFormat:@"http://localhost/chat/messages.php?past=%ld&t=%ld",  
  2.                      lastId, time(0) ];  
  3.       
  4.     NSMutableURLRequest *request = [[[NSMutableURLRequest alloc] init] autorelease];  
  5.     [request setURL:[NSURL URLWithString:url]];  
  6.     [request setHTTPMethod:@"GET"];  
  7.   
  8.     NSURLConnection *conn=[[NSURLConnection alloc] initWithRequest:request delegate:self];    
  9.     if (conn)  
  10.     {    
  11.         receivedData = [[NSMutableData data] retain];    
  12.     }     
  13.     else     
  14.     {    
  15.     }   
  16.   
  17. - (void)timerCallback {  
  18.     //[timer release];  
  19.     [self getNewMessages];  
  20. }  
  21.   
  22. - (void)connection:(NSURLConnection *)connection didReceiveResponse:(NSURLResponse *)response    
  23. {    
  24.     [receivedData setLength:0];    
  25. }    
  26.   
  27. - (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data    
  28. {    
  29.     [receivedData appendData:data];    
  30. }    
  31.   
  32. - (void)connectionDidFinishLoading:(NSURLConnection *)connection    
  33. {    
  34.     if (chatParser)  
  35.         [chatParser release];  
  36.       
  37.     if ( messages == nil )  
  38.         messages = [[NSMutableArray alloc] init];  
  39.   
  40.     chatParser = [[NSXMLParser alloc] initWithData:receivedData];  
  41.     [chatParser setDelegate:self];//set the delegate  
  42.     [chatParser parse];//start parse  
  43.   
  44.     [receivedData release];    
  45.       
  46.     [messageList reloadData];  
  47.       
  48.     NSInvocation *invocation = [NSInvocation invocationWithMethodSignature:  
  49.                                     [self methodSignatureForSelector: @selector(timerCallback)]];  
  50.     [invocation setTarget:self];  
  51.     [invocation setSelector:@selector(timerCallback)];  
  52.     //timer = [NSTimer scheduledTimerWithTimeInterval:5.0 invocation:invocation repeats:NO];  
  53.     [NSTimer scheduledTimerWithTimeInterval:5.0 invocation:invocation repeats:NO];//if set yes,then very 5 seconds updata the table  
  54. }   
 

一个实现同步Get请求的例子:

C代码   收藏代码
  1. // 初始化请求  
  2. NSMutableURLRequest *request = [[NSMutableURLRequest alloc] init];           
  3. // 设置URL  
  4. [request setURL:[NSURL URLWithString:urlStr]];  
  5. // 设置HTTP方法  
  6. [request setHTTPMethod:@"GET"];  
  7. // 发 送同步请求, 这里得returnData就是返回得数据了  
  8. NSData *returnData = [NSURLConnection sendSynchronousRequest:request   
  9.                                                returningResponse:nil error:nil];   
  10. // 释放对象  
  11. [request release];  
 

 

来源:

http://mobile.51cto.com/iphone-281460.htm

http://blog.csdn.net/bl1988530/article/details/6590099


转载自:http://justcoding.iteye.com/blog/1474177   天梯梦

你可能感兴趣的:(obj-c)