開源IM項目-InChat登錄接口設計與實現(xiàn)(基于Netty)

只給你最值得的信息

小弟正在做的一個開源IM項目驼壶,目標是實現(xiàn)一個輕量級躏嚎、高效率的支持聊天與物聯(lián)網的通訊框架轧拄。昨天剛剛出的設計稿并再今天做了實現(xiàn)诅病。

項目是基于Netty的二次開發(fā)汰具,關于Netty我這里就不再介紹了卓鹿,懂的人自然都懂。我的預算是做一個所有企業(yè)或組織可以引用的Maven項目留荔,并且是基本上開箱即用吟孙,簡單實現(xiàn)對應的配置與重寫方法就可以搭建自己的IM項目(某Q、某信的效果)聚蝶。

本文著重介紹的是登錄接口的設計與實現(xiàn)杰妓。

設計信息

關于InChat統(tǒng)一登錄的接口設計,設計針對小程序碘勉、APP巷挥、Web端的登錄作用,所以將作為token的形式登錄InChat的WebSocket長連接验靡,用戶服務器做sso的認證登錄后得到token后直接發(fā)送login信息到InChat倍宾,用戶服務器需要重寫InChat中的verifyToken方法校驗自己的的Token信息是否有效雏节,正常則啟動長連接≡浔觯考慮到token失效問題矾屯,WebSocket長連接的登錄僅做初次登錄,接下來考慮以心跳形式保持鏈接狀態(tài)(pingpong)初厚,使用token認證是為保護InChat鏈接的常規(guī)化(目前暫時這樣設計后面根據(jù)使用情況更改設計)

[圖片上傳失敗...(image-29d656-1543988912603)]

由于目前大部分的Web項目或基于IM的項目登錄可能存在多端的單點登錄,所以我選用了Token的形式孙技,為什么登錄后還需要用token再來websocket這邊校驗一次呢产禾?

因為你登錄的是web應用程序端的,而websocket而言牵啦,只要別人知道你的地址亚情,那么就可以鏈接上,我們不希望存在過多的死鏈接(無效鏈接)哈雏,所以我們需要將token再次發(fā)給InChat登錄楞件,由InChat來檢驗是否是合法登錄鏈接,如果無效則關閉鏈接裳瘪。

代碼實現(xiàn)

由于是想要做給別人用的土浸,那么我們自己本身就要封裝的好一點,對于配置我選了足夠多的類型彭羹。

[圖片上傳失敗...(image-a24a6f-1543988912603)]

對于netty監(jiān)聽與初始化黄伊,我使用的方式是掃描與AspectJ,你可以在項目的auto包中看到掃描啟動派殷,這種啟動思路我也是參考了其他的開源項目(具體忘記了地址)还最。

    @Bean
    @ConditionalOnMissingBean(name = "sacnScheduled")
    public ScanRunnable initRunable(@Autowired  InitNetty serverBean){
        long time =(serverBean==null || serverBean.getPeriod()<5)?10:serverBean.getPeriod();
        ScanRunnable sacnScheduled = new SacnScheduled(time);
        Thread scanRunnable = new Thread(sacnScheduled);
        scanRunnable.setDaemon(true);
        scanRunnable.start();
        return sacnScheduled;
    }


    @Bean(initMethod = "open", destroyMethod = "close")
    @ConditionalOnMissingBean
    public InitServer initServer(InitNetty serverBean){
        if(!ObjectUtils.allNotNull(serverBean.getWebport(),serverBean.getServerName())){
            throw  new NullPointerException("not set port");
        }
        if(serverBean.getBacklog()<1){
            serverBean.setBacklog(_BLACKLOG);
        }
        if(serverBean.getBossThread()<1){
            serverBean.setBossThread(CPU);
        }
        if(serverBean.getInitalDelay()<0){
            serverBean.setInitalDelay(SEDU_DAY);
        }
        if(serverBean.getPeriod()<1){
            serverBean.setPeriod(SEDU_DAY);
        }
        if(serverBean.getHeart()<1){
            serverBean.setHeart(TIMEOUT);
        }
        if(serverBean.getRevbuf()<1){
            serverBean.setRevbuf(BUF_SIZE);
        }
        if(serverBean.getWorkerThread()<1){
            serverBean.setWorkerThread(CPU*2);
        }
        return new InitServer(serverBean);
    }

在上圖中存在一個DefaultWebSocketHandler,這個是默認的netty啟動處理毡惜。

當然在執(zhí)行它之前拓轻,還需要執(zhí)行到一個抽象的類WebSocketHandler。

它將會為我做一些基本的功能操作经伙。

@Slf4j
public abstract class WebSocketHandler extends SimpleChannelInboundHandler<Object> {

    WebSocketHandlerApi webSocketHandlerApi;

    public WebSocketHandler(WebSocketHandlerApi webSocketHandlerApi){
        this.webSocketHandlerApi = webSocketHandlerApi;
    }

