Latest 0.3.0
Homepage https://github.com/sunzhenglin/CoreNetWorkingLib
License MIT
Platforms ios 8.0
Dependencies AFNetworking, SVProgressHUD, TXModel
Authors

CoreNetWorking

  • 轻量级的网络请在使用GET、POST、以及图片上传时是你的操作更简单快捷、在进行网络请求时还可以智能显示加载进度HUD

    CoreNetWorking优点

  • 使用以及操作简单快捷
  • 内部集成HUD以及智能显示HUD
  • 更加方便的网络检测功能
  • 内部监听错误以更加简单的方式让你统一处理错误使你的开发更加高效

CoreNetWorking缺点

  • 逻辑复杂、多变的情况下需要开发者二次封装才能完成各项任务

cocoapods集成

  • pod ‘CoreNetWorkingLib’, ‘~> 0.3.0’

    代码片段

/** 完成回调 */
typedef void (^NWCompletionHandler) (NSError *error,id obj);

/** HUD显示类型 */
typedef NS_ENUM(NSInteger,NWShowHUDType){
    NWShowHUDTypeDefault     =0,//默认
    NWShowHUDTypeInfo        =1,//信息
    NWShowHUDTypeCaveatInfo  =2,//警告
    NWShowHUDTypeSuccessInfo =3,//成功
    NWShowHUDTypeFailureInfo =4,//失败
};

/**
 *  网络管理器
 *
 *  主要功能:GET请求、POST请求、上传单张图片、上传多张图片、上传多组多图片、网络检测、HUD、上传单文件、上传多文件、上传多组多文件
 *
 *  主要设置:1.设置请求超时时间 2.设置请求头 3.设置内容类型 4.设置网络请求识别码
 *
 *  辅助快捷:1.HUD显示 2.获取当前时间
 *
 *  辅助功能1:“TXNetErrorCode.h”以及“TXNetErrorDelegate.h”文件主要集中处理错误代码
 *
 *  辅助功能2:“TXNetworkStatusDelegate.”文件主要集中处理网络状态
 *
 */
@interface TXNetWorking : NSObject

/** 网络管理器 */
+ (TXNetWorking*)netWorkingManager;

/**
 *  AFHTTPSessionManager
 *
 *  注意:只有调用“netWorkingManager”方法才能使用
 *
 */
@property (nonatomic,strong,readonly)AFHTTPSessionManager *aFHTTPManager;

/**
 *  AFNetworkReachabilityManager
 *
 *  注意:只有调用“openNetworkMonitoring”方法才能使用
 *
 */
@property (nonatomic,strong,readonly)AFNetworkReachabilityManager *aFReachabilityManager;

/**
 *  网络状态
 *
 *  注意:只用在开启网络检测时可用
 *
 */
@property (nonatomic,assign,readonly)NWNetworkStatus networkStatus;

/**
 *  网络请求识别码
 *
 *  注意:适用于空灵智能
 *
 */
@property (nonatomic,assign)NSInteger code;

/** 请求超时时间 */
@property (nonatomic,assign)NSTimeInterval requestTimedOut;

/**
 *  设置请求超时时间
 *  @param requestTimedOut 超时时间
 */
+ (void)setRequestTimedOut:(NSTimeInterval)requestTimedOut;

/**
 *  设置请求头
 *  @param value 请求头的值
 *  @param key 请求头的键
 */
+ (void)setRequestHeaderWithValue:(NSString*)value forkey:(NSString*)key;

/** 内容类型*/
@property (nonatomic,copy)NSSet<NSString*> *contentTypes;

/**
 *  设置内容类型
 *  @param contentTypes 内容类型
 */
+ (void)setContentTypes:(NSSet<NSString*> *)contentTypes;

/** 开启网络检测 */
+ (void)openNetworkMonitoring;

/**
 *  显示HUD
 *  @param showHUDType HUD显示类型
 *  @param info 信息
 */
+ (void)showHUDWithShowHUDType:(NWShowHUDType)showHUDType info:(NSString*)info;

/** 消除HUD */
+ (void)dismissHUD;

/**
 *  获取当前时间
 *
 *  注意:“dateFormat”参数默认格式为:yyyyMMddHHmmss
 *
 *  @param dateFormat 时间格式 如:yyyyMMddHHmmss
 *
 *  @return 当前时间
 */
+ (NSString*)currentTimeWithDateFormat:(NSString*)dateFormat;

/**
 *  post
 *  @param strURL 请求的URL
 *  @param parameters 请求的参数
 *  @param showHUD 是否显示HUD
 */
+ (void)post:(NSString*)strURL parameters:(NSDictionary*)parameters showHUD:(BOOL)showHUD completionHandler:(NWCompletionHandler)completionHandler;

/**
 *  get
 *  @param strURL 请求的URL
 *  @param parameters 请求的参数
 *  @param showHUD 是否显示HUD
 */
+ (void)get:(NSString*)strURL parameters:(NSDictionary*)parameters showHUD:(BOOL)showHUD completionHandler:(NWCompletionHandler)completionHandler;

