Migrated repository
Go to file
2018-07-25 08:54:10 +08:00
docs 增加J-IM开发文档 2018-05-11 15:11:01 +08:00
jim-client 发布v2.2.0版本,优化消息体设计改为建造者模式Builder.build创建,同时增加消息体扩展字段extras 2018-07-25 00:48:04 +08:00
jim-common 发布v2.2.0版本,优化消息体设计改为建造者模式Builder.build创建,同时增加消息体扩展字段extras 2018-07-25 00:48:04 +08:00
jim-parent 发布v2.2.0版本,优化消息体设计改为建造者模式Builder.build创建,同时增加消息体扩展字段extras 2018-07-25 00:48:04 +08:00
jim-server 发布v2.2.0版本,优化消息体设计改为建造者模式Builder.build创建,同时增加消息体扩展字段extras 2018-07-25 00:48:04 +08:00
jim-server-demo 发布v2.2.0版本,优化消息体设计改为建造者模式Builder.build创建,同时增加消息体扩展字段extras 2018-07-25 00:48:04 +08:00
.gitignore 增加idea的ignore文件 2018-07-18 14:47:30 +08:00
LICENSE 修改协议为Apache协议 2018-04-04 11:48:05 +08:00
README.md 更新 README.md 2018-07-25 08:54:10 +08:00

输开源协议

maven最新版本

J-IM简介

J-IM 是用JAVA语言,基于t-io开发的轻量、高性能、单机支持几十万至百万在线用户IM主要目标降低即时通讯门槛快速打造低成本接入在线IM系统通过极简洁的消息格式就可以实现多端不同协议间的消息发送如内置(Http、Websocket、Tcp自定义IM协议)等并提供通过http协议的api接口进行消息发送无需关心接收端属于什么协议一个消息格式搞定一切
JavaDoc https://apidoc.gitee.com/xchao/j-im/

主要特点

    1、高性能(单机可支持几十万至百万人同时在线)
    2、轻量、可扩展性极强
    3、支持集群多机部署
    4、支持SSL/TLS加密传输
    5、消息格式极其简洁(JSON)
    6、支持多种协议(Socket自定义IM协议、Websocket、Http),可分别独立部署。
    7、内置消息持久化(离线、历史、漫游),保证消息可靠性,高性能存储
    8、各种丰富的API接口。
    9、零成本部署一键启动。

消息格式

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:私聊)",
   "group_id":"群组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类型",
    "loginname": "用户名",
    "password": "密码",
    "token": "校验码(此字段可与logingname、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)

性能

   极其震撼的性能那个每秒发送500万条聊天消息单机支持几十万人同时在线的测试当年引起了极大争议,看看t-io用户的一则测试报告吧 t-io 30W长连接并发压力测试报告

使用

  • 引入j-im(快速开发自己的高性能IM服务器),在你的pom.xml中加入如下代码片段
<dependency>
    <groupId>org.j-im</groupId>
    <artifactId>jim-server</artifactId>
    <version>2.2.0.v20180725-RELEASE</version>
</dependency>

J-IM一些截图

Web访问地址:http://localhost:8888

输入图片说明

Http协议api调用地址:http://localhost:8888/api/message/send

输入图片说明

输入图片说明

近期发布

  • 支持Https、Wss (已完成)
  • 支持J-PUSH消息推送
  • 支持图片、语音、视频发送等
  • 官网开发

更多

更多相关信息持续关注这家伙:t-io不仅仅百万并发框架

鸣谢

t-io不仅仅百万并发框架

联系方式

个人QQ:1241503759
个人Email:wchaojava@163.com

官方QQ群号245513673 J-IM朋友圈

群二维码