[iOS微博项目 - 3.5] - 封装业务

github: https://github.com/hellovoidworld/HVWWeibo

 

A.封装微博业务

1.需求

把微博相关业务（读取、写微博）

界面控制器不需要知道微博操作细节（例如选择从网络读取还是缓存读取）

 

2.实现

把微博操作封装成一个工具类

把微博网络请求的参数和返回结果也封装成一个类

 

 

 

3.实现

（1）基础参数类

由于多数请求都需要access_token，所以封装一个参数父类

 //
 //  HVWBaseParam.h
 //  HVWWeibo
 //
 //  Created by hellovoidworld on 15/2/9.
 //  Copyright (c) 2015年 hellovoidworld. All rights reserved.
 //

 #import <Foundation/Foundation.h>

 @interface HVWBaseParam : NSObject

 /** 访问令牌 */
 @property(nonatomic, copy) NSString *access_token;

 @end

 

 //
 //  HVWBaseParam.m
 //  HVWWeibo
 //
 //  Created by hellovoidworld on 15/2/9.
 //  Copyright (c) 2015年 hellovoidworld. All rights reserved.
 //

 #import "HVWBaseParam.h"
 #import "HVWAccountInfo.h"
 #import "HVWAccountInfoTool.h"

 @implementation HVWBaseParam

 - (NSString *)access_token {
     if (nil == _access_token) {
         _access_token = [HVWAccountInfoTool accountInfo].access_token;
     }
     return _access_token;
 }

 @end

 

（2）首页获取微博

a.参数类

根据微博API请求参数列表

 

 //
 //  HVWHomeStatusParam.h
 //  HVWWeibo
 //
 //  Created by hellovoidworld on 15/2/9.
 //  Copyright (c) 2015年 hellovoidworld. All rights reserved.
 //

 #import "HVWBaseParam.h"

 @interface HVWHomeStatusParam : HVWBaseParam

 /** false string 采用OAuth授权方式不需要此参数，其他授权方式为必填参数，数值为应用的AppKey。 */
 @property(nonatomic, copy) NSString *source;

 /** false int64 若指定此参数，则返回ID比since_id大的微博（即比since_id时间晚的微博），默认为0。 */
 @property(nonatomic, strong) NSNumber *since_id;

 /** false   int64 若指定此参数，则返回ID小于或等于max_id的微博，默认为0。 */
 @property(nonatomic, strong) NSNumber *max_id;

 /** false int 单页返回的记录条数，最大不超过100，默认为20。 */
 @property(nonatomic, strong) NSNumber *count;

 /** false int 返回结果的页码，默认为1。 */
 @property(nonatomic, strong) NSNumber *page;

 /** false int 是否只获取当前应用的数据。0为否（所有数据），1为是（仅当前应用），默认为0。 */
 @property(nonatomic, strong) NSNumber *base_app;

 /** false int 过滤类型ID，0：全部、1：原创、2：图片、3：视频、4：音乐，默认为0。 */
 @property(nonatomic, strong) NSNumber *feature;

 /** false int 返回值中user字段开关，0：返回完整user字段、1：user字段仅返回user_id，默认为0。 */
 @property(nonatomic, strong) NSNumber *trim_user;

 @end

 

b.返回结果类

微博返回结果是N条微博数据的数组

(这里在返回结果包装类中直接使用之前创建的HVWStatus类来封装微博数据)

 

每个status里面的元素：

 

 //
 //  HVWHomeStatusResult.h
 //  HVWWeibo
 //
 //  Created by hellovoidworld on 15/2/9.
 //  Copyright (c) 2015年 hellovoidworld. All rights reserved.
 //

 #import <Foundation/Foundation.h>
 #import "HVWStatus.h"

 @interface HVWHomeStatusResult : NSObject

 /** 微博数组，里面装的HVWStatus模型 */
 @property(nonatomic, strong) NSArray *statuses;

 /** 近期微博总数 */
 @property(nonatomic, assign) int total_number;

 @end

 

 //
 //  HVWHomeStatusResult.m
 //  HVWWeibo
 //
 //  Created by hellovoidworld on 15/2/9.
 //  Copyright (c) 2015年 hellovoidworld. All rights reserved.
 //

 #import "HVWHomeStatusResult.h"
 #import "MJExtension.h"

 @implementation HVWHomeStatusResult

 /** 指明将json数组元素转为什么模型类 */
 - (NSDictionary *)objectClassInArray {
     return @{@"statuses":[HVWStatus class]};
 }

 @end

 

c.公共请求工具类

