[iOS微博项目

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请求封装一套（参数 、结果和请求工具方法）