豆瓣客户端(三)发送图文广播

这只是一个简单的Demo,功能是调用豆瓣的接口发送图文广播。功能并不齐全,只是为网络编程练练手而已。

首先强调,这里没有用到第三方类库,也没有使用豆瓣的iOS SDK,都是直接用iOS给出的类和接口写的,只有代码是自己的,才真正有一种踏实的感觉。

当然第三方类库也非常好用,而且我也非常尊敬开发者开源共享的精神。


广播接口的主要内容如下:

URL

shuo/v2/statuses/

HTTP请求方式

POST
’我说‘类型的广播中如果需要附带图片,注意采用multipart/form-data编码方式上传,上传图片大小限制为<3M,仅支持JPEG,GIF,PNG图片,name 是 image

请求参数

  必选 类型及范围 说明
source true string appkey
text true string 广播文本内容
image false bytes 我说的图
rec_title false string 推荐网址的标题
rec_url false string 推荐网址的href
rec_desc false string 推荐网址的描述
rec_image false string 推荐网址的附图url

调用示例

curl "https://api.douban.com/shuo/v2/statuses/" -H "Authorization: Bearer TOKEN"  -F "text=TestText"  -F "image=@upload.png"
分析:

接口:https://api.douban.com/shuo/v2/statuses/

请求方式:POST

请求参数:source(必须,NSString),text(必须,NSString),image(可选,二进制数据)。

请求头:Authorization : Bearer ACCESS_TOKEN


首先是认证授权,不多说。

接着来到发广播界面:


对应SayViewController,下面看看该ViewController的接口部分:

#import <UIKit/UIKit.h>

@interface SayViewController : UIViewController <UITextViewDelegate, NSURLConnectionDataDelegate, NSURLConnectionDelegate>
@property (weak, nonatomic) IBOutlet UITextView *myWords_textView; // 广播内容编辑框
@property (weak, nonatomic) IBOutlet UIBarButtonItem *send_buttonItem; // 发送按钮
- (IBAction)sendMyWords:(id)sender; // 发送广播
@property (strong, nonatomic) NSMutableData *responseData; // 发送广播后返回的数据
@end

如果是单纯的发送文字内容则非常简单:

- (IBAction)sendMyWords:(id)sender {
    [myWords_textView resignFirstResponder];
    if ([myWords_textView.text isEqualToString:@""]) {
        UIAlertView *av = [[UIAlertView alloc] initWithTitle:@"发表广播失败"
                                                     message:@"你输入的广播内容为空"
                                                    delegate:nil cancelButtonTitle:@"确定" otherButtonTitles:nil, nil];
        [av show];
    }
    else {
        //  -- 建立URL请求对象 --
        NSMutableURLRequest *request = [[NSMutableURLRequest alloc] initWithURL:[NSURL URLWithString:SEND_BROADCAST_URL]
                                                                    cachePolicy:NSURLRequestReloadIgnoringCacheData
                                                                timeoutInterval:20.0];
        
        //  -- 设置HTTP请求方式为POST --
        [request setHTTPMethod:@"POST"];
        
        //  -- 设置HTTP请求的BODY数据 --
        NSString *paramSource = [NSString stringWithFormat:@"source=%@", API_KEY];
        NSString *paramText = [NSString stringWithFormat:@"text=%@", myWords_textView.text];
        NSString *parameters = [NSString stringWithFormat:@"%@&%@", paramSource, paramText];
        NSMutableData *postData = [[NSMutableData alloc] init];
        [postData appendData:[parameters dataUsingEncoding:NSUTF8StringEncoding]];
        [request setHTTPBody:postData];
        
        //  -- 设置HTTP请求头部分 --
        NSString *bearerToken = [NSString stringWithFormat:@"Bearer %@", [OAuthViewController getAccessToken]];
        [request setValue:bearerToken forHTTPHeaderField:@"Authorization"];
        
        //  -- 建立URL连接 --
        NSURLConnection *connection = [[NSURLConnection alloc] initWithRequest:request delegate:self];
        if (connection) {
            [connection start];
        }
    }
}

首先以接口网址初始化请求。

