java jms例子_JMS 教程 学习笔记 （九）JMS 样例代码

本章给出了一些展示JMS 客户端如何使用JMS API

的代码样例。也解释了如何使用几个消息类型。这些例子使用了支持统一消息模型的方法：这些例子使用点对点或发布/订阅进行工作。用JMS

API 进行工作是推荐的方式。

在JMS

规范的早期版本中，只支持消息域(点对点或发布/订阅)各自的接口，且客户端要么使用点对点要么使用发布/订阅来进行编程。现在，JMS

客户端可以使用JMS 公共接口进行编程。

在例子中，客户端应用发送和接收股票报价信息。客户端应用从股票报价服务中接收消息。股票报价服务在这个例子中没有描述。

为了简化这个例子，没有对异常进行处理。本章描述了为发送和接收消息而创建正确环境的步骤。在描述了基本的功能后，本章描述如何执行一些其他的公共功能，例如使用消息选择器。

准备发送和接收消息

下面是建立连接然后准备发送和接收消息的基本步骤。

􀁺 获得 ConnectionFactory 和Destination。

􀁺 创建 Connection 和Session。

􀁺 创建 MessageConsumer。

􀁺 创建 MessageProducer。

获取

ConnectionFactory

消息生产者和消息消费者(发送者和接收者)都需要得到ConnectionFactory，并使用它

来建立Connection 和Session。

通常，管理员已经为JMS

客户端创建和配置好了ConnectionFactory。客户端程序通常使用JNDI API

来查找ConnectionFactory。

import javax.naming.*;

import javax.jms.*;

ConnectionFactory connectionFactory;

Context messaging = new InitialContext();

connectionFactory = (ConnectionFactory)

messaging.lookup("ConnectionFactory");

获取 Destination

管理员已经创建和配置了一个名字为“StockQueue”的Queue，它是股票报价消息被发送和接收的地方。同样，可以使用JNDI

API 来查找目的地。

Queue stockQueue;

stockQueue =

(Queue)messaging.lookup("StockSource");

创建 Connection

在得到ConnectionFactory

之后，客户端程序使用它来创建Connection。Connection connection;

connection =

ConnectionFactory.createConnection();

创建 Session

在得到Connection

之后，客户端程序使用它来创建Session。这个Session

用于创建MessageProducer(发送消息)或MessageConuser(接收消息)。

Connection.createSession 方法有两个参数：

􀁺 1：一个表示会话是否是事务性的布尔。

􀁺 2：消息确认模式。

Session session;

session = connection.createSession(false,

Session.AUTO_ACKNOWLEDGE);

创建

MessageProducer

在得到Session 后， 客户端程序使用Session

来创建MessageProducer 。这个MessageProducer

对象用于向目的地发送消息。通过使用Session.createProducer

方法来创建MessageProducer，参数是消息被发送的目的地。

MessageProducer sender;

sender =

session.createProducer(stockQueue);

创建

MessageConsumer

消息可以被同步或异步的消费。这个例子展示了如何创建同步消费消息的消息消费者。

MessageConsumer

用于从目的地接收消息，在这个例子中是“StockQueue”。用Session.createConsumer

方法来创建MessageConsumer，参数是接收消息的目的地。

MessageConsumer

receiver;

receiver =

session.createConsumer(stockQueue);

启动消息转发

到现在为止，消息的转发还是被禁止的，以便前面的设置不会被异步转发的消息打断。

现在设置已经完成，可以告诉Connection 开始向MessageConsumer 转发消息了。

connection.start();

使用 TextMessage

有几个消息格式。在这个例子中，股票报价消息作为文本串被发送。客户端按文本串读

取和展示这个消息。

下面的代码解释了如何创建这样的消息：

String stockData;

TextMessage message;

message = session.createTextMessage();

message.setText(stockData);

发送和接收消息

现在已经完成了Session 的设置，你可以发送和接收消息了。本节描述了如何：

􀁺 创建消息

􀁺 发送消息

􀁺 同步接收消息

发送消息

为了发送消息，使用MessageProducer.send 方法，参数是Message 对象。

sender.send(message);

同步接收消息

为了接收Queue

里的消息，你可以使用MessageConsumer.receive 方法。这个方法调用在消息到达Queue

之前可能阻塞。这个方法也可以用于从Topic 中接收消息。

TextMessage

stockMessage;

stockMessage =

(TextMessage)receiver.receive();

为了限制客户端阻塞的时间长度，使用receive

方法的超时参数。如果在超时到期时还没有消息到达，那么receive 方法返回。超时参数按毫秒计时。

