Programming WebLogic Enterprise JavaBeans, Version 3.0
Introduction and Roadmap
This section describes the contents and organization of this guide—Programming WebLogic Enterprise Java Beans, Version 3.0.
- Document Scope and Audience
- Guide to this Document
- Related Documentation
- Comprehensive Example for the EJB 3.0 Developer
- New and Changed Features in this Release
Document Scope and Audience
This document is a resource for software developers who develop applications that include WebLogic Server Enterprise Java Beans (EJBs), Version 3.0.
The document mostly discusses the new EJB 3.0 programming model, in particular the use of metadata annotations to simplify development. The document briefly discusses the main differences between EJB 3.0 and 2.X for users who are familiar with programming EJB 2.X and want to know why they might want to use the new 3.0 programming model.
This document does not address EJB topics that are the same between versions 2.X and 3.0, such as design considerations, EJB container architecture, 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.
It is assumed that the reader is familiar with Java Platform, Enterprise Edition (Java EE) Version 5 and EJB 2.X concepts.
Guide to this Document
- This chapter, Introduction and Roadmap, introduces the organization of this guide.
- Understanding Enterprise JavaBeans 3.0, provides an overview of the new EJB 3.0 features and programming model, as well as a brief description of the differences between EJB 3.0 and 2.X.
- Simple Enterprise JavaBeans 3.0 Examples, provides simple examples of programming EJBs using the new metadata annotations specified by EJB 3.0.
- Iterative Development of Enterprise JavaBeans 3.0, describes the EJB implementation process, and provides guidance for how to get an EJB up and running in WebLogic Server.
- Programming the Annotated EJB 3.0 Class, describes the requirements and typical steps when programming the EJB bean class that contains the metadata annotations.
- Using Oracle Kodo with WebLogic Server, describes how to use Oracle Kodo to create entity beans. Oracle Kodo is a product that provides the implementation of the Java Persistence API section of the EJB 3.0 specification, as well as other persistence-related technologies such as Java Data Objects (JDO).
- EJB 3.0 Metadata Annotations Reference, provides reference information for the EJB 3.0 metadata annotations, as well as information about standard metadata annotations that are used by EJB.
- Persistence Configuration Schema Reference, provides reference information for the persistence configuration schema.
Related Documentation
This document contains EJB 3.0-specific development information. Additionally, it provides information only for session and message-driven beans. For completed information on general EJB design and architecture, the EJB 2.X programming model (which is fully supported in EJB 3.0), and programming 3.0 entities, see the following documents:
- Programming Weblogic Enterprise JavaBeans (Version 2.X)
- Enterprise JavaBeans 3.0 Specification (JSR-220)
For comprehensive guidelines for developing, deploying, and monitoring WebLogic Server applications, see the following documents:
- Developing Applications with WebLogic Server is a guide to developing WebLogic Server applications.
- Deploying Applications to WebLogic Server is the primary source of information about deploying WebLogic Server applications in development and production environments.
Comprehensive Example for the EJB 3.0 Developer
In addition to this document and the basic examples described in Simple Enterprise JavaBeans 3.0 Examples, Oracle provides a comprehensive example in the WebLogic Server distribution kit. The example illustrates EJB 3.0 in action and provides practical instructions on how to perform key EJB 3.0 development tasks. In particular, the example demonstrates usage of EJB 3.0 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.
WebLogic Server optionally installs this comprehensive example in WL_HOME\samples\server\examples\src\examples\ejb\ejb30, where WL_HOME is the top-level directory of your WebLogic Server installation. On Windows, you can start the examples server, and obtain information about the samples and how to run them from the WebLogic Server Start menu.
Oracle recommends that you run this example before programming your own application that uses EJB 3.0.
New and Changed Features in this Release
For a comprehensive listing of the new WebLogic Server features introduced in this release, see What's New in WebLogic Server in the Release Notes.
For a list of all known and resolved issues in this release, see Weblogic Server Known and Resolved Issues in Known and Resolved Issues.