Guide Pratique EDI NetBeans

Guide Pratique EDI
NetBeans
Copyright © 2005 Sun Microsystems, Inc. All rights reserved.
Table des matières
Assistant type de Projet EJB.............................................................................................................2
Structure Module EJB.......................................................................................................................5
Ajout d'EJB, Fichiers et Bibliothèques à votre Module EJB..............................................................6
Ajout de la Logique Métier à un Enterprise Java Bean.....................................................................9
Méthodes de Bean.......................................................................................................................9
Ajout d'une Simple Méthode Métier................................................................................................12
Descripteurs de Déployement EJB Bean .......................................................................................14
Etendre des
Applications Web
avec de la Logique
Métier: Introduction
aux Composants
EJB
Pour la plupart des utilisateurs de NetBeans, ainsi que pour les développeurs d'applications
Web, le concept d'Enterprise JavaBeans peut être nouveau ou apparemment complexe, comme
c'est la première fois que l'EDI NetBeans 4.1 expose les assistants et fonctionnalités nécessaires
pour créer facilement des EJB et leur ajouter des méthodes Métiers. Une fois que ces méthodes
Métiers sont implémentées (en Java), elles peuvent être appelée sui depuis d'autres EJB, ou
depuis des servlettes d'applications Web, ou des classes utilitaires. Les avantages d'encapsuler le
code de l'application dans des méthodes métiers d'EJB sont nombreux:
[nl] Les Enterprise JavaBeans supporte les transactions, le mécanisme qui gére les
accès concurrentiels à des objets partagés. Le paramétrage de Transaction est
déclaratif, via les fichiers de descripteur de déployement.
Guide Pratique EDI NetBeans, Extention Applications Web avec Logique Métier: Introduction aux
Composants EJB, 1

[nl] Enterprise Java Beans peuvent être utilisés par plusieurs clients, sur différentes
machines, ou non (accès local et/ou distant)
[nl] Les méthodes métiers des Enterprise Java Beans peuvent être sécurisés
déclarativement, sans modification de code source.
[nl] Enterprise Java Beans accèdent aux ressources externes, comme les bases de
données, les message queues, les mail sessions, services Web, déclarativement,
via JNDI: Java Naming and Directory Interface (JNDI). JNDI permet aux
composants de localiser d'autres composants et ressources. Pour localiser une
ressource JDBC, par exemple, un Enterprise JavaBean invoque la méthode
lookup du JNDI. JNDI maintient un ensemble d'associations entre un nom et
un objet. La méthode lookup passe un nom JNDI comme paramètre et retourne
l'objet associé.
Voir Tableau 8-1 pour une liste de tous les types d'EJB.
Types
d'Enterprise Java
Bean
Description
Session Exécute une tâche pour un client; implémente un service Web. Un Session
Bean peut être stateful pour la gestion de la conversation entre le client
(l'utilisateur de la logique métier) et le Serveur, ou stateless.
Entity Représente un objet d'entité metier qui existen dans un stockage persistant.
Typiquement, une base de données SQL (mais il existe d'autres possibilités)
Message-Driven Agit comme un listener pour un Java Message Service API, traitant les
messages de façon asynchrone.
Assistant type de Projet EJB.
La première chose à faire pour développer des EJB est de créer un projet EJB Module qui peut
contenir un ou plusieurs Enterprise JavaBeans. Pour donner une analogie avec le concept
d'application Web, tandis qu'une application Web est un composant J2EE déployable, contenant
un ensemble de servlettes, pages web, et JSP, un module EJB est également un composant
J2EE déployable, contenant un ensemble d'Enterprise Java Beans.
[lb] Pour créer un projet EJB Module dans l'EDI NetBeans 4.1, choisissez le
type de projet “Ejb Module” qui est dans la catégorie “Enterprise”.
Guide Pratique EDI NetBeans, Extention Applications Web avec Logique Métier: Introduction aux
Composants EJB, 2

[lb] Vous pouvez alors spécifier l'emplacement du projet, son nom, et si oui ou non
vous désirez rajouter ce composant J2EE à une application J2EE existante
(projet EAR). Vous pouvez toujours faire cela lorsque vous aurez créé un projet
d'Application J2EE.
[lb] Votre projet est créé et visible dans la fenêtre Projects. Il ne contient pas de
composant Enterprise JavaBeans, aussi, votre première tâche sera d'en rajouter
un (voir section suivante)
Guide Pratique EDI NetBeans, Extention Applications Web avec Logique Métier: Introduction aux
Composants EJB, 3

[lb] Vous pouvez sélectionner la fenêtre Files pour voir les répertoires et fichiers qui
ont été créés sur disque. La section suivante décrit la convention utilisée pour
cette structure.
Guide Pratique EDI NetBeans, Extention Applications Web avec Logique Métier: Introduction aux
Composants EJB, 4

Structure Module EJB
Les J2EE Blueprints fournissent des guidelines sur la façon de structurer
vos applications J2EE et modules EJB pour s'assurer qu'ils fonctionnent
proprement avec les différents serveurs d'application. Lorsque vous
créez un projet dans l'EDI, cette convention de structure J2EE Blueprints
est respectée.
Ce qui suit est une description rapide des éléments structurels du module
EJB généré:
[lb] Le dossier src/java qui contient tous les fichiers sources Java dans
l'application.
[lb] src/conf qui contient les descripteurs de déployement J2EE et les
descripteurs de déployement spécifiques aux serveurs d'application
[lb] Le répertoire de setup qui contient les fichiers de ressources spécifiques
au serveur
Vous pouvez trouver des informations supplémentaires sur ces
conventions à l'adresse
https://conventions.dev.java.net/
Voir le Tableau 8-2 pour des informations sur comment les nombreux
éléments sources d'un Module EJB correspondent avec leur
représentation dans l'EDI et où ils finissent dans le composant déployé.
Tableau 8-2:
Contenu Représentation dans la
fenêtre Projects
Représentation dans la
fenêtre Files
Emplacement dans le
Fichier EJB JAR Généré
(situé dans le dossier dist)
EJBs Noeud Enterprise
JavaBeans
Répertoire src/java Racine du fichier
Fichiers sources Java,
classes d'aide, fichiers Java
EJB, etc.
Noeud Source Packages Répertoire src/java Package structure for the
JAR file
Tests unitaires Noeud Test Packages Répertoire test N/A
Descripteurs de
déployement (ejb-
jar.xml,
webservices.xml)
Noeud Configuration Files Répertoire src/conf Dossier META-INF
Fichier de configuration du
contexte et Descripteurs de
déployement serveurs
d'Application (sun-
ejb-jar.xml, sun-
cmp-mapping.xml,
others)
répertoire src/conf Dossier META-INF
Guide Pratique EDI NetBeans, Extention Applications Web avec Logique Métier: Introduction aux
Composants EJB, 5