YMPオンラインマニュアル
/ 服務概述
服務概述
服務模塊(Serv)是一套基于NIO實現(xiàn)的通訊服務框架,提供TCP、UDP協(xié)議的客戶端與服務端封裝,靈活的消息監(jiān)聽與消息內(nèi)容編/解碼,簡約的配置使二次開發(fā)更加便捷;
同時默認提供斷線重連、鏈路維護(心跳)等服務支持,您只需了解業(yè)務即可輕松完成開發(fā)工作。
Maven包依賴
<dependency> <groupId>net.ymate.platform</groupId> <artifactId>ymate-platform-serv</artifactId> <version>2.0-SNAPSHOT</version> </dependency>
注:在項目的pom.xml中添加上述配置,該模塊已經(jīng)默認引入核心包依賴,無需重復配置。
基礎概念
會話(Session)
用于客戶端與服務端之間連接狀態(tài)的維護和消息發(fā)送的對象;
編/解碼器(Codec)
目前提供以下兩種編/解碼器,開發(fā)者可通過實現(xiàn)ICodec接口自行擴展;
NioStringCodec:采用字節(jié)byte[4]作為消息頭,用于記錄消息體長度的字符串消息編/解碼器;
TextLineCodec:用于解析以回車換行符(\r\n)做為消息結(jié)束標志的字符串消息的編/解碼器;
內(nèi)置服務(Service)
目前提供以下兩種內(nèi)置服務,更多服務在不斷完善中...;
IHeartbeatService:內(nèi)置鏈路維護(心跳)服務,該服務將在與服務端成功建立連接后按參數(shù)配置的時間間隔向服務端發(fā)送心跳消息(心跳消息內(nèi)容默認為0字符,心跳消息內(nèi)容可以通過自定義參數(shù)heartbeat_message設置);
IReconnectService:內(nèi)置斷線重連服務,當服務的連接狀態(tài)異常時將嘗試重新與服務端建立連接;