emppapi.html

上海移动通信企业短信通平台EMPP接口协议 empp api及例子

<DL>
<DD><B>Deprecated.</B>&nbsp;<I>不建议使用这个方法，这个方法可能在将来的版本中被废除</I>
<P>
<DD>建立与短信服务器的连接，不注册Listener，用户必须自己创建线程接收短信服务器回送的
 Response消息，状态报告，还有回复短信。还必须创建一个发送ActiveTest消息的线程以 保持与短信服务器的连接
<P>
<DD><DL>

<DT><B>Returns:</B><DD>服务器返回的连接响应消息
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/ValueNotSetException.html" title="class in com.wondertek.esmp.esms.empp.exception">ValueNotSetException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/MessageIncompleteException.html" title="class in com.wondertek.esmp.esms.empp.exception">MessageIncompleteException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/UnknownCommandIdException.html" title="class in com.wondertek.esmp.esms.empp.exception">UnknownCommandIdException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/InvalidEMPPObjectException.html" title="class in com.wondertek.esmp.esms.empp.exception">InvalidEMPPObjectException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/NotEnoughDataInByteBufferException.html" title="class in com.wondertek.esmp.esms.empp.exception">NotEnoughDataInByteBufferException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/HeaderIncompleteException.html" title="class in com.wondertek.esmp.esms.empp.exception">HeaderIncompleteException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/EMPPObjectException.html" title="class in com.wondertek.esmp.esms.empp.exception">EMPPObjectException</A></CODE>
<DD><CODE>java.io.IOException</CODE></DL>
</DD>
</DL>
<HR>

<A NAME="stopWorkThread()"><!-- --></A><H3>
stopWorkThread</H3>
<PRE>
public void <B>stopWorkThread</B>()</PRE>
<DL>
<DD>这个方法公开出来
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="terminateAsync()"><!-- --></A><H3>
terminateAsync</H3>
<PRE>
public void <B>terminateAsync</B>()
                    throws <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/ValueNotSetException.html" title="class in com.wondertek.esmp.esms.empp.exception">ValueNotSetException</A>,
                           <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/MessageIncompleteException.html" title="class in com.wondertek.esmp.esms.empp.exception">MessageIncompleteException</A>,
                           <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/UnknownCommandIdException.html" title="class in com.wondertek.esmp.esms.empp.exception">UnknownCommandIdException</A>,
                           <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/InvalidEMPPObjectException.html" title="class in com.wondertek.esmp.esms.empp.exception">InvalidEMPPObjectException</A>,
                           <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/NotEnoughDataInByteBufferException.html" title="class in com.wondertek.esmp.esms.empp.exception">NotEnoughDataInByteBufferException</A>,
                           <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/HeaderIncompleteException.html" title="class in com.wondertek.esmp.esms.empp.exception">HeaderIncompleteException</A>,
                           <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/EMPPObjectException.html" title="class in com.wondertek.esmp.esms.empp.exception">EMPPObjectException</A>,
                           java.io.IOException</PRE>
<DL>
<DD>向服务端发送连接终止消息，断掉与短信服务器的连接
<P>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/ValueNotSetException.html" title="class in com.wondertek.esmp.esms.empp.exception">ValueNotSetException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/MessageIncompleteException.html" title="class in com.wondertek.esmp.esms.empp.exception">MessageIncompleteException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/UnknownCommandIdException.html" title="class in com.wondertek.esmp.esms.empp.exception">UnknownCommandIdException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/InvalidEMPPObjectException.html" title="class in com.wondertek.esmp.esms.empp.exception">InvalidEMPPObjectException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/NotEnoughDataInByteBufferException.html" title="class in com.wondertek.esmp.esms.empp.exception">NotEnoughDataInByteBufferException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/HeaderIncompleteException.html" title="class in com.wondertek.esmp.esms.empp.exception">HeaderIncompleteException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/EMPPObjectException.html" title="class in com.wondertek.esmp.esms.empp.exception">EMPPObjectException</A></CODE>
<DD><CODE>java.io.IOException</CODE></DL>
</DD>
</DL>
<HR>

