 |
Vous n'êtes pas connecté. Connexion |
 |
Page modifiée à 11:30, 1 Fév 2011 par Max
TP1 EJB : mise en place de l'environnement, premières applicationsDe $1Table des matières
0. Installation logicielleLogiciels obligatoires :
SNAP2 NOTE : les photos d'écrans sont toutes avec Glassfish v3 prelude et avec netbeans 6.7.1, comme nous allons utiliser glassfish v3.1 final et netbeans 6.9, il se peut qu'il y ait de petites différences.
Installez donc le JDK si vous ne l'avez pas, puis netbeans, et passons à la suite. JE CONSEILLE DE DESINSTALLER LA VERSION PRECEDENTE DE NETBEANS ET DE GLASSFISH SI VOUS AVIEZ DEJA UNE ANCIENNE VERSION ! 1. Vérification de l'installationLancez netbeans une fois l'installation terminée. Cliquez sur l'onglet "services" et ouvrez l'item serveurs. Vous devez voir que tomcat et glassfish sont installés (si vous n'avez pas installé tomcat, ce n'est pas grave) : SNAP3 Vérifions maintenant que tout est ok... L'archive que nous avons installée comprend l'outil de développement netbeans mais aussi le serveur d'application de Sun, appellé Glassfish. Lancez netbeans, puis allez dans l'onglet "services". Nous allons lancer le serveur pour voir si tout est ok: SNAP4 Puis, en demandant à voir la console d'administration, cela va ouvrir la page d'admin dans votre navigateur. En entrant le mot de passe adminadmin, une belle page devrait s'afficher. J'espère que vous n'avez pas modifié le mot de passe proposé par défaut, car dans une classe de TP, les statistiques prouvent que la moitié des élèves ne se souviennent plus de leur mot de passe très rapidement! SNAP5 Le screenshot ci-dessous présente la console d'administration. Nous en reparlerons plus tard. Le fait qu'elle s'affiche dans votre navigateur prouve que l'installation est ok. SNAP6 2. Création d'un nouveau projetNous allons créer maintenant un projet pour le TP d'aujourd'hui. Allez dans le menu file/new project, puis dans la fenêtre suivante, sélectionnez JavaEE comme catégorie de projet et « enterprise application » comme projet: SNAP¨7 Cliquez sur « next », puis donnez un nom à votre projet, cliquez sur next ou suivant... SNAP8 Indiquez maitenant que nous allons utiliser le serveur d'application de Sun (glassfish v3 ou v3.1 et le mode Java EE6) SNAP9 Une fois terminé, vous verrez dans l'onglet project « trois sous projets » : SNAP10
Le fichier .ear est en fait une archive qui contient les deux autres fichiers : le .jar et le .war, il permet de déployer l'ensemble de la web application d'un seul coup. Nous verrons par la suite qu'on peut aussi mettre des EJBs dans une simple application web (nouveauté Java EE 6). 3. Création d'un premier ejb de type session bean stateless : HelloWorldAllez sur le sous projet TP1-ejb (celui avec l'icone en forme de haricot), qui correspond à la partie "ejb" du projet) et faites bouton droit/new/session bean : SNAP11 Puis dans la fenêtre suivante, indiquez le nom de votre Ejb, son type, et un nom de package (obligatoire) : SNAP12 Une fois terminé, deux fichiers sont ajoutés dans le sous-projet : HelloWord.java et HelloWorldLocal.java, qui correspondent à la classe du bean et à son interface « locale » (un bean avec un interface locale ne peut être utilisé que par un client tournant dans la même JVM : une jsp, une servlet ou un autre ejb). NOTE : si jamais on ne coche pas d'interface, ce qui n'est possible qu'avec un serveur Java EE6, cela suppose que le bean dispose par défaut d'une interface locale. Il est toujours nécessaire de créer explicitement une interface remote dans le cas d'une application distribuée. SNAP13 Ajoutons une méthode dans ce bean, la méthode getMessage() qui renvoie la chaîne de caractères «Hello World» : public String getMessage() {
System.out.println("Hello World qui va s'afficher dans la console du serveur, pour trace");
return "Hello World";
}
Dans l'éditeur, une petite lampe jaune doit apparaître sur la gauche de l'en-tête de la méthode. Lorsqu'on clique dessus, une ou des actions sont proposées. SNAP14 Cette action ajoute automatiquement la déclaration de la méthode getMessage() dans l'interface HelloWorldLocal.java. @Local
public interface HelloWorldLocal {
java.lang.String getMessage();
}
Rappel : les lignes commençant par @ sont des "attributs de code" ou encore des "annotations de code". Ce sont en fait des méta-données… Elles serviront au compilateur à générer du code contextuel. Ceci permet de n'avoir dans le source .java que du POJO (Plain Old Java Object, une classe java "normale" en fin de compte !) 4. Ecriture d'une servlet client de test de ce beanSur le projet finissant par -war, faites clic-droit/new/Servlet : SNAP15 N'oubliez pas de donner un nom de package ! SNAP16 Vous verrez que votre servlet est apparue dans les sources du projet. Dans un projet Java EE 6, les caractéristiques des servlets ne se trouvent plus dans un descripteur web.xml, mais directement dans le code source, sous la forme d'annotations de code (lignes commençant par @). Ouvrez donc le code source de votre servlet et observez les annotations de code. Le second paramètre de l'annotation WebServlet indique le chemin relatif de l'URL auquel la servlet va répondre (c.f., Rappel URL ci-dessous). Vous pouvez modifier directement le code pour modifier l'URL, ou même utiliser des expressions régulières, par exemple : /Servlet* etc. Rappel : URLs : SNAP17 SNAP18 SNAP19 @WebServlet(name="ServletTest", urlPatterns={"/ServletTest"})
public class ServletTest extends HttpServlet {
Dans les sources de cette servlet, on va indiquer que l'on va « parler » au bean HelloWorld. Pour cela, cliquez avec le bouton droit dans le code de la servlet (n'importe où) et selectionnez « insert code » :
Un menu apparait, choisissez "call enterprise bean" :
Cela va insérer dans la Servlet deux lignes de code qui vont correspondre à la fois à la déclaration et à l'initialisation d'une variable référençant un objet du type de l'interface du Bean que l'on souhaite appeler. Le @EJB est l'annotation de code qui va procéder à "l'injection de code" lors de la compilation ou du déploiement. La variable helloWorld sera initialisée par le code injecté et ne vaudra pas "null" comme cela pourrait sembler : public class ServletTest extends HttpServlet {
@EJB
private HelloWorldLocal helloWorld;
Notons aussi que quelques imports ont étés rajoutés, ce sont ceux dont le code généré aura besoin. La variable helloWorld référençant un objet du type de l'interface du Bean HelloWorld va, à partir de maintenant pouvoir être utilisé directement dans la servlet, sans que l'on ait besoin de l'initialiser. Ajoutons la ligne suivantes dans la méthode processRequest de la servlet, après avoir décommenté les lignes de processRequest() : ...
try {
out.println("<html>");
out.println("<head>");
out.println("<title>Servlet ServletTest</title>");
out.println("</head>");
out.println("<body>");
out.println("<h1>Servlet ServletTest at " + request.getContextPath () + "</h1>");
out.println("L'ejb HelloWorld a renvoyé : <em>" + helloWorld.getMessage() + "</em>");
out.println("</body>");
out.println("</html>");
} finally {
...
Sauvegardons le tout, et exécutons le projet principal : clic droit sur le projet-TRIANGLE, puis "exécuter" SNAP20 Cela va avoir pour effet de lancer le serveur d'application, (cette opération peut prendre un certain temps, des lignes vont s'afficher et au final, vous devriez avoir la ligne ci-dessous : GÉNÉRATION TERMINÉE (durée totale X seconde)
Votre projet a été déployé. Normalement après un certain temps, le navigateur ouvre une page par défaut. INFO : le fichier index.jsp se trouve dans le dossier "Web Pages" du sous-projet "TP1-war". Rajoutons juste l'URL relatif de la servlet à la fin : (e.g., http://localhost:8080/TP1-war/ServletTest ). Cela invoque la servlet.
SNAP21 Voilà, vous avez exécuté votre première appli web utilisant des EJBs !!!! 5. Modifions la page par défaut et insérons un petit menuLa page par defaut est la page index.jsp du projet. Modifions là pour ajouter un menu avec une entrée qui permet de lancer la servlet facilement. Pour cela, double cliquez sur la page index.jsp dans le dossier Web Pages du sous-projet war. Nous pouvons simplifier l'ajout de HTML en utilisant la palette disponible à partir de Outils>palette (CTRL+MAJ+8) SNAP22 Modifiez le source comme ceci : <%@page contentType="text/html" pageEncoding="UTF-8"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>JSP accueil TP1</title>
</head>
<body>
<h1>Menu du TP1</h1>
<ul>
<li><a href="ServletTest">Appeler la Servlet de test</a></li>
</ul>
</body>
</html>
6. Ecriture d’un second bean appelé par le bean HelloWorld
Au final, lorsqu’on exécute la servlet de test, cela doit afficher : L'ejb HelloWorld a renvoyé : Hello World Je suis le second bean, appelé par le bean HelloWorld
Accès à une base de donnée via un entity bean et un persistence managerLa base de données, prise de contactSans aller trop loin, nous allons un peu jouer avec une base de données d'exemple livrée avec le JDK. Les outils dont vous disposez viennent en effet en standard avec une petite base de données d'exemple. Vous pouvez la consulter en cliquant sur l'onglet Services et en allant dans Databases/jdbc:derby//.../sample Si jamais l'icône est cassée, faite clic droit/connect, le mot de passe est "app"...
Dans cette base vous allez trouver les tables CUSTOMER, MANUFACTURER etc... en faisant click droit/view data sur les tables vous pouvez également consulter les données qui sont déjà disponibles. Nous allons jouer pendant plusieurs TPs avec cette petite base de données.
Création d'un entity bean proxy de la table MANUFACTUREROk, passons aux choses sérieuses, nous allons créer un entity bean proxy vers la table MANUFACTURER. Pour cela bouton droite sur le projet ejb et choisissez entity classes from database, dans la fenêtre qui s'ouvre choisissez jdbc/sample comme datasource et parmis les tables proposées choisissez MANUFACTURER.
Cliquez sur next et n'oubliez pas en bas de la fenêtre de dialogue suivante, de cliquer le bouton create persistence unit, ça va avoir pour effet de créer un Persistence Manager pour le projet, soit en d'autres termes un module qui va gérer le mapping entre le monde des objets java et le monde des base de données relationnelles.
Une fois le bouton cliqué on a une autre fenêtre qui apparait, permettant de choisir l'outil externe qui va assurer le mapping relationnel/objet. Par défaut c'est l'outil Toplink (autrefois payant et développé par Oracle) qui est proposé, mais si vous regardez le menu on peut aussi choisir l'outil très populaire Hibernate développé par JBoss. Gardez pour le moment les valeurs par défaut.
On va choisir Create comme option, ce qui signifie que si besoin est on laissera le serveur d'application créer de nouvelles tables. /*
* To change this template, choose Tools | Templates
* and open the template in the editor.
*/
package tp1;
import java.io.Serializable;
import javax.persistence.Basic;
import javax.persistence.Column;
import javax.persistence.Entity;
import javax.persistence.Id;
import javax.persistence.NamedQueries;
import javax.persistence.NamedQuery;
import javax.persistence.Table;
/**
*
* @author michel
*/
@Entity
@Table(name = "MANUFACTURER")
@NamedQueries({@NamedQuery(name = "Manufacturer.findAll",
query = "SELECT m FROM Manufacturer m"), @NamedQuery(name = "Manufacturer.findByManufacturerId",
query = "SELECT m FROM Manufacturer m WHERE m.manufacturerId = :manufacturerId"),
@NamedQuery(name = "Manufacturer.findByName", query = "SELECT m FROM Manufacturer m WHERE m.name = :name"),
@NamedQuery(name = "Manufacturer.findByAddressline1",
query = "SELECT m FROM Manufacturer m WHERE m.addressline1 = :addressline1"),
@NamedQuery(name = "Manufacturer.findByAddressline2",
query = "SELECT m FROM Manufacturer m WHERE m.addressline2 = :addressline2"),
@NamedQuery(name = "Manufacturer.findByCity", query = "SELECT m FROM Manufacturer m WHERE m.city = :city"),
@NamedQuery(name = "Manufacturer.findByState", query = "SELECT m FROM Manufacturer m WHERE m.state = :state"),
@NamedQuery(name = "Manufacturer.findByZip", query = "SELECT m FROM Manufacturer m WHERE m.zip = :zip"),
@NamedQuery(name = "Manufacturer.findByPhone", query = "SELECT m FROM Manufacturer m WHERE m.phone = :phone"),
@NamedQuery(name = "Manufacturer.findByFax", query = "SELECT m FROM Manufacturer m WHERE m.fax = :fax"),
@NamedQuery(name = "Manufacturer.findByEmail", query = "SELECT m FROM Manufacturer m WHERE m.email = :email"),
@NamedQuery(name = "Manufacturer.findByRep", query = "SELECT m FROM Manufacturer m WHERE m.rep = :rep")})
public class Manufacturer implements Serializable {
private static final long serialVersionUID = 1L;
@Id
@Basic(optional = false)
@Column(name = "MANUFACTURER_ID")
private Integer manufacturerId;
@Column(name = "NAME")
private String name;
@Column(name = "ADDRESSLINE1")
private String addressline1;
@Column(name = "ADDRESSLINE2")
private String addressline2;
@Column(name = "CITY")
private String city;
@Column(name = "STATE")
private String state;
@Column(name = "ZIP")
private String zip;
@Column(name = "PHONE")
private String phone;
@Column(name = "FAX")
private String fax;
@Column(name = "EMAIL")
private String email;
@Column(name = "REP")
private String rep;
public Manufacturer() {
}
public Manufacturer(Integer manufacturerId) {
this.manufacturerId = manufacturerId;
}
public Integer getManufacturerId() {
return manufacturerId;
}
Vous verrez que des méthodes permettant de rechercher des informations ont été automatiquement créées, que les attributs de la classe ont été associé (via des attributs de code) avec des colonnes, que la table sur laquelle se mappe ce bean est MANUFACTURER, etc... Remarquez les requêtes nommées qui ont été générées, notamment la requête "FindAll" qui correspond à un select * from MNUFACTURER en SQL : @NamedQuery(name = "Manufacturer.findAll", query = "SELECT m FROM Manufacturer m")
Modification du bean HelloWorld pour qu'il fasse un findAll sur les manufacturersOuvrez le source du bean HelloWorld. On va lui indiquer que nous allons utiliser le persistence manager que nous venons de créer pour utiliser des requêtes. Pour cela: bouton de droite/persistence/use entity manager.
Cela va insérer deux lignes dans le code de l'EJB : @Stateless
public class HelloWorldBean implements HelloWorldLocal {
@PersistenceContext
private EntityManager em;
Ces deux lignes déclarent que l'objet em est un entity manager et qu'il s'agit de l'entity manager par défaut. Dans un projet on peut avoir plusieurs persistence managers qui travaillent sur des bases de données différentes. Leurs caractéristiques se trouvent dans le fichier persistence.xml. Si on en a plusieurs, le premier est celui par defaut et il n'est pas la peine de le nommer. Si on veut indiquer que l'on utilise un persistence manager particulier on peut donner son nom, comme ici : @Stateless
public class HelloWorldBean implements HelloWorldLocal {
@PersistenceContext(name="TP1EJB_2009-ejbPU")
private EntityManager em;
Au passage, vous pouvez voir le nom du persistance manager en cliquant sur le fichier persistence.xml dans le projet ejb :
Pour le moment, ce n'est pas la peine de s'embêter, puisque nous n'en avons qu'un, laissons le code tel qu'il est par défaut (sans nom précisé). Ajoutez maintenant ce bout de code dans le bean : Ajoutez ce bout de code dans le bean: public void printAllManufacturers() {
Query query = em.createNamedQuery("Manufacturer.findAll");
Collection< Manufacturer > result = query.getResultList();
for(Manufacturer cust:result ) {
System.out.println(cust.getName());
}
}
Cette méthode utilise l'entity manager pour exécuter la requête Manufacturer.findAll. Rajoutez cette méthode dans l'interface, puis appelez-là depuis la servlet. Sauvez, déployez, testez. Dans la console du serveur d'application (dans netbeans), vous devez avoir la liste des fournisseurs qui s'affiche : Google Sun MicroSystems Acer Matrox 3Com CBX Cables Sony Getaway SoftClip Toshiba Sams Publishing Computer Cables & More BMC ... Affichage des résultats dans une page JSPNous allons modifier votre projet pour que la liste des manufacturers soit affichée dans une page Jsp une fois que l'on a cliqué sur le bouton de la page jsp initiale, au lieu de s'afficher dans la console avec des printlns... public Collection getAllManufacturers() {
Query query = em.createNamedQuery("Manufacturer.findAll");
Collection< Manufacturer > result = query.getResultList();
return result;
}
protected void processRequest(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
//out.println("L'ejb HelloWorld a renvoyé :" + helloWorldBean.getMessage());
//out.close();
Collection manufacturers = helloWorldBean.getAllManufacturers();
request.setAttribute("Manufacturers", manufacturers);
RequestDispatcher dp = request.getRequestDispatcher("DisplayManufacturers.jsp");
dp.forward(request, response);
}
<%@page contentType="text/html"%>
<%@page pageEncoding="UTF-8"%>
<%--
The taglib directive below imports the JSTL library. If you uncomment it,
you must also add the JSTL library to the project. The Add Library... action
on Libraries node in Projects view can be used to add the JSTL 1.1 library.
--%>
<%@taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>JSP Page</title>
</head>
<body>
<h1>List of Manufacturers</h1>
<ul>
<c:forEach var="u" items="${requestScope['Manufacturers']}">
<li>${u.name}</li>
</c:forEach>
</ul>
</body>
</html>
La ligne <%@taglib... %> indique que nous allons utiliser une librairie de tag JSP particulière : la JSP Standard Tag Library (JSTL), livrée en standard avec J2EE. Cette librairie fournit des mécanismes pour manipuler les paramètres HTTP, etc... sans avoir besoin d'écrire du java. La ligne avec le foreEach par exemple récupère un paramètre intitulé Manufacturers (ça tombe bien, c'est celui que nous avons passé depuis la servlet) et itère sur chaque élément (forEach...), puis on peut appeler les méthodes getName() etc... juste en les nommant, au travers de ce que l'on appelle "une variable JSP" : ${u.name}. Cette écriture est équivalent à un System.out.println(elem.getName()); ou elem est de type Manufacturer. C'est plus simple quand même ${u.name} que ce long println... Exécutez, cela doit afficher dans le navigateur la liste des Manufacturers. Ajout d'un nouveau manufacturer
Modification du bean HelloWorld pour créer un nouveau manufacturer:...
printAllManufacturers();
// On crée un nouveau customer
Manufacturer c = new Manufacturer();
c.setName("Michel Buffa");
// Nouvelle clé primaire
c.setManufacturerId(100);
em.persist(c);
System.out.println(################# APRES AJOUT ################);
printAllManufacturers();
Simple non ? La méthode persist permet d'ajouter un nouveau manufacturer dans la table.
|
Powered by MindTouch Deki Open Source Edition v.8.08 |
