作者:贺小令
人人网(www.renren.com)前身为校内网，是中国最大、最受用户欢迎的网络SNS平台。人人网目前针对不同领域的开发者，提供了相应的教程和文档，目前主要分为“站内应用开发”、“第三方网站接入”、“移动客户端接入”和“桌面客户端接入”四大模块。以下结合自己实际做过的一个项目（人人好友电话簿）介绍基于Android开发的移动客户端接入基本流程。
手机等移动设备的客户端应用（如手机游戏、实用工具等）接入人人网，可以使用人人网帐号登录移动客户端，并利用人人网开放平台提供的社交图谱（Social Graph）和传播渠道，增进用户与好友的交互，提升使用体验，并获得广泛传播。
Android手机客户端接入人人网，可以有两种实现方式：
第一种是直接使用人人网开放平台提供的各种接口，如用作验证和授权的OAuth 2.0，提供数据的底层Rest API，以及嵌入各种Widget。关于OAuth 2.0详细协议介绍，请参考https://datatracker.ietf.org/doc/draft-ietf-oauth-v2/，后文会介绍在人人中的相关用法。
第二种是使用人人网开放平台官方封装的开源Android SDK。 人人网最新版的Android SDK实际上是将OAuth 2.0、Rest API等平台提供的底层接口封装起来而已。
在我的项目中我采用了第一种方式,即直接使用人人网开放平台提供的各种接口，这种方式比较简单，自己可以随心所欲的发挥。第二种方式，我看过人人提供的SDK，比较晦涩难懂。如有兴趣，可以自己去研究。
整体流程如下图：
第一步：注册一个人人账户，如果有了，跳过此步。
第二步：用自己的账号密码登陆到人人网，然后跳转到http://dev.renren.com/app，点击创建客户端应用按钮，并按相应的流程填写完相应信息，你就可以提交应用审核。完成后你将得到：API
Key和Secret Key，如下图：
API Key就是人人OAuth2.0中的“client_id”，Secret Key就是“client_secret”。
第三、四步：
人人网开放平台提供了上述的OAuth2.0验证与授权流程以支持不同类型的应用，包括：网站、站内应用、手机客户端和桌面客户端。
由于OAuth 2.0协议定义的桌面客户端的授权流程，用户体验方面过于复杂，所以桌面客户端应用可以在应用中嵌入浏览器控件（很多框架都支持嵌入浏览器，例如：.NET、AIR、Cocoa等）使用客户端流程。
由于大部分桌面客户端软件是没有后端没有Web服务器支持，没办法提供一个'redirect_uri'，所以人人网为没有Web服务器的客户端应用提供了一个通用的URL：http://graph.renren.com/oauth/login_success.html。
流程如下：
在应用中嵌入一个浏览器控件，并使用客户端流程定向控件到人人OAuth 2.0 Authorize Endpoint（https://graph.renren.com/oauth/authorize）：
https://graph.renren.com/oauth/authorize?client_id=YOUR_API_KEY&redirect_uri=http://graph.renren.com/oauth/login_success.html
经过用户验证、应用授权，人人OAuth2.0将把浏览器控件定向导'redirect_uri'（http://graph.renren.com/oauth/login_success.html），并在URI Fragment中追加Access Token：http://graph.renren.com/oauth/login_success.html#access_token=...当应用发现浏览器的控件的URL跳转到这个URL上时，从URL中解析出Access
Token。
在Android中加载html用WebView控件，由于Android主要是触屏，因此需要加display=touch参数，完整的URL为
https://graph.renren.com/oauth/authorize?client_id=05d3794614f244c39e300c65f5f68a9e&response_type=token&display=touch&redirect_uri=http://graph.renren.com/oauth/login_success.html
登陆授权流程如下：
主要代码和注释如下：
RenrenLoginActivity.java
import android.app.Activity;
……
/**
* @author hexiaoling
*/
public class RenrenLoginActivity extends Activity {
public final static String TAG = "RenrenLoginActivity";
private WebView renrenLoginWebView; // WebView 控件，用于显示从人人网请求得到html授权页面
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.renren_login_web_view);
renrenLoginWebView = (WebView) findViewById(R.id.renren_login_web_view); // 得到 WebView 控件
//对WebView进行设置（对JS的支持，对缩放的支持，对缓存模式的支持）
WebSettings webSettings = renrenLoginWebView.getSettings();
webSettings.setJavaScriptEnabled(true);
webSettings.setBuiltInZoomControls(true);
webSettings.setCacheMode(WebSettings.LOAD_NO_CACHE);
// 根据client_id取得到人人服务器人人对你的应用授权，如果成功则返回人人网登陆页面的html文件，并在WebView控件上显示
// 此时用户需要输入自己人人账号的用户名、密码并点击登陆
renrenLoginWebView.loadUrl("https://graph.renren.com/oauth/authorize?"+
"client_id=05d3794614f244c39e300c65f5f68a9e&response_type=token"+
"&display=touch&redirect_uri=http://graph.renren.com/oauth/login_success.html");
renrenLoginWebView.setWebViewClient(new WebViewClient() {
//击网页里面的链接还是在当前的webview里跳转，不跳到浏览器那边
@Override
public boolean shouldOverrideUrlLoading(WebView view, String url) {
view.loadUrl(url);
return true;
}
@Override
public void onReceivedSslError(WebView view, SslErrorHandler handler, SslError error) {
handler.proceed();//让webview处理https请求
}
@Override
public void onPageFinished(WebView view, String url) {
String url0 = renrenLoginWebView.getUrl();
String access_token = "";
String expires_in = "";
Log.i(TAG, "URL = " + url0);
if(url0 != null) {
if(url0.contains("access_token=")) { // 从URL中解析得到 access_token
access_token = url0.substring(url0.indexOf("access_token=") + 13, url0.length() - 19);
try {
access_token = URLDecoder.decode(access_token, "utf-8"); // 制定为utf-8编码
} catch (UnsupportedEncodingException e) {
e.printStackTrace();
}
Log.i(TAG, "access_token = " + access_token);
}
if(url0.contains("expires_in=")) { // 从URL中解析得到 expires_in
expires_in = url0.substring(url0.indexOf("expires_in=") + 11, url0.length());
Log.i(TAG, "expires_in = " + expires_in);
}
RenrenUtil.access_token = access_token; // 将解析得到的 access_token 保存起来
RenrenUtil.expires_in = expires_in; // 将解析得到的 expires_in 保存起来
//输入用户名、密码登陆成功，进行页面跳转
if(RenrenUtil.access_token.length() != 0) {
Intent intent = new Intent(RenrenLoginActivity.this, RenrenFriendsActivity.class);
startActivity(intent);
}
}
super.onPageFinished(view, url);
}
});
}
}
下图表示加载人人授权应用的html登陆成果界面：
第五步：这里以访问我的人人好友列表为例，包括取得好友的名称和照片。主要流程如下：
①人人API利用不同功能的请求函数和相关参数，详细请参考http://wiki.dev.renren.com/wiki/API。此处以获得好友列表为例，其对应函数为friends.getFriends（得到用户的信息，支持批量获取），人人对friends.getFriends的描述和参数列表如下图：
下图表示将请求参数和Secret得到MD5值为签名，并组装请求参数核心代码：
String method = " friends.getFriends "; // 人人API中定义的方法，用于得到当前登录用户的好友列表。
int count = 30; // 得到用户数30个
List<String> param = new ArrayList<String>();
param.add("method=" + method);
param.add("v=1.0"); // 版本固定参数
param.add("access_token=" + RenrenUtil.access_token); //RenrenUtil.access_token 是在LoginActivity中已经保存的数据
param.add("format=JSON"); // 返回JSON数据
param.add("count=" + count); //得到用户数
String signature = getSignature(param, "55f436828286417ab9db7ea17ee9cbde"); //第二个参数为 Secret Key
List<BasicNameValuePair> paramList = new ArrayList<BasicNameValuePair>();
paramList.add(new BasicNameValuePair("sig", signature)); // 签名
paramList.add(new BasicNameValuePair("method", method));
paramList.add(new BasicNameValuePair("v", "1.0"));
paramList.add(new BasicNameValuePair("access_token", RenrenUtil.access_token));
paramList.add(new BasicNameValuePair("format", "JSON"));
paramList.add(new BasicNameValuePair("count", "" + count));
下图表示将请求参数和SecretKey加密得到它们的MD5值的算法如下：
/**
* 得到MD5签名
* @param paramList
* @param secret
* @return
*/
public String getSignature(List<String> paramList,String secret) {
Collections.sort(paramList);
StringBuffer buffer = new StringBuffer();
for (String param : paramList) {
buffer.append(param); //将参数键值对，以字典序升序排列后，拼接在一起
}
buffer.append(secret); //符串末尾追加上应用的Secret Key
try {//下面是将拼好的字符串转成MD5值，然后返回
java.security.MessageDigest md = java.security.MessageDigest.getInstance("MD5");
StringBuffer result = new StringBuffer();
try {
for (byte b : md.digest(buffer.toString().getBytes("utf-8"))) {
result.append(Integer.toHexString((b & 0xf0) >>> 4));
result.append(Integer.toHexString(b & 0x0f));
}
} catch (UnsupportedEncodingException e) {
for (byte b : md.digest(buffer.toString().getBytes())) {
result.append(Integer.toHexString((b & 0xf0) >>> 4));
result.append(Integer.toHexString(b & 0x0f));
}
}
return result.toString();
} catch (java.security.NoSuchAlgorithmException ex) { }
return null;
}
②使用HTTP协议，Android已经对其做了很好的封装，使用起来很方便。使用将第①步得到的参数列表想http://api.renren.com/restserver.do发送Http请求，同时得到HttpResponse响应，判断响应代码是否为200，为200表示成功。然后解析JSON数据为相关对象，核心代码如下：
String returnValue = "0";
try {
HttpPost httpPost = new HttpPost("http://api.renren.com/restserver.do");
httpPost.setEntity(new UrlEncodedFormEntity(paramList, HTTP.UTF_8));// 添加请求参数到请求对象
HttpResponse httpResponse = httpClient.execute(httpPost);
if(httpResponse.getStatusLine().getStatusCode() == 200) { //为200表示执行成功
strResult = EntityUtils.toString(httpResponse.getEntity()); //得到返回数据（为JSON数据）
if(! strResult.contains("error_code")) {
renrenList = Renren.parseRenrenFromJson(strResult); //解析JSON数据为相应对象
returnValue = "1"; //定义返回标志
}
}
} catch (ClientProtocolException e) {
strResult = e.getMessage().toString();
e.printStackTrace();
} catch (IOException e) {
strResult = e.getMessage().toString();
e.printStackTrace();
} catch (Exception e) {
strResult = e.getMessage().toString();
e.printStackTrace();
}
return returnValue;
网络请求会比较耗时，因此建议使用多线程来处理。在Android中可以使用继承AsyncTask<String, Integer,String>类来实现多线程处理。
③解析JSON数据为人人对象方法：
/**
* 解析JSON数据为人人对象
* @param renrenJsonData
* @return
*/
public List<Renren> parseRenrenFromJson(String renrenJsonData) {
List<Renren> renrenList = new ArrayList<Renren>();
try {
JSONArray jsonArray = new JSONArray(renrenJsonData);
int length = jsonArray.length();
for (int i = 0; i < length; ++i) {
JSONObject jsonObject = jsonArray.getJSONObject(i);
Renren renren = new Renren();
renren.setId(jsonObject.getString("id"));
renren.setName(jsonObject.getString("name"));
renren.setHeadurl(jsonObject.getString("headurl"));
renrenList.add(renren);
}
return renrenList;
} catch (JSONException e) { }
return null;
}
下图为JSON数据的数据结构：
人人类Renren.java
public class Renren {
protected String id;
protected String name;
protected String headurl;
省略get、set方法。
}
④在List中显示人人好友列表（图片、名称），并用Adapater来加载数据。由于请求friends.getFriends返回的只有图片的URL，因此图片还需要单独去请求，为了保障用户体验，图片采用异步加载。
public class FriendsAdapater extends BaseAdapter {
private AsyncImageLoader asyncImageLoader = new AsyncImageLoader(); // 异步获取图片
@Override
public int getCount() {
return renrenList == null ? 0 : renrenList.size();
}
@Override
public Object getItem(int position) {
return renrenList == null ? null :renrenList.get(position);
}
@Override
public long getItemId(int position) {
return position;
}
@Override
public View getView(int position, View convertView, ViewGroup parent) {
convertView = LayoutInflater.from(getApplicationContext()).inflate(R.layout.friend, null);
userName= (TextView) convertView.findViewById(R.id.username);
userImage = (ImageView) convertView.findViewById(R.id.userimage);
Renren renren = renrenList.get(position);
if (renren != null) {
convertView.setTag(renren.getId());
userImage.setTag(renren.getHeadurl());
userName.setText(renren.getName());
//异步加载图片并显示
Drawable cachedImage = asyncImageLoader.loadDrawable(renren, new ImageCallback() {
@Override
public void imageLoaded(Drawable imageDrawable, String imageUrl) {
ImageView imageView = (ImageView) friendsList.findViewWithTag(imageUrl);
if(imageView != null) {
imageView.setImageDrawable(imageDrawable);
}
}
});
if (cachedImage != null) {
userImage.setImageDrawable(cachedImage);
} else {//如果没有图片，就以一个载入的图片代替显示
userImage.setImageResource(R.drawable.icon);
}
}
return convertView;
}
}
异步加载图片类AsyncImageLoader.java
/**
* 异步加载图片类
* @author hexiaoling
*/
public class AsyncImageLoader {
private HashMap<String, SoftReference<Drawable>> imageCache; //缓存图片
public AsyncImageLoader() {
imageCache = new HashMap<String, SoftReference<Drawable>>();
}
public Drawable loadDrawable(final Renren renren, final ImageCallback imageCallback) {
final String imageId = renren.getId();
final String imageURL = renren.getHeadurl();
//判断缓存中是否已经存在图片，如果存在则直接返回
if (imageCache.containsKey(imageId)) {
SoftReference<Drawable> softReference = imageCache.get(imageId);
Drawable drawable = softReference.get();
if (drawable != null) {
return drawable;
}
}
final Handler handler = new Handler() {
public void handleMessage(Message message) {
imageCallback.imageLoaded((Drawable) message.obj, imageURL);
}
};
//开辟一个新线程去下载图片，并用Handler去更新UI
new Thread() {
@Override
public void run() {
Drawable drawable = loadImageFromUrl(imageURL);
imageCache.put(imageURL, new SoftReference<Drawable>(drawable));
Message message = handler.obtainMessage(0, drawable);
handler.sendMessage(message);
}
}.start();
return null;
}
//从URL下载图片
public static Drawable loadImageFromUrl(String url) {
URL m;
InputStream i = null;
try {
m = new URL(url);
i = (InputStream) m.getContent();
} catch (MalformedURLException e1) {
e1.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
}
Drawable d = Drawable.createFromStream(i, "src");
return d;
}
//回调接口
public interface ImageCallback {
//回调函数
public void imageLoaded(Drawable imageDrawable, String imageUrl);
}
}
下图为运行结果：（因涉及好友真实信息，不将部分图片和文字加码，此结果仅表示按照此步骤运行正确）
另外需要注意的是，访问人人API需要访问网络，因此需要在添加网络访问授权
<uses-permissionandroid:name="android.permission.INTERNET" />
此文仅简单介绍了基于人人网API的Android开发的基本步骤，如需了解更多信息，请研究人人官网http://wiki.dev.renren.com/wiki/API。欢迎就上述问题进一步交流。
参考文献：http://wiki.dev.renren.com/wiki/API