JBoss 系列五十九：jBPM Human Task 源代码分析 - II

概述

jbpm human task 源代码分析 - I中为执行jbpm human task服务器端的代码，本文集中与执行human task时客户端如何连接到服务器，进行与服务器交互，jBPM 5执行human task是与服务器通信可以使用三种方式：

• hornetq
• mina
• jms

jbpm human task 源代码分析 - I中是使用jms，本文客户端代码分析也使用jms，所设计到的类注意包括JMSTaskClientConnector，JMSTaskClientHandler等。

org.jbpm.task.service.jms.JMSTaskClientConnector

org.jbpm.task.service.TaskClientConnector接口定义了客户端连接到human task服务器端的方法，接口中定义了如下方法：

public boolean connect();public boolean connect(String address, int port);public void disconnect() throws Exception;public void write(Object message);public BaseHandler getHandler();public String getName();public AtomicInteger getCounter();

connect方法供客户端连接到服务器，disconnect()方法供客户端断开到服务器的连接，write(Object message)想服务器端发送消息，如果使用JMS则发送JMS消息到服务器端消息队列，getHandler()方法获取连接处理器，getName()方法获取连接的名字。org.jbpm.task.service.jms.JMSTaskClientConnector实现了org.jbpm.task.service.TaskClientConnector接口，用来提供jms做为传输方式时的实现，相关类图如下：

connect()初始化JMS发送消息相关的Session，Producer等，顺序大致如下：

通过JNDI查询获取QueueConnectionFactory，通过QueueConnectionFactory创建QueueConnection，通过QueueConnection创建QueueSession，通过QueueSession创建MessageProducer，如果以上过程成功返回true。相关代码段如下：

QueueConnectionFactory factory = (QueueConnectionFactory) ctx.lookup(connFactoryName);this.connection = factory.createQueueConnection();this.producerSession = this.connection.createQueueSession(transactedQueue, acknowledgeMode);this.consumerSession = this.connection.createQueueSession(transactedQueue, acknowledgeMode);this.taskServerQueue = this.producerSession.createQueue(taskServerQueueName);this.responseQueue = this.consumerSession.createQueue(responseQueueName);this.producer = this.producerSession.createProducer(this.taskServerQueue);this.connection.start();return true;

org.jbpm.task.service.jms.JMSTaskClientConnector提供了一个构造方法如下：

public JMSTaskClientConnector(String name, BaseClientHandler handler, Properties connectionProperties, Context context) {if (name == null) {throw new IllegalArgumentException("Name can not be null");}this.name = name;this.handler = handler;this.connectionProperties = connectionProperties;this.context = context;this.counter = new AtomicInteger();if(System.getProperty("enableLog") != null)this.enableLog = Boolean.parseBoolean(System.getProperty("enableLog"));}

构造方法中：

• name - 定义了TaskClientConnector的名字
• handler - 定义客户端连接处理器
• connectionProperties - 定义初始化JMS发送消息相关的Session，Producer等参数，如队列名字等
• context - 定义JNDI的上下文

org.jbpm.task.service.jms.JMSTaskClientHandler

JMSTaskClientConnector构造方法中需要传入客户端连接处理器JMSTaskClientHandler，这里我们分析该类，首先给出类图，如下：

org.jbpm.task.service.BaseHandler定义了一个方法：

public void addResponseHandler(int id, ResponseHandler responseHandler);

org.jbpm.task.service.BaseClientHandler实现了BaseHandler，BaseClientHandler中定义了Map<Integer, ResponseHandler> responseHandlers，并在构造方法中初始化，addResponseHandler()方法的实现是将ResponseHandler添加到Map中，BaseClientHandler代码如下：

protected Map<Integer, ResponseHandler> responseHandlers;public BaseClientHandler() {responseHandlers = new HashMap<Integer, ResponseHandler>();}public void addResponseHandler(int id, ResponseHandler responseHandler) {responseHandlers.put( id, responseHandler );}

JMSTaskClientHandler的messageReceived方法如下：

public void messageReceived(Session session, Object message, Destination destination, String selector) throws Exception {String name = "";if (destination instanceof Queue) {name = ((Queue) destination).getQueueName();} else if (destination instanceof Topic) {name = ((Topic) destination).getTopicName();}MessageProducer producer = (MessageProducer) this.producers.get(name);if (producer == null) {producer = session.createProducer(destination);this.producers.put(name, producer);}this.handler.messageReceived(new JMSSessionWriter(session, producer, selector), message);}