消息服务

消息服务，主要实现服务端与客户端之间的数据交互，服务端与客户端之间的消息传送是其基础功能之一。

1. 功能介绍

消息服务，主要实现服务端与客户端之间的数据交互，服务端与客户端之间的消息传送是其基础功能之一。

根据项目的需求，可以实现业务需要的数据传输（例如，实现数据同步功能）。

2. 应用场景

下面，通过案例进行消息发送、消息接收的配置讲解。

1. 开发平台的配置

1.表定义
2.构件方法定义
3.窗体定义
在进行消息服务配置过程中，必须定义构件方法。
在本案例中，定义了2个构件方法： sendMessage(发送消息) 、 receiveMessage(接收消息) 。
（1）sendMessage(发送消息)
本案例只需定义【 方法输入 】（在实际项目中，可按需配置其他业务逻辑）。
sendMessage(发送消息) 构件方法的具体规则在执行平台中配置。
编码 名称 类型 初始值 必须 描述
messageContent 消息内容 长文本 ✔ 主要用于窗体界面执行该方法时，进行参数传递。
（2）receiveMessage(接收消息) 
在本案例中，根据入参新增（消息内容）数据并且保存。
方法输入：主要用于在执行平台【消息监听(客户端)】中配置时设置入参。
编码 名称 类型 必须 描述
messageContent 消息内容 长文本 ✔ 主要用于窗体界面执行该方法时，进行参数传递。
方法变量：
编码 名称 类型 必须 描述
message 消息 长文本 根据消息表定义字段，主要用于新增消息和保存消息。
规则配置：
① 新增实体记录【消息】
② 保存实际到数据表【消息】
在本案例中，定义了2个窗体： 发送消息 、 查看消息 。
（1）发送消息窗体
通过【发送】按钮，执行构件方法 sendMessage(发送消息) ，传入消息内容参数。
（2）查看消息窗体
主要通过窗体加载事件，配置【从数据库获取数据到实体】规则，查看消息数据（非必要配置，可以通过直接表查看消息数据）。

编码	名称	类型	初始值	必须	描述
`messageContent`	消息内容	长文本		✔	主要用于窗体界面执行该方法时，进行参数传递。

编码	名称	类型	必须	描述
`messageContent`	消息内容	长文本	✔	主要用于窗体界面执行该方法时，进行参数传递。

编码	名称	类型	必须	描述
`message`	消息	长文本		根据消息表定义字段，主要用于新增消息和保存消息。

2. 执行平台的配置

1.系统地址管理
2.消息队列定义(服务端)
3.消息服务器连接管理(客户端)
4.构件服务端方法
5.消息监听(客户端)
6.效果预览
访问目录：配置中心 → 业务系统初始化配置 → 集成服务 → 消息服务 → 系统地址管理
服务器：自定义，编码要求唯一性，被规则引用后不建议修改或删除；
访问地址URL：当前服务的地址；
类型：目前仅支持 " V系统 " 类型。
访问目录：配置中心 → 业务系统初始化配置 → 集成服务 → 消息服务 → 消息队列定义(服务端)
在消息队列定义（服务端）的配置中，需要对 “ 消息服务器设置 ” 和 “ 消息队列 ” 进行配置。
（1）消息服务器配置
消息服务器地址：主要作为 “ 消息管理 ” 的服务端口地址，格式：tcp:// + 访问地址URL（例如IP地址） + :端口，例如：tcp://127.0.0.1:9999 。
区别于【系统地址管理】中设置的 “ 访问地址URL ”
访问地址URL ：作为一个总的访问地址；
消息服务器地址 ： 是总访问地址中，开放的一个服务端口，并且消息管理服务端口必须只有一个，端口区别与访问地址URL的端口。
一般勾选  随应用服务器同时启动 ，当应用服务器（ “ 系统地址管理 ” 中添加的访问地址服务）启动时，同样启用消息服务器。
若不勾选，当应用服务器重启后，需要在该页面手动【启用】消息服务器。
（2）消息队列定义
主要定义队列传送数据（在实际的使用中，可根据实际业务需要来定义不同的消息队列，实现不同的业务功能）。
队列：自定义，编码要求唯一性；
消息类型：可以设置 广播消息（一对多） 和 点对点消息（一对一） ，在本案例中设置类型为  广播消息  ；
活动集：自定义，编号要求唯一性；
活动集变量：自定义，按需求设置活动集参数，用于定义消息队列该如何传送数据。
注意
在 “ 消息服务器连接管理 ” 中定义客户端信息时，可选择定义的队列，并对客户端授予该队列的连接权限，连接权限分为：接收和发送（如果无设置授权则视为允许任意的连接）。
访问目录：配置中心 → 业务系统初始化配置 → 集成服务 → 消息服务 → 消息服务器连接管理(客户端)
客户端：自定义，编码要求唯一性；
选择服务器：在【系统地址管理】中，选择对应的服务器。
连接测试：主要测试服务器是否能正常启动。
注意：只有服务器在【消息队列定义(服务端)】中定义了消息服务器地址，并且启动，那么选择的服务器才回匹配jms地址。
访问目录：配置中心 → 业务系统初始化配置 → 集成服务 → 服务端方法设置 → 构件服务端方法
主要设置在开发平台中定义的 sendMessage(发送消息) 构件方法规则。
（1）配置规则链
（2）【消息-发送信息】规则的具体配置
选择具体规则，点击【配置】按钮将打开【规则实例框架】窗体，进行规则的具体配置——若首次新增规则，将直接打开该窗体。
访问目录：配置中心 → 业务系统初始化配置 → 集成服务 → 消息服务 → 消息监听(客户端)
设置客户端后，会显示在消息监听列表中。
根据需求添加队列信息，并且配置消息处理规则链（主要设置在开发平台中定义的 receiveMessage(接收消息)构件方法），最后开启监听。
（1）配置消息处理规则链
（2）【执行方法】规则的具体配置
（3）开始监听
（1）发送消息
（2）接收消息