Documentation de la plate

Documentation de la plate−forme JOnAS
Frederic Maistre

Table des matières
Documentation JOnAS....................................................................................................................................................1
Java Open Application Server (JOnAS): une Plate−forme J2EETM........................................................................3
Introduction...........................................................................................................................................................3
Les fonctionnalités de JOnAS...............................................................................................................................6
L'architecture JOnAS............................................................................................................................................8
Environnement de développement et de déploiement sur JOnAS......................................................................16
Mise en Cluster et Performance..........................................................................................................................18
Perspectives.........................................................................................................................................................20
Démarrer avec JOnAS...................................................................................................................................................22
Installation de JOnAS.........................................................................................................................................22
Exécuter une première application à base d'EJB................................................................................................23
Des exemples plus complexes............................................................................................................................25
Guide de Configuration.................................................................................................................................................30
Les règles de configuration de JOnAS................................................................................................................31
Configurer l'environnement JOnAS....................................................................................................................32
Configurer le Protocole de Communication et l'interface JNDI.........................................................................33
Configurer le système de trace (monolog)..........................................................................................................35
Configurer les Services JOnAS..........................................................................................................................37
Configurer le Service Registre............................................................................................................................38
Configurer le Service Conteneur EJB.................................................................................................................39
Configurer le Conteneur WEB............................................................................................................................39
Configurer le Service WebServices....................................................................................................................40
Configurer le Service EAR.................................................................................................................................41
Configurer le Service transaction........................................................................................................................42
Configurer le Service Base de Données..............................................................................................................42
Configurer le Service de Sécurité.......................................................................................................................45
Configurer le Service JMS (non compatible avec les MDB 2.1).......................................................................45
Configurer le Service Ressource.........................................................................................................................46
Configurer le Service JMX.................................................................................................................................47
Configurer le Service Mail..................................................................................................................................47
Configurer le service DB (hsql)..........................................................................................................................49
Configurer la Sécurité.........................................................................................................................................50
Configurer les sources de données JDBC...........................................................................................................62
Configurer les Connecteurs JDBC......................................................................................................................66
Configurer les connecteurs JMS.........................................................................................................................72
Guide du Programmeur d'Application J2EE..............................................................................................................78
Public auquel il est destiné et son contenu..........................................................................................................78
Principes..............................................................................................................................................................78
Documentation de la plate−forme JOnAS
i

Table des matières
Guide du Programmeur d'Application J2EE
Hiérarchie de chargeurs de classe JOnAS...........................................................................................................80
Guide du programmeur EJB: Développer des Beans Sessions..................................................................................83
Public visé et contenu.........................................................................................................................................83
Introduction.........................................................................................................................................................83
L'interface d'accueil............................................................................................................................................84
L'interface du composant....................................................................................................................................84
La classe d'implémentation de l'EJB...................................................................................................................85
Ajuster le pool de Bean Session Stateless...........................................................................................................87
EJB Programmer's Guide: Developing Entity Beans.................................................................................................89
Target Audience and Content.............................................................................................................................89
Introduction.........................................................................................................................................................89
The Home Interface............................................................................................................................................90
The Component Interface...................................................................................................................................92
The Primary Key Class.......................................................................................................................................93
The Enterprise Bean Class..................................................................................................................................95
Writing Database Access Operations (bean−managed persistence).................................................................101
Configuring Database Access for Container−managed Persistence.................................................................103
Tuning Container for Entity Bean Optimizations.............................................................................................107
Using CMP2.0 persistence................................................................................................................................109
Guide du programmeur EJB : Développer des Beans "Message−driven"............................................................132
Description d'un Bean Message−driven............................................................................................................132
Développer un Bean Message−driven..............................................................................................................133
Aspects administration......................................................................................................................................135
Exécuter un Bean Message−driven...................................................................................................................136
Aspects Transactionnels....................................................................................................................................138
Exemple............................................................................................................................................................138
Régler le pool de Beans Messages....................................................................................................................141
Guide du programmeur EJB: Comportement transactionnel................................................................................142
Public visé et contenu.......................................................................................................................................142
Gérer les transactions de manière déclarative...................................................................................................142
Transactions gérées par le Bean........................................................................................................................144
Gestion des transactions distribuées.................................................................................................................144
EJB Programmer's Guide: Enterprise Bean Environment.....................................................................................147
Target Audience and Content...........................................................................................................................147
Introduction.......................................................................................................................................................147
Environment Entries.........................................................................................................................................147
Documentation de la plate−forme JOnAS
ii

