一个演示怎样使用 weiboclient4j
的Demo应用:
新浪微博官方推荐的Java客户端 weibo4j 一直没有发布到maven仓库,而我们是重度maven用户,因而重新发明了这个新的轮子。
在项目pom.xml里面加入依赖:
<dependency>
<groupId>com.github.hoverruan</groupId>
<artifactId>weiboclient4j</artifactId>
<version>0.4.13</version>
</dependency>
Weiboclient4j支持新浪微博API V1和V2(未完成),目前推荐使用V2版本的接口:
// 使用你的应用的api key和secret
String apiKey = "xxxxxxx";
String apiSecret = "xxxxxxxx";
WeiboClient client = new WeiboClient(apiKey, apiSecret);
OAuth2例子:
String authorizationCallback = "..."; // 你的Callback地址
String state = "...";
String url = client.getAuthorizationUrl(ResponseType.Code, DisplayType.Default, state, authorizationCallback);
// 浏览器重定向到url; 用户授权; 然后返回callback地址
String code = ... // 从新浪的回调请求里面获得code
String accessTokenCallback = "..."; // 或者Access Token的Callback地址
SinaWeibo2AccessToken accessToken = client.getAccessTokenByCode(code, accessTokenCallback);
System.out.println("Access token: " + accessToken.getToken());
System.out.println("User Uid: " + accessToken.getUid());
System.out.println("Expires in: " + accessToken.getExpiresIn());
System.out.println("Remind in: " + accessToken.getRemindIn());
获取用户Timeline例子:
StatusService service = client.getStatusService();
Timeline friendsTimeline = service.getFriendsTimeline();
更多的使用例子可以参考 weiboclient4j.examples.OAuth2CommandLine
WeiboClient里面,大部分的方法都没有Javadoc,取而代之的是大部分的参数都是特定的对象,这样做的原因是因为:
- 写Javadoc太麻烦
- 一些API的参数较多,如果使用基本类型容易混淆各个参数的含义
- IDE对已知类型的对象、Enum能提供更友好的提醒和自动完成
所有的参数对象在 package weiboclient4j.params
下面;举一个例子:
使用静态引入 CoreParameters.*:
import static weiboclient4j.params.CoreParameters.*;
FriendshipService service = client.getFriendshipService();
Friendship friendship;
friendship = service.getFriendship(sourceUid(12345), targetUid(67890));
// 或者
friendship = service.getFriendship(sourceScreenName("xxx"), targetScreenName("yyy"));
使用 P:
import weiboclient4j.params.P;
FriendshipService service = client.getFriendshipService();
Friendship friendship;
friendship = service.getFriendship(P.sourceUid(12345), P.targetUid(67890));
// 或者
friendship = service.getFriendship(P.sourceScreenName("xxx"), P.targetScreenName("yyy"));
分页相关的参数,全部通过 Paging
对象封装:
Paging paging = Paging.create()
.sinceId(12345)
.count(25);
Timeline timeline = service.getFriendsTimeline(paging, BaseApp.No, Feature.All); // 后两个参数可省略
微博接口 | StatusService | 完成 |
评论接口 | CommentService | 完成 |
用户接口 | UserService | 完成 |
关系接口 | FriendshipService | 完成 |
帐号接口 | AccountService | 完成 |
收藏接口 | FavoriteService | 完成 |
话题接口 | TrendService | 完成 |
标签接口 | TagService | 完成 |
注册接口 | RegisterService | 完成 |
搜索接口 | SearchService | 完成 |
推荐接口 | SuggestionService | 完成 |
提醒接口 | RemindService | 完成 |
短链接口 | ShortUrlService | 完成 |
通知接口 | NotificationService | 完成 |
公共服务接口 | CommonService | 完成 |
位置服务接口 | PlaceService | 完成 |
地理信息接口 | LocationService | 开发中 |
阮永沛Hover @ 新浪微博