企业信息机API接口说明 (V1.01)
为了企业用户更加简便同时又灵活地实现与短信相关的业务,我们提供了一个企业业务系统接入华为公司短信平台的应用程序开发接口库。该接口库以JA V A方式提供给企业应用系统进行调用。通过调用该接口库的方法可以实现短信的单条发送、发、上行短信查询、返回短信系统信息位、根据系统信息位得到短信状态等功能。
使用该API时请注意以下几点:
1.把所需要的第三方驱动(如:mssqlserver.jar, log4j-1.2.9.jar等)放到工程根目录的lib 文件里边。
2.把,Log4j.properties放置到工程根目录下。
3.在根目录下创建一个log文件夹,在log里创建一个SMlog.log文件。
第1章结构及描述:
smentry.jar
:Java API
com.huawei.api
:包路径
com.huawei.api.SMErrorMapping;
:定义接口异常类型及参考信息
com.huawei.api.SMException;
影视资源站采集api接口数据:接口异常类
com.huawei.api.SMEntry;
:直接操作信息机接口
com.huawei.api.SMReceivedBean;
:上行短信对象类
com.huawei.api. SendShorBean;
:
下行短信对象类
com.huawei.api.SMTools;
:工具类
com.huawei.api.ConnectionMgr;
:连接DB类
在应用中,通过直接调用SMEntry类的方法实现api接口功能;通过捕获SMException异常得到出错信息;
第2章详细说明:2.1 SMErrorMapping 及SMException类;
捕获异常信息:
try{
}catch(SMException e){
}
异常列表:
2.2 SMEntry 类
2.2.1 接口初始化和释放
企业应用在调用接口内部函数时,应该首先初始化接口,在企业应用不再使用接口时,应该释放接口。以下两个函数分别实现初始化接口和释放接口的功能。
1. 初始化函数
public static void init(String dbName, String name, String pass) throws SMException 参数描述:
dbName:这是接口内部使用的企业信息机数据库的服务器名称。
name:这是接口登录的企业信息机数据库的账号用户名称。
pass:这是接口登录的企业信息机数据库的账号密码。
异常:
1001 , 1010 (参考异常列表)
说明:
当调用初始化函数时,实际仅做数据库连接;
示例:
public void test_init(String dbName,String name,String pass){
try{
SMEntry.init(dbName,name,pass);
}catch(SMException e){
}
}
2. 释放函数
public static void cleanUp() throws SMException
异常:
1010 (参考异常列表)
说明:
当调用此函数时,仅断开数据库连接;
示例:
public void test_ cleanUp (){
try{
SMEntry.cleanUp ();
}catch(SMException e){
}
}
2.2.2 短信发送
接口提供两个函数分别实现短信单发和短信发功能
1. 短信单发函数
public synchronized static int submitShortMessage(
String user,
String password,
java.util.Date atTime,
String sourceAddr,
String destAddr,
String content,
int needStateReport,
String serviceID, String feeType,
String feeCode) throws SMException
参数描述(参考异常列表各个参数具体说明):
user :用户名
password :密码
atTime:的时间。(Java.util.Date)
sourceAddr:待的源地址。
destAddr:待的目的地址。
content:短信内容。
needStateReport:发送该短信是否需要状态报告。(注:使用状态报告可以确认对方是否一定收到)。该参数可以使用两个值,0:表示不需要状态报告,1:表示需要状态报告。
serviceID:业务类型。业务类型将用于运营商端对短信进行计费时使用,该参数不能超过10个字符。
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论