然后设置参数,并编码成二进制数据:

NSString *parameters = [NSString stringWithFormat:@"%@&%@", paramSource, paramText];
[parameters dataUsingEncoding:NSUTF8StringEncoding]

再将其编码好的二进制数据设置为HTTP请求的BODY。

在设置好请求头后,建立URL连接,start即可。

利用NSURLConnection和NSURLConnectionData的委托可以获取返回的数据:

#pragma mark -
#pragma mark NSURLConnection or NSURLConnectionData delegate

- (void)connection:(NSURLConnection *)connection didReceiveResponse:(NSURLResponse *)response {
    if (response) {
        responseData = [[NSMutableData alloc] initWithLength:0];
    }
}

- (void)connection:(NSURLConnection *)connection didReceiveData:(NSData *)data {
    if (data) {
        [responseData appendData:data];
    }
}

- (void)connectionDidFinishLoading:(NSURLConnection *)connection {
    NSError *error = nil;
    NSDictionary *dic = [NSJSONSerialization JSONObjectWithData:responseData options:kNilOptions error:&error];
    NSLog(@"dic = %@", dic);
    
    UIAlertView *av = nil;
    if (!dic || dic[@"code"]) {
        av = [[UIAlertView alloc] initWithTitle:@"发送失败"
                                        message:@"未知错误"
                                       delegate:nil cancelButtonTitle:@"确定" otherButtonTitles:nil, nil];
    }
    else {
        av = [[UIAlertView alloc] initWithTitle:@"发送成功"
                                        message:@"Congratulations"
                                       delegate:nil cancelButtonTitle:@"Good" otherButtonTitles:nil, nil];
    }
    [av show];
}

- (void)connection:(NSURLConnection *)connection didFailWithError:(NSError *)error {
    UIAlertView *av = [[UIAlertView alloc] initWithTitle:@"发生错误"
                                                 message:[error localizedDescription]
                                                delegate:nil
                                       cancelButtonTitle:@"确定" otherButtonTitles:nil, nil];
    [av show];
}

其中使用responseData来接收返回的数据。

注意responseData是NSMutableData类型,首先如果收到服务器的响应就调用DidReceiveResponse就初始化该变量,但长度为0。

随着服务器不断返回数据,在DidReceiveData的不断调用中补全接收到的数据。

在接收数据完成后调用DidFinishLoading进行处理,如果接收数据失败就调用DidFailWithError作出错处理。

Run一下:


点击发送后,在我的豆瓣中的我的广播中可以看到结果:



真正麻烦的是要实现图文广播,注意这里强调的是不使用第三方类库或者豆瓣给出的SDK。

先看看文档的说明:

’我说‘类型的广播中如果需要附带图片,注意采用multipart/form-data编码方式上传,上传图片大小限制为<3M,仅支持JPEG,GIF,PNG图片,name 是 image
multipart/form-data编码方式,也就是要把各个字段分开分别编码,然后将合起来的二进制数据设置为请求的BODY再POST到服务器。

好吧,我对HTTP协议,报文内容什么的的确了解不多,看来专业课的理论知识还是非常重要的。

在参考了网上一些文章后才大致明白其编码的工作方式,最后参考一下豆瓣SDK中的代码还是解决了该部分的内容。

先给出两篇挺有价值的参考文章:

IOS Post form(data and pic)I

【原】iOS通过http post上传图片(头像是个帅哥来的,感谢这位帅哥的分享)

在参考了豆瓣的SDK的源码后,我大致假设HTTP请求报文内容如下:

Content-type: multipart/form-data, charset=utf-8, boundary=KhTmLbOuNdArY, Authorization=Bearer access_token
        
--KhTmLbOuNdArY
Content-disposition: form-data; name="source"
        
AppKey对应的内容
--KhTmLbOuNdArY
Content-disposition: form-data; name="text"
        
要发送的广播内容
--KhTmLbOuNdArY
content-disposition: form-data; name="image"; filename="WW.jpg"
Content-Type: image/png
        
... contents of WW.jpg ...
--KhTmLbOuNdArY--

其中WW.jpg就是我要POST的一张图片。


