看来微博在中国又有一次不可忽略的发展了,因为昨天有这么一个新闻“中国首届微博开发者大会”,官网如下图:

 

要使用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()

  1. package weibo4j.examples; 
  2.  
  3. import weibo4j.Status; 
  4. import weibo4j.Weibo; 
  5. import weibo4j.WeiboException; 
  6. import weibo4j.http.AccessToken; 
  7. import weibo4j.http.RequestToken; 
  8. import java.io.UnsupportedEncodingException; 
  9.  
  10. // Web 方式认证 
  11. public class WebOAuth { 
  12.     private Weibo weibo; 
  13.  
  14.     public WebOAuth(){       
  15.         // 准备好Consumer Key、Consumer Secret 
  16.         // 对应于新浪微博应用就是申请到的 App key 和 Secret key 
  17.         System.setProperty("weibo4j.oauth.consumerKey", Weibo.CONSUMER_KEY); 
  18.         System.setProperty("weibo4j.oauth.consumerSecret", Weibo.CONSUMER_SECRET); 
  19.         weibo = new Weibo(); 
  20.     } 
  21.  
  22.     // 根据传入的 callback_url 获取 request token 
  23.     public RequestToken getRequestToken(String backUrl) { 
  24.         try { 
  25.             // 指定 callback_url 并获得 request token 
  26.             RequestToken requestToken = weibo.getOAuthRequestToken(backUrl); 
  27.  
  28.             System.out.println("Request token: " + requestToken.getToken()); 
  29.             System.out.println("Request token secret: " + requestToken.getTokenSecret()); 
  30.  
  31.             return requestToken; 
  32.         } catch (Exception e) { 
  33.             System.out.println("获取Request token发生异常!"); 
  34.             e.printStackTrace(); 
  35.             return null
  36.         } 
  37.     } 
  38.  
  39.     // 根据传入的 request token 和 verifier 获取 access token 
  40.     public AccessToken gettAccessToken(RequestToken requestToken, String verifier) { 
  41.         try {            
  42.             AccessToken accessToken = weibo.getOAuthAccessToken(requestToken 
  43.                     .getToken(), requestToken.getTokenSecret(), verifier); 
  44.              
  45.             System.out.println("Access token: " + accessToken.getToken()); 
  46.             System.out.println("Access token secret: " + accessToken.getTokenSecret()); 
  47.  
  48.             return accessToken; 
  49.         } catch (Exception e) { 
  50.             System.out.println("获取Access token发生异常!"); 
  51.             e.printStackTrace(); 
  52.             return null
  53.         } 
  54.     } 
  55.  
  56.     // 根据传入的 Access Token 和内容发表微博 
  57.     public void update(AccessToken access, String content) { 
  58.         try { 
  59.             weibo.setToken(access.getToken(), access.getTokenSecret()); 
  60.             content = new String(content.getBytes("GBK"), "UTF-8"); 
  61.             Status status = weibo.updateStatus(content); 
  62.             System.out.println("成功发表微博:" + status.getText() + "."); 
  63.         } catch (UnsupportedEncodingException e) { 
  64.             System.out.println("微博内容转编码发生异常!"); 
  65.             e.printStackTrace(); 
  66.         } catch (WeiboException e) { 
  67.             System.out.println("发表微博发生异常!"); 
  68.             e.printStackTrace(); 
  69.         } 
  70.     } 

request.jsp,用于提供 callback_url(这里我们自定义为下文中的callback.jsp),当获取得到RequestToken之后,保存该RequestTokenSession中,并将页面重定向到callback.jsp进行验证、授权。

  1. <%@ page contentType="text/html;charset=utf-8" %> 
  2. <%@ page language="java" import="weibo4j.*" %> 
  3. <%@ page language="java" import="weibo4j.http.*" %> 
  4. <%@ page language="java" import="weibo4j.util.*" %> 
  5.  
  6. <jsp:useBean id="weboauth" scope="session" class="weibo4j.examples.WebOAuth" /> 
  7.  
  8. <% 
  9.     if("1".equals(request.getParameter("opt"))) 
  10.     { 
  11.         // 传入callback_url 
  12.         String callback_url = "http://localhost:8080/sinaweibo/callback.jsp"
  13.         RequestToken requestToken = weboauth.getRequestToken(callback_url); 
  14.          
  15.         if(requestToken != null){ 
  16.             out.println(requestToken.getToken()); 
  17.             out.println(requestToken.getTokenSecret()); 
  18.             session.setAttribute("requestToken",requestToken); 
  19.  
  20.             String url = requestToken.getAuthorizationURL()+"&oauth_callback="+callback_url; 
  21.             System.out.println("AuthorizationURL:" + url); 
  22.  
  23.             //BareBonesBrowserLaunch.openURL(callback_url); 
  24.             //response.sendRedirect(requestToken.getAuthorizationURL()); 
  25.  
  26.             // 重定向到附加了callback_url回调地址的sina微博认证页面 
  27.             response.sendRedirect(url); 
  28.         }else
  29.             out.println("request error"); 
  30.         } 
  31.     }else
  32. %> 
  33.         <a href="request.jsp?opt=1">请点击进行Web方式的OAuth认证!</a>    
  34. <%  }   %> 

 

