如意王JAVA用手册.docVIP

如意王 JAVA接口 用户使用说明书 文档修改记录 日期 作者 版本 文档修改记录 2009-1-13 黄元林 SJ4.0.0 在登录时提交给服务端时增加了产品版本号参数。 2009-5-31 吴和智 SJ4.0.0 整理了JAVA例程的函数 2010-12-10 牛梅花 SJ4.1.0 把已失效的方法去掉 目 录 1 产品简介 1 1.1 概述 1 1.2 版本说明 1 1.3 JAVA接口介绍 2 1.4 常量定义 2 1.5 使用对象 2 2 接口使用说明 2 2.1 JavaAPI接口 3 2.2 类接口说明 3 2.2.1 用户登陆 3 2.2.2 费用查询 4 2.2.3 修改密码 5 2.2.4 发送短信 5 2.2.5 登出系统 6 2.3 系统内部调用接口 6 2.3.1 应答信息包 6 2.3.2 上行信息包 6 2.3.3 状态报告包 7 2.3.4 信息队列 7 2.4 TCP/IP Scoket接口 8 2.5 Java例程 8 2.5.1 登录 8 2.5.2 费用查询 9 2.5.3 修改密码 9 2.5.4 短信单发 9 2.5.5 群发 10 2.5.6 解析队列信息 10 2.5.7 系统登出 11 3 常见问题 12 产品简介 概述 如意王系列产品是我公司提供给客户进行二次开发的接口协议和接口程序。它们是我产品系列中的重要一员，是我产品多元化的体现。通过如意王，企业可以将与自身的ERP/CRM/MIS系统结合，提高信息处理的实时性，HTTP协议短信由短信网关的协议接口和业务支撑系统的协议接口构成是从最底层与我短信息运营服务平台的接入方式，开发难度最高，适合我的渠道客户（软件公司）和一些较大规模且计算机技术实力较强的公司使用。TCP/N协议短信TCP/Y协议短信ActiveX接口短信基于二种协议在不同操作系统平台和数据库平台中以不同开发工具开发的封装成不同形式的接口产品，这些产品均是以接口包形式封装的，每个产品由于用户对短信息功能要求的不同，分为很多个接口，它们分别跟服务器后台的组织结构与联系人管理系统、智能网关系统、营运支撑系统等各系统相连，从而完成相关系统的功能。DLL接口HTTP短信DLL接口TCP/N短信DLL接口TCP/Y短信JAVA接口N短信JAVA接口Y短信JAVA接口必威体育精装版版V1.00x14/0x94 短信网关将收到的Report信息发送给ISP系统 fee 0x08/0x88 ISP系统向短信网关查询话费记录清单 agent_list 0x09/0x89 ISP系统向Server查询当前可用的Agent modify_pwd 0x10/0x90 修改密码 Sendcluster 0x11/0x91 群发短信 使用对象 本文档的主要读者是我公司短信上下行的客户公司的开发主管、开发人员。 接口使用说明 短信接口包括：JavaAPI接口，提供短信发送（单发/群发）、查询状态报告、余额费用、修改密码、登陆、登出、链路检测、通道查询。下面详细说明接口的使用方法。 JavaAPI接口 登录 退出 短信单发 短信群发 费用查询 修改密码 状态报告接收、上行和应答等 类接口说明 GSTEngineFactory为单例工厂类，与用户交互的接口全部封装在该工厂类中，该类含有以下接口的封装： 登录网关、退出网关、单发短信、群发短信、定时发送、取消定时发送、上行接收、状态报告接收、费用查询、链路检测、通道查询和修改密码等接口。 用户登陆 方式一 方法：public static GSTEngineFactory getInstance String userID, String pass 参数： userID 登陆ID Pass 登陆密码 方法：public int loginEngin 参数： 无 说明：调用带userID，pass参数的构造方法getInstance String userID, String pass ,实例化GSTEngineFactory类,然后调用GSTEngineFactory实例中的loginEngin 方法，通过读取配置文件中的ServerIP与Port连接到网关,连接成功后，进行户名与密码的校验。登录成功后，发送链路检测，并开启链路维护线程。 返回:：登陆成功返回0，失败返回-1 方式二 方法：public static GSTEngineFactory getInstance 参数： 无 方法：public int loginEngin 参数： 无 说明：调用没有参数的getInstance 构造方法,实例化GSTEngineFactory类系统会自动读取配置文件sms_perties中定义的：userID