2.3. 通过截获数据包审核消息
截获进入或退出代理的数据包,以审核数据包或过滤信息。拦截器会更改它们截获的数据包。这使拦截器功能强大,但也存在存在危险性。
开发符合您业务需求的拦截器。拦截器是特定于协议的,必须实现适当的接口。
拦截器必须实现 intercept()
方法,它会返回一个布尔值。如果值为 true
,则消息数据包继续开启。如果为 false
,则进程被中止,没有调用其他拦截器,也不会进一步处理消息数据包。
2.3.1. 创建拦截器
拦截器可以更改它们所截获的数据包。您可以创建自己的传入和传出拦截器。所有拦截器都是特定于协议的,用于分别进入或退出服务器的任何数据包调用。这可让您创建拦截器来满足业务要求,如审计数据包。
拦截器及其依赖项必须放在代理的 Java 类路径中。您可以使用 <broker-instance-dir>/lib
目录,因为它是类路径的一部分。
以下示例演示了如何创建拦截器来检查传递给它的每个数据包的大小。
该示例为每个协议实施特定的接口。
步骤
实施适当的接口并覆盖其拦截器
()
方法。如果您使用 AMQP 协议,实施
org.apache.activemq.artemis.protocol.amqp.broker.AmqpInterceptor
接口。package com.example; import org.apache.activemq.artemis.protocol.amqp.broker.AMQPMessage; import org.apache.activemq.artemis.protocol.amqp.broker.AmqpInterceptor; import org.apache.activemq.artemis.spi.core.protocol.RemotingConnection; public class MyInterceptor implements AmqpInterceptor { private final int ACCEPTABLE_SIZE = 1024; @Override public boolean intercept(final AMQPMessage message, RemotingConnection connection) { int size = message.getEncodeSize(); if (size <= ACCEPTABLE_SIZE) { System.out.println("This AMQPMessage has an acceptable size."); return true; } return false; } }
如果使用 Core Protocol,您的拦截器必须实施
org.apache.artemis.activemq.api.core.Interceptor
接口。package com.example; import org.apache.artemis.activemq.api.core.Interceptor; import org.apache.activemq.artemis.core.protocol.core.Packet; import org.apache.activemq.artemis.spi.core.protocol.RemotingConnection; public class MyInterceptor implements Interceptor { private final int ACCEPTABLE_SIZE = 1024; @Override boolean intercept(Packet packet, RemotingConnection connection) throws ActiveMQException { int size = packet.getPacketSize(); if (size <= ACCEPTABLE_SIZE) { System.out.println("This Packet has an acceptable size."); return true; } return false; } }
如果您使用 MQTT 协议,则实施
org.apache.activemq.artemis.core.protocol.mqtt.MQTTInterceptor
接口。package com.example; import org.apache.activemq.artemis.core.protocol.mqtt.MQTTInterceptor; import io.netty.handler.codec.mqtt.MqttMessage; import org.apache.activemq.artemis.spi.core.protocol.RemotingConnection; public class MyInterceptor implements Interceptor { private final int ACCEPTABLE_SIZE = 1024; @Override boolean intercept(MqttMessage mqttMessage, RemotingConnection connection) throws ActiveMQException { byte[] msg = (mqttMessage.toString()).getBytes(); int size = msg.length; if (size <= ACCEPTABLE_SIZE) { System.out.println("This MqttMessage has an acceptable size."); return true; } return false; } }
如果您使用 STOMP 协议,则实施
org.apache.activemq.core.protocol.stomp.StompFrameInterceptor
接口。package com.example; import org.apache.activemq.artemis.core.protocol.stomp.StompFrameInterceptor; import org.apache.activemq.artemis.core.protocol.stomp.StompFrame; import org.apache.activemq.artemis.spi.core.protocol.RemotingConnection; public class MyInterceptor implements Interceptor { private final int ACCEPTABLE_SIZE = 1024; @Override boolean intercept(StompFrame stompFrame, RemotingConnection connection) throws ActiveMQException { int size = stompFrame.getEncodedSize(); if (size <= ACCEPTABLE_SIZE) { System.out.println("This StompFrame has an acceptable size."); return true; } return false; } }