内部处理模型转字典的逻辑

 //
 //  HVWBaseTool.h
 //  HVWWeibo
 //
 //  Created by hellovoidworld on 15/2/10.
 //  Copyright (c) 2015年 hellovoidworld. All rights reserved.
 //

 #import <Foundation/Foundation.h>

 @interface HVWBaseTool : NSObject

 /** GET请求 */
 + (void) getWithUrl:(NSString *)url parameters:(id)parameters resultClass:(Class)resultClass success:(void (^)(id))success failure:(void (^)(NSError *))failure;

 /** POST请求(不带文件参数) */
 + (void) postWithUrl:(NSString *)url parameters:(id)parameters resultClass:(Class)resultClass success:(void (^)(id))success failure:(void (^)(NSError *))failure;

 /** POST请求(带文件参数) */
 + (void) postWithUrl:(NSString *)url parameters:(id)parameters filesData:(NSArray *)filesData resultClass:(Class)resultClass success:(void (^)(id))success failure:(void (^)(NSError *))failure;

 @end

 

 //
 //  HVWBaseTool.m
 //  HVWWeibo
 //
 //  Created by hellovoidworld on 15/2/10.
 //  Copyright (c) 2015年 hellovoidworld. All rights reserved.
 //

 #import "HVWBaseTool.h"
 #import "HVWNetworkTool.h"
 #import "MJExtension.h"

 @implementation HVWBaseTool

 /** GET请求 */
 + (void) getWithUrl:(NSString *)url parameters:(id)parameters resultClass:(Class)resultClass success:(void (^)(id))success failure:(void (^)(NSError *))failure {

     // 解析出参数
     NSDictionary *param = [parameters keyValues];

     [HVWNetworkTool get:url parameters:param success:^(id responseObject) {
         if (success) {
             id result = [resultClass objectWithKeyValues:responseObject];
             success(result);
         }
     } failure:^(NSError *error) {
         if (failure) {
             if (failure) {
                 failure(error);
             }
         }
     }];
 }

 /** POST请求(不带文件参数) */
 + (void) postWithUrl:(NSString *)url parameters:(id)parameters resultClass:(Class)resultClass success:(void (^)(id))success failure:(void (^)(NSError *))failure {

     // 解析出参数
     NSDictionary *param = [parameters keyValues];

     [HVWNetworkTool post:url parameters:param success:^(id responseObject) {
         if (success) {
             id result = [resultClass objectWithKeyValues:responseObject];
             success(result);
         }
     } failure:^(NSError *error) {
         if (failure) {
             if (failure) {
                 failure(error);
             }
         }
     }];
 }

 /** POST请求(带文件参数) */
 + (void) postWithUrl:(NSString *)url parameters:(id)parameters filesData:(NSArray *)filesData resultClass:(Class)resultClass success:(void (^)(id))success failure:(void (^)(NSError *))failure {

     // 解析出参数
     NSDictionary *param = [parameters keyValues];

     [HVWNetworkTool post:url parameters:param filesData:filesData success:^(id responseObject) {
         if (success) {
             id result = [resultClass objectWithKeyValues:responseObject];
             success(result);
         }
     } failure:^(NSError *error) {
         if (failure) {
             if (failure) {
                 failure(error);
             }
         }
     }];
 }

 @end

 

d.微博请求工具类

 //
 //  HVWStatusTool.h
 //  HVWWeibo
 //
 //  Created by hellovoidworld on 15/2/9.
 //  Copyright (c) 2015年 hellovoidworld. All rights reserved.
 //

 #import <Foundation/Foundation.h>
 #import "HVWBaseTool.h"
 #import "HVWHomeStatusParam.h"
 #import "HVWHomeStatusResult.h"

 @interface HVWStatusTool : HVWBaseTool

 /** 获取首页微博数据 */
 + (void) statusWithParameters:(HVWHomeStatusParam *)parameters success:(void (^)(HVWHomeStatusResult *statusResult))success failure:(void (^)(NSError *error))failure;

 @end

 

 //
 //  HVWStatusTool.m
 //  HVWWeibo
 //
 //  Created by hellovoidworld on 15/2/9.
 //  Copyright (c) 2015年 hellovoidworld. All rights reserved.
 //

 #import "HVWStatusTool.h"
 #import "MJExtension.h"

 @implementation HVWStatusTool

 /** 获取首页微博数据 */
 + (void) statusWithParameters:(HVWHomeStatusParam *)parameters success:(void (^)(HVWHomeStatusResult *statusResult))success failure:(void (^)(NSError *error))failure {
     // 发送请求
     [self getWithUrl:@"https://api.weibo.com/2/statuses/home_timeline.json" parameters:parameters resultClass:[HVWHomeStatusResult class] success:success failure:failure];
 }

 @end

 

==》以此类推，可以封装“发送微博”、“获取用户信息”等，其实就是一个微博API请求封装一套（参数 、结果和请求工具方法）