JOnAS Platform Documentation JOnAS Platform Documentation Table of Contents JOnAS Documentation....................................................................................................................................................1 Java Open Application Server (JOnAS): a J2EETM Platform..................................................................................4 Introduction...........................................................................................................................................................4 JOnAS Features....................................................................................................................................................7 JOnAS Architecture..............................................................................................................................................9 JOnAS Development and Deployment Environment.........................................................................................17 Clustering and Performance................................................................................................................................18 Perspectives.........................................................................................................................................................20 Getting started with JOnAS..........................................................................................................................................22 JOnAS Installation..............................................................................................................................................22 Running a First EJB Application........................................................................................................................23 More Complex Examples...................................................................................................................................25 Configuration Guide......................................................................................................................................................30 JOnAS Configuration Rules...............................................................................................................................31 Configuring JOnAS Environment.......................................................................................................................32 Configuring the Communication Protocol and JNDI.........................................................................................33 Configuring the Logging System (monolog)......................................................................................................36 Configuring JOnAS Services..............................................................................................................................37 Configuring Registry Service.............................................................................................................................39 Configuring EJB Container Service....................................................................................................................39 Configuring WEB Container Service.................................................................................................................40 Configuring WebServices Service......................................................................................................................41 Configuring EAR Service...................................................................................................................................42 Configuring Transaction Service........................................................................................................................42 Configuring Database Service............................................................................................................................43 Configuring Discovery Service...........................................................................................................................45 Configuring Security Service..............................................................................................................................46 Configuring JMS Service (not compliant with 2.1 MDBs)................................................................................46 Configuring Resource Service............................................................................................................................47 Configuring JMX Service...................................................................................................................................48 Configuring Mail Service...................................................................................................................................48 Configuring DB Service (hsql)...........................................................................................................................51 Configuring Security...........................................................................................................................................51 Configuring JDBC DataSources.........................................................................................................................63 Configuring Resource Adapters..........................................................................................................................68 Configuring JMS Resource Adapters.................................................................................................................74 Common Parameters...........................................................................................................................................84 i JOnAS Platform Documentation Table of Contents J2EE Application Programmer's Guide......................................................................................................................87 Target Audience and Content.............................................................................................................................87 Principles.............................................................................................................................................................87 JOnAS class loader hierarchy.............................................................................................................................89 EJB Programmer's Guide: Developing Session Beans...............................................................................................93 Target Audience and Content.............................................................................................................................93 Introduction.........................................................................................................................................................93 The Home Interface............................................................................................................................................94 The Component Interface...................................................................................................................................94 The Enterprise Bean Class..................................................................................................................................95 Tuning Stateless Session Bean Pool...................................................................................................................97 EJB Programmer's Guide: Developing Entity Beans.................................................................................................99 Target Audience and Content.............................................................................................................................99 Introduction.........................................................................................................................................................99 The Home Interface..........................................................................................................................................100 The Component Interface.................................................................................................................................102 The Primary Key Class.....................................................................................................................................103 The Enterprise Bean Class................................................................................................................................106 Writing Database Access Operations (bean−managed persistence).................................................................111 Configuring Database Access for Container−managed Persistence.................................................................113 Tuning Container for Entity Bean Optimizations.............................................................................................117 Using CMP2.0 persistence................................................................................................................................120 EJB Programmer's Guide: Message−driven Beans..................................................................................................143 Description of a Message−driven Bean............................................................................................................143 Developing a Message−driven Bean................................................................................................................143