1. /*

  2.  * Copyright 2002 Sun Microsystems, Inc. All rights reserved.

  3.  * SUN PROPRIETARY/CONFIDENTIAL. Use is subject to license terms.

  4.  */

  5. 

  6. package javax.jms;

  7. 

  8. 

  9. /** A <CODE>MessageListener</CODE> object is used to receive asynchronously 

  10.   * delivered messages.

  11.   *

  12.   * <P>Each session must insure that it passes messages serially to the

  13.   * listener. This means that a listener assigned to one or more consumers

  14.   * of the same session can assume that the <CODE>onMessage</CODE> method 

  15.   * is not called with the next message until the session has completed the 

  16.   * last call.

  17.   *

  18.   * @version     1.0 - 13 March 1998

  19.   * @author      Mark Hapner

  20.   * @author      Rich Burridge

  21.   */

  22. 

  23. public interface MessageListener {

  24. 

  25.     /** Passes a message to the listener.

  26.       *

  27.       * @param message the message passed to the listener

  28.       */

  29. 

  30.     void 

  31.     onMessage(Message message);

  32. }