TXNetworking

Latest	0.1.1
Homepage	https://github.com/xtzPioneer/TXNetworking
License	MIT
Platforms	ios 8.0
Dependencies	AFNetworking
Authors	xtzPioneer

TXNetworking

基于AFNetworking开发的网络管理工具,采用了链式编程、函数式编程、以及离散式编程。使其降低开发成本、提升开发速率。该框架还采用了扩展式开发使其易扩展、易更改。

功能及简介

1、集成 GET / POST / PUT / DELETE 等请求方式
2、集成 Upload / Download 任务上传和下载并且支持开始、暂停、继续等操作
3、支持请求头、内容类型、参数、超时时间等设置
4、支持拦截返回参数和自定义返回格式
5、采用链式编程
6、采用函数式编程
7、采用离散式编程

8、采用扩展式开发

安装

pod 'TXNetworking'

使用姿势

#import "TXNetworking.h"

设置配置-方法1

[TXNetworkingManager setConfig:^(TXNetworkingConfig * _Nonnull config) {
 [email protected]"www.test";
 [email protected]{@"test":@"Headers"};
 [email protected]{@"test":@"parameters"};
 config.requestConfig.defaultContentTypes=[NSSet setWithObjects:@"test-ContentTypes", nil];
 config.requestConfig.defaultAPIRequestTimeoutInterval=10.f;
 config.requestConfig.defaultTaskRequestTimeoutInterval=120.f;
 [email protected]"test/DownloadFilePath";
 config.deBugConfig.defaultDeBug=NO;
}];

设置配置-方法2

[TXNetworkingManager manager]
.setDefaultBaseURL(@"-www.test")
.setDefaultHeaders(@{@"test":@"test2-Headers"})
.addDefaultHeaders(@{@"test2":@"add-test2-Headers"})
.setDefaultParameters(@{@"test":@"test2-Parameters"})
.addDefaultParameters(@{@"test2":@"add-test2-Parameters"})
.setDefaultContentTypes([NSSet setWithObjects:@"test2-ContentTypes", nil])
.addDefaultContentTypes([NSSet setWithObjects:@"add-test2-ContentTypes", nil])
.setDefaultAPIRequestTimeoutInterval(40.f)
.setDefaultTaskRequestTimeoutInterval(240.f)
.setDefaultDownloadFilePath(@"test/DownloadFilePath")
.setDeBug(YES)
.setDefaultSuccessFormatHandler(^ id (id obj){
 return @{
 @"title":@"我拦截了成功",
 @"data":obj
 };
})
.setDefaultFailureFormatHandler(^ id (id obj){
 return @{
 @"title":@"我拦截了故障",
 @"data":obj
 };
})
.setDefaultProgressFormatHandler(^ id (id obj){
 return @{
 @"title":@"我拦截了进度",
 @"data":obj
 };
});

API请求-方法1

TXAPIRequest *apiRequest=[TXAPIRequest request];
apiRequest.method=POST;
[email protected]"APItest";
[email protected]"APItestbaseURL";
[email protected]{@"testAPIParameters":@"APIParameters"};
[email protected]{@"testAPIHeaders":@"APIHeaders"};
apiRequest.contentTypes=[NSSet setWithObjects:@"testAPIContentTypes", nil];
apiRequest.timeoutInterval=50;
// 开始API请求
[apiRequest startAPIRequest];
// 取消API请求
[apiRequest cancelAPIRequest];

API请求-方法2

TXAPIRequest *apiRequest=[TXAPIRequest request];
apiRequest
.setMethod(GET)
.setURL(@"APItestURL-m2")
.setBaseURL(@"APItestbaseURL-m2")
.setParameters(@{@"APItestParameter":@"setf2"})
.addParameters(@{@"APItestParameter2":@"addf2"})
.setHeaders(@{@"APIHeaders":@"setf2"})
.addHeaders(@{@"APIHeaders2":@"addf2"})
.setContentTypes([NSSet setWithObjects:@"APISetContentTypes", nil])
.addContentTypes([NSSet setWithObjects:@"APIaddContentTypes", nil])
.setTimeoutInterval(60)
.setDeBug(NO)
.setSuccessHandler(^ (id obj){
    NSLog(@"成功回调:%@",obj);
})
.setFailureHandler(^ (id obj){
    NSLog(@"失败回调:%@",obj);
})
.setProgressHandler(^ (id obj){
    NSLog(@"进度回调:%@",obj);
})
.setStateHandler(^ (TXAPIRequestState state){
    switch (state) {
        case TXAPIRequestStateRunning: {
            NSLog(@"运行");
        }
            break;
        case TXAPIRequestStateCancel: {
            NSLog(@"取消");
        }
            break;
        case TXAPIRequestStateCompleted: {
            NSLog(@"完成");
        }
            break;

        default:
            break;
    }
})
.start();

Task请求-方法1

