配置插件
REST 插件的配置可在 MERLIC RTE Setup 的“通讯”选项卡中调整。在“通讯”选项卡中,可以添加 REST 插件实例、配置参数,并可以直接在用户界面中启动和停止插件。
如果启用 RESTful API 和内置 web 应用程序,它们仅在插件运行时可用。
在 MERLIC RTE Setup 中启用配置
- 打开 MERLIC RTE Setup 并转到“通讯”选项卡。如果 MERLIC Communicator 未运行,您可以从“通讯”选项卡直接启动它。
-
- 确保插件当前未在运行。否则,参数将不可用于配置。可以通过插件实例列表中的相应状态图标查看插件的当前状态。如果状态显示
图标,表示插件正在运行。在这种情况下,必须通过单击 MERLIC RTE Setup 底部的“
停止插件”按钮停止它。如果状态显示
图标,表示插件当前未在运行。

此类型参数代表 Communicator 插件中无法在“通讯”选项卡的配置区域中调整的一般参数。它们可显示插件的版本号、日志等级的当前参数值、插件的访问等级,以及插件配置的验证设置。这些值需要在不同的位置或通过不同的方法分别进行设置。
Version
此参数显示在插件实现期间定义的版本号。它由主要版本、次要版本和维护版本组成。添加新插件实例时也会显示此版本号。版本是可选的。因此,在实现过程中可能并未定义版本号。
Log level
默认情况下,使用 Communicator 的日志等级,即“Info”。这意味着将记录严重程度为“critical”、“error”、“warning”和“info”的所有类型的消息,即提供一般性非关键信息的消息。
还可以为 Communicator 整体设置不同的日志等级,或仅针对特定插件实例进行设置。
Access level
此参数显示为插件设置的访问等级。对于 REST 插件,访问等级默认设置为“monitor and control”。这表示插件可以接收“事件”并发送“操作”。访问级别与插件实现中定义的功能相关。实现的功能无法在 MERLIC RTE Setup 中调整。
Supports rapid validation
该参数显示插件是否支持立即验证当前的插件配置。对于这个插件,勾选复选框表示支持“快速验证”。这意味着,每次在 MERLIC RTE Setup 的“通讯”选项卡中修改任何可编辑参数时,都会验证插件的配置。如果插件不支持“快速验证”,则只有在保存配置时才会验证插件的配置。
“User parameters”代表可为插件配置的参数集。它们显示在可以展开或关闭的不同类别中。
以下部分介绍每个类别的参数。
HTTP Server
此类别中的参数定义 HTTP 服务器的设置。
下图概述了参数以及相应的默认设置。图下有参数的详细说明。
IP address
此参数定义服务器监听连接所在的网络接口的互联网协议地址(IP 地址)。此参数支持互联网协议版本 4 (IPv4) 和版本 6 (IPv6) 地址。
默认情况下,它设置为“127.0.0.1”,这意味着只能从本地计算机访问 RESTful API 和内置 web 应用程序。如果要从同一网络中的另一个设备访问它们,则必须指定该网络中本地计算机的相应 IP 地址。
Port
此参数定义服务器监听新连接所在的端口。默认情况下设置为“8040”。
Serve built-in web app
此参数定义内置 web 应用程序是否在上面指定的系统中运行。默认情况下,此选项处于启用状态,当插件以默认设置运行时,您可以在网页浏览器中通过 http://127.0.0.1:8040 查看 web 应用程序。
In-Memory Database
此类别中的参数定义事件、结果和错误的缓冲区容量设置。操作和工作的容量设置为 1 MB 且无法更改。
下图概述了参数以及相应的默认设置。图下有参数的详细说明。
Event store capacity
此参数定义用于存储事件的缓冲区大小。默认情况下设置为 64 MB。
Result store capacity
此参数定义用于存储结果的缓冲区大小。默认情况下设置为 128 MB。
Error store capacity
此参数定义用于存储错误信息的缓冲区大小。默认情况下设置为 16 MB。
Data retention rate
此参数定义由于达到相应缓冲区的容量而回收内存时,缓冲区中保留的内存的百分比。默认情况下设置为 70%。这意味着 30% 的内存将被回收,70% 的内存将被保留。
指定的保留率适用于数据库中所有数据类型的缓冲区,包括容量正好为 1 MB 的操作和工作。