Red Hat Application Server JOnAS User Guide Red Hat Application Server: JOnAS User Guide Copyright © 1999-2004 by ObjectWeb Consortium ObjectWeb Consortium INRIA - ZIRST, 655 avenue de l'Europe Montbonnot 38334 SAINT-ISMIER Cedex FRANCE Additional information copyright © Red Hat, Inc., 2003-2004. 1801 Varsity Drive Raleigh NC 27606-2072 USA Phone: +1 919 754 3700 Phone: 888 733 4281 Fax: +1 919 754 3701 PO Box 13588 Research Triangle Park NC 27709 USA Manual identifier: • PDF: rhel-jonas-EN-3-PDF-RHI (2003-09-24T01:08) • HTML: rhel-jonas-EN-3-HTML-RHI (2003-09-24T01:08) Red Hat is a registered trademark and the Red Hat Shadow Man logo, RPM, and the RPM logo are trademarks of Red Hat, Inc. JOnAS is copyright © ObjectWeb Consortium. The JOnAS logo is copyright © Bruno Bellamy. Tomcat is copyright © The Apache Software Foundation (ASF). IntelTM, PentiumTM, ItaniumTM, and CeleronTM are registered trademarks of Intel Corporation. EJBTM, J2EETM, JCATM, JCEETM, JDBCTM, JDOTM, JMSTM, RMITM, and SunTM, and Sun Microsystems® are registered trademarks of Sun Microsystems, Inc. Linux is a registered trademark of Linus Torvalds. All other trademarks and copyrights referred to are the property of their respective owners. The GPG fingerprint of the [email protected] key is: CA 20 86 86 2B D6 9D FC 65 F6 EC C4 21 91 80 CD DB 42 A6 0E Table of Contents I. Introductory JOnAS Documentation ..........................................................................................vii 1. Java Open Application Server (JOnAS): a J2EE Platform ................................................... 1 1.1. Introduction to Red Hat Application Server .......................................................... 1 1.2. JOnAS Features ..................................................................................................... 2 1.3. JOnAS Architecture............................................................................................... 4 1.4. JOnAS Development and Deployment Environment .......................................... 10 1.5. Clustering and Performance................................................................................. 11 1.6. Future Development............................................................................................. 13 2. Getting Started with JOnAS................................................................................................ 15 2.1. Running the First EJB Application...................................................................... 15 2.2. More Complex Examples .................................................................................... 16 3. JOnAS Configuration.......................................................................................................... 21 3.1. JOnAS Configuration Rules................................................................................. 21 3.2. Configuring the JOnAS Environment.................................................................. 22 3.3. Configuring the Communication Protocol and JNDI........................................... 23 3.4. Configuring Logging System (monolog)............................................................. 24 3.5. Configuring JOnAS Services ............................................................................... 26 3.6. Configuring the DB Service (hsql) ...................................................................... 44 3.7. Configuring JMS Resource Adapters................................................................... 44 4. Configuring JDBC DataSources ......................................................................................... 51 4.1. Configuring DataSources..................................................................................... 51 4.2. CMP2.0/JORM .................................................................................................... 52 4.3. ConnectionManager Configuration...................................................................... 53 4.4. Tracing SQL Requests Through P6Spy ............................................................... 53 5. JOnAS Class Loader Hierarchy.......................................................................................... 55 5.1. Understanding the Class Loader Hierarchy ......................................................... 55 5.2. Commons Class Loader ....................................................................................... 55 5.3. Application Class Loader..................................................................................... 55 5.4. Tools Class Loader............................................................................................... 55 5.5. Tomcat Class Loader............................................................................................ 56 5.6. JOnAS Class Loaders .......................................................................................... 56 5.7. JOnAS Class Loader Hierarchy........................................................................... 56 6. JOnAS Command Reference .............................................................................................. 59 6.1. jonas ..................................................................................................................... 59 6.2. jclient.................................................................................................................... 62 6.3. newbean ............................................................................................................... 62 6.4. registry ................................................................................................................. 65 6.5. GenIC................................................................................................................... 65 6.6. JmsServer............................................................................................................. 67 6.7. RAConfig ............................................................................................................. 68 II. Enterprise Beans Programmer's Guide..................................................................................... 71 7. Developing Session Beans.................................................................................................. 73 7.1. Introduction to Session Beans.............................................................................. 73 7.2. The Home Interface ............................................................................................. 73 7.3. The Component Interface .................................................................................... 74 7.4. The Enterprise Bean Class................................................................................... 74 7.5. Tuning the Stateless-Session Bean Pool .............................................................. 77 8. Developing Entity Beans .................................................................................................... 79 8.1. Introduction to Entity Beans ................................................................................ 79 8.2. The Home Interface ............................................................................................. 80 8.3. The Component Interface .................................................................................... 81 8.4. The Primary Key Class ........................................................................................ 82 8.5. The Enterprise Bean Class................................................................................... 84 8.6. Writing Database Access Operations (Bean-Managed Persistence) ................... 89 8.7. Configuring Database Access for Container-Managed Persistence..................... 91 8.8. Using CMP2.0 Persistence................................................................................... 94 8.9. Standard CMP2.0 Aspects ................................................................................... 94 8.10. JOnAS Database Mappers ................................................................................. 95 8.11. JOnAS Database Mapping (Specific Deployment Descriptor).......................... 97 8.12. Tuning a Container for Entity Bean Optimizations ......................................... 115 9. Developing Message-Driven Beans.................................................................................. 119 9.1. Description of a Message-Driven Bean ............................................................. 119 9.2. Developing a Message-Driven Bean.................................................................. 119 9.3. Administration Aspects...................................................................................... 121 9.4. Running a Message-Driven Bean ...................................................................... 122 9.5. Transactional Aspects ........................................................................................ 124 9.6. Message-Driven Beans Example ....................................................................... 124 9.7. Tuning the Message-Driven Bean Pool ............................................................. 126 10. Defining the Deployment Descriptor.............................................................................. 129 10.1. Principles.......................................................................................................... 129 10.2. Example of Session Descriptors .....................................................................