OrDroid-Msg 消息推送架构搭建手册 - OrDroid APP 相关

# 一、背景与目的
在实际生产中，往往需要将服务端数据(普通消息、协同工作流审批通知、ESOP文档更新、Andon异常)实时同步到客户端。因此，OrBitMsg消息推送服务架构主要用于数据服务器与用户Android客户端之间的数据分发，需要注意的是，本架构只基于用户局域网内的消息数据分发，如果需要外网接收，可通过微信等其它途径实现。本架构所涉及到表对象、存储过程请参考《OrBit消息推送开发文档》，实现原理请参考《OrBit消息推送机制》。
# 二、下载消息推送套件
在PKM中，找到"产品"分组，并打开"软件版本管理"元对象插件，点击"012 OrDroid APP 软件 V15.2（推荐使用）"，在"文件列表"页签下找到"消息推送套件.rar"下载，如图。
![](/media//202212/2022-12-16_110045.png)
# 三、安装jdk
3.1 jdk下载与配置
jdk下载地址：https://www.oracle.com/index.html(注意：目前项目只支持jdk1.8版本)
3.2 jdk环境变量配置步骤
(1) 右键"我的电脑"，点击"属性"，点击"高级系统设置"，选择"高级"页签，点击"环境变量"，在"系统变量"下新建一个"变量"，在"变量名"处写入"JAVA_HOME"，"变量值"为jdk安装路径。
![](/media//202011/2020-11-26_140250.png)
(2) 找到系统变量"Path"，点"编辑"，在变量值中增加一行变量"%JAVA_HOME%\bin;%JAVA_HOME%\jre\bin"。
![](/media//202011/2020-11-26_140609.png)
(3) 在"系统变量"下新建一个"变量"，"变量名"写入"CLASSPATH"，变量值写入".;%JAVA_HOME%\lib;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar"。
![](/media//202011/2020-11-26_140733.png)
(4) java环境配置好后，可运行"cmd"，输入"java"、"javac"检查是否成功，如图。
![](/media//202207/2022-07-04_153134.png)

![](/media//202207/2022-07-04_153444.png)

# 四、MAVEN部署
4.1 部署
将apache-maven-3.6.3压缩包解压至本地部署，完成后在系统变量"Path"中增加一行变量值，变量值为解压后的地址。
![](/media//202110/1633768114(1)_1633768173.jpg)
4.2 修改.m2地址
4.2.1 将.m2文件解压至本地部署
4.2.2 在apache-maven-3.6.3目录下找到conf目录, 找到settings.xml文件并打开
![](/media//202212/2022-12-15_172218.png)
4.2.3 修改.m2文件路径, 如下:
![](/media//202212/2022-12-15_172701.png)

# 五、ActiveMQ部署
将"apache-activemq-5.15.12-bin.zip"解压至本地，依次打开目录"apache-activemq-5.15.12-bin -> apache-activemq-5.15.12 -> bin -> win64"，运行"activemq.bat"即可。注意，ActiveMQ运行成功后，请不要关闭窗口，否则将无法推送消息。
![](/media//202011/2020-11-26_141154.png)

# 六、OrBitMsgServer项目部署
6.1 项目部署
将项目"OrBitMsgServer.zip"压缩包解压至用户本地。
6.2 修改项目端口
由于Tomcat的默认端口是8080，此端口经常会出现被占用的情况，此时我们可打开OrBitMsgServer项目，依次打开目录src\main\resources，打开"application.properties"文件，修改"server.port"属性，重新更换端口即可，如图。
![](/media//202206/2022-06-23_110418.png)
6.3 运行项目
运行快捷键"win+r"，在弹出窗口中输入"cmd"，定位到OrBitMsgServer项目根目录，执行命令"mvn spring-boot:run"。 注意，项目运行成功后，请不要关闭窗口，否则将无法推送消息。
![](/media//202011/2020-11-26_140931.png)

# 七、其它配置及说明
7.1 配置消息服务器地址
![](/media//202011/2020-11-26_141346.png)
7.2 存储过程OrDroid_MessagePackQueueTask说明
注：此存储过程主要用于遍历用户消息队列，所以需要将此存储过程部署到数据库作业队列上。
![](/media//202207/2022-07-04_145813.png)
7.3 OrBitMsgServer架构简单说明
当用户在消息对象写入一条数据后，会将消息转换成json字符串通过webapi接口发送至消息中间件。为防止用户未登录客户端漏接数据，此时数据库作业队列会在一段时间内通过存储过程OrDroid_MessagePackQueueTask遍历表对象AlarmSend，然后把表对象中未读消息转换成json字符串通过webapi接口发送至消息中间件，消息中间件在将数据转发至各用户Android客户端。