SDK包(object c版) 由@Aevit 提供

广告位

该文档由 @Aevit 提供 6.4.1 使用说明 将框架目录下的 ./SDK/Objective-C/ 目录…

该文档由 @Aevit 提供

6.4.1 使用说明

将框架目录下的 ./SDK/Objective-C/ 目录中的全部代码拷贝到项目里面即可使用。如:
SDK包(object c版) 由@Aevit 提供

请求方式,可以使用系统的NSURLSession,或第三方的网络请求库等 这里我们使用第三方的AFNetworking,进行二次封装(https://github.com/AFNetworking/AFNetworking) 如需使用其他网络请求方式(如NSURLSession),请继承自PhalApiClient,重写request方法即可,可参考AFNPhalApiClient

6.4.2 代码示例

如下是使用的代码场景片段。

首先,我们需要导入SDK包:

#import "AFNPhalApiClient.h"

然后,准备按以下方法实现接口请求即可:

// 待POST的参数 NSDictionary *params = @{@"demo_key_1": @"your_key", @"demo_key_2": @"1.0"};  // 使用AFNPhalApiClient [[[[[AFNPhalApiClient sharedClient] withHost:@"http://api1.aevit.xyz/"] withService:@"Default.Index"] withParams:params] requestWithFormDataBlock:^(id formData) {     // 如需上传文件(图片等),请参照如下格式     [formData appendPartWithFileData:UIImageJPEGRepresentation([UIImage imageNamed:@"head.JPG"], 1) name:@"file" fileName:@"image.jpg" mimeType:@"image/jpeg"]; } completeBlock:^(id resultObject) {     PALog(@"resultObject: %@", resultObject); } failureBlock:^(NSError *error) {     PALog(@"error: %@", error); }];  // 打印url查看 PALog(@"total url: %@", [[AFNPhalApiClient sharedClient] printTotalUrlStr]);

6.4.3 运行效果

运行后,查询log,可以看到:
SDK包(object c版) 由@Aevit 提供

可以注意到,调用完成后,会有接口请求的链接和返回的结果,如:

2015-10-19 18:28:01.503 PhalApiClientDemo[23161:1199740] total url: http://api1.aevit.xyz/?service=Default.Index&demo_key_2=1.0&demo_key_1=your_key  2015-10-19 18:28:01.536 PhalApiClientDemo[23161:1199740] resultObject: {     data =     {         content = "PHPerU60a8U597dUff0cU6b22U8fceU4f7fU7528PhalApiUff01";         time = 1445250481;         title = "Hello World!";         version = "1.2.1";     };     msg = "";     ret = 200; }

6.4.4 扩展你的过滤器和结果解析器

(1)扩展过滤器

当服务端接口需要接口签名验证,或者接口参数加密传送,或者压缩传送时,可以实现此过滤器,以便和服务端操持一致。

当需要扩展时,分两步。首先,需要实现过滤器接口:

 @interface MyFilter : PhalApiClientFilter @end  @implementation PhalApiClientFilter /**  *  接口过滤器  *  可用于接口签名生成  *  *  @param service 接口服务名称  *  @param params  接口参数,注意是mutable变量,可以直接修改  */ - (void)filter:(NSString*)service params:(NSMutableDictionary*)params {     // 在此对接口进行过滤 } @end

然后设置过滤器:

[[[[[[AFNPhalApiClient sharedClient] withHost:BASE_URL] withService:@"Default.Index"] withParams:params]       withFilter:[MyFilter new]] // filter      requestWithFormDataBlock:^(id formData) {     } completeBlock:^(id resultObject) {     } failureBlock:^(NSError *error) { }];

(2)扩展结果解析器

当返回的接口结果不是JSON格式时,如XML,请上google搜索“AFNetworking XML”相关资料即可)。

关于作者: 华为工程师芊芊

为您推荐

广告位

发表评论