sina微博開放平臺中使用OAuth驗證並發表微博

 看來微博在中國又有一次不可忽略的發展了，因爲昨天有這麼一個新聞“中國首屆微博開發者大會”，官網如下圖：

 

要使用sina微博開放平臺的API，應先獲取sina分配的App key 和App Secret，下面是我創建應用之後sina分配的App key 和App Secret（這個可是要保密的哦）。

 

然後是下載微博 SDK，我用 Java 的 weibo4j。目前有以下的語言版本：

 

修改SDK包裏面 Weibo.java 類的 App Key 和App Secret 爲剛剛獲取的 App Key 和App Secret ，如下圖使用說明所示：

 

完成了這些之後，就可以根據提供的Demo開始寫代碼了。如下： 

WebOAuth.java，用於初始化Weibo.java類所需的App Key 和 App Secret，並提供獲取Request Token 和Access Token 的方法getRequestToken()、gettAccessToken()，其所需參數如代碼所示。另外，還提供了發佈一個文本微博的方法update()。

package weibo4j.examples;

import weibo4j.Status;
import weibo4j.Weibo;
import weibo4j.WeiboException;
import weibo4j.http.AccessToken;
import weibo4j.http.RequestToken;
import java.io.UnsupportedEncodingException;

// Web 方式認證
public class WebOAuth {
    private Weibo weibo;

    public WebOAuth(){
        // 準備好Consumer Key、Consumer Secret
        // 對應於新浪微博應用就是申請到的 App key 和 Secret key
        System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER_KEY);
        System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER_SECRET);
        weibo = new Weibo();
    }

    // 根據傳入的 callback_url 獲取 request token
    public RequestToken getRequestToken(String backUrl) {
        try {
            // 指定 callback_url 並獲得 request token
            RequestToken requestToken = weibo.getOAuthRequestToken(backUrl);

            System.out.println("Request token: " + requestToken.getToken());
            System.out.println("Request token secret: " + requestToken.getTokenSecret());

            return requestToken;
        } catch (Exception e) {
            System.out.println("獲取Request token發生異常！");
            e.printStackTrace();
            return null;
        }
    }

    // 根據傳入的 request token 和 verifier 獲取 access token
    public AccessToken gettAccessToken(RequestToken requestToken, String verifier) {
        try {
            AccessToken accessToken = weibo.getOAuthAccessToken(requestToken
                    .getToken(), requestToken.getTokenSecret(), verifier);

            System.out.println("Access token: " + accessToken.getToken());
            System.out.println("Access token secret: " + accessToken.getTokenSecret());

            return accessToken;
        } catch (Exception e) {
            System.out.println("獲取Access token發生異常！");
            e.printStackTrace();
            return null;
        }
    }

    // 根據傳入的 Access Token 和內容發表微博
    public void update(AccessToken access, String content) {
        try {
            weibo.setToken(access.getToken(), access.getTokenSecret());
            content = new String(content.getBytes("GBK"), "UTF-8");
            Status status = weibo.updateStatus(content);
            System.out.println("成功發表微博：" + status.getText() + ".");
        } catch (UnsupportedEncodingException e) {
            System.out.println("微博內容轉編碼發生異常！");
            e.printStackTrace();
        } catch (WeiboException e) {
            System.out.println("發表微博發生異常！");
            e.printStackTrace();
        }
    }
}

request.jsp，用於提供 callback_url（這裏我們自定義爲下文中的callback.jsp），當獲取得到RequestToken之後，保存該RequestToken到Session中，並將頁面重定向到callback.jsp進行驗證、授權。

<%@ page contentType="text/html;charset=utf-8" %>
<%@ page language="java" import="weibo4j.*" %>
<%@ page language="java" import="weibo4j.http.*" %>
<%@ page language="java" import="weibo4j.util.*" %>

<jsp:useBean id="weboauth" scope="session" class="weibo4j.examples.WebOAuth" />

<%
    if("1".equals(request.getParameter("opt")))
    {
        // 傳入callback_url
        String callback_url = "http://localhost:8080/sinaweibo/callback.jsp";
        RequestToken requestToken = weboauth.getRequestToken(callback_url);

        if(requestToken != null){
            out.println(requestToken.getToken());
            out.println(requestToken.getTokenSecret());
            session.setAttribute("requestToken",requestToken);

            String url = requestToken.getAuthorizationURL()+"&oauth_callback="+callback_url;
            System.out.println("AuthorizationURL:" + url);

            //BareBonesBrowserLaunch.openURL(callback_url);
            //response.sendRedirect(requestToken.getAuthorizationURL());

            // 重定向到附加了callback_url回調地址的sina微博認證頁面
            response.sendRedirect(url);
        }else{
            out.println("request error");
        }
    }else{
%>
        <a href="request.jsp?opt=1">請點擊進行Web方式的OAuth認證！</a>
<%  }   %>

 

