#RocketMQ Filtersrv详解 Metaq 3.0以后改名为RocketMQ，阿里云的ONS则是基于RocketMQ搭建的。今天闲着无事，把RocketMQ的代码clone到本地分析了一下，从clone下来的代码，结构还是比较清晰的，代码量也不是很多。我发现其中一个模块我之前没有听说过的。于是就抱着一探究竟的目的，去看看它是何物，这个模块就是filtersrv，是RocketMQ在3.0.11版本以后加入的模块。下面将对它进行讨论和分析，这里假设你已经对RocketMQ有一定的了解，不对如何搭建它做任何介绍。 ##RocketMQ基本组件 在RocketMQ中分为client(consumer,producer)、broker和namesrv，下面对这三者进行一下简单的介绍。
- client:是开发主要面对的模块，它主要提供consumer订阅消息，提供producer发布消息，提供简洁的API。<br>
- broker:是每个RocketMQ中最核心的部分，该组件提供消息的存储和分发，producer将某个topic的消息发布到broker，而consumer将从broker订阅某个topic的消息<br/>
- namesrv:可以理解为注册中心，没个broker启动则将会将自己的信息发布到namesrv，发布到namesrv的信息包括broker提供的topic信息，那么client启动的时候，则将自己所需要的topic向namesrv订阅，namesrv则会返回提供订阅topic的broker信息（主要是地址相关信息），获的broker信息，那么client可以直接和broker通信。
如果按照dubbo的思维去看待，可以把topic理解为一个服务的接口，broker则是实现该服务的提供者，namesrv则是dubbo中的注册中心，这样就不难理解RocketMQ中这三个组件了。基于这个，那么这三者之间的通信是下图方式：
上面讲了一大堆貌似还没有filtersrv的内容，下面将进入今天的主题——filtersrv
##Filtersrv是何物 相信从名字可以大概看到它的目的，没错他就是过滤服务器，那是对什么进行过滤呢？以及我们要怎么配置才可以让它工作呢？
在深入介绍它之前，先看看怎么用它，上代码：
1public class Consumer { 2 3 public static void main(String[] args) throws InterruptedException, MQClientException { 4 DefaultMQPushConsumer consumer = new DefaultMQPushConsumer("ConsumerGroupNamecc4"); 5 consumer.setNamesrvAddr("localhost:20881"); 6 /** 7 * 使用Java代码，在服务器做消息过滤 8 */ 9 consumer.subscribe("TopicFilter7","MessageFilterImpl","import com.alibaba.rocketmq.common.filter.MessageFilter;\n" + 10 "import com.alibaba.rocketmq.common.message.MessageExt;\n" + 11 "\n" + 12 "\n" + 13 "public class MessageFilterImpl implements MessageFilter {\n" + 14 "\n" + 15 " @Override\n" + 16 " public boolean match(MessageExt msg) {\n" + 17 " String property = msg.getUserProperty(\"SequenceId\");\n" + 18 " if (property != null) {\n" + 19 " int id = Integer.parseInt(property);\n" + 20 " if ((id % 3) == 0 && (id > 10)) {\n" + 21 " return true;\n" + 22 " }\n" + 23 " }\n" + 24 "\n" + 25 " return false;\n" + 26 " }\n" + 27 "}"); 28 29 consumer.registerMessageListener(new MessageListenerConcurrently() { 30 31 @Override 32 public ConsumeConcurrentlyStatus consumeMessage(List<MessageExt> msgs, 33 ConsumeConcurrentlyContext context) { 34 System.out.println(Thread.currentThread().getName() + " Receive New Messages: " + msgs); 35 return ConsumeConcurrentlyStatus.CONSUME_SUCCESS; 36 } 37 }); 38 39 /** 40 * Consumer对象在使用之前必须要调用start初始化，初始化一次即可<br> 41 */ 42 consumer.start(); 43 44 System.out.println("Consumer Started."); 45 } 46} 47 48 49public class Producer { 50 public static void main(String[] args) throws MQClientException, InterruptedException { 51 DefaultMQProducer producer = new DefaultMQProducer("ProducerGroupName"); 52 producer.start(); 53 54 try { 55 for (int i = 0; i < 6000000; i++) { 56 Message msg = new Message("TopicFilter7",// topic 57 "TagA",// tag 58 "OrderID001",// key 59 ("Hello MetaQ").getBytes());// body 60 61 msg.putUserProperty("SequenceId", String.valueOf(i)); 62 63 SendResult sendResult = producer.send(msg); 64 System.out.println(sendResult); 65 } 66 } 67 catch (Exception e) { 68 e.printStackTrace(); 69 } 70 71 producer.shutdown(); 72 } 73}
你可能会发现为什么这里的Consumer订阅消息的时候这么复杂？一串java类的源码，并且这个类还实现了MessageFilter接口，如果你仔细看会发现MessageFilter的方法match会对当前消息中的某个自定义属性判断，返回boolean值。这个是什么意思呢？不妨看看MessageFilter的接口定义
1/** 2 * 服务端消息过滤接口，Consumer实现这个接口后，Consumer客户端会注册这段Java程序到Broker，由Broker来编译并执行， 3 * 以达到服务器消息过滤的目的 4 */ 5public interface MessageFilter { 6 /** 7 * 过滤消息 8 * 9 * @param msg 10 * @return 是否可以被Consumer消费 11 */ 12 public boolean match(final MessageExt msg); 13}
相信看到这个注释就应该知道这个是干嘛的吧？其实就是对当前消费者接受的消息进行一次过滤。如果在延伸点就是可以自定义负载均衡，上面的MessageFilter既然是字符串，那是不是表示可以动态生成这个代码呢？对的，那么基于这个可以动态对同一个Group下面的消费者提供不同的过滤原则。那么下面让我们在看深点，看看consumer是什么时候通知filtersrv，以及filtersrv是在整个RocketMQ定位是什么？分析如果有了filtersrv之后，整个订阅消息和发布消息又和异常。
##Broker和Filtersrv绑定
###Broker和Filtersrv的关系
1public class FiltersrvConfig { 2 private String rocketmqHome = System.getProperty(MixAll.ROCKETMQ_HOME_PROPERTY, 3 System.getenv(MixAll.ROCKETMQ_HOME_ENV)); 4 5 @ImportantField 6 private String namesrvAddr = System.getProperty(MixAll.NAMESRV_ADDR_PROPERTY, 7 System.getenv(MixAll.NAMESRV_ADDR_ENV)); 8 9 // 连接到哪个Broker 10 private String connectWhichBroker = "127.0.0.1:10911"; 11 // Filter Server对外服务的IP 12 private String filterServerIP = RemotingUtil.getLocalAddress(); 13 // 消息超过指定大小，开始压缩 14 private int compressMsgBodyOverHowmuch = 1024 * 8; 15 // 压缩Level 16 private int zipCompressLevel = 5; 17 18 // 是否允许客户端上传Java类 19 private boolean clientUploadFilterClassEnable = true; 20 21 // 过滤类的仓库地址 22 private String filterClassRepertoryUrl = "http://fsrep.tbsite.net/filterclass"; 23 24 private int fsServerAsyncSemaphoreValue = 2048; 25 private int fsServerCallbackExecutorThreads = 64; 26 private int fsServerWorkerThreads = 64; 27 ..... 28}
上面是FiltersrvConfig的定义，所有关于filtersrv的配置信息都会封装在这个里面。可以看到主要要配置三个参数namesrvAddr、namesrvAddr和connectWhichBroker（此处补充一下：RocketMQ每个模块具体有哪些配置项的规则还是比较简单的可以看看MixAll里面的properties2Object方法，这个是自动将properties文件自动填充到FiltersrvConfig，BrokerConfig、NamesrvConfig、NettyServerConfig和NettySystemConfig等配置对象中），其中namesrvAddr和namesrvAddr两个属性和broker的一样，而connectWhichBroker表示当前filtersrv是属于哪个broker的，这里可以看出一个filtersrv只能属于一个broker，那是不是一个broker可以有多个filtersrv呢？这个后面介绍。
为了探究broker和filtersrv之间的关系，有必要看看broker的启动和注册到namesrv的过程，RocketMQ的一点好处就是基本每个模块都是通过XXXStartup加上XXController，那么broker也不例外，它的入口是BrokerStartup和BrokerController。如果你展开了rocketmq-broker的包接口，一个很醒目的filtersrv包名，不用想也知道，这就是broker和filtersrv关联的主要地方。
代码看上去并没有很多，如果你打开BrokerController不难发现它有一个filterServerManager属性，就是FilterServerManager。看broker的启动，需要看看BrokerController的start方法，看里面做了什么。
1if (this.messageStore != null) { 2 this.messageStore.start(); 3 } 4 5 if (this.remotingServer != null) { 6 this.remotingServer.start(); 7 } 8 9 if (this.brokerOuterAPI != null) { 10 this.brokerOuterAPI.start(); 11 } 12 13 if (this.pullRequestHoldService != null) { 14 this.pullRequestHoldService.start(); 15 } 16 17 if (this.clientHousekeepingService != null) { 18 this.clientHousekeepingService.start(); 19 } 20 21 if (this.filterServerManager != null) { 22 this.filterServerManager.start(); 23 } 24 25 this.registerBrokerAll(true, false); 26 27 this.scheduledExecutorService.scheduleAtFixedRate(new Runnable() { 28 29 @Override 30 public void run() { 31 try { 32 BrokerController.this.registerBrokerAll(true, false); 33 } 34 catch (Exception e) { 35 log.error("registerBrokerAll Exception", e); 36 } 37 } 38 }, 1000 * 10, 1000 * 30, TimeUnit.MILLISECONDS); 39 40 if (this.brokerStatsManager != null) { 41 this.brokerStatsManager.start(); 42 } 43 44 this.addDeleteTopicTask();
发现是启动了各个组件，其中也触发了filterServerManager的start方法，另外还设置了一个定时器定时器将当前broker注册到namesrv。上面看到是在filtersrv需要配置broker的地址信息，而broker并没有配置filtersrv的地方，那可以猜测是filtersrv启动的时候向broker发送了一个消息，表示告诉broker你有一个filtersrv了。我就抱着这个猜想去看看是不是真的这样，要看broker监听请求，那就需要看看remotingServer了，这里先说明一下RocketMQ用来处理远程的请求的均是NettyRequestProcessor接口的实现，那么可以发现在BrokerController的initialize方法调用了registerProcessor方法，可以看到在方法registerProcessor中，向remotingServer注册了各种NettyRequestProcessor实现，其中有一个AdminBrokerProcessor做为默认的processor。看看AdminBrokerProcessor里面的实现，发现里面有注册filtersrv的实现：
1@Override 2 public RemotingCommand processRequest(ChannelHandlerContext ctx, RemotingCommand request) 3 throws RemotingCommandException { 4 switch (request.getCode()) { 5 ...... 6 7 case RequestCode.REGISTER_FILTER_SERVER: 8 return this.registerFilterServer(ctx, request); 9 // 根据 topic 和 group 获取消息的时间跨度 10 ...... 11 default: 12 break; 13 } 14 15 return null; 16 }
果然是我们猜测的那样，是filtersrv向broker注册。下面我就不卖关子了，直接告诉filtersrv在哪里向broker注册了自己，在FiltersrvController的initialize方法的时候调用了FilterServerOuterAPI的registerFilterServerToBroker方法将自己注册到broker里面去了。上面说了一个filtersrv只能属于一个broker，那一个broker可不可以有多个filtersrv呢？下面揭开这个谜底。上面已经知道broker在哪里处理filtersrv的注册请求，那么我们不妨看看registerFilterServer方法做了什么事情：
1 private RemotingCommand registerFilterServer(ChannelHandlerContext ctx, RemotingCommand request) 2 throws RemotingCommandException { 3 final RemotingCommand response = 4 RemotingCommand.createResponseCommand(RegisterFilterServerResponseHeader.class); 5 final RegisterFilterServerResponseHeader responseHeader = 6 (RegisterFilterServerResponseHeader) response.readCustomHeader(); 7 final RegisterFilterServerRequestHeader requestHeader = 8 (RegisterFilterServerRequestHeader) request 9 .decodeCommandCustomHeader(RegisterFilterServerRequestHeader.class); 10 11 this.brokerController.getFilterServerManager().registerFilterServer(ctx.channel(), 12 requestHeader.getFilterServerAddr()); 13 14 responseHeader.setBrokerId(this.brokerController.getBrokerConfig().getBrokerId()); 15 responseHeader.setBrokerName(this.brokerController.getBrokerConfig().getBrokerName()); 16 17 response.setCode(ResponseCode.SUCCESS); 18 response.setRemark(null); 19 return response; 20 } 21
其实最后还是交给了FilterServerManager的registerFilterServer方法，继续深入进去，看看这个方法里面做了什么。
1 public void registerFilterServer(final Channel channel, final String filterServerAddr) { 2 FilterServerInfo filterServerInfo = this.filterServerTable.get(channel); 3 if (filterServerInfo != null) { 4 filterServerInfo.setLastUpdateTimestamp(System.currentTimeMillis()); 5 } 6 else { 7 filterServerInfo = new FilterServerInfo(); 8 filterServerInfo.setFilterServerAddr(filterServerAddr); 9 filterServerInfo.setLastUpdateTimestamp(System.currentTimeMillis()); 10 this.filterServerTable.put(channel, filterServerInfo); 11 log.info("Receive a New Filter Server<{}>", filterServerAddr); 12 } 13 } 14
发现是将filtersrv信息封装成了FilterServerInfo并且放到了filterServerTable一个 Map对象中，既然这里是一个集合，那就不难知道一个broker可以有多个filtersrv，这个问题就解决了。
上面一直是在说filtersrv和broker之间的关系，以及filtersrv如果将自己注册到broker中。下面我们看看有了filtersrv的broker又如何将自己发布到namesrv中。
###Broker如何将自己注册到Namesrv
要回答上面的问题，其实就要知道Broker如何将自己注册到Namesrv中。如果没记错，上面以及说过在 BrokerController有定时将自己注册到Namersrv中，那这个就简单了，看看那个里面做了什么，这个问题基本就解决了。在 BrokerController的registerBrokerAll方法便是将broker发布到所有的namesrv中的逻辑。
1 public synchronized void registerBrokerAll(final boolean checkOrderConfig, boolean oneway) { 2 TopicConfigSerializeWrapper topicConfigWrapper = 3 this.getTopicConfigManager().buildTopicConfigSerializeWrapper(); 4 5 if (!PermName.isWriteable(this.getBrokerConfig().getBrokerPermission()) 6 || !PermName.isReadable(this.getBrokerConfig().getBrokerPermission())) { 7 ConcurrentHashMap<String, TopicConfig> topicConfigTable = 8 new ConcurrentHashMap<String, TopicConfig>(topicConfigWrapper.getTopicConfigTable()); 9 for (TopicConfig topicConfig : topicConfigTable.values()) { 10 topicConfig.setPerm(this.getBrokerConfig().getBrokerPermission()); 11 } 12 topicConfigWrapper.setTopicConfigTable(topicConfigTable); 13 } 14 15 RegisterBrokerResult registerBrokerResult = this.brokerOuterAPI.registerBrokerAll(// 16 this.brokerConfig.getBrokerClusterName(), // 17 this.getBrokerAddr(), // 18 this.brokerConfig.getBrokerName(), // 19 this.brokerConfig.getBrokerId(), // 20 this.getHAServerAddr(), // 21 topicConfigWrapper,// 22 this.filterServerManager.buildNewFilterServerList(),// 23 oneway); 24 25 if (registerBrokerResult != null) { 26 if (this.updateMasterHAServerAddrPeriodically && registerBrokerResult.getHaServerAddr() != null) { 27 this.messageStore.updateHaMasterAddress(registerBrokerResult.getHaServerAddr()); 28 } 29 30 this.slaveSynchronize.setMasterAddr(registerBrokerResult.getMasterAddr()); 31 32 if (checkOrderConfig) { 33 this.getTopicConfigManager().updateOrderTopicConfig(registerBrokerResult.getKvTable()); 34 } 35 } 36 } 37 38 39 public List<String> buildNewFilterServerList() { 40 List<String> addr = new ArrayList<String>(); 41 Iterator<Entry<Channel, FilterServerInfo>> it = this.filterServerTable.entrySet().iterator(); 42 while (it.hasNext()) { 43 Entry<Channel, FilterServerInfo> next = it.next(); 44 addr.add(next.getValue().getFilterServerAddr()); 45 } 46 return addr; 47 }
可以看到上面的方法调用了filterServerManager的buildNewFilterServerList方法，而buildNewFilterServerList方法则是从上面说的filterServerTable集合中把filtersrv的地址拷贝出来，不得不说世界是圆的。到这里我们知道broker将自己注册到namesrv的时候，其实是将属于自己的filtersrv也注册到了namesrv中，那我这里又猜测一下，client端通过topic查找某个broker的时候也会将附带的filtersrv提供给client端，因为这也是属于broker的一部分。
##Client端通过Topic查找broker
要看client通过topic查找broker，就需要去看看namesrv端的处理了。在整个RocketMQ中，我个人觉得namesrv实现比较简洁，不光是代码量，实现比较直接，并没有过多的嵌套。整个namesrv处理来自broker和client的请求均是在DefaultRequestProcessor类中实现。那么我们找一下在哪里是通过topic查找broker的。
1@Override 2 public RemotingCommand processRequest(ChannelHandlerContext ctx, RemotingCommand request) 3 throws RemotingCommandException { 4 if (log.isDebugEnabled()) { 5 log.debug("receive request, {} {} {}",// 6 request.getCode(), // 7 RemotingHelper.parseChannelRemoteAddr(ctx.channel()), // 8 request); 9 } 10 11 switch (request.getCode()) { 12 .... 13 case RequestCode.REGISTER_BROKER: 14 Version brokerVersion = MQVersion.value2Version(request.getVersion()); 15 // 新版本Broker，支持Filter Server 16 if (brokerVersion.ordinal() >= MQVersion.Version.V3_0_11.ordinal()) { 17 return this.registerBrokerWithFilterServer(ctx, request); 18 } 19 // 低版本Broker，不支持Filter Server 20 else { 21 return this.registerBroker(ctx, request); 22 } 23 .... 24 case RequestCode.GET_ROUTEINTO_BY_TOPIC: 25 return this.getRouteInfoByTopic(ctx, request); 26 ..... 27 default: 28 break; 29 } 30 return null; 31 }
此处顺便也说一下broker注册的处理，可以看到在处理broker注册的时候有进行版本判断，可以看到如果版本大于3.0.11，那么就有通过filtersrv，注册的实现方法是registerBrokerWithFilterServer里面的具体实现，可以自行去看看。接下来看看通过topic查找broker的处理，其实就是getRouteInfoByTopic方法的逻辑。
1 public RemotingCommand getRouteInfoByTopic(ChannelHandlerContext ctx, RemotingCommand request) 2 throws RemotingCommandException { 3 final RemotingCommand response = RemotingCommand.createResponseCommand(null); 4 final GetRouteInfoRequestHeader requestHeader = 5 (GetRouteInfoRequestHeader) request 6 .decodeCommandCustomHeader(GetRouteInfoRequestHeader.class); 7 8 TopicRouteData topicRouteData = 9 this.namesrvController.getRouteInfoManager().pickupTopicRouteData(requestHeader.getTopic()); 10 11 if (topicRouteData != null) { 12 String orderTopicConf = 13 this.namesrvController.getKvConfigManager().getKVConfig( 14 NamesrvUtil.NAMESPACE_ORDER_TOPIC_CONFIG, requestHeader.getTopic()); 15 topicRouteData.setOrderTopicConf(orderTopicConf); 16 17 byte[] content = topicRouteData.encode(); 18 response.setBody(content); 19 response.setCode(ResponseCode.SUCCESS); 20 response.setRemark(null); 21 return response; 22 } 23 24 response.setCode(ResponseCode.TOPIC_NOT_EXIST); 25 response.setRemark("No topic route info in name server for the topic: " + requestHeader.getTopic() 26 + FAQUrl.suggestTodo(FAQUrl.APPLY_TOPIC_URL)); 27 return response; 28 }
可以看到是通过RouteInfoManager的pickupTopicRouteData方法获取某个topic的broker信息，如果没有则提示没有该topic匹配的broker。看看在pickupTopicRouteData方法中的实现：
1public TopicRouteData pickupTopicRouteData(final String topic) { 2 TopicRouteData topicRouteData = new TopicRouteData(); 3 boolean foundQueueData = false; 4 boolean foundBrokerData = false; 5 Set<String> brokerNameSet = new HashSet<String>(); 6 List<BrokerData> brokerDataList = new LinkedList<BrokerData>(); 7 topicRouteData.setBrokerDatas(brokerDataList); 8 9 HashMap<String, List<String>> filterServerMap = new HashMap<String, List<String>>(); 10 topicRouteData.setFilterServerTable(filterServerMap); 11 12 try { 13 try { 14 this.lock.readLock().lockInterruptibly(); 15 List<QueueData> queueDataList = this.topicQueueTable.get(topic); 16 if (queueDataList != null) { 17 topicRouteData.setQueueDatas(queueDataList); 18 foundQueueData = true; 19 20 // BrokerName去重 21 Iterator<QueueData> it = queueDataList.iterator(); 22 while (it.hasNext()) { 23 QueueData qd = it.next(); 24 brokerNameSet.add(qd.getBrokerName()); 25 } 26 27 for (String brokerName : brokerNameSet) { 28 BrokerData brokerData = this.brokerAddrTable.get(brokerName); 29 if (null != brokerData) { 30 BrokerData brokerDataClone = new BrokerData(); 31 brokerDataClone.setBrokerName(brokerData.getBrokerName()); 32 brokerDataClone.setBrokerAddrs((HashMap<Long, String>) brokerData 33 .getBrokerAddrs().clone()); 34 brokerDataList.add(brokerDataClone); 35 foundBrokerData = true; 36 37 // 增加Filter Server 38 for (final String brokerAddr : brokerDataClone.getBrokerAddrs().values()) { 39 List<String> filterServerList = this.filterServerTable.get(brokerAddr); 40 filterServerMap.put(brokerAddr, filterServerList); 41 } 42 } 43 } 44 } 45 } 46 finally { 47 this.lock.readLock().unlock(); 48 } 49 } 50 catch (Exception e) { 51 log.error("pickupTopicRouteData Exception", e); 52 } 53 54 if (log.isDebugEnabled()) { 55 log.debug("pickupTopicRouteData {} {}", topic, topicRouteData); 56 } 57 58 if (foundBrokerData && foundQueueData) { 59 return topicRouteData; 60 } 61 62 return null; 63 }
可以看到当前namesrv的filterServerTable中获取了某个broker的filtersrv列表，并且整个信息是封装在TopicRouteData返回给client查找的请求，那么client端拿到的TopicRouteData里面就包含了filtersrv列表，那么接下来看看client怎么来处理这些filtersrv的。
这里再补充一下，其实只有consumer才会需要filtersrv，所以只有consumer端才会利用这个信息，而producer不会对这些信息。而consumer通过topic获取filtersrv的方式是先同步获取一次，后面还会有定时器定时发起查询topic的broker信息。这里如果有兴趣可以看看MQClientInstance的updateTopicRouteInfoFromNameServer方法，定时调用是在 startScheduledTask方法触发，而这个方法是在消费端start的时候，而一次同步触发是在触发订阅某个topic的方法时候。
下面需要看看consumer如何利用TopicRouteData实体处理filtersrv集合的。
##Consumer如何处理filtersrv的
###consumer如何将本地的MessageFilter同步到filtersrv
我们知道执行MessageFilter实现逻辑是在filtersrv，那要怎么告诉filtersrv呢？同样也是需要递归namesrv返回的TopicRouteData中filtersrv地址列表，将信息同步到filtersrv中。
这部分逻辑是在MQClientInstance的sendHeartbeatToAllBrokerWithLock，而这个方法同样也是会有一次同步调用，以及后面会定时出发，和updateTopicRouteInfoFromNameServer方法一样。
由于篇幅问题，这里就不贴代码，感兴趣可以去看看这部分逻辑。
###filtersrv如何处理来自consumer的MessageFilter的实现逻辑
上面说过，RocketMQ处理来自远程的请求是NettyRequestProcessor的子类实现的，filtersrv也不例外，处理它这部分逻辑的是DefaultRequestProcessor。下面看看他的基本实现：
1 @Override 2 public RemotingCommand processRequest(ChannelHandlerContext ctx, RemotingCommand request) 3 throws Exception { 4 if (log.isDebugEnabled()) { 5 log.debug("receive request, {} {} {}",// 6 request.getCode(), // 7 RemotingHelper.parseChannelRemoteAddr(ctx.channel()), // 8 request); 9 } 10 11 switch (request.getCode()) { 12 case RequestCode.REGISTER_MESSAGE_FILTER_CLASS: 13 return registerMessageFilterClass(ctx, request); 14 case RequestCode.PULL_MESSAGE: 15 return pullMessageForward(ctx, request); 16 } 17 18 return null; 19 }
可以看到它这里只处理两种请求，一种是注册MessageFilter实现类的，另一个则是consumer发起的拉去消息，这就是为什么 MessageFilter只能处理来自消费端的请求了。处理注册MessageFilter实现类是方法registerMessageFilterClass，最终会在FilterClassManager动态编译来自consumer的java源码生成一个MessageFilter的类对象，然后反射生成对象。具体逻辑如下：
1public boolean registerFilterClass(final String consumerGroup, final String topic, 2 final String className, final int classCRC, final byte[] filterSourceBinary) { 3 final String key = buildKey(consumerGroup, topic); 4 5 // 先检查是否存在，是否CRC相同 6 boolean registerNew = false; 7 FilterClassInfo filterClassInfoPrev = this.filterClassTable.get(key); 8 if (null == filterClassInfoPrev) { 9 registerNew = true; 10 } 11 else { 12 if (this.filtersrvController.getFiltersrvConfig().isClientUploadFilterClassEnable()) { 13 if (filterClassInfoPrev.getClassCRC() != classCRC && classCRC != 0) { 14 registerNew = true; 15 } 16 } 17 } 18 19 // 注册新的Class 20 if (registerNew) { 21 synchronized (this.compileLock) { 22 filterClassInfoPrev = this.filterClassTable.get(key); 23 if (null != filterClassInfoPrev && filterClassInfoPrev.getClassCRC() == classCRC) { 24 return true; 25 } 26 27 try { 28 29 FilterClassInfo filterClassInfoNew = new FilterClassInfo(); 30 filterClassInfoNew.setClassName(className); 31 filterClassInfoNew.setClassCRC(0); 32 filterClassInfoNew.setMessageFilter(null); 33 34 if (this.filtersrvController.getFiltersrvConfig().isClientUploadFilterClassEnable()) { 35 String javaSource = new String(filterSourceBinary, MixAll.DEFAULT_CHARSET); 36 Class<?> newClass = DynaCode.compileAndLoadClass(className, javaSource); 37 Object newInstance = newClass.newInstance(); 38 filterClassInfoNew.setMessageFilter((MessageFilter) newInstance); 39 filterClassInfoNew.setClassCRC(classCRC); 40 } 41 42 this.filterClassTable.put(key, filterClassInfoNew); 43 } 44 catch (Throwable e) { 45 String info = 46 String 47 .format( 48 "FilterServer, registerFilterClass Exception, consumerGroup: %s topic: %s className: %s", 49 consumerGroup, topic, className); 50 log.error(info, e); 51 return false; 52 } 53 } 54 } 55 56 return true; 57 }
那么这里就有问题需要注意了。由于MessageFilter是在Consumer端实现的，如果在实现类中用了第三方的api，并且在filtersrv中不存在，那么将会导致传输到filtersrv的java源码无法编译，如果需要能够编译通过，需要将该第三方api的jar包也放到filtersrv的classpath下面。同时还需要注意的是，你的实现类不能有包名，不然也会导致编译不通过。个人觉得这部分实现有点粗糙，我还是第一次看到将java源码传输到远程服务编译再执行的，这部分实现欠妥。
##Consumer如何触发filtersrv
###Consumer“狸猫换太子”
上面说了那么多，这里就要回到重点，消费端获取消息的时候怎么触发filtersrv呢？其实为了将filtersrv整合到Consumer感觉对RocketMQ的改动还是比较大的，在PullApiWrapper中的方法pullKernelImpl有调用computPullFromWhichFilterServer类，不妨看看这两个方法的实现：
1 public PullResult pullKernelImpl(// 2 final MessageQueue mq,// 1 3 final String subExpression,// 2 4 final long subVersion,// 3 5 final long offset,// 4 6 final int maxNums,// 5 7 final int sysFlag,// 6 8 final long commitOffset,// 7 9 final long brokerSuspendMaxTimeMillis,// 8 10 final long timeoutMillis,// 9 11 final CommunicationMode communicationMode,// 10 12 final PullCallback pullCallback// 11 13 ) throws MQClientException, RemotingException, MQBrokerException, InterruptedException { 14 ......... 15 16 String brokerAddr = findBrokerResult.getBrokerAddr(); 17 if (PullSysFlag.hasClassFilterFlag(sysFlagInner)) { 18 brokerAddr = computPullFromWhichFilterServer(mq.getTopic(), brokerAddr); 19 } 20 21 PullResult pullResult = this.mQClientFactory.getMQClientAPIImpl().pullMessage(// 22 brokerAddr,// 23 requestHeader,// 24 timeoutMillis,// 25 communicationMode,// 26 pullCallback); 27 28 return pullResult; 29 } 30 31 throw new MQClientException("The broker[" + mq.getBrokerName() + "] not exist", null); 32 } 33 34 35 36private String computPullFromWhichFilterServer(final String topic, final String brokerAddr) 37 throws MQClientException { 38 ConcurrentHashMap<String, TopicRouteData> topicRouteTable = this.mQClientFactory.getTopicRouteTable(); 39 if (topicRouteTable != null) { 40 TopicRouteData topicRouteData = topicRouteTable.get(topic); 41 List<String> list = topicRouteData.getFilterServerTable().get(brokerAddr); 42 43 if (list != null && !list.isEmpty()) { 44 return list.get(randomNum() % list.size()); 45 } 46 } 47 48 throw new MQClientException("Find Filter Server Failed, Broker Addr: " + brokerAddr + " topic: " 49 + topic, null); 50 }
第一个方法主要看参数brokerAddr,发现会判断当前订阅的topic是不是有filtersrv有则会调用computPullFromWhichFilterServer,而这个方法里面则是从当前topic的TopicRouteData中filtersrv的集合中随机获取一个返回并赋给brokerAddr，那么此时请求的不是broker了，而是filtersrv，于是你也就不奇怪为什么在filtersrv的DefaultRequestProcessor里面会处理拉去消息的请求了。这里就很容易理解在consumer端对filtersrv的处理，其实就是“狸猫换太子”的方式。
###filtersrv反向代理
为了看清楚在consumer“狸猫换太子”之后filtersrv是如何处理的，所以还需要看看filtersrv如何处理来自consumer获取消息的。这就需要看看DefaultRequestProcessor的pullMessageForward方法
1private RemotingCommand pullMessageForward(final ChannelHandlerContext ctx, final RemotingCommand request) 2 throws Exception { 3 final RemotingCommand response = 4 RemotingCommand.createResponseCommand(PullMessageResponseHeader.class); 5 final PullMessageResponseHeader responseHeader = 6 (PullMessageResponseHeader) response.readCustomHeader(); 7 final PullMessageRequestHeader requestHeader = 8 (PullMessageRequestHeader) request.decodeCommandCustomHeader(PullMessageRequestHeader.class); 9 10 // 由于异步返回，所以必须要设置 11 response.setOpaque(request.getOpaque()); 12 13 DefaultMQPullConsumer pullConsumer = this.filtersrvController.getDefaultMQPullConsumer(); 14 final FilterClassInfo findFilterClass = 15 this.filtersrvController.getFilterClassManager().findFilterClass( 16 requestHeader.getConsumerGroup(), requestHeader.getTopic()); 17 if (null == findFilterClass) { 18 response.setCode(ResponseCode.SYSTEM_ERROR); 19 response.setRemark("Find Filter class failed, not registered"); 20 return response; 21 } 22 23 if (null == findFilterClass.getMessageFilter()) { 24 response.setCode(ResponseCode.SYSTEM_ERROR); 25 response.setRemark("Find Filter class failed, registered but no class"); 26 return response; 27 } 28 29 responseHeader.setSuggestWhichBrokerId(MixAll.MASTER_ID); 30 31 // 构造从Broker拉消息的参数 32 MessageQueue mq = new MessageQueue(); 33 mq.setTopic(requestHeader.getTopic()); 34 mq.setQueueId(requestHeader.getQueueId()); 35 mq.setBrokerName(this.filtersrvController.getBrokerName()); 36 long offset = requestHeader.getQueueOffset(); 37 int maxNums = requestHeader.getMaxMsgNums(); 38 39 final PullCallback pullCallback = new PullCallback() { 40 41 @Override 42 public void onSuccess(PullResult pullResult) { 43 responseHeader.setMaxOffset(pullResult.getMaxOffset()); 44 responseHeader.setMinOffset(pullResult.getMinOffset()); 45 responseHeader.setNextBeginOffset(pullResult.getNextBeginOffset()); 46 response.setRemark(null); 47 48 switch (pullResult.getPullStatus()) { 49 case FOUND: 50 response.setCode(ResponseCode.SUCCESS); 51 52 List<MessageExt> msgListOK = new ArrayList<MessageExt>(); 53 try { 54 for (MessageExt msg : pullResult.getMsgFoundList()) { 55 boolean match = findFilterClass.getMessageFilter().match(msg); 56 if (match) { 57 msgListOK.add(msg); 58 } 59 } 60 61 // 有消息返回 62 if (!msgListOK.isEmpty()) { 63 returnResponse(requestHeader.getConsumerGroup(), requestHeader.getTopic(), ctx, 64 response, msgListOK); 65 return; 66 } 67 // 全部都被过滤掉了 68 else { 69 response.setCode(ResponseCode.PULL_RETRY_IMMEDIATELY); 70 } 71 } 72 // 只要抛异常，就终止过滤，并返回客户端异常 73 catch (Throwable e) { 74 final String error = 75 String.format("do Message Filter Exception, ConsumerGroup: %s Topic: %s ", 76 requestHeader.getConsumerGroup(), requestHeader.getTopic()); 77 log.error(error, e); 78 79 response.setCode(ResponseCode.SYSTEM_ERROR); 80 response.setRemark(error + RemotingHelper.exceptionSimpleDesc(e)); 81 returnResponse(requestHeader.getConsumerGroup(), requestHeader.getTopic(), ctx, 82 response, null); 83 return; 84 } 85 86 break; 87 case NO_MATCHED_MSG: 88 response.setCode(ResponseCode.PULL_RETRY_IMMEDIATELY); 89 break; 90 case NO_NEW_MSG: 91 response.setCode(ResponseCode.PULL_NOT_FOUND); 92 break; 93 case OFFSET_ILLEGAL: 94 response.setCode(ResponseCode.PULL_OFFSET_MOVED); 95 break; 96 default: 97 break; 98 } 99 100 returnResponse(requestHeader.getConsumerGroup(), requestHeader.getTopic(), ctx, response, 101 null); 102 } 103 104 105 @Override 106 public void onException(Throwable e) { 107 response.setCode(ResponseCode.SYSTEM_ERROR); 108 response.setRemark("Pull Callback Exception, " + RemotingHelper.exceptionSimpleDesc(e)); 109 returnResponse(requestHeader.getConsumerGroup(), requestHeader.getTopic(), ctx, response, 110 null); 111 return; 112 } 113 }; 114 115 pullConsumer.pullBlockIfNotFound(mq, null, offset, maxNums, pullCallback); 116 117 return null; 118 } 119
你会发现在filtersrv中也有一个DefaultMQPullConsumer，你是否明白了？其实这个时候filtersrv自己也是一个消费端，替consumer请求它所需要的topic的消息，你是否和nginx，apache或者f5这类反向代理对应上了呢？其实filtersrv其实就是一层夹在broker和consumer之间的代理。
最后还有一个重点没说，说了半天的MessageFilter,它应该在哪里发挥作用呢？看到方法pullMessageForward方法中匿名类PullCallback没？在它的onSuccess方法FOUND情况下会调用MessageFilter的match方法将当前返回给消息进行一次过滤。
这里需要注意一点的是，这个MessageFilter不能拿来做负载，因为如果通过MessageFilter的match过滤之后，对于broker来说，过滤掉的消息是已经消费掉的，其他的消费者是无法再消费的（消息模式为CLUSTERING）。那这个MessageFilter还有什么用呢？可以简单理解为他就是一个过滤器！过滤消费端感兴趣的数据。我这里列举一个实例：
比如当前消息模式是BROADCASTING，由于该模式同一个组的消费者，每条消息都会收到，可能订阅这个topic的消费端不是对所有的消息都感兴趣，那么就有必要加一个过滤器将该消费者感兴趣的数据提供才传给该消费者。这样从通信成本来说会相对减少，因为按照常规filtersrv将会和broker部署在一起，那么它们之间的传输比和consumer之间的传输成本肯定低。
上面对filtersrv在namesrv，broker和consumer中的体现进行了介绍和讨论，那么加入filtersrv之后，整个通信图会是怎么样呢？下图给出了有了filtersrv之后，该是怎么样的情况。