<A NAME="submitMsg(com.wondertek.esmp.esms.empp.EMPPSubmitSM)"><!-- --></A><H3>
submitMsg</H3>
<PRE>
public <A HREF="../../../../../com/wondertek/esmp/esms/empp/EMPPSubmitSMResp.html" title="class in com.wondertek.esmp.esms.empp">EMPPSubmitSMResp</A> <B>submitMsg</B>(<A HREF="../../../../../com/wondertek/esmp/esms/empp/EMPPSubmitSM.html" title="class in com.wondertek.esmp.esms.empp">EMPPSubmitSM</A>&nbsp;msg)
                           throws <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/ValueNotSetException.html" title="class in com.wondertek.esmp.esms.empp.exception">ValueNotSetException</A>,
                                  <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/MessageIncompleteException.html" title="class in com.wondertek.esmp.esms.empp.exception">MessageIncompleteException</A>,
                                  <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/UnknownCommandIdException.html" title="class in com.wondertek.esmp.esms.empp.exception">UnknownCommandIdException</A>,
                                  <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/InvalidEMPPObjectException.html" title="class in com.wondertek.esmp.esms.empp.exception">InvalidEMPPObjectException</A>,
                                  <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/NotEnoughDataInByteBufferException.html" title="class in com.wondertek.esmp.esms.empp.exception">NotEnoughDataInByteBufferException</A>,
                                  <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/HeaderIncompleteException.html" title="class in com.wondertek.esmp.esms.empp.exception">HeaderIncompleteException</A>,
                                  <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/EMPPObjectException.html" title="class in com.wondertek.esmp.esms.empp.exception">EMPPObjectException</A>,
                                  java.io.IOException</PRE>
<DL>
<DD>新增的方法：同步发送短信，阻塞在该函数获得EMPPSubmitSMResp
 如果用户注册了EMPPRecvListener，该listener也将收到同样的EMPPSubmitSMResp
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>msg</CODE> - 
<DT><B>Returns:</B><DD>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/ValueNotSetException.html" title="class in com.wondertek.esmp.esms.empp.exception">ValueNotSetException</A></CODE>
<DD><CODE>java.io.IOException</CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/EMPPObjectException.html" title="class in com.wondertek.esmp.esms.empp.exception">EMPPObjectException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/HeaderIncompleteException.html" title="class in com.wondertek.esmp.esms.empp.exception">HeaderIncompleteException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/NotEnoughDataInByteBufferException.html" title="class in com.wondertek.esmp.esms.empp.exception">NotEnoughDataInByteBufferException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/InvalidEMPPObjectException.html" title="class in com.wondertek.esmp.esms.empp.exception">InvalidEMPPObjectException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/UnknownCommandIdException.html" title="class in com.wondertek.esmp.esms.empp.exception">UnknownCommandIdException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/MessageIncompleteException.html" title="class in com.wondertek.esmp.esms.empp.exception">MessageIncompleteException</A></CODE></DL>
</DD>
</DL>
<HR>

<A NAME="submitMsg(java.lang.String, java.lang.String[], java.lang.String)"><!-- --></A><H3>
submitMsg</H3>
<PRE>
public <A HREF="../../../../../com/wondertek/esmp/esms/empp/EMPPSubmitSMResp.html" title="class in com.wondertek.esmp.esms.empp">EMPPSubmitSMResp</A>[] <B>submitMsg</B>(java.lang.String&nbsp;content,
                                    java.lang.String[]&nbsp;mobiles,
                                    java.lang.String&nbsp;serviceId)
                             throws <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/ValueNotSetException.html" title="class in com.wondertek.esmp.esms.empp.exception">ValueNotSetException</A>,
                                    <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/MessageIncompleteException.html" title="class in com.wondertek.esmp.esms.empp.exception">MessageIncompleteException</A>,
                                    <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/UnknownCommandIdException.html" title="class in com.wondertek.esmp.esms.empp.exception">UnknownCommandIdException</A>,
                                    <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/InvalidEMPPObjectException.html" title="class in com.wondertek.esmp.esms.empp.exception">InvalidEMPPObjectException</A>,
                                    <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/NotEnoughDataInByteBufferException.html" title="class in com.wondertek.esmp.esms.empp.exception">NotEnoughDataInByteBufferException</A>,
                                    <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/HeaderIncompleteException.html" title="class in com.wondertek.esmp.esms.empp.exception">HeaderIncompleteException</A>,
                                    <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/EMPPObjectException.html" title="class in com.wondertek.esmp.esms.empp.exception">EMPPObjectException</A>,
                                    java.io.IOException</PRE>
