消息中心构架设计说明书版本:1.0变更记录目录1 1. 文档介绍 (4)1.1文档目的 (4)1.2文档范围 (4)1.3读者对象 (4)1.4参考文献 (4)1.5术语与缩写解释 (4)2系统概述 (5)3设计约束 (6)4设计策略 (7)5系统总体结构 (8)6子系统N的结构与功能 (15)7开发环境的配置 (27)8运行环境的配置 (28)9测试环境的配置 (29)10其它 (30)1 1. 文档介绍1.1 文档目的消息中心接收别的系统发送的消息,再基于一定的规则以邮件、短信、消息等方式推送消息到pc端和手机端,比如对于attendance迟到、早退、tour超时提醒等需要及时推送相应的信息给相关人员,中心对规则、用户、消息进行管理。
为此,根据“先进实用、稳定可靠”的原则设计本消息中心。
1.2 文档范围消息的接收、发送、保存,对应用用户的管理。
1.3 读者对象开发人员1.4 参考文献1.5 术语与缩写解释2 系统概述系统主要完成消息的接收、发送和保存,再基于一定的规则以邮件、短信、消息等方式推送消息到pc端或手机,以及对用户、规则、消息进行管理。
系统接收来自别的系统应用用户的消息,然后基于一定的规则把消息进行推送。
3 设计约束1.系统必须遵循国家软件开发的标准。
2.系统用java开发,服务器中间件为tomcat。
3.系统必须稳定可靠,性能高,满足每天40-500万次的推送量。
4.保证消息的成功送达,如果不成功就重发。
4 设计策略1. 系统高可用、高性能、易扩展,安全稳定,实用可靠,满足用户的需要。
2. 系统可以进行扩展,增加推送的消息种类,增加消息推送的规则。
3. 系统可以复用于别的系统的消息推送。
5 系统总体结构5.1 系统架构设计1.逻辑架构系统采用接口用rocketMQ实现应用用户的消息接收,用drools依据一定的规则进行消息转发,发送邮件、短信、消息到pc端和手机端,消息发送后用rocketMQ发送结果消息给应用用户。
用户管理发送规则,对不同的消息、发送的方式、发送的时间、接收者进行设置,以后消息中心按照这些规则发送消息。
规则处理采用drools完成。
系统采用MQTT服务器 mosquito实现消息对手机端的推送,采用winsocket 发送消息给pc端。
MQTT通过发布/订阅方式发送消息给手机,方式为发布/订阅,为了实现点对点发送,需要在发送的消息里加上手机端的imei和用户名,同时在手机端进行判断,如果imei和用户名符合则接收此消息。
采用winsocket实现推送消息到pc端,为实现点对点的推送,可以在消息中加上要发送的pc端的用户名,pc端对消息的用户名进行判断,如果和自己的一样则接收消息。
对于群发,大家都可以收到。
应用用户通过接口发送消息给消息中心,消息采用json格式,包含应用用户id、发送消息方式id、Title、content、usrId,sendTime。
采用mqtt QoS level 2协议,保证自动重发发送不成功的消息,而且可以保证消息的顺序到达,可以设置超时时间,防止断网。
Mqtt不建立长连接,省电、省流量。
还可以用mosquitto实现集群发送,集群可以线性扩展。
应用系统用户在注册、登陆后申请发送消息的类别,有邮件、短信、手机消息、pc消息4种,注册后要记住自己的id,然后通过接口发送消息;管理员审批用户的申请,管理消息;消息中心发送消息或邮件、短信到相应的pc端或手机端用户。
系统的管理功能包括对规则、用户、消息进行管理。
中心的时区设当地的时区,系统用ntpdate命令让系统使用NTP(Network Time Protocol 网络时间协议)协议来从网络同步时间的命令,这样即使有夏令时的变化,系统也会自动更新。
中心使用时间时需要得到系统的时区。
2.网络架构5.2 系统包含模块1.消息接收发送模块。
1)提供发送接口用于接收应用用户的消息和参数,然后通过规则发送消息,用户通过接收接口得到发送结果:发送消息到手机端。
发送消息到pc端。
发送邮件。
发送短信。
2.手机、pc接收模块。
手机接收消息中心发送的消息。
Pc接收消息中心发送的消息。
3.管理模块。
1)用户和管理员注册、登陆。
2)实现用户申请消息发送方式申请、查看消息、修改密码、统计消息。
用户可以申请邮件、短信、手机消息、pc消息4种方式发送消息。
3)管理用户、审批用户发送方式、管理员密码修改、查看和统计发送过的消息。
4)管理规则,可以增加、修改、删除查询规则。
5.3 用例图1.应用用户用例图2.管理员用例图3消息用户用例图4.应用用户用例图5.4 流程图1.发送消息流程图6 系统模块的结构与功能系统包括消息接收送接模块、手机、pc接收消息模块、管理模块,共3个模块。
6.1 消息接收发送模块提供接口用于接收应用用户的消息,然后用drools通过规则异步发送消息,用户调用接收接口得到发送结果:发送消息到手机端。
发送消息到pc端。
发送邮件。
发送短信。
系统采用rocketmq接收消息和返回消息发送结果给用户,系统给pc、手机采用@Async异步发送邮件等消息,并得到发送结果,把结果返回给调用者,消息及发送的情况入库,入库时需要检查消息是否已经存在。
用户采用异步调用本接口,得到发送结果,如果不成功,用户可以重发。
因为中心的时区与各用户的时区不同,用户需要发送自己的时区,系统返回发送时间时要根据时区转换时间。
当手机离线没有收到消息,则在定时器中重发;对于需要定时发送的消息,通过定时器完成发送。
定时器20分钟执行一次,对这2种情况通过规则发送消息。
系统确定时间时要根据时区进行转换,按照用户的时区时间来发送消息。
6.1.1单元定义6.1.2接口描述1. 发送接口接口定义:public void sendMessage(String applicationId,String typeid,String title,String content,String userId) throws Exception;●描述:通过调用此接口可发送消息及参数,接口在com.isoftstone.message.MessageBiz中。
●入口参数2. 接收接口接口定义:public Integer getMessageResult(String applicationId,String typeid,String title,String content,String userId) throws Exception;●描述:通过调用此接口可得到发送消息的结果,如果发送失败,用户则调用发送接口重发。
接口在com.isoftstone.message.MessageBiz中。
●入口参数接口返回:时序图基本场景以下场景触发模块:用户调用接口发送消息。
时序图及描述流程描述:1. 用户使用接口发送消息及参数。
2. 接口对消息参数进行分析,判断是否可以发送。
3. 接口根据参数分别异步发送邮件、短信、手机、pc消息,并得到发送结果,反馈给接口调用者。
4. 发送消息后保存消息到数据库。
异常描述IO异常:数据插入失败,写入日志。
数据库操作异常:数据插入失败,写入日志网络连接超时异常:网络异常,发送失败,写入日志并反馈给用户。
6.2 手机、pc接收模块6.2.1手机接收消息中心发送的消息手机用mqtt接收消息。
6.2.2P c接收消息中心发送的消息。
Pc用winsocket接收消息。
6.3 管理模块。
6.3.1用户和管理员注册、登陆。
用户和管理员注册、登陆。
应用用户注册后记住自己的id,以后发送消息时会用到。
6.3.2用户操作功能。
实现用户申请消息发送方式申请、查看消息、修改密码、统计消息。
用户可以申请邮件、短信、手机消息、pc消息4种方式发送消息。
6.3.3管理功能。
管理规则、用户、审批用户发送方式、管理员密码修改、查看和统计发送过的消息。
规则以xml格式生成。
6.3.4注册、登陆界面完成应用用户和注册、登陆。
6.3.5用户申请界面实现用户申请消息发送方式申请。
用户可以申请邮件、短信、手机消息、pc消息4种方式发送消息。
1.应用用户消息管理2.应用用户消息管理3.应用用户密码管理4.发送管理5.应用用户消息统计6.3.6管理界面管理员实现对应用用户的管理、对应用用户申请的管理和对消息的管理,及管理员注册、登陆。
1.应用用户管理2.应用用户消息审批管理2. 消息管理4..管理员密码管理5.消息统计5. 规则管理6. 规则编辑7 开发环境的配置8 运行环境的配置9 测试环境的配置同开发环境。
10 其它10.1 数据库设计t_ m obile_messageidtitle content sendTime status remarkreceiveUserIdapplicationTypeId deletedbigint varchar(80)varchar(500)datetime tinyintvarchar(100)varchar(50)bigint tinyint<pk>t_timeZoneidcountry timeZone keycreateTime updateTime remark deleted ...bigint varchar(80)varchar(100)varchar(100)datetime datetime datetime tinyint<pk>t_application _message_type idapplicationId typeId name remark agree deleted applyTime ...bigint bigint bigintvarchar(50)varchar(100)int intdatetime<pk>t_message_subscribe_type id name reamark deleted ...bigint varchar(50]varchar(100)tinyint<pk>t_adminid name email telephone remark passWord registerTime deleted ...bigint varchar(50)varchar(128)varchar(32)varchar(100)varchar(50)datetime tinyint<pk>t_application_userid name email telephone remark passWord registerTime deleted ...bigint varchar(50)varchar(128)varchar(32)varchar(100)varchar(50)datetime tinyint<pk>t_ e mail_messageidtitle content sendTime dst status remarkreceiveUserIdapplicationTypeIdbigint varchar(80)varchar(500)datetime tinyint tinyintvarchar(100)varchar(50)bigint<pk>t_ s hort_messageidtitle content sendTime status remarkreceiveUserIdapplicationTypeId deletedbigint varchar(80)varchar(500)datetime tinyintvarchar(100)varchar(50)bigint tinyint<pk>t_pc_ m essageidtitle content sendTime status remarkreceiveUserIdapplicationTypeId deletedbigint varchar(80)varchar(500)datetime tinyintvarchar(100)varchar(50)bigint tinyint<pk>t_userd_timeZoneidcountry timeZone keycreateTime updateTime remark deleted ...bigint varchar(80)varchar(100)varchar(100)datetime datetime datetime tinyint<pk>t_ruleid name content createTime updateTimeremark deleted ...bigint varchar(100)varchar(1000)datetime datetime datetime int<pk>10.1.1邮件消息表t_email_message⏹ 主要用途:保存发送的邮件 ⏹ 数据增长频率:个⏹ 数据保存周期:由用户调用操作10.1.2手机消息表t_mobile_message⏹主要用途:保存发送的手机消息⏹数据增长频率:个⏹数据保存周期:由用户调用操作10.1.3短信消息表t_short_message⏹主要用途:保存发送的短信消息。