callback.jsp，在上一步中重定向之後，callback_url 後面會被附加了oauth_verifier參數，此時我們根據保存在 Session中的RequestToken和獲取到的oauth_verifier參數申請獲得AccessToken。一旦獲得AccessToken，我們再把頁面重定向到編寫微博的頁面writeWeibo.html。

<%@ page contentType="text/html;charset=utf-8" %>
<%@ page language="java" import="weibo4j.http.*" %>
<%@ page language="java" import="weibo4j.*" %>

<jsp:useBean id="weboauth" scope="session" class="weibo4j.examples.WebOAuth" />
<%
    // 獲得HTTP請求中的 oauth_verifier 參數
    String verifier=request.getParameter("oauth_verifier");

    out.println("oauth_verifier:"+verifier);
    System.out.println("oauth_verifier:"+verifier);

    if(verifier != null){

        RequestToken requestToken = (RequestToken)session.getAttribute("requestToken");

        if(requestToken != null){

            AccessToken accessToken = weboauth.gettAccessToken(requestToken,verifier);

            if(accessToken != null){
                try{
                    session.setAttribute("accessToken",accessToken);

                    out.println("5 秒後轉到 writeWeibo.html");
                    Thread.sleep(5000);
                    response.sendRedirect("http://localhost:8080/sinaweibo/writeWeibo.html");

                }catch(Exception e){
                    e.printStackTrace();
                }
            }else{
                out.println("access token request error");
            }
        }else{
            out.println("request token session error");
        }
    }else{
        out.println("verifier String error");
    }
%>

 

writeWeibo.html，很簡單的HTML文件。

<html>
    <head><title>發佈sina微博</title></head>
    <body bgcolor="#d0d0d0" >
        <form action="updateWeibo.jsp" method="post">
            請在這裏寫上140字符以內的文本：</br>
            <textarea name="weiboText" rows="3" cols="30">測試新浪微博！</textarea></br>
            <input type="submit" value="發佈">
            <input type="reset" value="清除"></br>
        </form>
    </body>
</html>

 

updateWeibo.jsp，用於發表文本微博，即調用WebOAuth.java 中的update方法。

<%@ page contentType="text/html;charset=utf-8" %>
<%@ page language="java" import="weibo4j.http.*" %>
<%@ page language="java" import="weibo4j.*" %>

<jsp:useBean id="weboauth" scope="session" class="weibo4j.examples.WebOAuth" />
<%
    AccessToken accessToken = (AccessToken)session.getAttribute("accessToken");
    String weiboText = (String)request.getParameter("weiboText");

    // 連續發表同樣的微博內容會返回400錯誤
    weboauth.update(accessToken, weiboText);
    out.println("微博發表成功！");
%>

 

       運行之前我們要準備好 Tomcat ，並將上面的源文件放到正確的目錄中。此外，還應該在\WEB-INF\lib目錄下添加SDK包中帶有的commons-httpclient-3.1.jar 包，以及我自己編譯、打包後的weibo4j.jar（裏面是sina微博開放平臺中的具體Java實現）。

 

       運行Tomcat，在瀏覽器中訪問request.jsp 頁面，如下圖：

 

       點擊其中的鏈接，如下圖（注意地址欄的變化）：

       其中地址欄的URL如下：

http://api.t.sina.com.cn/oauth/authorize?oauth_token=efda6f2499877d0e6d814f8c3d31a1d1&oauth_callback=http://localhost:8080/sinaweibo/callback.jsp

 

       填上具體有效的sina微博賬號、密碼並授權。以下是填上了我測試用的微博賬號並授權的結果：

       其中地址欄的URL如下：

http://localhost:8080/sinaweibo/writeWeibo.html

 

       點擊“發佈”，如下圖：

       登錄微博查看一下，如下圖：

      

       查看一下該賬號所授權的應用列表：

       至此，關於OAuth方式使用sina微博開放平臺來發布微博就大概是這個過程。

 

       小結：

1、其實還有好多細節沒能講到，我也是嘗試了好多次才一點點發現問題、理解問題、再到解決問題；

       2、如果瀏覽器中已經保存了我們登錄sina微博的賬號信息的Cookie，那麼在授權時不用輸入賬號信息，當然也可以修改不用當前賬號進行授權；

       3、還有控制檯輸入的一些信息，例如Token、URL、服務器返回信息都沒有截圖給出。

 

       以下內容你可能會感興趣：

OAuth簡介及sina微博開放平臺