第一章 概述1 產品概述SMPPSMProxy是符合SMPP3.4協議的接口，可以同時滿足Unix和WINDOW NT平臺的使用。SMPPSMProxy與SMSC建立TCP連接進行通信，并負責短消息發送和接收、維護與SMSC的握手、斷連重連等；SMPPSMProxy提供客戶API接口函數，包括登錄PROXY、退出PROXY、發送短消息、接受短消息、接受響應信息等。SMPPSMProxy支持多線程并發使用發送短消息，SMPPSMProxy和SMSC之間使用的通信協議是SMPP協議。2 組網結構SMPPSMProxy就是運行在SP上，負責和SMSC進行SMPP3.4協議的通訊，要求SP的功能實體向SMSC發SMPP_SUBMIT消息，由SMSC返回SMPP_DELIVERY消息給SP。3 SMProxy的結構客戶程序調用到SMPPSMProxy提供的接口函數實現收發短消息，SMPPSMProxy實現把客戶程序所發出的消息按SMPP3.4協議進行編碼后發給數據增值業務中心(infoX)，由數據增值業務中心(infoX)發送給SMC，并通過數據增值業務中心(infoX)接收SMC所響應的消息與主動下發的消息并進行解碼后，通知客戶程序接收SMC主動下發的短消息。第二章 SMPP3.4協議的封裝SMPP協議封裝在m.smpp.message包中，主要消息如下（1）SMPPEnquireLinkMessage 心跳消息，對應SMPP3.4文檔中的SMPP_ENQUIRE_LINK消息，是SMPPSMProxy與SMSC的心跳消息。（2）SMPPEnquireLinkRespMessage 心跳響應消息，對應SMPP3.4文檔中的SMPP_ENQUIRE_LINK_RESP，是SMPPSMProxy發送心跳消息后收到的響應消息。（3）SMPPLoginMessage 請求連接消息，對應SMPP3.4文檔中的SMPP_BIND_RECEIVER的消息，是SMPPSMProxy向SMSC發送的建立邏輯請求連接消息。（4）SMPPLoginRespMessage 請求連接應答消息，對應SMPP3.4文檔中的SMPP_BIND_RECEIVER_RESP的消息，是SMPPSMProxy向SMSC發送的建立邏輯請求連接后收到的響應消息。（5）SMPPDeliverMessage SMSC下發短信，對應SMPP3.4文檔中的 SMPP_DELIVER_SM消息，是SMSC下發給SMPPSMProxy的短消息或者狀態報告消息。（6）SMPPDeliverRespMessage 下發短信響應，對應SMPP3.4文檔中的 SMPP_DELIVER_SM_RESP消息，是SMPPSMProxy收到的下發短信后的響應消息。（7）SMPPSubmitMessage 發送短信消息，對應SMPP3.4文檔中的 SMPP_SUBMIT_SM消息，是SMPPSMProxy發送短訊的消息。（8）SMPPSubmitRespMessage 下發短信的響應，對應SMPP3.4 文檔中的 SMPP_SUBMIT_SM_RESP消息，是SMPPSMProxy發送短訊的響應消息。（9）SMPPUnbindMessage 終止連接消息，對應SMPP3.4 文檔中的 SMPP_UNBIND消息，是SMSC和SMPPSMProxy終止邏輯連接的消息。（10）SMPPUnbindRespMessage 終止連接的響應消息，對應SMPP3.4 文檔中的 SMPP_UNBIND_RESP消息，是SMSC或SMPPSMProxy收到終止連接后發送的響應消息。 其中的心跳消息（1，2）、建立邏輯連接的消息（3，4）和終止邏輯連接消息（9，10）只是SMPPSMProxy系統內部使用消息，提供給外部的接口中不涉及這六條消息。第三章 SMPPSMProxy使用說明1 SMPPSMProxy提供的接口方法描述1、send【函數功能】 向SMSC發送SMPP消息，阻塞直到收到響應或超時。【函數原型】SMPPMessage send(SMPPMessage message)；【參數說明】IN message - 發送的SMPP消息，包括 SMPPSubmitMessage提交短信【處理】調用這個接口方法，向SMSC發送Submit命令消息。 如果發送消息超時或通信異常則拋出異常，需要調用者捕獲處理。【返回值】發送SMPPSubmitMessage，返回SMPPSubmitRepMessage；2 close【函數功能】 向SMSC發送終止連接SMPP消息，調用之后連接將永久不可用。【函數原型】Void close()；【參數說明】 無【處理】調用這個接口方法，SMPPSMProxy向SMSC發送SMPPUnbindMessage消息 如果發送消息超時或通信異常則拋出異常，需要調用者捕獲處理。【返回值】 無3 getConnState【函數功能】 獲取通訊連接的狀態方法。【函數原型】String getConnState()；【參數說明】 無【處理】調用這個接口方法，獲取TCP連接狀態的描述。 如果發送消息超時或通信異常則拋出異常，需要調用者捕獲處理。【返回值】 當前錯誤描述，若連接正常則返回null。2 封裝接口方法的SMPPSMProxy的抽象類SMPPSMProxy在com.huawei.SMProxy的包中，封裝了Send、close、getConnState方法。SMPPSMProxy是一個抽象類，需要被繼承使用。SMPPSMProxy抽象類的框架如下：public class SMPPSMProxy public SMPPSMProxy(Args args) /完成初始化和向SMSC登錄等工作 public SMPPSMProxy(Map args) /完成初始化和向SMSC登錄等工作 /* * 發送消息，阻塞直到收到響應或超時。 * 返回為收到的消息 * exception PException 超時或通信異常。 */ public SMPPMessage send(SMPPMessage message) /發送消息 /* * 連接終止的處理，由API使用者實現 * SMC連接終止后，需要執行動作的接口 */ public void onTerminate() /* * 對收到消息的處理。由API使用者實現。缺省返回成功收到的響應 * param msg 從短消息中心來的消息。 * return 應該回的響應，由API使用者生成。 */ public SMPPMessage onDeliver(SMPPDeliverMessage msg) /* * 終止連接。調用之后連接將永久不可用。 */ public void close() /* * 提供給業務層調用的獲取連接狀態的方法 */ public String getConnState() /返回連接狀態的描述 3 使用SMPPSMProxy抽象類可以直接使用SMPPSMProxy類提供的Send、close和getConnState方法但是如果SP有接收SMSC下發的短信的要求或SMSC斷開連接的時候要求得到事件通知的時候，就必須聲明一個新的類繼承SMPPSMProxy，重載實現onDeliver( )和onTerminate( )。使用例子參見smppdemo實際使用SMPPSMProxy封裝的send、close和getConnState的接口方法的時候，只需要生成SMSender的對象，然后調用SMSender的send、close和getConnState方法即可。4 配置參數使用說明SMPPSMProxy需要的配置參數如下表參數名稱參數例值參數描述host47SMSC主機地址的IP地址port7890SMSC主機開發的端口號heartbeat-interval10心跳信息發送間隔時間(單位：秒)reconnect-interval10連接中斷時重連間隔時間(單位：秒)heartbeat-noresponseout5需要重連時，連續發出心跳而沒有接收到響應的個數（單位：個)transaction-timeout10操作超時時間(單位：秒)Debugtruetrue表示屬于調試狀態，所有的消息被打印輸出到屏幕，false表示不屬于調試狀態，所有的消息不被輸出system-idSPIdentifies the ESME system requesting to bind as a transmitter with the SMSC.passwordThe password may be used by the SMSC to authenticate the ESME requesting to bind.system-typeIdentifies the type of ESME system requesting to bind as a transmitter with the SMSC.addr-ton0Indicates Type of Number of theESME address.If not known set to NULLaddr-npi0Numbering Plan Indicator for ESMEaddress.If not known set to NULL.address-rangeThe ESME address.If not known set to NULL.Interface-version34Indicates the version of the SMPPprotocol supported by the ESME.配置文件可以采用我們提供的XML格式，也可以采用其他格式，只要構造的時候能通過Map類型或Arg類型的參數傳入指定的參數就可以了。例如可以用java的property文件保存參數，或將配置和SP的應用程序配置放在一起。下面是以XML格式定義的配置文件app.xml是在SMP