    @Override
    protected void channelRead0(ChannelHandlerContext ctx, Object msg) throws Exception {
        if (msg instanceof TextWebSocketFrame){
            textdoMessage(ctx,(TextWebSocketFrame)msg);
        }else if (msg instanceof WebSocketFrame){
            webdoMessage(ctx,(WebSocketFrame)msg);
        }
    }

    protected abstract void webdoMessage(ChannelHandlerContext ctx, WebSocketFrame msg);

    protected abstract void textdoMessage(ChannelHandlerContext ctx, TextWebSocketFrame msg);

    @Override
    public void channelInactive(ChannelHandlerContext ctx) throws Exception {
        log.info("【DefaultWebSocketHandler:channelInactive】"+ctx.channel().localAddress().toString()+"關閉成功");
        webSocketHandlerApi.close(ctx.channel());
    }

    @Override
    public void userEventTriggered(ChannelHandlerContext ctx, Object evt) throws Exception {
        if(evt instanceof IdleStateEvent){
            webSocketHandlerApi.doTimeOut(ctx.channel(),(IdleStateEvent)evt);
        }
        super.userEventTriggered(ctx, evt);
    }
}

對于登錄接口扶叉,他是基于WebSocket的,且是TextWebSocketFrame類型的橱乱,WebSocketFrame是后期的圖片聊天功能辜梳,所以我們的DefaultWebSocketHandler暫時只需要實現(xiàn)textdoMessage。

對于websocket的傳輸我們推薦使用json形式泳叠,這對于前后端都是由好處的作瞄。

    @Override
    protected void textdoMessage(ChannelHandlerContext ctx, TextWebSocketFrame msg) {
        Channel channel = ctx.channel();
        ServerWebSocketHandlerService serverWebSocketHandlerService;
        if (webSocketHandlerApi instanceof ServerWebSocketHandlerService){
            serverWebSocketHandlerService = (ServerWebSocketHandlerService)webSocketHandlerApi;
        }else{
            throw new NoFindHandlerException("Server Handler 不匹配");
        }
        Map<String,String> maps = (Map) JSON.parse(msg.text());
        switch (maps.get("type")){
            case "login":
                serverWebSocketHandlerService.login(channel,msg);
                break;
            default:
                break;
        }
    }

由上面的代碼,你也許才想到了前端登錄的大致json內容危纫,沒錯是這樣的宗挥。

{
    type: "login",
    token: value
}

ServerWebSocketHandlerService是一個自己定義的后端WebSocket存在的接口實現(xiàn)服務乌庶,我們現(xiàn)在使用到他的登錄接口,讓我們來看看他的登錄實現(xiàn)方法契耿。

    
    @Autowired
    InChatVerifyService inChatVerifyService;
    
    @Override
    public boolean login(Channel channel, TextWebSocketFrame textWebSocketFrame) {
        //校驗規(guī)則瞒大,自定義校驗規(guī)則
        Map<String,String> maps = (Map<String, String>) JSON.parse(textWebSocketFrame.text());
        System.out.println("login-"+textWebSocketFrame.text());
        String token = maps.get("token");
        Gson gson = new Gson();
        Map<String,String> backMap = new HashMap<>();
        if (inChatVerifyService.verifyToken(token)){
            backMap.put("type","login");
            backMap.put("success","true");
            channel.writeAndFlush(new TextWebSocketFrame(gson.toJson(backMap)));
            return true;
        }
        backMap.put("type","login");
        backMap.put("success","false");
        channel.writeAndFlush(new TextWebSocketFrame(gson.toJson(backMap)));
        close(channel);
        return false;
    }

由以上可看出,我們會將token和inChatVerifyService.verifyToken做校驗搪桂,這是一個接口透敌,我并沒有寫實現(xiàn),因為這個是用戶的事情了踢械,它需要實現(xiàn)并重寫我的verifyToken方法酗电,并返回給我一個值,如下是我測試的時候寫的模擬實現(xiàn)内列。

/**
 * 不屬于項目代碼
 * Created by MySelf on 2018/11/22.
 */
@Service
public class InChatVerifyServiceImpl implements InChatVerifyService {

    @Override
    public boolean verifyToken(String token) {
        //與Redis中的Token做比較撵术,請用戶自己實現(xiàn),查找是否存在該Token值
        System.out.println("verify---"+token);
        if ("3333".equals(token)){
            return true;
        }
        return false;
    }
}

我僅僅做了普通的校驗,對于用戶可以注入RedisTemplate然后進行校驗等工作话瞧。到此我們的登錄接口就實現(xiàn)好了嫩与!

看看效果

微信圖片_20181122171033.png

GitHub

項目名:InChat
項目地址:https://github.com/UncleCatMySelf/InChat
項目簡介:A lightweight, efficient communication framework that supports chat and the Internet of Things(一個輕量級、高效率的支持聊天與物聯(lián)網的通訊框架)

Demo分支

