金笛JAVA短信服务器 v3.2 发布

[s0z0y]

一、 产品简介

金笛短信服务器是一款基于短信猫、猫池的JAVA短信平台软件。可以部署在Win、Linux等环境下，为企业事业单位提供六种短信调用接口。用户不需要编码，就可以实现业务系统和短信收发功能的嫁接。

金笛短信服务器v3.2 在v3.1基础上，做了大量改进。在保证稳定的基础上，比旧版本容易安装部署，容易扩展功能。通过创新的通道（Gateway）概念和技术，支持多种短信发送设备混合发送；通过接口（Interface）概念和技术，支持多种短信数据存储、交换格式。
金笛短信服务器的目标，就是为组织机构提供一个方便易用的高可靠的短信平台，实现OA办公提醒、邮件到达通知、CRM客户关怀、关键事务监控、网站短信服务、机房软硬件报警等。

通道（Gateway）目前支持：Wavecom全系列GSM/GPRS/CDMA Modem、西门子全系列、Maestro全系列、金笛工业手机、金笛短信猫池全系列硬件产品。
通过通道（Gateway）测试的硬件设备型号有：
Wavecom：M1206B, M1306B, WMOD2 Wismo, Fastrack Supreme 20, WISMO CDMA。.
Maestro： M100，M100Lite。
金笛工业手机：Q24PL、Q2403A、Q2406A、Q2303a系列、金笛8口串口猫池、金笛8口网口猫池。
支持的接口主要有：
 数据库接口：采用数据库存储收到的短信和待发送的短信。金笛短信服务器按照设定的时间间隔扫描数据库，实现自动发送并修改发送状态。发送失败还可以重发。目前支持MySQL、SQL Server、Oracle三种数据库。
 XML接口：收到的短信自动存为XML格式文件；需要发送的短信按照XML格式存储到指定目录，就可以自动发送出去。
 EMAIL接口：指定2个邮箱，一个用来接收短信，一个用来发送短信。发个EMAIL就可以发送短信。
 JMX接口：通过RMI方式实现远程控制短信收发队列（对象）。
 HTTP接口：收到短信或者发出短信后，可以按照指定参数调用URL。
 HTTP Server接口：内嵌HTTP Server，用户可通过URL参数传递实现短信发送。

金笛短信服务器还支持多达500个汉字的长短信，支持自动负载均衡、支持自定义短信路由，支持同步、异步发送，支持闪信、wappush、状态报告等功能。还有，金笛邮件服务器完全采用JAVA实现，可以跨平台运行，具有很好的兼容性。总之，更多激动人心的功能还需您在使用过程中一一发掘。

二、 应用领域
金笛短信服务器通过提供六种常用的接口方式（DB、HttpClient、HttpServer、XML、Email、JMX），为您的应用系统在最低耦合的前提下，提供分布式短信服务功能。最低耦合有这样的好处：
1、 快速部署。5分钟皆可将短信服务器部署好。
2、 减少开发的工作量，提高效率，提高系统的健壮性、可靠性。
3、 部署时只关心业务层面，不用考虑具体硬件及通信细节。
4、 便于以后升级和扩展。便于多应用系统共享短信服务。

三、 运行环境
WindowsXP、2000、2003、2008、linux
注意！windows和linux 环境变量、路径略有不同，请根据不同操作系统选用对应的安装包。
四、 试用版和正式版区别
正式版和试用版的区别在于试用版发出的短信有广告，正式版没有。

五、 Windows下安装步骤
安装包整合了JDK1.6和MySQL5.1.37，解压缩就可以运行。
将jdsmsserver.rar 解压到C:\

cd  c:\jdsmsserver\mysql-5.1.37-win32\bin
msyqld  –defaults-file=..\my.ini
cd  c:\jdsmsserver\bin
start_jdsms.bat

如果想把安装包放在其它目录下，请修改start_jdsms.bat中JDSMS_HOME对应路径。

六、 Linux下安装步骤
1／先安装MySQL , 创建smsserver数据库，运行初始化脚本。
#mysql -u root -p111111 smsserver < /path/to/MySQL.sql
注意！
mysql默认字符集选择GB2312
如果默认不是gb2312,请修改my.cnf , 在［mysql]下面添加一行
default-character-set=gb2312
重新启动mysql,重新运行smsserver初始化脚本.

2／运行JDSMSServer启动脚本

#cd /jdsmsserver/bin
#./start_jdsms.sh

3／examples目录下有几个收发及测试端口程序，如果步骤2有错误，
可以运行测试程序锁定故障原因。

