JMS - 事务性消息

JMS 事务遵从发送操作与接收操作相互分离的约定。下图显示的是一个事务性发送，其中一组消息要么能够保证全部到达消息服务器，要么连一条消息也不能保证到达消息服务器。从发送者的角度来看，JMS 提供者为这组消息提供了高速缓存，直到执行 commit() 为止。如果发生了故障，或者执行了 rollback()，这些消息就会丢弃。在一个事务中传送给消息服务器的消息，它并不会转发给消费者，知道该生产者提交该事务为止。

生产者在会话上发布 commit() 之前，JMS 提供者不会开始向它的消费者传送消息，即使它已经从发送者处接收到所有的消息。JMS 事务的范围能够包括任意数量的消息。虽然会话 commit() 和 JTA(Java Transaction API) 事务 commit() 在概念上类似，但是二者并不相同。会话事务是由 JMS 提供者管理的，而不是由 JTA 管理的。

JMS 还支持事务性接收，消费者正在接收一组事务性消息，而且要么全部接收，要么一条也不接收，参考下图。从事务性接收者的角度来看，这些消息会尽可能快地传送给接收者，但是它们一直由 JMS 提供者保存，直到接收者在会话对象上执行 commit() 为止。如果发送了故障，或者执行 rollback()，提供者会试图重新传送消息，在这种情况下，这些消息就会设置重新传送标记。

发送消息，如果在发送消息的方法正常完成后没有调用 Session.commit() 方法，JMS 提供者会从队列中删除这些消息，而这些消息并没有传送给消息消费者。接收消息时，如果在接收消息的方法正常完成后没有调用 Session.commit() 方法，消息就会被标记为未被传送。JMS 提供者会把这些消息重新传送给消息消费者，并将 JMSRedelivered 消息头属性设置为 true，表示此前曾试图处理过这些消息。因此在这两种情况下，都必须注意：要确保在该方法结束之前，提交会话或将其回滚。

Sample Code:

// ...
Connection connection = null;
Session session = null;
try {
    Context ctx = new InitialContext();
    ConnectionFactory connFactory = (ConnectionFactory) ctx.lookup("connectionFactory");
    connection = connFactory.createConnection();
    connection.start();

    // 创建会话对象实例，第一个参数表示会话是否是启用事务
    session = connection.createSession(true, Session.AUTO_ACKNOWLEDGE);

    Destination destination = (Destination) ctx.lookup("HelloQueue");
    MessageProducer msgProducer = session.createProducer(destination);
    Message textMsg = session.createTextMessage("This is a test message.");
    msgProducer.send(textMsg);

    // 提交事务
    session.commit();
    System.out.println("send the message successfully");
} catch (Exception e) {
    if (session != null) {
        try {
            // 回滚事务
            session.rollback();
        } catch (JMSException jmse) {
            jmse.printStackTrace();
        }
    }
    e.printStackTrace();
} finally {
    JMSUtils.closeConnection(connection);
}
// ...