<DL>
<DD>新增的方法：同步发送短信，阻塞在该函数获得EMPPSubmitSMResp 支持长短信，返回的EMPPSubmitSMResp[]
 表示长短信拆分成多条短信发送后，返回的响应数组
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>content</CODE> - 短信内容<DD><CODE>mobiles</CODE> - 手机号数组<DD><CODE>serviceId</CODE> - 服务号，也就是企业号
<DT><B>Returns:</B><DD>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/ValueNotSetException.html" title="class in com.wondertek.esmp.esms.empp.exception">ValueNotSetException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/MessageIncompleteException.html" title="class in com.wondertek.esmp.esms.empp.exception">MessageIncompleteException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/UnknownCommandIdException.html" title="class in com.wondertek.esmp.esms.empp.exception">UnknownCommandIdException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/InvalidEMPPObjectException.html" title="class in com.wondertek.esmp.esms.empp.exception">InvalidEMPPObjectException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/NotEnoughDataInByteBufferException.html" title="class in com.wondertek.esmp.esms.empp.exception">NotEnoughDataInByteBufferException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/HeaderIncompleteException.html" title="class in com.wondertek.esmp.esms.empp.exception">HeaderIncompleteException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/EMPPObjectException.html" title="class in com.wondertek.esmp.esms.empp.exception">EMPPObjectException</A></CODE>
<DD><CODE>java.io.IOException</CODE></DL>
</DD>
</DL>
<HR>

<A NAME="submitMsg(java.lang.String, java.lang.String[], java.lang.String, java.lang.String)"><!-- --></A><H3>
submitMsg</H3>
<PRE>
public <A HREF="../../../../../com/wondertek/esmp/esms/empp/EMPPSubmitSMResp.html" title="class in com.wondertek.esmp.esms.empp">EMPPSubmitSMResp</A>[] <B>submitMsg</B>(java.lang.String&nbsp;content,
                                    java.lang.String[]&nbsp;mobiles,
                                    java.lang.String&nbsp;serviceId,
                                    java.lang.String&nbsp;srcTermId)
                             throws <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/ValueNotSetException.html" title="class in com.wondertek.esmp.esms.empp.exception">ValueNotSetException</A>,
                                    <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/MessageIncompleteException.html" title="class in com.wondertek.esmp.esms.empp.exception">MessageIncompleteException</A>,
                                    <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/UnknownCommandIdException.html" title="class in com.wondertek.esmp.esms.empp.exception">UnknownCommandIdException</A>,
                                    <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/InvalidEMPPObjectException.html" title="class in com.wondertek.esmp.esms.empp.exception">InvalidEMPPObjectException</A>,
                                    <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/NotEnoughDataInByteBufferException.html" title="class in com.wondertek.esmp.esms.empp.exception">NotEnoughDataInByteBufferException</A>,
                                    <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/HeaderIncompleteException.html" title="class in com.wondertek.esmp.esms.empp.exception">HeaderIncompleteException</A>,
                                    <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/EMPPObjectException.html" title="class in com.wondertek.esmp.esms.empp.exception">EMPPObjectException</A>,
                                    java.io.IOException</PRE>
