JMS和Message driven bean【转】

这边对初学者理解JMS和MDB比较有帮助。

JMS（Java Message Service）即消息服务。是由sun公司提出，定义java程序访问企业消息传递系统的接口，是J2EE平台上实现面向消息的中间件的规范。面向消息的中间件系统是一种异步通讯系统。非java平台的面向消息的中间件系统也有很多，比较常见的有IBM的MQSeries,Microsoft的MSMQ。
Message driven bean是EJB2.0规范新增加的一种bean,这样就使EJB框架具备了异步消息通讯机制。Message driven bean在JMS系统中扮演消息的消费者(consumer),也就是消息的监听者，而一个客户端着扮演消息的生产者(productor)即消息的发送者。当一个客户端向一个队列或主题发送一个消息后，EJB容器将调用相应的Message driven bean，对收到的消息进行处理，对bean的调用是自动进行的，所要做的只是把消息发送到队列或主题即可。
在此不多说JMS和Message driven bean的详细情况，详细知识请到sun的java网站上取得，或在网上搜索。在这里说明一个简单例子的实现过程。本例子用到的工具软件application server：weblogic 6.1,jdk:jdk1.3。
要想运行一个Message driven bean，先要在weblogic控制台做一些设定。
1．Connection factory的设定
打开weblogic控制台，在左边的Form中选择mydomain/Service//JMS/Connection factory,在右边将会显示Connection factory的配置画面，然后在该画面中选择new JMS Connection Factory configuration。
名字：TestConnFactory
JNDI名：jmstest.JMSConnFactory
其他选项取默认值，点击做成按钮。
　　2.JMS的服务器设置
    (1)在左边的Form中选择mydomain/Service//JMS/server，在右边将显示的配置画面，点击new JMSServer configuration。


名字：MyJMSServer
点击作成按钮即作成了server。
(2)然后在左边的form中就可以看到MyJMSServer这一项，下面有destination子项，点击打开，看到destination的设定画面。点击new JMSQueue configuration或者new JMSTopic configuration，这次我们选new JMSTopic configuration。

名字：MyJMSTopic
JNDI名：jmstest.JMSTopic
点击作成按钮。

到此，JMS的服务器端就配置好了。
    先说一下用JMS API做的一个例子。在JMS系统中，消息传递模型分两种，点对点模型(point-to-point model，PTP)和发布/订阅模型(publish and subscribe，pub/sub)。关于这两种模型的详细资料，请在网上查询。下面的例子用的是发布/订阅模型，对于点对点模型处理几乎一模一样，只是用到的有些方法名称不一样。
1． 消息发布程序
package jmstest;

/**
* Title:
* Description:
* Copyright:    Copyright (c) 2001
* Company:
* @author
* @version 1.0
*/

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

public class TPublisher {

    public static void main(String[] args) {

        new TPublisher().publish();
    }

    public void publish() {

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

        try {
            //Prompt for JNDI names
            System.out.println("Enter TopicConnectionFactory name:");
            String factoryName = reader.readLine();
            System.out.println("Enter Topic name:");
            String topicName = reader.readLine();

            //Look up administered objects
            Context initContext = Util.getInitialContext();
            TopicConnectionFactory factory =
                (TopicConnectionFactory) initContext.lookup(factoryName);
            Topic topic = (Topic) initContext.lookup(topicName);
            initContext.close();

            //Create JMS objects
            TopicConnection connection = factory.createTopicConnection();
            TopicSession session =
                connection.createTopicSession(false, Session.AUTO_ACKNOWLEDGE);
            TopicPublisher publisher = session.createPublisher(topic);
            // set persistant
            publisher.setDeliveryMode(DeliveryMode.PERSISTENT);

            //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);
                publisher.publish(message);
            }
            System.out.println("Exiting...");
            reader.close();
            connection.close();
            System.out.println("Goodbye!");

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

2．消息订阅程序
package jmstest;

/**
* Title:
* Description:
* Copyright:    Copyright (c) 2001
* Company:
* @author
* @version 1.0
*/

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

public class TSubscriber implements MessageListener {

    private boolean stop = false;

    public static void main(String[] args) {

        new TSubscriber().subscribe();
    }

    public void subscribe() {

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

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

            //Look up administered objects
            Context initContext = Util.getInitialContext();
            TopicConnectionFactory factory =
                (TopicConnectionFactory) initContext.lookup(factoryName);
            Topic topic = (Topic) initContext.lookup(topicName);
            initContext.close();

            //Create JMS objects
            TopicConnection connection = factory.createTopicConnection();
            TopicSession session =
                connection.createTopicSession(false, Session.AUTO_ACKNOWLEDGE);
            TopicSubscriber subscriber = session.createSubscriber(topic);
            subscriber.setMessageListener(this);
            connection.start();

            //Wait for stop
            while (!stop) {
                Thread.sleep(1000);
            }
            System.out.println("Exiting...");
            connection.close();
            System.out.println("Goodbye!");

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

    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;
        }
    }
}
打开消息订阅程序和消息发布程序，输入我们在上面配置好的connection factory名和topic名，即可通过消息发布程序发送字符消息，在消息订阅程序程序中可以接收到。

