Documentation JOnAS

Documentation de la plate−forme JOnAS

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..........................................................................................................................17
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..................................................................................................................................45
Configurer le Service Ressource.........................................................................................................................46
Configurer le Service JMX.................................................................................................................................46
Configurer le Service Mail..................................................................................................................................47
Configurer la Sécurité.........................................................................................................................................49
Configurer les sources de données JDBC...........................................................................................................61
Configurer les Connecteurs JDBC......................................................................................................................65
Guide du Programmeur d'Application J2EE..............................................................................................................72
Public auquel il est destiné et son contenu..........................................................................................................72
Principes..............................................................................................................................................................72
Hiérarchie de chargeurs de classe JOnAS...........................................................................................................74
Documentation de la plate−forme JOnAS
i

Table des matières
Guide du programmeur EJB: Développer des Beans Sessions..................................................................................77
Public visé et contenu.........................................................................................................................................77
Introduction.........................................................................................................................................................77
L'interface d'accueil............................................................................................................................................78
L'interface du composant....................................................................................................................................78
La classe d'implémentation de l'EJB...................................................................................................................79
Ajuster le pool de Bean Session Stateless...........................................................................................................81
EJB Programmer's Guide: Developing Entity Beans.................................................................................................83
Target Audience and Content.............................................................................................................................83
Introduction.........................................................................................................................................................83
The Home Interface............................................................................................................................................84
The Component Interface...................................................................................................................................86
The Primary Key Class.......................................................................................................................................87
The Enterprise Bean Class..................................................................................................................................89
Writing Database Access Operations (bean−managed persistence)...................................................................94
Configuring Database Access for Container−managed Persistence...................................................................96
Tuning Container for Entity Bean Optimizations.............................................................................................100
Using CMP2.0 persistence................................................................................................................................102
Guide du programmeur EJB : Développer des Beans "Message−driven"............................................................125
Description d'un Bean Message−driven............................................................................................................125
Développer un Bean Message−driven..............................................................................................................126
Aspects administration......................................................................................................................................128
Exécuter un Bean Message−driven...................................................................................................................129
Aspects Transactionnels....................................................................................................................................131
Exemple............................................................................................................................................................131
Régler le pool de Beans Messages....................................................................................................................134
Guide du programmeur EJB: Comportement transactionnel................................................................................135
Public visé et contenu.......................................................................................................................................135
Gérer les transactions de manière déclarative...................................................................................................135
Transactions gérées par le Bean........................................................................................................................137
Gestion des transactions distribuées.................................................................................................................137
EJB Programmer's Guide: Enterprise Bean Environment.....................................................................................140
Target Audience and Content...........................................................................................................................140
Introduction.......................................................................................................................................................140
Environment Entries.........................................................................................................................................140
Resource References.........................................................................................................................................141
Resource Environment References...................................................................................................................142
EJB References.................................................................................................................................................142
Documentation de la plate−forme JOnAS
ii

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

Table des matières
Guide de l'intégrateur d'application J2EE................................................................................................................180
Public visé et contenu.......................................................................................................................................180
Définir le descripteur de déploiement d'Ear......................................................................................................180
Packager un EAR..............................................................................................................................................182
Guide de déploiement et d'installation.......................................................................................................................184
Public visé.........................................................................................................................................................184
Principes des processus de déploiement et d'installation..................................................................................184
Exemple de déploiement et d'installation d'EJB en utilisant un fichier ejb−jar................................................185
Déploiement et installation d'une application Web..........................................................................................186
Déploiement et installation d'une application J2EE..........................................................................................187
Guide d'Administration...............................................................................................................................................188
jonas admin.......................................................................................................................................................188
JonasAdmin.......................................................................................................................................................188
Guide de référence des commandes JOnAS..............................................................................................................193
jonas..................................................................................................................................................................193
jclient.................................................................................................................................................................196
newbean............................................................................................................................................................197
registry..............................................................................................................................................................199
CheckEnv..........................................................................................................................................................199
EJBServer.........................................................................................................................................................200
GenIC................................................................................................................................................................201
JmsServer..........................................................................................................................................................203
JonasAdmin.......................................................................................................................................................203
RAConfig..........................................................................................................................................................205
Services JOnAS............................................................................................................................................................208
A qui il est destiné et pour quoi faire................................................................................................................208
Introduire un nouveau Service..........................................................................................................................208
Compréhension avancée...................................................................................................................................210
Guide de l'utilisateur JMS..........................................................................................................................................213
Installation et configuration de JMS.................................................................................................................213
Ecriture d'opérations JMS au sein d'un composant d'application.....................................................................214
Quelques règles de programmation et restrictions quand on utilise JMS dans les EJB...................................217
Administration JMS..........................................................................................................................................220
Exécution d'un EJB réalisant des opérations JMS............................................................................................222
Un exemple d'EJB JMS....................................................................................................................................224
Documentation de la plate−forme JOnAS
iv