新浪微博SDK开发(1):总述
2018-06-18 05:08:33来源:未知 阅读 ()
花了几天时间,消耗了九牛六虎之力,新浪微博大部分API已经封装,但有部分API实在太难封装。
说起这封装,我必须严重地、从人品和技术层面鄙视一下新浪的程序员,实在太菜了。估计菜鸟都被大企业吸收了,菜到连面向对象都不懂。建议新浪的菜菜们向淘宝学习下,人家淘宝还同时有XML和JSON两种数据格式。
同样的内容,返回的JSON对象居然会出现不同结构,更可恶的,像公共API中获取城市列表,国家区域代码列表的返回结果,实在让人不得不发笑。那些JSON用JS读起来都困难,更何况要进行封装呢。根本没法封装,因此在论坛上抱怨的人不少,可是新浪官方呢,置之不管,就当没看见一样,看来,大企业就是这点水平。
题外话不多说,回归主题。除了权限不够和无法封装的API外,其余的API都封装了。先上一张代码地图。
这图有点像蜘蛛网,非常有美感,可惜是静止的,如果会动的,一定很好看。
我不可能把代码一行一行地向大家讲述,因为这样做会相当恶心。现在菜菜们都整天拿开源来装逼,所以,为了迎合广大菜菜所说的所谓“趋势”,我也决定把我这份乱七八糟的代码向全人类公开。
下载地址:http://vdisk.weibo.com/s/z7iFc2gCCwC1b
接下来,就给大家说说原理和思路,这才是编程的关键。
1、不管是微博API还是其他的开放平台的API,都有N多共同点。首先,用户要用自己的帐号登录,然后由用户决定是否授权给我们的应用程序,如果用户已同意授权,我们会得到一个授权码(Code)。
2、拿到Code后,我们要用这个Code来换取一个Access Token,就相当于用户授予我们一把钥匙,我们再用这把钥匙去开启库房的门,然后取出一个临时令牌,就好比在汉代,大臣代表天子巡视诸侯国时,手里要持着天子的符节一样。有了Token,我们的应用才能进行一系列操作。
微博的API的每一次调用,其实就是一轮HTTP请求-响应的往返过程,说白了,就是一问一答,我们调用API是问,服务器完成相关处理后返回结果给我们,为答。我们也知道,HTTP发送数据,用得最多的两种方法是GET和POST,至于是GET还是POST,我们按照API文档的说明去干就行了。
而对于服务器返回的数据(JSON),我是通过数据协定的形式来进行封装的。比如:
一个表示用户信息的回复JSON如下:
{ "id": 1404376560, "screen_name": "zaku", "name": "zaku", "province": "11", "city": "5", "location": "北京 朝阳区", "description": "人生五十年,乃如梦如幻;有生斯有死,壮士复何憾。", "url": "http://blog.sina.com.cn/zaku", "profile_image_url": "http://tp1.sinaimg.cn/1404376560/50/0/1", "domain": "zaku", "gender": "m", "followers_count": 1204, "friends_count": 447, "statuses_count": 2908, "favourites_count": 0, "created_at": "Fri Aug 28 00:00:00 +0800 2009", "following": false, "allow_all_act_msg": false, "geo_enabled": true, "verified": false, "status": { "created_at": "Tue May 24 18:04:53 +0800 2011", "id": 11142488790, "text": "我的相机到了。", "source": "<a href="http://weibo.com" rel="nofollow">新浪微博</a>", "favorited": false, "truncated": false, "in_reply_to_status_id": "", "in_reply_to_user_id": "", "in_reply_to_screen_name": "", "geo": null, "mid": "5610221544300749636", "annotations": [], "reposts_count": 5, "comments_count": 8 }, "allow_all_comment": true, "avatar_large": "http://tp1.sinaimg.cn/1404376560/180/0/1", "verified_reason": "", "follow_me": false, "online_status": 0, "bi_followers_count": 215 }
我们可以根据JSON中每个成员的名字,用代码封装成一个类。
/// <summary> /// 用户实体 /// </summary> [DataContract] public class UserInfo { /// <summary> /// 用户UID /// </summary> [DataMember(Name = "id")] public long ID { get; set; } /// <summary> /// 字符串型的用户UID /// </summary> [DataMember(Name = "idstr")] public string IDStr { get; set; } /// <summary> /// 用户昵称 /// </summary> [DataMember(Name = "screen_name")] public string ScreenName { get; set; } /// <summary> /// 友好显示名称 /// </summary> [DataMember(Name = "name")] public string Name { get; set; } /// <summary> /// 用户所在省级ID /// </summary> [DataMember(Name = "province")] public int Province { get; set; } /// <summary> /// 用户所在城市ID /// </summary> [DataMember(Name = "city")] public int City { get; set; } /// <summary> /// 用户所在地 /// </summary> [DataMember(Name = "location")] public string Location { get; set; } /// <summary> /// 用户个人描述 /// </summary> [DataMember(Name = "description")] public string Description { get; set; } /// <summary> /// 用户博客地址 /// </summary> [DataMember(Name = "url")] public string Url { get; set; } /// <summary> /// 用户头像地址(中图),50×50像素 /// </summary> [DataMember(Name = "profile_image_url")] public string ProfileImageUrl { get; set; } /// <summary> /// 用户的微博统一URL地址 /// </summary> [DataMember(Name = "profile_url")] public string ProfileUrl { get; set; } /// <summary> /// 用户的个性化域名 /// </summary> [DataMember(Name = "domain")] public string Domain { get; set; } /// <summary> /// 用户的微号 /// </summary> [DataMember(Name = "weihao")] public string WeiHao { get; set; } /// <summary> /// 性别,m:男、f:女、n:未知 /// </summary> [DataMember(Name = "gender")] public string Gender { get; set; } /// <summary> /// 粉丝数 /// </summary> [DataMember(Name = "followers_count")] public int FollowersCount { get; set; } /// <summary> /// 关注数 /// </summary> [DataMember(Name = "friends_count")] public int FriendsCount { get; set; } /// <summary> /// 微博数 /// </summary> [DataMember(Name = "statuses_count")] public int StatusesCount { get; set; } /// <summary> /// 收藏数 /// </summary> [DataMember(Name = "favourites_count")] public int FavouritesCount { get; set; } /// <summary> /// 用户创建(注册)时间 /// </summary> [DataMember(Name = "created_at")] public string CreatedAt { get; set; } /// <summary> /// 暂未支持 /// </summary> [DataMember(Name = "following")] public bool Following { get; set; } /// <summary> /// 是否允许所有人给我发私信,true:是,false:否 /// </summary> [DataMember(Name = "allow_all_act_msg")] public bool AllowAllActMsg { get; set; } /// <summary> /// 是否允许标识用户的地理位置,true:是,false:否 /// </summary> [DataMember(Name = "geo_enabled")] public bool GeoEnabled { get; set; } /// <summary> /// 是否是微博认证用户,即加V用户,true:是,false:否 /// </summary> [DataMember(Name = "verified")] public bool Verified { get; set; } /// <summary> /// 暂未支持 /// </summary> [DataMember(Name = "verified_type")] public int VerifiedType { get; set; } /// <summary> /// 用户备注信息 /// </summary> [DataMember(Name = "remark")] public string Remark { get; set; } /// <summary> /// 用户的最近一条微博信息 /// </summary> [DataMember(Name = "status")] public Status Status { get; set; } /// <summary> /// 当对象数据未返回完整微博信息时,将填充该字段 /// </summary> [DataMember(Name = "status_id")] public long StatusID { get; set; } /// <summary> /// 是否允许所有人对我的微博进行评论,true:是,false:否 /// </summary> [DataMember(Name = "allow_all_comment")] public bool AllowAllComment { get; set; } /// <summary> /// 用户头像地址(大图),180×180像素 /// </summary> [DataMember(Name = "avatar_large")] public string AvatarLarge { get; set; } /// <summary> /// 用户头像地址(高清),高清头像原图 /// </summary> [DataMember(Name = "avatar_hd")] public string AvatarHd { get; set; } /// <summary> /// 认证原因 /// </summary> [DataMember(Name = "verified_reason")] public string VerifiedReason { get; set; } /// <summary> /// 该用户是否关注当前登录用户,true:是,false:否 /// </summary> [DataMember(Name = "follow_me")] public bool FollowMe { get; set; } /// <summary> /// 用户的在线状态,0:不在线、1:在线 /// </summary> [DataMember(Name = "online_status")] public int OnlineStatus { get; set; } /// <summary> /// 用户的互粉数 /// </summary> [DataMember(Name = "bi_followers_count")] public int BiFollowersCount { get; set; } /// <summary> /// 用户当前的语言版本,zh-cn:简体中文,zh-tw:繁体中文,en:英语 /// </summary> [DataMember(Name = "lang")] public string Lang { get; set; } }
其中,Status属性表示用户发表的最新一条微博,它由一个表示微博的对象构成。
{ "created_at": "Tue May 24 18:04:53 +0800 2011", "id": 11142488790, "text": "我的相机到了。", "source": "<a href="http://weibo.com" rel="nofollow">新浪微博</a>", "favorited": false, "truncated": false, "in_reply_to_status_id": "", "in_reply_to_user_id": "", "in_reply_to_screen_name": "", "geo": null, "mid": "5610221544300749636", "annotations": [], "reposts_count": 5, "comments_count": 8 }
同样,我们也用一个数据协定类来封装它,表示一条微博的信息。
/// <summary> /// 微博实体 /// </summary> [DataContract] public class Status { /// <summary> /// 微博创建时间 /// </summary> [DataMember(Name = "created_at")] public string CreateAt { get; set; } /// <summary> /// 微博ID /// </summary> [DataMember(Name = "id")] public Int64 ID { get; set; } /// <summary> /// 微博MID /// </summary> [DataMember(Name = "mid")] public Int64 MID { set; get; } /// <summary> /// 字符串型的微博ID /// </summary> [DataMember(Name = "idstr")] public string IDStr { get; set; } /// <summary> /// 微博信息内容 /// </summary> [DataMember(Name = "text")] public string Text { get; set; } /// <summary> /// 微博来源 /// </summary> [DataMember(Name = "source")] public string Source { get; set; } /// <summary> /// 是否已收藏,true:是,false:否 /// </summary> [DataMember(Name = "favorited")] public bool Favorited { get; set; } /// <summary> /// 是否被截断,true:是,false:否 /// </summary> [DataMember(Name = "truncated")] public bool Truncated { get; set; } /// <summary> /// (暂未支持)回复ID /// </summary> [DataMember(Name = "in_reply_to_status_id")] public string InReplyToStatusID { get; set; } /// <summary> /// (暂未支持)回复人UID /// </summary> [DataMember(Name = "in_reply_to_user_id")] public string InReplyToUserID { get; set; } /// <summary> /// (暂未支持)回复人昵称 /// </summary> [DataMember(Name = "in_reply_to_screen_name")] public string InReplyToScreenName { get; set; } /// <summary> /// 缩略图片地址 /// </summary> [DataMember(Name = "thumbnail_pic")] public string ThumbnailPic { get; set; } /// <summary> /// 中等尺寸图片地址 /// </summary> [DataMember(Name = "bmiddle_pic")] public string BmiddlePic { get; set; } /// <summary> /// 原始图片地址 /// </summary> [DataMember(Name = "original_pic")] public string OriginalPic { get; set; } /// <summary> /// 地理信息 /// </summary> [DataMember(Name = "geo")] public GeoInfo Geo { get; set; } /// <summary> /// 微博作者的用户信息 /// </summary> [DataMember(Name = "user")] public UserInfo User { get; set; } /// <summary> /// 被转发的原微博信息字段,当该微博为转发微博时返回 /// </summary> [DataMember(Name = "retweeted_status")] public Status RetweetedStatus { get; set; } /// <summary> /// 转发数 /// </summary> [DataMember(Name = "reposts_count")] public int RepostsCount { get; set; } /// <summary> /// 评论数 /// </summary> [DataMember(Name = "comments_count")] public int CommentsCount { get; set; } /// <summary> /// 表态数 /// </summary> [DataMember(Name = "attitudes_count")] public int AttitudesCount { get; set; } /// <summary> /// 暂未支持 /// </summary> [DataMember(Name = "mlevel")] public int Mlevel { get; set; } /// <summary> /// 微博的可见性及指定可见分组信息。该object中type取值,0:普通微博,1:私密微博,3:指定分组微博,4:密友微博;list_id为分组的组号 /// </summary> [DataMember(Name = "visible")] public dynamic Visible { get; set; } /// <summary> /// 微博配图地址。多图时返回多图链接。无配图返回“[]” /// </summary> [DataMember(Name = "pic_urls")] public dynamic PicUrls { get; set; } /// <summary> /// 微博流内的推广微博ID /// </summary> [DataMember(Name = "ad")] public dynamic Ad { get; set; } /// <summary> /// 当不返回user字段时,此属性可填充UID /// </summary> [DataMember(Name = "uid")] public long Uid { get; set; } }
我们在接收到服务器的回应后,直接对数据进行反序列化,就可以得到这些数据的封装实例,面向对象,操作起来更方便。这些被封装的基本类型,我都放到了Models目录下。为了实现反序列化,我定义了一个类,公开一个静态方法,以便从JSON数据生成对象实例。
public class JsonSerializeHelper { public static T ReadDataFromJson<T>(Stream inStream) { DataContractJsonSerializer s = new DataContractJsonSerializer(typeof(T)); return (T)s.ReadObject(inStream); } }
因为我们要反序列化的类型是多种多样的,无法定论,因此,这里使用泛型参数较合适。具体反序列化为哪种类型的实例,在运行时决定。
由于每个API的调用都是一轮HTTP请求/回应,无论你调用哪个API都一样,这个行为是通过的,所以,我就统一进行提取,并使用.NET 4.5新增的HttpClient类来处理,这个类很强大,把一些不太好处理的HTTP请求都为我们封装好了,尤其是像form-data这种POST的数据,如MultiPart form data这些,尤其是向服务器上传文件时较容易处理,省去许多不必要的机械性工作,将人类从无必要的代码中解放出来,极大地提高生产率,这是.NET最牛X的地方。
internal static async Task<TResult> SendRequestWithMultipartFormDataAsync<TResult>(string relateUrl, IDictionary<string, object> parms, string filename) { Uri reqUri = new Uri(API_BASE_RUI); reqUri = new Uri(reqUri, relateUrl); TResult result = default(TResult); using (HttpClient client = new HttpClient()) { string b = "---------------------" + DateTime.Now.Ticks.ToString("x"); MultipartFormDataContent formData = new MultipartFormDataContent(b); foreach (var pair in parms) { string str = pair.Value as string; if (str != null) { StringContent stringContent = new StringContent(pair.Value as string); formData.Add(stringContent, pair.Key); } Stream stream = pair.Value as Stream; if (stream != null) { StreamContent streamContent = new StreamContent(stream); formData.Add(streamContent, pair.Key, filename); } } var response = await client.PostAsync(reqUri, formData); if (response.IsSuccessStatusCode) { using (Stream backstream = await response.Content.ReadAsStreamAsync()) { result = JsonSerializeHelper.ReadDataFromJson<TResult>(backstream); } } else { ErrorData err = null; using (Stream errstream = await response.Content.ReadAsStreamAsync()) { err = JsonSerializeHelper.ReadDataFromJson<ErrorData>(errstream); } throw new WeiboException(err); } } return result; } internal static async Task<string> HttpGetStringAsync(string relateUrl) { Uri base_uri = new Uri(API_BASE_RUI); Uri request_uri = new Uri(base_uri, relateUrl); string result = ""; using (HttpClient client = new HttpClient()) { result = await client.GetStringAsync(request_uri); } return result; } internal static async Task<Stream> HttpGetStreamAsync(string relateUrl) { Uri base_uri = new Uri(API_BASE_RUI); base_uri = new Uri(base_uri, relateUrl); Stream streamres = null; using (HttpClient client = new HttpClient()) { var streamtmp = await client.GetStreamAsync(base_uri); streamres = new MemoryStream(); streamtmp.CopyTo(streamres); streamtmp.Dispose(); } return streamres; }
上面仅仅列举了一两个方法,详细的代码大家可以下载源代码看。
在我发布的解决方案中,有一个项目名为WeiboTest,它是一个单元测试项目,是我在封装API过程用来测试调用而写的。
这个SDK可用在桌面程序和Web应用程序中,对于WP和Store App,我一开始是考虑建一个可移植的Portable项目的,但由于我仅在试水阶段,后来就没考虑移植了,其实绝大部分代码是可以通用的,但有一小部分不行,比如文件操作就不能通用,因为WP上的文件是通过独立存储来处理的,而不像桌面环境中那样使用物理文件来处理。等代码完善后,我会考虑将它改为一个通用类库。
下面就介绍一下我封装了哪些API。
一、登录授权部分我合为一体了,
不使用新浪弹出的授权页面,而是直接模拟用户登录时POST的数据,直接获取Code,然后调用OAuth2的API换取Token。同时还公开用于取消授权的RevokeOAuth2Async。
二、微博模块。
1、获取最近的公共微博列表,
2、获取好友/关注人/自己的最新微博列表。
3、获取与当前登录用户相互关注的用户的最新微博列表。
4、获取某条微博的转发列表。
5、获取@当前用户 的微博列表。
6、根据微博ID获取单条微博的详细信息。
7、批量获取微博的转发数和评论数。
8、微博ID和MID的相互获取。
9、获取微博官方表情列表。
10、转发微博。
11、发表微博 / 发表带图片的微博。
12、删除微博。
三、评论模块。
1、获取某条微博的评论列表。
2、获取当前登录用户所发表的评论列表。
3、获取当前用户接收到的评论列表。
4、获取@当前用户的评论列表。
5、批量获取评论列表。
6、发表评论。
7、删除指定评论。
8、批量删除评论。
9、回复某条评论。
四、帐号模块。
1、获取当前用户的隐私设置信息。是设置项,不是获取隐私,别想歪了。
2、获取学校列表,这个好像没什么用。
五、关系模块。
1、获取当前登录用户的关注列表。
2、获取两个用户之间的共同关注人列表。比如我关注了A,而C也关注了A,因而我和C的共同关注人就是A。
3、获取用户的相互关注人列表。也就是有哪些人跟我互粉。
4、获取当前用户的粉丝列表。即哪些人关注了我。
5、获取用户的活跃粉丝列表。这个不知道干什么的,反正我测试的时候返回空。
6、获取当前登录用户关注列表中同时关注了某用户的列表。比如,我关注了A,获取我关注的用户中也关注了A的用户列表。
7、关注一位用户。
8、取消关注某位用户。
六、用户模块。
1、根据用户ID获取用户信息。
2、批量获取用户的关注数、粉丝数、微博数。
3、通过个性域名获取用户信息以及最新发表的一条微博。
七、短链接模块。
1、长链接转为短链接。
2、短链接转为长链接。
八、地理位置模块。
1、根据IP地址返回地理信息。
2、根据具体地址返回地理坐标信息。
3、根据地理坐标(经度,纬度)返回地址信息。
这个SDK不算很完美,由于新浪的程序员比较菜,有些JSON数据结构相当不合理,暂时无法封装,等到哪天我想到解决方法后再补充。
标签:
版权申明:本站文章部分自网络,如有侵权,请联系:west999com@outlook.com
特别注意:本站所有转载文章言论不代表本站观点,本站所提供的摄影照片,插画,设计作品,如需使用,请与原作者联系,版权归原作者所有
- Spire.Cloud.SDK for Java 合并、拆分Excel单元格 2020-06-09
- JAVA实习面经+面试常问问题和流程(商汤,今日头条,微博) 2020-04-15
- 基于JAVA-SSM框架的B/S微博系统的设计与实现 2020-04-12
- 阿里云云服务器ECS开发者工具包(SDK) 2020-01-15
- 微博热搜、天猫秒杀、12306抢票,都是高并发,难点相同吗? 2019-12-29
IDC资讯: 主机资讯 注册资讯 托管资讯 vps资讯 网站建设
网站运营: 建站经验 策划盈利 搜索优化 网站推广 免费资源
网络编程: Asp.Net编程 Asp编程 Php编程 Xml编程 Access Mssql Mysql 其它
服务器技术: Web服务器 Ftp服务器 Mail服务器 Dns服务器 安全防护
软件技巧: 其它软件 Word Excel Powerpoint Ghost Vista QQ空间 QQ FlashGet 迅雷
网页制作: FrontPages Dreamweaver Javascript css photoshop fireworks Flash