/**
 *  图片上传(单张)
 *  @param strURL 上传图片的接口路径,如/path/images/
 *  @param image 图片对象
 *  @param fileName 给图片起一个名字,默认为当前日期时间,格式为"yyyyMMddHHmmss",后缀为`jpg`
 *  @param name 与指定的图片相关联的名称,这是由后端写接口的人指定的,如imagefiles
 *  @param mimeType 默认为image/jpeg
 *  @param parameters 参数
 *  @param showHUD 是否显示HUD
 */
+ (void)uploadImage:(NSString *)strURL
              image:(UIImage *)image
           fileName:(NSString *)fileName
               name:(NSString *)name
           mimeType:(NSString *)mimeType
         parameters:(NSDictionary *)parameters
            showHUD:(BOOL)showHUD
  completionHandler:(NWCompletionHandler)completionHandler;

/**
 *  图片上传(多张)
 *  @param strURL 上传图片的接口路径,如/path/images/
 *  @param images 图片集合
 *  @param fileName 给图片起一个名字,默认为当前日期时间,格式为"yyyyMMddHHmmss",后缀为`jpg`
 *  @param name 与指定的图片相关联的名称,这是由后端写接口的人指定的,如imagefiles
 *  @param mimeType 默认为image/jpeg
 *  @param parameters 参数
 *  @param showHUD 是否显示HUD
 */
+ (void)uploadImage:(NSString *)strURL
              images:(NSArray<UIImage*> *)images
           fileName:(NSString *)fileName
               name:(NSString *)name
           mimeType:(NSString *)mimeType
         parameters:(NSDictionary *)parameters
            showHUD:(BOOL)showHUD
  completionHandler:(NWCompletionHandler)completionHandler;

/**
 *  图片上传(多组、多张)
 *  @param strURL 上传图片的接口路径,如/path/images/
 *  @param images 多组图片集合
 *  @param fileName 给图片起一个名字,默认为当前日期时间,格式为"yyyyMMddHHmmss",后缀为`jpg`
 *  @param names 与指定的图片相关联的名称集合,这是由后端写接口的人指定的,如imagefiles1、imagefiles2
 *  @param mimeType 默认为image/jpeg
 *  @param parameters 参数
 *  @param showHUD 是否显示HUD
 */
+ (void)uploadImage:(NSString *)strURL
             images:(NSArray<NSArray<UIImage*>*>*)images
           fileName:(NSString *)fileName
              names:(NSArray<NSString*> *)names
           mimeType:(NSString *)mimeType
         parameters:(NSDictionary *)parameters
            showHUD:(BOOL)showHUD
  completionHandler:(NWCompletionHandler)completionHandler;

/**
 *  上传文件
 *  @param strURL 上传文件的接口路径,如/path/files/
 *  @param fileURL 文件的URL
 *  @param fileName 给文件起一个名字,如:"yyyyMMddHHmmss.mp4",
 *  @param name 与指定的文件相关联的名称,这是由后端写接口的人指定的,如audiofiles
 *  @param mimeType 上传类型:application/octet-stream
 *  @param parameters 参数
 *  @param showHUD 是否显示HUD
 */
+ (void)uploadFile:(NSString*)strURL
           fileURL:(NSURL*)fileURL
          fileName:(NSString*)fileName
              name:(NSString*)name
          mimeType:(NSString*)mimeType
        parameters:(NSDictionary*)parameters
           showHUD:(BOOL)showHUD
 completionHandler:(NWCompletionHandler)completionHandler;

/**
 *  上传文件(多文件)
 *  @param strURL 上传文件的接口路径,如/path/files/
 *  @param fileURLs 文件的URL集合
 *  @param fileName 给文件起一个名字,如:"yyyyMMddHHmmss.mp4",
 *  @param name 与指定的文件相关联的名称,这是由后端写接口的人指定的,如audiofiles
 *  @param mimeType 上传类型:application/octet-stream
 *  @param parameters 参数
 *  @param showHUD 是否显示HUD
 */
+ (void)uploadFile:(NSString*)strURL
          fileURLs:(NSArray<NSURL*>*)fileURLs
          fileName:(NSString*)fileName
              name:(NSString*)name
          mimeType:(NSString*)mimeType
        parameters:(NSDictionary*)parameters
           showHUD:(BOOL)showHUD
 completionHandler:(NWCompletionHandler)completionHandler;

/**
 *  上传文件(多组、多文件)
 *  @param strURL 上传文件的接口路径,如/path/files/
 *  @param fileURLs 多组文件的URL集合
 *  @param fileName 给文件起一个名字,如:"yyyyMMddHHmmss.mp4",
 *  @param names 与指定的文件相关联的名称集合,这是由后端写接口的人指定的,如audiofiles1,audiofiles2
 *  @param mimeType 上传类型:application/octet-stream
 *  @param parameters 参数
 *  @param showHUD 是否显示HUD
 */
