java实现自动发送短信功能
功能简介
SDK客户端的构造方式,实例化客户端Client类后即可通过该实例调用短信发送等函数.
构造函数
public Client(String serialNumber, String key) throws Exception
| 参数名称 |
说明 |
| serialNumber |
客户端序列号，必须输入 |
| key |
要注册的关键字，必须输入 1． 用户自定义key值，长度不超过15个字符的字符串(可包含数字和字母) 2． 将key做好备份，不要遗忘 3． 请做好保密工作，因客户自身原因泄露该关键字造成的经济损失北京辉煌软通科技有限公司不承担任何责任 |
import cn.emay.sdk.client.api.Client;
Client c = new Client("3SDK-EMS-0130-AAAAA","123456");
1.2 注册序列号 功能介绍
完成对序列号的注册。
l 序列号说明
(1) 软件序列号首次使用必须注册，就像信用卡首次使用必须激活一样。
(2) 软件序列号只需注册成功一次即可，注册成功后，即使重启电脑，都不需再次注册序列号。
(3) 序列号注册成功后，需记住密码并妥善保管。
(4) 试用SDK接口时，辉煌提供测试序列号，并提供适当测试余额。
(5) 正式应用SDK接口时，辉煌提供正式序列号，在应用时，只需重新注册一次序列号即可，其它接口不变。
函数声明
public int registEx(String serialpass)
| 参数名称 |
说明 |
| serialpass |
软件序列号密码，密码（6位），必须输入 |
代码演示
import cn.emay.sdk.client.api.Client;
/**
* 测试函数
*/
public void testTegistEx(){
try {
Client sdkclient=new Client("3SDK-EMS-0130-AAAAA","123456");
int i=sdkclient.registEx("123456");
System.out.println("函数结果:"+i);
} catch (Exception e) {
e.printStackTrace();
}
}
演示结果
SDKServer:/192.168.1.67 connected !
method:THREADGROUP:收发服务线程启动
method:THREADGROUP:未发送超时监控启动
函数结果:0
l 返回值
| 返回值 |
描述 |
| 0 |
注册成功 |
| 10 |
客户端注册失败 |
| 101 |
客户端网络故障 |
| 305 |
服务器端返回错误，错误的返回值（返回值不是数字字符串） |
| 999 |
操作频繁 |
1.3 注册企业信息
l 功能介绍
用户序列号激活以后便可以通过该接口注册自己企业的详细信息，如果要修企业的某个信息，那么可重新调用该接口
l 函数声明
public int registDetailInfo(String name, String linkMan, String phoneNum, String mobile,String email, String fax, String address, String postcode)
l 参数详解
| 参数名称 |
说明 |
| eName |
企业名称(最多60字节)，必须输入 |
| linkMan |
联系人姓名(最多20字节)，必须输入 |
| phoneNum |
联系电话(最多20字节)，必须输入 |
| mobile |
联系手机(最多15字节)，必须输入 |
| |
电子邮件(最多60字节)，必须输入 |
| fax |
联系传真(最多20字节)，必须输入 |
| address |
公司地址(最多60字节)，必须输入 |
| postcode |
邮政编码(最多6字节)，必须输入 |
l 代码演示
public void testRegistDetailInfo(){
try {
Client sdkclient=new Client("3SDK-EMS-0130-AAAAA","123456");
int a=sdkclient.registDetailInfo("企业名称", "联系人", "固话", "手机", "邮件", "传真", "企业地址", "邮政编码");
System.out.println("短信发送结果:"+a);
} catch (Exception e) {
e.printStackTrace();
}
}
l 演示结果
SDKServer:/192.168.1.67 connected !
method:THREADGROUP:收发服务线程启动
method:THREADGROUP:未发送超时监控启动
短信发送结果:0
l 返回值
| 返回值 |
描述 |
| 0 |
注册企业信息成功 |
| -1 |
注册企业信息不符合要求 |
| 11 |
企业信息注册失败 |
| 101 |
客户端网络故障 |
| 305 |
服务器端返回错误，错误的返回值（返回值不是数字字符串） |
| 307 |
目标电话号码不符合规则，电话号码必须是以0、1开头 |
| 999 |
操作频繁 |
1.4 注销序列号
l 功能介绍
用户注销以后就不能再识别发送短信，接受上行短信等接口，只有重新注册以后才能重新使用
l 函数声明
public int logout()
l 参数详解
无
l 代码演示
public void testLogout(){
try {
Client sdkclient=new Client("3SDK-EMS-0130-AAAAA","123456");
int a=sdkclient.logout();
System.out.println("短信注销结果:"+a);
} catch (Exception e) {
e.printStackTrace();
}
}
l 演示结果
SDKServer:/192.168.1.67 connected !
method:THREADGROUP:收发服务线程启动
method:THREADGROUP:未发送超时监控启动
短信注销结果:0
l 返回值
| 返回值 |
描述 |
| 0 |
注销成功 |
| 22 |
注销失败 |
| 101 |
客户端网络故障 |
| 305 |
服务器端返回错误，错误的返回值（返回值不是数字字符串） |
| 999 |
操作频繁 |
1.5 查询单价
l 功能介绍
返回一条短信的费用
l 函数声明
public double getEachFee()
l 参数详解
无
l 代码演示
public void testGetEachFee(){
try {
Client sdkclient=new Client("3SDK-EMS-0130-AAAAA","123456");
double a=sdkclient.getEachFee();
System.out.println("短信发送结果:"+a);
} catch (Exception e) {
e.printStackTrace();
}
}
l 演示结果
SDKServer:/192.168.1.67 connected !
method:THREADGROUP:收发服务线程启动
method:THREADGROUP:未发送超时监控启动
短信发送结果:0.1
l 返回值
| 返回值 |
描述 |
| 27 |
查询单条短信费用错误码 |
| 101 |
客户端网络故障 |
| 305 |
服务器返回错误数据，不能转换成数字 |
| 999 |
操作频繁 |
1.6 查询余额
l 功能介绍
获得序列号的剩余金额
l 函数声明
public double getBalance()throws Exception
l 参数详解
无
l 代码演示
public void testGetBalance(){
try {
Client sdkclient=new Client("3SDK-EMS-0130-AAAAA","123456");
double a=sdkclient.getBalance();
System.out.println("短信发送结果:"+a);
} catch (Exception e) {
e.printStackTrace();
}
}
l 演示结果
SDKServer:/192.168.1.67 connected !
method:THREADGROUP:收发服务线程启动