hiAir SMS JSP元件使用說明

• class放置路徑：以tomcat的首頁預設路徑為例：sms2.class需放在/tomcat安裝路徑/webapps/ROOT/WEB-INF/classes/hiairv2/ 的目錄下

• 元件函式說明：
  

  函式名稱	說明
  create_conn(ServerIP,ServerPort,UserID,Passwd)	建立SMS伺服器連線
  send_text_message(MobileNum,Message)	傳送文字簡訊
  send_text_message(MobileNum,Message,Order_Time)	預約傳送文字簡訊
  query_message(Type,MessageID)	查詢簡訊傳送結果
  recv_text_message( )	接收手機回傳簡訊
  cancel_text_message(MessageID)	取消預約文字簡訊
  ret_message( )	取得系統回傳的描述
  get_msisdn( )	取得手機回覆者的手機號碼
  close_conn( )	結束SMS伺服器連線

  函式參數說明：
  

  參數名稱	參數型態	內容	說明
  ServerIP	字串(string)	SMS伺服器IP	202.39.54.130
  ServerPort	字串(string)	SMS伺服器Port	8000
  UserID	字串(string)	登入帳號	最長8個字元
  Passwd	字串(string)	登入密碼	最長16個字元
  MobileNum	字串(string)	手機號碼	國內固定為10個字元，國外20以內
  Message	字串(string)	簡訊內容	最長為159個字元
  Order_Time	字串(string)	預約傳送的時間	格式:YYMMDDHHMM00(12字元)
  Type	數值(int)	查詢訊息的種類	2:text ,6:logo, 8:ringtone, 14:wappush
  MessageID	字串(string)	系統回傳的訊息ID	簡訊傳送時，系統回傳的訊息ID

  註1：YYMMDDHHMM00->年月日時分秒，秒必須為00。
            Ex : 021210110200 表示西元2002年12月10日11點02分
  
  函式回傳值說明：

  1.	create_conn(ServerIP,ServerPort,UserID,Passwd)：回傳值型態為int
  	回傳值 內容 0  帳號/密碼檢查成功 1  密碼錯誤 2  帳號不存在 3  超過准許最大連線數 4  帳號狀態不正確或以退租 71  Socket 連線失敗或傳送錯誤 其他值  請參考hiAirV2軟體規格書
  2.	send_text_message(MobileNum,Message)：回傳值型態為int
  	回傳值 內容 0  訊息傳送成功 2  編碼格式錯誤 6  手機號碼格式 8  重送截止時間格式錯誤 9  預約傳送時間格式錯誤 11  系統暫時無法傳送訊息 71  Socket 連線失敗或傳送錯誤 其他值  請參考hiAirV2軟體規格書 註1：當回傳值=0，傳送成功，此時請用get_message()取得系統回覆的           MessageID，以供查詢簡訊傳送結果用。
  3.	query_message(Type,MessageID)：回傳值型態為int
  	回傳值 內容 0  訊息已送達對方 1  手機未開或在受訊範圍外 2  查詢系統無此MessageID資料 3  MessageID格式錯誤 4  已送到簡訊中心，尚未完成查詢 5  預約時間超過48小時 8  手機號碼或簡訊內容格式錯誤 10  簡訊已被移除或超過重送時間 17  訊息無法送達對方 19  訊息已送至簡訊中心 20  預約簡訊，等待傳送中 21  預約簡訊，已取消傳送 22  簡訊內容不合規定(疑似詐財簡訊) 71  Socket 連線失敗或傳送錯誤 其他值  請參考hiAirV2軟體規格書 註：請用get_message( )取得查詢結果的說明內容。
  4.	recv_text_message( ): 回傳值型態為int
  	回傳值 內容 0  有手機回傳簡訊 1  系統無手機回傳的簡訊 2  系統錯誤，請重試 3  MessageID格式錯誤 71   Socket 連線失敗或傳送錯誤 註：當回傳值=0，表示系統有手機回傳的簡訊，此時請用get_message( )取得         手機回覆的內容，用get_msisdn( )取得回傳者的手機號碼。
  4.	cancel_text_message(MessageID): 回傳值型態為int
  	回傳值 內容 0  取消成功 1  目前非預約狀態，可能之前已取消或已發送成功。 2  查詢系統無此MessageID資料 3  Socket 連線失敗或傳送錯誤 71  Socket 連線失敗或傳送錯誤 註：請用get_message( )取得結果的說明內容。
  5.	get_message( )：回傳值型態為string
  	取得系統回傳的訊息。 註：當send_text_message( )成功傳送訊息到Server，系統會回傳MessageID，需用         get_message( )取得MessageID
  6.	get_msisdn( )：回傳值型態為string
  	回傳值為手機號碼 註：當執行recv_text_message( )取得手機回傳的簡訊時，需用get_msisdn( )取得回傳         者的手機號碼。
  7.	close_conn()：無回傳值

  　

• 其他相關說明：
  
  1. create_conn( )成功建立連線後，才可使用send_text_message( )、query_message( )和
      recv_text_message( )，傳送結束後，請記得使用close_conn( )結束連線。
  
  2. send_text_message( )將簡訊傳送到簡訊伺服器，如果成功(回傳值=0)，則系統會回傳
      一個MessageID，請用get_message( )取得此MessageID，之後可以根據此MessageID，
      使用query_message( )查詢簡訊是否有成功傳送至GSM手機或呼叫器中。如果傳送不
      成功(回傳值!=0)，可以用get_message( )取得系統回覆的訊息。
  
  3. 執行RecvMsg接收回傳的簡訊，如果成功(回傳值=0)，請用Get_Ret_Content取得回傳
      的簡訊內容，用Get_Send_MSISDN取得回傳者的手機號碼。
  
  4. 如欲一次傳送多筆簡訊，請於create_conn( )成功建立連結後，多次執行send_text_
      message( )即可。
  
  5. 簡訊伺服器，同一帳號最多可建立五個Connection。