本文首發公眾號與個人部落格:Java貓說 & 貓叔的部落格 | MySelf,轉載請申明出處。
前言
大家可以看看上一篇:用Java構建一個簡單的WebSocket聊天室
在上一篇文章中我們已經實現了:自我對話、好友交流、群聊、離線訊息等的功能。
而本篇,我們的框架升級了,並且開通了幾個新的HTTP介面功能,同時也把原先框架的一些異常做了處理。
我們將使用更少的程式碼完成功能更加完善的聊天專案!
採用框架
我們整個Demo基本不需要大家花費太多時間,就可以實現以下的功能。
- 使用者token登入校驗
- 自我聊天
- 點對點聊天
- 群聊
- 獲取線上使用者數與使用者標籤列表
- 傳送系統通知
首先,我們需要介紹一下我們今天打算採用的框架,InChat : 一個輕量級、高效率的支援多端(應用與硬體Iot)的非同步網路應用通訊框架,採用這個框架,我們基本上只需要兩三個類就可以實現我們今天需要的功能了。
先看看效果
需要了解SSM & SpringBoot 嗎?
InChat ,本身不依賴於任何的底層框架,所以大家只要會基本的Java語言就可以實現一套自己的WebSocket聊天室。
框架使用手冊(新版V1.1.2剛剛釋出)
關於詳細的手冊說明,大家可以看看官網的介紹:
<dependency>
<groupId>com.github.UncleCatMySelf</groupId>
<artifactId>InChat</artifactId>
<version>1.1.2</version>
</dependency>
複製程式碼
開始Demo搭建
構建一個空的Maven專案
我們不需要依賴其他的Maven包,只要本文提及的框架即可。
<dependency>
<groupId>com.github.UncleCatMySelf</groupId>
<artifactId>InChat</artifactId>
<version>1.1.2</version>
</dependency>
複製程式碼
InChat啟動引數可以自配置
你只需要繼承InChat的預設配置類InitNetty
即可,如下
public class MyInit extends InitNetty {
/** 自定義啟動監聽埠 */
@Override
public int getWebport() {
return 8090;
}
}
複製程式碼
獲取聊天訊息資料
此介面與原先一樣,僅修改了方法名
public class DataBaseServiceImpl implements InChatToDataBaseService {
@Override
public Boolean writeMessage(InChatMessage message) {
System.out.println(message.toString());
return true;
}
}
複製程式碼
登入校驗與群聊訊息
此介面沒有做過多的修改
public class VerifyServiceImpl implements InChatVerifyService {
@Override
public boolean verifyToken(String token) {
return true;
}
@Override
public JSONArray getArrayByGroupId(String groupId) {
JSONArray jsonArray = JSONArray.parseArray("[\"1111\",\"2222\",\"3333\"]");
return jsonArray;
}
}
複製程式碼
服務端傳送通知訊息列舉類
此介面具有Demo模板,使用者需要繼承InChat框架的FromServerService
介面,同時該介面註釋也有例項demo,我們需要實現一個自定義的列舉,你可以這樣寫:
public enum FromServerServiceImpl implements FromServerService {
//你可以自定義自己的系統訊息,請以Integer-String的形式
TYPE1(1,"【系統通知】您的賬號存在異常,請注意安全保密資訊。"),
TYPE2(2,"【系統通知】恭喜您連續登入超過5天,獎勵5積分。");
private Integer code;
private String message;
FromServerServiceImpl(Integer code, String message){
this.code = code;
this.message = message;
}
public Integer getCode() {
return code;
}
//實現介面的方法,遍歷本列舉的code,獲取對應的訊息,作為系統訊息傳送
public String findByCode(Object code) {
Integer codes = (Integer)code;
for (FromServerServiceImpl item: FromServerServiceImpl.values()) {
if (item.code == codes){
return item.message;
}
}
return null;
}
public void setCode(Integer code) {
this.code = code;
}
public String getMessage() {
return message;
}
public void setMessage(String message) {
this.message = message;
}
}
複製程式碼
啟動專案
1.1.2版本的啟動專案變得異常的簡單,你只需要配置啟動的配置工廠即可。
public class application {
public static void main(String[] args) {
//配置你的自定義配置
ConfigFactory.initNetty = new MyInit();
//配置校驗類
ConfigFactory.inChatVerifyService = new VerifyServiceImpl();
//配置訊息接收處理類
ConfigFactory.inChatToDataBaseService = new DataBaseServiceImpl();
//配置服務端系統訊息列舉,這裡的值無所謂 TYPE1或者TYPE2或者TYPEN均可以
ConfigFactory.fromServerService = FromServerServiceImpl.TYPE1;
//啟動InChat
InitServer.open();
}
}
複製程式碼
專案效果
啟動成功
DEBUG - -Dio.netty.threadLocalDirectBufferSize: 0
DEBUG - -Dio.netty.maxThreadLocalCharBufferSize: 16384
INFO - 服務端啟動成功【192.168.56.1:8090】
複製程式碼
當聊天連線未註冊情況下,客戶端自動斷開後,服務會自動包對應的異常
INFO - [Handler:channelInactive]/192.168.56.1:8090關閉成功
ERROR - [捕獲異常:NotFindLoginChannlException]-[Handler:channelInactive] 關閉未正常註冊連結!
複製程式碼
原先的
自我傳送
,點對點傳送
,群聊
均與原來一樣
原先的介面說明可以看上一版本: v1.1.0-alpha版本使用說明
新功能新增 HTTP
新增HTTP介面三個,在你啟動Inchat的時候,預設啟動,對於你的其他web API並無任何影響,它是一個IM的輔助作用。本版本不支援使用者自定義相關的InChat HTTP介面
獲取線上使用者數
- 地址:
[ip:埠]/get_size
GET - 返回值
{
"code": 200,
"data": {
"online": 1,//當前線上數
"time": "Jan 3, 2019 10:06:45 PM"//查詢時間
}
}
複製程式碼
獲取線上使用者標識
- 地址:
[ip:埠]/get_list
GET - 返回值
{
"code": 200,
"data": {
//返回線上使用者列表
"tokens": [
"1111"
]
}
}
複製程式碼
根據使用者標籤,傳送系統指定訊息
- 地址:
[ip:埠]/send_from_server
POST - 引數:
token
(你可以從get_list
中得到線上使用者標籤)、value
(你在系統中新增列舉的code
值,這裡不接受字串) - 返回值
{
"code": 400,
"data": {
"message": "通知傳送成功"
}
}
複製程式碼
(有個小BUG,返回值code應該是200)
關於前端
InChat : 一個輕量級、高效率的支援多端(應用與硬體Iot)的非同步網路應用通訊框架,大家可以直接來這個專案下獲取前端頁面,或者直接訪問這個地址:github.com/UncleCatMyS…
對於這個前端頁面,我們需要更改一下IP地址。
執行除錯專案
接下來直接啟動後端專案,當我們看到以下的資訊,則專案啟動成功。
INFO - 服務端啟動成功【192.168.1.121:8090】
複製程式碼
這裡的IP需要更換以下讀者啟動後的IP地址。
接著直接用瀏覽器開啟chat.html的頁面即可,關於js的方法,大家可以看看InChatV1.1.0版本使用說明。
執行效果已經提前展示啦!
公眾號:Java貓說
現架構設計(碼農)兼創業技術顧問,不羈平庸,熱愛開源,雜談程式人生與不定期乾貨。