three20 教程 学习笔记 three20 NetWork 详解

//作者：禚来强 iphone开发qq群：79190809 邮箱：[email protected]
还是老规矩我比较喜欢贴代码：

void TTNetworkRequestStarted();//开始状态栏小飞轮

void TTNetworkRequestStopped();//停止状态栏小飞轮

#define TTIMAGE(_URL) [[TTURLCache sharedCache] imageForURL:_URL]//缓冲中提取图片，没有就去网络下载


缓存方案
typedef enum {
  TTURLRequestCachePolicyNone    = 0,
  TTURLRequestCachePolicyMemory  = 1,
  TTURLRequestCachePolicyDisk    = 2,
  TTURLRequestCachePolicyNetwork = 4,
  TTURLRequestCachePolicyNoCache = 8,
  TTURLRequestCachePolicyEtag    = 16 | TTURLRequestCachePolicyDisk,
  TTURLRequestCachePolicyLocal
  = (TTURLRequestCachePolicyMemory | TTURLRequestCachePolicyDisk),
  TTURLRequestCachePolicyDefault
  = (TTURLRequestCachePolicyMemory | TTURLRequestCachePolicyDisk
     | TTURLRequestCachePolicyNetwork),
} TTURLRequestCachePolicy;


这个在我的博客里已经要单独的文章详解过了，http://blog.csdn.net/diyagoanyhacker/archive/2011/05/05/6396524.aspx

网络链接的主要的一个类：TTURLRequest.相当于ios的NSUrlRequest

#import <Foundation/Foundation.h>

@interface TTURLRequest : NSObject 

@property (nonatomic, copy) NSString* urlPath;//网络请求的Url

@property (nonatomic, copy) NSString* URL __TTDEPRECATED_METHOD;//和上边那个是一样的。老外真麻烦 用两个 呵呵

@property (nonatomic, copy) NSString* httpMethod;//http请求的方法

@property (nonatomic, retain) id<TTURLResponse> response;//这个就是接收数据的对象

@property (nonatomic, retain) NSData* httpBody; //这个是postBody

@property (nonatomic, copy) NSString* contentType;如果是post或者put的时候这个对象才会被填充 默认为multipart/form-data

@property (nonatomic, readonly) NSMutableDictionary* parameters;//POST/PUT 的参数就是key 和 value

@property (nonatomic, readonly) NSMutableDictionary* headers;//http请求头

@property (nonatomic) TTURLRequestCachePolicy cachePolicy;//缺省为TTURLRequestCachePolicyDefault 这个在上面已经提到了

@property (nonatomic) NSTimeInterval cacheExpirationAge;//提取缓存的时间默认为一个星期 也就是说在缓存中超过一个星期的就会被重新下载

@property (nonatomic, copy) NSString* cacheKey;//这个是http缓存标志Etag的key Etag在我的博客也有介绍
http://blog.csdn.net/diyagoanyhacker/archive/2011/05/05/6397036.aspx

作者：禚来强 emal：[email protected] gtalk：[email protected]

@property (nonatomic, retain) id userInfo;

@property (nonatomic, retain) NSDate* timestamp;

@property (nonatomic) BOOL isLoading;//当前是否正在进行网络链接

@property (nonatomic) BOOL shouldHandleCookies;//这里是关于coockie的设置。默认为yes。就是储存和发送coockies。no则相反

@property (nonatomic) NSInteger totalBytesLoaded;//这次请求加载的字节数

@property (nonatomic) NSInteger totalBytesExpected;

@property (nonatomic) NSInteger totalBytesDownloaded;//从服务器上现在文件的字节数

@property (nonatomic) NSInteger totalContentLength;//这次请求内容的长度，就是字数

@property (nonatomic) BOOL respondedFromCache;//这次网络请求的资源，是否来自缓存

@property (nonatomic, assign) BOOL filterPasswordLogging;

@property (nonatomic) NSStringEncoding charsetForMultipart;//当使用multipart/form-data data发送请求的时候，数据的编码方式

@property (nonatomic, readonly) NSMutableArray* delegates;//网络请求的代理类。具体可以进去看一下，很简单，就一个代理方法


+ (TTURLRequest*)request;//类方法，这个不用我说了吧，大家都应该明白 呵呵

+ (TTURLRequest*)requestWithURL:(NSString*)URL delegate:(id /*<TTURLRequestDelegate>*/)delegate;//同上

- (id)initWithURL:(NSString*)URL delegate:(id /*<TTURLRequestDelegate>*/)delegate;//同上

- (void)setValue:(NSString *)value forHTTPHeaderField:(NSString *)field;//设置请求头

- (void)addFile:(NSData*)data mimeType:(NSString*)mimeType fileName:(NSString*)fileName;//发送二进制文件

- (BOOL)send;//发送异步请求，如果返回为yes，表示此次请求的资源来自缓存

- (BOOL)sendSynchronously;//发送同请求

- (void)cancel;//退出网络链接，呵呵 挺有用哈

- (NSURLRequest*)createNSURLRequest;//同上

@end

作者：禚来强 emal：[email protected] gtalk：[email protected]