TextMessage

stockMessage;

TextMessage =

(TextMessage)receiver.receive(4000);

解包 TextMessage

股票报价信息使用TextMessage

发送。为了从消息中得到这个信息，使用TextMessage.getText 方法。它以字符串返回消息的内容。

String newStockData;

newStockData = message.getText();

其他消息特性

本节不仅提供了基本的消息功能，而且还描述了如何执行某些其他的公共消息功能：

􀁺 创建异步

MessageListener。

􀁺 使用消息选择器过滤消息转发。

􀁺 创建 Topic 的永久订阅。

􀁺 对使用永久订阅的 Topic 进行重新连接。

异步接收消息

为了在消息被转发到消息消费者时异步的接收消息，客户端程序需要创建实现了MessageListener

接口的消息监听器

本例中MessageListener

接口的实现称为StockListener.java，类似于下面的代码：

import

javax.jms.*;

public class StockListener implements MessageListener

{

public void onMessage(Message message) {

...

}

}

客户端程序按下面的方式将这个MessageListener 对象注册到MessageConsumer 对象：

StockListener myListener = new

StockListener();

receiver.setMessageListener(myListener);

Connection 必须被启动以迎接开始的消息转发。当消息被发布到Queue

时会异步的通知MessageListener。这通过MessageListener 接口的onMessage

方法实现。由客户端负责处理消息。

public void onMessage(Message

message)

{

String newStockData;

newStockData = message.getText();

if(...)

{

}

}

使用消息选择器

在这个例子中，客户端程序只对技术相关的股票感兴趣。消息的发送者向消息的属性中设置一个称为StockSector

的属性。它的值包括“Technology”，“Financial”，“Manufacturing”,“Emerging”和“Global”。消息发送者通过使用Message.setStringProperty

方法来设置这些属性值。

String stockData;

TextMessage message;

ConnectionFactory connectionFactory;

Context messaging = new InitialContext();

connectionFactory =

(ConnectionFactory) Messaging.lookup("ConnectionFactory")

Topic newsFeedTopic;

newsFeedTopic = messaging.lookup("BreakingNews");

Connection connection;

Session session;

connection = ConnectionFactory.createConnection();

session = connection.createSession(false,

Session.AUTO_ACKNOWLEDGE);

执行完常规的设置后， 客户端程序可以创建到目的地的永久订阅者。使用

session.createDurableSubscriber

来创建永久TopicSubscriber。名字“mySubscription”用于标

识永久订阅。

session.createDurableSubscriber(newsFeedTopic,"mySubscription");

此时，客户端程序可以启动连接和开始接收消息。

重新连接使用永久订阅的

Topic

为了重新连接一个存在永久订阅的Topic ， 客户端程序可以简单的再次调用

session.createDurableSubscriber，参数和以前的相同。客户端程序可以中断连接。使用永久

订阅可以让从Topic 消费消息的客户端程序始终能够得到消息，即使客户端程序不是持续连

接的。

session.createDurableSubscriber(newsFeedTopic,

"mySubscription");

这将会重新建立客户端程序到Topic 的连接，并且转发客户端断开时到达的消息。但是

需要知道几个重要的限制：

客户端必须使用同一个

Connection。

􀁺 Destination 和订阅的名字必须和以前的一样。

􀁺 如果指定了消息选择器，则它的名字也必须和以前的一样。

如果不能满足这些条件，那么永久订阅被删除，并创建一个新的订阅。

JMS 消息类型

有五个JMS

消息类型。本节提供了如何创建和解包每种消息类型的例子。在每个例子中，在消息中的数据都是与股票报价相关的数据。任何情况下，创建消息真正内容的代码都是可以忽略的。

创建 TextMessage

在这个例子中，股票报价信息作为TextMessgae 被发送。TextMessage 携带了可以被客

户端作为文本字符串读取的消息。

下面的代码解释了如何创建这样的消息：

String

stockData;

TextMessage message;

message = session.createTextMessage();

message.setText(stockData);

解包 TextMessage

为了解包TextMessage，客户端使用Message.getText 方法。

String stockInfo;

stockInfo = message.getText();

创建

BytesMessage

股票报价信息可以以字节格式发送，服务器知道如何构造它，客户端知道如何作为股票报价来解析和展现它。它作为BytesMessage

被发送。

这样的消息可以按下面的方式来构造：

byte[] stockData;

BytesMessage message;

message = session.createBytesMessage();

message.writeBytes(stockData);

解包

BytesMessage

当收到BytesMessage 时，可以按照以下方式来解包：