<DL>
<DD>新增的方法：同步发送短信，阻塞在该函数获得EMPPSubmitSMResp 支持长短信，返回的EMPPSubmitSMResp[]
 表示长短信拆分成多条短信发送后，返回的响应数组
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>content</CODE> - 短信内容<DD><CODE>mobiles</CODE> - 手机号数组<DD><CODE>serviceId</CODE> - 服务号，也就是企业号<DD><CODE>srcTermId</CODE> - 源号码，显示在手机上的号码，必须是以serviceId开头，长度不超过18位.对普通企业srcTermId等于子帐号
<DT><B>Returns:</B><DD>
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/ValueNotSetException.html" title="class in com.wondertek.esmp.esms.empp.exception">ValueNotSetException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/MessageIncompleteException.html" title="class in com.wondertek.esmp.esms.empp.exception">MessageIncompleteException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/UnknownCommandIdException.html" title="class in com.wondertek.esmp.esms.empp.exception">UnknownCommandIdException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/InvalidEMPPObjectException.html" title="class in com.wondertek.esmp.esms.empp.exception">InvalidEMPPObjectException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/NotEnoughDataInByteBufferException.html" title="class in com.wondertek.esmp.esms.empp.exception">NotEnoughDataInByteBufferException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/HeaderIncompleteException.html" title="class in com.wondertek.esmp.esms.empp.exception">HeaderIncompleteException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/EMPPObjectException.html" title="class in com.wondertek.esmp.esms.empp.exception">EMPPObjectException</A></CODE>
<DD><CODE>java.io.IOException</CODE></DL>
</DD>
</DL>
<HR>

<A NAME="submitMsgAsync(com.wondertek.esmp.esms.empp.EMPPSubmitSM)"><!-- --></A><H3>
submitMsgAsync</H3>
<PRE>
public void <B>submitMsgAsync</B>(<A HREF="../../../../../com/wondertek/esmp/esms/empp/EMPPSubmitSM.html" title="class in com.wondertek.esmp.esms.empp">EMPPSubmitSM</A>&nbsp;msg)
                    throws <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/ValueNotSetException.html" title="class in com.wondertek.esmp.esms.empp.exception">ValueNotSetException</A>,
                           <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/MessageIncompleteException.html" title="class in com.wondertek.esmp.esms.empp.exception">MessageIncompleteException</A>,
                           <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/UnknownCommandIdException.html" title="class in com.wondertek.esmp.esms.empp.exception">UnknownCommandIdException</A>,
                           <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/InvalidEMPPObjectException.html" title="class in com.wondertek.esmp.esms.empp.exception">InvalidEMPPObjectException</A>,
                           <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/NotEnoughDataInByteBufferException.html" title="class in com.wondertek.esmp.esms.empp.exception">NotEnoughDataInByteBufferException</A>,
                           <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/HeaderIncompleteException.html" title="class in com.wondertek.esmp.esms.empp.exception">HeaderIncompleteException</A>,
                           <A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/EMPPObjectException.html" title="class in com.wondertek.esmp.esms.empp.exception">EMPPObjectException</A>,
                           java.io.IOException</PRE>
<DL>
<DD>异步发送短信，服务器端回复的EMPPSubmitResp消息，通过建立连接时注册的Listener获取
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>msg</CODE> - 短信
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/ValueNotSetException.html" title="class in com.wondertek.esmp.esms.empp.exception">ValueNotSetException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/MessageIncompleteException.html" title="class in com.wondertek.esmp.esms.empp.exception">MessageIncompleteException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/UnknownCommandIdException.html" title="class in com.wondertek.esmp.esms.empp.exception">UnknownCommandIdException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/InvalidEMPPObjectException.html" title="class in com.wondertek.esmp.esms.empp.exception">InvalidEMPPObjectException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/NotEnoughDataInByteBufferException.html" title="class in com.wondertek.esmp.esms.empp.exception">NotEnoughDataInByteBufferException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/HeaderIncompleteException.html" title="class in com.wondertek.esmp.esms.empp.exception">HeaderIncompleteException</A></CODE>
<DD><CODE><A HREF="../../../../../com/wondertek/esmp/esms/empp/exception/EMPPObjectException.html" title="class in com.wondertek.esmp.esms.empp.exception">EMPPObjectException</A></CODE>
<DD><CODE>java.io.IOException</CODE></DL>
</DD>
</DL>
<HR>

<A NAME="submitMsgAsync(java.lang.String, java.lang.String[], java.lang.String)"><!-- --></A><H3>
submitMsgAsync</H3>
<PRE>