+ (void)uploadFile:(NSString*)strURL
          fileURLs:(NSArray<NSArray<NSURL*>*>*)fileURLs
          fileName:(NSString*)fileName
             names:(NSArray<NSString*>*)names
          mimeType:(NSString*)mimeType
        parameters:(NSDictionary*)parameters
           showHUD:(BOOL)showHUD
 completionHandler:(NWCompletionHandler)completionHandler;

使用方法

  • 例如:
/**
 * 登录
 * @param account 账户名
 * @param verificationCode 验证码
 * @param password 密码 注意:家长端密码传入“1”
 */
- (void)logInWithAccount:(NSString*)account verificationCode:(NSString*)verificationCode password:(NSString*)password{
    _operationType=LROperationTypeLogIn;
    NSMutableDictionary *parameters=[NSMutableDictionary dictionary];
    [parameters setValue:@"1" forKey:@"type"];//家长端
    if (!account || [account isEqualToString:@""]) {
        NSString * [email protected]"账号不能为空";
        if (self.completionHandler) self.completionHandler([NSError errorWithDomain:@"KLLogInRegisterViewModelError" code:-1002 userInfo:@{@"msg":msg}],nil);
    }else if (!verificationCode || [verificationCode isEqualToString:@""]){
        NSString * [email protected]"验证码不能为空";
        if (self.completionHandler) self.completionHandler([NSError errorWithDomain:@"KLLogInRegisterViewModelError" code:-1003 userInfo:@{@"msg":msg}],nil);
    }else if (!password || [password isEqualToString:@""]){
        NSString * [email protected]"密码不能为空";
        if (self.completionHandler) self.completionHandler([NSError errorWithDomain:@"KLLogInRegisterViewModelError" code:-1004 userInfo:@{@"msg":msg}],nil);
    }else{
        [parameters setValue:account forKey:@"account"];
        [parameters setValue:verificationCode forKey:@"vcode"];
        [parameters setValue:password forKey:@"pwd"];
        [TXNetWorking post:HTTP_API(@"user/login.do") parameters:parameters showHUD:NO completionHandler:^(NSError *error, TXNetModel *netModel) {
            if (!error) {
                if (self.completionHandler) self.completionHandler(error,netModel);
            }else{
                NSString * [email protected]"登录失败";
                if (self.completionHandler) self.completionHandler([NSError errorWithDomain:@"KLLogInRegisterViewModelError" code:-1005 userInfo:@{@"msg":msg}],netModel);
            }
        }];
    }
}
  • 使用示例:
  • (void)viewDidLoad {
    [super viewDidLoad];
    /* 登录接口演示 /
    NSMutableDictionary parameters=[NSMutableDictionary dictionary];
    [parameters setValue:@"15934862072" forKey:@"account"];
    [parameters setValue:@"666666" forKey:@"vcode"];
    [parameters setValue:@"1" forKey:@"pwd"];
    // 注意:“HTTP_API(@"user/login.do")”这个是登录接口
    // 注意:“parameters”这个是请求参数
    // 注意:“YES”这个是是否显示HUD,现在这里是显示
    [TXNetWorking post:HTTP_API(@"user/login.do") parameters:parameters showHUD:YES completionHandler:^(NSError
    error, TXNetModel *netModel) {
    if (!error) {
    //登录成功
    }else{
    //登录失败
    }
    }];
    // Do any additional setup after loading the view, typically from a nib.
    }

Latest podspec

{
    "name": "CoreNetWorkingLib",
    "version": "0.3.0",
    "summary": "u676du5ddeu7a7au7075u667au80fdu79d1u6280u6709u9650u516cu53f8u57fau4e8eAFNetworkingu6240u5f00u53d1u7684u7f51u7edcu8bf7u6c42u5e93,u652fu6301getu3001postu3001uploadu7b49u529fu80fd.",
    "description": "u676du5ddeu7a7au7075u667au80fdu79d1u6280u6709u9650u516cu53f8u57fau4e8eAFNetworkingu6240u5f00u53d1u7684u7f51u7edcu8bf7u6c42u5e93,u652fu6301getu3001postu3001uploadu3001u4ee5u53cau7f51u7edcu68c0u6d4bu7b49u529fu80fd.",
    "homepage": "https://github.com/sunzhenglin/CoreNetWorkingLib",
    "license": {
        "type": "MIT",
        "file": "LICENSE"
    },
    "authors": {
        "szl": "[email protected]"
    },
    "source": {
        "git": "https://github.com/sunzhenglin/CoreNetWorkingLib.git",
        "tag": "0.3.0"
    },
    "platforms": {
        "ios": "8.0"
    },
    "source_files": "CoreNetWorkingLib/Classes/**/*.{h,m}",
    "dependencies": {
        "AFNetworking": [
            "~> 3.2.1"
        ],
        "SVProgressHUD": [
            "~> 2.2.5"
        ],
        "TXModel": [
            "~> 1.0.1"
        ]
    },
    "prefix_header_contents": "#import "CoreNetworking.h""
}

Pin It on Pinterest

Share This