Java Enterprise Edition

Objectif
Se former sur les technologies web en java
Modalités
Ratio:
30% de théorie - 70% de pratique
Outils utilisés:
Eclipse, Netbeans, Jboss
Durée:
32 heures
Evaluation:
par binôme, dossier de projet et démo lors de la dernière séance.
Cours
Les technologies JEE5
TP

• Appréhender les outils de développement
• Appréhender les technologies jsp-servlet-jsf-jpa etc...
• Rédiger une spécification fonctionnelle simplifiée
• Concevoir un modèle métier simplifié (6 classes)
• Banque
• Client
• Compte
• Compte-epargne
• Compte-courant
• Ville
• Implémenter les classes
• Réaliser des jeux de test unitaire
• Concevoir l'architecture technique (serveur web)
• Réaliser le serveur web
• Concevoir l'interface utilisateur
• Choisir la technologie de persistance des objets métier
• Coder les classes d'accès aux données
• Intégration et tests

Supports de cours
introduction.ppt
jee5-jsp.ppt
jee5-jsf(1).ppt
jee5-jsf(2).ppt
Supports de tp
tp1: jee-servlet
tp2: jee-jsf
tp3: convertisseurs-validateurs-événements
tp3: bis valuechangelistener et cycle de vie
tp4: modèle du domaine avec de simples beans: Application bancaire
tp5: crud: navigation dans le modèle et mise à jour des données
tp6: base de données relationnelle Hypersonic
tp7: a) jdbc, introduction au mapping objet-relationnel
tp7: b) JBoss et sa base de données interne Hsqldb
tp8: mise en oeuvre de JPA (Java Persistence Api)
tp10: modèle du domaine simplifié
tp12: modèle du domaine simplifié (jpa+hibernate+dao+web)
Corrigés de tp
tp2: datatable, formulaire
tp3a: convertisseurs, validateurs
tp3b: listeners, lifecycle
tp3b: v2 listeners, lifecycle
tp4: modèle du domaine avec de simples beans: Application bancaire
tp5: crud
tp8: mise en oeuvre de JPA
tp10: v1 - modèle du domaine simplifié (simples javabeans)
tp10: v2 - modèle du domaine simplifié (jpa+hibernate)
tp11: modèle du domaine simplifié (jpa+hibernate+web)
tp11: modèle du domaine simplifié (jpa+hibernate+web sans libs)
tp12: modèle du domaine simplifié (jpa+hibernate+dao+web)

MyFaces
tp JBoss-MyFaces
tp MyFaces-exemples
Bibliothèques JEE
hibernate
hsqldb

TP: Crud Create-Retrieve-Update-Delete

Architecture
L'application est vue comme un modèle de données du domaine fortement structuré et typé et couplé.

Cette couche métier à caractère statique côtoie une couche d'interface utilisateur (swing, html, jsp, dans notre cas jsf), ainsi qu'une couche applicative constituée par les contrôleurs, à caractère dynamique.

Ce modèle du domaine est bien découplé des deux autres couches, ainsi que des couches techniques (persistance par exemple).

Dans le cas où le modèle est connecté avec un ou plusieurs modèles externes, cette connection s'effectuera au travers d'une API consitutée d'interfaces.

Les classes métier comportent des règles-métier de base (l'âge d'un personne ne peut être négatif....)
Les contrôleurs comportent des règles métier applicatives (on ne peut changer de département pour telle adresse, le solde du compte ne peut être inférieur à une limite autorisée).

Développer une application revient à concevoir et à coder le modèle statique, la mécanique navigationnelle (Crud = create-retrieve-update-delete), les règles de gestion et les exceptions-métier, l'interface utilisateur, après avoir choisi une infrastructure technique (jsf dans notre cas) et une solution de persistance du modèle (jdbc, hibernate, ejb, etc...), conformément aux spécifications fonctionnelles qui auront été rédigées pour satisfaire le besoin.

Organisation du code

La première tâche est de structurer le projet.
Les classes de l'application se situent dans un package bank. Les classes du modèle dans un package bank.model. Les exceptions métier ont également un package réservé, ainsi que les contrôleurs.

