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