网易云信Web IM入门(一)

一.运行Web IM的demo

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现在用的是网易云的服务器,我们想自己使用它,所以要做以下配置。

二.Web IM使用前的准备

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 nvps = new ArrayList();
        //账户名 你的应用中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请求示例;返回说明以及主要的返回码。

这是做完配置和准备工作后的使用:网易云信Web IM入门(二)

若是哪里有理解错误的或写错的地方,望各位读者评论或者私信指正,不胜感激。

你可能感兴趣的:(一位小小的人的java,web的学习之路)