JMS点对点编程

介绍 第 1 页（共10 页）

在这一节中，我们将分析两个进行点对点消息接发的程序—— QSender.java 和 QReceiver.java。

我们将在一些小节中分析代码并描述每一小节的功能。可以在附录中查看完整的小节清单：QSender.java 的代码清单 和 QReceiver.java 的代码清单。

QSender：提示输入 JNDI 名称 第 2 页（共10 页）


这两个示例程序都是命令行程序， 用 System.in 输入、用 System.out 输出。

QSender 类有两个方法：main(String[]) 和 send()。main(String[]) 方法只举例说明了 QSender ，并调用了它的 send() 方法。

send() 方法的第一部分提示输入用来发送消息受管理对象的 JNDI 的名称。


import java.io.*;
import javax.jms.*;
import javax.naming.*;

public class QSender {

public static void main(String[] args) {

new QSender().send();
}

public void send() {

BufferedReader reader = new BufferedReader(new InputStreamReader(System.in));

try {
//Prompt for JNDI names
System.out.println("Enter QueueConnectionFactory name:");
String factoryName = reader.readLine();
System.out.println("Enter Queue name:");
String queueName = reader.readLine();
. . .


QSender查找管理对象 第 3 页（共10 页）


send() 方法的第二部分用前面输入的名字在 JNDI 中查找受管理的对象。

通过举例说明 InitialContext 对象访问 JNDI，通过调用lookup(String) 方法并传递要获取的对象的名字来检索受管理的对象。注意， lookup(String) 方法返回的是 Object，所以必须对返回的对象进行类型强制转换。


. . .
//Look up administered objects
InitialContext initContext = new InitialContext();
QueueConnectionFactory factory =
(QueueConnectionFactory) initContext.lookup(factoryName);
Queue queue = (Queue) initContext.lookup(queueName);
initContext.close();
. . .

QSender：创建 JMS 对象 第 4 页（共10 页）


现在，我们已创建了发送消息所需要的 JMS 对象。注意，我们没有用 new 直接举例说明这些对象。所有对象都是通过调用另一个对象的方法创建的。

首先，用 QueueConnectionFactory 创建 QueueConnection。然后用 QueueConnection 创建一个 QueueSession。

QueueSession 不是经过处理的（false），并且它将使用自动确认 （Session.AUTO_ACKNOWLEDGE）。

最后，创建 QueueSender 将信息发送到从 JNDI 中检索的 Queue 发送消息。


. . .
//Create JMS objects
QueueConnection connection = factory.createQueueConnection();
QueueSession session =
connection.createQueueSession(false, Session.AUTO_ACKNOWLEDGE);
QueueSender sender = session.createSender(queue);
. . .


QSender：发送消息 第 5 页（共10 页）


现在就可以发送消息了。在这一部分中，我们进入一个循环，该循环提示我们要发送的消息的文本。如果用户输入 quit，则退出循环。

否则要在输入的文本中建立一个 TextMessage ，并用 QueueSender 发送消息，然后返回循环的开始部分。


. . .
//Send messages
String messageText = null;
while (true) {
System.out.println("Enter message to send or 'quit':");
messageText = reader.readLine();
if ("quit".equals(messageText))
break;
TextMessage message = session.createTextMessage(messageText);
sender.send(message);
}
. . .

QSender：退出 第 6 页（共10 页）


退出循环后，关闭 QueueConnection。关闭 QueueConnection 会自动关闭 QueueSession 和 QueueSender。


. . .
//Exit
System.out.println("Exiting...");
reader.close();
connection.close();
System.out.println("Goodbye!");

} catch (Exception e) {
e.printStackTrace();
System.exit(1);
}
}
}


QReceiver提示输入 JNDI 名称并查找受管理的对象 第 7 页（共10 页）


QReceiver 类与 QSender 类非常类似，都有一个 main(String[]) 方法，它只举例说明 QReceiver 并调用了它的主要方法 receive()。

提示输入 JNDI 名字并查找受管理对象的代码与 QSender 中的代码完全一样。

不过，在这个类中有两处不一样的地方：

boolean stop 实例变量被用来指出程序应该退出。


QReceiver 可以实现 MessageListener 接口来异步接收消息。


import java.io.*;
import javax.jms.*;
import javax.naming.*;

public class QReceiver implements MessageListener {

private boolean stop = false;

public static void main(String[] args) {

new QReceiver().receive();
}

public void receive() {

BufferedReader reader = new BufferedReader(new InputStreamReader(System.in));

try {
//Prompt for JNDI names
System.out.println("Enter QueueConnectionFactory name:");
String factoryName = reader.readLine();
System.out.println("Enter Queue name:");
String queueName = reader.readLine();
reader.close();

//Look up administered objects
InitialContext initContext = new InitialContext();
QueueConnectionFactory factory =
(QueueConnectionFactory) initContext.lookup(factoryName);
Queue queue = (Queue) initContext.lookup(queueName);
initContext.close();
. . .


QReceiver：创建 JMS 对象 第 8 页（共10 页）


像在 QSender 中那样创建 QueueConnection 和 QueueSession，然后创建一个 QueueReceiver。

接着，调用 setMessageListener()，传递 QReceiver 的本地实例 this，我们将重调它来实现 MessageListener 接口。

最后，启动 QueueConnection 来接收消息。


. . .
//Create JMS objects
QueueConnection connection = factory.createQueueConnection();
QueueSession session =
connection.createQueueSession(false, Session.AUTO_ACKNOWLEDGE);
QueueReceiver receiver = session.createReceiver(queue);
receiver.setMessageListener(this);
connection.start();
. . .


QReceiver：等待 stop 并退出 第 9 页（共10 页）


接着，程序进入一个循环，它会在 stop 变量变为 true 时退出循环。在循环中，线程睡眠一秒钟。一旦退出循环， QueueConnection 就会退出，并且程序也会终止。


. . .
//Wait for stop
while (!stop) {
Thread.sleep(1000);
}

//Exit
System.out.println("Exiting...");
connection.close();
System.out.println("Goodbye!");

} catch (Exception e) {
e.printStackTrace();
System.exit(1);
}
}
. . .

QReceiver：onMessage(Message) 方法 第 10 页（共10 页）


需要包含 QReceiver 类的 onMessage(Message) 方法，因为 QReceiver 可以实现 MessageListener 接口。

接收消息时，就调用这个方法，并将 Message 作为参数传递。

在这个实现中，我们获得了消息的文本内容，并将它打印到 System.out。然后，检查消息是否等于 stop，如果是，则将 stop 变量设置为 true，这会使 receive() 方法中的循环终止。


. . .
public void onMessage(Message message) {

try {
String msgText = ((TextMessage) message).getText();
System.out.println(msgText);
if ("stop".equals(msgText))
stop = true;
} catch (JMSException e) {
e.printStackTrace();
stop = true;
}
}
}