Preface

This guide gets you started building Enterprise JavaBeans for OC4J. It includes code examples to help you develop your application.

Who Should Read This Guide?

Anyone developing Enterprise JavaBeans for OC4J will benefit from reading this guide. Written especially for programmers, it will also be of value to architects, systems analysts, project managers, and others interested in EJB applications. To use this guide effectively, you must have a working knowledge of J2EE.

Documentation Accessibility

Our goal is to make Oracle products, services, and supporting documentation accessible, with good usability, to the disabled community. To that end, our documentation includes features that make information available to users of assistive technology. This documentation is available in HTML format, and contains markup to facilitate access by the disabled community. Standards will continue to evolve over time, and Oracle Corporation is actively engaged with other market-leading technology vendors to address technical obstacles so that our documentation can be accessible to all of our customers. For additional information, visit the Oracle Accessibility Program Web site at

 http://www.oracle.com/accessibility/

Accessibility of Code Examples in Documentation

JAWS, a Windows screen reader, may not always correctly read the code examples in this document. The conventions for writing code require that closing braces should appear on an otherwise empty line; however, JAWS may not always read a line of text that consists solely of a bracket or brace.

Accessibility of Links to External Web Sites in Documentation

This documentation may contain links to Web sites of other companies or organizations that Oracle Corporation does not own or control. Oracle Corporation neither evaluates nor makes any representations regarding the accessibility of these Web sites.

Prerequisite Reading

Before consulting this Guide, you should read the following:

• Any J2EE book that enables you to understand the basics of J2EE programming.

• The Oracle Application Server Containers for J2EE User's Guide. This guide helps you to understand the minimum requirements for a J2EE application in the OC4J environment.

• The Sun Microsystems EJB 2.0 specification as a supplement to this guide. This guide assumes that you already have a base understanding of the EJB 2.0 specification details.

Suggested Reading

Books

• Professional Java Server Programming, J2EE Edition, Wrox Press Ltd, 2000.

• Mastering Enterprise JavaBeans and the Java2 Platform Enterprise Edition, by Ed Roman. Wily Computer Publishing, 1999.

• Designing Enterprise Applications with the Java2 Platform, Enterprise Edition, Addison-Wesley, 2000.

• Core Java by Cornell & Horstmann, second edition, Volume II (Prentice-Hall, 1997) demonstrates several Java concepts relevant to EJBs.

• The Developer's Guide to Understanding Enterprise JavaBeans, an overview of EJBs, is available at http://www.Nova-Labs.com.

Online Sources

There are many useful online sources of information about Java. For example, you can view or download guides and tutorials from the Sun Microsystems home page on the Web:

http://www.sun.com

The current 2.0 EJB specification is available at:

http://java.sun.com/products/ejb/docs.html

Another popular Java Web site is:

http://www.gamelan.com

For Java API documentation, see:

http://www.javasoft.com

How This Guide Is Organized

This guide consists of the following:

Chapter 1, "EJB Overview", presents a brief overview of EJBs.

Chapter 2, "EJB Primer", discusses a stateless session bean development for the OC4J server.

Chapter 3, "CMP Entity Beans", discusses a CMP entity bean and advanced issues connected with CMP entity beans.

Chapter 4, "Entity Relationship Mapping", discusses container-managed relationships (CMR) within the entity bean for OC4J.

Chapter 5, "EJB Query Language", provides an overview and examples of setting up query methods that use EJB QL.

Chapter 6, "BMP Entity Beans", discusses a BMP entity bean.

Chapter 7, "Message-Driven Beans", discusses an MDB entity bean.

Chapter 8, "Configuring EJB Application Security", discusses EJB application security.

Chapter 9, "Advanced EJB Subjects", discusses advanced issues for EJBs.

Chapter 10, "EJB Clustering", discusses how to cluster EJBs across OC4J nodes.

Chapter 11, "Active Components for Java", introduces a new methodology to merge the advantages of both asynchronous and request/response communication.

Appendix A, "OC4J-Specific DTD Reference" describes the OC4J-specific deployment descriptor.

Appendix B, "EJB 1.1 CMP Entity Beans" contains the EJB 1.1 CMP entity bean methodology.

Appendix C, "Migration From EJB 1.1 to EJB 2.0 Container Managed Persistence", discusses how to migrate an EJB 1.1 application that uses container managed persistence to the 2.0 specification model.

Conventions

The following conventions are used in this manual:

Convention	Meaning
. . .	Vertical ellipsis points in an example mean that information not directly related to the example has been omitted.
. . .	Horizontal ellipsis points in statements or commands mean that parts of the statement or command not directly related to the example have been omitted
boldface text	Boldface type in text indicates a term defined in the text, the glossary, or in both locations.
< >	Angle brackets enclose user-supplied names.
[ ]	Brackets enclose optional clauses from which you can choose one or none.