L'organisation du code proposée est le fruit d'un parti-pris architectural, et n'est en rien obligatoire. Cependant, cette méthode met en évidence le modèle MVC sous-jacent à JSF, et tend à établir une bonne pratique.

Les contrôleurs sont au nombre d'un par entité, ils ont tous la même structure.
Les composants graphiques sont extraits des contrôleurs et placés dans une classe View (package bank.view).
Les vues sont génériques, il ne doit pas y avoir d'adhérence au modèle, sauf décision de conception différente.

Afin d'éviter l'adhérence au modèle, on utilise éventuellement des classes utilitaires afin de peupler certains composants (voir classe KeyValuePair par exemple).

Les classes du modèle ne doivent comporter aucune adhérence aux contrôleurs ni aux vues. Vérifiez le en examinant la liste des imports.

L'organisation proposée n'est pas totalement aboutie. Il sera nécessaire, par la suite, de déresponsabiliser les contrôleurs des fonctionalités de navigation dans le modèle(crud). Ces fonctionnalités seront, plus tard, confiées à des classes DAO (Data Access Object), les contrôleurs conservant simplement une fonction d'aiguilleur.

Structure du projet

Interface utilisateur




Exemples de code

dans bankControler:
<br />public ListView getView() {<br /> if (!viewInit){<br /> viewInit=true;<br /> List<keyvaluepair> options = new ArrayList<keyvaluepair>();<br /> for (Iterator<city> i = bankApp.getCities().iterator(); i.hasNext();) {<br /> City city = i.next();<br /> KeyValuePair v = new KeyValuePair();<br /> v.key = city.getId();<br /> v.value = city.getName();<br /> options.add(v);<br /> }<br /> view.initOptions(options);<br /> }<br /> return view;<br /> }<br /><br />public void zipChanged(ValueChangeEvent event) {<br /> currentBank.setCity(bankApp.getCityById(Integer.parseInt(event.getNewValue().toString())));<br /> FacesContext.getCurrentInstance().renderResponse();<br />}<br /><br />
dans ListView

<br />public void initOptions(List<keyvaluepair> values) {<br /> items = new ArrayList<selectitem>();<br /> for (Iterator i = values.iterator(); i.hasNext();) {<br /> KeyValuePair v = (KeyValuePair) i.next();<br /> items.add(new SelectItem(Integer.toString(v.key), v.value)); <br /> }<br />}<br />
la classe KeyValuePair
<br />public class KeyValuePair {<br /> public int key;<br /> public String value;<br />}<br />
dans bankForm.jsp
<br /><h:outputlabel for="city" value="ville"><br /> <h:panelgroup><br /> <h:selectonemenu id="city" value="#{bankControler.currentBank.city.id}" immediate="true" styleclass="selectOneMenu" onchange="submit()" valuechangelistener="#{bankControler.zipChanged}"><br /> <f:selectitem itemvalue="" itemlabel="choose"><br /> <f:selectitems value="#{bankControler.zipItems}"><br /> </h:selectOneMenu><br /> <h:message for="city" styleclass="error" showdetail="true" showsummary="false"><br /> </h:panelGroup><br />

corrigé ici

Frameworks JSF - Ajax

• Outre les bibiliothèques référencées par jsfmatrix déjà citées, voici deux autres bibliothèques JSF basées sur Ajax
• Les composants Yahoo: Yui4jsf démo
• Un framework Sun: jMaki démo
  

TP: Application bancaire simplifiée

L'exemple est tiré de Netbeans: UMLBankAppSample

Spécifications:

L'application permet de créer banques, des clients et des comptes bancaires.
Les comptes sont de trois types:

• Checking: compte courant
• Saving: compte épargne
• Platinum: compte de type carte de paiement

Tous les types de comptes ont les attributs suivants:

double balance; // le solde
String accountNumber; Le numéro de compte
double interestRate; //un taux d'intérêt

En outre ils possèdent un historique et ils sont liés à un client:

History history;
Customer customer;

• Le client possède plusieurs comptes et possède les attributs suivants:

int id;
String name;
String forName;
String address;
String zipCode;

• Le compte Checking est soumis à une pénalité en cas de découvert:

double overdraftPenalty = 25.00;

