• • • • • • Table of Contents Index Reviews Reader Reviews Errata Academic Enterprise JavaBeans, 4th Edition By Bill Burke, Sacha Labourey, Richard Monson-Haefel Publisher : O'Reilly Pub Date : June 2004 ISBN : 0-596-00530-X Pages : 788 This authoritative guide includes everything that made previous editions of Enterprise JavaBeans the single must-have book for EJB developers: the author's solid grasp on the complexities of EJBs; hundreds of clear, practical examples; adept coverage the key concepts EJBs ; and diagrams to illustrate the concepts presented The fourth edition also includes everything you need to get up to speed quickly on the changes in EJB version 2.1 as well as a JBoss implementation guide • • • • • • Table of Contents Index Reviews Reader Reviews Errata Academic Enterprise JavaBeans, 4th Edition By Bill Burke, Sacha Labourey, Richard Monson-Haefel Publisher : O'Reilly Pub Date : June 2004 ISBN : 0-596-00530-X Pages : 788 Copyright Preface Author's Note What Is Enterprise JavaBeans? Who Should Read This Book? Software and Versions Comments and Questions Organization Conventions Acknowledgments Part I: Lay of the Land Chapter 1 Introduction Section 1.1 Server-Side Components Section 1.2 Distributed Object Architectures Section 1.3 Component Models Section 1.5 Titan Cruises: An Imaginary Business Section 1.4 Asynchronous Messaging Section 1.6 What's Next? Chapter 2 Architectural Overview Section 2.1 The Enterprise Bean Component Section 2.2 Using Enterprise Beans Section 2.4 Summary Section 2.3 The Bean-Container Contract Chapter 3 Resource Management and the Primary Services Section 3.1 Resource Management Section 3.3 What's Next? Section 3.2 Primary Services Chapter 4 Developing Your First Enterprise Beans Section 4.1 Choosing and Setting Up an EJB Server Section 4.3 Developing a Session Bean Section 4.2 Developing an Entity Bean Chapter 5 The Remote and Local Client View Section 5.1 Locating Beans with JNDI Section 5.3 The Local Client API Section 5.2 The Remote Client API Chapter 6 CMP: Basic Persistence Section 6.1 The Abstract Programming Model Section 6.3 Persistence Fields Section 6.4 Dependent Value Classes Section 6.2 The Customer EJB Section 6.5 Relationship Fields Chapter 7 CMP: Entity Relationships Chapter 8 CMP: EJB QL Section 7.1 The Seven Relationship Types Section 8.1 Declaring EJB QL Section 8.2 The Query Methods Section 8.4 Problems with EJB QL Section 8.3 EJB QL Examples Chapter 9 Bean-Managed Persistence Section 9.1 The Remote Interface Section 9.2 The Remote Home Interface Section 9.3 The Primary Key Section 9.4 The ShipBean Section 9.5 Obtaining a Resource Connection Section 9.7 The ejbCreate( ) Method Section 9.9 The ejbRemove( ) Method Section 9.11 The Deployment Descriptor Section 9.6 Exception Handling Section 9.8 The ejbLoad( ) and ejbStore( ) Methods Section 9.10 The ejbFind( ) Methods Chapter 10 The Entity-Container Contract Section 10.1 The Primary Key Section 10.3 ejbHome( ) Section 10.5 The Life Cycle of an Entity Bean Section 10.2 The Callback Methods Section 10.4 EntityContext Chapter 11 Session Beans Section 11.1 The Stateless Session Bean Section 11.3 The Stateful Session Bean Section 11.2 The Life Cycle of a Stateless Session Bean Section 11.4 The Life Cycle of a Stateful Session Bean Chapter 12 Message-Driven Beans Section 12.1 JMS and Message-Driven Beans Section 12.2 JMS-Based Message-Driven Beans Section 12.4 Connector-Based Message-Driven Beans Section 12.3 The Life Cycle of a Message-Driven Bean Section 12.5 EJB 2.1: Message Linking Chapter 13 Timer Service Section 13.1 Titan's Maintenance Timer Section 13.2 Timer Service API Section 13.4 Entity Bean Timers Section 13.6 Message-Driven Bean Timers Chapter 14 EJB 2.1: Web Service Standards Section 13.3 Transactions Section 13.5 Stateless Session Bean Timers Section 13.7 Final Words Section 14.1 Web Services Overview Section 14.2 XML Schema and XML Namespaces Section 14.3 SOAP 1.1 Section 14.4 WSDL 1.1 Section 14.5 UDDI 2.0 Section 14.6 From Standards to Implementation Chapter 15 EJB 2.1 and Web Services Section 15.1 Accessing Web Services with JAX-RPC Section 15.2 EJB Endpoints Chapter 16 Transactions Section 16.1 ACID Transactions Section 16.3 Isolation and Database Locking Section 16.5 Explicit Transaction Management Section 16.7 Transactional Stateful Session Beans Section 16.2 Declarative Transaction Management Section 16.4 Nontransactional Beans Section 16.6 Exceptions and Transactions Chapter 17 J2EE Section 17.1 Servlets Section 17.3 Web Components and EJB Section 17.5 Fitting the Pieces Together Section 17.2 JavaServer Pages Section 17.4 Filling in the Gaps Chapter 18 XML Deployment Descriptors Section 18.1 The ejb-jar File Section 18.3 The Document Headerand Schema Declarations Section 18.5 Describing Enterprise Beans Section 18.6 Describing Relationships Chapter 19 EJB Design in the Real World Section 18.2 The Contents of a Deployment Descriptor Section 18.4 The Descriptor's Body Section 18.7 Describing Bean Assembly Section 19.1 Pre-Design: Containers and Databases Section 19.2 Design Section 19.3 Should You Use EJBs? Section 19.4 Wrapping Up Part II: JBoss Workbook Chapter 20 Introduction Section 20.1 Contents of the JBoss Workbook Chapter 21 JBoss Installation and Configuration Section 21.1 About JBoss Section 21.2 Installing JBoss Application Server Section 21.3 A Quick Look at JBoss Internals Section 21.4 Exercise Code Setup and Configuration Chapter 22 Exercises for Chapter 4 Section 22.1 Exercise 4.1: A Simple Entity Bean Section 22.2 Exercise 4.2: A Simple Session Bean Chapter 23 Exercises for Chapter 5 Section 23.1 Exercise 5.1: The Remote Component Interfaces Section 23.2 Exercise 5.2: The EJBObject, Handle, and Primary Key Section 23.3 Exercise 5.3: The Local Component Interfaces Chapter 24 Exercises for Chapter 6 Section 24.1 Exercise 6.1: Basic Persistence in CMP 2.0 Section 24.2 Exercise 6.2: Dependent Value Classes in CMP 2.0 Section 24.3 Exercise 6.3: A Simple Relationship in CMP 2.0 Chapter 25 Exercises for Chapter 7 Section 25.1 Exercise 7.1: Entity Relationships in CMP 2.0, Part 1 Section 25.2 Exercise 7.2:Entity Relationships in CMP 2.0, Part 2 Section 25.3 Exercise 7.3: Cascade Deletes in CMP 2.0 Chapter 26 Exercises for Chapter 8 Section 26.1 Exercise 8.1: Simple EJB QL Statements Section 26.2 Exercise 8.2: Complex EJB QL Statements Chapter 27 Exercises for Chapter 9 Section 27.1 Exercise 9.1: A BMP Entity Bean Chapter 28 Exercises for Chapter 11 Section 28.1 Exercise 11.1: A Stateless Session Bean Section 28.2 Exercise 11.2: A Stateful Session Bean Chapter 29 Exercises for Chapter 12 Section 29.1 Exercise 12.1: JMS as a Resource Section 29.2 Exercise 12.2: The Message-Driven Bean Chapter 30 Exercises for Chapter 13 Section 30.1 Exercise 13.1: EJB Timer Service Chapter 31 Exercises for Chapter 15 Section 31.1 Exercise 15.1: Web Services and EJB 2.1 Appendix A Database Configuration Section A.1 Set Up the Database Section A.3 Start Up JBoss Section A.2 Examine the JBoss-Specific Files Section A.4 Build and Deploy the Example Programs Section A.5 Examine and Run the Client Applications Colophon Index Copyright © 2004, 2003, 2001, 2000, 1999 O'Reilly Media, Inc Printed in the United States of America The JBoss Workbook section of the book was previously published as JBoss 3.2 Workbook for Enterprise JavaBeans, Third Edition Published by O'Reilly Media, Inc., 1005 Gravenstein Highway North, Sebastopol, CA 95472 O'Reilly books may be purchased for educational, business, or sales promotional use Online editions are also available for most titles (http://safari.oreilly.com) For more information, contact our corporate/institutional sales department: (800) 998-9938 or corporate@oreilly.com Nutshell Handbook, the Nutshell Handbook logo, and the O'Reilly logo are registered trademarks of O'Reilly Media, Inc Enterprise JavaBeans?, Fourth Edition, the image of a wallaby and joey, and related trade dress are trademarks of O'Reilly Media, Inc Java™ and all Java-based trademarks and logos are trademarks or registered trademarks of Sun Microsystems, Inc., in the United States and other countries O'Reilly Media, Inc is independent of Sun Microsystems Microsoft, Windows, Windows NT, and the Windows logo are trademarks or registered trademarks of Microsoft Corporation in the United States and other countries JBoss is fully owned and operated by JBoss, Inc in the United States and other countries Many of the designations used by manufacturers and sellers to distinguish their products are claimed as trademarks Where those designations appear in this book, and O'Reilly Media, Inc was aware of a trademark claim, the designations have been printed in caps or initial caps While every precaution has been taken in the preparation of this book, the publisher and authors assume no responsibility for errors or omissions, or for damages resulting from the use of the information contained herein subqueries subscribing to topics 2nd subscription durability subscriptionDurablity property ( element) SUBSTRING string function subsystem exceptions BMP and suffixes 2nd create methods and 2nd SUM( ) function Sun Microsystems EJB-to-CORBA mapping developed by Forte IDE developed by Sun';s JMX (Java Management eXtensions) Supports transaction attribute suspended transactions synchronizing beans state 2nd 3rd 4th system exceptions 2nd subsystem-level versus application exceptions [SYMBOL] [A] [B] [C] [D] [E] [F] [G] [H] [I] [J] [L] [M] [N] [O] [P] [Q] [R] [S] [T] [U] [V] [W] [X] [Z] tables, creating in databases taskflow terminology conventions abstract persistence schema and TextMessage TextMessage message type thread control threads three-tier architecture TicketDistributor EJB consuming messages TicketDO object 2nd timeouts Passivated state and setting stateful session beans and stateless session beans and timer attacks Timer interface exceptions getNextTimeout( ) method Timer Service 2nd API creating timers exceptions exercises how a bean would register for notification at a set time how it works improving problems with transactions uses for scheduling systems TimerHandle object timers cancelling entity bean serious concern identifying managing MDBs configuring at deployment initializing standard configuration properties problems with retrieving information from stateless session bean TimerService interface createTimer( ) methods definition getTimers( ) method Titan application business entities Titan Cruises (sample business) Topic object TopicConnection TopicConnectionFactory 2nd TopicPublisher 2nd topics (JMS) TopicSession TopicSubscriber toString( ) method TPC (two-phase commit protocol) element element nesting inside element Transactional Method-Ready state 2nd transactions 2nd accuracy of ACID atomic attributes 2nd CMP entity beans and definitions of EJB endpoints and Mandatory MDBs and 2nd Never NotSupported Required RequiresNew setting specifying Supports balancing performance of against consistency business business systems that employ consistency of declarative management and durability of entity beans exceptions and explicit management and how they work interoperability isolation and database locking isolation levels isolation of database locking management, explicit managers propagation of propogation 2nd BMT beans and scope minimizing scope of stateful session beans and summary of interactions between (table) suspended Transfer Object pattern transient fields 2nd transitioning between states Method-Ready Pool and stateful session beans and Transactional Method-Ready state and TravelAgent EJB (sample session bean) 2nd 3rd ACID properties creating deploying exercise listCabins( ) method MDBs and 2nd reasons for using transactions and travelagent.wsdl file travelagent_mapping.xml file TravelAgentClientBean.java TravelAgentEndpoint.java two-phase commit protocol (2-PC or TPC) element (WSDL) [SYMBOL] [A] [B] [C] [D] [E] [F] [G] [H] [I] [J] [L] [M] [N] [O] [P] [Q] [R] [S] [T] [U] [V] [W] [X] [Z] UDDI (Universal Description, Discovery and Integration) registry repository UML diagram of business entities and their relationships unchecked exceptions unchecked methods 2nd undefined primary keys underscore (_) unidirectional relationships, wrong way to modify unit-of-work 2nd unsetEntityContext( ) method 2nd updatePhoneNumber( ) method URLs distributed computing technologies EJB in JNDI this book XML deployment descriptors and element users UserTransaction interface 2nd definition of utilities container-deployment for database tables utility classes [SYMBOL] [A] [B] [C] [D] [E] [F] [G] [H] [I] [J] [L] [M] [N] [O] [P] [Q] [R] [S] [T] [U] [V] [W] [X] [Z] valid XML value types, restrictions on vendors fear of lock-in and support for JMS virtual persistence fields VisualAge IDE (IBM) [SYMBOL] [A] [B] [C] [D] [E] [F] [G] [H] [I] [J] [L] [M] [N] [O] [P] [Q] [R] [S] [T] [U] [V] [W] [X] [Z] war (web archive) files web components EJBs and Web Service Description Language [See WSDL] web services accessing with JAX-RPC exercises J2EE overview standards WebOS webservices.xml file WebSphere (IBM) well formed XML WHERE clause arithmetic and logic operators in arithmetic operators and BETWEEN clause and CDATA sections and comparison operators and equality semantics and IN operator and input parameters and IS EMPTY operator and IS NULL comparison operator and LIKE comparison operator and literals and logical operators and MEMBER OF operator and operator precedence and wildcards, asterisk indicating 2nd 3rd wizards for graphical deployment for object-to-relational database mapping workbook contents example code downloading exercises [See exercises] online resources workflow scheduling examples workflow, modeling with session beans 2nd stateful session beans and 2nd wrapper classes for primitive data types write locks write once, run anywhere WSDL file used to generate endpoint interface generating JAX-RPC stubs from WSDL (Web Service Description Language) 2nd 3rd element element element element element element [SYMBOL] [A] [B] [C] [D] [E] [F] [G] [H] [I] [J] [L] [M] [N] [O] [P] [Q] [R] [S] [T] [U] [V] [W] [X] [Z] XML as entity data from EJBs correctness documents element delimiters parsers using different markup languages in same document version of, specifying in documents versus HTML XML deployment descriptors [See deployment descriptors] XML elements defining for session beans XML Namespaces declarations default namespaces prefixes for target namespace URI XML Schema built-in types built-in types and corresponding Java types specification XSDs for deployment descriptors in EJB 2.1 [SYMBOL] [A] [B] [C] [D] [E] [F] [G] [H] [I] [J] [L] [M] [N] [O] [P] [Q] [R] [S] [T] [U] [V] [W] [X] [Z] zipping/unzipping JAR files ... Version 2.0, which was covered in the second and third editions of this book The most recent revision to the specification, Version 2.1, is covered by this, the fourth edition of Enterprise JavaBeans This edition also covers EJB 2.0, which is for the... Enterprise JavaBeans component model Chapter 2 This chapter defines the architecture of the Enterprise JavaBeans component model and examines the difference between the three basic types of enterprise beans: entity... new books on the subject debut, I can't help but remember the days when the words "Enterprise JavaBeans" drew blank looks from just about everyone I'm glad those days are over What Is Enterprise JavaBeans? When Java™ was first introduced in the summer of 1995, most