按照three20 TTNetWorkDemo工程里的目录，下一个目录应该是Responses
在这个文件夹里有两个类，分别是TTURLDataResponse TTURLImageResponse 这两个类其实很简单，就实现了了一个协议方法。这两个类是为前面提到的TTURLRequest的属性responses准备的。

作者：禚来强 email：[email protected]

接下来是requests文件夹里面有很多文件和文件夹 
首先说TTURLRequestDelegate.h：这个文件里定义了一个协议。这个协议和ios里NSUrlRequest的delegate差不多，方法和方法名称很相似。大家可以自己看一下。如果再写这个我感觉意义不大
接下来是TTURLRequestCachePolicy.h这个文件里定义了一个结构体，这个结构提是为TTUrlRequest的cacheKey准备的至于这个结构提的用法在我的博客http://blog.csdn.net/diyagoanyhacker/archive/2011/05/05/6396524.aspx中有专门详细的介绍。

更新中

接下来是一个比较重要的类，说他重要是因为他扮演着ios中线程池或者线程队列的角色，还句话说就是这个类是app中所有的网络链接的管理者。厉害吧！

@interface TTURLRequestQueue : NSObject 

@property (nonatomic) BOOL suspended;//是否接受新的网络链接，如果是no，则新的网络链接请求被吊起，直到他yes。因为网络链接会降低手机的性能，所以three20给我们提供了可以控制的借口

@property (nonatomic) NSUInteger maxContentLength;//最大网络下载数据的长度，默认为150000 bytes。这是为了防止过多的占用内存。其实我们有更好的办法防止这样的事情发生。如果需要发邮件联系我。

@property (nonatomic, copy) NSString* userAgent;//设置http请求的user-Agent头：它是一个特殊字符串头，使得服务器能够识别客户使用的操作系统及版本、CPU 类型、浏览器及版本、浏览器渲染引擎、浏览器语言、浏览器插件等。如果在这里设置了，则所有的请求都会使用。

@property (nonatomic) CGFloat imageCompressionQuality;//压缩图片的系数，默认为0.75.这种压缩是影响分辨率的。应谨慎设置！

+ (TTURLRequestQueue*)mainQueue;//得到共享的TTURLRequestQueue。TTUrlRequest都会加入这里面。

+ (void)setMainQueue:(TTURLRequestQueue*)queue;设置得到共享的TTURLRequestQueue。这个我们一般情况下用不到

- (BOOL)sendRequest:(TTURLRequest*)request;//发送异步请求，如果返回为yes，说明资源是从缓存中得到的。反之，反之。

- (BOOL)sendSynchronousRequest:(TTURLRequest*)request;//发送同步请求。返回值同上。

- (void)cancelRequest:(TTURLRequest*)request;//切断一个网络链接

- (void)cancelRequestsWithDelegate:(id)delegate;//大家可以讨论一下这个借口的用法

- (void)cancelAllRequests;//停止所有的网络链接包括被吊起的网络链接

- (NSURLRequest*)createNSURLRequest:(TTURLRequest*)request URL:(NSURL*)URL;//创建一个网络请求，这个函数一般情况下是被自身所调用。我们接触不到

@end
好的，这个类给讲解完了，实际上写到这里，我感觉有点那没为什么没有访问app中所有网络链接（TTUrlRequest）的接口呢？实际上这个接口被three20放到TTRequestLoader.h里面的_request属性里面了。下面我们讲解一下TTRequestLoader.h

持续更新中.....
作者：禚来强  email：[email protected]

TTRequestLoader.h管理这TTUrlRequest的设置，利用ios的NSURLConnection，进行实际的网络链接。以及管理TTUrlRequest的回调函数，如开始下载调用哪个函数，结束现在调用哪个函数。
TTRequestLoader实现了NSURLConnectionDelegate协议。
实际上每一个TTUrlRequest都有一个自己的TTRequestLoader。
TTRequestLoader会装在具有相同设置的TTUrlRequest

@interface TTRequestLoader : NSObject

@property (nonatomic, readonly) NSArray* requests;//附属于这个loader的TTUrlRequests

@property (nonatomic, readonly) NSString* urlPath;//请求的url

@property (nonatomic, readonly) NSString* cacheKey;//请求的cacheKey，用来表示数据缓存的

@property (nonatomic, readonly) TTURLRequestCachePolicy cachePolicy;//缓存计划

@property (nonatomic, readonly) NSTimeInterval cacheExpirationAge;//缓存的资源的有效时间

@property (nonatomic, readonly) BOOL isLoading;//正在进行网络链接吗？

@property (nonatomic, readonly) NSString* URL __TTDEPRECATED_METHOD;//url


- (id)initForRequest:(TTURLRequest*)request queue:(TTURLRequestQueue*)queue;

- (void)addRequest:(TTURLRequest*)request;//不说了
- (void)removeRequest:(TTURLRequest*)request;//不说了

- (BOOL)cancel:(TTURLRequest*)request;//推出网络链接

- (NSError*)processResponse:(NSHTTPURLResponse*)response data:(id)data;
- (void)dispatchError:(NSError*)error;
- (void)dispatchLoaded:(NSDate*)timestamp;
- (void)dispatchAuthenticationChallenge:(NSURLAuthenticationChallenge*)challenge;
- (void)cancel;

//作者：禚来强 email：[email protected]

@end