《开源精选》是我们分享 Github、Gitee 等开源社区中优质项目的栏目，包括技术、学习、实用与各种有趣的内容。本期推荐的 J-IM 是用 JAVA 语言开发的轻量、高性能、单机支持几十万至百万在线用户 IM，主要目标降低即时通讯门槛，快速打造低成本接入在线 IM 系统。
J-IM简介
J-IM 是用 JAVA 语言开发的轻量、高性能、单机支持几十万至百万在线用户 IM，主要目标降低即时通讯门槛，快速打造低成本接入在线IM系统，通过极简洁的消息格式就可以实现多端不同协议间的消息发送如内置(Http、Websocket、Tcp 自定义 IM 协议)等，并提供通过 http 协议的 api 接口进行消息发送无需关心接收端属于什么协议，一个消息格式搞定一切！
主要特点
-
• 高性能(单机可支持几十万至百万人同时在线)
-
• 轻量、可扩展性极强
-
• 支持集群多机部署
-
• 支持 SSL/TLS 加密传输
-
• 消息格式极其简洁(JSON)
-
• 一端口支持可插拔多种协议(Socket 自定义 IM 协议、Websocket、Http),各协议可分别独立部署。
-
• 内置消息持久化(离线、历史、漫游)，保证消息可靠性，高性能存储
-
• 各种丰富的 API 接口。
-
• 零成本部署，一键启动。
消息格式
1.聊天请求消息结构
{
"from": "来源ID",
"to": "目标ID",
"cmd":"命令码(11)int类型",
"createTime": "消息创建时间long类型",
"msgType": "消息类型int类型(0:text、1:image、2:voice、3:vedio、4:music、5:news)",
"chatType":"聊天类型int类型(0:未知,1:公聊,2:私聊)",
"groupId":"群组id仅在chatType为(1)时需要,String类型",
"content": "内容",
"extras" : "扩展字段,JSON对象格式如：{'扩展字段名称':'扩展字段value'}"
}请求:COMMAND_CHAT_REQ(11)
响应:COMMAND_CHAT_RESP(12)
2.鉴权请求消息结构
{
"cmd":"命令码(3)int类型",
"token": "校验码"
}请求:COMMAND_AUTH_REQ(3)
响应:COMMAND_AUTH_RESP(4)
3.握手请求消息结构
{
"cmd":"命令码(1)int类型",
"hbyte":"握手1个字节"
}请求:COMMAND_HANDSHAKE_REQ(1)
响应:COMMAND_HANDSHAKE_RESP(2)**
4.登录请求消息结构
{
"cmd":"命令码(5)int类型",
"userId": "用户账号",
"password": "密码",
"token": "校验码(此字段可与userId、password共存,也可只选一种方式)"
}请求:COMMAND_LOGIN_REQ(5)
响应:COMMAND_LOGIN_RESP(6)
5.心跳请求消息结构
{
"cmd":"命令码(13)int类型",
"hbbyte":"心跳1个字节"
}请求:COMMAND_HEARTBEAT_REQ(13)
响应:COMMAND_HEARTBEAT_REQ(13)
6.关闭、退出请求消息结构
{
"cmd":"命令码(14)int类型",
"userId":"用户ID"
}请求:COMMAND_CLOSE_REQ(14)
响应:无
7.获取用户信息请求消息结构
{
"cmd":"命令码(17)int类型",
"userId":"用户id(必填项)",
"type":"获取类型(0:所有在线用户,1:所有离线线用户,2:所有用户[在线+离线])"
}请求:COMMAND_GET_USER_REQ(17)
响应:COMMAND_GET_USER_RESP(18)
8.获取持久化聊天消息(离线+历史+漫游)请求结构
{
"cmd":"命令码(19)int类型",
"fromUserId":"消息发送用户id(此字段必须与userId一起使用,获取双方聊天消息),非必填",
"userId":"当前用户id(必填字段),当只有此字段时,type必须为0，意思是获取当前用户所有离线消息(好友+群组)",
"groupId":"群组id(此字段必须与userId一起使用,获取当前用户指定群组聊天消息),非必填",
"beginTime":"消息区间开始时间Date毫秒数double类型,非必填",
"endTime":"消息区间结束时间Date毫秒数double类型,非必填",
"offset":"分页偏移量int类型，类似Limit 0,10 中的0,非必填",
"count":"显示消息数量,类似Limit 0,10 中的10,非必填",
"type":"消息类型(0:离线消息,1:历史消息)"
}请求:COMMAND_GET_MESSAGE_REQ(19)
响应:COMMAND_GET_MESSAGE_RESP(20)
使用
-
• 服务端(快速开发自己的高性能IM服务器)：引入 jim-server,在你的 pom.xml 中加入如下代码片段
<dependency>
<groupId>org.j-im</groupId>
<artifactId>jim-server</artifactId>
<version>3.0.0.v20200501-RELEASE</version>
</dependency>-
• 客户端(快速开发自己的IM客户端)：引入 jim-client,在你的 pom.xml 中加入如下代码片段
<dependency>
<groupId>org.j-im</groupId>
<artifactId>jim-client</artifactId>
<version>3.0.0.v20200501-RELEASE</version>
</dependency>截图
传送门
开源协议：Apache 2.0
开源地址：https://gitee.com/xchao/j-im
-END-
原文始发于微信公众号（开源技术专栏）：低成本接入在线J-IM系统，用过直接卸载扣扣
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请发送邮件至 举报，一经查实，本站将立刻删除。
文章由极客之音整理，本文链接：https://www.bmabk.com/index.php/post/79573.html