下面逐段贴上代码吧:

首先设置好请求头内容(Content-type: multipart/form-data, charset=utf-8, boundary=KhTmLbOuNdArY, Authorization=Bearer access_token)和请求方式为POST。

        //  -- 设置HTTP请求方式和请求头 --
        // 请求头的内容:
        // Content-type: multipart/form-data, charset=utf-8, boundary=KhTmLbOuNdArY, Authorization=Bearer access_token
        NSString *charset = (NSString *)CFStringConvertEncodingToIANACharSetName(CFStringConvertNSStringEncodingToEncoding(NSUTF8StringEncoding));
        CFUUIDRef uuid = CFUUIDCreate(nil);
        NSString *uuidString = (NSString*)CFBridgingRelease(CFUUIDCreateString(nil, uuid));
        CFRelease(uuid);
        NSString *stringBoundary = [NSString stringWithFormat:@"0xKhTmLbOuNdArY-%@",uuidString];
        NSString *endItemBoundary = [NSString stringWithFormat:@"\r\n--%@\r\n",stringBoundary];
        NSMutableURLRequest *request = [[NSMutableURLRequest alloc] initWithURL:[NSURL URLWithString:SEND_BROADCAST_URL]];
        [request setHTTPMethod:@"POST"];
        [request setValue:[NSString stringWithFormat:@"multipart/form-data; charset=%@; boundary=%@", charset, stringBoundary] forHTTPHeaderField:@"Content-Type"];
        NSString *bearerToken = [NSString stringWithFormat:@"Bearer %@", [OAuthViewController getAccessToken]];
        [request setValue:bearerToken forHTTPHeaderField:@"Authorization"];


然后开始对BODY的内容进行逐段二进制编码:

        //  -- 对要POST的数据进行编码并设置HTTP请求的BODY --
        // 开头的boundary:
        // --KhTmLbOuNdArY
        NSMutableData *postData = [[NSMutableData alloc] init];
        [postData appendData:[[NSString stringWithFormat:@"--%@\r\n",stringBoundary] dataUsingEncoding:NSUTF8StringEncoding]];
        
        // source参数对应的key和内容:
        // Content-disposition: form-data; name="source"
        //
        // AppKey对应的内容
        NSString *kSource = [NSString stringWithFormat:@"Content-Disposition: form-data; name=\"source\"\r\n\r\n"];
        [postData appendData:[kSource dataUsingEncoding:NSUTF8StringEncoding]];
        NSString *vSource = [NSString stringWithFormat:@"source=%@", API_KEY];
        [postData appendData:[vSource dataUsingEncoding:NSUTF8StringEncoding]];
        
        // 分割字段内容的boundary:
        // --KhTmLbOuNdArY
        [postData appendData:[endItemBoundary dataUsingEncoding:NSUTF8StringEncoding]];
        
        // text参数对应的key和内容:
        // Content-disposition: form-data; name="text"
        //
        // 要发送的广播内容
        NSString *kText = [NSString stringWithFormat:@"Content-Disposition: form-data; name=\"text\"\r\n\r\n"];
        [postData appendData:[kText dataUsingEncoding:NSUTF8StringEncoding]];
        NSString *vText = myWords_textView.text;
        [postData appendData:[vText dataUsingEncoding:NSUTF8StringEncoding]];
        
        // 分割字段内容的boundary:
        // --KhTmLbOuNdArY
        [postData appendData:[endItemBoundary dataUsingEncoding:NSUTF8StringEncoding]];
        
        // image参数对应的key和内容:
        // content-disposition: form-data; name="image"; filename="WW.jpg"
        // Content-Type: image/png
        //
        // ... contents of WW.jpg ...
        NSString *kImage = [NSString stringWithFormat:@"Content-Disposition: form-data; name=\"image\"; filename=\"WW.jpg\"\r\n"];
        [postData appendData:[kImage dataUsingEncoding:NSUTF8StringEncoding]];
        NSString *tImage = [NSString stringWithFormat:@"Content-Type: %@\r\n\r\n", @"image/jpeg"];
        [postData appendData:[tImage dataUsingEncoding:NSUTF8StringEncoding]];
        UIImage *pickedImage = [UIImage imageNamed:@"WW.jpg"];
        // NSData *imageData = UIImagePNGRepresentation(pickedImage); // png格式
        NSData *imageData = UIImageJPEGRepresentation(pickedImage, 0.0); // jpg格式,1.0表示最大压缩,0.0表示图像无压缩
        [postData appendData:imageData];
        
        // 结尾的boundary
        // --KhTmLbOuNdArY--
        [postData appendData:[[NSString stringWithFormat:@"\r\n--%@--\r\n",stringBoundary] dataUsingEncoding:NSUTF8StringEncoding]];
        
        
        //  -- 设置HTTP的BODY和请求头中的Content-Length --
        NSString *length = [NSString stringWithFormat:@"%d", [postData length]];
        [request setValue:length forHTTPHeaderField:@"Content-Length"];
        [request setHTTPBody:postData];
