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;
        }
    }
}