Etot API 使用說明
	                ======

	            Java版 Etot API 1.0 release
	            ----------------------------

安裝
------------
	1:將安裝盤中的etot_api目錄拷貝到任意路徑.
	2:修改環境變量CLASSPATH，確認包含etot_api目錄所在的完整路徑.
	  例如:
	  CLASSPATH=E:\package\twinbays\etot_api;d:\oracle\ora81\orb\classes\share.zip
	3:編輯etot_api/conf/xboxp.ini,填寫實際的配置.
	4:安裝過程結束.
	5:您可以編輯etot_api\com\twinbays\etot\t\XboxAPIT.java,存盤編譯后,執行
	  java com.twinbays.etot.t.XboxAPIT send 命令,測試一下安裝是否正確。
	6:請注意
		1)不要修改etot_api目錄及下級子目錄的目錄名、文件名和目錄結構.
		2)一些jsp環境，如tomcat，在第一次使用Etot API前可能需要重新啟動.
	
使用
------------
	說明
	  1:Receive類
	    Deliver類和Result類的基類,用于接收操作.

	    源代碼
	      package com.twinbays.etot ;
	      public class Receive
	      {
	          /*
	          成員變量m_bType的值用于標明是服務請求或發送結果.
	          0x32  標明為服務請求Deliver
	          0x31  標明為發送結果Result
	          */
	          public byte m_bType ;
	      } 

	  2:Deliver類
	    Receive類的子類,用于接收操作,封裝一條服務請求的數據.

	    源代碼
	      package com.twinbays.etot ;

	      public class Deliver extends Receive
	      {
	            /*
	            主叫號碼
	            */
	            public String m_strSrcNo ;

	            /*
	            GSM協議類型，用于非Nokia手機下載鈴聲和圖片，詳細解釋請參考GSM03.40中的9.2.3.9
	            */
	            public byte m_bTpUid ;

	            /*
	            GSM協議類型，用于非Nokia手機下載鈴聲和圖片，詳細解釋請參考GSM03.40中的9.2.3.23
	            */
	            public byte m_bTpUdhi ;

	            /*
	            服務請求的編碼，0為ASCII，4為Binary，15為GBK
	            */
	            public byte m_bEncoded ;

	            /*
	            服務請求內容的長度
	            */
	            public int m_nMsgLength ;

	            /*
	            服務請求的內容,用戶可自行轉換為字符串或2進制對象
	            */
	            public byte[] m_abMsg ;
	      }

	  3:result
	    Receive類的子類,用于接收操作,封裝一條發送結果的數據.

	    源代碼
	      package com.twinbays.etot ;

	      public class Result extends Receive
	      {
	            /*
	            對應SendSMS調用的返回值,或SendBatchSMS調用返回的數組元素
	            */
	            public int m_nOid ;

	            /*
	            本次發送結果對應發送請求的已發送次數
	            */
	            public int m_nCurrTimes ;

	            /*
	            本次發送時間，格式為YYYYMMDDhhmmss
	            */
	            public String m_strSendTime ;

	            /*
	            發送方式,如"S"
	            */
	            public String m_strSendMode ;

	            /*
	            被叫號碼
	            */
	            public String m_strDestNo ;

	            /*
	            發送結果狀態，'S'為成功，'F'為失敗
	            */
	            public String m_strState ;

	            /*
	            付費號碼
	            */
	            public String m_strChargeNo ;
	      }

	  4:XboxAPI
	    入口類,提供方法用于發送一條短信到一個或多個被叫號碼,或接收一條或多條Deliver和Result。

	    方法sendSMS,用于發送一條短信到一個被叫號碼
	    public int sendSMS(	String __strDestNo, String __strSvcType, int __nLength, 
	                        String __strContent, byte __nTpUid, byte __nTpUdhi, String __strScheduleTime, 
	                        short __nExpireTime, short __nTimes, short __nInterval, String __strChargeNo ) 
	                        throws ApiInitException
	    入口參數:
	      __strDestNo        被叫手機號碼，字符串，最長21字節
	      __strSvcType       服務類型，字符串，最長10字節
	      __nLength          發送內容的長度(字節數)，應等于__abContent.length
	      __abContent        發送的內容，字節數組。
	      __nTpUid           通常為0，僅用于向非Nokia手機發送鈴聲和圖片
	      __nTpUdhi          通常為0，僅用于向非Nokia手機發送鈴聲和圖片
	      __strScheduleTime  發送時間，字符串，長度為14，格式為YYYYMMDDhhmmss，null表示立即發送
	      __nExpireTime      有效時間（分鐘），0為使用短信中心缺省值；
	      __nTimes           發送次數，0無效
	      __nInterval        每次發送的間隔時間（分鐘），0無效
	      __strChargeNo      付費手機號碼，字符串，最長21字節；如為null或空串（""）表示由被叫付費；如為"0"表示由SP付費。
	    返回值
	      整型,表示該條短消息的OID，0表示失敗。

	    方法sendBatchSMS,用于發送一條短信到多個被叫號碼
	    public int sendBatchSMS(	String __strDestNo, String __strSvcType, int __nLength, 
					String __strContent, String __strScheduleTime, 
					short __nExpireTime, short __nTimes, short __nInterval, String __strChargeNo ) 
					throws ApiInitException
	    入口參數:
	      __strDestNo        被叫手機號碼，字符串，如有多個號碼用逗號隔開
	      __strSvcType       服務類型，字符串，最長10字節
	      __nLength          發送內容的長度(字節數)，應等于__abContent.length
	      __abContent        發送的內容，字節數組。
	      __strScheduleTime  發送時間，字符串，長度為14，格式為YYYYMMDDhhmmss，null表示立即發送
	      __nExpireTime      有效時間（分鐘），0為使用短信中心缺省值；
	      __nTimes           發送次數，0無效
	      __nInterval        每次發送的間隔時間（分鐘），0無效
	      __strChargeNo      付費手機號碼，字符串，最長21字節；如為null或空串（""）表示由被叫付費；如為"0"表示由SP付費。
	    返回值
	      整型數組,元素對應于每條短消息的OID.

	    方法RecvMsg,用于接收一條或多條Deliver和Result
	    public Receive[] recvMsg( byte __nMaxRecv ) throws ApiInitException
	    入口參數:
	      __nMaxRecv        最多接收Deliver和Result的條數,byte類型
	    返回值
	      Receive數組,包含Deliver和Result信息

	  5.ApiInitException類
	    異常,包含錯誤信息.可以調用toString()方法打印出錯信息.

	例子
	  參見etot_api\com\twinbays\etot\t\XboxAPIT.java