oauth_china_android

简介

• 实现了新浪微博，腾讯微博，QQ，豆瓣，人人等平台的OAuth2验证

• 提供了统一的接口，简单方便的对接上述平台

• 采用加密方式持久化了OAuth2验证得到的access_token，expires_in，refresh_token，uid等信息

• 

说明

• oauth_china_android是android的library project，添加到android的project里面即可。
• oauth_china_android_demo是实现的demo。MainActivity中是所有平台的示例。SimpleActivity中演示了使用一个平台的简单的使用方法。demo中所有申请的appkey都是未发布的，所以没有被添加测试账号的人无法使用。

演示

// 实例化对应平台的OAuthConfig对象
OAuthConfig config = new SinaConfig("2489004023",
				"990329a88e14d1ab133ac006e7e018f9", "http://www.sina.com");
				
// 实例化OAuthChina对象，OAuthChina类是主要使用的类
OAuthChina oauthChina = new OAuthChina(this, config);
		
// 获取token信息
Token token = oauthChina.getToken();
if (token != null) {
	// token存在
	if (token.isSessionValid()) {
		// token有效
		Log.d(TAG, "token: " + token.toString());
	} else {
		// token过期
		oauthChina
				.refreshToken(token.getRefreshToken(), mOAuthListener);
	}
} else {
	// token不存在，开启OAuth验证
	oauthChina.startOAuth(mOAuthListener);
}

// 清空token信息
// oauthChina.clearToken();

// 使用refresh_token刷新access_token，部分公司提供的oauth验证不支持refresh_token
// oauthChina.refreshToken(token.getRefreshToken(), mOAuthListener);

OAuthListener mOAuthListener = new OAuthListener() {

	@Override
	public void onSuccess(Token token) {
		// 获取token成功
		Log.d(TAG, "token: " + token.toString());
	}

	@Override
	public void onError(String error) {
		// 获取token失败
		Log.d(TAG, "error: " + error);
	}

	@Override
	public void onCancel() {
		// 用户取消了操作
		Log.d(TAG, "cancel");

	}
};

详细说明

OAuthConfig(String appKey, String appSecret, String redirectUrl)

• appKey 对应平台的appkey
• appSecret 对应平台的appSecret
• redirectUrl 对应平台的回调地址

OAuthChina(Context context, OAuthConfig config)

• context
• config 对应平台的OAuthConfig实例

public interface OAuthListener {

	void onSuccess(Token token);
	
	void onCancel();
	
	void onError(String error);
	
}

• onSuccess OAuth验证成功后回调，token是返回的token信息
• onCancel 用户取消OAuth验证
• onError OAuth出现错误

class Token

• 详见Token类代码

API文档

• 新浪微博API文档: http://open.weibo.com/wiki/API%E6%96%87%E6%A1%A3_V2
• 腾讯微博API文档: http://wiki.open.t.qq.com/index.php/API%E6%96%87%E6%A1%A3
• QQ API文档: http://wiki.opensns.qq.com/wiki/%E3%80%90QQ%E7%99%BB%E5%BD%95%E3%80%91API%E6%96%87%E6%A1%A3
• 豆瓣API文档: http://developers.douban.com/wiki/?title=api_v2
• 人人API文档: http://wiki.dev.renren.com/wiki/API

依赖

https://github.com/loopj/android-async-http An asynchronous, callback-based Http client for Android built on top of Apache's HttpClient libraries.

License

This program is free softwareyou can redistribute it and /or modify it under the terms of the GNU General Public License as published by the Free Software Foundataioneither version 2 of the License,or (at your option) any later version.

You should have read the GNU General Public License before start "RTFSC".

If not,see http://www.gnu.org/licenses/