JMS用公用接口进行客户机编程

绍 第 1 页（共11 页）


在这一节中，我们将查看两个进行 JMS 客户机消息接发的程序——Sender.java 和 Receiver.java。

我们将按小节分析代码并描述每小节的作用。可以在附录中看到完整的清单：Sender.java 的代码清单 和 Receiver.java 的代码清单。
Sender：提示输入 JNDI 名 第 2 页（共11 页）


所有示例程序都是命令行程序，它们用 System.in 进行输入，用System.out 进行输出。

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

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


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

public class Sender {

public static void main(String[] args) {

new Sender().send();
}

public void send() {

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

try {
//Prompt for JNDI names
System.out.println("Enter ConnectionFactory name:");
String factoryName = reader.readLine();
System.out.println("Enter Destination name:");
String destinationName = reader.readLine();
。。。。。。。。。。。
Sender：查询管理对象 第 3 页（共11 页）


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

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

Sender：创建 JMS 对象 第 4 页（共11 页）


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

首先，用 ConnectionFactory 创建一个 Connection。然后我们用这个 Connection 创建一个 Session。

Session 没有被处理（false） 并且它将使用自动确认（Session.AUTO_ACKNOWLEDGE）。

最后，创建 Sender ，向从 JNDI 中检索的 Destination 发送消息。


. . .
//Create JMS objects
Connection connection = factory.createConnection();
Session session =
connection.createSession(false, Session.AUTO_ACKNOWLEDGE);
MessageProducer sender = session.createProducer(destination);
. . .


. . .
//Look up administered objects
InitialContext initContext = new InitialContext();
ConnectionFactory factory =
(ConnectionFactory) initContext.lookup(factoryName);
Destination destination = (Destination) initContext.lookup(destinationName);
initContext.close();
. . .

Sender：发送消息 第 5 页（共11 页）


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

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


. . .
//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);
}
. . .

Sender：退出 第 6 页（共11 页）


退出循环后，关闭 Connection。关闭Connection 会自动关闭 Session 和 MessageProducer。


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

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

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


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

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

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

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


Receiver 实现了 MessageListener 接口，为了异步接收消息。


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

public class Receiver implements MessageListener {

private boolean stop = false;

public static void main(String[] args) {

new Receiver().receive();
}

public void receive() {

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

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

//Look up administered objects
InitialContext initContext = new InitialContext();
ConnectionFactory factory =
(ConnectionFactory) initContext.lookup(factoryName);
Destination destination = (Destination) initContext.lookup(destinationName);
initContext.close();
. . .

Receiver：创建 JMS 对象 第 8 页（共11 页）


像在 Sender 中那样创建Connection 和 Session，然后创建一个 MessageConsumer。

接着，调用 setMessageListener()，传递 Receiver ——本地实例 this，您会重调用它来实现 MessageListener 接口。

最后，启动 Connection，允许接收消息。


. . .
//Create JMS objects
Connection connection = factory.createConnection();
Session session =
connection.createSession(false, Session.AUTO_ACKNOWLEDGE);
MessageConsumer receiver = session.createConsumer(queue);
receiver.setMessageListener(this);
connection.start();
. . .


Receiver：等待 stop 并退出 第 9 页（共11 页）


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


. . .
//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);
}
}
. . .


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


需要包含 Receiver 类的 onMessage(Message) 方法，因为 Receiver 可以实现 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;
}
}
}


返回程序 第 11 页（共11 页）


[url]http://www6.software.ibm.com/developerworks/cn/education/java/j-jms/tutorial/j-jms-1-1.html[/url]
如 开始 中所述，编译 Sender 和 Receiver 程序需要 javax.naming 和 javax.jms 包。

在运行这个程序之前，需要使用 JMS 提供者提供的管理工具创建受管理对象 ConnectionFactory 和 Destination ，并将它们放到 JNDI 名字空间中。

还需要保证提供者的 JMS 实现类存在于 classpath 中。

然后，可以同时运行这两个程序，为 ConnectionFactory 和 Destination 提供同样的 JNDI 名称，并从 Sender 向 Receiver 发送消息。