Sagit.Framework For IOS 开发框架入门教程6：网络请求STHttp

前言：

IOS的文章，今天，再来补一篇，Sagit的教程；

虽然感觉IOS的文章没什么观众，还是努力写吧，-_-〜

Sagit 开源地址：https://github.com/cyq1162/Sagit

今天主要是分享网络请求，即STHttp的用法：

STHttp为处理网络API请求的功能的源码。

1､对外API功能调用说明：

对于网络请求，Sagit目前是对AFNetworking做了一下二次封装！

所以框架里有引用到这个第三方组件。

封装完后，目前对外调用的API：

typedef void(^Success)(STModel *result);
typedef void(^Error)(NSString *errMsg);
//!提供基础的网络请求（get、post、upload(图片上传））
@interface STHttp : NSObject

@property (nonatomic,strong) STMsgBox *msgBox;

- (instancetype)init:(STMsgBox*)msgBox;
- (void)get:(NSString *)url paras:(NSDictionary *)paras success:(Success)succese;
- (void)get:(NSString *)url paras:(NSDictionary *)paras success:(Success)success error:(Error)error;

- (void)post:(NSString *)url paras:(NSDictionary *)paras success:(Success)success;
- (void)post:(NSString *)url paras:(NSDictionary *)paras success:(Success)success error:(Error)error;

- (void)upload:(NSString *)url data:(NSData *)data success:(Success)success;
- (void)upload:(NSString *)url data:(NSData *)data success:(Success)success error:(Error)error;

- (void)upload:(NSString *)url paras:(NSDictionary *)paras success:(Success)success;
- (void)upload:(NSString *)url paras:(NSDictionary *)paras success:(Success)success error:(Error)error;
- (void)setHeader:(NSString*)key v:(NSString*)value;

+ (instancetype)share;
+ (instancetype)shareWithLoading;
//-(void)networkState;
@end

只有三个常用的方法：get、post、upload（图片）。

2、调用方式

对于该类的调用方式，有两种

1､在继承自STController的控制器下，直接用[self.http ...]

STController这个基类，默认实现的有两个子类接口（msgBox：消息弹窗、http：网络请求）

例如：

[self.http get:UrlQuestionRank paras:nil success:^(STModel *result) {
        if (result.success)
        {
            NSMutableArray<id> *data=(NSMutableArray<id>*)result.msg[@"data"];
            STFirstTable.source=data;
            [STFirstTable reloadData];
        }
    }];

2､在任意地方，都可以全局的调用：用[Sagit.Http ...]

Sagit，是一个总类库的起始名称空间，很多常用功能，都是由Sagit打开头开始，后续会单独介绍。

例如：

//获取积分
                [Sagit.Http get:UrlIntegralShareBlog paras:nil success:^(STModel *result)
                 {
                     if(result.success && result.msg)
                     {
                         NSString *data=(NSString*)result.msg;
                         if(data && data.isInt)
                         {
                             //修改当前积分总数
                             Sagit.Global.User.user.Integral=data.integerValue;
                         }
                     }
                 }];

3、项目代码实例

下面，会和大伙分享 IT连App 中，应用到该相关的代码：

A、get用法：加载用户信息

-(void)loadUserInfo:(NSString*)userID  loadComplete:(LoadComplete)loadComplete
{
    if(![NSString isNilOrEmpty:self.Token])
    {
        NSMutableDictionary *dic=nil;
        if(![NSString isNilOrEmpty:userID])
        {
            dic=@{@"UserID":userID};
        }
        //检测有没有缓存
        if(userID)
        {
            PersonalModel *mode=[Sagit.Cache get:userID];
            if(mode)
            {
                loadComplete(mode);
                return;
            }
        }
        [Sagit.Http get:UrlUserInfo paras:dic success:^(STModel *result)
         {
             PersonalModel *user=nil;
             if(result.success)
             {
                 user = [[PersonalModel alloc] initWithObject:result.msg];
             }
             if(user && userID==nil){self.User=user;}
             else
             {
                 [Sagit.Cache set:userID value:user];
             }
             if(loadComplete!=nil)
             {
                loadComplete(user);
             }
             
         }];
    }
    else if(loadComplete!=nil)
    {
        loadComplete(nil);
    }
}

木有效果图〜

B、post用法：登陆账号

- (void)LoginClick:(UIButton *)sender {
    
    if(![self isMatch:@"手机号" name:@"UserName" regex:RexMobile]
       || ![self isMatch:@"密码" name:@"password" regex:nil]
      )
    {
        return;
    }
    NSMutableDictionary *para = [self formData];
    [para setValue:@(UserAccountType) forKey:@"AccountType"];
    
    [self.http post:UrlLogin paras:para success:^(STModel *result)
     {
         
        if (result.success) {
            Sagit.Global.Token=(NSString *)result.msg;
            [STNew(@"MainController") asRoot];
        }else {
            [self.msgBox prompt:(NSString *)result.msg];
        }
    }];
}

界面图：

C、upload用法：上传图片

- (void)headImageClick:(UIButton*)btn
{
    [btn.imageView pick:^(NSData *data, UIImagePickerController *picker, NSDictionary<NSString *,id> *info)
     {
        [self.http upload:UrlUploadPhoto paras:@{@"photo":data,@"PhotoType":@"2"} success:^(STModel *result) {
            if (result.success) {
                [self key:@"uploadPhoto" value:@"1"];
                [self.msgBox prompt:@"头像上传成功!"];
                [btn image:data];// corner:YES];
            }else {
                [self.msgBox prompt:@"头像上传失败!"];
            }
        }];
        
    } edit:YES];
}

界面图：

4､返回结果的实体类

STModel，是约定好格式的结果。

@interface STModel : STModelBase
@property (nonatomic, assign) BOOL success;
@property (retain, nonatomic) id<NSObject> msg;

@end

msg，可以根据具体返回的数据，进行对应的类型转换。

5､IT连中的对STHttp进行了扩展使用

下面和大伙分享一下：IT连的都是扩展了点什么：

A、对于定义API的URL，都简化了前缀

/** 注册 */
#define UrlReg   @"/user/register"
/** 登陆 */
#define UrlLogin  @"/user/login"

将前缀的主机部分，由扩展功能完成。

所以扩展重写了：reSetUrl函数：

@implementation STHttp(IT)

-(NSString*)reSetUrl:(NSString *)url
{
    if(![url hasPrefix:@"http://"] && ![url hasPrefix:@"https://"])
    {
        if([url startWith:@"/photos/"] || [url startWith:@"/qrcode/"])
        {
            url=[ImageHost append:url];
        }
        else
        {
            url=[ApiHost append:url];
        }
    }
    return  url;
}
-(void)reSetHeader
{
    [self setHeader:@"ver" v:AppVersionNum];
    [self setHeader:@"prod" v:STNumString(AppProdType)];
    if(Sagit.Global.Token)
    {
        [self setHeader:@"token" v:Sagit.Global.Token];
    }
}
-(void)showError:(NSString*)errMsg
{
    if(self.msgBox!=nil)
    {
        [self.msgBox alert:@"网络连接错误"];
    }
}

B、扩展中重写了：reSetHeader功能，用于设置一些固定的请求头。

C、扩展中重写了：showError，用于统一显示网络请求的错误信息。

总结：

本篇虽然介绍的是网络请求，但分享的代码，也都是IT连里完整的功能模块了。

Sagit框架，让IOS开发更简单，你值的拥有！！！

顺便新开：IOS Sagit 开发框架 QQ群：702724292