最后建立URL连接,并通过委托获取服务器回调的数据,代码和上面的发文字广播相同,不再重复。

还是Run一下:


点了发送后,我的广播内容也更新了:


老白出现了,就是WW.jpg对应的图片内容。(看到老白最后倒在实验室含笑而终,Baby Blue音乐一直在唱,既感到欣慰又是心痛啊,永别了,我的老白)


该博客对应的Demo已经上传,欢迎下载交流。由于豆瓣应用的机制:只有添加为该应用的测试用户才可以授权给该应用并登录,所以如果你想运行该应用,可以自己新建一个豆瓣应用,再替换Demo中的DBAPIURL.h中的API_KEY,SECRET_KEY和REDIRECT_URI。或者你留下你豆瓣的uid,让我添加你为该应用的测试用户就可以使用了。



好了,最后小结一下。

主要说说POST数据的方法(不使用第三方类库,尽管它们非常好用)。

如果单纯是POST一些NSString等类型的数据,直接设置参数,再编码为NSData就可以了,例如获取token时:

    NSString *paramClinetID = [NSString stringWithFormat:@"client_id=%@", API_KEY];
    NSString *paramClientSecret = [NSString stringWithFormat:@"client_secret=%@", SECRET_KEY];
    NSString *paramRedirectURI = [NSString stringWithFormat:@"redirect_uri=%@", REDIRECT_URI];
    NSString *paramGrantType = @"grant_type=authorization_code";
    NSString *paramCode = [NSString stringWithFormat:@"code=%@", authorization_code];
    NSString *parameters = [NSString stringWithFormat:@"%@&%@&%@&%@&%@", paramClinetID, paramClientSecret, paramRedirectURI, paramGrantType, paramCode];
    NSMutableData *postData = [[NSMutableData alloc] init];
    [postData appendData:[parameters dataUsingEncoding:NSUTF8StringEncoding]];


如果要POST的数据中包含了多个字段,并且其中一些数据是图片,音乐等文件数据时,就要使用multi-part/form-data的编码方式了,说到底都是将各个字段的数据编码成二进制数据而已,关键是按报文数据的格式进行二进制数据编码。

最近要做一个将文件POST到服务器的功能,很简单地用ASI实现了,但是始终觉得代码不是自己的心里就不踏实,所以就回来写下豆瓣练练手,最终还是实现了豆瓣POST图片的功能。

另外,我对HTTP协议的了解不多(课程还没讲,而自己又很懒还没去看),所以难免会有许多错漏,希望大家指出错误,让我改正。



---------------------------------------------- 我是分割线 ------------------------------------------------------


昨晚看完了最后一集的绝命毒师,思绪万千,今天就忍不住在博客里写了下来,看代码的人可以忽略。

老白始终让我有一种很亲切的感觉,他的结局我感觉还算欣慰吧,起码他成功地反击了杰克军团,就走了小粉,安排好了家人的一切,并且死在了他最爱的实验室里,最后很安详地倒在了地上,含笑而终。

看见他在摸着实验室的仪器,流露出不舍的表情的时候,相信各位老白的粉丝心里都酸酸的。

好吧,最后仅以一句简单的豆瓣广播向我亲爱的老白说声再见吧。




  • 1
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值