3.5. 通过截获数据包来审核消息
截获进入或退出代理的数据包,以审核数据包或过滤消息。拦截器会更改它们拦截器的数据包。这使得拦截器功能强大,但也可能有危险。
开发满足您业务需求的拦截器。拦截器是特定于协议的,必须实现适当的接口。
拦截器必须实施 intercept ()
方法,该方法返回布尔值。如果值为 true
,则消息数据包将继续。如果为 false
,则进程将中止,则不会调用其他拦截器,且不会进一步处理消息数据包。
3.5.1. 创建拦截器 复制链接链接已复制到粘贴板!
拦截器可能会更改它们拦截器的数据包。您可以创建自己的传入和传出的拦截器。所有拦截器都特定于协议,并为进入或分别退出服务器的任何数据包调用。这可让您创建拦截器来满足审计数据包等业务要求。
拦截器及其依赖项必须放在代理的 Java 类路径中。您可以使用 < ;broker_instance_dir> /lib
目录,因为它是 classpath 的一部分。
以下示例演示了如何创建一个拦截器来检查传递给它的每个数据包的大小。
这个示例为每个协议实施一个特定的接口。
流程
实施适当的接口并覆盖其
intercept ()
方法。如果您使用 AMQP 协议,请实施
org.apache.activemq.artemis.protocol.amqp.broker.AmqpInterceptor
接口。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 如果使用核心协议,您的拦截器必须实现
org.apache.artemis.activemq.api.core.Interceptor
接口。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 如果您使用 MQTT 协议,请实施
org.apache.activemq.artemis.core.protocol.mqtt.MQTTInterceptor
接口。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 如果您使用 STOMP 协议,请实施
org.apache.activemq.artemis.core.protocol.stomp.StompFrameInterceptor
接口。Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.5.2. 将代理配置为使用拦截器 复制链接链接已复制到粘贴板!
先决条件
-
创建拦截器类,并将其添加到代理的 Java 类路径中。您可以使用 <
;broker_instance_dir> /lib
目录,因为它是 classpath 的一部分。
流程
-
Open
<broker_instance_dir>/etc/broker.xml
通过将配置添加到 <broker
_instance_dir> /etc/broker.xml
,将代理配置为使用拦截器如果拦截器用于传入的信息,请将其
class-name
添加到remoting-incoming-interceptors
列表中。Copy to Clipboard Copied! Toggle word wrap Toggle overflow 如果拦截器用于传出消息,请将其
class-name
添加到remoting-outgoing-interceptors
列表中。Copy to Clipboard Copied! Toggle word wrap Toggle overflow
3.5.3. 客户端上的拦截器 复制链接链接已复制到粘贴板!
客户端可以使用拦截器来截获客户端向服务器发送或服务器发送到客户端的数据包。如果代理侧拦截器返回 false
值,则不会调用其他拦截器,客户端不会进一步处理数据包。这个过程透明,除非以 阻塞
的方式发送传出数据包。在本例中,ActiveMQException
会抛出给调用者。ActiveMQException
thrown 包含返回 false
值的拦截器的名称。
在服务器上,客户端拦截器类及其依赖项必须添加到客户端的 Java 类路径中,才能正确实例化和调用。