首页 > 代码库 > 新浪微博授权认证的实现
新浪微博授权认证的实现
最近准备找工作,着手看了下新浪微博的资料,前几天通过调用客户端实现了微博分享功能。这两天在网上搜了些资料,结合官方的开发文档,实现了授权验证部分。
下面按类作为章节来总结下验证这部分的实现:
Constants类
这个类内容很少,但起到很大作用,能否成功获取授权关键就在于该类中的一些变量如APP_KEY和SECRET的赋值是否正确。
package com.example.shareweibobyapi;//授权类public interface Constants { /** 当前 DEMO 应用的 APP_KEY,如果自己在新浪官网上的开发者认证还没有通过,则该APP_KEY和SECRET有效期一般只有一天 */ public static final String APP_KEY = "2059271021"; public static final String CONSUMER_SECRET = "0df386dee39f2b165c066a5665ff4eb7"; public static final String REDIRECT_URL = "http://www.sina.com.cn"; public static final String SCOPE = "email,direct_messages_read,direct_messages_write," + "friendships_groups_read,friendships_groups_write,statuses_to_me_read," + "follow_app_official_microblog," + "invitation_write";}
AccessTokenKeeper类
该类通过SharedPreferences实现了AccessToken的保存和读取以及删除。下面对SharePreferences类进行简单介绍:SharedPreferences是Android平台上一个轻量级的存储类,主要保存一些配置信息,可以保存Long、Int、String类型的数据。2个Activity之间的数据传递除了可以通过Intent来传递,还可以使用该类进行传递。
package com.example.shareweibobyapi;import android.content.Context;import android.content.SharedPreferences;import android.content.SharedPreferences.Editor;import com.sina.weibo.sdk.auth.Oauth2AccessToken;/** * 该类实现了AccessToken的保存和读取以及删除。*/public class AccessTokenKeeper { private static final String PREFERENCES_NAME = "com_weibo_sdk_android";//SharedPreferences类所在包 private static final String KEY_UID = "uid";//创建一个变量存储用户昵称 private static final String KEY_ACCESS_TOKEN = "access_token";//创建一个变量存储access_token private static final String KEY_EXPIRES_IN = "expires_in"; /** * 保存 Token 对象到 SharedPreferences。 * @param context 应用程序上下文环境 * @param token Token 对象 */ public static void writeAccessToken(Context context, Oauth2AccessToken token) { if (null == context || null == token) { return; } SharedPreferences pref = context.getSharedPreferences(PREFERENCES_NAME, Context.MODE_APPEND); Editor editor = pref.edit(); editor.putString(KEY_UID, token.getUid()); editor.putString(KEY_ACCESS_TOKEN, token.getToken()); editor.putLong(KEY_EXPIRES_IN, token.getExpiresTime()); editor.commit(); } /** * 从 SharedPreferences 读取 Token 信息。 * @param context 应用程序上下文环境 * @return 返回 Token 对象 */ public static Oauth2AccessToken readAccessToken(Context context) { if (null == context) { return null; } Oauth2AccessToken token = new Oauth2AccessToken(); SharedPreferences pref = context.getSharedPreferences(PREFERENCES_NAME, Context.MODE_APPEND); token.setUid(pref.getString(KEY_UID, "")); token.setToken(pref.getString(KEY_ACCESS_TOKEN, "")); token.setExpiresTime(pref.getLong(KEY_EXPIRES_IN, 0)); return token; } /** * 清空 SharedPreferences 中 Token信息。 * @param context 应用程序上下文环境 */ public static void clear(Context context) { if (null == context) { return; } SharedPreferences pref = context.getSharedPreferences(PREFERENCES_NAME, Context.MODE_APPEND); Editor editor = pref.edit(); editor.clear(); editor.commit(); }}
MainActivity类
该类为主窗口类,实现了OAuth授权认证。新浪微博的OAuth授权认证过程,大致可以分为以下几个步骤:
1.第三方应用携带App Key和App Secret两个参数向新浪微博发起认证请求。
2.通过验证后,第三方应用根据服务器返回的Request Token和Request Secret这两个参数跳转到新浪微博的授权界面。如果用户设备上已经安装微博客户端,则直接调用微博客户端拉取授权信息(oauth_verifier),否则跳转到WEB认证界面,用户可通过输入自己的账号和密码获取授权信息(oauth_verifier)。
3.第三方应用携带Request Token和Request以及oauth_verifier这三个参数再次向新浪微博发起认证请求。新浪微博将返回user_id、Access Token和Access Secret这三组参数,客户端利用这三组参数即可调用具有相应权限的API。
package com.example.shareweibobyapi;public class MainActivity extends Activity { Button ssoBtn;//分享按钮 EditText shareText; private TextView mTokenText;//显示授权成功后返回的access_token private WeiboAuth mWeiboAuth;//微博web授权类,提供登录功能 private Oauth2AccessToken mAccessToken;//提供Oauth2认证功能 private SsoHandler mSsoHandler; private UsersAPI mUsersAPI;//用户信息接口 @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); initView(); } public void initView() { ssoBtn=(Button) findViewById(R.id.button1); mTokenText=(TextView) findViewById(R.id.textView1); //创建微博实例,传入APP_KEY,REDIRECT_URL等信息 mWeiboAuth=new WeiboAuth(this,Constants.APP_KEY,Constants.REDIRECT_URL,Constants.SCOPE); //从SharedPreferences读取AccessToken信息 mAccessToken=AccessTokenKeeper.readAccessToken(this); //第一次启动本应用,AccessToken不可用 if(mAccessToken.isSessionValid()) { updateTokenView(true); } //单击“分享”按钮,进行授权 ssoBtn.setOnClickListener(new OnClickListener() { public void onClick(View v) { if(v==ssoBtn) { mSsoHandler=new SsoHandler(MainActivity.this,mWeiboAuth); mSsoHandler.authorize(new AuthListener()); } } }); } //当SSO授权Activity退出时,该函数被调用.发起SSO登录的Actiity必须重写onActivityResult protected void onActivityResult(int requestCode,int resultCode,Intent data) { super.onActivityResult(requestCode,resultCode,data); if(mSsoHandler!=null) { mSsoHandler.authorizeCallBack(requestCode, resultCode, data); } } //微博授权回调类 class AuthListener implements WeiboAuthListener { //授权完成 @Override public void onComplete(Bundle values){ //从Bundle解析Token mAccessToken=Oauth2AccessToken.parseAccessToken(values); if(mAccessToken.isSessionValid()) { //显示Token updateTokenView(false); //保存Token到SharePreferences AccessTokenKeeper.writeAccessToken(MainActivity.this, mAccessToken); Toast.makeText(MainActivity.this,"success!!",Toast.LENGTH_SHORT).show(); //根据uid获取用户的昵称 long uid=Long.parseLong(mAccessToken.getUid()); mUsersAPI.show(uid,mListener); } else { Toast.makeText(MainActivity.this,"fail!!",Toast.LENGTH_SHORT).show(); } }//授权异常 @Override public void onWeiboException(WeiboException e) { Toast.makeText(MainActivity.this, "Auth exception : " + e.getMessage(), Toast.LENGTH_LONG) .show(); } } //显示当前Token信息 public void updateTokenView(boolean hasExisted) { //获取用户信息接口 mUsersAPI=new UsersAPI(mAccessToken); String date=new SimpleDateFormat("yyyy/MM/dd HH:mm:ss").format(new java.util.Date(mAccessToken.getExpiresTime())); String format=getString(R.string.weibosdk_demo_token_to_string_format_1); mTokenText.setText(String.format(format,mAccessToken.getToken(),date)); String message=String.format(format,mAccessToken.getToken(),date); if(hasExisted) { message=getString(R.string.weibosdk_demo_token_has_existed)+"\n"+message; //根据uid获取用户的昵称,因为uid是在回调方法从服务器传递过俩的数据中 long uid=Long.parseLong(mAccessToken.getUid()); mUsersAPI.show(uid, mListener); } mTokenText.setText(message); } };}
来看看期待已久的授权成功的效果图:
总结:
整个过程中遇到的问题以及解决方案:
1.定义按钮的时候犯了个低级错误:在MainActivity的变量定义区域实例化了一个Button对象,导致运行时出现空指针错误,最后通过LOgcat信息定位错误所在行,将实例化语句转移到OnCreat()中即可解决问题。
2.运行程序,点击“分享”按钮出现这个异常:auth exception 21338。出现问题后百度、谷歌交叉搜索一下,最后才明白问题根源所在:App_Key过期。由于在新浪微博上申请的开发者身份还没有通过认证,所以申请的App_Key只能在当天使用。找到问题根源,解决起来就很简单了,重新申请一个就搞定。
3.解决上面那个问题后,满怀信心地再次运行程序,结果却出现这个错误:sso package or sign error。再次百度、谷歌,结果发现这是新版本的SDK才会出现的问题,一般都是由于MD5签名不正确或者过期而导致。而当想要修改MD5签名的时候,我竟然发现一开始创建应用的时候我竟没有使用签名,真是蠢到家。解决起来也很简单,安装一个签名工具,签名后在新浪微博个人信息里面填写下应用报名和签名即可。
领悟:
学习一个新的知识,不要太过浮躁,不要总想着我多长时间内能做出来。对于没接触过的东西,即使再简单,对我们来说都是陌生的东西,和陌生的东西打交道总需要些耐心和时间。所以多看看与该知识相关的一些优秀博客,站在别人的成果上去看问题,总会看得更远一些。