本文主要是介绍豆瓣客户端(三)发送图文广播,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
这只是一个简单的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:NSURLRequestReloadIgnoringCacheDatatimeoutInterval: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:nilcancelButtonTitle:@"确定" 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_tokenNSString *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:// --KhTmLbOuNdArYNSMutableData *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到服务器的功能,很简单地用ASI实现了,但是始终觉得代码不是自己的心里就不踏实,所以就回来写下豆瓣练练手,最终还是实现了豆瓣POST图片的功能。
另外,我对HTTP协议的了解不多(课程还没讲,而自己又很懒还没去看),所以难免会有许多错漏,希望大家指出错误,让我改正。
---------------------------------------------- 我是分割线 ------------------------------------------------------
昨晚看完了最后一集的绝命毒师,思绪万千,今天就忍不住在博客里写了下来,看代码的人可以忽略。
老白始终让我有一种很亲切的感觉,他的结局我感觉还算欣慰吧,起码他成功地反击了杰克军团,就走了小粉,安排好了家人的一切,并且死在了他最爱的实验室里,最后很安详地倒在了地上,含笑而终。
看见他在摸着实验室的仪器,流露出不舍的表情的时候,相信各位老白的粉丝心里都酸酸的。
好吧,最后仅以一句简单的豆瓣广播向我亲爱的老白说声再见吧。
这篇关于豆瓣客户端(三)发送图文广播的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!