byte[] stockInfo;

int length;

length = message.readBytes(stockInfo);

消息体被复制到字节数组。客户端程序然后可以开始读和解析数据。

创建 MapMessage

由服务器发送的每个股票消息都可以是不同股票报价名字/值对的映射，使用

MapMessage。例如，它可以包含以下条目：

􀁺 股票订价名称——String

􀁺 当前的值——double

􀁺 订价时间——long

􀁺 最后更新——double

􀁺 股票信息——String

为了构造MapMessage，客户端程序使用不同的与MapMessage

关联的set 方法(setString，setLong 等等)，并在MapMessage 中设置命名的值。

String stockName;

double stockValue;

long stockTime;

double stockDiff;

String stockInfo;

MapMessage message;

message = session.createMapMessage();

注意，下面的设置可以按任何顺序进行：

message.setString("Name", "SUNW");

message.setDouble("Value", stockValue);

message.setLong("Time", stockTime);

message.setDouble("Diff", stockDiff);

message.setString("Info", "Recent server announcement causes market

interest");

解包 MapMessage

为了解包MapMessage，客户端程序使用不同的与MapMessage 相关的get 方法来获取MapMessage

各元素的值。在下面的例子中，客户端程序希望得到某些MapMessage 元素。

String stockName;

double stockValue;

long stockTime;

double stockDiff;

String stockInfo;

通过使用get 方法和提供期望的值的名字从消息中取出的数据。可以按任意顺序从 MapMessage 中得到它的元素。

stockName =

message.getString("Name");

stockDiff = message.getDouble("Diff");

stockValue = message.getDouble("Value");

stockTime = message.getLong("Time");

如果客户端需要得到MapMessage

的元素列表，那么它可以使用MapMessage.getMapNames 方法。

创建

StreamMessage

与MapMessage

类似，应用可以发送由按序写入消息的不同字段组成的消息，每个字段都是原始数据类型。使用StreamMessage

来实现。下面的原始类型赋给股票报价消息的每一项。

股票订价名称——String

􀁺 当前的值——double

􀁺 订价时间——long

􀁺 最后更新——double

􀁺 股票信息——String

客户端可能只对某些消息字段感兴趣，但在使用StreamMessage

的情况下，客户端必须按顺序读并暗地抛弃每个字段。

在下面的例子中，已经设置了下面字段的值：

String stockName;

double stockValue;

long stockTime;

double stockDiff;

String stockInfo;

StreamMessage message;

message = session.createStreamMessage();

下面的元素必须按照它们被读取的顺序写入StreamMessage。注意，它们不是单独命名的属性，和MapMessage

中一样。

message.writeString(stockName);

message.writeDouble(stockValue);

message.writeLong(stockTime);

message.writeDouble(stockDiff);

message.writeString(stockInfo);

解包

StreamMessage

StreamMessage 的元素必须按照写入的顺序被读取。

String stockName;

double stockValue;

long stockTime;

double stockDiff;

String stockInfo;

stockName = message.readString();

stockValue = message.readDouble();

stockTime = message.readLong();

stockDiff = message.readDouble();

stockInfo = message.readString();

创建

ObjectMessage

股票信息可以以特殊的StockObject

对象的形式被发送。这个对象然后作为ObjectMessage 的消息体被发送。ObjectMessage 可以用于发送java

对象。

使用那些StockObject

实现中互不重复的方法来设置这些值。例如，StockObject 可以有

设置不同数据值的方法。使用StockObject 的应用可能看起来类似如下代码：

String stockName;

double stockValue;

long stockTime;

double stockDiff;

String stockInfo;

StockObject stockObject = new StockObject();

stockObject.setName(stockName);

stockObject.setValue(stockValue);

stockObject.setTime(stockTime);

stockObject.setDiff(stockDiff);

stockObject.setInfo(stockInfo);

为了创建ObjectMessage，将StockObject

传入消息，你将按下面的方式来实现：

ObjectMessage message;

message = session.createObjectMessage();

message.setObject(stockObject);

解包

ObjectMessage

为了解包ObjectMessage，使用ObjectMessage.getObject

方法来得到对象。一旦对象被取出，客户端应用使用与对象类型匹配的方法从对象中取出数据。

StockObject stockObject;

stockObject = (StockObject)message.getObject();

String stockName;

double stockValue;

long stockTime;

double stockDiff;

String stockInfo;

stockName = stockObject.getName();

stockValue = stockObject.getValue();

stockTime = stockObject.getTime();

stockDiff = stockObject.getDiff();

stockInfo = stockObject.getInfo();