經(jīng)常有朋友問(wèn)起GoEasy如何實(shí)現(xiàn)IM,今天就手把手的帶大家從頭到尾用GoEasy實(shí)現(xiàn)一個(gè)完整IM聊天,全套代碼已經(jīng)放在了github。
今日的前端技術(shù)發(fā)展可謂百花爭(zhēng)鳴,為了確保本文能幫助到使用任何技術(shù)棧的前端工程師,Demo的源碼實(shí)現(xiàn)上選擇了最簡(jiǎn)單的HTML+JQuery的方式,所以,不論您是準(zhǔn)備用Uniapp開(kāi)發(fā)移動(dòng)APP,還是準(zhǔn)備寫(xiě)個(gè)小程序,不論你喜歡用React還是VUE,還是React-native或ionic, 或者您直接用原生 和Type ,都是可以輕松理解,全套代碼已經(jīng)放在github上了,下載后不需要搭建任何環(huán)境,直接用瀏覽器打開(kāi),就可以用來(lái)聊天了。

作為一名程序員,在編碼之前,首先要做的當(dāng)然是架構(gòu)設(shè)計(jì)!什么?確認(rèn)不是裝逼?當(dāng)然,別忘了星爺?shù)哪蔷湓挘何沂且幻绦騿T!沒(méi)有思想的程序員,跟咸魚(yú)有什么區(qū)別呢?

