1.1 Web IM的demo下载链接:https://github.com/netease-im/NIM_Web_Demo
1.2 运行Web IM的demo,首先你需要安装Node.js(这里不讲,自行百度),然后打开你从GitHub上克隆的项目,同时按shift+Ctrl键,鼠标右击打开命令提示符(或Powershell),先输入npm install接着输入 node app,会输出server start at 8182
1.3 接着点击这个链接:http://localhost:8182/webdemo/im/index.html,Web IM的demo就运行成功了。
但是这个demo现在用的是网易云的服务器,我们想自己使用它,所以要做以下配置。
2.1 首先你需要在网易云信注册账号,然后在控制台创建一个应用,记录下应用的App Key。
2.2 接着你需要在这个应用的功能管理找到IM免费版的账号管理,添加一个IM用户(用作登录实验)。
2.3 接着创建网易云用户ID,获得token,用于外联登录等(身份令牌用于登录时作为验证,通俗说是暗号,它不可能让你通过代码+账号就得到网易云数据库中的密码,但是又想让你有自己的唯一标识用作登录,所以有了身份令牌)。
2.4 网易云通信ID的各个接口。
https://api.netease.im/nimserver/user/create.action 创建网易云通信ID的接口。
https://api.netease.im/nimserver/user/update.action 更新网易云通信ID的接口。
https://api.netease.im/nimserver/user/refreshToken.action 更新并获取网易云通信ID的接口。
https://api.netease.im/nimserver/user/block.action 封禁网易云通信ID的接口。
https://api.netease.im/nimserver/user/unblock.action 解禁网易云通信ID的接口
2.5 所需jar包
commons-logging-1.2.jar httpclient-4.5.5.jar httpcore-4.3.2.jar
2.6 Java代码
所有调用网易云通信服务端接口的请求都需要校验,得到token后一定要记录下来账号+账号对应的token。
CheckSumBuilder 校验类
import java.security.MessageDigest;
public class CheckSumBuilder {
// 计算并获取CheckSum
public static String getCheckSum(String appSecret, String nonce, String curTime) {
return encode("sha1", appSecret + nonce + curTime);
}
// 计算并获取md5值
public static String getMD5(String requestBody) {
return encode("md5", requestBody);
}
private static String encode(String algorithm, String value) {
if (value == null) {
return null;
}
try {
MessageDigest messageDigest
= MessageDigest.getInstance(algorithm);
messageDigest.update(value.getBytes());
return getFormattedText(messageDigest.digest());
} catch (Exception e) {
throw new RuntimeException(e);
}
}
private static String getFormattedText(byte[] bytes) {
int len = bytes.length;
StringBuilder buf = new StringBuilder(len * 2);
for (int j = 0; j < len; j++) {
buf.append(HEX_DIGITS[(bytes[j] >> 4) & 0x0f]);
buf.append(HEX_DIGITS[bytes[j] & 0x0f]);
}
return buf.toString();
}
private static final char[] HEX_DIGITS = { '0', '1', '2', '3', '4', '5',
'6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f' };
}
getToken 创建token类
import org.apache.http.HttpResponse;
import org.apache.http.NameValuePair;
import org.apache.http.client.entity.UrlEncodedFormEntity;
import org.apache.http.client.methods.HttpPost;
import org.apache.http.impl.client.DefaultHttpClient;
import org.apache.http.message.BasicNameValuePair;
import org.apache.http.util.EntityUtils;
import java.util.ArrayList;
import java.util.Date;
import java.util.List;
public class getToken {
public static void main(String[] args) throws Exception{
DefaultHttpClient httpClient = new DefaultHttpClient();
//网易云通信ID接口,按实际情况换
String url = "https://api.netease.im/nimserver/user/refreshToken.action";
HttpPost httpPost = new HttpPost(url);
String appKey = "你的应用的App Key";
String appSecret = "你的应用的appSecret";
String nonce = "12345";
String curTime = String.valueOf((new Date()).getTime() / 1000L);
String checkSum = CheckSumBuilder.getCheckSum(appSecret, nonce ,curTime);//参考 计算CheckSum的java代码
// 设置请求的header
httpPost.addHeader("AppKey", appKey);
httpPost.addHeader("Nonce", nonce);
httpPost.addHeader("CurTime", curTime);
httpPost.addHeader("CheckSum", checkSum);
httpPost.addHeader("Content-Type", "application/x-www-form-urlencoded;charset=utf-8");
// 设置请求的参数
List
//账户名 你的应用中IM功能中的账户或者你的网易云信账户(不推荐这种)
nvps.add(new BasicNameValuePair("accid", "IM账户"));
httpPost.setEntity(new UrlEncodedFormEntity(nvps, "utf-8"));
// 执行请求
HttpResponse response = httpClient.execute(httpPost);
// 打印执行结果
System.out.println(EntityUtils.toString(response.getEntity(), "utf-8"));
}
}
2.7 网易云通信服务端接口概述以及CheckSumBuilder.java:接口概述
2.8 网易云通信ID官方文档:网易云通信ID官方文档,这里你可以看到网易云通信ID各个接口的请求说明;接口描述;参数说明;curl请求示例;返回说明以及主要的返回码。
若是哪里有理解错误的或写错的地方,望各位读者评论或者私信指正,不胜感激。