• Le Platinum possède une autorisation maxi et une réserve d'argent qui diminue en cas de retrait si le solde n'est pas suffisant.

static final double overdraftLimit = 2500.00;
double availableFunds;

• Le compte Saving rapporte des intérêts quand le solde est positif.
• La classe History possède un seul attribut qui compte les opérations:
  

int transaction;


Créer un cas de test:

<br />public static void main(String[] args) {<br /> BankApplication app = new BankApplication();<br /> System.out.println("-----Creating customers-----");<br /> Customer c1 = new Customer(1,"Dupont","Jean","10, rue des lilas","30000");<br /> app.add(c1);<br /> Customer c2 = new Customer(2,"Poulain","Amélie","20, rue des mimosas","34000");<br /> app.add(c2);<br /> System.out.println("-----Creating accounts-----");<br /> Checking checkingAccount1 = new Checking("1234",150);<br /> app.add(checkingAccount1);<br /> Saving savingAccount1 = new Saving("12399", 100,0.06);<br /> app.add(savingAccount1);<br /> Checking checkingAccount2 = new Checking("9234",1501);<br /> app.add(checkingAccount2);<br /> Saving savingAccount2 = new Saving("92399", 1000,0.07);<br /> app.add(savingAccount2);<br /> c1.addAccount(checkingAccount1);<br /> c1.addAccount(savingAccount1);<br /> c2.addAccount(checkingAccount2);<br /> c2.addAccount(savingAccount2);<br /> System.out.println("-----writings-----");<br /> savingAccount1.deposit(700.00);<br /> checkingAccount1.deposit(360.00); <br /> checkingAccount1.deposit(10.00); <br /> checkingAccount1.deposit(20.00); <br /> try{<br /> checkingAccount1.withdraw(10.00); <br /> checkingAccount1.withdraw(20.00); <br /> checkingAccount1.withdraw(60.00); <br /> }<br /> catch(Exception ex){<br /> //ex.printStackTrace();<br /> }<br /> checkingAccount2.deposit(10.00);<br /> try{<br /> checkingAccount2.withdraw(10660.00); <br /> }<br /> catch(Exception ex){<br /> //ex.printStackTrace();<br /> } <br /> System.out.println("-----Bank Application balances-----");<br /> System.out.print(app.toString());<br /> }<br />

Créer un modèle de classes du domaine à base de simples javabeans (la persistence sera implémentée ultérieurement)

A l'exécution du test , on obtient:

-----Creating customers-----
-----Creating accounts-----
Account created: Checking Account:        Number:  1234
Balance:  150.0 history is empty
Account created: Saving Account:        Number:  12399
Balance:  100.0
Account created: Checking Account:        Number:  9234
Balance:  1501.0 history is empty
Account created: Saving Account:        Number:  92399
Balance:  1000.0
-----writings-----
1 Jean Dupont Saving Account:        12399 deposit 700.0
1 Jean Dupont Checking Account:        1234 deposit 360.0
1 Jean Dupont Checking Account:        1234 deposit 10.0
1 Jean Dupont Checking Account:        1234 deposit 20.0
1 Jean Dupont Checking Account:        1234 withdraw 10.0
1 Jean Dupont Checking Account:        1234 withdraw 20.0
1 Jean Dupont Checking Account:        1234 withdraw 60.0
2 Amélie Poulain Checking Account:        9234 deposit 10.0
2 Amélie Poulain Checking Account:        9234 withdraw 10660.0
2 Amélie Poulain Checking Account:        9234 noAvailableFunds
-----Bank Application balances-----
1 Jean Dupont
Checking Account:        Number:  1234
Balance:  450.0    Transaction count is 3
Saving Account:        Number:  12399
Balance:  800.0
------------
2 Amélie Poulain
Checking Account:        Number:  9234
Balance:  1511.0 history is empty
Saving Account:        Number:  92399
Balance:  1000.0
------------

Intégrer l'application dans une application web, au moyen d'un backing bean.

Créer les pages permettant de naviguer dans l'application, de créer, de supprimer, modifier des banques, des clients, des comptes, et d'effectuer des opérations.
Vérifier la non régression des règles de gestion.

Pour chaque entité, il faut prévoir une vue en liste basée sur une DataTable, et une vue d'édition basée sur un formulaire, voir tp jee-jsf et guide de référence
le modèle ici.
le corrigé v1 ici.

Myfaces et JBoss 4.2

Pour utiliser l'implémentation Apache MyFaces avec JBoss 4.2 et Redhat Developer Studio, il est nécessaire d'effectuer les opérations suivantes:

• Créer un nouveau projet jsf

• choisir MyFaces 1.1.4

Tester: Run as/Run on server ...

On obtient l'erreur suivante car il y a un conflit entre l'implémentation MyFaces déployée avec la webapp et l'implémentation de référence fournie avec JBoss.

10:04:44,796 ERROR [[/myfaces-examples]] Erreur lors de la configuration de la classe d'écoute de l'application (application listener) org.apache.myfaces.webapp.StartupServletContextListener
java.lang.ClassNotFoundException: org.apache.myfaces.webapp.StartupServletContextListener

Solution: Supprimer l'implémentation JSF-RI de JBoss

• Stopper le serveur JBoss
• Supprimer les bibliothèques jsf livrées avec Jboss
  

ici: [jboss server dir]\server\default\deploy\jboss-web.deployer\jsf-libs

• Mettre hors service les listeners jsf dans web.xml
  

ici: [jboss server dir]\server\default\deploy\jboss-web.deployer\conf\web.xml

<br /><!-- <listener><br /> <listener-class>org.jboss.web.jsf.integration.config.JBossJSFConfigureListener</listener-class><br /> </listener><br /><br /> <listener><br /> <listener-class>com.sun.faces.application.WebappLifecycleListener</listener-class><br /> </listener><br />--><br />


ainsi que le paramètre suivant:

<br /><!-- <init-param><br /> <description>JSF standard tlds</description><br /> <param-name>tagLibJar0</param-name><br /> <param-value>jsf-libs/jsf-impl.jar</param-value><br /></init-param><br />--><br />

• Redémarrer le serveur Jboss, vérifier que le serveur démarre sans exception et qu'il n'y ait pas d'erreur au déploiement de la webapp.

Installer les exemples MyFaces

Les exemples de l'implémentation MyFaces subissent quelques modifications pour s'exécuter avec JBoss 4.2 et Eclipse.

• Le site des exemples MyFaces original est ici.
  
• Un projet MyFaces-examples modifié se trouve ici.
• Créer un projet MyFaces comme il est décrit ici.
• Copier le répertoire WebContent et JavaSource du projet téléchargé dans ce nouveau projet créé.

Modifier web.xml (répertoire WEB-INF) pour permettre l'affichage des codes sources, en adaptant le path (init-param source.dir) du code source du projet:
<br /> <servlet><br /> <servlet-name>SourceCodeServlet</servlet-name><br /> <servlet-class><br /> org.apache.myfaces.shared_tomahawk.util.servlet.SourceCodeServlet<br /> </servlet-class><br /> <init-param><br /> <param-name>source.dir</param-name><br /> <param-value><br /> C:\workspace-rhds2\myfaces-examples\JavaSource\<br /> </param-value><br /> </init-param><br /> </servlet><br />

• Run as / Run on server pour tester

Ajouter un exemple: ValueChangeListener et Validation.
Comment concilier un submit destiné à rafraichir une page, sans effectuer la validation du formulaire, avec un submit destiné à appliquer la règle de gestion et de navigation de la vue?

Créer un formulaire dans une jsp:


code de la jsp:
<br /><br /><?xml version="1.0" encoding="ISO-8859-1" ?><br /><%@ page language="java" contentType="text/html; charset=ISO-8859-1" pageEncoding="ISO-8859-1"%><br /><%@ taglib uri="http://java.sun.com/jsf/html" prefix="h"%><br /><%@ taglib uri="http://java.sun.com/jsf/core" prefix="f"%><br /><%@ taglib uri="http://myfaces.apache.org/tomahawk" prefix="t"%><br /><%@ taglib uri="http://java.sun.com/jstl/core" prefix="c"%><br /><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><br /><html xmlns="http://www.w3.org/1999/xhtml"><br /><head><br /><meta equiv="Content-Type" content="text/html; charset=ISO-8859-1"><br /><title>ValueChangeListeners et validations</title><br /></head><br /><body><br /><%@include file="inc/head.inc"%><br /><f:view><br /> <h:panelgroup id="body"><br /> <h:outputlabel styleclass="header18" value="ValueChangeListeners et validations"></h:outputLabel><br /> <h:form id="f1"><br /> <h:panelgrid columns="3" border="1" rules="all"><br /> <h:panelgroup><br /> <h:outputlabel value="foobar" for="ip1"></h:outputLabel><br /> <f:verbatim>, une valeur entre 5 et 10</f:verbatim><br /> </h:panelGroup><br /> <h:inputtext value="#{selectModel.dummyValue}" id="ip1" required="true"><br /> <f:validatelongrange minimum="5" maximum="10"><br /> </h:inputText><br /> <t:message id="foobarError" for="ip1" styleclass="error"><br /> <h:selectonemenu id="selone_menu_options" value="o2" styleclass="selectOneMenu" onchange="submit()" immediate="true" valuechangelistener="#{selectModel.menuChanged}"><br /> <f:selectitem itemvalue="" itemlabel="choose"><br /> <f:selectitems value="#{selectModel.optionItems}"><br /> </h:selectOneMenu><br /> <h:outputtext value="#{selectModel.counter}"></h:outputText><br /> <h:commandbutton action="#{selectModel.confirm}" value="ok"></h:commandButton><br /> </h:panelGrid><br /> </h:form><br /> <t:messages id="messageList" styleclass="error" summaryformat="{0} dans {1}"><br /> </h:panelGroup><br /> <jsp:include page="inc/mbean_source.jsp"><br /></f:view><br /><%@include file="inc/page_footer.jsp"%><br /></body><br /></html><br /><br />

code du bean:
<br /><br />package org.apache.myfaces.examples.listener;<br /><br />import java.util.ArrayList;<br />import java.util.List;<br /><br />import javax.faces.context.FacesContext;<br />import javax.faces.event.ValueChangeEvent;<br />import javax.faces.model.SelectItem;<br /><br />/**<br /> * @author Martin Marinschek<br /> */<br />public class SelectModel {<br /> private List<string> options;<br /> private List<selectitem> optionItems;<br /><br /> private long dummyValue = 100;<br /><br /> public long getDummyValue() {<br /> return dummyValue;<br /> }<br /><br /> public void setDummyValue(long dummyValue) {<br /> this.dummyValue = dummyValue;<br /> }<br /><br /> public List getOptions() {<br /> if (options == null) {<br /> initOptions();<br /> }<br /> return options;<br /> }<br /><br /> public void setOptions(List options) {<br /> this.options = options;<br /> }<br /><br /> public List getOptionItems() {<br /> if (optionItems == null) {<br /> initOptions();<br /> }<br /> return optionItems;<br /> }<br /><br /> static int counter = 5;<br /><br /> /**<br /> * chaque fois on ajoute une option dans la boite<br /> * <br /> * @param event<br /> */<br /> public void menuChanged(ValueChangeEvent event) {<br /> options.add("o" + counter);<br /> optionItems.add(new SelectItem("o" + counter, "Option " + counter));<br /> counter++;<br /> FacesContext.getCurrentInstance().renderResponse(); // pour<br /> // court-circuiter<br /> // le cycle<br /> }<br /><br /> public int getCounter() {<br /> return counter;<br /> }<br /><br /> public String confirm() {<br /> System.out.println("confirmed");<br /> return "ok";<br /> }<br /><br /> private void initOptions() {<br /> options = new ArrayList<string>();<br /> options.add("o1");<br /> options.add("o2");<br /> options.add("o3");<br /> options.add("o4");<br /><br /> optionItems = new ArrayList<selectitem>();<br /> optionItems.add(new SelectItem("o1", "Option 1"));<br /> optionItems.add(new SelectItem("o2", "Option 2"));<br /> optionItems.add(new SelectItem("o3", "Option 3"));<br /> optionItems.add(new SelectItem("o4", "Option 4"));<br /> }<br />}<br /><br />