17 Star 23 Fork 7

GangWang / MTNET

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
该仓库未声明开源许可证文件(LICENSE),使用请关注具体项目描述及其代码上游依赖。
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
┌──┐┌──┐┌──┐┌──┐┌──┐
││││└┐┌┘│┌┐││ ─┤└┐┌┘
││││ ││ │││││ ─┤ ││ 
└┴┴┘ └┘ └┘└┘└──┘ └┘ 

                

MTNET

MTNET是一个十分轻量、功能强大的ios的http网络库,用来处理有大量很频繁发起http请求的场景,在已上架的数歀app使用中表现良好稳定。

其它的网络库上手容易,但要处理比较密集和较大文件下载时就显得比较麻烦。

使用下载池管理所有网络下载,可设置同时下载的请求数,针对单个请求可以中止和取消,提供两种数据接收方式:内存接收和磁盘接收。

磁盘接收数据会将接收到的数据小块小块的写入磁盘,避免了如果下载文件比较大时造成的内存吃紧

开发者可继承MTDownloadRecvDataFileSystem类,灵活指定下载文件的存储路径和存储文件名,并提供文件是否缓存和获取缓存文件的方法

已修改为 ARC 版本

~~~ 有很多同学反馈需要支持arc版本, 会尽快支持 ~~~


# 使用
引入头文件

```objectivec
#import "MTDownloaderHelper.h"
#import "MTDownloadObjectModel.h"
#import "MTDownloadRequest.h"
#import "MTDownloadRecvData.h"	
```

声明下载池

```objectivec
@property (nonatomic, strong) MTDownloaderHelper * downloadHelper;

	...
	
self.downloadHelper = [[MTDownloaderHelper alloc] init];	
```

设置下载池同时最多可执行的任务数

```objectivec
[self.downloadHelper setMaxConcurrentTaskCount:5];
```

可给下载池中所有链接指定同一个下载超时的设置

```objectivec
[self.downloadHelper setTimeout:20];
```

向下载池中投入一个下载请求

```objectivec
MTDownloadRequest * request = [[MTDownloadRequest alloc] init];
MTDownloadObjectModel * downloadMdel = [[MTDownloadObjectModel alloc] init];
downloadMdel.url = @"http://www.baidu.com";
request.downloadModel = downloadMdel;
    
request.delegate  = self;
    
[self.downloadHelper addDownloadRequest:request];
```

取消一个下载请求,如此下载请求还未开始下载就从下载队列中移除。如已开始下开就中止当前下载

```objectivec
[self.downloadHelper cancelDownloadRequestByName:request.name];
```

使用`MTDownloadRequestDelegate` 获取下载结果

```objectivec
- (void) didTaskReceiveDataFinish   : (NSData *) theData    request:(MTDownloadRequest*) request
{
    NSLog(@"download ok");
}

- (void) taskDataDownloadFailed     : (NSError *) error     request:(MTDownloadRequest*) request
{
    NSLog(@"download failed:%@", error);
}
```



###自定义接收下载规则
可以继承`MTDownloadRecvDataFileSystem`自己制定下载规则,在此类中还提供了`processRecvAllDataFinish` 和 `processRecvAllDataFalied`这两个方法,重写就可以自定义处理当下载数据出错或者成功后的操作

比如 下载数据出错后需要清理缓存,下载成功后需要对文件进行解压、压缩、图片缩放等


```objectivec
#import "MTDownloadRecvData.h"

@interface AppImageDowloadRecv : MTDownloadRecvDataFileSystem

- (void) setFileName:(NSString *) fileName;

@end



#import "AppImageDowloadRecv.h"
#import "MTPath.h"
#import "MTFile.h"
#import "NSString+Extension.h"
#import "mcfDef.h"

@implementation AppImageDowloadRecv

- (id) init
{
    self = [super init];
    if(self)
    {
        self.localCacheDirPath = [MTPath Combine:kCache combinePath:@"appdata"];
        static BOOL created = FALSE;
        if (!created) {
            created = TRUE;
            [MTPath createDirectory:self.localCacheDirPath withAttributes:nil];
        }
    }
    
    return self;
}

- (void) setFileName:(NSString *) fileName
{
    if ([NSString isNilOrEmpty:fileName])
    {
        return;
    }
    
    self.name = fileName;
    self.localFullPath = [MTPath Combine:self.localCacheDirPath combinePath:fileName];
}

- (BOOL) bCached
{
    return [MTFile fileExistsAtPath:self.localFullPath];
}

- (NSData *) data
{
    if ([self bCached])
    {
        return [NSData dataWithContentsOfFile:self.localFullPath];
    }
    
    return nil;
}

@end

```



向下载池中投入一个自己定义下载规则的请求

```objectivec
MTDownloadRequest * request = [[MTDownloadRequest alloc] init];
    
MTDownloadObjectModel * downloadMdel = [[MTDownloadObjectModel alloc] init];
downloadMdel.url = @"http://www.baidu.com";
request.downloadModel = downloadMdel;
    
AppImageDowloadRecv * recvData = [[AppImageDowloadRecv alloc] init];
[recvData setFileName:@"filename"];
request.recvData = recvData;
    
request.delegate  = self;
    
[self.downloadHelper addDownloadRequest:request];
```



---
If you like this project, give a start ;)


---
Using Mtnet in your App? Let me know [weibo](http://weibo.com/wgblog)  or [gang.wang.china@gmail.com](gang.wang.china@gmail.com)  :).

空文件

简介

MTNET是一个十分轻量、功能强大的ios的http网络库 展开 收起
Objective-C
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
Objective-C
1
https://gitee.com/gangwang/MTNET.git
git@gitee.com:gangwang/MTNET.git
gangwang
MTNET
MTNET
master

搜索帮助