1 Introduction and Roadmap

This section describes the contents and organization of this guide—Programming JMS for Oracle WebLogic Server.

Document Scope and Audience
Guide to this Document
Related Documentation
Samples and Tutorials for the JMS Developer
New and Changed JMS Features In This Release

Document Scope and Audience

This document is a resource for software developers who want to develop and configure applications that include WebLogic Server Java Message Service (JMS). It also contains information that is useful for business analysts and system architects who are evaluating WebLogic Server or considering the use of WebLogic Server JMS for a particular application

The topics in this document are relevant during the design and development phases of a software project. The document also includes topics that are useful in solving application problems that are discovered during test and pre-production phases of a project.

This document does not address production phase administration, monitoring, or performance tuning JMS topics. For links to WebLogic Server documentation and resources for these topics, see Related Documentation.

It is assumed that the reader is familiar with Java EE and JMS concepts. This document emphasizes the value-added features provided by WebLogic Server JMS and key information about how to use WebLogic Server features and facilities to get a JMS application up and running.

Guide to this Document

This chapter, Chapter 1, "Introduction and Roadmap," introduces the organization of this guide.
Chapter 2, "Understanding WebLogic JMS," provides an overview of the Java Message Service. It also describes WebLogic JMS components and features.
Chapter 3, "Best Practices for Application Design," provides design options for WebLogic Server JMS, application behaviors to consider during the design process, and recommended design patterns.
Chapter 4, "Developing a Basic JMS Application," describes how to develop a WebLogic JMS application.
Chapter 5, "Managing Your Applications," describes how to programmatically manage your JMS applications using value-added WebLogic JMS features.
Chapter 6, "Using JMS Module Helper to Manage Applications," describes how to programatically create and manage JMS servers, Store-and-Forward Agents, and JMS system resources.
Chapter 7, "Using Multicasting with WebLogic JMS," describes how to use Multicasting to enable the delivery of messages to a select group of hosts that subsequently forward the messages to subscribers.
Chapter 8, "Using Distributed Destinations," describes how to use distributed destinations with WebLogic JMS.
Chapter 9, "Enhanced Support for Using WebLogic JMS with EJBs and Servlets," describes "best practice" methods that make it easier to use WebLogic JMS in conjunction with Java EE components, like Enterprise Java Beans and Servlets.
Chapter 10, "Using Message Unit-of-Order," describes how to use Message Unit-of-Order to provide strict message ordering when using WebLogic JMS queues.
Chapter 11, "Using Unit-of-Work Message Groups," describes how to use Unit-of-Work Message Groups to provide groups of messages when using WebLogic JMS.
Chapter 12, "Using Transactions with WebLogic JMS," describes how to use transactions with WebLogic JMS.
Chapter 13, "WebLogic JMS C API," provides information on how to develop C programs that interoperate with WebLogic JMS.
Chapter 14, "Recovering from a Server Failure," describes how to terminate a JMS application gracefully if a server fails and how to migrate JMS data after server failure.
Appendix A, "Deprecated WebLogic JMS Features," describes features that have been deprecated for this release of WebLogic Server.
Appendix B, "FAQs: Integrating Remote JMS Providers," provides answers to frequently asked questions about how to integrate WebLogic Server with remote JMS providers.
Appendix C, "How to Lookup a Destination," provides a summary of methods you can use to lookup a destination.
Appendix D, "Using the JMS Destination Availability Helper APIs with Distributed Queues," provides a means for getting notifications when destinations become available or unavailable.

Samples and Tutorials for the JMS Developer

In addition to this document, Oracle provides a variety of code samples and tutorials for JMS developers. The examples and tutorials illustrate WebLogic Server JMS in action, and provide practical instructions on how to perform key JMS development tasks.

Oracle recommends that you run some or all of the JMS examples before developing your own JMS applications.

Avitek Medical Records Application (MedRec) and Tutorials

MedRec is an end-to-end sample Java EE application shipped with WebLogic Server that simulates an independent, centralized medical record management system. The MedRec application provides a framework for patients, doctors, and administrators to manage patient data using a variety of different clients.

MedRec demonstrates WebLogic Server and Java EE features, and highlights Oracle-recommended best practices. MedRec is included in the WebLogic Server distribution, and can be accessed from the Start menu on Windows machines. For Linux and other platforms, you can start MedRec from the WL_HOME\samples\domains\medrec directory, where WL_HOME is the top-level installation directory for WebLogic Platform.

MedRec includes a service tier comprised primarily of Enterprise Java Beans (EJBs) that work together to process requests from web applications, web services, and workflow applications, and future client applications. The application includes message-driven, stateless session, stateful session, and entity EJBs.

New and Changed JMS Features In This Release

For a comprehensive listing of the new WebLogic Server features introduced in this release, see What's New in Oracle WebLogic Server.