Springmvc 5

Spring MVC par l'exemple
- Partie 5 -
serge.taheistia.uni-angers.r, aril 2006
springmc - partie5, S1 - uniersit dÀngers
1,3
J Rappels
Nous poursuions dans cet article le traail ait dans les prcdents :
! Spring MVC par l'exemple - partie 1 : |http:,,tahe.deeloppez.com,jaa,springmc-part1|
Dans le dernier article, nous aons mis en oeure Spring MVC dans une architecture 3tier |web, metier, dao| sur un exemple
basique de gestion dùne liste de personnes. Cela nous a permis dùtiliser les concepts qui aaient t prsents dans les prcdents
articles.
Dans la ersion 1, la liste des personnes tait maintenue en mmoire et disparaissait au dchargement de làpplication web. Dans la
ersion tudie ici, la liste des personnes est maintenue dans une table de base de donnes. Nous ne delopperons que les couches
|serice| et |dao|. La couche |ui-web| reste celle qui a t deloppe pour la ersion 1.
Nous delopperons lèxemple tout dàbord aec une base de donnes lirebird. Puis ensuite, nous prsenterons des ersions pour
les SGBD Postgres, MySQL et SQL Serer Lxpress. Le tableau suiant indique au lecteur ou se procurer librement ces SGBD et
des clients pour les administrer :
SGBD site(s)
client(s) d'administration
Firebird http://www.firebirdsql.org/
IBLxpert :
http://www.ibexpert.com/
SQL Manager Lite pour lirebird :
http://www.sqlmanager.net/fr/products/ibfb/manager
Postgres http://www.postgresql.org/ SQL Manager Lite pour Postgres :
http://www.sqlmanager.net/fr/products/postgresql/man
ager
MySQL http://www.mysql.com/
http://www.easyphp.org/
SQL Manager Lite pour MySQL :
http://www.sqlmanager.net/fr/products/mysql/manager
SQL
Server
Express
http://msdn.microsoft.com/vstudio/express/
sql/
SQL Serer Management Studio Lxpress :
http://msdn.microsoft.com/vstudio/express/sql/downl
oad/
SQL Manager Lite pour SQL Serer Lxpress:
http://www.sqlmanager.net/fr/products/mssql/manager
2 Spring MVC dans une architecture 3tier Lxemple 2 - Iirebird
2.J La base de donnees Iirebird
2,3
utilisateur
! Donnees
Couche Interace Utilisateur|ui-web|
Couche d'acces
aux donnes
|dao|
Couche serice
|service|
"
#
$
%
Controller
DispatcherSerlet
View
Modele Map
&
'
Dans cette ersion, nous allons installer la liste des personnes dans une table de base de donnes lirebird. On trouera dans le
document |http:,,tahe.deeloppez.com,diers,sql-irebird,| des inormations pour installer et grer ce SGBD. Dans ce qui suit,
les copies d`cran proiennent d` IBLxpert, un client dàdministration des SGBD Interbase et lirebird.
La base de donnes sàppelle |dbpersonnes.gdb|. Llle contient une table |PLRSONNLS| :
La table |PLRSONNLS| contiendra la liste des personnes gre par làpplication web. Llle a t construite aec les ordres SQL
suiants :
1.
2. CREATE TABLE PERSONNES (
3. ID INTEGER NOT NULL,
4. "VERSION" INTEGER NOT NULL,
5. NOM VARCHAR(30) NOT NULL,
6. PRENOM VARCHAR(30) NOT NULL,
7. DATENAISSANCE DATE NOT NULL,
8. MARIE SMALLINT NOT NULL,
9. NBENFANTS SMALLINT NOT NULL
10. );
11.
12.
13. ALTER TABLE PERSONNES ADD CONSTRAINT CHK_PRENOM_PERSONNES check (PRENOM<>'');
14. ALTER TABLE PERSONNES ADD CONSTRAINT CHK_MARIE_PERSONNES check (MARIE=0 OR MARIE=1);
15. ALTER TABLE PERSONNES ADD CONSTRAINT CHK_NOM_PERSONNES check (NOM<>'');
16. ALTER TABLE PERSONNES ADD CONSTRAINT CHK_ENFANTS_PERSONNES check (NBENFANTS>=0);
17.
18.
19. ALTER TABLE PERSONNES ADD CONSTRAINT PK_PERSONNES PRIMARY KEY (ID);
! lignes 2-10 : la structure de la table |PLRSONNLS|, destine a sauegarder des objets de type |Personne|, relete la
structure de cet objet. Le type boolen nèxistant pas dans lirebird, le champ |MARIL| ,ligne 8, a t dclar de type
|SMALLIN1|, un entier. Sa aleur sera 0 ,pas mari, ou 1 ,mari,.
! lignes 13-16 : des contraintes dìntgrit qui reletent celles du alidateur de donnes |ValidatePersonne|.
! ligne 19 : le champ ID est cl primaire de la table |PLRSONNLS|
La table |PLRSONNLS| pourrait aoir le contenu suiant :
La base |dbpersonnes.gdb| a, outre la table |PLRSONNLS|, un objet appel gnrateur et nomm |GLN_PLRSONNLS_ID|. Ce
gnrateur dlire des nombres entiers successis que nous utiliserons pour donner sa aleur, a la cl primaire |ID| de la classe
|PLRSONNLS|. Prenons un exemple pour illustrer son onctionnement :
3,3
- double-cliquer sur |GLN_PLRSONNLS_ID|
- le gnrateur a actuellement la aleur 96
- mettons lòrdre SQL ci-dessus ,l12, -
- la aleur obtenue est làncienne aleur du gnrateur -1
On peut constater que la aleur du gnrateur |GLN_PLRSONNLS_ID| a chang ,double-clic dessus - l5 pour raraichir, :
Lòrdre SQL
SELECT GEN_ID ( GEN_PERSONNES_ID,1 ) FROM RDB$DATABASE
permet donc dàoir la aleur suiante du gnrateur |GLN_PLRSONNLS_ID|. GLN_ID est une onction interne de lirebird et
|RDB>DA1ABASL|, une table systeme de ce SGBD.
2.2 Le projet Lclipse des couches dao et service
Pour delopper les couches |dao| et |serice| de notre application aec base de donnes, nous utiliserons le projet Lclipse |spring-
mc-38| suiant :
Le projet est un simple projet Jaa, pas un projet web 1omcat. Rappelons que la ersion 2 de notre application a utiliser la couche
|web| de la ersion 1. Cette couche nà donc pas a tre crite.
Dossier |src|
4,3
Ce dossier contient les codes source des couches |dao| et |serice| :
On y troue dirents paquetages :
! |istia.st.springmc.personnes.dao| : contient la couche |dao|
! |istia.st.springmc.personnes.entites| : contient la classe |Personne|
! |istia.st.springmc.personnes.serice| : contient la classe |serice|
! |istia.st.springmc.personnes.tests| : contient les tests JUnit des couches |dao| et |serice|
ainsi que des ichiers de coniguration qui doient tre dans le !"#$$%#&' de làpplication.
Dossier |database|
Ce dossier contient la base de donnes lirebird des personnes :
! |dbpersonnes.gdb| est la base de donnes.
! |dbpersonnes.sql| est le script SQL de gnration de la base :
1. /******************************************************************************/
2. /*** Generated by IBExpert 2006.03.07 27/04/2006 10:27:11 ***/
3. /******************************************************************************/
4.
5. SET SQL DIALECT 3;
6.
7. SET NAMES NONE;
8.
9. CREATE DATABASE 'C:\data\2005-2006\webjava\dvp-spring-mvc\mvc-38\database\DBPERSONNES.GDB'
10. USER 'SYSDBA' PASSWORD 'masterkey'
11. PAGE_SIZE 16384
12. DEFAULT CHARACTER SET NONE;
13.
14.
15.
16. /******************************************************************************/
17. /*** Generators ***/
18. /******************************************************************************/
19.
20. CREATE GENERATOR GEN_PERSONNES_ID;
21. SET GENERATOR GEN_PERSONNES_ID TO 787;
22.
23.
24.
25. /******************************************************************************/
26. /*** Tables ***/
27. /******************************************************************************/
28.
29.
5,3
30.
31. CREATE TABLE PERSONNES (
32. ID INTEGER NOT NULL,
34. NOM VARCHAR(30) NOT NULL,
35. PRENOM VARCHAR(30) NOT NULL,
36. DATENAISSANCE DATE NOT NULL,
37. MARIE SMALLINT NOT NULL,
38. NBENFANTS SMALLINT NOT NULL
39. );
40.
41. INSERT INTO PERSONNES (ID, "VERSION", NOM, PRENOM, DATENAISSANCE, MARIE, NBENFANTS) VALUES (1, 1,
'Major', 'Joachim', '1984-11-13', 1, 2);
'Humbort', 'Mlanie', '1985-02-12', 0, 1);
'Lemarchand', 'Charles', '1986-03-01', 0, 0);
44.
45. COMMIT WORK;
46.
47.
48.
49. /* Check constraints definition */
50.
51. ALTER TABLE PERSONNES ADD CONSTRAINT CHK_PRENOM_PERSONNES check (PRENOM<>'');
52. ALTER TABLE PERSONNES ADD CONSTRAINT CHK_NOM_PERSONNES check (NOM<>'');
53. ALTER TABLE PERSONNES ADD CONSTRAINT CHK_MARIE_PERSONNES check (MARIE=0 OR MARIE=1);
54. ALTER TABLE PERSONNES ADD CONSTRAINT CHK_ENFANTS_PERSONNES check (NBENFANTS>=0);
55.
56.
57. /******************************************************************************/
58. /*** Primary Keys ***/
59. /******************************************************************************/
60.
61. ALTER TABLE PERSONNES ADD CONSTRAINT PK_PERSONNES PRIMARY KEY (ID);
Dossier |lib|
Ce dossier contient les archies ncessaires a làpplication :
On notera la prsence du pilote JDBC |irebirdsql-ull.jar| du SGBD lirebird. 1outes ces archies ont partie du !"#$$(#&' du projet
Lclipse.
Dossier |dist|
Ce dossier contiendra les archies issues de la compilation des classes de làpplication :
! |personnes-dao.jar| : archie de la couche |dao|
! |personnes-serice.jar| : archie de la couche |serice|
2.3 La couche dao
2.3.1 Les composantes de Ia couche [dao]
La couche |dao| est constitue des classes et interaces suiantes :
6,3
! |IDao| est lìnterace prsente par la couche |dao|
! |DaoImplCommon| est une implmentation de celle-ci ou le groupe de personnes se troue dans une table de base de
donnes. |DaoImplCommon| regroupe des onctionnalits indpendantes du SGBD.
! |DaoImpllirebird| est une classe drie de |DaoImplCommon| pour grer spciiquement une base lirebird.
! |DaoLxception| est le type des exceptions non controles, lances par la couche |dao|. Cette classe est celle de la ersion 1.
Lìnterace |IDao| est la suiante :
1. package istia.st.springmvc.personnes.dao;
2.
3. import istia.st.springmvc.personnes.entites.Personne;
4.
5. import java.util.Collection;
6.
7. public interface IDao {
8. // liste de toutes les personnes
9. Collection getAll();
10. // obtenir une personne particulire
11. Personne getOne(int id);
12. // ajouter/modifier une personne
13. void saveOne(Personne personne);
14. // supprimer une personne
15. void deleteOne(int id);
16. }
! lìnterace a les mmes quatre mthodes que dans la ersion prcdente.
La classe |DaoImplCommon| implmentant cette interace sera la suiante :
2.
4. import org.springframework.orm.ibatis.support.SqlMapClientDaoSupport;
5.
7.
8. public class DaoImplCommon extends SqlMapClientDaoSupport implements
9. IDao {
10.
11. // liste des personnes
12. public Collection getAll() {
13. ...
14. }
15.
16. // obtenir une personne en particulier
17. public Personne getOne(int id) {
18. ...
19. }
20.
21. // suppression d'une personne
22. public void deleteOne(int id) {
23. ...
24. }
25.
26. // ajouter ou modifier une personne
27. public void saveOne(Personne personne) {
28. // le paramtre personne est-il valide ?
29. check(personne);
30. // ajout ou modification ?
31. if (personne.getId() == -1) {
32. // ajout
33. insertPersonne(personne);
34. } else {
35. updatePersonne(personne);
36. }
37. }
38.
39. // ajouter une personne
40. protected void insertPersonne(Personne personne) {
41. ...
42. }
43.
44. // modifier une personne
45. protected void updatePersonne(Personne personne) {
,3
46. ...
47. }
48.
49. // vrification validit d'une personne
50. private void check(Personne p) {
51. ...
52. }
53.
54. ...
55. }
! lignes 8-9 : la classe |DaoImpl| implmente lìnterace |IDao| et donc les quatre mthodes |getAll, getOne, saeOne,
deleteOne|.
! lignes 2-3 : la mthode |saeOne| utilise deux mthodes internes |insertPersonne| et |updatePersonne| selon qu'on doit
aire un ajout ou une modiication de personne.
! ligne 50 : la mthode prie |check| est celle de la ersion prcdente. Nous ne reiendrons pas dessus.
! ligne 8 : pour implmenter lìnterace |IDao|, la classe |DaoImpl| drie de la classe Spring |SqlMapClientDaoSupport|.
2.3.2 La couche d'accs aux donnes [iBATIS]
La classe Spring |SqlMapClientDaoSupport| utilise un ramework tierce |Ibatis SqlMap| disponible a lùrl |http:,,ibatis.apache.org,|
:
|iBA1IS| est un projet Apache qui acilite la construction de couches |dao| sàppuyant sur des bases de donnes. Aec |iBA1IS|,
l'architecture de la couche d'acces aux donnes est la suiante :
|iBA1IS| s'insere entre la couche |dao| de l'application et le pilote JDBC de la base de donnes. Il existe des alternaties a |iBA1IS|
telle, par exemple, l'alternatie |libernate| :
8,3
utilisateur
Donnees
Couche d'acces
aux donnes
|dao|
Couche d'acces
aux donnes
|JDBC|
Couche d'acces
aux donnes
|iBA1IS|
Lùtilisation du ramework |iBA1IS| ncessite deux archies |ibatis-common, ibatis-sqlmap| qui ont t toutes deux places dans le
dossier |lib| du projet :
La classe |SqlMapClientDaoSupport| encapsule la partie gnrique de lùtilisation du ramework |iBA1IS|, c.a.d. des parties de code
quòn retroue dans toutes les couche |dao| utilisant l'outil |iBA1IS|. Pour crire la partie non gnrique du code, cèst a dire ce qui
est spciique a la couche |dao| que lòn crit, il suit de drier la classe |SqlMapClientDaoSupport|. Cèst ce que nous aisons ici.
La classe |SqlMapClientDaoSupport| est dinie comme suit :
Parmi les mthodes de cette classe, lùne dèlles permet de conigurer le client |iBA1IS| aec lequel on a exploiter la base de
donnes :
Lòbjet |SqlMapClient sqlMapClient| est lòbjet |IBA1IS| utilis pour accder a une base de donnes. A lui tout seul, il implmente
la couche |iBA1IS| de notre architecture :
9,3
utilisateur
Donnees
Couche d'acces
aux donnes
|dao|
Couche d'acces
aux donnes
|JDBC|
Couche d'acces
aux donnes
|Hibernate|
Une squence typique dàctions aec cet objet est la suiante :
1. demander une connexion a un pool de connexions
2. ourir une transaction
3. excuter une srie dòrdres SQL mmorise dans un ichier de coniguration
4. ermer la transaction
5. rendre la connexion au pool
Si notre implmentation |DaoImplCommon| traaillait directement aec |iBA1IS|, elle derait aire cette squence de aon
rpte. Seule lòpration 3 est spciique a une couche |dao|, les autres oprations tant gnriques. La classe Spring
|SqlMapClientDaoSupport| assurera elle-mme les oprations 1, 2, 4 et 5, dlguant lòpration 3 a sa classe drie, ici la classe
|DaoImplCommon|.
Pour pouoir onctionner, la classe |SqlMapClientDaoSupport| a besoin dùne rrence sur lòbjet iBA1IS |SqlMapClient
sqlMapClient| qui a assurer le dialogue aec la base de donnes. Cet objet a besoin de deux choses pour onctionner :
! un objet |DataSource| connect a la base de donnes aupres duquel il a demander des connexions
! un ,ou des, ichier de coniguration ou sont externaliss les ordres SQL a excuter. Ln eet, ceux-ci ne sont pas dans le
code Jaa. Ils sont identiis par un code dans un ichier de coniguration et lòbjet |SqlMapClient sqlMapClient| utilise ce
code pour aire excuter un ordre SQL particulier.
Un embryon de coniguration de notre couche |dao| qui relterait l'architecture ci-dessus serait le suiant :
1. 
2. <bean id="dao" class="istia.st.springmvc.personnes.dao.DaoImplCommon">
3. <property name="sqlMapClient">
4. <ref local="sqlMapClient"/>
5. </property>
6.</bean>
Ici la proprit |sqlMapClient| ,ligne 3, de la classe |DaoImplCommon| ,ligne 2, est initialise. Llle lèst par la mthode
|setSqlMapClient| de la classe |DaoImpl|. Cette classe nà pas cette mthode. Cèst sa classe parent |SqlMapClientDaoSupport| qui
là. Cèst donc elle qui est en ralit initialise ici.
Maintenant ligne 4, on ait rrence a un objet nomm " sqlMapClient " qui reste a construire. Celui-ci, on là dit, est de type
|SqlMapClient|, un type |iBA1IS| :
|SqlMapClient| est une interace. Spring ore la classe |SqlMapClientlactoryBean| pour obtenir un objet implmentant cette
interace :
Rappelons que nous cherchons a instancier un objet implmentant lìnterace |SqlMapClient|. Ce nèst apparemment pas le cas de la
classe |SqlMapClientlactoryBean|. Celle-ci implmente lìnterace |lactoryBean| ,c ci-dessus,. Celle-ci a la mthode |getObject,,|
suiante :
10,3
utilisateur
Donnees
Couche d'acces aux donnes
|SqlMapDaoClientSupport :
DaoImplCommon|
Couche d'acces
aux donnes
|JDBC|
|SqlMapClient|
Lorsquòn demande a Spring une instance dùn objet implmentant lìnterace |lactoryBean|, il :
! cre une instance |I| de la classe - ici il cre une instance de type |SqlMapClientlactoryBean|.
! rend a la mthode appelante, le rsultat de la mthode |I|.getObject,, - la mthode |SqlMapClientlactoryBean|.getObject,,
a rendre ici un objet implmentant lìnterace |SqlMapClient|.
Pour pouoir rendre un objet implmentant lìnterace |SqlMapClient|, la classe |SqlMapClientlactoryBean| a besoin de deux
inormations ncessaires a cet objet :
! un objet |DataSource| connect a la base de donnes aupres duquel il a demander des connexions
! un ,ou des, ichier de coniguration ou sont externaliss les ordres SQL a excuter
La classe |SqlMapClientlactoryBean| possede les mthodes set pour initialiser ces deux proprits :
Nous progressons... Notre ichier de coniguration se prcise et deient :
1.
2. <bean id="sqlMapClient"
3. class="org.springframework.orm.ibatis.SqlMapClientFactoryBean">
4. <property name="dataSource">
5. <ref local="dataSource"/>
6. </property>
7. <property name="configLocation">
8. <value>classpath:sql-map-config-firebird.xml</value>
9. </property>
10. </bean>
15. </property>
16. </bean>
! lignes 2-3 : le bean " sqlMapClient " est de type |SqlMapClientlactoryBean|. De ce qui ient d`tre expliqu, nous saons
que lorsque nous demandons a Spring une instance de ce bean, nous obtenons un objet implmentant lìnterace iBA1IS
|SqlMapClient|. Cèst ce dernier objet qui sera donc obtenu en ligne 14.
! lignes -9 : nous indiquons que le ichier de coniguration ncessaire a lòbjet iBA1IS |SqlMapClient| sàppelle " sql-map-
conig-irebird.xml " et quìl doit tre cherch dans le !"#$$%#&' de làpplication. La mthode
|SqlMapClientlactoryBean|.setConigLocation est ici utilise.
! lignes 4-6 : nous initialisons la proprit |dataSource| de |SqlMapClientlactoryBean| aec sa mthode |setDataSource|.
Ligne 5, nous aisons rrence a un bean appel " dataSource " qui reste a construire. Si on regarde le parametre attendu par la
mthode |setDataSource| de |SqlMapClientlactoryBean|, on oit quìl est de type |DataSource| :
On a de noueau aaire a une interace dont il nous aut trouer une classe dìmplmentation. Le role dùne telle classe est de
ournir a une application, de aon eicace, des connexions a une base de donnes particuliere. Un SGBD ne peut maintenir
ouertes simultanment un grand nombre de connexions. Pour diminuer le nombre de connexions ouertes a un moment donn,
on est amens, pour chaque change aec la base, a :
! ourir une connexion
! commencer une transaction
! mettre des ordres SQL
! ermer la transaction
! ermer la connexion
Ourir et ermer des connexions de aon rpte est coteux en temps. Pour rsoudre ces deux problemes ,limiter a la ois le
nombre de connexions ouertes a un moment donn, et limiter le cot dòuerture , ermeture de celles-ci, les classes
implmentant lìnterace |DataSource| procedent souent de la aon suiante :
11,3
! elles ourent des leur instanciation, N connexions aec la base de donnes ise. N a en gnral une aleur par daut et
peut le plus souent tre dini dans un ichier de coniguration. Ces N connexions ont rester tout le temps ouertes et
orment un pool de connexions disponibles pour les threads de làpplication.
! lorsquùn thread de làpplication demande une ouerture de connexion, lòbjet |DataSource| lui donne lùne des N
connexions ouertes au dmarrage, sìl en reste de disponibles. Lorsque làpplication erme la connexion, cette derniere
nèst en ralit pas erme mais simplement remise dans le pool des connexions disponibles.
Il existe dierses implmentations de lìnterace |DataSource| disponibles librement. Nous allons utiliser ici lìmplmentation
|commons DBCP| disponible a lùrl |http:,,jakarta.apache.org,commons,dbcp,| :
Lùtilisation de lòutil |commons DBCP| ncessite deux archies |commons-dbcp, commons-pool| qui ont t toutes deux places
dans le dossier |lib| du projet :
La classe |BasicDataSource| de |commons DBCP| ournit lìmplmentation |DataSource| dont nous aons besoin :
Cette classe a nous ournir un pool de connexions pour accder a la base lirebird |dbpersonnes.gdb| de notre application. Pour
cela, il aut lui donner les inormations dont elle a besoin pour crer les connexions du pool :
1. le nom du pilote JDBC a utiliser - initialis aec |setDrierClassName|
2. le nom de lùrl de la base de donnes a exploiter - initialis aec |setUrl|
3. lìdentiiant de lùtilisateur propritaire de la connexion - initialis aec |setUsername| ,et non pas setUserName comme
on aurait pu s'y attendre,
4. son mot de passe - initialis aec |setPassword|
Le ichier de coniguration de notre couche |dao| pourra tre le suiant :
1. <?xml version="1.0" encoding="ISO_8859-1"?>
2. <!DOCTYPE beans SYSTEM "http://www.springframework.org/dtd/spring-beans.dtd">
3. <beans>
4. 
5. <bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource"
6. destroy-method="close">
7. <property name="driverClassName">
8. <value>org.firebirdsql.jdbc.FBDriver</value>
9. </property>
10. 
11. <property name="url">
12. <value>jdbc:firebirdsql:localhost/3050:C:/data/2005-2006/webjava/dvp-spring-mvc/mvc-
38/database/dbpersonnes.gdb</value>
13. </property>
14. <property name="username">
15. <value>sysdba</value>
12,3
16. </property>
17. <property name="password">
18. <value>masterkey</value>
19. </property>
20. </bean>
21. 
26. </property>
29. </property>
30. </bean>
35. </property>
36. </bean>
37. </beans>
! lignes -9 : le nom du pilote JDBC du SGBD lirebird
! lignes 11-13 : lùrl de la base lirebird |dbpersonnes.gdb|. On era particulierement attention a l`criture de celle-ci. Il ne
doit y aoir aucun espace entre les balises alue et lùrl.
! lignes 14-16 : le propritaire de la connexion - ici, |sysdba| qui est làdministrateur par daut des distributions lirebird
! lignes 1-19 : son mot de passe |masterkey| - galement la aleur par daut
On a beaucoup progress mais il reste toujours des points de coniguration a lucider : la ligne 28 rrence le ichier |sql-map-
conig-irebird.xml| qui doit conigurer le client |SqlMapClient| dìBA1IS. Aant d`tudier son contenu, montrons lèmplacement de
ces ichiers de coniguration dans notre projet Lclipse :
! |spring-conig-test-dao-irebird.xml| est le ichier de coniguration de la couche |dao| que nous enons d`tudier
! |sql-map-conig-irebird.xml| est rrenc par |spring-conig-test-dao-irebird.xml|. Nous allons l`tudier.
! |personnes-irebird.xml| est rrenc par |sql-map-conig-irebird.xml|. Nous allons l`tudier.
Les trois ichiers prcdents sont dans le dossier |src|. Sous Lclipse, cela signiie quà lèxcution ils seront prsents dans le dossier
|bin| du projet ,non reprsent ci-dessus,. Ce dossier ait partie du !"#$$%#&' de làpplication. Au inal, les trois ichiers prcdents
seront donc bien prsents dans le !"#$$%#&' de làpplication. Cèst ncessaire.
Le ichier |sql-map-conig-irebird.xml| est le suiant :
1. <?xml version="1.0" encoding="UTF-8" ?>
2. <!DOCTYPE sqlMapConfig
3. PUBLIC "-//iBATIS.com//DTD SQL Map Config 2.0//EN"
4. "http://www.ibatis.com/dtd/sql-map-config-2.dtd">
5.
6. <sqlMapConfig>
7. <sqlMap resource="personnes-firebird.xml"/>
8. </sqlMapConfig>
! ce ichier doit aoir sqlMapConig comme balise racine ,lignes 6 et 8,
! ligne : la balise sqlMap sert a dsigner les ichiers qui contiennent les ordres SQL a excuter. Il y a souent, mais ce
nèst pas obligatoire, un ichier par table. Cela permet de rassembler les ordres SQL sur une table donne dans un mme
ichier. Mais on troue rquemment des ordres SQL impliquant plusieurs tables. Dans ce cas, la dcomposition
prcdente ne tient pas. Il aut simplement se rappeler que lènsemble des ichiers dsigns par les balises sqlMap
seront usionns. Ces ichiers sont cherchs dans le !"#$$%#&' de làpplication.
Le ichier |personnes-irebird.xml| dcrit les ordres SQL qui ont tre mis sur la table |PLRSONNLS| de la base de donnes
lirebird |dbpersonnes.gdb|. Son contenu est le suiant :
2.
13,3
3. <!DOCTYPE sqlMap
4. PUBLIC "-//iBATIS.com//DTD SQL Map 2.0//EN"
5. "http://www.ibatis.com/dtd/sql-map-2.dtd">
6.
7. <sqlMap>
8. 
9. <typeAlias alias="Personne.classe"
10. type="istia.st.springmvc.personnes.entites.Personne"/>
11. 
12. <resultMap id="Personne.map"
13. class="Personne.classe">
14. <result property="id" column="ID" />
15. <result property="version" column="VERSION" />
16. <result property="nom" column="NOM"/>
17. <result property="prenom" column="PRENOM"/>
18. <result property="dateNaissance" column="DATENAISSANCE"/>
19. <result property="marie" column="MARIE"/>
20. <result property="nbEnfants" column="NBENFANTS"/>
21. </resultMap>
22. 
23. <select id="Personne.getAll" resultMap="Personne.map" > select ID, VERSION, NOM,
24. PRENOM, DATENAISSANCE, MARIE, NBENFANTS FROM PERSONNES</select>
25. 
26. <select id="Personne.getOne" resultMap="Personne.map" >select ID, VERSION, NOM,
27. PRENOM, DATENAISSANCE, MARIE, NBENFANTS FROM PERSONNES WHERE ID=#value#</select>
28. 
29. <insert id="Personne.insertOne" parameterClass="Personne.classe">
30. <selectKey keyProperty="id">
31. SELECT GEN_ID(GEN_PERSONNES_ID,1) as "value" FROM RDB$$DATABASE
32. </selectKey>
33. insert into
34. PERSONNES(ID, VERSION, NOM, PRENOM, DATENAISSANCE, MARIE, NBENFANTS)
35. VALUES(#id#, #version#, #nom#, #prenom#, #dateNaissance#, #marie#,
36. #nbEnfants#) </insert>
37. 
38. <update id="Personne.updateOne" parameterClass="Personne.classe"> update
39. PERSONNES set VERSION=#version#+1, NOM=#nom#, PRENOM=#prenom#, DATENAISSANCE=#dateNaissance#,
40. MARIE=#marie#, NBENFANTS=#nbEnfants# WHERE ID=#id# and
41. VERSION=#version#</update>
42. 
43. <delete id="Personne.deleteOne" parameterClass="int"> delete FROM PERSONNES WHERE
44. ID=#value# </delete>
45. </sqlMap>
! le ichier doit aoir sqlMap comme balise racine ,lignes et 45,
! lignes 9-10 : pour aciliter l`criture du ichier on donne làlias ,synonyme, |Personne.classe| a la classe
|istia.st.springmc.personnes.entites.Personne|.
! lignes 12-21 : ixe les correspondances entre colonnes de la table |PLRSONNLS| et champs de lòbjet |Personne|.
! lignes 23-24 : lòrdre SQL |select| pour obtenir toutes les personnes de la table |PLRSONNLS|
! lignes 26-2 : lòrdre SQL |select| pour obtenir une personne particuliere de la table |PLRSONNLS|
! lignes 29-36 : lòrdre SQL |insert| qui insere une personne dans la table |PLRSONNLS|
! lignes 38-41 : lòrdre SQL |update| qui met a jour une personne de la table |PLRSONNLS|
! lignes 42-44 : lòrdre SQL |delete| qui supprime une personne de la table |PLRSONNLS|
Le role et la signiication du contenu du ichier |personnes-irebird.xml| ont tre expliqus ia l`tude de la classe
|DaoImplCommon| qui implmente la couche |dao|
2.3.3 La cIasse [DaoImpICommon]
Reenons sur làrchitecture dàcces aux donnes :
La classe |DaoImplCommon| est la suiante :
2.
4. import org.springframework.orm.ibatis.support.SqlMapClientDaoSupport;
5.
14,3
utilisateur
Donnees
|SqlMapDaoClientSupport :
DaoImplCommon|
Couche d'acces
aux donnes
|JDBC|
|SqlMapClient|
7.
8. public class DaoImplCommon extends SqlMapClientDaoSupport implements
9. IDao {
10.
13. ...
14. }
15.
18. ...
19. }
20.
23. ...
24. }
25.
29. check(personne);
32. // ajout
34. } else {
36. }
37. }
38.
39. // ajouter une personne
41. ...
42. }
43.
46. ...
47. }
48.
49. // vrification validit d'une personne
50. private void check(Personne p) {
51. ...
52. }
53.
54. ...
55. }
Nous allons tudier les mthodes les unes apres les autres.
getAll
Cette mthode permet dòbtenir toutes les personnes de la liste. Son code est le suiant :
3. return getSqlMapClientTemplate().queryForList("Personne.getAll", null);
4.}
Rappelons-nous tout dàbord que la classe |DaoImplCommon| drie de la classe Spring |SqlMapClientDaoSupport|. Cèst cette
classe qui a la mthode |getSqlMapClient1emplate,,| utilise ligne 3 ci-dessus. Cette mthode a la signature suiante :
Le type |SqlMapClient1emplate| encapsule lòbjet |SqlMapClient| de la couche |iBA1IS|. Cèst par lui quòn aura acces a la base de
donnes. Le type |iBA1IS| SqlMapClient pourrait tre directement utilis puisque la classe |SqlMapClientDaoSupport| y a acces :
Lìnconnient de la classe |iBA1IS| SqlMapClient est quèlle lance des exceptions de type |SQLLxception|, un type d'exception
controle, c.a.d. qui doit tre gre par un try , catch ou dclare dans la signature des mthodes qui la lance. Or souenons-nous
que la couche |dao| implmente une interace |IDao| dont les mthodes ne comportent pas dèxceptions dans leurs signatures. Les
15,3
mthodes des classes dìmplmentation de lìnterace |IDao| ne peuent donc, elles non plus, aoir dèxceptions dans leurs
signatures. Il nous aut donc intercepter chaque exception |SQLLxception| lance par la couche |iBA1IS| et lèncapsuler dans une
exception non controle. Le type |DaoLxception| de notre projet erait làaire pour cette encapsulation.
Plutot que de grer nous-mmes ces exceptions, nous allons les conier au type Spring |SqlMapClient1emplate| qui encapsule
lòbjet |SqlMapClient| de la couche |iBA1IS|. Ln eet |SqlMapClient1emplate| a t construit pour intercepter les exceptions
|SQLLxception| lances par la couche |SqlMapClient| et les encapsuler dans un type |DataAccessLxception| non control. Ce
comportement nous conient. On se souiendra simplement que la couche |dao| est dsormais susceptible de lancer deux types
dèxceptions non controles :
! notre type propritaire |DaoLxception|
! le type Spring |DataAccessLxception|
Le type |SqlMapClient1emplate| est dini comme suit :
Il implmente lìnterace |SqlMapClientOperations| suiante :
Cette interace dinit des mthodes capables dèxploiter le contenu du ichier |personnes-irebird.xml| :
|queryIorList|
Cette mthode permet d`mettre un ordre |SLLLC1| et dèn rcuprer le rsultat sous orme dùne liste dòbjets :
! |statementName| : lìdentiiant ,id, de lòrdre |select| dans le ichier de coniguration
! |parameterObject| : lòbjet " parametre " pour un |select| paramtr. Lòbjet " parametre " peut prendre deux ormes :
! un objet respectant la norme Javabean : les parametres de lòrdre |select| sont alors les noms des champs du
Jaabean. A lèxcution de lòrdre |select|, ils sont remplacs par les aleurs de ces champs.
! un dictionnaire : les parametres de lòrdre |select| sont alors les cls du dictionnaire. A lèxcution de lòrdre
|select|, celles-ci sont remplaces par leurs aleurs associes dans le dictionnaire.
! si le |SLLLC1| ne ramene aucune ligne, le rsultat |List| est un objet ide d'lments mais pas )*"" , verifier,.
|queryIorObject|
Cette mthode est identique dans son esprit a la prcdente mais elle ne ramene quùn unique objet. Si le |SLLLC1| ne ramene
aucune ligne, le rsultat est le pointeur )*"".
|insert|
Cette mthode permet dèxcuter un ordre SQL |insert| paramtr par le second parametre. L'objet rendu est la cl primaire de la
ligne qui a t insre. Il n'y a pas d'obligation a utiliser ce rsultat.
16,3
|update|
Cette mthode permet dèxcuter un ordre SQL |update| paramtr par le second parametre. Le rsultat est le nombre de lignes
modiies par l'ordre SQL |update|.
|delete|
Cette mthode permet dèxcuter un ordre SQL |delete| paramtr par le second parametre. Le rsultat est le nombre de lignes
supprimes par l'ordre SQL |delete|.
Reenons a la mthode |getAll| de la classe |DaoImplCommon| :
3. return getSqlMapClientTemplate().queryForList("Personne.getAll", null);
4.}
! ligne 4 : lòrdre |select| nomm " Personne.getAll " est excut. Il nèst pas paramtr et donc lòbjet " parametre " est )*"".
Dans |personnes-irebird.xml|, lòrdre |select| nomm " Personne.getAll " est le suiant :
2.
3. <!DOCTYPE sqlMap
6.
7. <sqlMap>
13. class="Personne.classe">
21. </resultMap>
25. ...
26. </sqlMap>
! ligne 23 : lòrdre SQL " Personne.getAll " est non paramtr ,absence de parametres dans le texte de la requte,.
! la ligne 3 de la mthode |getAll| demande lèxcution de la requte |select| appele " Personne.getAll ". Celle-ci a tre
excute. |iBA1IS| sàppuie sur JDBC. On sait alors que le rsultat de la requte a tre obtenu sous la orme dùn objet
|ResultSet|. Ligne 23, làttribut |resultMap| de la balise select indique a |iBA1IS| quel " resultMap " il doit utiliser pour
transormer chaque ligne du |ResultSet| obtenu en objet. Cèst le " resultMap " |Personne.map| dini lignes 12-21 qui
indique comment passer dùne ligne de la table |PLRSONNLS| a un objet de type |Personne|. |iBA1IS| a utiliser ces
correspondances pour ournir une liste dòbjets |Personne| a partir des lignes de lòbjet |ResultSet|.
! la ligne 3 de la mthode |getAll| renoie alors une collection dòbjets |Personne|
! la mthode |querylorList| peut lancer une exception Spring |DataAccessLxception|. Nous la laissons remonter.
Nous expliquons les autres mthodes de la classe |AbstractDaoImpl| plus rapidement, lèssentiel sur lùtilisation d`|iBA1IS| ayant
t dit dans l`tude de la mthode |getAll|.
getOne
Cette mthode permet dòbtenir une personne identiie par son |id|. Son code est le suiant :
1,3
3. // on la rcupre dans la BD
4. Personne personne = (Personne) getSqlMapClientTemplate()
5. .queryForObject("Personne.getOne", new Integer(id));
6. // a-t-on rcupr qq chose ?
7. if (personne == null) {
8. // on lance une exception
9. throw new DaoException(
10. "La personne d'id [" + id + "] n'existe pas", 2);
11. }
12. // on rend la personne
13. return personne;
14. }
! ligne 4 : demande lèxcution de lòrdre |select| nomm " Personne.getOne ". Celui-ci est le suiant dans le ichier
|personnes-irebird.xml| :
2. <select id="Personne.getOne" resultMap="Personne.map" parameterClass="int">
3. select ID, VERSION, NOM, PRENOM, DATENAISSANCE, MARIE, NBENFANTS FROM
4. PERSONNES WHERE ID=#value#</select>
Lòrdre SQL est paramtr par le parametre 4alue4 ,ligne 4,. Làttribut 4alue4 dsigne la aleur du parametre pass a
lòrdre SQL, lorsque ce parametre est de type simple : Integer, Double, String, ... Dans les attributs de la balise select,
làttribut |parameterClass| indique que le parametre est de type entier ,ligne 2,. Ligne 5 de |getOne|, on oit que ce
parametre est lìdentiiant de la personne cherche sous la orme dùn objet +)&,-,.. Ce changement de type est obligatoire
puisque le second parametre de |querylorList| doit tre de type |Object|.
Le rsultat de la requte |select| sera a transormer en objet ia làttribut |resultMap~"Personne.map"| ,ligne 2,. On
obtiendra donc un type |Personne|.
! lignes -11 : si la requte |select| nà ramen aucune ligne, on rcupere alors le pointeur )*"" en ligne 4. Cela signiie quòn
nà pas trou la personne cherche. Dans ce cas, on lance une |DaoLxception| de code 2 ,lignes 9-10,.
! ligne 13 : sìl n`y a pas eu dèxception, alors on rend lòbjet |Personne| demand.
deleteOne
Cette mthode permet de supprimer une personne identiie par son |id|. Son code est le suiant :
3. // on supprime la personne
4. int n = getSqlMapClientTemplate().delete("Personne.deleteOne",
5. new Integer(id));
6. // a-t-on russi
7. if (n == 0) {
8. throw new DaoException("Personne d'id [" + id + "] inconnue", 2);
9. }
10. }
! lignes 4-5 : demande lèxcution de lòrdre |delete| nomm " Personne.deleteOne ". Celui-ci est le suiant dans le ichier
|personnes-irebird.xml| :
1.
Lòrdre SQL est paramtr par le parametre 4alue4 ,ligne 3, de type |parameterClass~"int"| ,ligne 2,. Ce sera
lìdentiiant de la personne cherche ,ligne 5 de /,",&,0),,
! ligne 4 : le rsultat de la mthode 123"4#(!"5,)&6,7("#&,89/,",&, est le nombre de lignes dtruites.
! lignes -8 : si la requte |delete| nà dtruit aucune ligne, cela signiie que la personne nèxiste pas. On lance une
|DaoLxception| de code 2 ,ligne 8,.
saeOne
Cette mthode permet dàjouter une nouelle personne ou de modiier une personne existante. Son code est le suiant :
18,3
4. check(personne);
7. // ajout
9. } else {
11. }
12. }
13....
! ligne 4 : on riie la alidit de la personne aec la mthode |check|. Cette mthode existait dja dans la ersion
prcdente et aait t alors commente. Llle lance une |DaoLxception| si la personne est inalide. On laisse remonter
celle-ci.
! ligne 6 : si on arrie la, cèst quìl n`y a pas eu dèxception. La personne est donc alide.
! lignes 6-11 : selon lìd de la personne, on a aaire a un ajout ,id~ -1, ou a une mise a jour ,id -1,. Dans les deux cas, on
ait appel a deux mthodes internes a la classe :
! insertPersonne : pour làjout
! updatePersonne : pour la mise a jour
insertPersonne
Cette mthode permet dàjouter une nouelle personne. Son code est le suiant :
1.// ajouter une personne
3. // 1re version
4. personne.setVersion(1);
5. // on attend 10 ms - pour les tests mettre true au lieu de false
6. if (true)
7. wait(10);
8. // on insre la nouvelle personne dans la table de la BD
9. getSqlMapClientTemplate().insert("Personne.insertOne", personne);
10. }
! ligne 4 : on met a 1 le n de ersion de la personne que lòn est en train de crer
! ligne 9 : on ait lìnsertion ia la requte nomme " Personne.insertOne " qui est la suiante :
3. SELECT GEN_ID(GEN_PERSONNES_ID,1) as "value" FROM RDB$$DATABASE
4. </selectKey>
5. insert into
6. PERSONNES(ID, VERSION, NOM, PRENOM, DATENAISSANCE, MARIE, NBENFANTS)
7. VALUES(#id#, #version#, #nom#, #prenom#, #dateNaissance#, #marie#,
8. #nbEnfants#) </insert>
Cèst une requte paramtre et le parametre est de type |Personne| ,parameterClass~"Personne.classe", ligne 1,. Les
champs de lòbjet |Personne| passs en parametre ,ligne 9 de 5)$,.&%,.$:)),, sont utiliss pour remplir les colonnes de la
ligne qui a tre insre dans la table |PLRSONNLS| ,lignes 5-8,. On a un probleme a rsoudre. Lors d'une insertion,
lòbjet |Personne| a insrer a son id gal a -1. Il aut remplacer cette aleur par une cl primaire alide. On utilise pour cela
les lignes 2-4 de la balise selectKey ci-dessus. Llles indiquent :
! la requte SQL a excuter pour obtenir une aleur de cl primaire. Celle indique ici est celle que nous aons
prsente au paragraphe 2.1 - page 4. Deux points sont a noter :
! as " value " est obligatoire. On peut aussi crire #$;<#"*, mais <#"*, est un mot cl de lirebird qui a du
tre protg par des guillemets.
! la table lirebird s'appelle en ralit |RDB>DA1ABASL|. Mais le caractere > est interprt par |iBA1IS|.
Il a t protg en le ddoublant.
! le champ de l'objet |Personne| qu'il aut initialiser aec la aleur rcupre par l'ordre |SLLLC1|, ici le champ
|id|. C'est l'attribut |keyProperty| de la ligne 2 qui indique ce champ.
! lignes 6- : pour le besoin des tests, nous serons amens a attendre 10 ms aant de aire l'insertion, ceci pour oir sìl y a
des conlits entre threads qui oudraient aire en mme temps des ajouts.
updatePersonne
Cette mthode permet de modiier une personne existant dja dans la table |PLRSONNLS|. Son code est le suiant :
1.// modifier une personne
4. if (true)
19,3
5. wait(10);
6. // modification
7. int n = getSqlMapClientTemplate()
8. .update("Personne.updateOne", personne);
9. if (n == 0)
10. throw new DaoException("La personne d'Id [" + personne.getId()
11. + "] n'existe pas ou bien a t modifie", 2);
12. }
! une mise a jour peut chouer pour au moins deux raisons :
1. la personne a mettre a jour nèxiste pas
2. la personne a mettre a jour existe mais le thread qui eut la modiier nà pas la bonne ersion
! lignes -8 : la requte SQL |update| nomme " Personne.updateOne " est excute. C'est la suiante :
3. PERSONNES set VERSION=#version#+1, NOM=#nom#, PRENOM=#prenom#,
DATENAISSANCE=#dateNaissance#,
! ligne 2 : la requte est paramtre et admet pour parametre un type |Personne|
,parameterClass~"Personne.classe",. Celui-ci est la personne a modiier ,ligne 8 - updatePersonne,.
! on ne eut modiier que la personne de la table |PLRSONNLS| ayant le mme n |id| et la mme ersion
|ersion| que le parametre. Cèst pourquoi, on a la contrainte |\lLRL ID~4id4 and VLRSION~4ersion4|.
Si cette personne est troue, elle est mise a jour aec la personne parametre et sa ersion est augmente de 1
,ligne 3 ci-dessus,.
! ligne 9 : on rcupere le nombre de lignes mises a jour.
! lignes 10-11 : si ce nombre est nul, on lance une |DaoLxception| de code 2, indiquant que, soit la personne a mettre a jour
nèxiste pas, soit elle a chang de ersion entre-temps.
2.4 1ests de la couche dao
2.4.1 Tests de I'impImentation [DaoImpICommon]
Maintenant que nous aons crit la couche |dao|, nous nous proposons de la tester aec des tests JUnit :
Aant de aire des tests intensis, nous pouons commencer par un simple programme de type |main| qui a aicher le contenu de
la table |PLRSONNLS|. Cèst la classe |Main1estDaolirebird| :
1. package istia.st.springmvc.personnes.tests;
2.
3. import istia.st.springmvc.personnes.dao.IDao;
4.
6. import java.util.Iterator;
7.
8. import org.springframework.beans.factory.xml.XmlBeanFactory;
9. import org.springframework.core.io.ClassPathResource;
10.
11. public class MainTestDaoFirebird {
12. public static void main(String[] args) {
13. IDao dao = (IDao) (new XmlBeanFactory(new ClassPathResource(
14. "spring-config-test-dao-firebird.xml"))).getBean("dao");
15. // liste actuelle
16. Collection personnes = dao.getAll();
17. // affichage console
18. Iterator iter = personnes.iterator();
19. while (iter.hasNext()) {
20. System.out.println(iter.next());
21. }
20,3
22. }
23. }

Le ichier de coniguration |spring-conig-test-dao-irebird.xml| de la couche |dao|, utilis lignes 13-14, est le suiant :
3. <beans>
9. </property>
10. 
13. </property>
16. </property>
19. </property>
20. </bean>
26. </property>
29. </property>
30. </bean>
35. </property>
36. </bean>
37. </beans>
Ce ichier est celui tudi au paragraphe 2.3.2, page 12.
Pour le test, le SGBD lirebird est lanc. Le contenu de la table |PLRSONNLS| est le suiant :
Lèxcution du programme |Main1estDaolirebird| donne les rsultats cran suiants :
On a bien obtenu la liste des personnes. On peut passer au test JUnit.
Le test JUnit |1estDaolirebird| est le suiant :
2.
3. import java.text.ParseException;
4. import java.text.SimpleDateFormat;
21,3
6. import java.util.Iterator;
7. import org.springframework.beans.factory.xml.XmlBeanFactory;
8. import org.springframework.core.io.ClassPathResource;
9.
10. import istia.st.springmvc.personnes.dao.DaoException;
13. import junit.framework.TestCase;
14.
15. public class TestDaoFirebird extends TestCase {
16.
17. // couche [dao]
18. private IDao dao;
19.
20. public IDao getDao() {
21. return dao;
22. }
23.
24. public void setDao(IDao dao) {
25. this.dao = dao;
26. }
27.
28. // constructeur
29. public void setUp() {
30. dao = (IDao) (new XmlBeanFactory(new ClassPathResource(
31. "spring-config-test-dao-firebird.xml"))).getBean("dao");
32. }
33.
35. private void doListe(Collection personnes) {
36. ...
37. }
38.
39. // test1
40. public void test1() throws ParseException {
41. ...
42. }
43.
44. // modification-suppression d'un lment inexistant
46. ..
47. }
48.
49. // gestion des versions de personne
50. public void test3() throws ParseException, InterruptedException {
51. ...
52. }
53.
54. // optimistic locking - accs multi-threads
55. public void test4() throws Exception {
56. ...
57. }
58.
59. // tests de validit de saveOne
61. ....
62. }
63.
64. // insertions multi-threads
65. public void test6() throws ParseException, InterruptedException{
66. ...
67. }
! les tests |test1| a |test5| sont les mmes que dans la ersion 1, sau |test4| qui a lgerement olu. Le test |test6| est lui
noueau. Nous ne commentons que ces deux tests.
|test4|
|test4| a pour objecti de tester la mthode |updatePersonne - DaoImplCommon|. On rappelle le code de celle-ci :
1.// modifier une personne
4. if (true)
5. wait(10);
6. // modification
9. if (n == 0)
12. }
22,3
! lignes 4-5 : on attend 10 ms. On orce ainsi le thread qui excute |updatePersonne| a perdre le processeur, ce qui peut
augmenter nos chances de oir des conlits dàcces entre threads concurrents.
|test4| lance N~100 threads chargs dìncrmenter, en mme temps, de 1 le nombre dènants de la mme personne. On eut oir
comment les conlits de ersion et les conlits dàcces sont grs.
2. // ajout d'une personne
3. Personne p1 = new Personne(-1, "X", "X", new SimpleDateFormat(
4. "dd/MM/yyyy").parse("01/02/2006"), true, 0);
5. dao.saveOne(p1);
6. int id1 = p1.getId();
7. // cration de N threads de mise jour du nombre d'enfants
8. final int N = 100;
9. Thread[] taches = new Thread[N];
10. for (int i = 0; i < taches.length; i++) {
11. taches[i] = new ThreadDaoMajEnfants("thread n " + i, dao, id1);
12. taches[i].start();
13. }
14. // on attend la fin des threads
16. taches[i].join();
17. }
18. // on rcupre la personne
19. p1 = dao.getOne(id1);
20. // elle doit avoir N enfants
21. assertEquals(N, p1.getNbEnfants());
22. // suppression personne p1
23. dao.deleteOne(p1.getId());
24. // vrification
25. boolean erreur = false;
26. int codeErreur = 0;
27. try {
28. p1 = dao.getOne(p1.getId());
29. } catch (DaoException ex) {
30. erreur = true;
31. codeErreur = ex.getCode();
32. }
33. // on doit avoir une erreur de code 2
34. assertTrue(erreur);
35. assertEquals(2, codeErreur);
36. }
Les threads sont crs lignes 8-13. Chacun a augmenter de 1 le nombre d'enants de la personne cre lignes 3-5. Les threads
|1hreadDaoMajLnants | de mise a jour sont les suiants :
2.
3. import java.util.Date;
4.
5. import istia.st.springmvc.personnes.dao.DaoException;
8.
9. public class ThreadDaoMajEnfants extends Thread {
10. // nom du thread
11. private String name;
12.
13. // rfrence sur la couche [dao]
15.
16. // l'id de la personne sur qui on va travailler
17. private int idPersonne;
18.
19. // constructeur
20. public ThreadDaoMajEnfants(String name, IDao dao, int idPersonne) {
21. this.name = name;
22. this.dao = dao;
23. this.idPersonne = idPersonne;
24. }
25.
26. // coeur du thread
27. public void run() {
28. // suivi
29. suivi("lanc");
30. // on boucle tant qu'on n'a pas russi incrmenter de 1
31. // le nbre d'enfants de la personne idPersonne
32. boolean fini = false;
33. int nbEnfants = 0;
34. while (!fini) {
35. // on rcupre une copie de la personne d'idPersonne
36. Personne personne = dao.getOne(idPersonne);
37. nbEnfants = personne.getNbEnfants();
23,3
38. // suivi
39. suivi("" + nbEnfants + " -> " + (nbEnfants + 1)
40. + " pour la version " + personne.getVersion());
41. // attente de 10 ms pour abandonner le processeur
42. try {
43. // suivi
44. suivi("dbut attente");
45. // on s'interrompt pour laisser le processeur
46. Thread.sleep(10);
47. // suivi
48. suivi("fin attente");
49. } catch (Exception ex) {
50. throw new RuntimeException(ex.toString());
51. }
52. // attente termine - on essaie de valider la copie
53. // entre-temps d'autres threads ont pu modifier l'original
55. try {
56. // incrmente de 1 le nbre d'enfants de cette copie
57. personne.setNbEnfants(nbEnfants + 1);
58. // on essaie de modifier l'original
59. dao.saveOne(personne);
60. // on est pass - l'original a t modifi
61. fini = true;
63. // on rcupre le code erreur
65. // si une erreur d'ID ou de version de code erreur 2, on ressaie la mise jour
66. switch (codeErreur) {
67. case 2:
68. suivi("version corrompue ou personne inexistante");
69. break;
70. default:
71. // exception non gre - on laisse remonter
72. throw ex;
73. }
74. }
75. }
76. // suivi
77. suivi("a termin et pass le nombre d'enfants " + (nbEnfants + 1));
78. }
79.
80. // suivi
81. private void suivi(String message) {
82. System.out.println(name + " [" + new Date().getTime() + "] : "
83. + message);
84. }
85. }
Une mise a jour de personne peut chouer parce que la personne quòn eut modiier nèxiste pas ou quèlle a t mise a jour
auparaant par un autre thread. Ces deux cas sont ici grs lignes 6-69. Dans ces deux cas en eet, la mthode |updatePersonne|
lance une |DaoLxception| de code 2. Le thread sera alors ramen a recommencer la procdure de mise a jour depuis son dbut
,boucle while, ligne 34,.
|test6|
|test6| a pour objecti de tester la mthode |insertPersonne - DaoImplCommon|. On rappelle le code de celle-ci :
1.// ajouter une personne
3. // 1re version
4. personne.setVersion(1);
6. if (true)
7. wait(10);
8. // on insre la nouvelle personne dans la table de la BD
9. getSqlMapClientTemplate().insert("Personne.insertOne", personne);
10. }
! lignes 6- : on attend 10 ms pour orcer le thread qui excute |insertPersonne| a perdre le processeur et augmenter ainsi
nos chances de oir apparaitre des conlits dus a des threads qui ont des insertions en mme temps.
Le code de |test6| est le suiant :
3. // cration d'une personne
4. Personne p = new Personne(-1, "X", "X", new SimpleDateFormat(
6. // qu'on duplique N fois dans un tableau
7. final int N = 100;
24,3
8. Personne[] personnes=new Personne[N];
9. for(int i=0;i<personnes.length;i++){
10. personnes[i]=new Personne(p);
11. }
12. // cration de N threads d'insertion - chaque thread insre 1 personne
13. Thread[] taches = new Thread[N];
15. taches[i] = new ThreadDaoInsertPersonne("thread n " + i, dao, personnes[i]);
16. taches[i].start();
17. }
18. // on attend la fin des threads
20. // thread n i
21. taches[i].join();
22. // supression personne
23. dao.deleteOne(personnes[i].getId());
24. }
25.}
On cre 100 threads qui ont insrer en mme temps 100 personnes direntes. Ces 100 threads ont tous obtenir une cl primaire
pour la personne quìls doient insrer puis tre interrompus pendant 10 ms ,ligne 10 - insertPersonne, aant de pouoir aire leur
insertion. On eut riier que les choses se passent bien et que notamment ils obtiennent bien des aleurs de cl primaire
direntes.
! lignes -11 : un tableau de 100 personnes est cr. Ces personnes sont toutes des copies de la personne p cre lignes 4-5.
! lignes 14-1 : les 100 threads d'insertion sont lancs. Chacun d'eux est charg d'insrer l'une des 100 personnes cre
prcdemment..
! lignes 19-23 : |test6| attend la in de chacun des 100 threads qu'il a lancs. Lorsqu'il a dtect la in du thread n i, il
supprime la personne que ce thread ient d'insrer.
Le thread dìnsertion |1hreadDaoInsertPersonne| est le suiant :
2.
3. import java.util.Date;
4.
7.
8. public class ThreadDaoInsertPersonne extends Thread {
9. // nom du thread
10. private String name;
11.
12. // rfrence sur la couche [dao]
14.
15. // l'id de la personne sur qui on va travailler
16. private Personne personne;
17.
18. // constructeur
19. public ThreadDaoInsertPersonne(String name, IDao dao, Personne personne) {
20. this.name = name;
21. this.dao = dao;
22. this.personne = personne;
23. }
24.
27. // suivi
28. suivi("lanc");
29. // insertion
31. // suivi
32. suivi("a termin");
33. }
34.
35. // suivi
36. private void suivi(String message) {
37. System.out.println(name + " [" + new Date().getTime() + "] : "
38. + message);
39. }
40. }
! lignes 19-22 : le constructeur du thread mmorise la personne qu'il doit insrer et la couche |dao| qu'il doit utiliser pour
aire cette insertion.
! ligne 30 : la personne est insre. Si une exception se produit, elle remonte a |test6|.
1ests
25,3
Aux tests, on obtient les rsultats suiants :
- le test |test4| choue
- le test |test6| russit
Le test |test4| choue donc. Le nombre d'enants est pass a 64 au lieu de 100 attendu. Que s'est-il pass Lxaminons les logs
cran. Ils montrent l'existence d'exceptions lances par lirebird :
1. Exception in thread "Thread-62" org.springframework.jdbc.UncategorizedSQLException: SqlMapClient
operation; uncategorized SQLException for SQL []; SQL state [HY000]; error code [335544336];
2. --- The error occurred in personnes-firebird.xml.
3. --- The error occurred while applying a parameter map.
4. --- Check the Personne.updateOne-InlineParameterMap.
5. --- Check the statement (update failed).
6. --- Cause: org.firebirdsql.jdbc.FBSQLException: GDS Exception. 335544336. deadlock
7. update conflicts with concurrent update; nested exception is
com.ibatis.common.jdbc.exception.NestedSQLException:
8. --- The error occurred in personnes-firebird.xml.
9. --- The error occurred while applying a parameter map.
! ligne 1 - on a eu une exception Spring |org.springramework.jdbc.UncategorizedSQLLxception|. C'est une exception non
controle qui a t utilise pour encapsuler une exception lance par le pilote JDBC de lirebird, dcrite ligne 6.
! ligne 6 - le pilote JDBC de lirebird a lanc une exception de type |org.irebirdsql.jdbc.lBSQLLxception| et de code
d'erreur 335544336.
! ligne : indique qu'on a eu un conlit d'acces entre deux threads qui oulaient mettre a jour en mme temps la mme ligne
de la table |PLRSONNLS|.
Ce n'est pas une erreur irrcuprable. Le thread qui intercepte cette exception peut retenter la mise a jour. Il aut pour cela modiier
le code de |1hreadDaoMajLnants| :
1. try {
7. fini = true;
11. // si une erreur d'ID ou de version de code ereur 2, on ressaie la mise jour
13. case 2:
15. break;
16. default:
18. throw ex;
19. }
! ligne 8 : on gere une exception de type |DaoLxception|. D'apres ce qui a t dit, il nous audrait grer l'exception qui est
apparue aux tests, le type |org.springramework.jdbc.UncategorizedSQLLxception|. On ne peut cependant pas se
contenter de grer ce type qui est un type gnrique de Spring destin a encapsuler des exceptions qu'il ne connait pas.
Spring connait les exceptions mises par les pilotes JDBC d'un certain nombre de SGBD tels Oracle, MySQL, Postgres,
DB2, SQL Serer, ... mais pas lirebird. Aussi toute exception lance par le pilote JDBC de lirebird se troue-t-elle
encapsule dans le type Spring |org.springramework.jdbc.UncategorizedSQLLxception| :
26,3
On oit ci-dessus, que la classe |UncategorizedSQLLxception| drie de la classe |DataAccessLxception| que nous aons
oque, paragraphe 2.3.3 - page 16. Il est possible de connaitre l'exception qui a t encapsule dans
|UncategorizedSQLLxception| grace a sa mthode |getSQLLxception| :
Cette exception de type |SQLLxception| est celle lance par la couche |iBA1IS| qui elle mme encapsule l'exception
lance par le pilote JDBC de la base de donnes. La cause exacte de l'exception de type |SQLLxception| peut tre
obtenue par la mthode :
On obtient l'objet de type |1hrowable| qui a t lanc par le pilote JDBC :
Le type |1hrowable| est la classe parent de |Lxception|.
Ici il nous audra riier que l'objet de type |1hrowable| lanc par le pilote JDBC de lirebird et cause de l'exception
|SQLLxception| lance par la couche |iBA1IS| est bien une exception de type |org.irebirdsql.gds.GDSLxception| et de code
d'erreur 335544336. Pour rcuprer le code erreur, nous pourrons utiliser la mthode |getLrrorCode,,| de la classe
|org.irebirdsql.gds.GDSLxception|.
Si nous utilisons dans le code de |1hreadDaoMajLnants| l'exception |org.irebirdsql.gds.GDSLxception|, alors ce thread ne pourra
traailler qu'aec le SGBD lirebird. Il en sera de mme du test |test4| qui utilise ce thread. Nous oulons iter cela. Ln eet, nous
souhaitons que nos tests JUnit restent alables quelque soit le SGBD utilis. Pour arrier a ce rsultat, on dcide que la couche
|dao| lancera une |DaoLxception| de code 4 lorsqu'une exception de type " conlit de mise a jour " est dtecte et ce, quelque soit
le SGBD sous-jacent. Ainsi, le thread |1hreadDaoMajLnants| pourra-t-il tre rcrit comme suit :
2. ...
3.
4. public class ThreadDaoMajEnfants extends Thread {
5. ...
6.
9. ...
10. while (!fini) {
11. // on rcupre une copie de la personne d'idPersonne
12. Personne personne = dao.getOne(idPersonne);
13. nbEnfants = personne.getNbEnfants();
2,3
14. ...
15. // attente termine - on essaie de valider la copie
16. // entre-temps d'autres threads ont pu modifier l'original
18. try {
24. fini = true;
28. // si une erreur d'ID ou de version 2 ou un deadlock 4, on
29. // ressaie la mise jour
31. case 2:
33. break;
34. case 4:
35. suivi("conflit de mise jour");
36. break;
37. default:
39. throw ex;
40. }
41. }
42. }
43. // suivi
44. suivi("a termin et pass le nombre d'enfants " + (nbEnfants + 1));
45. }
46. ...
47. }
! lignes 34-36 : l'exception de type |DaoLxception| de code 4 est intercepte. Le thread |1hreadDaoMajLnants| a tre
orc de recommencer la procdure de mise a jour a son dbut ,ligne 10,
Notre couche |dao| doit donc tre capable de reconnaitre une exception de type " conlit de mise a jour ". Celle-ci est mise par un
pilote JDBC et lui est spciique. Cette exception doit tre gre dans la mthode |updatePersonne| de la classe |DaoImplCommon|
:
4. if (true)
5. wait(10);
6. // modification
9. if (n == 0)
12. }
Les lignes -11 doient tre entoures par un try , catch. Pour le SGBD lirebird, il nous aut riier que l'exception qui a caus
l'chec de la mise a jour est de type |org.irebirdsql.gds.GDSLxception| et a comme code d'erreur 335544336. Si on met ce type de
test dans |DaoImplCommon|, on a lier cette classe au SGBD lirebird, ce qui n'est idemment pas souhaitable. Si on eut garder
un caractere gnraliste a la classe |DaoImplCommon|, il nous aut la drier et grer l'exception dans une classe spciique a
lirebird. C'est ce que nous aisons maintenant.
2.4.2 La cIasse [DaoImpIFirebird]
Son code est le suiant :
2.
4.
5. public class DaoImplFirebird extends DaoImplCommon {
6.
10. if (true)
11. wait(10);
12. // modification
13. try {
14. // on modifie la personne qui a la bonne version
28,3
15. int n = getSqlMapClientTemplate().update("Personne.updateOne",
16. personne);
17. if (n == 0)
20. } catch (org.springframework.jdbc.UncategorizedSQLException ex) {
21. if (ex.getSQLException().getCause().getClass().isAssignableFrom(
22. org.firebirdsql.jdbc.FBSQLException.class)) {
23. org.firebirdsql.jdbc.FBSQLException cause = (org.firebirdsql.jdbc.FBSQLException) ex
24. .getSQLException().getCause();
25. if (cause.getErrorCode() == 335544336) {
26. throw new DaoException(
27. "Conflit d'accs au mme enregistrement", 4);
28. }
29. } else {
30. throw ex;
31. }
32. }
33. }
34.
35. // attente
36. private void wait(int N) {
37. // on attend N ms
38. try {
39. Thread.sleep(N);
40. } catch (InterruptedException e) {
41. // on affiche la trace de l'exception
42. e.printStackTrace();
43. return;
44. }
45. }
46.
47. }
! ligne 5 : la classe |DaoImpllirebird| drie de |DaoImplCommon|, la classe que nous enons d`tudier. Llle redinit,
lignes 8-33, la mthode |updatePersonne| qui nous pose probleme.
! lignes 20 : nous interceptons l'exception Spring de type |UncategorizedSQLLxception|
! lignes 21-22 : nous riions que l'exception sous-jacente de type |SQLLxception| et lance par la couche |iBA1IS| a pour
cause une exception de type |org.irebirdsql.jdbc.lBSQLLxception|
! ligne 25 : on riie de plus que le code erreur de cette exception lirebird est 335544336, le code d'erreur du " deadlock ".
! lignes 26-2 : si toutes ces conditions sont runies, une |DaoLxception| de code 4 est lance.
! lignes 36-44 : la mthode |wait| permet dàrrter le thread courant de N millisecondes. Llle nà dùtilit que pour les tests.
Nous sommes prts pour les tests de la nouelle couche |dao|.
2.4.3 Tests de I'impImentation [DaoImpIFirebird]
Le ichier de coniguration des tests |spring-conig-test-dao-irebird.xml| est modii pour utiliser l'implmentation
|DaoImpllirebird| :
3. <beans>
9. </property>
13. </property>
16. </property>
19. </property>
20. </bean>
26. </property>
29. </property>
29,3
30. </bean>
32. <bean id="dao" class="istia.st.springmvc.personnes.dao.DaoImplFirebird">
35. </property>
36. </bean>
37. </beans>
! ligne 32 : la nouelle implmentation |DaoImpllirebird| de la couche |dao|.
Les rsultats du test |test4| qui aait chou prcdemment sont les suiants :
|test4| a t russi. Les dernieres lignes de logs cran sont les suiantes :
1. thread n 36 [1145977145984] : fin attente
2. thread n 75 [1145977145984] : a termin et pass le nombre d'enfants 99
3. thread n 36 [1145977146000] : version corrompue ou personne inexistante
4. thread n 36 [1145977146000] : 99 -> 100 pour la version 100
5. thread n 36 [1145977146000] : dbut attente
6. thread n 36 [1145977146015] : fin attente
7. thread n 36 [1145977146031] : a termin et pass le nombre d'enfants 100
La derniere ligne indique que cèst le thread n 36 qui a termin le dernier. La ligne 3 montre un conlit de ersion qui a orc le
thread n 36 a reprendre sa procdure de mise a jour de la personne ,ligne 4,. Dàutres logs montrent des conlits dàcces lors des
mises a jour :
2. thread n 75 [1145977145765] : conflit de mise jour
La ligne 2 montre que le thread n 5 a chou lors de sa mise a jour a cause dùn conlit de mise a jour : lorsque la commande SQL
|update| a t mise sur la table |PLRSONNLS|, la ligne quìl allait mettre a jour tait errouille par un autre thread. Ce conlit
d'acces a obliger le thread n 5 a retenter sa mise a jour.
Pour terminer aec |test4| on remarquera une dirence notable aec les rsultats du mme test dans la ersion 1 ou il aait chou
a cause de problemes de synchronisation. Les mthodes de la couche |dao| de la ersion 1 n`tant pas synchronises, des conlits
dàcces apparaissaient. Ici, nous nàons pas eu besoin de synchroniser la couche |dao|. Nous aons simplement gr les conlits
dàcces signals par lirebird.
Lxcutons maintenant la totalit du test JUnit de la couche |dao| :
30,3
Il semble donc quòn ait une couche |dao| alide. Pour la dclarer alide aec une orte probabilit, il nous audrait aire daantage
de tests encore. Nanmoins, nous la considererons comme oprationnelle.
2.S La couche service
2.5.1 Les composantes de Ia couche [service]
La couche |serice| est constitue des classes et interaces suiantes :
! |ISerice| est lìnterace prsente par la couche |serice|
! |SericeImpl| est une implmentation de celle-ci
Lìnterace |ISerice| est la suiante :
1. package istia.st.springmvc.personnes.service;
2.
4.
6.
7. public interface IService {
8. // liste de toutes les personnes
9. Collection getAll();
10.
11. // obtenir une personne particulire
12. Personne getOne(int id);
13.
14. // ajouter/modifier une personne
15. void saveOne(Personne personne);
16.
17. // supprimer une personne
18. void deleteOne(int id);
19.
20. // sauvegarder plusieurs personnes
21. void saveMany(Personne[] personnes);
22.
23. // supprimer plusieurs personnes
24. void deleteMany(int ids[]);
25. }
! lìnterace a les mmes quatre mthodes que dans la ersion 1 mais elle en a deux de plus :
! saveMany : permet de sauegarder plusieurs personnes en mme temps de aon atomique. Soit elles sont toutes
sauegardes, soit aucune ne lèst.
! deleteMany : permet de supprimer plusieurs personnes en mme temps de aon atomique. Soit elles sont toutes
supprimes, soit aucune ne lèst.
Ces deux mthodes ne seront pas utilises par làpplication web. Nous les aons rajoutes pour illustrer la notion de
transaction sur une base de donnes. Les deux mthodes deront en eet tre excutes au sein dùne transaction pour
obtenir làtomicit dsire.
La classe |SericeImpl| implmentant cette interace sera la suiante :
1. package istia.st.springmvc.personnes.service;
2.
5.
7.
8. public class ServiceImpl implements IService {
9.
10. // la couche [dao]
12.
13. public IDao getDao() {
14. return dao;
15. }
16.
17. public void setDao(IDao dao) {
31,3
18. this.dao = dao;
19. }
20.
23. return dao.getAll();
24. }
25.
28. return dao.getOne(id);
29. }
30.
34. }
35.
38. dao.deleteOne(id);
39. }
40.
41. // sauvegarder une collection de personnes
42. public void saveMany(Personne[] personnes) {
43. // on boucle sur le tableau des personnes
44. for (int i = 0; i < personnes.length; i++) {
45. dao.saveOne(personnes[i]);
46. }
47. }
48.
49. // supprimer une collection de personnes
50. public void deleteMany(int[] ids) {
51. // ids : les id des personnes supprimer
52. for (int i = 0; i < ids.length; i++) {
53. dao.deleteOne(ids[i]);
54. }
55. }
56. }
! les mthodes |getAll, getOne, insertOne, saeOne| ont appel aux mthodes de la couche |dao| de mme nom.
! lignes 42-4 : la mthode |saeMany| sauegarde, une par une, les personnes du tableau pass en parametre.
! lignes 50-55 : la mthode |deleteMany| supprime, une par une, les personnes dont on lui a pass le tableau des 5/ en
parametre
Nous aons dit que les mthodes |saeMany| et |deleteMany| deaient se aire au sein dùne transaction pour assurer làspect tout
ou rien de ces mthodes. Nous pouons constater que le code ci-dessus ignore totalement cette notion de transaction. Celle-ci
nàpparaitra que dans le ichier de coniguration de la couche |serice|.
2.5.2 Configuration de Ia couche [service]
Ci-dessus, ligne 11, on oit que lìmplmentation |SericeImpl| dtient une rrence sur la couche |dao|. Celle-ci, comme dans la
ersion 1, sera initialise par Spring au moment de lìnstanciation de la couche |serice - SericeImpl|. Le ichier de coniguration
qui permettra lìnstanciation de la couche |serice| sera le suiant :
3. <beans>
9. </property>
13. </property>
16. </property>
19. </property>
20. </bean>
32,3
26. </property>
29. </property>
30. </bean>
31. 
35. </property>
36. </bean>
37. 
38. <bean id="transactionManager"
39. class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
42. </property>
43. </bean>
44. 
45. <bean id="service"
46. class="org.springframework.transaction.interceptor.TransactionProxyFactoryBean">
47. <property name="transactionManager">
48. <ref local="transactionManager"/>
49. </property>
50. <property name="target">
51. <bean class="istia.st.springmvc.personnes.service.ServiceImpl">
52. <property name="dao">
53. <ref local="dao"/>
54. </property>
55. </bean>
56. </property>
57. <property name="transactionAttributes">
58. <props>
59. <prop key="get*">PROPAGATION_SUPPORTS,readOnly</prop>
60. <prop key="save*">PROPAGATION_REQUIRED</prop>
61. <prop key="delete*">PROPAGATION_REQUIRED</prop>
62. </props>
63. </property>
64. </bean>
65. </beans>
! lignes 1-36 : coniguration de la couche |dao|. Cette coniguration a t explique lors de l`tude de la couche |dao| au
paragraphe 2.3.2 - page 12.
! lignes 38-64 : conigurent la couche |serice|
Ligne 46, on peut oir que lìmplmentation de la couche |serice| est aite par le type |1ransactionProxylactoryBean|. On
sàttendait a trouer le type |SericeImpl|. |1ransactionProxylactoryBean| est un type prdini de Spring. Comment se peut-il
quùn type prdini puisse implmenter lìnterace |ISerice| qui elle, est spciique a notre application
Dcourons tout dàbord la classe |1ransactionProxylactoryBean| :
Nous oyons quèlle implmente lìnterace |lactoryBean|. Nous aons dja rencontr cette interace. Nous saons que lorsquùne
application demande a Spring, une instance dùn type implmentant |lactoryBean|, Spring rend non pas une instance |I| de ce type,
mais lòbjet rendu par la mthode 1+89-,&0=>,?&@A :
Dans notre cas, la couche |serice| a tre implmente par lòbjet rendu par 16.#)$#?&5:)%.:BCD#?&:.CE,#)89-,&0=>,?&@A. Quelle est la
nature de cet objet Nous nàllons pas rentrer dans les dtails car ils sont complexes. Ils releent de ce quòn appelle Spring AOP
,Aspect Oriented Programming,. Nous allons tenter d`claircir les choses aec de simples schmas. AOP permet la chose suiante :
! on a deux classes C1 et C2, C1 utilisant l'interace |I2| prsente par C2 :
33,3
! grace a AOP, on peut placer, de aon transparente pour les deux classes, un intercepteur entre les classes C1 et C2 :
La classe |C1| a t compile pour traailler aec l'interace |I2| que |C2| implmente. Au moment de lèxcution, AOP
ient placer la classe |intercepteur| entre |C1| et |C2|. Pour que cela soit possible, il aut bien sr que la classe
|intercepteur| prsente a |C1| la mme interace |I2| que |C2|.
A quoi cela peut-il serir La documentation Spring donne quelques exemples. On peut ouloir aire, par exemple, des
logs a l'occasion des appels a une mthode M particuliere de |C2|, pour aire un audit de cette mthode. Dans
|intercepteur|, on crira alors une mthode |M| qui ait ces logs. Làppel de |C1| a |C2|.M a se passer ainsi ,c schma ci-
dessus, :
1. |C1| appelle la mthode M de |C2|. Cèst en ait la mthode M de |intercepteur| qui sera appele. Cela est
possible si |C1| sàdresse a une interace |I2| plutot quà une implmentation particuliere de |I2|. Il suit alors
que |intercepteur| implmente |I2|.
2. la mthode M de |intercepteur| ait les logs et appelle la mthode M de |C2| ise initialement par |C1|.
3. la mthode M de |C2| sèxcute et rend son rsultat a la mthode M de |intercepteur| qui peut entuellement
ajouter quelque chose a ce qui a t ait en 2.
4. la mthode M de |intercepteur| rend un rsultat a la mthode appelante de |C1|
On oit que la mthode M de |intercepteur| peut aire quelque chose avant et aprs làppel de la mthode M de |C2|. Vis
a is de |C1|, elle enrichit donc la mthode M de |C2|. On peut donc oir la technologie AOP comme une aon dènrichir
lìnterace prsente par une classe.
Comment ce concept sàpplique-t-il a notre couche |serice| Si on implmente la couche |serice| directement aec une instance
|SericeImpl|, notre application web aura làrchitecture suiante :
Si on implmente la couche |serice| aec une instance |1ransactionProxylactoryBean|, on aura làrchitecture suiante :
On peut dire que la couche |serice| est instancie aec deux objets :
! lòbjet que nous appelons ci-dessus |proxy transactionnel| et qui est en ait lòbjet rendu par la mthode |getObject| de
|1ransactionProxylactoryBean|. Cèst cet objet qui era lìnterace de la couche |serice| aec la couche |web|. Il
implmente par construction lìnterace |ISerice|.
! une instance |SericeImpl| qui elle aussi implmente lìnterace |ISerice|. Llle seule sait comment traailler aec la couche
|dao|, aussi est-elle ncessaire.
Imaginons que la couche |web| appelle la mthode |saeMany| de lìnterace |ISerice|. Nous saons que onctionnellement, les
ajouts , mises a jour aits par cette mthode doient l'tre dans une transaction. Soit ils russissent tous, soit aucun nèst ait. Nous
34,3
|C2| |CJ|
|C2| |CJ| |intercepteur|
1
2
3 4
|service|
|SericeImpl|
|web|
|service|
|SericeImpl|
|web|
1
|proxy
transactionnel|
5
|dao|
|DaoImplCommon|
|dao|
|DaoImplCommon|
2
3
4
7
6
aons prsent la mthode |saeMany| de la classe |SericeImpl| et nous aons point le ait quèlle nàait pas la notion de
transaction. La mthode |saeMany| du |proxy transactionnel| a enrichir la mthode |saeMany| de la classe |SericeImpl| aec
cette notion de transaction. Suions le schma ci-dessus :
1. la couche |web| appelle la mthode |saeMany| de lìnterace |ISerice|.
2. la mthode |saeMany| de |proxy transactionnel| est excute. Llle commence une transaction. Il aut quèlle ait
les inormations suisantes pour le aire, notamment un objet |DataSource| pour obtenir une connexion au
SGBD. Puis elle ait appel a la mthode |saeMany| de |SericeImpl|.
3. celle-ci sèxcute. Llle ait appel de aon rpte a la couche |dao| pour excuter les insertions ou les mises a
jour. Les ordres SQL excuts a cette occasion le sont dans la transaction commence en 2.
4. supposons quùne de ces oprations choue. La couche |dao| a laisser remonter une exception ers la couche
|serice|, en lòccurrence la mthode |saeMany| de lìnstance |SericeImpl|.
5. celle-ci ne ait rien et laisse remonter lèxception jusquà la mthode |saeMany| de |proxy transactionnel|.
6. a rception de lèxception, la mthode |saeMany| de |proxy transactionnel| qui est propritaire de la transaction
ait un |rollback| de celle-ci pour annuler la totalit des mises a jour, puis laisse remonter lèxception jusquà la
couche |web| qui sera charge de la grer.
A l`tape 4, nous aons suppos quùne des insertions ou des mises a jour chouait. Si ce nèst pas le cas, en |5| aucune
exception ne remonte. Idem en |6|. Dans ce cas, la mthode |saeMany| de |proxy transactionnel| ait un |commit| de la
transaction pour alider la totalit des mises a jour.
Nous aons maintenant une ide plus prcise de làrchitecture mise en place par le bean |1ransactionProxylactoryBean|. Reenons
sur la coniguration de celui-ci :
6. </property>
7. </bean>
13. </property>
18. </property>
19. </bean>
20. </property>
22. <props>
23. <prop key="get*">PROPAGATION_REQUIRED,readOnly</prop>
26. </props>
27. </property>
28. </bean>
Suions cette coniguration a la lumiere de làrchitecture qui est conigure :
! |proxy transactionnel| a grer les transactions. Spring ore plusieurs stratgies de gestion de celles-ci. |proxy
transactionnel| a besoin dùne rrence sur le gestionnaire de transactions choisi.
! lignes 11 - 13 : dinissent làttribut |transactionManager| du bean |1ransactionProxylactoryBean| aec une rrence sur
un gestionnaire de transactions. Celui-ci est dini lignes 2 - .
! lignes 2- : le gestionnaire de transactions est de type |DataSource1ransactionManager| :
35,3
|service|
|SericeImpl|
|web|
1
|proxy
transactionnel|
5
|dao|
|DaoImplCommon|
2
3
4
7
6
|DataSource1ransactionManager| est un gestionnaire de transactions adapt aux SGBD accds ia un objet
|DataSource|. Il ne sait grer que les transactions sur un unique SGBD. Il ne sait pas grer des transactions distribues sur
plusieurs SGBD. Ici, nous nàons quùn seul SGBD. Aussi ce gestionnaire de transactions conient-il. Lorsque |proxy
transactionnel| a dmarrer une transaction, il a le aire sur une connexion attache au thread. Cèst cette connexion qui
sera utilise dans toutes les couches qui menent a la base de donnes : |SericeImpl, DaoImplCommon,
SqlMapClient1emplate, JDBC|.
La classe |DataSource1ransactionManager| a besoin de connaitre la source de donnes aupres de laquelle elle doit
demander une connexion pour làttacher au thread. Celle-ci est dinie lignes 4-6 : cèst la mme source de donnes que
celle utilise par la couche |dao| ,c paragraphe 2.5.2, page 32,.
! lignes 14-19 : làttribut " target " indique la classe qui doit tre intercepte, ici la classe |SericeImpl|. Cette inormation est
ncessaire pour deux raisons :
! la classe |SericeImpl| doit tre instancie puisque cèst elle qui assure le dialogue aec la couche |dao|
! |1ransactionProxylactoryBean| doit gnrer un proxy qui prsente a la couche |web| la mme interace que
|SericeImpl|.
! lignes 21-2 : indiquent quelles mthodes de |SericeImpl|, le proxy doit intercepter. Làttribut |transactionAttributes|,
ligne 21, indique quelles mthodes de |SericeImpl| ncessitent une transaction et quels sont les attributs de celle-ci :
! ligne 23 : les mthodes dont le nom commencent par get |getOne, getAll| sèxcutent dans une transaction
dàttribut |PROPAGA1ION_RLQUIRLD,readOnly| :
! PROPAGA1ION_RLQUIRLD : la mthode sèxcute dans une transaction s'il y en a dja une attache au
thread, sinon une nouelle est cre et la mthode sèxcute dedans.
! readOnly : transaction en lecture seule
Ici les mthodes |getOne| et |getAll| de |SericeImpl| sèxcuteront dans une transaction alors qu'en ait ce n'est
pas ncessaire. Il s'agit a chaque ois d'une opration constitue d'un unique ordre SLLLC1. On ne oit pas l'utilit
de mettre ce SLLLC1 dans une transaction.
! ligne 24 : les mthodes dont le nom commencent par save, |saeOne, saeMany| sèxcutent dans une transaction
dàttribut |PROPAGA1ION_RLQUIRLD|.
! ligne 25 : les mthodes |deleteOne| et |deleteMany| de |SericeImpl| sont conigures de aon identique aux
mthodes |saeOne, saeMany|.
Dans notre couche |serice|, seules les mthodes |saeMany| et |deleteMany| ont besoin de sèxcuter dans une transaction. La
coniguration aurait pu tre rduite aux lignes suiantes :
2. <props>
3. <prop key="saveMany">PROPAGATION_REQUIRED</prop>
4. <prop key="deleteMany">PROPAGATION_REQUIRED</prop>
5. </props>
6. </property>
2.6 1ests de la couche service
Maintenant que nous aons crit et conigur la couche |serice|, nous nous proposons de la tester aec des tests JUnit :
36,3
Le ichier de coniguration |spring-conig-test-serice-irebird.xml| de la couche |serice| est celui qui a t dcrit au paragraphe
2.5.2, page 32.
Le test JUnit |1estSericelirebird| est le suiant :
2.
3. ...
4.
5. public class TestServiceFirebird extends TestCase {
6.
7. // couche [service]
8. private IService service;
9.
10. public IService getService() {
11. return service;
12. }
13.
14. public void setService(IService service) {
15. this.service = service;
16. }
17.
18. // setup
19. public void setUp() {
20. service = (IService) (new XmlBeanFactory(new ClassPathResource(
21. "spring-config-test-service-firebird.xml"))).getBean("service");
22. }
23.
25. private void doListe(Collection personnes) {
26. ...
27. }
28.
29. // test1
31. ...
32. }
33.
34. // modification-suppression d'un lment inexistant
36. ...
37. }
38.
39. // gestion des versions de personne
40. public void test3() throws ParseException, InterruptedException {
41. ...
42. }
43.
44. // optimistic locking - accs multi-threads
46. ...
47. }
48.
49. // tests de validit de saveOne
51. ...
52. }
53.
56. ...
57. }
58.
59. // tests de la mthode deleteMany
61. // liste actuelle
62. Collection personnes = service.getAll();
63. int nbPersonnes1 = personnes.size();
64. // affichage
65. doListe(personnes);
66. // cration de trois personnes
67. Personne p1 = new Personne(-1, "X", "X", new SimpleDateFormat(
69. Personne p2 = new Personne(-1, "Y", "Y", new SimpleDateFormat(
70. "dd/MM/yyyy").parse("01/03/2006"), false, 0);
71. Personne p3 = new Personne(-2, "Z", "Z", new SimpleDateFormat(
73. // ajout des 3 personnes - la personne p3 avec l'id -2 va provoquer
74. // une exception
75. boolean erreur = false;
76. try {
77. service.saveMany(new Personne[] { p1, p2, p3 });
79. erreur = true;
3,3
80. System.out.println(ex.toString());
81. }
82. // vrification
84. // nouvelle liste - le nombre d'lments n'a pas du changer
85. // cause rollback automatique de la transaction
86. int nbPersonnes2 = service.getAll().size();
87. assertEquals(nbPersonnes1, nbPersonnes2);
88. // ajout des deux personnes valides
89. // on remet leur id -1
90. p1.setId(-1);
91. p2.setId(-1);
92. service.saveMany(new Personne[] { p1, p2 });
93. // on rcupre leurs id
96. // vrifications
97. p1 = service.getOne(id1);
98. assertEquals(p1.getNom(), "X");
100. assertEquals(p2.getNom(), "Y");
101. // nouvelle liste - on doit avoir 2 lments de +
102. int nbPersonnes3 = service.getAll().size();
103. assertEquals(nbPersonnes1 + 2, nbPersonnes3);
104. // suppression de p1 et p2 et d'une personne inexistante
105. // une exception doit se produire
106. erreur = false;
107. try {
108. service.deleteMany(new int[] { id1, id2, -1 });
110. erreur = true;
111. System.out.println(ex.toString());
112. }
113. // vrification
115. // nouvelle liste
116. personnes = service.getAll();
118. // aucune personne n'a du tre supprime (rollback
119. // automatique de la transaction)
121. // on supprime les deux personnes valides
122. service.deleteMany(new int[] { id1, id2 });
123. // vrifications
124. // personne p1
127. try {
130. erreur = true;
132. }
136. // personne p2
138. codeErreur = 0;
139. try {
142. erreur = true;
144. }
148. // nouvelle liste
149. personnes = service.getAll();
151. // vrification - on doit tre revenu au point de dpart
153. // affichage
154. doListe(personnes);
155. }
156.
157.}
! lignes 19-22 : le programme teste des couches |dao| et |serice| conigures par le ichier |spring-conig-test-serice-
irebird.xml|, celui tudi dans la section prcdente.
! les tests |test1| a |test6| sont identiques dans leur esprit a leurs homologues de mme nom dans la classe de test
|1estDaolirebird| de la couche |dao|. La seule dirence est que par coniguration, les mthodes |saeOne| et
|deleteOne| sèxcutent dsormais dans une transaction.
38,3
! la mthode |test| a pour but de tester les mthodes |saeMany| et |deleteMany|. On eut riier quèlles sèxcutent bien
dans une transaction. Commentons le code de cette mthode :
! lignes 62-63 : on compte le nombre de personnes |nbPersonnes1| actuellement dans la liste
! lignes 6-2 : on cre trois personnes
! lignes 3-83 : ces trois personnes sont sauegardes par la mthode |saeMany| - ligne . Les deux premieres personnes
p1 et p2 ayant un id gal a -1 ont tre ajoutes a la table |PLRSONNLS|. La personne p3 a elle un id gal a -2. Il ne sàgit
donc pas dùne insertion mais dùne mise a jour. Celle-ci a chouer car il n`y a aucune personne aec un id gal a - 2 dans
la table |PLRSONNLS|. La couche |dao| a donc lancer une exception qui a remonter jusquà la couche |serice|.
Lèxistence de cette exception est teste ligne 83.
! a cause de lèxception prcdente, la couche |serice| derait aire un |rollback| de lènsemble des ordres SQL mis
pendant lèxcution de la mthode |saeMany|, ceci parce que cette mthode sèxcute dans une transaction. Lignes 86-8,
on riie que le nombre de personnes de la liste nà pas boug et que donc les insertions de p1 et p2 nònt pas eu lieu.
! lignes 88-103 : on ajoute les seules personnes p1 et p2 et on riie quènsuite on a deux personnes de plus dans la liste.
! lignes 106-114 : on supprime un groupe de personnes constitu des personnes p1 et p2 quòn ient dàjouter et dùne
personne inexistante ,id~ -1,. La mthode |deleteMany| est utilise pour cela, ligne 108. Cette mthode a chouer car il
n`y a aucune personne aec un id gal a - 1 dans la table |PLRSONNLS|. La couche |dao| a donc lancer une exception
qui a remonter jusquà la couche |serice|. Lèxistence de cette exception est teste ligne 114.
! a cause de lèxception prcdente, la couche |serice| derait aire un |rollback| de lènsemble des ordres SQL mis
pendant lèxcution de la mthode |deleteMany|, ceci parce que cette mthode sèxcute dans une transaction. Lignes 116-
11, on riie que le nombre de personnes de la liste nà pas boug et que donc les suppressions de p1 et p2 nònt pas eu
lieu.
! ligne 122 : on supprime un groupe constitu des seules personnes p1 et p2. Cela derait russir. Le reste de la mthode
riie que cèst bien le cas.
Lèxcution des tests donne les rsultats suiants :
Les sept tests ont t russis. Nous considererons notre couche |serice| comme oprationnelle.
2.7 La couche web
Rappelons làrchitecture gnrale de làpplication web a construire :
Nous enons de construire les couches |dao| et |serice| permettant de traailler aec une base de donnes lirebird. Nous aons
crit une ersion 1 de cette application ou les couches |dao| et |serice| traaillaient aec une liste de personnes en mmoire. La
couche |web| crite a cette occasion reste valide. Ln eet, elle sàdressait a une couche |serice| implmentant lìnterace |ISerice|.
La nouelle couche |serice| implmentant cette mme interace, la couche |web| n'a pas tre modifiee.
39,3
utilisateur
! Donnees
Couche d'acces
aux donnes
|dao|
Couche serice
|service|
"
#
$
%
Controller
DispatcherSerlet
View
Modele Map
&
'
Dans le prcdent article, la ersion 1 de làpplication aait t teste aec le projet Lclipse |spring-mc-3B| ou les couches |web,
serice, dao| aaient t mises dans des archies .jar :
Le dossier |\LB-INl,src| tait ide. Les classes des trois couches taient dans les trois archies |personnes-.jar | :
archie de la couche |dao|
archie de la couche |serice|
archie de la couche |web|
Pour tester la ersion 2, nous dupliquons le dossier |mc-3B| du projet |spring-mc-3B| en |mc-38B| :
Nous modiions le ichier |.project| ain quìl rrence un projet Lclipse appel |spring-mc-38B| :
1. <projectDescription>
2. <name>spring-mvc-38B</name>
3. <comment></comment>
4. ...
Nous aisons de mme aec le ichier |.tomcatplugin| pour rrencer une application web de contexte |,spring-mc-38B| :
1. <extraInfo></extraInfo>
2. <webPath>/spring-mvc-38B</webPath>
3. </tomcatProjectProperties>
40,3
Lnsuite nous importons ce projet sous Lclipse |lile , Import , Lxisting projects| :
Dans le projet |spring-mc-38|, nous exportons |lile , Lxport , Jar ile| les couches |dao| et |serice| respectiement dans les
archies |personnes-dao.jar| et |personnes-serice.jar| du dossier |dist| du projet :
Nous copions ces deux ichiers, puis sous Lclipse nous les collons dans le dossier |\LB-INl,lib| ou ils ont remplacer les
archies de mme nom de la ersion prcdente.
Ln procdant de la mme aon, nous copions les archies |commons-dbcp-.jar, commons-pool-.jar, irebirdsql-ull.jar, ibatis-
common-2.jar, ibatis-sqlmap-2.jar| du dossier |lib| du projet |spring-mc-38| dans le dossier |\LB-INl,lib| du projet |spring-mc-
38B|. Ces archies sont ncessaires aux nouelles couches |dao| et |serice|.
Ceci ait, nous incluons les nouelles archies dans le Classpath du projet : |clic droit sur projet - Properties - Jaa Build Path -
Add Jars|.
41,3
Le ichier |applicationContext.xml| conigure les couches |dao| et |serice| de làpplication web. Dans la nouelle ersion, il est
identique au ichier |spring-conig-test-serice-irebird.xml| qui a seri pour conigurer le test de la couche serice dans le projet
|spring-mc-38|. On ait donc un copier , coller de lùn ers làutre :
3. <beans>
9. </property>
13. </property>
16. </property>
19. </property>
20. </bean>
26. </property>
29. </property>
30. </bean>
31. 
35. </property>
36. </bean>
42. </property>
43. </bean>
49. </property>
54. </property>
42,3
55. </bean>
56. </property>
58. <props>
59. <prop key="get*">PROPAGATION_SUPPORTS,readOnly</prop>
62. </props>
63. </property>
64. </bean>
65. </beans>
! ligne 12 : lùrl de la base de donnes lirebird. Nous continuons a utiliser la base qui a seri aux tests des couches |dao| et
|serice|
Nous dclarons le contexte de la nouelle application web |clic droit sur projet - Projet 1omcat - Mise a jour du contexte| :
Nous sommes prts pour les tests. Le SGBD lirebird est lanc. Le contenu de la table |PLRSONNLS| est alors le suiant :
1omcat est lanc a son tour. Aec un naigateur, nous demandons lùrl |http:,,localhost:8080,spring-mc-38B| :
Nous ajoutons une nouelle personne aec le lien |Ajout| :
43,3
Nous riions làjout dans la base de donnes :
Le lecteur est init a aire dàutres tests |modiication, suppression|.
laisons maintenant le test de conlits de ersion qui aait t ait dans la ersion 1. |lireox| sera le naigateur de lùtilisateur U1.
Celui-ci demande lùrl |http:,,localhost:8080,spring-mc-38B,list.html| :
|IL| sera le naigateur de lùtilisateur U2. Celui-ci demande la mme Url :
44,3
Lùtilisateur U1 entre en modiication de la personne |Perrichon| :
Lùtilisateur U2 ait de mme :
Lùtilisateur U1 ait des modiications et alide :
alidation
rponse du sereur
Lùtilisateur U2 ait de mme :
45,3
alidation
le conlit de ersion a t dtect
Lùtilisateur U2 reient a la liste des personnes aec le lien |Annuler| du ormulaire :
Il troue la personne |Perrichon| telle que U1 là modiie ,nom pass en majuscules,.
Lt la base de donnes dans tout a Regardons :
La personne n 654 a bien son nom en majuscules suite a la modiication aite par U1.
2.8 Conclusion
Rappelons ce que nous oulions aire. Nous aions une application web aec làrchitecture 3tier suiante :
46,3
ou les couches |dao| et |serice| traaillaient aec une liste de donnes en mmoire qui tait donc perdue lorsque le sereur web
tait arrt. C`tait la ersion 1. Dans la ersion 2, les couches |serice| et |dao| ont t rcrites pour que la liste de personnes soit
dans une table de base de donnes. Llle est donc dsormais persistante. On se propose maintenant de oir lìmpact quà sur notre
application le changement de SGBD. Pour cela, nous allons construire trois nouelles ersions de notre application web :
! ersion 3 : le SGBD est Postgres
! ersion 4 : le SGBD est MySQL
! ersion 5 : le SGBD est SQL Serer Lxpress 2005
Les changements se ont aux endroits suiants :
! la classe |DaoImpllirebird| implmente des onctionnalits de la couche |dao| lies au SGBD lirebird. Si ce besoin
persiste, elle sera remplace respectiement par les classes |DaoImplPostgres|, |DaoImplMySQL| et |DaoImplSqlLxpress|.
! le ichier de mapping |personnes-irebird.xml| dìBA1IS pour le SGBD lirebird a tre remplac respectiement par les
ichiers de mapping |personnes-postgres.xml|, |personnes-mysql.xml| et |personnes-sqlexpress.xml|.
! la coniguration de lòbjet |DataSource| de la couche |dao| est spciique a un SGBD. Llle a donc changer a chaque
ersion.
! le pilote JDBC du SGBD change galement a chaque ersion
Ln-dehors de ces points, tout reste a lìdentique. Dans la suite, nous dcrions ces nouelles ersions en ne nous attachant quàux
seules noueauts amenes par chacune d'elles.
3 Spring MVC dans une architecture 3tier Lxemple 4 - Postgres
3.J La base de donnees Postgres
Dans cette ersion, nous allons installer la liste des personnes dans une table de base de donnes Postgres 8.x
|http:,,www.postgres.org|. Dans ce qui suit, les copies d`cran proiennent du client LMS PostgreSQL Manager Lite
|http:,,www.sqlmanager.net,r,products,postgresql,manager|, un client dàdministration gratuit du SGBD Postgres.
La base de donnes sàppelle |dbpersonnes|. Llle contient une table |PLRSONNLS| :
4,3
utilisateur
! Donnees
Couche d'acces
aux donnes
|dao|
Couche serice
|service|
"
#
$
%
Controller
DispatcherSerlet
View
Modele Map
&
'
suiants :
1. CREATE TABLE "public"."PERSONNES" (
2. "ID" INTEGER NOT NULL,
4. "NOM" VARCHAR(30) NOT NULL,
5. "PRENOM" VARCHAR(30) NOT NULL,
6. "DATENAISSANCE" DATE NOT NULL,
7. "MARIE" BOOLEAN NOT NULL,
8. "NBENFANTS" INTEGER NOT NULL,
9. CONSTRAINT "PERSONNES_pkey" PRIMARY KEY("ID"),
10. CONSTRAINT "PERSONNES_chk_NBENFANTS" CHECK ("NBENFANTS" >= 0),
11. CONSTRAINT "PERSONNES_chk_NOM" CHECK (("NOM")::text <> ''::text),
12. CONSTRAINT "PERSONNES_chk_PRENOM" CHECK (("PRENOM")::text <> ''::text)
13. ) WITH OIDS;
Nous nìnsistons pas sur cette table qui est analogue a la table |PLRSONNLS| de type lirebird tudie prcdemment. On notera
cependant que les noms des colonnes et des tables sont entre guillemets. Par ailleurs, ces noms sont sensibles a la casse. Il est
possible que ce mode de onctionnement de Postgres 8.x soit conigurable. Je nài pas creus la question.

Outre la table |PLRSONNLS|, la base |dbpersonnes| a, un objet appel squence et nomm |SLQ_ID|. Ce gnrateur dlire des
nombres entiers successis que nous utiliserons pour donner sa aleur a la cl primaire |ID| de la classe |PLRSONNLS|. Prenons
un exemple pour illustrer son onctionnement :
48,3
- double-cliquer sur |SLQ_ID|
- la prochaine aleur du gnrateur est 38
- mettons lòrdre SQL ci-dessus ,l12, -
- la aleur obtenue est la aleur |Next alue| de la squence
|SLQ_ID|
On peut constater que la aleur |Next alue| de la squence |SLQ_ID| a chang ,double-clic dessus - l5 pour raraichir, :
Lòrdre SQL
SELECT nextval('"SEQ_ID"')
permet donc dàoir la aleur suiante de la squence |SLQ_ID|. Nous lùtiliserons dans le ichier |personnes-postgres.xml| qui
rassemble les ordres SQL mis sur le SGBD.
Pour delopper les couches |dao| et |serice| de notre application aec la base de donnes Postgres 8.x, nous utiliserons le projet
Lclipse |spring-mc-39| suiant :
49,3
Le projet est un simple projet Jaa, pas un projet web 1omcat.
Dossier |src|
1ous les ichiers ayant |postgres| dans leur nom ont pu subir ou non une modication is a is de la ersion lirebird.Dans ce qui
suit, nous dcrions les ichiers modiis.
Dossier |database|
Ce dossier contient le script de cration de la base de donnes Postgres des personnes :
1. -- EMS PostgreSQL Manager Lite 3.1.0.1
2. -- ---------------------------------------
3. -- Host : localhost
4. -- Database : dbpersonnes
5.
6.
7.
8. --
9. -- Definition for function plpgsql_call_handler (OID = 17230) :
10. --
11. ...
12. --
13. -- Structure for table PERSONNES (OID = 17254) :
14. --
15. CREATE TABLE "PERSONNES" (
16. "ID" integer NOT NULL,
17. "VERSION" integer NOT NULL,
18. "NOM" varchar(30) NOT NULL,
19. "PRENOM" varchar(30) NOT NULL,
20. "DATENAISSANCE" date NOT NULL,
21. "MARIE" boolean NOT NULL,
50,3
22. "NBENFANTS" integer NOT NULL,
23. CONSTRAINT "PERSONNES_chk_NBENFANTS" CHECK (("NBENFANTS" >= 0)),
24. CONSTRAINT "PERSONNES_chk_NOM" CHECK ((("NOM")::text <> ''::text)),
25. CONSTRAINT "PERSONNES_chk_PRENOM" CHECK ((("PRENOM")::text <> ''::text))
26. );
27. --
28. -- Definition for sequence SEQ_ID (OID = 17261) :
29. --
30. CREATE SEQUENCE "SEQ_ID"
31. INCREMENT BY 1
32. NO MAXVALUE
33. NO MINVALUE
34. CACHE 1;
35. --
36. -- Data for blobs (OID = 17254) (LIMIT 0,3)
37. --
38. INSERT INTO "PERSONNES" ("ID", "VERSION", "NOM", "PRENOM", "DATENAISSANCE", "MARIE", "NBENFANTS")
VALUES (1, 1, 'Major', 'Joachim', '1984-11-13', true, 2);
VALUES (2, 1, 'Humbort', 'Mlanie', '1985-01-12', false, 1);
VALUES (3, 1, 'Lemarchand', 'Charles', '1986-01-01', false, 0);
41. --
42. -- Definition for index PERSONNES_pkey (OID = 17256) :
43. --
44. ALTER TABLE ONLY "PERSONNES"
45. ADD CONSTRAINT "PERSONNES_pkey" PRIMARY KEY ("ID");
46. --
47. -- Data for sequence public."SEQ_ID" (OID = 17261)
48. --
49. SELECT pg_catalog.setval('"SEQ_ID"', 37, true);
50. --
51. -- Comments
52. --
53. COMMENT ON SCHEMA public IS 'Standard public schema';
Dossier |lib|
On notera la prsence du pilote jdbc du SGBD Postgres 8.x. 1outes ces archies ont partie du !"#$$(#&' du projet Lclipse.
Dossier |dist|
Ce dossier contient les archies issues de la compilation des classes de làpplication :
3.3 La couche dao
La couche |dao| est la suiante :
51,3
Nous ne prsentons que ce qui change is a is de la ersion |lirebird|.
Le ichier de mapping |personne-postgres.xml| est le suiant :
2.
3. <!DOCTYPE sqlMap
6.
7. 
9.
10. <sqlMap>
16. class="istia.st.springmvc.personnes.entites.Personne">
24. </resultMap>
26. <select id="Personne.getAll" resultMap="Personne.map" > select "ID",
27. "VERSION", "NOM", "PRENOM", "DATENAISSANCE", "MARIE", "NBENFANTS" FROM
28. "PERSONNES"</select>
30. <select id="Personne.getOne" resultMap="Personne.map" >select "ID",
31. "VERSION", "NOM", "PRENOM", "DATENAISSANCE", "MARIE", "NBENFANTS" FROM
32. "PERSONNES" WHERE "ID"=#value#</select>
36. SELECT nextval('"SEQ_ID"') as value
37. </selectKey>
38. insert into "PERSONNES"("ID", "VERSION",
39. "NOM", "PRENOM", "DATENAISSANCE", "MARIE", "NBENFANTS") VALUES(#id#,
40. #version#, #nom#, #prenom#, #dateNaissance#, #marie#, #nbEnfants#)
41. </insert>
44. "PERSONNES" set "VERSION"=#version#+1, "NOM"=#nom#, "PRENOM"=#prenom#,
45. "DATENAISSANCE"=#dateNaissance#, "MARIE"=#marie#, "NBENFANTS"=#nbEnfants#
46. WHERE "ID"=#id# and "VERSION"=#version#</update>
48. <delete id="Personne.deleteOne" parameterClass="int"> delete FROM
49. "PERSONNES" WHERE "ID"=#value# </delete>
50. </sqlMap>
Cèst le mme contenu que |personnes-irebird.xml| aux dtails pres suiants :
! les noms des colonnes et des tables sont entre guillemets et ces noms sont sensibles a la casse
! lòrdre SQL " Personne.insertOne " a chang lignes 34-41. La aon de gnrer la cl primaire aec Postgres est dirente
de celle utilise aec lirebird :
52,3
! ligne 36 : lòrdre SQL |SLLLC1 nextal,'"SLQ_ID"',| ournit la cl primaire. La syntaxe |as alue| est obligatoire.
|alue| reprsente la cl obtenue. Cette aleur a tre aecte au champ de lòbjet |Personne| dsign par làttribut
|keyProperty| ,line 35,, ici le champ |id|.
! les ordres SQL de la balise insert sont excuts dans lòrdre ou ils sont rencontrs. Donc le SLLLC1 est ait
aant lÌNSLR1. Au moment de lòpration dìnsertion, le champ |id| de lòbjet |Personne| aura donc t mis a jour
par lòrdre SQL SLLLC1.
! lignes 38-40 : insertion de lòbjet |Personne|
La classe dìmplmentation |DaoImplCommon| de la couche |dao| est celle tudie dans la ersion |lirebird|.
La coniguration de la couche |dao| a t adapte au SGBD |Postgres|. Ainsi, le ichier de coniguration |spring-conig-test-dao-
postgres.xml| est-il le suiant :
3. <beans>
8. <value>org.postgresql.Driver</value>
9. </property>
11. <value>jdbc:postgresql:dbpersonnes</value>
12. </property>
14. <value>postgres</value>
15. </property>
17. <value>postgres</value>
18. </property>
19. </bean>
25. </property>
27. <value>classpath:sql-map-config-postgres.xml</value>
28. </property>
29. </bean>
34. </property>
35. </bean>
36. </beans>
! lignes 5-19 : le bean |dataSource| dsigne maintenant la base |Postgres| |dbpersonnes| dont làdministrateur est |postgres|
aec le mot de passe |postgres|. Le lecteur modiiera cette coniguration selon son propre enironnement.
! ligne 31 : la classe |DaoImplCommon| est la classe d'implmentation de la couche |dao|
Ces modiications aites, on peut passer aux tests.
3.4 Les tests des couches dao et service
Les tests des couches |dao| et |serice| sont les mmes que pour la ersion |lirebird|. Les rsultats obtenus sont les suiants :
53,3
- couche |dao|
- couche |serice|
On constate que les tests ont t passs aec succes aec l'implmentation |DaoImplCommon|. Nous n'aurons pas a drier cette
classe comme il aait t ncessaire de le aire aec le SGBD |lirebird|.
3.S 1ests de l'application web
Pour tester làpplication web aec le SGBD |Postgres|, nous construisons un projet Lclipse |spring-mc-39B| de aon analogue a
celle utilise pour construire le projet |spring-mc-38B| aec la base lirebird ,c page 39,.
Le SGBD Postgres est lanc. Le contenu de la table |PLRSONNLS| est alors le suiant :
54,3
4 Spring MVC dans une architecture 3tier Lxemple 4 - MySQL
4.J La base de donnees MySQL
Dans cette ersion, nous allons installer la liste des personnes dans une table de base de donnes MySQL 4.x. Nous aons utilis le
paquetage |Apache - MySQL - PlP| disponible a l'url |http:,,www.easyphp.org|. Dans ce qui suit, les copies d`cran proiennent
du client LMS MySQL Manager Lite |http:,,www.sqlmanager.net,r,products,mysql,manager|, un client dàdministration gratuit
du SGBD MySQL.
suiants :
1. CREATE TABLE personnes (
2. ID int(11) NOT NULL auto_increment,
3. VERSION int(11) NOT NULL default '0',
4. NOM varchar(30) NOT NULL default '',
5. PRENOM varchar(30) NOT NULL default '',
6. DATENAISSANCE date NOT NULL default '0000-00-00',
7. MARIE tinyint(4) NOT NULL default '0',
8. NBENFANTS int(11) NOT NULL default '0',
9. PRIMARY KEY (ID)
10. ) ENGINE=InnoDB DEFAULT CHARSET=latin1
55,3
MySQL 4.x semble plus paure que les deux SGBD prcdents. Je n'ai pas pu mettre de contraintes ,checks, a la table.
! ligne 10 : la table doit aoir le type |InnoDB| et non le type |MyISAM| qui ne supporte pas les transactions.
! ligne 2 : la cl primaire est de type auto_increment. Si on insere une ligne sans aleur pour la colonne ID de la table,
MySQL gnrera automatiquement un nombre entier pour cette colonne. Cela a nous iter de gnrer les cls primaires
nous-mmes.

Nous saons que lors de l'insertion d'un objet |Personne| par notre couche |dao|, le champ |id| de cet objet est gal a -1 aant
l'insertion et a une aleur dirente de -1 ensuite, cette aleur tant la cl primaire aecte a la nouelle ligne insre dans la table
|PLRSONNLS|. Voyons sur un exemple comment nous allons pouoir connaitre cette aleur.
- on excute l'ordre d'insertion ci-dessus ,l12,. On notera qu'on ne donne pas de aleur
au champ ID -
- on excute l'ordre SLLLC1 ci-dessus
pour connaitre la derniere aleur
insre dans le champ ID de la table -
- le rsultat
- riication
Lòrdre SQL
SELECT LAST_INSERT_ID()
permet de connaitre la derniere aleur insre dans le champ ID de la table. Llle est a mettre aprs l'insertion. C'est une
dirence aec les SGBD |lirebird| et |Postgres| ou on demandait la aleur de la cl primaire de la personne ajoute avant
l'insertion. Nous lùtiliserons dans le ichier |personnes-mysql.xml| qui rassemble les ordres SQL mis sur la base de donnes.
Pour delopper les couches |dao| et |serice| de notre application aec la base de donnes MySQL, nous utiliserons le projet
Lclipse |spring-mc-40| suiant :
56,3
Dossier |src|
1ous les ichiers ayant |mysql| dans leur nom ont pu subir ou non une modiication is a is des ersions lirebird et Postgres. Dans
ce qui suit, nous dcrions ceux qui ont t modiis.
Dossier |database|
Ce dossier contient le script de cration de la base de donnes MySQL des personnes :
1. # EMS MySQL Manager Lite 3.2.0.1
2. # ---------------------------------------
3. # Host : localhost
4. # Port : 3306
5. # Database : dbpersonnes
6.
7.
8. SET FOREIGN_KEY_CHECKS=0;
9.
10. CREATE DATABASE dbpersonnes
11. CHARACTER SET 'latin1'
12. COLLATE 'latin1_swedish_ci';
13.
14. USE dbpersonnes;
15.
16. #
17. # Structure for the personnes table :
5,3
18. #
19.
20. CREATE TABLE personnes (
21. ID int(11) NOT NULL auto_increment,
22. VERSION int(11) NOT NULL default '0',
23. NOM varchar(30) NOT NULL default '',
24. PRENOM varchar(30) NOT NULL default '',
25. DATENAISSANCE date NOT NULL default '0000-00-00',
26. MARIE tinyint(4) NOT NULL default '0',
27. NBENFANTS int(11) NOT NULL default '0',
28. PRIMARY KEY (ID)
29. ) ENGINE=InnoDB DEFAULT CHARSET=latin1;
30.
31. #
32. # Data for the personnes table (LIMIT 0,500)
33. #
34.
35. INSERT INTO personnes (ID, VERSION, NOM, PRENOM, DATENAISSANCE, MARIE, NBENFANTS)
VALUES
36. (1,1,'Major','Joachim','1984-01-13',1,2),
37. (2,1,'Humbort','Mlanie','1985-01-12',0,1),
38. (3,1,'Lemarchand','Charles','1986-01-01',0,0);
39.
40. COMMIT;
Dossier |lib|
On notera la prsence du pilote jdbc du SGBD MySQL. 1outes ces archies ont partie du !"#$$(#&' du projet Lclipse.
Dossier |dist|
4.3 La couche dao
58,3
Le ichier de mapping |personne-mysql.xml| est le suiant :
2.
3. <!DOCTYPE sqlMap
6.
7. <sqlMap>
21. </resultMap>
30. insert into
31. PERSONNES(VERSION, NOM, PRENOM, DATENAISSANCE, MARIE, NBENFANTS)
32. VALUES(#version#, #nom#, #prenom#, #dateNaissance#, #marie#,
33. #nbEnfants#)
35. select LAST_INSERT_ID() as value
36. </selectKey>
37. </insert>
46. 
47. <select id="Personne.getNextId" resultClass="int">select
48. LAST_INSERT_ID()</select>
49. </sqlMap>
! lòrdre SQL " Personne.insertOne " a chang lignes 29-3 :
59,3
! l'ordre SQL d'insertion est excut aant l'ordre SLLLC1 qui a permettre de rcuprer la aleur de la cl primaire
de la ligne insre
! l'ordre SQL d'insertion n'a pas de aleur pour la colonne ID de la table |PLRSONNLS|
Cela relete l'exemple d'insertion que nous aons comment page 56.
On notera qu'il y a peut-tre la une source possible de problemes entre threads concurrents. Imaginons deux threads 1h1
et 1h2 qui ont une insertion en mme temps. Il y a au total quatre ordres SQL a mettre. Supposons qu'ils soient aits
dans l'ordre suiant :
1. insertion I1 de 1h1
3. select S1 de 1h1
4. select S2 de 1h2
Ln 3, 1h1 rcupere la cl primaire gnre lors de la derniere insertion, donc celle de 1h2 et non la sienne. Je ne sais pas si
la mthode |insert| d'iBA1IS est protge pour ce cas de igure. Nous allons supposer qu'elle le gere proprement. Si ce
n'tait pas le cas, il nous audrait drier la classe dìmplmentation |DaoImplCommon| de la couche |dao| en une classe
|DaoImplMySQL| ou la mthode |insertPersonne| serait synchronise. Ceci ne rsoudrait le probleme que pour les
threads de notre application. Si ci-dessus, 1h1 et 1h2 sont des threads de deux applications direntes, il audrait alors
rsoudre le probleme a la ois aec des transactions et un nieau d'tanchit adquat ,isolation leel, entre transactions.
Le nieau |serializable| dans lequel les transactions sont excutes comme si elles s'excutaient squentiellement serait
appropri.
On notera que ce probleme n'existe pas aec les SGBD lirebird et Postgres qui eux ont le SLLLC1 aant l'INSLR1. Si
on a par exemple la squence :
1. select S1 de 1h1
2. select S2 de 1h2
Aux tapes 1 et 2, 1h1 et 1h2 rcuperent des aleurs de cl primaire aupres du mme gnrateur. Cette opration est
normalement atomique, et 1h1 et 1h2 ont rcuprer deux aleurs direntes. Si l'opration n'tait pas atomique, et que
1h1 et 1h2 rcupraient deux aleurs identiques, l'insertion aite en 4 par 1h2 chouerait pour cause de doublon de cl
primaire. C'est une erreur tout a ait rcuprable et 1h2 peut retenter l'insertion.
On a laisser l'opration " Personne.insertOne " telle qu'elle est actuellement dans le ichier |personnes-mysql.xml| mais le
lecteur doit aoir conscience qu'il y a la potentiellement un probleme.
La classe dìmplmentation |DaoImplCommon| de la couche |dao| est celle des deux ersions prcdentes.
La coniguration de la couche |dao| a t adapte au SGBD |MySQL|. Ainsi, le ichier de coniguration |spring-conig-test-dao-
mysql.xml| est-il le suiant :
3. <beans>
8. <value>com.mysql.jdbc.Driver</value>
9. </property>
11. <value>jdbc:mysql://localhost/dbpersonnes</value>
12. </property>
14. <value>root</value>
15. </property>
17. <value></value>
18. </property>
19. </bean>
25. </property>
27. <value>classpath:sql-map-config-mysql.xml</value>
28. </property>
60,3
29. </bean>
34. </property>
35. </bean>
36.</beans>
! lignes 5-19 : le bean |dataSource| dsigne maintenant la base |MySQL| |dbpersonnes| dont làdministrateur est |root| sans
mot de passe. Le lecteur modiiera cette coniguration selon son propre enironnement.
4.4 Les tests des couches dao et service
- couche |dao|
- couche |serice|
4.S 1ests de l'application web
Pour tester làpplication web aec le SGBD |MySQL|, nous construisons un projet Lclipse |spring-mc-40B| de aon analogue a
celle utilise pour construire le projet |spring-mc-38B| aec la base lirebird ,c page 39,.
Le SGBD MySQL est lanc. Le contenu de la table |PLRSONNLS| est alors le suiant :
61,3
S Spring MVC dans une architecture 3tier Lxemple S SQL Server
Lxpress
S.J La base de donnees SQL Server Lxpress
Dans cette ersion, nous allons installer la liste des personnes dans une table de base de donnes SQL Serer Lxpress 2005
disponible a l'url |http:,,msdn.microsot.com,studio,express,sql,|. Dans ce qui suit, les copies d`cran proiennent du client
LMS Manager Lite pour SQL Serer Lxpress |http:,,www.sqlmanager.net,r,products,mssql,manager|, un client
dàdministration gratuit du SGBD SQL Serer Lxpress.
62,3
suiants :
1. CREATE TABLE [dbo].[PERSONNES] (
2. [ID] int IDENTITY(1, 1) NOT NULL,
3. [VERSION] int NOT NULL,
4. [NOM] varchar(30) COLLATE French_CI_AS NOT NULL,
5. [PRENOM] varchar(30) COLLATE French_CI_AS NOT NULL,
6. [DATENAISSANCE] datetime NOT NULL,
7. [MARIE] tinyint NOT NULL,
8. [NBENFANTS] tinyint NOT NULL,
9. PRIMARY KEY CLUSTERED ([ID]),
10. CONSTRAINT [PERSONNES_ck_NOM] CHECK ([NOM]<>''),
11. CONSTRAINT [PERSONNES_ck_PRENOM] CHECK ([PRENOM]<>''),
12. CONSTRAINT [PERSONNES_ck_NBENFANTS] CHECK ([NBENFANTS]>=(0))
13. )
14. ON [PRIMARY]
15. GO
! ligne 2 : la cl primaire |ID| est de type entier. L'attribut IDLN1I1Y indique que si on insere une ligne sans aleur pour
la colonne ID de la table, SQL Lxpress gnrera lui-mme un nombre entier pour cette colonne. Dans IDLN1I1\,1, 1,,
le premier parametre est la premiere aleur possible pour la cl primaire, le second, l'incrment utilis dans la gnration
des nombres.

Nous saons que lors de l'insertion d'un objet |Personne| par notre couche |dao|, le champ |id| de cet objet est gal a -1 aant
l'insertion et a une aleur dirente de -1 ensuite, cette aleur tant la cl primaire aecte a la nouelle ligne insre dans la table
|PLRSONNLS|. Voyons sur un exemple comment nous allons pouoir connaitre cette aleur.
63,3
- on excute l'ordre d'insertion ci-dessus ,l12,. On notera qu'on ne donne pas de aleur
au champ ID -
- on excute l'ordre SLLLC1 ci-dessus
pour connaitre la derniere aleur
insre dans le champ ID de la table -
- le rsultat
- riication
Lòrdre SQL
SELECT IDENTITY
permet de connaitre la derniere aleur insre dans le champ ID de la table. Llle est a mettre aprs l'insertion. C'est une
dirence aec les SGBD |lirebird| et |Postgres| ou on demandait la aleur de la cl primaire de la personne ajoute avant
l'insertion, mais c'est analogue a la gnration de cl primaire du SGBD MySQL. Nous lùtiliserons dans le ichier |personnes-
sqlexpress.xml| qui rassemble les ordres SQL mis sur la base de donnes.
S.2 Le projet Lclipse des couches dao et service
Pour delopper les couches |dao| et |serice| de notre application aec la base de donnes|SQL Serer Lxpress|, nous utiliserons le
projet Lclipse |spring-mc-41| suiant :
Dossier |src|
64,3
1ous les ichiers ayant |sqlexpress| dans leur nom ont pu subir ou non une modiication is a is des ersions lirebird, Postgres et
MySQL. Dans ce qui suit, nous ne dcrions que ceux qui ont t modiis.
Dossier |database|
Ce dossier contient le script de cration de la base de donnes SQL Lxpress des personnes :
1. -- SQL Manager 2005 Lite for SQL Server (2.2.0.1)
2. -- ---------------------------------------
3. -- Host : (local)\SQLEXPRESS
4. -- Database : dbpersonnes
5.
6.
7. --
8. -- Structure for table PERSONNES :
9. --
10.
11. CREATE TABLE [dbo].[PERSONNES] (
12. [ID] int IDENTITY(1, 1) NOT NULL,
13. [VERSION] int NOT NULL,
14. [NOM] varchar(30) COLLATE French_CI_AS NOT NULL,
15. [PRENOM] varchar(30) COLLATE French_CI_AS NOT NULL,
16. [DATENAISSANCE] datetime NOT NULL,
17. [MARIE] tinyint NOT NULL,
18. [NBENFANTS] tinyint NOT NULL,
19. CONSTRAINT [PERSONNES_ck_NBENFANTS] CHECK ([NBENFANTS]>=(0)),
20. CONSTRAINT [PERSONNES_ck_NOM] CHECK ([NOM]<>''),
21. CONSTRAINT [PERSONNES_ck_PRENOM] CHECK ([PRENOM]<>'')
22. )
23. ON [PRIMARY]
24. GO
25.
26. --
27. -- Data for table PERSONNES (LIMIT 0,500)
28. --
29.
30. SET IDENTITY_INSERT [dbo].[PERSONNES] ON
31. GO
32.
33. INSERT INTO [dbo].[PERSONNES] ([ID], [VERSION], [NOM], [PRENOM], [DATENAISSANCE], [MARIE],
[NBENFANTS])
34. VALUES
35. (1, 1, 'Major', 'Joachim', '19541113', 1, 2)
36. GO
37.
[NBENFANTS])
39. VALUES
40. (2, 1, 'Humbort', 'Mlanie', '19850212', 0, 1)
41. GO
42.
[NBENFANTS])
44. VALUES
45. (3, 1, 'Lemarchand', 'Charles', '19860301', 0, 0)
65,3
46. GO
47.
48. SET IDENTITY_INSERT [dbo].[PERSONNES] OFF
49. GO
50.
51. --
52. -- Definition for indices :
53. --
54.
55. ALTER TABLE [dbo].[PERSONNES]
56. ADD PRIMARY KEY CLUSTERED ([ID])
57. WITH (
58. PAD_INDEX = OFF,
59. IGNORE_DUP_KEY = OFF,
60. STATISTICS_NORECOMPUTE = OFF,
61. ALLOW_ROW_LOCKS = ON,
62. ALLOW_PAGE_LOCKS = ON)
63. ON [PRIMARY]
64. GO
Dossier |lib|
On notera la prsence du pilote jdbc |sqljdbc.jar| du SGBD |Sql Serer Lxpress|. 1outes ces archies ont partie du !"#$$(#&' du
projet Lclipse.
Dossier |dist|
S.3 La couche dao
66,3
Le ichier de mapping |personne-sqlexpress.xml| est le suiant :
2.
3. <!DOCTYPE sqlMap
6.
7. <sqlMap>
21. </resultMap>
30. insert into
31. PERSONNES(VERSION, NOM, PRENOM, DATENAISSANCE, MARIE, NBENFANTS)
32. VALUES(#version#, #nom#, #prenom#, #dateNaissance#, #marie#,
33. #nbEnfants#)
35. select IDENTITY as value
36. </selectKey>
37. </insert>
46. 
47. <select id="Personne.getNextId" resultClass="int">select
48. LAST_INSERT_ID()</select>
49. </sqlMap>
! lòrdre SQL " Personne.insertOne " a chang lignes 29-3 :
! l'ordre SQL d'insertion est excut aant l'ordre SLLLC1 qui a permettre de rcuprer la aleur de la cl primaire
de la ligne insre
6,3
! l'ordre SQL d'insertion n'a pas de aleur pour la colonne ID de la table |PLRSONNLS|
Cela relete l'exemple d'insertion que nous aons comment page 63. A noter, qu'on retroue ici le probleme d'insertions
simultanes par des threads dirents dcrit pour MySQL au paragraphe 4.3, page 60.
La classe dìmplmentation |DaoImplCommon| de la couche |dao| est celle des trois ersions prcdentes.
La coniguration de la couche |dao| a t adapte au SGBD |SQL Lxpress|. Ainsi, le ichier de coniguration |spring-conig-test-
dao-sqlexpress.xml| est-il le suiant :
3. <beans>
8. <value>com.microsoft.sqlserver.jdbc.SQLServerDriver</value>
9. </property>
11. <value>jdbc:sqlserver://localhost\\SQLEXPRESS:4000;databaseName=dbpersonnes</value>
12. </property>
14. <value>sa</value>
15. </property>
17. <value>msde</value>
18. </property>
19. </bean>
25. </property>
27. <value>classpath:sql-map-config-sqlexpress.xml</value>
28. </property>
29. </bean>
34. </property>
35. </bean>
36. </beans>
! lignes 5-19 : le bean |dataSource| dsigne maintenant la base |SQL Lxpress| |dbpersonnes| dont làdministrateur est |sa|
aec le mot de passe |msde|. Le lecteur modiiera cette coniguration selon son propre enironnement.
La ligne 11 mrite des explications :
<value>jdbc:sqlserver://localhost\\SQLEXPRESS:4000;databaseName=dbpersonnes</value>
! //localhost : indique que le sereur SQL Lxpress est sur la mme machine que notre application Jaa
! \\SQLLXPRLSS : est le nom d'une instance de SQL Serer. Il semble que plusieurs instances peuent s'excuter en
mme temps. Il semble donc logique de nommer l'instance a laquelle on s'adresse. Ce nom peut tre obtenu grace |SQL
Serer Coniguration Manager| install normalement en mme temps que SQL Lxpress :
68,3
! 4000 : port d'coute de SQL Lxpress. Cela est dpendant de la coniguration du sereur. Par daut, il traaille aec des
ports dynamiques, donc pas connus a l'aance. On ne prcise alors pas de port dans l'url JDBC. Ici, nous aons traaill
aec un port ixe, le port 4000. Cela s'obtient par coniguration :
- |clic droit sur 1CP,IP - Proprits| -
- on laisse les champs |1CP Dynamic Ports| ides
- on met les champs |1CP Port| a 4000
! l'attribut dataBaseName ixe la base de donnes aec laquelle on eut traailler. C'est celle qui a t cre aec le client
LMS :

S.4 Les tests des couches dao et service
- couche |dao|
- couche |serice|
69,3
S.S 1ests de l'application web
Pour tester làpplication web aec le SGBD |SQL Serer Lxpress|, nous construisons un projet Lclipse |spring-mc-41B| de aon
analogue a celle utilise pour construire le projet |spring-mc-38B| aec la base lirebird ,c page 39,.
Le SGBD SQL serer Lxpress est lanc. Le contenu de la table |PLRSONNLS| est alors le suiant :
0,3
6 Conclusion
Rappelons le but de cet article. Dans l'article qui prcdait, nous aions mis en oeure Spring MVC dans une architecture 3tier
|web, metier, dao| sur un exemple basique de gestion dùne liste de personnes.
Dans cette ersion 1, la liste des personnes tait maintenue en mmoire et disparaissait au dchargement de làpplication web. Dans
les quatre nouelles ersions tudies ici, la liste des personnes est maintenue dans une table de base de donnes. Nous aons utilis
quatre SGBD dirents : lirebird, Postgres, MySQL et SQL Serer Lxpress. Nous n'aons delopp que les seules couches
|serice| et |dao|, la couche |web| restant celle deloppe pour la ersion 1.
Ce que nous aons oulu montrer dans cet article, c'est l'apport de Spring pour la construction des couches |dao| et |serice|. Grace
a l'intgration de Spring aec iBA1IS, nous aons pu construire quatre ersions qui ne dierent que par leurs ichiers de
coniguration. La mme classe |DaoImplCommon| a t utilise pour implmenter la couche |dao| dans les quatre ersions. Pour
grer un probleme spciique au SGBD lirebird, nous aons t amens a drier cette classe mais pas a la modiier.
Lnin, nous aons montr comment Spring nous permettait de grer les transactions de aon dclaratie au nieau de la couche
|serice|.
7 Le code de l'article
Comme pour les prcdents articles, le lecteur trouera le code des exemples de ce document sous la orme d'un ichier zipp sur le
site de l'article. Les regles de dploiement du ichier zipp sont a relire dans l'article 1. Une ois un projet import dans |Lclipse| :
! copier le contenu du dossier |lib| du zip dans le dossier |\LB-INl,lib| du projet
! s'assurer que le dossier |work| existe sinon le crer : |clic droit sur projet , Projet 1omcat , Crer le dossier work|
! nettoyer le projet |Project , clean , clean selected projects|
Pour rejouer les tests, le lecteur devra adapter la configuration du DataSource trouve dans les differents fichiers de
configuration son propre environnement. Cet objet renseigne :
1. le nom de classe du pilote JDBC du SGBD utilis
2. l'url de la base de donnes a exploiter
3. le proprietaire des connexions qui sont ouertes sur la base
4. le mot de passe de ce dernier.
Les inormations 2 a 4 sont dpendantes de l'enironnement utilis pour les tests.
Le code est lir sous la orme d'un zip contenant les dossiers suiants :
Le dossier |lib| rassemble les archies utilises par les dirents projets |mc-xx, mc-xxB| :
1,3
utilisateur
! Donnees
Couche d'acces
aux donnes
|dao|
Couche serice
|service|
"
#
$
%
Controller
DispatcherSerlet
View
Modele Map
&
'
Les dossiers |lib| des dirents projets ont t eux ids ain de diminuer la taille du zip. Il audra donc aller chercher les archies
ncessaires a un projet dans le dossier |lib| ci-dessus. Dans les dossiers |lib| des projets web |mc-xxB|, on a laiss les archies des
couches |dao|, |serice| et |web| de l'application construite par les projets associs |mc-xx| :
2,3
TabIe des matires
!()*++,-. ( ((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((( ( ///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// ( &(
&(.+)012(345(6*1.(71,(*)5809,597),("90,)(:(,;,3+-,(&(<(=0),>0)6 ( ((((((((((((((((((((((((((((((((((((((((((((((((((((((((( ( ///////////////////////////////////////////////////////// ( &(
&/! ( -*(>*.,(6,(6?11@,.(=0),>0)6///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////&
&/& ( -,(+)?A,9(,5-0+.,(6,.(5?758,.(B6*?C(,9(B.,)405,C///////////////////////////////////////////////////////////////////////////////////////////////////////////////////// #
&/" ( -*(5?758,(B6*?C//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////'
2.3.1 LES COMPOSANTES DE LA COUCHE |DAO|......................................................................................................................................... 6
2.3.2 LA COUCHE DÀCCES AUX DONNEES |IBATIS|................................................................................................................................ 8
2.3.3 LA CLASSE |DAOIMPLCOMMON|.................................................................................................................................................. 14
&/# ( 9,.9.(6,(-*(5?758,(B6*?C//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////&D
2.4.1 TESTS DE L'IMPLEMENTATION |DAOIMPLCOMMON|......................................................................................................................... 20
2.4.2 LA CLASSE |DAOIMPLFIREBIRD|...................................................................................................................................................28
2.4.3 TESTS DE L'IMPLEMENTATION |DAOIMPLFIREBIRD|..........................................................................................................................29
&/$ ( -*(5?758,(B.,)405,C//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////"!
2.5.1 LES COMPOSANTES DE LA COUCHE |SERVICE|.................................................................................................................................. 31
2.5.2 CONFIGURATION DE LA COUCHE |SERVICE|..................................................................................................................................... 32
&/' ( 9,.9.(6,(-*(5?758,(B.,)405,C////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////"'
&/% ( -*(5?758,(BE,>C/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// "F
&/G ( 5?15-7.0?1////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////#'
"(.+)012(345(6*1.(71,(*)5809,597),("90,)(:(,;,3+-,(#(<(+?.92),. ( ((((((((((((((((((((((((((((((((((((((((((((((((((((( ( ///////////////////////////////////////////////////// ( #% (
"/! ( -*(>*.,(6,(6?11@,.(+?.92),./////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// #%
"/& ( -,(+)?A,9(,5-0+.,(6,.(5?758,.(B6*?C(,9(B.,)405,C/////////////////////////////////////////////////////////////////////////////////////////////////////////////////// #F
"/" ( -*(5?758,(B6*?C////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////$!
"/# ( -,.(9,.9.(6,.(5?758,.(B6*?C(,9(B.,)405,C///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// $"
"/$ ( 9,.9.(6,(-H*++-05*90?1(BE,>C//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// $#
#(.+)012(345(6*1.(71,(*)5809,597),("90,)(:(,;,3+-,(#(<(3I.J- ( (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((( ( //////////////////////////////////////////////////////////// ( $$ (
#/! ( -*(>*.,(6,(6?11@,.(3I.J-/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////$$
#/& ( -,(+)?A,9(,5-0+.,(6,.(5?758,.(B6*?C(,9(B.,)405,C/////////////////////////////////////////////////////////////////////////////////////////////////////////////////// $'
#/" ( -*(5?758,(B6*?C////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////$G
#/# ( -,.(9,.9.(6,.(5?758,.(B6*?C(,9(B.,)405,C///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// '!
#/$ ( 9,.9.(6,(-H*++-05*90?1(BE,>C//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// '!
$(.+)012(345(6*1.(71,(*)5809,597),("90,)(:(,;,3+-,($(:(.J-(.,)4,)(,;+),.. ( (((((((((((((((((((((((((((((( ( ////////////////////////////// ( '& (
$/! ( -*(>*.,(6,(6?11@,.(.J-(.,)4,)(,;+),..//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// '&
$/& ( -,(+)?A,9(,5-0+.,(6,.(5?758,.(B6*?C(,9(B.,)405,C/////////////////////////////////////////////////////////////////////////////////////////////////////////////////// '#
$/" ( -*(5?758,(B6*?C////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////''
$/# ( -,.(9,.9.(6,.(5?758,.(B6*?C(,9(B.,)405,C///////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// 'F
$/$ ( 9,.9.(6,(-H*++-05*90?1(BE,>C//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// %D
'(5?15-7.0?1 ( (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((( ( ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// ( %! (
%(-,(5?6,(6,(-K*)905-, ( (((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((((( ( ////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////// ( %! (
3,3

Springmvc 5

Загружено:

Сведения о документе

Оригинальное название

Авторское право

Доступные форматы

Поделиться этим документом

Поделиться или встроить документ

Параметры публикации

Этот документ был вам полезен?

Это неприемлемый материал?

Авторское право:

Доступные форматы

Springmvc 5

Загружено:

Авторское право:

Доступные форматы

Spring MVC par l'exemple

Вам также может понравиться