原始項目核心演示, 您可以先運行了解, 模仿微聊天聊天應用程序, 逐步更新, 基于 springbot-web 套接字的一般框架, 結合 netty 聊天社交, 并記錄聊天日志, 異步存儲, 前端臨時 sui mobile, 添加實現(xiàn) tcp/后端通信端口 (mqtt 協(xié)議交排、實時和單片機等 tcp 硬件通信), 添加圖片處理流划滋、聊天實現(xiàn)文本和圖片發(fā)送功能,api 調用 netty 長鏈接執(zhí)行發(fā)送消息 (聯(lián)機、用戶列表的數(shù)量)

[圖片上傳失敗...(image-31008c-1543988912603)]

webrtc分支

基于Netty與web RTC實現(xiàn)語音與視頻通訊的分支項目

im-api分支

騰訊 im (云通信) 后端仿真項目, 以 api 的形式對接, 如果有前端想要透隽唬靠可以運行此分支, 預計該分支最終將為一個單一的服務并發(fā) 300, 000個用戶的 im 后臺項目

paho-mqtt分支

基于 paho. js 和 java mqtt 客戶端消息訂閱和通信的小型程序端或移動 web 端, 小程序物聯(lián)網演示目前支持 ws 格式

tcp-wechat分支

基于小程序端與單片機等硬件 tcp/ip 的主要通信, 將物聯(lián)網中心作為中轉, 本演示將充分實現(xiàn)具體功能


1787897575-5b6fb1bf2b46f_articlex.png
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
  • 序言:七十年代末古毛,一起剝皮案震驚了整個濱河市,隨后出現(xiàn)的幾起案子都许,更是在濱河造成了極大的恐慌稻薇,老刑警劉巖,帶你破解...
    沈念sama閱讀 216,470評論 6 501
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件胶征,死亡現(xiàn)場離奇詭異塞椎,居然都是意外死亡,警方通過查閱死者的電腦和手機睛低,發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 92,393評論 3 392
  • 文/潘曉璐 我一進店門案狠,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人钱雷,你說我怎么就攤上這事骂铁。” “怎么了罩抗?”我有些...
    開封第一講書人閱讀 162,577評論 0 353
  • 文/不壞的土叔 我叫張陵拉庵,是天一觀的道長。 經常有香客問我套蒂,道長钞支,這世上最難降的妖魔是什么茫蛹? 我笑而不...
    開封第一講書人閱讀 58,176評論 1 292
  • 正文 為了忘掉前任,我火速辦了婚禮烁挟,結果婚禮上婴洼,老公的妹妹穿的比我還像新娘。我一直安慰自己撼嗓,他們只是感情好柬采,可當我...
    茶點故事閱讀 67,189評論 6 388
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著且警,像睡著了一般警没。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上振湾,一...
    開封第一講書人閱讀 51,155評論 1 299
  • 那天,我揣著相機與錄音亡脸,去河邊找鬼押搪。 笑死,一個胖子當著我的面吹牛浅碾,可吹牛的內容都是我干的大州。 我是一名探鬼主播,決...
    沈念sama閱讀 40,041評論 3 418
  • 文/蒼蘭香墨 我猛地睜開眼垂谢,長吁一口氣:“原來是場噩夢啊……” “哼厦画!你這毒婦竟也來了?” 一聲冷哼從身側響起滥朱,我...
    開封第一講書人閱讀 38,903評論 0 274
  • 序言:老撾萬榮一對情侶失蹤根暑,失蹤者是張志新(化名)和其女友劉穎,沒想到半個月后徙邻,有當?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體排嫌,經...
    沈念sama閱讀 45,319評論 1 310
  • 正文 獨居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內容為張勛視角 年9月15日...
    茶點故事閱讀 37,539評論 2 332
  • 正文 我和宋清朗相戀三年缰犁,在試婚紗的時候發(fā)現(xiàn)自己被綠了淳地。 大學時的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點故事閱讀 39,703評論 1 348
  • 序言:一個原本活蹦亂跳的男人離奇死亡帅容,死狀恐怖颇象,靈堂內的尸體忽然破棺而出,到底是詐尸還是另有隱情并徘,我是刑警寧澤遣钳,帶...
    沈念sama閱讀 35,417評論 5 343
  • 正文 年R本政府宣布,位于F島的核電站饮亏,受9級特大地震影響耍贾,放射性物質發(fā)生泄漏阅爽。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點故事閱讀 41,013評論 3 325
  • 文/蒙蒙 一荐开、第九天 我趴在偏房一處隱蔽的房頂上張望付翁。 院中可真熱鬧,春花似錦晃听、人聲如沸百侧。這莊子的主人今日做“春日...
    開封第一講書人閱讀 31,664評論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽佣渴。三九已至,卻和暖如春初斑,著一層夾襖步出監(jiān)牢的瞬間辛润,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 32,818評論 1 269
  • 我被黑心中介騙來泰國打工见秤, 沒想到剛下飛機就差點兒被人妖公主榨干…… 1. 我叫王不留砂竖,地道東北人。 一個月前我還...
    沈念sama閱讀 47,711評論 2 368
  • 正文 我出身青樓鹃答,卻偏偏與公主長得像乎澄,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個殘疾皇子测摔,可洞房花燭夜當晚...
    茶點故事閱讀 44,601評論 2 353

推薦閱讀更多精彩內容