? 返回值
返回结果 说明 List
public void testGetReport(){ try { Client sdkclient=new Client(\ List a=sdkclient.getReport(); StatusReport m=(StatusReport)a.iterator().next(); System.out.println(\状态报考数量:\ System.out.println(\状态报告状态:\ } catch (Exception e) { e.printStackTrace(); } }
? 演示结果
SDKServer:/192.168.1.67 connected ! method:THREADGROUP:收发服务线程启动 method:THREADGROUP:未发送超时监控启动 函数结果:0 状态报告数量:1 状态报告状态:0
3.19 修改密码 ? 功能介绍
修改序列号的密码
? 函数声明
public int serialPwdUpd(String serialPwd, String serialPwdNew)
? 参数详解
参数名称 说明 serialPwd 旧密码 serialPwdNew 新密码，6位，必须是数字字符串，必须输入
? 代码演示
public void testSerialPwdUpd(){ try { Client sdkclient=new Client(\ int a=sdkclient.serialPwdUpd(\
System.out.println(\短信发送结果:\
25/30 页
? 演示结果
}
} catch (Exception e) { e.printStackTrace(); }
SDKServer:/192.168.1.67 connected ! method:THREADGROUP:收发服务线程启动 method:THREADGROUP:未发送超时监控启动 短信发送结果:0
? 返回值
返回值 描述 0 密码修改成功 -1 新密码长度不能大于6 101 客户端网络故障 305 服务器端返回错误数据，返回的数据必须是数字 308 新密码不是数字，必须是数字 999 操作频繁
4
配置及环境要求
4.1
配置日志信息
客户端开发包默认采用log4j包作为日志工具.
? 用户没有采用Log4j工具情况下
用户在默认情况下无需手动配置,SDK客户端会自动运行日志工具,进行日志管理. 日志目录在项目目录下的sdklog文件夹下 如发现异常请参考常见问题 用户也可根据自己不同的环境进行修改或删除配置文件 默认包含日志配置文件sdkclient.jar/log4j.properties
? 用户自有Log4j工具情况
用户如已经对Log4j进行管理,可不用理睬客户端默认的log4j配置文件或将配置文件删除 目前sdk客户端采用默认的debug , info , warn , error 级别
4.2 查看日志
日志文件默认保存在项目下的sdklog文件夹内,
包含日志文件为sdkclient_debug.log, sdkclient_info.log,
sdkclient_warn.log, sdkclient_error.log 分别记录四个级别以上的日志信息
26/30 页
4.3 客户端配置
客户端为了满足不同环境的不同用户都能正常使用,采用的配置文件的方式. 配置文件在sdkclient.jar/client.properties下 以下将对配置文件进行详细说明
? 其他默认编码格式 CHARSETCODE
客户端自有配置,用户可不修改 默认(GBK)
? 到发送缓存前的编码格式 BYTECODE
SDK客户端进行短信发送前的数据编码格式,如客户发送乱码短信可由此进行修改 默认(GBK)
? 服务器默认地址 SERVERADDR
SDK服务器的ip地址,SDK客户端启动时将此IP作为SDK服务器地址 默认(sdk999.eucp.b2m.cn)
? 服务器默认端口 SERVERPORT
SDK服务器的连接端口.默认(80) ? 数据超时时间 ClearTimeoutDateTime
暂时没用
? 发送缓存大小 SENDBUFFER
SDK客户端的发送缓存和接收缓存的初始化大小,
客户可根据自己的硬件环境进行修改,默认(1048576) 单位 字节.
数值越大发送队列的承载性越强,能对网络质量不好时,会有更好的缓冲能力.
? 接收缓存大小RECEIVEBUFFER
默认初始化（1048576）单位字节
? 最大缓存 MAXBUFFERSIZE
默认(1048576) 单位 字节.
请将最大缓存调整和初始化缓存相同即可,目前未使用
? 最小缓存 MINBUFFERSIZE
暂时没用
? 等待发送队列时间 WAITBUFFERTIME
暂时没用
? 等待短信响应时间 WAITRESPONSETIME
客户端发送后等待响应超时时间设定.
默认(10000) 单位 毫秒
通常当网络质量出现问题时会涉及到此配置.请根据网络状况将超时时间调长.
? 短信收发频率 SENDRECEIVESPEED
SDK客户端采用java的nio包非阻塞网络通信机制,次为短信收发器的收发频率设定默认(10) 单位毫秒
每隔这段时间才查看是否有收发数据,短信收发量少可设定为100-1000 (毫秒) 为外界提供服务收发量大可设定为10-100 (毫秒)
? 超时断开连接时间 STOPHEARDTIME
当超过此时间没有短信发送时,SDK客户端会自动断开连接释放网络资源, 当重新发送短信时客户端会自动重新进行网络连接 默认(5) 单位分钟
? 短信发送超时情况下获取下行短信状态报告次数MTTIMES
27/30 页
默认为6次
? 设置下行短信发送频率(毫秒) MTFREQUENCY
默认是5000（毫秒）
? 收发线程测试连接次数（TESTCONECTTIMES）
默认5次
? 收发线程每次测试连接时间间隔(单位秒)
默认5秒
4.4 Java环境要求
需要JRE5.0以上 运行环境，如果需要支持低版本的jdk则需要与我们客服取得联系
5 开发建议
5.1 准备工作
合作伙伴必须通过亿美软通或是亿美软通代理商，取得SDK开发包和相关文档，取得供由本SDK使用的序列号及密码，这些参数将用于服务注册及短信发送。
5.2 网络测试
在调用SDK过程中出现网络故障错误时，可通过以下指令测试 是否可正常连接EUCP平台：telnet sdk999.eucp.b2m.cn 80
5.3 开发建议
? 获取开发包及 相关说明文档之后，可先看一下说明文档，之后运行开发包中的示例进行初步的
试用。
? 调用SDK各接口时，需参考SDK使用说明文档 对接口返回值做相应的处理。
5.4
项目检查
? 检查我们的项目中是否有日志配置文件log4j.properties，如果没有那么检查我们的
emaysdkclient.jar/log4j.properties的默认的日志文件，请根据自己的开发环境重新修改日志输入路径，如果有那么我们的默认配置文件可以不用关心
28/30 页