Skip to main content

If you don't have an IBM ID and password, register here.

By clicking Submit, you agree to the developerWorks terms of use.

The first time you sign into developerWorks, a profile is created for you. This profile includes the first name, last name, and display name you identified when you registered with developerWorks. Select information in your developerWorks profile is displayed to the public, but you may edit the information at any time. Your first name, last name (unless you choose to hide them), and display name will accompany the content that you post.

All information submitted is secure.

The first time you sign in to developerWorks, a profile is created for you, so you need to choose a display name. Your display name accompanies the content you post on developerworks.

Please choose a display name between 3-31 characters. Your display name must be unique in the developerWorks community and should not be your email address for privacy reasons.

By clicking Submit, you agree to the developerWorks terms of use.

All information submitted is secure.

Introducing the Java Message Service

author photo
Willy Farrell is a senior software engineer in the IBM Developer Skills Program. As part of the developerWorks team, he provides relevant technical information and insight to developers on the latest e-business and industry trends through Web content, articles, speaking engagements, and consulting to faculty at IBM Scholars Program member universities. He has been programming computers for a living since 1981, began using Java in 1996, and joined IBM in 1998.

Summary:  This tutorial provides an introductory overview of the Java Message Service, its functionality, and its capabilities. You will learn the basic programming techniques for creating JMS programs and work with sample code that demonstrates these techniques. Note: This tutorial has been updated to include changes to JMS version 1.1.

Date:  08 Jun 2004
Level:  Introductory PDF:  A4 and Letter (157 KB | 44 pages)Get Adobe® Reader®

Comments:  

Pub/sub interfaces

Pub/sub interfaces introduction

Now let's look at the pub/sub interfaces. As we go through them, notice how they are very much like the PTP interfaces, except for the names and a few other differences.

Remember: The point-to-point and pub/sub interfaces are included in JMS version 1.1 only for backward compatibility. If you are doing new development, use the common interfaces covered in the New in JMS 1.1: Common interfaces and Client programming with common interfaces sections.

TopicConnectionFactory

TopicConnectionFactory is an administered object that is retrieved from JNDI in order to create a connection to a provider. It contains a createTopicConnection() method, which returns a TopicConnection object.

TopicConnection

TopicConnection encapsulates an active connection to a provider. Some of its methods are:

  • createTopicSession(boolean, int): Returns a TopicSession object. The boolean parameter indicates whether the TopicSession is transacted; the int indicates the acknowledgment mode (see Acknowledgment ).

  • start() (inherited from Connection ): Activates the delivery of messages from the provider.

  • stop() (inherited from Connection ): Temporarily stops delivery of messages; delivery can be restarted with start().

  • close() (inherited from Connection ): Closes the connection to the provider and releases all resources held in its behalf.


TopicSession

TopicSession is the single-threaded context for sending and receiving pub/sub messages. Some of its methods are:

  • createPublisher(Topic): Returns a TopicPublisher object to send messages to the specified Topic.

  • createSubscriber(Topic): Returns a TopicSubscriber object to receive messages from the specified Topic. This subscriber is non-durable; that is, the subscription will last only for the lifetime of the object and will receive messages only when it is active.

  • createDurableSubscriber(Topic, String): Returns a TopicSubscriber object to receive messages from the specified Topic, giving the String name to the subscriber. Messages for a durable subscriber will be retained by JMS if the object is not active and will be delivered to subsequent subscriber objects that are created with the same name.

  • unsubscribe(String): Ends the subscription with the String name.

  • commit() (inherited from Session ): Commits all consumed or produced messages for the current transaction.

  • rollback() (inherited from Session ): Rolls back all consumed or produced messages for the current transaction.

  • create<MessageType>Message(...) (inherited from Session ): A variety of methods that return a <MessageType>Message, such as MapMessage, TextMessage, and so on.


Topic

Topic encapsulates a pub/sub destination. It is an administered object that is retrieved from JNDI.


TopicPublisher

TopicPublisher is used to send pub/sub messages. Some of its methods are:

  • publish(Message): Publishes the indicated Message.

  • setDeliveryMode(int) (inherited from MessageProducer ): Sets the delivery mode for subsequent messages sent; valid values are DeliveryMode.PERSISTENT and DeliveryMode.NON_PERSISTENT.

  • setPriority(int) (inherited from MessageProducer ): Sets the priority for subsequent messages sent; valid values are 0 through 9.

  • setTimeToLive(long) (inherited from MessageProducer ): Sets the duration before expiration, in milliseconds, of subsequent messages sent.


TopicSubscriber

TopicSubscriber is used to receive point-to-point messages. Some of its methods are:

  • receive() (inherited from MessageConsumer ): Returns the next message that arrives; this method blocks until a message is available.

  • receive(long) (inherited from MessageConsumer ): Receives the next message that arrives within long milliseconds; this method returns null if no message arrives within the time limit.

  • receiveNoWait (inherited from MessageConsumer ): Receives the next message if one is immediately available; this method returns null if no message is available.

  • setMessageListener(MessageListener) (inherited from MessageConsumer ): Sets the MessageListener; the MessageListener object receives messages as they arrive, that is, asynchronously (see MessageListener ).

8 of 13 | Previous | Next

Comments



Help: Update or add to My dW interests

What's this?

This little timesaver lets you update your My developerWorks profile with just one click! The general subject of this content (AIX and UNIX, Information Management, Lotus, Rational, Tivoli, WebSphere, Java, Linux, Open source, SOA and Web services, Web development, or XML) will be added to the interests section of your profile, if it's not there already. You only need to be logged in to My developerWorks.

And what's the point of adding your interests to your profile? That's how you find other users with the same interests as yours, and see what they're reading and contributing to the community. Your interests also help us recommend relevant developerWorks content to you.

View your My developerWorks profile

Return from help

Help: Remove from My dW interests

What's this?

Removing this interest does not alter your profile, but rather removes this piece of content from a list of all content for which you've indicated interest. In a future enhancement to My developerWorks, you'll be able to see a record of that content.

View your My developerWorks profile

Return from help

static.content.url=http://www.ibm.com/developerworks/js/artrating/
SITE_ID=1
Zone=Java technology
ArticleID=131862
TutorialTitle=Introducing the Java Message Service
publish-date=06082004
author1-email=willyf@us.ibm.com
author1-email-cc=

Tags

Help
Use the search field to find all types of content in My developerWorks with that tag.

Use the slider bar to see more or fewer tags.

Popular tags shows the top tags for this particular content zone (for example, Java technology, Linux, WebSphere).

My tags shows your tags for this particular content zone (for example, Java technology, Linux, WebSphere).

Use the search field to find all types of content in My developerWorks with that tag. Popular tags shows the top tags for this particular content zone (for example, Java technology, Linux, WebSphere). My tags shows your tags for this particular content zone (for example, Java technology, Linux, WebSphere).