七、 功能测试
1、 数据库接口收发测试：
<code>Cd c:\jdsmsserver\mysql-5.1.37-win\bin
mysql –u root
mysql> insert into smsserver_out (type,recipient,text,encoding,create_date) values ('O','13601019694','jdsmsserver数据库发送成功','U',now());
</code>
手机号码改为你自己的，等10秒左右，如果收到短信，说明数据库接口收发设置成功。
2、 URL收发测试：
打开IE浏览器，输入：
http://localhost:8080/send?password=...B5%8B%E8%AF%95
等10秒左右，如果能收到短信，说明HttpServer接口收发设置成功。
3、 Email收发测试：
向sendsms@mailer.com.cn 发一封邮件，主题为收件人手机号码，正文为短信内容，等30秒左右，如果可以收到，说明Email接口设置成功。通过SMSServer.conf可以修改为其它Email地址。

八、 功能详解
数据库表结构字段说明：smsserver_in 。收到短信后，自动转存到这里。
字段名 类型 属性 描述

id INT 自动 primary key.
process INT NOT NULL 预留备用
originator CHAR(16) NOT NULL 发件人
type CHAR(1) NOT NULL 短信类型："I"普通短信, "S"短信状态报告
encoding CHAR(1) NOT NULL 编码格式："7" for 7bit, "8" for 8bit and "U" for Unicode/UCS2.
message_date DATETIME NOT NULL 短信发送日期时间
receive_date DATETIME NOT NULL 接收日期时间
text CHAR(xxx) NOT NULL 正文
original_ref_no CHAR(64) NULL 用于短信状态报告: 此号码对应于外发的短信序号.
original_receive_date DATETIME NULL 用于短信状态报告: 对方收到短信的日期时间
gateway_id CHAR(64) NOT NULL 通道标识，用于标识是哪个通道收到的短信.


Smsserver_out 用于存放外发的短信：


字段 类型 属性 描述
id INT 自动 primary key.
type CHAR(1) NOT NULL 短信类型. "O"普通短信, "W" wappush.
recipient CHAR(16) NOT NULL 收件人手机号码，前面不要加 "+" 或者0
text CHAR(xxx) NOT NULL 短信正文
wap_url CHAR(xxx) NOT NULL for WAP SI messages! Wap短信URL地址.
wap_expiry_date DATETIME NULL Wap短信有效期，默认7天。
wap_signal CHAR(1) NULL "N" NONE, "L" LOW, "M" MEDIUM, "H" HIGH, "D" DELETE.
create_date DATETIME NOT NULL, Default value: current date/time 记录插入数据库的时间.
originator CHAR(16) NOT NULL, Default value: '' 发件人.正常情况下为空.
encoding CHAR(1) NOT NULL, Default value: '7' 编码格式："7" 7bit, "8" 8bit and "U" Unicode/UCS2.发送中文短信请设为U。
status_report INT NOT NULL, Default value: 0 状态报告：设为 1需要短信状态报告，默认为0.
flash_sms INT NOT NULL, Default value: 0 闪信，设为1 发送闪信，默认为0.
src_port INT NOT NULL, Default value: -1 源端口 (对彩铃有效)
dst_port INT NOT NULL, Default value: -1 目的端口 (对彩铃有效)
sent_date DATETIME NULL 发送时间. Jdsmsserver发送时会更新这个时间。
ref_no CHAR(64) NULL 短信对应ID
priority INT NOT NULL, Default value: 0 优先级：
低：负数
普通：0
高：正数
status CHAR(1) NOT NULL, Default value "U" 短信状态："U" :未发送, "Q" : 排队中, "S" : 已发送, "F" : 失败.
errors INT NOT NULL, Default value: 0 重发次数.
gateway_id CHAR(64) NOT NULL, Default value is the star character 短信通道标识，可指定发送通道。为空由短信服务器自动选择。


Smsserver_calls 主要记录呼入的语音呼叫
字段名 类型 属性 描述

id INT 自动 primary key.
call_date DATETIME NOT NULL 电话呼入时间.
gateway_id CHAR(64) NOT NULL 通道标识.
caller_id CHAR(16) NOT NULL 对方号码.



九、 常见问题

 如何将mysql加入系统service？
C:\jdsmsserver\mysql-5.1.37-win32\bin>mysqld --install mysqld --defaults-file=..\my.ini

 如何开机自动启动jdsmsserver？
将start_jdsms.bat 创建一个快捷方式，放在「开始」菜单\程序\启动 目录下。