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 页）



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

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

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

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