1 Introduction and Roadmap

This chapter describes the contents and organization of this guide—Developing Enterprise JavaBeans for Oracle WebLogic Server.

This chapter includes the following sections:

1.1 Document Scope and Audience

This document is a resource for software developers who develop applications that include WebLogic Server Enterprise JavaBeans (EJBs). It is assumed that the reader is familiar with Java EE and basic EJB programming concepts.

The document mostly discusses the EJB 3.2 programming model, in particular the use of metadata annotations to simplify development. This document does not address EJB topics that are different between versions 2.x and 3.x, such as design considerations, EJB container architecture, entity beans, deployment descriptor use, and so on. This document also does not address production phase administration, monitoring, or performance tuning. For links to WebLogic Server documentation and resources for these topics, see Related Documentation.

For information on programming and packaging 2.1 EJBs, see Developing Enterprise JavaBeans, Version 2.1, for Oracle WebLogic Server.

1.2 Guide to this Document

1.3 Related Documentation

This document contains EJB 3.2-specific development information. Additionally, it provides information only for session and message-driven beans. For complete information on general EJB design and architecture, the EJB 2.x programming model (which is fully supported in EJB 3.x), see the following documents.

1.3.1 EJB Documentation in WebLogic Server

For information about developing and deploying EJBs with WebLogic Server, see:

1.3.2 Additional EJB Information

It is assumed the reader is familiar with programming in Java EE and EJB concepts and features. To learn more about basic EJB concepts, such as the benefits of enterprise beans, the types of enterprise beans, and their life cycles, then visit the following Web sites:

1.4 Comprehensive Examples for the EJB Developer

In addition to this document and the basic examples described in Simple Enterprise JavaBeans Examples,, Oracle provides comprehensive examples in the WebLogic Server distribution kit.

When you install WebLogic Server complete with the examples, the examples source code is placed in the EXAMPLES_HOME directory. The default path is ORACLE_HOME\wlserver\samples\server. From this directory, you can access the source code and instruction files for the examples without having to set up the samples domain. See Sample Applications and Code Examples in Understanding Oracle WebLogic Server.

Oracle recommends that you run these examples before programming your own application that uses EJBs.

1.4.1 EJB 3.2 Examples

Oracle provides Java EE 7 examples that demonstrate new features in EJB 3.2, such as:

For more information, see the EJB 3.2 examples in the WebLogic Server distribution kit: EXAMPLES_HOME/examples/src/examples/javaee7/ejb where EXAMPLES_HOME represents the directory in which the WebLogic Server code examples are configured. See Sample Applications and Code Examples in Understanding Oracle WebLogic Server.

1.4.2 EJB 3.1 Examples

Oracle provides Java EE 6 examples that demonstrate new features in EJB 3.1, such as:

For more information, see these examples in the WebLogic Server distribution kit: EXAMPLES_HOME/examples/src/examples/javaee6/ejb where EXAMPLES_HOME represents the directory in which the WebLogic Server code examples are configured. See Sample Applications and Code Examples in Understanding Oracle WebLogic Server.

1.4.3 EJB 3.0 Example

There is also an EJB 3.0 persistence service example, EJB 3.1: Example of Using the Embeddable EJB Container in Java SE, that includes actual business code and provides practical instructions on how to perform key EJB 3.0 development tasks. In particular, the example demonstrates usage of EJB 3.x with:

  • Java Persistence API

  • Stateless Session Bean

  • Message Driven Bean

  • Asynchronous JavaScript based browser application

The example uses a persistent domain model for entity EJBs. For more information, see the example in the WebLogic Server distribution kit: EXAMPLES_HOME/examples/src/examples/ejb/ejb30 where EXAMPLES_HOME represents the directory in which the WebLogic Server code examples are configured. See Sample Applications and Code Examples in Understanding Oracle WebLogic Server.

1.5 New and Changed Features in this Release

For a comprehensive listing of the new features in EJB 3.1 features introduced in this release of WebLogic Server, see What Is New and Changed in EJB 3.2.