TXTaskRequest *taskRequest=[TXTaskRequest request];
taskRequest.method=Download;
[email protected]"TaskURL";
[email protected]"TaskbaseURL";
[email protected]{@"testTaskParameters":@"TaskParameters"};
[email protected]{@"testTaskHeaders":@"TaskHeaders"};
taskRequest.contentTypes=[NSSet setWithObjects:@"testTaskContentTypes", nil];
taskRequest.timeoutInterval=50;
[email protected]"testTaskDownloadFilePath";
[email protected]"fileName.zip";
taskRequest.deBug=YES;
// 开始Task请求
[taskRequest startTaskRequest];
// 取消Task请求
[taskRequest cancelTaskRequest];
// 继续Task请求
[taskRequest resumeTaskRequest];
// 暂停Task请求
[taskRequest pauseTaskRequest];

Task请求-方法1

TXTaskRequest *taskRequest=[TXTaskRequest request];
taskRequest.setMethod(Upload)
.setURL(@"TaskURLf2")
.setBaseURL(@"TaskbaseURLf2")
.setParameters(@{@"testTaskParameters2":@"testTaskParameters2"})
.addParameters(@{@"addTestTaskParameters2":@"addTestTaskParameters2"})
.setHeaders(@{@"testTaskHeaders2":@"testTaskHeaders2"})
.addHeaders(@{@"addTestTaskHeaders2":@"addTestTaskHeaders2"})
.setContentTypes([NSSet setWithObject:@"testTaskContentTypes2"])
.addContentTypes([NSSet setWithObject:@"addTestTaskContentTypes2"])
.setTimeoutInterval(60)
.setDownloadFilePath(@"testTaskDownloadFilePathf2")
.setDeBug(YES)
.setSuccessHandler(^ (id obj) {
  // 回到主线程刷新UI
  dispatch_async(dispatch_get_main_queue(), ^{
      [email protected]"下载1下载成功";
  });
  NSLog(@"下载1:filePath:%@",obj);
})
.setFailureHandler(^ (id obj){
  // 回到主线程刷新UI
  dispatch_async(dispatch_get_main_queue(), ^{
      [email protected]"下载1下载失败";
  });
})
.setProgressHandler(^ (id obj){
  // 回到主线程刷新UI
  dispatch_async(dispatch_get_main_queue(), ^{
      NSProgress *progress=obj;
      NSInteger completed=progress.fractionCompleted*100;
      label.text=[NSString stringWithFormat:@"下载1的进度:%ld%%",(long)completed];
  });
})
.setStateHandler(^ (TXTaskRequestState state){
 switch (state) {
     case TXTaskRequestStateRunning: {
          NSLog(@"下载1状态:运行");
     }
          break;
     case TXTaskRequestStatePause: {
          NSLog(@"下载1状态:暂停");
     }
          break;
     case TXTaskRequestStateCancel: {
          NSLog(@"下载1状态:取消");
     }
          break;
     case TXTaskRequestStateCompleted: {
          NSLog(@"下载1状态:完成");
     }
          break;
        default:
          break;
  }
})
.start();

总结

方法1:采用函数式编程以及离散式编程,使其具备更加灵活的操作性。
方法2:采用链式编程以及扩展式编程,使其具备方法1的所有特性，并且具备更加灵活的延展性以及扩展性。

反馈

QQ：1754748325
E-mail：[email protected]
开发中遇到bug，希望小伙伴儿们能够及时反馈到QQ或E-mail！

开发环境&支持版本

开发使用最新版本Xcode，理论上支持iOS9及以上版本，如有版本适配问题，请及时反馈！多谢合作！

版本&更新

更新时间:2019.5.27 版本:0.1.1 更新内容: 新增网络检测功能

Latest podspec

{
    "name": "TXNetworking",
    "version": "0.1.1",
    "summary": "u57fau4e8eAFNetworkingu5f00u53d1u7684u7f51u7edcu7ba1u7406u5de5u5177,u91c7u7528u4e86u94feu5f0fu7f16u7a0bu3001u51fdu6570u5f0fu7f16u7a0bu3001u4ee5u53cau79bbu6563u5f0fu7f16u7a0bu3002u4f7fu5176u964du4f4eu5f00u53d1u6210u672cu3001u63d0u5347u5f00u53d1u901fu7387u3002",
    "description": "u57fau4e8eAFNetworkingu5f00u53d1u7684u7f51u7edcu7ba1u7406u5de5u5177,u91c7u7528u4e86u94feu5f0fu7f16u7a0bu3001u51fdu6570u5f0fu7f16u7a0bu3001u4ee5u53cau79bbu6563u5f0fu7f16u7a0bu3002u4f7fu5176u964du4f4eu5f00u53d1u6210u672cu3001u63d0u5347u5f00u53d1u901fu7387u3002u8be5u6846u67b6u8fd8u91c7u7528u4e86u6269u5c55u5f0fu5f00u53d1u4f7fu5176u6613u6269u5c55u3001u6613u66f4u6539u3002",
    "homepage": "https://github.com/xtzPioneer/TXNetworking",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "xtzPioneer": "[email protected]"
    },
    "source": {
        "git": "https://github.com/xtzPioneer/TXNetworking.git",
        "tag": "0.1.1"
    },
    "platforms": {
        "ios": "8.0"
    },
    "source_files": "TXNetworking/Classes/**/*.{h,m}",
    "dependencies": {
        "AFNetworking": [
            "~> 3.2.1"
        ]
    }
}

Thu, 30 May 2019 10:08:21 +0000

Pin It on Pinterest

Share This