咳咳咳,正文開(kāi)始:
首先我們代碼層將整個(gè)功能分為四層:
1、華麗的展示層(index.html):你們負(fù)責(zé)功能優(yōu)雅強(qiáng)大,我負(fù)責(zé)貌美如花。展示層其實(shí)就是純靜態(tài)的html,顯示界面,高端點(diǎn)說(shuō),就是負(fù)責(zé)人機(jī)交互的。
2、承上啟下的控制層(controller.js): 控制層作用就是接受頁(yè)面操作的參數(shù),調(diào)用service層,根據(jù)頁(yè)面的操作指令或者service層的反饋,負(fù)責(zé)對(duì)頁(yè)面的展示做出控制。不可以編寫(xiě)任何與展示邏輯無(wú)關(guān)的代碼,也就是不能侵入任何業(yè)務(wù)邏輯。衡量這一層做的好不好的的標(biāo)準(zhǔn),就是假設(shè)刪掉controller和view層,service能準(zhǔn)確完整的描述所有的業(yè)務(wù)邏輯。
3、運(yùn)籌帷幄的關(guān)鍵核心業(yè)務(wù)層(service.js): 接受controller層的指令,實(shí)現(xiàn)業(yè)務(wù)邏輯,必要時(shí)候調(diào)用goeasy提供網(wǎng)絡(luò)通訊支持,或調(diào)用restapi層完成數(shù)據(jù)的查詢和保存。這一層包含所有的業(yè)務(wù)邏輯,任何業(yè)務(wù)邏輯相關(guān)的代碼,都不可以漏到其他層,確保只要service存在,整個(gè)項(xiàng)目的靈魂就存在,確保service層完全是原生代碼實(shí)現(xiàn)業(yè)務(wù)邏輯,而沒(méi)有類(lèi)似于vue或者小程序前端框架的語(yǔ)法和代碼滲入,從而達(dá)到service層能夠在任何前端框架通用。
4、神通廣大的服務(wù)器交互層(restapi.js): 根據(jù)傳入的參數(shù)完成服務(wù)器端接口的調(diào)用,來(lái)實(shí)現(xiàn)數(shù)據(jù)查詢或、修改或保存,并且返回結(jié)果,不參與任何業(yè)務(wù)邏輯。在實(shí)踐中大部分是負(fù)責(zé)發(fā)送http請(qǐng)求和服務(wù)器交互。
分層的目標(biāo)就是為了確保除了在核心業(yè)務(wù)層以外的其他層次能夠被輕易的替換。舉例:我們當(dāng)前的版本是使用html+jquery完成,如果希望再開(kāi)發(fā)一個(gè)Uniapp實(shí)現(xiàn)的小程序或者app,只需要用Uniapp畫(huà)個(gè)新外殼,對(duì)controller層做一些修改,就可輕松完成一個(gè)小程序或者APP版的IM聊天,不需要對(duì)service和restapi做任何修改 。同理,如果服務(wù)器端發(fā)生變化,或者更換了與服務(wù)器的交互方式,只需要對(duì)restapi做出修改,其他三層則不受任何影響。
OK, 有了如此清晰而優(yōu)秀的代碼結(jié)構(gòu)分層設(shè)計(jì),就差一段優(yōu)雅的代碼來(lái)實(shí)現(xiàn)了。
Ready, Go! 編碼開(kāi)始:
1、登錄頁(yè)面
這個(gè)最簡(jiǎn)單,閉著眼睛畫(huà)個(gè)界面,用戶名密碼正確后,完成以下幾個(gè)步驟。
1.1. 根據(jù)用戶名查詢出來(lái)的用戶,初始化全局變量:當(dāng)前用戶。
1.2. 將controller層的onNewMessage, onFriendOnline,onFriendOffline賦值給service 。
1.3. new goeasy建立長(zhǎng)連接,記得要傳入userid。如需在subscriberPrencese用戶上下線提醒事件,或者在調(diào)用HereNow獲取在線用戶列表時(shí),能拿到userId以外,更多的信息,可以在userdata里傳入。
1.4. 調(diào)用restapi,查詢?cè)撚脩舻暮糜蚜斜?,根?jù)結(jié)果初始化本地好友列表friendlist。
1.5. 循環(huán)好友,以friendUUID為channel,調(diào)用subscriberPrencense,監(jiān)聽(tīng)所有好友的上下線事件。
1.6. 以當(dāng)前用戶的uuid為channel,調(diào)用subscriber,監(jiān)聽(tīng)來(lái)自所有好友發(fā)來(lái)的消息。
1.7. 顯示好友列表界面。
1.8. 初始化好友的在線狀態(tài),以數(shù)組形式傳入所有好友的userId,調(diào)用hereNowByUserIds,獲得當(dāng)前在線的好友列表,根據(jù)結(jié)果將friendlist里屬于在線狀態(tài)的friend的在線狀態(tài)改為true,同時(shí)將界面上在線用戶的頭像改為彩色。
2、顯示好友列表(1.7)
2.1. service層獲取當(dāng)前用戶信息,在頁(yè)面顯示當(dāng)前用戶的username和頭像。
2.2. service獲取本地好友列表,然后controller將每個(gè)好友的頭像和名稱(chēng)顯示到頁(yè)面上,對(duì)于當(dāng)前在線的用戶,旁邊顯示一個(gè)小綠點(diǎn),并且為每個(gè)好友綁定一個(gè)點(diǎn)擊事件,點(diǎn)擊好友時(shí),顯示聊天界面, 如果該好友有未讀消息的,紅色小氣泡顯示未讀消息數(shù)量。
3、點(diǎn)擊一個(gè)好友,進(jìn)入與其聊天的界面
3.1. 窗口頂部顯示聊天好友的名稱(chēng)。
3.2. 調(diào)用restapi根據(jù)當(dāng)前用戶的UUID和好友的friendUUID,查詢與該好友的聊天記錄,如果這個(gè)聊天記錄的sender是自己,就顯示在頁(yè)面的右邊,如果是朋友發(fā)的,則顯示在左邊。
3.3. 將該好友在本地?cái)?shù)據(jù)里未讀消息恢復(fù)為0。
3.4. 并且將聊天記錄滾動(dòng)到最下邊。
3.5. 如果點(diǎn)擊返回,就直接調(diào)進(jìn)入第二步。
4、在聊天界面,輸入消息后發(fā)送
4.1. 當(dāng)前用戶uuid作為senderUUID和消息內(nèi)容組成chatMessage。
4.2. 調(diào)用restapi將chatMessage發(fā)往“服務(wù)器”端,我們建議的方式是所有的消息發(fā)往自己的服務(wù)器端,在服務(wù)器端先保存入庫(kù),然后在服務(wù)端publish。具體做法是將chatMessage轉(zhuǎn)換為字符串,入庫(kù),然后將該好友的channel作為channel調(diào)用GoEasy完成publish。(當(dāng)然,你會(huì)發(fā)現(xiàn)在我們的示例代碼這個(gè)過(guò)程是在restapi里直接完成的,原因是為了demo的演示方便,我們模擬的服務(wù)器端行為,相信你懂的)
4.3. 自己的消息發(fā)送成功后,顯示在聊天窗口的右邊。
5、收到新消息
5.1. 在1.6定義了接收好友新消息的事件,當(dāng)收到一條好友的新消息時(shí)。
5.2. 首先調(diào)用restapi保存到服務(wù)器。
5.3. 本地好友數(shù)據(jù)里的未讀消息加1。
5.4. 如果當(dāng)前界面是好友列表,將來(lái)自該朋友的未讀消息的數(shù)字顯示在界面上。
5.5. 如果收到的消息就是來(lái)自當(dāng)前對(duì)話窗口,就將消息顯示到聊天窗口,并且調(diào)用service將本地?cái)?shù)據(jù)里該好友的未讀消息清0。
6、用戶上下線提醒
6.1. 在1.5監(jiān)聽(tīng)了用戶上下線,當(dāng)收到一個(gè)用戶上線或下線的通知后(注意返回的是一個(gè)列表,一次事件有可能有多個(gè)好友都發(fā)生了狀態(tài)變化)。
6.2. 修改將本地?cái)?shù)據(jù)里該好友對(duì)象在線狀態(tài),如果是上線事件就顯示彩色,如果是下線就顯示黑白色。
至此,整個(gè)聊天功能就完成了,是不是很簡(jiǎn)單呢。在整個(gè)demo中只用到了goeasy的四個(gè)API:subscriber(接收消息),subscriberPrencense(接受上下線通知),hereNowByUserIds(獲取當(dāng)前在線用戶列表), publish(發(fā)送消息)。詳情可以參考goeasy官方文檔。https://www.goeasy.io/cn/developers.html
哼!這難道不是紙上談兵嗎?Talk is cheap, show me the code! 優(yōu)雅的代碼在哪里呢?
別著急,當(dāng)然有全套代碼啦,如果放個(gè)zip文件的下載連接,顯得B格太低,老規(guī)矩,github見(jiàn): https://github.com/GoEasySupport/goeasy-chat-demo
注意事項(xiàng):
1.在restapi.js 里 可以找到用戶名和密碼
2.在service.js里將appkey替換為您自己的common key
3.subscriberPrencense和hereNowByUserIds這兩個(gè)方法,默認(rèn)是關(guān)閉的,需要聯(lián)系GoEasy客服開(kāi)通哦~
將代碼與本文一起對(duì)照閱讀后,要寫(xiě)個(gè)IM,比畫(huà)個(gè)0還簡(jiǎn)單,如果使用的是其他的前端技術(shù)框架如小程序和React-native,只需要重新畫(huà)個(gè)外殼就好了!什么,你不相信?如果覺(jué)得你被騙了,可以聯(lián)系GoEasy技術(shù)支持人員,歡迎吐槽!沒(méi)有您暴風(fēng)雨般的吐槽和春風(fēng)一般的贊美,我如何進(jìn)步呢?
彩彈在最后:
看了代碼的你,是不是發(fā)現(xiàn)我們的RESTAPI其實(shí)是個(gè)冒牌貨,并不會(huì)真的和遠(yuǎn)程的某個(gè)服務(wù)器交互,這是為了方便演示,我們定義了兩個(gè)變量來(lái)幫助模擬遠(yuǎn)程數(shù)據(jù)的查詢,然后用localstorage來(lái)模擬服務(wù)器的保存,相信聰明的你,肯定已經(jīng)get到我們的代碼思路了。
GoEasy官網(wǎng):https://www.goeasy.io
到此這篇關(guān)于Websocket IM聊天教程 教你用GoEasy快速實(shí)現(xiàn)IM聊天的文章就介紹到這了,更多相關(guān)Websocket IM聊天內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
您可能感興趣的文章:- 使用Python AIML搭建聊天機(jī)器人的方法示例
- Android中基于XMPP協(xié)議實(shí)現(xiàn)IM聊天程序與多人聊天室
- 基于Python如何使用AIML搭建聊天機(jī)器人
- php版小黃雞simsimi聊天機(jī)器人接口分享
- JavaScript/jQuery、HTML、CSS 構(gòu)建 Web IM 遠(yuǎn)程及時(shí)聊天通信程序
- IM聊天教程之發(fā)送圖片/視頻/語(yǔ)音/表情