Table des matières
EJB Programmer's Guide: Enterprise Bean Environment
Resource References.........................................................................................................................................148
Resource Environment References...................................................................................................................149
EJB References.................................................................................................................................................149
Deprecated EJBContext.getEnvironment() method..........................................................................................151
Guide du programmeur EJB : Gestion de la sécurité..............................................................................................152
Public visé et contenu.......................................................................................................................................152
Introduction.......................................................................................................................................................152
Gestion déclarative de la securité.....................................................................................................................152
Gestion programmée de la sécurité...................................................................................................................153
Guide du programmeur EJB : Définir le descripteur de déploiement...................................................................156
Public visé et contenu.......................................................................................................................................156
Principes............................................................................................................................................................156
Exemple de descripteur pour un Bean Session.................................................................................................157
Exemple de descripteur pour un Bean Entité avec persistance CMP (CMP 1.1).............................................159
Astuces..............................................................................................................................................................161
EJB Programmer's Guide: EJB Packaging...............................................................................................................162
Target Audience and Content...........................................................................................................................162
Principles...........................................................................................................................................................162
Guide du programmeur d'applications web..............................................................................................................163
Public visé et Sommaire....................................................................................................................................163
Développement de composants Web................................................................................................................163
Définir le descripteur de déploiement web.......................................................................................................169
Les packages WAR...........................................................................................................................................173
Guide du Programmeur de Connecteur J2EE..........................................................................................................174
Public auquel ce guide est destiné et son contenu............................................................................................174
Principes............................................................................................................................................................174
Definir le Descripteur de Déploiement de Connecteur JOnAS........................................................................174
Packaging d'un Connecteur...............................................................................................................................176
Utilisation et Déploiement d'un Connecteur.....................................................................................................176
Connecteurs JDBC............................................................................................................................................178
Annexe : Principes de l'Architecture J2EE Connecteur....................................................................................179
Guide du programmeur d'applications clientes J2EE..............................................................................................181
Public visé et sommaire....................................................................................................................................181
Démarrer une application J2EE client..............................................................................................................181
Définir le descripteur de déploiement client.....................................................................................................183
Documentation de la plate−forme JOnAS
iii

Table des matières
Guide du programmeur d'applications clientes J2EE
Package Client..................................................................................................................................................185
Guide de l'intégrateur d'application J2EE................................................................................................................187
Public visé et contenu.......................................................................................................................................187
Définir le descripteur de déploiement d'Ear......................................................................................................187
Packager un EAR..............................................................................................................................................189
Guide de déploiement et d'installation.......................................................................................................................191
Public visé.........................................................................................................................................................191
Principes des processus de déploiement et d'installation..................................................................................191
Exemple de déploiement et d'installation d'EJB en utilisant un fichier ejb−jar................................................192
Déploiement et installation d'une application Web..........................................................................................193
Déploiement et installation d'une application J2EE..........................................................................................194
Guide d'Administration...............................................................................................................................................195
jonas admin.......................................................................................................................................................195
JonasAdmin.......................................................................................................................................................195
Guide de référence des commandes JOnAS..............................................................................................................200
jonas..................................................................................................................................................................200
jclient.................................................................................................................................................................203
newbean............................................................................................................................................................204
registry..............................................................................................................................................................206
GenIC................................................................................................................................................................206
JmsServer..........................................................................................................................................................208
RAConfig..........................................................................................................................................................209
Services JOnAS............................................................................................................................................................211
A qui il est destiné et pour quoi faire................................................................................................................211
Introduire un nouveau Service..........................................................................................................................211
Compréhension avancée...................................................................................................................................213
Guide de l'utilisateur JMS..........................................................................................................................................216
Installation et configuration de JMS.................................................................................................................216
Ecriture d'opérations JMS au sein d'un composant d'application.....................................................................217
Quelques règles de programmation et restrictions quand on utilise JMS dans les EJB...................................220
Administration JMS..........................................................................................................................................223
Exécution d'un EJB réalisant des opérations JMS............................................................................................225
Un exemple d'EJB JMS....................................................................................................................................227
Documentation de la plate−forme JOnAS
iv