    下面再说一下message driven bean的例子。message driven bean在JMS系统中扮演的是消息消费者的角色，即一个message driven bean相当于我们上面例子中的Tsubscriber，只不过它不需要手工调用，由服务器自动调用，也就是说我们只要向某个主题发送消息就可以了，消息将由服务器调用相应的message driven bean去处理。

1.MsgDrvTest.java

package msgdrvbeantest;

/**
* Title:
* Description:
* Copyright:    Copyright (c) 2001
* Company:
* @author
* @version 1.0
*/

import weblogic.rmi.RemoteException;

import javax.ejb.CreateException;
import javax.ejb.MessageDrivenBean;
import javax.ejb.MessageDrivenContext;

import javax.jms.JMSException;
import javax.jms.Message;
import javax.jms.MessageListener;
import javax.jms.TextMessage;

import javax.naming.InitialContext;
import javax.naming.NamingException;

public class MsgDrvTest implements MessageDrivenBean, MessageListener{
    private MessageDrivenContext m_context;
    private static final boolean VERBOSE = true;

    public MsgDrvTest() {
    }

    private void log(String s) {
        if (VERBOSE) System.out.println(s);
    }

    public void ejbActivate() {
        log("ejbActivate called");
    }

    public void ejbRemove() {
        log("ejbRemove called");
    }

    public void ejbPassivate() {
        log("ejbPassivate called");
    }

    public void setMessageDrivenContext(MessageDrivenContext ctx) {
        log("setMessageDrivenContext called");
        m_context = ctx;
    }

    public void ejbCreate () throws CreateException {
        log("ejbCreate called");
    }

    /////
    // MessageListener complement,we should do something at here
    //

    public void onMessage(Message msg) {
        TextMessage tm = (TextMessage) msg;
        try {
            String text = tm.getText();
            log("Received new message : " + text);
        }
        catch(JMSException ex) {
            ex.printStackTrace();
        }
    }

    //
    // MessageListener complement
    /////
}

2. ejb-jar.xml

<!DOCTYPE ejb-jar PUBLIC "-//Sun Microsystems, Inc.//DTD Enterprise JavaBeans 2.0//EN" "http://java.sun.com/dtd/ejb-jar_2_0.dtd">

<ejb-jar>
<enterprise-beans>
    <message-driven>
      <ejb-name>TestMsgDrvBean</ejb-name>
      <ejb-class>msgdrvbeantest.MsgDrvTest</ejb-class>
      <transaction-type>Container</transaction-type>
      <message-driven-destination>
      <!-- destination type: javax.jms.Topic or javax.jms.Queue -->
        <destination-type>javax.jms.Topic</destination-type>
      </message-driven-destination>
    </message-driven>
</enterprise-beans>
</ejb-jar>

3.weblogic-ejb-jar.xml

<?xml version="1.0"?>
<!DOCTYPE weblogic-ejb-jar PUBLIC "-//BEA Systems, Inc.//DTD WebLogic 6.0.0 EJB//EN" "http://www.bea.com/servers/wls600/dtd/weblogic-ejb-jar.dtd">

<weblogic-ejb-jar>
  <weblogic-enterprise-bean>
    <ejb-name>TestMsgDrvBean</ejb-name>
    <message-driven-descriptor>
      <pool>
        <max-beans-in-free-pool>20</max-beans-in-free-pool>
        <initial-beans-in-free-pool>1</initial-beans-in-free-pool>
      </pool>
      <!-- destination-jndi-name is that we configured at JMS server -->
      <destination-jndi-name>jmstest.JMSTopic</destination-jndi-name>
    </message-driven-descriptor>
    <jndi-name>TestMsgDrvBean</jndi-name>
  </weblogic-enterprise-bean>
</weblogic-ejb-jar>
编译MsgDrvTest.java文件，然后用ejbc，生成jar文件，然后将其发布到weblogic中即可。
测试程序可以用上面的例子中的Tpublisher，输入我们在上面配置好的connection factory名和topic名，然后就可以输入字符消息，比如输入一个单词hello，那么在weblogic的控制台就应该可以看到“Received new message : hello”