关于 ASINetworkQueues

ASINetworkQueues提供了一些额外的委托方法selector。

requestDidStartSelector

每当队列中的一个请求开始运行时调用。你可以使用这个作为didStartSelector的替代方法

为你加到队列的请求设置一个委托。

requestDidReceiveResponseHeadersSelector

每当队列中的一个请求从服务器得到响应头时调用。对于大的下载,这个selector有时在请求实际完成前执行。

你可以使用它作为对didReceiveResponseHeadersSelector的替代。

requestDidFinishSelector

每当队列中的一个请求完成时调用。可以使用它作为对didFinishSelector的替代。

requestDidFailSelector

每当队列中的请求失败时调用,可作为didFailSelector的替代。

queueDidFinishSelector

当队列完成时调用,不管单个请求成功或失败。

使用以上selector,要将队列的委托,而不是请求的委托,设置到实现这些 selector所代表的方法的控制器。

ASINetworkQueues工作起来和NSOperationQueues稍有不同,加到其中的请求不会立刻运行,当使用ASINetworkQueue时,添加你想运行的所有请求,然后调用[queuego]。当你启动一个队列,将精确进度(accurateprogress)打开时,他会首先为队列中所有的 get请求执行一个head请求,来得到将要下载数据的总体尺寸。获得此数据后,它就能准确的显示总体进度,然后真实的请求才会开始。

问题:当你向一个运行中的ASINetworkQueue加入一个请求时发生了什么事情?

回答:如果你使用ASINetworkQueue来追踪几个请求的总体进度,整体进度只会在哪个请求开始执行时,才会将它计算在内。ASINetworkQueue 不会在运行中,当加入请求后执行head请求,所以如果你立刻向运行的队列加入许多请求,总体进度不会立刻更新。如果队列已经运行,你不需要再次调用[queuego]。当ASINetworkQueue中的一个请求失败,队列默认的将取消所有其他的请求。你可以调用[queue setShouldCancelAllRequestsOnFailure:NO].来关闭这一行为。ASINetworkQueues只能执行ASIHTTPRequest操作,而不能用于一般操作,尝试添加一个非ASIHTTPRequest的NSOperation将产生一个异常。

提示:这里有一个创建和使用ASINetworkQueue的完整例子: 

//
//  MyController.h
//
//  Created by Ben Copsey on 20/07/2009.
//  Copyright 2009 All-Seeing Interactive. All rights reserved.
//

#import <Foundation/Foundation.h>
#import <GHUnit/GHUnit.h>
@class ASINetworkQueue;

@interface MyController : NSObject {
	ASINetworkQueue *networkQueue;
	
}

- (void)doNetworkOperations;

@property (retain) ASINetworkQueue *networkQueue;

@end

-------------------------------------------------------------------

//
//  MyController.m
//
//  Created by Ben Copsey on 20/07/2009.
//  Copyright 2009 All-Seeing Interactive. All rights reserved.
//

#import "MyController.h"
#import "ASIHTTPRequest.h"
#import "ASINetworkQueue.h"

@implementation MyController

- (void)dealloc
{
	[networkQueue release];
	[super dealloc];
}

- (void)doNetworkOperations
{
	// Stop anything already in the queue before removing it
	[[self networkQueue] cancelAllOperations];
	
	// Creating a new queue each time we use it means we don't have to worry about clearing delegates or resetting progress tracking
	[self setNetworkQueue:[ASINetworkQueue queue]];
	[[self networkQueue] setDelegate:self];
	[[self networkQueue] setRequestDidFinishSelector:@selector(requestFinished:)];
	[[self networkQueue] setRequestDidFailSelector:@selector(requestFailed:)];
	[[self networkQueue] setQueueDidFinishSelector:@selector(queueFinished:)];

	int i;
	for (i=0; i<5; i++) {
		ASIHTTPRequest *request = [ASIHTTPRequest requestWithURL:[NSURL URLWithString:@"http://allseeing-i.com"]];
		[[self networkQueue] addOperation:request];
	}
	 
	[[self networkQueue] go];
}
	
- (void)requestFinished:(ASIHTTPRequest *)request
{
	// You could release the queue here if you wanted
	if ([[self networkQueue] requestsCount] == 0) {

		// Since this is a retained property, setting it to nil will release it
		// This is the safest way to handle releasing things - most of the time you only ever need to release in your accessors
		// And if you an Objective-C 2.0 property for the queue (as in this example) the accessor is generated automatically for you
		[self setNetworkQueue:nil]; 
	}
	
	//... Handle success
	NSLog(@"Request finished");
}

- (void)requestFailed:(ASIHTTPRequest *)request
{
	// You could release the queue here if you wanted
	if ([[self networkQueue] requestsCount] == 0) {
		[self setNetworkQueue:nil]; 
	}
	
	//... Handle failure
	NSLog(@"Request failed");
}


- (void)queueFinished:(ASINetworkQueue *)queue
{
	// You could release the queue here if you wanted
	if ([[self networkQueue] requestsCount] == 0) {
		[self setNetworkQueue:nil]; 
	}
	NSLog(@"Queue finished");
}

@synthesize networkQueue;
@end