为邮件系统加上短信功能

[admin]

如果您的邮件系统不支持短信提醒、邮件服务短信监控，金笛提供基于短信猫+JAVA短信服务的短信方案，让您不需要开发，即可快速使用短信功能。


一、产品简介

金笛短信服务器是一款基于短信猫、猫池的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口网口猫池。
支持的接口主要有：
l 数据库接口：采用数据库存储收到的短信和待发送的短信。金笛短信服务器按照设定的时间间隔扫描数据库，实现自动发送并修改发送状态。发送失败还可以重发。目前支持MySQL、SQL Server、Oracle三种数据库。
l XML接口：收到的短信自动存为XML格式文件；需要发送的短信按照XML格式存储到指定目录，就可以自动发送出去。
l EMAIL接口：指定2个邮箱，一个用来接收短信，一个用来发送短信。发个EMAIL就可以发送短信。
l JMX接口：通过RMI方式实现远程控制短信收发队列（对象）。
l HTTP接口：收到短信或者发出短信后，可以按照指定参数调用URL。
l 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，解压缩就可以运行。
1、将jdsmsserver.rar 解压到C:\
cd c:\jdsmsserver\mysql-5.1.37-win32\bin
启动数据库：
mysqld --defaults-file=..\my.ini
2、向数据库插入一条待发送短信：
cd c:\jdsmsserver\mysql-5.1.37-win32\bin
mysql –u root smsserver
mysql> insert into smsserver_out (type,recipient,text,encoding,create_date) values ('O','13601019694','金笛短信服务器数据库设置成功','U', now());
手机号码改为你自己的手机号码。

3、修改配置文件中（ c:\jdsmsserver\conf\SMSServer.conf ）对应的短信设备端口号和波特率：
================================
# 请根据您具体应用环境，修改端口号和波特率。
# 建议使用M1206B或M1306B串口，USB口在linux老版本需要驱动。
gateway.0=M1306B, SerialModem
M1306B.port=COM1
M1306B.baudrate=115200
M1306B.manufacturer=Wavecom
M1306B.model=M1306B
M1306B.protocol=PDU
M1306B.pin=0000
M1306B.inbound=yes
M1306B.outbound=yes
M1306B.smsc_number=
================================

4、 启动金笛短信服务
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、 数据库接口收发测试：
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());
手机号码改为你自己的，等10秒左右，如果收到短信，说明数据库接口收发设置成功。
2、 URL收发测试：
打开IE浏览器，输入：
http://localhost:8080/send?password=1111&encoding=U&recipient=13601019694&text=%E5%9F%BA%E4%BA%8EHTTP%E7%9A%84%E7%9F%AD%E4%BF%A1%E6%94%B6%E5%8F%91%E6%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	短信通道标识，可指定发送通道。为空由短信服务器自动选择。