callback.jsp,在上一步中重定向之后,callback_url 后面会被附加了oauth_verifier参数,此时我们根据保存在 Session中的RequestToken和获取到的oauth_verifier参数申请获得AccessToken。一旦获得AccessToken,我们再把页面重定向到编写微博的页面writeWeibo.html

  1. <%@ page contentType="text/html;charset=utf-8" %> 
  2. <%@ page language="java" import="weibo4j.http.*" %> 
  3. <%@ page language="java" import="weibo4j.*" %> 
  4.  
  5. <jsp:useBean id="weboauth" scope="session" class="weibo4j.examples.WebOAuth" /> 
  6. <% 
  7.     // 获得HTTP请求中的 oauth_verifier 参数 
  8.     String verifier=request.getParameter("oauth_verifier"); 
  9.  
  10.     out.println("oauth_verifier:"+verifier); 
  11.     System.out.println("oauth_verifier:"+verifier); 
  12.  
  13.     if(verifier != null){ 
  14.  
  15.         RequestToken requestToken = (RequestToken)session.getAttribute("requestToken"); 
  16.  
  17.         if(requestToken != null){ 
  18.  
  19.             AccessToken accessToken = weboauth.gettAccessToken(requestToken,verifier); 
  20.  
  21.             if(accessToken != null){ 
  22.                 try
  23.                     session.setAttribute("accessToken",accessToken);                     
  24.  
  25.                     out.println("5 秒后转到 writeWeibo.html"); 
  26.                     Thread.sleep(5000); 
  27.                     response.sendRedirect("http://localhost:8080/sinaweibo/writeWeibo.html"); 
  28.  
  29.                 }catch(Exception e){ 
  30.                     e.printStackTrace(); 
  31.                 }                
  32.             }else
  33.                 out.println("access token request error"); 
  34.             }        
  35.         }else
  36.             out.println("request token session error"); 
  37.         } 
  38.     }else
  39.         out.println("verifier String error"); 
  40.     } 
  41. %> 

 

writeWeibo.html,很简单的HTML文件。

  1. <html> 
  2.     <head><title>发布sina微博</title></head> 
  3.     <body bgcolor="#d0d0d0" > 
  4.         <form action="updateWeibo.jsp" method="post">    
  5.             请在这里写上140字符以内的文本:</br> 
  6.             <textarea name="weiboText" rows="3" cols="30">测试新浪微博!</textarea></br> 
  7.             <input type="submit" value="发布"> 
  8.             <input type="reset" value="清除"></br> 
  9.         </form> 
  10.     </body> 
  11. </html> 

 

updateWeibo.jsp,用于发表文本微博,即调用WebOAuth.java 中的update方法。

  1. <%@ page contentType="text/html;charset=utf-8" %> 
  2. <%@ page language="java" import="weibo4j.http.*" %> 
  3. <%@ page language="java" import="weibo4j.*" %> 
  4.  
  5. <jsp:useBean id="weboauth" scope="session" class="weibo4j.examples.WebOAuth" /> 
  6. <% 
  7.     AccessToken accessToken = (AccessToken)session.getAttribute("accessToken"); 
  8.     String weiboText = (String)request.getParameter("weiboText"); 
  9.  
  10.     // 连续发表同样的微博内容会返回400错误 
  11.     weboauth.update(accessToken, weiboText); 
  12.     out.println("微博发表成功!"); 
  13. %> 

 

       运行之前我们要准备好 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、还有控制台输入的一些信息,例如TokenURL、服务器返回信息都没有截图给出。

 

       以下内容你可能会感兴趣:

OAuth简介及sina微博开放平台