(修改)Ecology通用短信接口实现方式及使用说明

### Ecology通用短信接口实现方式及使用说明 #### 一、背景与目的 随着移动通信技术的发展，短信服务已经成为企业内外沟通的重要渠道之一。为了更好地适应市场上的多种短信设备供应商，并确保系统的灵活性与可扩展性，泛微e-cology平台设计并实现了一套通用的短信接口。该接口的主要目的是为了解决不同短信设备供应商之间的兼容性问题，通过定义一种统一的数据交互模式，使得短信的发送过程更为简便高效。 #### 二、接口设计原理 ##### 2.1 原理概述 Ecology通用短信接口的设计基于中间表机制，即平台仅负责将待发送的短信数据存入预先定义好的中间表中，而具体的发送任务则交由短信设备供应商或者客户的自定义程序来完成。这种方式不仅简化了短信发送流程，同时也降低了与多种短信设备集成时的技术难度。 ##### 2.2 技术要点 - **中间表机制**：所有待发送短信的信息均存储于中间表中，包括但不限于接收人手机号、短信内容等关键字段。 - **数据库支持**：当前版本仅支持SQL Server和Oracle两种类型的数据库，其他数据库暂未纳入支持范围。 - **配置文件**：短信发送相关的配置信息，如数据库连接参数、SQL语句等，均在`sms.xml`文件中定义。 #### 三、配置使用说明 ##### 3.1 配置文件解析 配置文件`sms.xml`位于`ecology/WEB-INF/service/`目录下，其中包含了核心的短信服务配置。下面详细介绍各配置项的意义： - `<setproperty="type"value="sqlserver"/>`：指定中间表所在的数据库类型，若使用Oracle，则需将此值更改为`"oracle"`。 - `<setproperty="host"value="192.168.0.204"/>`：指定中间表所在数据库服务器的IP地址。 - `<setproperty="port"value="1433"/>`：指定中间表所在数据库的端口号，对于Oracle数据库，标准端口号为1521。 - `<setproperty="dbname"value="ecology3802"/>`：指定中间表所在的数据库名称。 - `<setproperty="username"value="sa"/>`：指定访问中间表所在数据库的用户名。 - `<setproperty="password"value="123"/>`：指定访问中间表所在数据库的密码。 - `<setproperty="sql"value="..."/>`：定义了向中间表插入数据的具体SQL语句。例如： ``` <setproperty="sql"value="insert into OutBox(ReceiverMobileNo, Msg, SendTime, IsChinese, ExpressLevel, Sender) values(?, ?, getDate(), 1, 1, 1)"/> ``` - `ReceiverMobileNo`：接收人手机号。 - `Msg`：短信内容。 - `SendTime`：发送时间，默认使用SQL Server内置函数`getDate()`获取当前系统时间。 - `IsChinese`：是否为中文短信（示例中固定为1）。 - `ExpressLevel`：紧急程度（示例中固定为1）。 - `Sender`：发送人（示例中固定为1）。 ##### 3.2 使用步骤 1. **定位配置文件**：首先找到`sms.xml`配置文件。 2. **编辑配置信息**：根据实际情况调整数据库类型、IP地址、端口号、数据库名、用户名和密码。 3. **定义SQL语句**：根据短信中间表的实际结构，编写适当的SQL插入语句。注意，短信内容和接收人手机号字段需使用占位符`?`来表示动态值。 4. **部署并测试**：完成配置后，重启应用并进行短信发送测试，确保所有配置正确无误。 #### 四、注意事项 - 确保所使用的数据库类型符合接口支持的范围（SQL Server或Oracle）。 - 在配置文件中提供的数据库连接信息需准确无误，以免导致连接失败。 - 中间表的设计需包含至少两个字段：接收人手机号和短信内容。 - 对于非中文环境，需根据实际情况调整`IsChinese`字段的值。 - 测试阶段需密切关注日志信息，以便及时发现并解决问题。 #### 五、总结 通过上述介绍可以看出，Ecology通用短信接口提供了一种灵活高效的短信发送机制，适用于不同短信设备供应商的集成需求。开发者只需关注短信内容的生成与发送逻辑，无需过多考虑底层技术细节。此外，合理的配置管理也有助于提高系统的稳定性和可靠性。