Blog de CinéPhil

Installer Open Modelsphere sous Linux

CinePhil — Wed, 29 Aug 2012 13:05:39 +0000

MISE À JOUR LE 29/08/2012 pour la version 3.2

« Open ModelSphere est un outil complet de modélisation de données qui prend en charge la modélisation conceptuelle, logique et physique. Il supporte plusieurs formalismes, entre autres: Entité-Association, DATARUN, et Information Engineering. Les modèles conceptuels peuvent être convertis en modèles relationnels et vice versa. »

Avec Open Modelsphere, on peut notamment modéliser des bases de données selon la méthode Merise ou en faisant un diagramme de classes UML.

C’est aussi, à ma connaissance, le seul logiciel de modélisation open source qui permette de faire des MCT Merise.

Il est téléchargeable sur le site officiel.

Vous remarquerez que la version téléchargeable est indiquée pour Windows mais comme il s’agit d’un programme Java, il fonctionne aussi sous Linux.

Voici les changements à opérer pour que ça fonctionne…

Après téléchargement de « Open ModelSphere 3.2 sous Windows (fichier zip) », décompressez celui-ci dans le répertoire de votre choix, puis donnez-vous éventuellement les droits d’accès nécessaires.
Sur ma Mageia Linux 2, je l’ai installé dans /usr/share/. Vous aurez alors un répertoire « Open_ModelSphere_[version] ». J’ai renommé ce répertoire tout simplement en « modelsphere » pour éviter des problèmes avec les noms à espaces et autres points.
Dans ce répertoire, vous trouverez un fichier « modelsphere.bat » dont le contenu est le suivant :

"C:\Program Files\Java\jdk1.7.0_01\jre/bin/javaw.exe" -ms32m -mx1024m -ss16m -classpath ".\modelsphere.jar;.\resources.zip;.\resources;.\targets;.\lib\jakarta-regexp-1.5\jakarta-regexp-1.5.jar;.\lib\velocity-1.6.1\velocity-1.6.1.jar;.\lib\jazzy-core\jazzy-core.jar;.\lib\jgrapht-all\jgrapht-all.jar;.\lib\jython-2.2.1\jython.jar;.\lib\velocity-1.6.1\lib\commons-collections-3.2.1.jar;.\lib\velocity-1.6.1\lib\commons-lang-2.4.jar;.\lib\lablib-checkboxtree-3.0.2.jar;.\lib\antlr-3.3-complete.jar;.\plugins\bin\repository_functions.jar" org.modelsphere.sms.Application

Ouvrez ce fichier avec un éditeur de texte et transformez-le de cette manière :

1
2
3

#!/bin/bash
cd `dirname $0`
java -ms64m -mx1024m -ss16m -classpath ".:./modelsphere.jar:./resources.zip:./resources:./targets:./lib/jakarta-regexp-1.5/jakarta-regexp-1.5.jar:./lib/velocity-1.6.1/velocity-1.6.1.jar:./lib/jazzy-core/jazzy-core.jar:./lib/jgrapht-all/jgrapht-all.jar:./lib/jython-2.2.1/jython.jar:./lib/velocity-1.6.1/lib/commons-collections-3.2.1.jar:./lib/velocity-1.6.1/lib/commons-lang-2.4.jar:./lib/lablib-checkboxtree-3.0.2.jar:./lib/antlr-3.3-complete.jar:./plugins/bin/repository_functions.jar" org.modelsphere.sms.Application

=> Il faut ajouter le descripteur du shell et la commande pour se rendre dans le répertoire du logiciel, supprimer le chemin Windows vers le programme java et remplacer :
– les antislashes par des slashes ;
– les points virgules par des doubles-points.
Vous pouvez copier/coller directement le code ci-dessus pour la version 3.2 mais si vous installez une version ultérieure, appliquez le principe donné juste avant pour faire votre lanceur d’application.

Enregistrez-le sous « modelsphere.sh », rendez-le exécutable (chmod a+x modelsphere.sh) et servez-vous en pour démarrer Open Modelsphere.

Vous pouvez ensuite faire un raccourci vers le programme. Je l’ai placé dans le menu « Développement » de KDE en lui associant la commande suivante : /usr/share/modelsphere/./modelsphere.sh

Il faut bien sûr que Java soit installé et qu’il puisse être activé par la simple commande « java » !

PS :
– Merci à passie pour sa collaboration dans la recherche de la bonne syntaxe en 2009.
– Un site utile pour utiliser Open Modelsphere : http://www.marco-savard.com/OpenModelSphere/index_fr.html

Bonnes modélisations !

Jointure externe et condition de restriction.

CinePhil — Fri, 10 Dec 2010 13:44:17 +0000

Quand on fait une jointure externe à gauche et qu’on pose une restriction (dans le WHERE) sur la table de droite, c’est comme si on faisait une jointure interne !

Explication avec un exemple simple…

Soit les tables suivantes :
Table A
idA, valA
1, ‘toto’
2, ‘titi’
3, ‘tata’

Table B
idB, idA, valB, booleen
1, 2, ‘riri’, 0
2, 3, ‘fifi’, 1

Faisons une jointure externe à gauche sans condition :
=> Code :

1
2
3

SELECT A.idA, A.valA, B.idB, B.valB, B.booleen
FROM A
LEFT OUTER JOIN B ON B.idA = A.idA

=> Résultat :
idA, valA, idB, valB, booleen
1, ‘toto’, NULL, NULL, NULL
2, ‘titi’, 1, ‘riri’, 0
3, ‘tata’, 2, ‘fifi’, 1

Ajoutons une restriction dans le WHERE sur la table B :
=> Code :

1
2
3
4

SELECT A.idA, A.valA, B.idB, B.valB, B.booleen
FROM A
LEFT OUTER JOIN B ON B.idA = A.idA
WHERE B.booleen = 1

=> Résultat :
idA, valA, idB, valB, booleen
3, ‘tata’, 2, ‘fifi’, 1

La seule ligne qui répond à la condition est celle de fifi. On n’a plus toutes les lignes de A.
J’aurais obtenu le même résultat avec une jointure interne. Démonstration…

1ère requête sans WHERE
=> Code :

1
2
3

SELECT A.idA, A.valA, B.idB, B.valB, B.booleen
FROM A
INNER JOIN B ON B.idA = A.idA

=> Résultat :
idA, valA, idB, valB, booleen
2, ‘titi’, 1, ‘riri’, 0
3, ‘tata’, 2, ‘fifi’, 1

2ème requête avec le WHERE :
=> Code :

1
2
3
4

SELECT A.idA, A.valA, B.idB, B.valB, B.booleen
FROM A
INNER JOIN B ON B.idA = A.idA
WHERE B.booleen = 1

=> Résultat :
idA, valA, idB, valB, booleen
3, ‘tata’, 2, ‘fifi’, 1

Reprenons maintenant la jointure externe et mettons la restriction dans la clause de jointure :
=> Code :

1
2
3
4

SELECT A.idA, A.valA, B.idB, B.valB, B.booleen
FROM A
LEFT OUTER JOIN B ON B.idA = A.idA
AND B.booleen = 1

=> Résultat :
idA, valA, idB, valB, booleen
1, ‘toto’, NULL, NULL, NULL
2, ‘titi’, NULL, NULL, NULL
3, ‘tata’, 2, ‘fifi’, 1

La jointure est faite sur les données restreintes au booleen = 1, c’est à dire seulement fifi mais toutes les lignes de A sont affichées, avec NULL dans les colonnes de B quand il n’y a pas de correspondance.

Conclusion :

Avec une jointure externe, il faut déplacer les conditions de restriction sur la table externe du WHERE vers la condition de jointure. Sinon c’est l’équivalent d’une jointure interne.

Quand faut-il une table associative ?

CinePhil — Fri, 24 Feb 2012 23:16:46 +0000

Mise à jour du 11/12/2012 : Ajout des contraintes d’unicité sur le cas 01. Merci à Richard_35 pour la suggestion et le travail complémentaire.

Ceux qui connaissent le modèle conceptuel de données (MCD) de la méthode Merise savent que lorsque les cardinalités maximales d’une association sont toutes deux à n, cela entraînera la création d’une table associative dans la base de données.

Mais il y a d’autres cas et certains suscitent quelques débats au sein des forums.

Examinons tous les cas possibles…

Soit deux entités A et B et une association entre elles. Les 16 associations possibles sont les suivantes :
01) A -0,1—-associer—-0,1- B
02) A -0,1—-associer—-1,1- B
03) A -0,1—-associer—-0,n- B
04) A -0,1—-associer—-1,n- B
05) A -1,1—-associer—-0,1- B
06) A -1,1—-associer—-1,1- B
07) A -1,1—-associer—-0,n- B
08) A -1,1—-associer—-1,n- B
09) A -0,n—-associer—-0,1- B
10) A -0,n—-associer—-1,1- B
11) A -0,n—-associer—-0,n- B
12) A -0,n—-associer—-1,n- B
13) A -1,n—-associer—-0,1- B
14) A -1,n—-associer—-1,1- B
15) A -1,n—-associer—-0,n- B
16) A -1,n—-associer—-1,n- B

On remarque que les cardinalités de l’association 02 sont inversées par rapport à l’association 05, de même pour la 03 et la 09, la 04 et la 13, la 07 et la 10, la 08 et la 14, la 12 et la 15.
Il ne reste donc plus que les 10 cas suivants :
01) A -0,1—-associer—-0,1- B
02) A -0,1—-associer—-1,1- B
03) A -0,1—-associer—-0,n- B
04) A -0,1—-associer—-1,n- B
06) A -1,1—-associer—-1,1- B
07) A -1,1—-associer—-0,n- B
08) A -1,1—-associer—-1,n- B
11) A -0,n—-associer—-0,n- B
12) A -0,n—-associer—-1,n- B
16) A -1,n—-associer—-1,n- B

Commençons par les cas les plus faciles…
Comme dit en introduction, il faut une table associative lorsque les cardinalités maximales sont à n. Il s’agit ici des 3 derniers cas, 11, 12 et 16.
Lorsque que les cardinalités sont à 1,1 d’un côté d’une association, il y aura une clé étrangère dans la table issue de l’entité située du côté des cardinalités 1,1. Il s’agit ici des cas 02, 07 et 08. Le cas 06 appelle des commentaires que je ferai plus tard…

Inscrivons ces cas simples dans le tableau :
01) A -0,1—-associer—-0,1- B
02) A -0,1—-associer—-1,1- B => Clé étrangère dans la table issue de l’entité B
03) A -0,1—-associer—-0,n- B
04) A -0,1—-associer—-1,n- B
06) A -1,1—-associer—-1,1- B
07) A -1,1—-associer—-0,n- B => Clé étrangère dans la table issue de l’entité A
08) A -1,1—-associer—-1,n- B => Clé étrangère dans la table issue de l’entité A
11) A -0,n—-associer—-0,n- B => Table associative
12) A -0,n—-associer—-1,n- B => Table associative
16) A -1,n—-associer—-1,n- B => Table associative

Examinons maintenant les cas qui restent, en commençant par le 06, qui semblerait entrer dans la seconde catégorie des cas faciles…

Cas 06) A -1,1—-associer—-1,1- B
Lorsque les deux couples de cardinalités sont à 1,1, on doit se demander si on peut fusionner les deux entités. Si elles représentent des choses sémantiquement différentes ou si on les conserve pour une raison technique (ajout de table à une BDD existante, amélioration des performances par séparation de données importantes en volume mais rarement lues…), on a le choix de la table qui accueillera la clé étrangère.

Cas 04) A -0,1—-associer—-1,n- B
La clé étrangère ne peut pas aller dans B puisque un B peut être associé à plusieurs A. Mais elle ne peut pas non plus aller dans A puisque un A peut ne pas être associé à un B. Il faut donc une table associative. Et comme un A sera associé au maximum une seule fois à un B, la clé primaire de la table associative sera la clé étrangère référençant A.

Cas 03) A -0,1—-associer—-0,n- B
Aucune des deux entités n’est systématiquement associée à l’autre (cardinalités minimales à 0). Il faut donc une table associative dont la clé primaire sera, pour la même raison que dans le cas 04, la clé étrangère référençant A.

Cas 01) A -0,1—-associer—-0,1- B
Pour la même raison que dans le cas 03, il faut une table associative. Et pour la même raison que dans le cas 06, on a le choix de la clé étrangère qui sera également clé primaire, l’autre clé étrangère devant être munie d’une contrainte d’unicité.

Complétons le tableau :
01) A -0,1—-associer—-0,1- B => Table associative avec le choix de la clé primaire.

A (IdA, …) ;
B (IdB, …) ;
AB (#IdA, #IdB, …) + index unique sur #IdB
ou AB(#IdB, #IdA, …) + index unique sur #IdA.

02) A -0,1—-associer—-1,1- B => Clé étrangère dans la table issue de l’entité B

A (IdA, …) ;
B (IdB, #IdA, …).

03) A -0,1—-associer—-0,n- B => Table associative dont la clé primaire référence A

A (IdA, …) ;
B (IdB, …) ;
AB (#IdA, #IdB, …).

04) A -0,1—-associer—-1,n- B => Table associative dont la clé primaire référence A

A (IdA, …) ;
B (IdB, …) ;
AB (#IdA, #IdB, …).

06) A -1,1—-associer—-1,1- B => Fusion des deux entités ou clé étrangère dans A ou B

AB (IdAB, {attributs de A}, {attributs de B}, …).

ou :

A (IdA, #IdB, …) ;
B (IdB, …).

A (IdA, …) ;
B (IdB, #IdA, …).

07) A -1,1—-associer—-0,n- B => Clé étrangère dans la table issue de l’entité A

A (IdA, #IdB, …) ;
B (IdB, …) ;

08) A -1,1—-associer—-1,n- B => Clé étrangère dans la table issue de l’entité A

A (IdA, #IdB, …) ;
B (IdB, …) ;

11) A -0,n—-associer—-0,n- B => Table associative

A (IdA, …) ;
B (IdB, …) ;
AB (#IdA, #IdB, …).

12) A -0,n—-associer—-1,n- B => Table associative

A (IdA, …) ;
B (IdB, …) ;
AB (#IdA, #IdB, …).

16) A -1,n—-associer—-1,n- B => Table associative

A (IdA, …) ;
B (IdB, …) ;
AB (#IdA, #IdB, …).

Sur 10 cas, il y en a donc 6 qui nécessitent une table associative !

== Mise à jour du 20/09/2011 ==
Suite à une question posée par cretthie dans une discussion du forum MySQL/Requêtes, j’apporte des précisions pour les cas demandant une table associative.

01) Il y aura une clé étrangère référençant A et une autre référençant B. On a le choix de décider quelle clé étrangère constituera également, toute seule, la clé primaire de la table. L’autre colonne portant la seconde clé étrangère sera en plus munie d’une contrainte d’unicité (index de type UNIQUE chez MySQL) pour respecter la cardinalité 0,1.
03) et 04) Là aussi, la clé primaire n’est constituée que d’une seule des deux clés étrangères : celle référençant A. L’autre est une clé étrangère « ordinaire ».
11), 12) et 16) Dans ces trois cas, la clé primaire de la table associative est composée des clés étrangères référençant A et B.

Règle de gestion bien écrite => Modélisation des données facile

CinePhil — Fri, 17 Feb 2012 13:14:16 +0000

Même si vous débutez en modélisation de base de données, en écrivant correctement les règles de gestion des données, vous pourrez facilement créer votre MCD (ou votre diagramme de classes si vous préférez UML).

La méthode que je décris ci-après devrait vous aider beaucoup pour apprendre à modéliser correctement.

1) Écrire une règle de gestion
L’exercice consiste à écrire en français (ou dans la langue de votre choix) une phrase décrivant comment sont associés deux concepts.

Par exemple, on vous demande de modéliser les données nécessaires à une gestion de projets et on vous dit, entre autres, qu’il y a toujours une personne qui est nommée chef de projet pour un projet et que plusieurs personnes travaillent sur un projet.

L’extrait en italique de la phrase précédente pourrait suffire à un concepteur habitué à la modélisation des données pour produire un MCD correct et possible mais il manque des informations pour ne pas faire d’erreur :
– est-ce qu’une personne est obligatoirement chef de projet au moins une fois ?
– est-ce que toute personne enregistrée dans le système travaille sur au moins un projet ?
– est-ce qu’une personne ne peut travailler que sur un seul projet à la fois ?

Muni des réponses à ces questions, vous pouvez écrire vos règles de gestion relatives aux associations entre les personnes et les projets. Par exemple, les réponses peuvent vous amener à écrire à coup sûr ces deux règles de gestion :
1) Un projet est dirigé par une seule personne (nommée « chef de projet » pour ce projet) et une personne peut diriger plusieurs projets (en étant nommée « chef de projet » pour chacun d’eux).
2) Un projet fait travailler de une à plusieurs personnes et une personne peut travailler sur plusieurs projets.

Il faut écrire la phrase en partant d’une personne et décrire son association avec les projets (diriger) et compléter la phrase en partant cette fois du projet et décrire l’association inverse vers les personnes.

2) Le passage au MCD
Des règles de gestion écrites précédemment, il est très facile d’en déduire le MCD :
personne -0,n—-diriger—-1,1- projet
|———0,n—-travailler—-1,n—|

Comment ai-je fait ?
Examinons la première règle de gestion :
1) Un projet est dirigé par une seule personne (nommée « chef de projet » pour ce projet) et une personne peut diriger plusieurs projets (en étant nommée « chef de projet » pour chacun d’eux).

Les termes en gras représentent les entités types du MCD : personne et projet. Ce sont, dans les règles de gestion, généralement des noms communs qui font ou qui subissent une action.

Les termes soulignés représentent l’association : diriger. Ce sont généralement des verbes, le plus souvent conjugués une fois à la forme active ([peut] « diriger », ou bien « dirige ») et une fois à la forme passive (« est dirigé par »). Dans le MCD, on laissera ce verbe à l’infinitif pour pouvoir lire l’association dans les deux sens plus facilement.

Les termes en italique sont un guide pour déterminer les cardinalités de l’association :
– « est dirigé » indique une obligation, donc une cardinalité minimale de 1 ;
– « un seul » indique une cardinalité maximale de 1 ;
– « peut [diriger] » indique une possibilité, donc aussi la possibilité qu’une personne ne dirige aucun projet, soit une cardinalité minimale de 0 ;
– « plusieurs » indique une cardinalité maximale de n.

Examinez la seconde règle de gestion et vous verrez que cela fonctionne de la même manière.

Au bout de quelques exercices de formalisation de règles de gestion de la sorte, vous passerez tellement facilement à la génération du MCD que vous finirez par vous passer de l’écriture des règles de gestion et vous contenterez seulement d’y penser quand vous dessinerez directement le MCD.

3) Petit exercice
Comment modéliseriez-vous le fait qu’un projet est dirigé obligatoirement par une personne ayant le titre de chef de projet et que d’autres personnes peuvent travailler sur le projet ?

Écrivez une ou des règles de gestion possibles puis passez au MCD.

Trigger pour incrémentation relative

CinePhil — Thu, 08 Sep 2011 13:18:49 +0000

Lorsqu’on pratique l’identification relative, il est impossible d’utiliser l’AUTO_INCREMENT pour numéroter la seconde colonne de la clé primaire relativement à la première qui est une clé étrangère. Par exemple, une chaîne hôtelière pourra avoir, dans sa base de données, une table « Hotel » et une table « Chambre » identifiée relativement à « Hotel ». C’est à dire que pour chaque identifiant d’hôtel dans la table « Chambre », le numéro de la chambre repart de 1.

Je décris ci-après la numérotation automatique des chambres, tout en SQL avec MySQL mais sans doute facilement adaptable dans le langage procédural de n’importe quel autre SGBD et pour d’autres besoins tels que les lignes de commande, de facture ou de livraison ou (ce qui m’a amené à étudier ce sujet) les numéros d’exercice d’un examen.

1. Le modèle de données
MCD :
Hotel -1,n—-Avoir—-(1,1)- Chambre

Note : les parenthèses autour des cardinalités 1,1 signifient que l’entité type Chambre est identifiée relativement à Hotel.

Tables :
Hotel (htl_id, htl_nom…)
Chambre (chb_id_hotel, chb_numero…)

Note : On voit ci-dessus que l’identifiant de l’hôtel participe à la clé primaire de la chambre.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

-- Table Hotel
CREATE TABLE Hotel
(
htl_id INT NOT NULL AUTO_INCREMENT PRIMARY KEY ,
htl_nom VARCHAR( 50 ) NOT NULL ,
UNIQUE (htl_nom)
) ENGINE = InnoDB
CHARACTER SET utf8 COLLATE utf8_general_ci;

-- Table Chambre
CREATE TABLE Chambre
(
chb_id_hotel INT NOT NULL ,
chb_numero INT NOT NULL ,
PRIMARY KEY ( chb_id_hotel , chb_numero )
) ENGINE = InnoDB
CHARACTER SET utf8 COLLATE utf8_general_ci;

ALTER TABLE Chambre
ADD FOREIGN KEY ( chb_id_hotel )
REFERENCES Hotel (htl_id)
ON DELETE CASCADE ;

2. Le trigger d’incrémentation relative
Je pars du principe que le numéro de la chambre peut être saisi ou non par l’utilisateur de l’application qui va insérer les nouvelles chambres dans la table. Lorsque le numéro de chambre est laissé vide, c’est le SGBD qui doit numéroter automatiquement la chambre en fonction de l’identifiant de l’hôtel concerné, c’est à dire en affectant le plus haut numéro de chambre de cet hôtel déjà présente dans la table + 1 à la colonne chb_numero.

Commençons par insérer quelques hôtels puis quelques chambres avec leur numéro :

1
2
3
4
5

INSERT INTO Hotel (htl_nom)
VALUES ('Hôtel des flots bleus'), ('Hôtel de la gare'), ('Hôtel du parc');

INSERT INTO Chambre (chb_id_hotel, chb_numero)
VALUES (1, 1), (1, 2), (1, 3), (2, 1);

Nous avons les données suivantes dans la table Chambre :
chb_id_hotel / chb_numero
1 / 1
1 / 2
1 / 3
2 / 1

Voici maintenant le trigger :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

DELIMITER //
CREATE TRIGGER tre_chambre_numero
BEFORE INSERT ON Chambre
FOR EACH ROW
BEGIN
DECLARE num INTEGER;
IF (NEW.chb_numero IS NULL OR NEW.chb_numero = 0) THEN
SET num =
(
SELECT COALESCE(MAX(chb_numero), 0) + 1
FROM Chambre
WHERE chb_id_hotel = NEW.chb_id_hotel
);
SET NEW.chb_numero = num;
END IF;
END//

Insérons maintenant quelques chambres aux 3 hôtels sans préciser le numéro :

1 2	INSERT INTO Chambre (chb_id_hotel) VALUES (1), (2), (3), (3)

Nous avons maintenant les données suivantes dans la table Chambre :
chb_id_hotel / chb_numero
1 / 1
1 / 2
1 / 3
1 / 4 — Nouvelle chambre avec le bon numéro
2 / 1
2 / 2 — Nouvelle chambre avec le bon numéro
3 / 1 — Nouvelle chambre avec le bon numéro
3 / 2 — Nouvelle chambre avec le bon numéro

Autocompletion avec ZendX_JQuery sur une grosse liste de données issues d’une base de données

CinePhil — Fri, 01 Apr 2011 14:02:36 +0000

Il existe des tutoriels assez bien faits pour insérer dans un formulaire Zend Framework une zone de liste en autocomplétion, en utilisant le composant ZendX_JQuery_Form_Element_Autocomplete, mais ceux-ci sont basés sur une courte liste de données dans un tableau PHP.

Ce petit tutoriel vous donne la solution pour avoir la même chose mais en allant chercher parmi une grosse quantité de données issues d’une base de données.

Je base cet exemple sur la recherche parmi les 36 682 communes françaises stockées dans une base MySQL mais ça doit être assez facilement adaptable à d’autres données.
Le code fourni fonctionne avec Zend Framework 1.11.1, JQuery 1.4.4, jquery-ui-1.8.7.custom.

1) Il faut, bien entendu, que JQuery soit installé et configuré pour fonctionner avec votre projet !

– J’ai ceci dans le layout (à adapter à votre version de la bibliothèque JQuery et à son emplacement) :

1
2
3
4

$this->JQuery()->setLocalPath($this->baseUrl() . '/js/jquery/development-bundle/jquery-1.4.4.js');
$this->JQuery()->addStyleSheet($this->baseUrl() . '/js/jquery/development-bundle/themes/smoothness/jquery-ui-1.8.7.custom.css');
$this->JQuery()->setUiLocalPath($this->baseUrl() .'/js/jquery/development-bundle/ui/jquery-ui-1.8.7.custom.js');
echo $this->jQuery();

– J’ai ceci dans le bootstrap :

1
2
3
4
5
6
7
8
9

protected function _initJQuery()
{
$this->bootstrap('view');
$view = $this->getResource('view');
$view->addHelperPath('ZendX/JQuery/View/Helper/', 'ZendX_JQuery_View_Helper');
$viewRenderer = new Zend_Controller_Action_Helper_ViewRenderer();
$viewRenderer->setView($view);
Zend_Controller_Action_HelperBroker::addHelper($viewRenderer);
}

2) Passons au code utile à l’autocomplétion en commençant par le modèle et en y créant une fonction qui extrait l’identifiant et le nom des communes à partir du début du nom :

1
2
3
4
5
6
7
8
9
10
11
12

public function getCommunesParDebutNom($debut)
{
$debut = $debut.'%';
$sql = "
SELECT cmn_id, cmn_nom
FROM tr_commune_cmn
WHERE cmn_nom LIKE :debut
";
$communestrouvees = $this->_db->fetchAll($sql, array('debut' => $debut));

return $communestrouvees;
}

3) Ensuite, ajoutons d’abord le helper d’action JQuery Autocomplete dans l’initialisation du contrôleur :

1
2
3
4
5
6
7

public function init()
{
// Ajout du helper d'action JQuery autoComplete
Zend_Controller_Action_HelperBroker::addHelper(
new ZendX_JQuery_Controller_Action_Helper_AutoComplete()
);
}

4) Puis, toujours dans le contrôleur, créons une fonction qui va générer la source du champ autocomplete :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

public function recherchecommunesAction()
{
$request = $this->getRequest();
$debut = $request->getParam('term');

$commune = new Application_Model_DbTable_Commune();
$result = $commune->getCommunesParDebutNom($debut);

$listecommunes = array();

foreach($result as $cmn)
{
$listecommunes[$cmn['cmn_id']] = $cmn['cmn_nom'];
}
$this->_helper->json(array_values($listecommunes));
}

=> L’action recherchecommunes fait appel à la fonction du modèle.

5) Passons au formulaire et créons l’élément autocomplete :

1
2
3
4
5
6
7
8
9
10
11
12

$baseurl = Zend_Controller_Front::getInstance()->getBaseUrl();

// Commune
// FIXME Ne donne pour le moment que le nom de la commune et pas son identifiant
$etb_id_commune = new ZendX_JQuery_Form_Element_AutoComplete('etb_id_commune');
$etb_id_commune
->setLabel('Commune')
->setRequired(false)
->setFilters(array('StripTags'))
->setJQueryParam('autoFill', true)
->setJQueryParams(array('source' => $baseurl.'/gereretablissements/recherchecommunes')
);

=> La source de l’élément autocomplete est l’url de l’action recherchecommunes (ici dans le contrôleur gereretablissements).
=> Remarquez aussi le FIXME… il me reste à peaufiner l’utilisation de JQuery ! Ce qui m’oblige pour le moment à avoir ce traitement des données postées par l’utilisateur dans le contrôleur :

1
2
3
4
5
6

// Recherche de l'identifiant de la commune
// FIXME A revoir quand le JQuery_Autocomplete retournera directement l'id
$nom_commune = $form->getValue('etb_id_commune');
$commune = new Application_Model_DbTable_Commune();
$result = $commune->getCommuneParNom($nom_commune);
$data['etb_id_commune'] = (int)$result['cmn_id'];

6) Rien de spécial dans la vue :

echo $this->form->etb_id_commune;

Créer un projet Seam pour Tomcat 6 avec Eclipse et les JBoss Tools

CinePhil — Thu, 23 Sep 2010 09:48:11 +0000

MISE À JOUR du 20/10/2010
Les mises à jour sont indiquées par les balises [M] et [/M]

J’ai rencontré pas mal de difficultés à utiliser un truc pourtant en apparence tout bête : Créer un nouveau projet Seam configuré pour un serveur Tomcat 6 en utilisant la commande du plugin JBoss Tools pour Eclipse.
Voici le résumé des opérations à effectuer. J’en ferai un vrai tutoriel plus tard. Vos remarques et éventuelles erreurs que vous rencontreriez en suivant ces instructions me permettront d’améliorer le tutoriel car il est possible que j’oublie ici des manipulations que j’ai effectuées et pas ou mal notées.

Configuration de l’environnement de développement
Voici ce que j’ai installé :

Eclipse Galileo 3.5.2 ([M]j’ai été en échec avec la version Helios au boulot mais j’ai réussi à la maison[/M])
Plugins JBoss Tools 3.1 pour Eclipse (j’ai installé tout le paquet !)
Tomcat 6.0.29
[M]Jboos-Seam 2.2.0.GA

J’ai installé le Plugin Sysdeo Tomcat pour Eclipse au boulot mais ça m’a posé des problèmes de compatibilité avec la fonction serveur d’Eclipse qui s’est avérée plus pratique pour lancer les projets Seam. Je n’utilise plus Sysdeo.[/M]

Au fil de mes (més)aventures, j’ai vu qu’il me fallait aussi télécharger mojarra-1.2-14-FCS-binary.zip à décompresser dans le répertoire java (/usr/share/java sur ma Mandriva Linux 2010.0). [M]Finalement, ça ne semble pas utile car les jars nécessaires (jsf-api.jar et jsf-impl.jar) sont présent dans le répertoire lib de jboss-seam.[/M]

Enchaînement des opérations
Dans Eclipse, utiliser la commande de menu File / New / Seam Web Project.
Dans la fenêtre « Seam Web Project » :

Donnez un nom à votre projet ; j’utiliserai ici « projettest ».
Dans la liste « Target runtime », choisissez « Apache Tomcat v6.0″. S’il n’est pas encore configuré, vous pouvez l’ajouter à l’aide du bouton « New… ».
Dans « Dynamic web module version », j’ai laissé ce qui s’est affiché par défaut : 2.5.
Dans « Target Server », vous choisissez votre serveur Tomcat.
Dans « Configuration », choisissez « Default configuration for Apache Tomcat v6.0″. Vous verrez alors apparaître en haut de la fenêtre un message d’avertissement indiquant : « Seam facet must be enabled ». Et vous n’aurez plus accès qu’au bouton « Cancel », ce qui vous empêche de continuer à créer le projet. Pas de panique ! Cliquez sur le bouton « Modify… » en face de la liste déroulante de la configuration. Vous arrivez alors dans une fenêtre appelée « Project Facets« . Cochez « Java persistence », « JavaServer Faces » et « Seam », sauvegardez la configuration sous un nouveau nom et cliquez sur OK. Vous revenez alors sur la fenêtre « Seam Web Project » sans le message d’erreur et vous pouvez maintenant cliquer sur le bouton « Next > ».

Je n’ai rien modifié dans les fenêtres « Java » et « Web Module« , successivement affichées par le bouton « Next > ».

Sur la fenêtre « JPA Facet« , [M]choisissez la Platform « Hibernate ».
Créez une librairie (que vous pouvez appeler par exemple « Hibernate » et importez-y les fichiers hibernate*.jar + persistence-api.jar de la lib de jboss-seam, puis sélectionnez cette nouvelle librairie. [/M]
La case « Include libraries with this application » est cochée.
La Liste déroulante « Connection » correspond au choix de la connexion à la base de données. Si vous n’en avez défini encore aucune, vous pouvez la créer en cliquant sur le lien « Add connection… ». J’ai configuré une base MySQL appelée « test ».
J’ai coché la case « Add driver library to build path » et le driver « MySQL JDBC Driver » est apparu dans la liste déroulante.
Dans « Persistent class management », c’est l’option « Annotated classes must be listed in persistence.xml » qui est choisie.
L’option « Create orm.xml » est cochée [M](Ne semble pas utile)[/m].
Cliquez sur le bouton « Next > ».

Dans la fenêtre « JSF Capabalities« , [M]choisissez le type « User library ». Créez une librairie appelée par exemple seam-jsf et importez-y les fichiers jsf-api.jar et jsf-impl.jar puis sélectionnez cette librairie.
L’option « Include libraries with this application » est cochée. Sous Eclipse Helios, il y a un message d’alerte en haut de la fenêtre indiquant qu’il peut y avoir une incompatibilité avec le facet choisi.[M]
J’ai laissé les zones de saisie tel qu’elles ont été remplies par Eclipse.
Cliquez sur le bouton « Next > ».

Dans la fenêtre « Seam Facet« , choisissez le Seam Runtime « JBoss-seam-2.2.0.GA » ou ajoutez-le s’il n’est pas déjà dans la liste. Choisissez l’option de déploiement « WAR ». Pour la configuration de la Database, j’ai choisi « MySQL5 (InnoDB ) » et j’ai coché l’option « DB Tables already exists in database » puisque j’ai créé une table dans la BDD de test. J’ai coché l’option « Create test Project » mais cela ne semble pas obligatoire. Je crois d’ailleurs de mémoire qu’il faut aussi installer le plugin TestNG pour utiliser le projet de test mais je n’en suis pas encore à tester mon projet ! J’y reviendrai en temps utile.

Voilà ! On peut cliquer sur le bouton « Finish » et laisser Eclipse créer le projet tout seul !

Jusque là, rien de compliqué, à part la subtilité concernant la configuration par défaut pour Apache à laquelle il manque des facets. Sauf que si vous essayez de démarrer Tomcat et d’accéder sur un navigateur à la page d’accueil de votre projet, ça ne fonctionnera pas !

On va commencer par ajouter dans le répertoire projettest/WebContent/WEB-INF/lib un paquet de jar pour éviter plus tard une floppée de messages d’erreur indiquant que des classes ne sont pas trouvées. [M]J’ai essayé de créer une librairie en y mettant tous les jar de la lib de jboss-seam mais j’ai eu des messages d’erreur lors de la création du projet indiquant qu’il y avait plusieurs versions d’une classe.[/M] Ces jar sont disponibles dans le répertoire lib de jboss-seam. S’il vous en manque, vous pourrez les télécharger en cherchant sur Internet. Copiez les fichiers jars suivant et collez-les, directement à l’aide de « paste » du menu contextuel d’Eclipse, dans le répertoire du projet indiqué plus haut. Voici la liste des jars nécessaires pour éviter les messages d’erreur à rallonge de Java :

antlr.jar
commons-collections.jar
commons-loggin.jar
dom4j.jar
hibernate-annotations.jar
hibernate-commons-annotations.jar
hibernate-core.jar
hibernate-entitymanager.jar
hibernate-validator.jar
javassist.jar
jsf-impl.jar
jsf-api.jar
jta.jar
log4j.jar
lucene-core.jar
persistence-api.jar
slf4j-api.jar
slf4j-log4j12.jar

Créer un fichier « context.xml » dans projettest/WebContent/META-INF. Y insérer le code suivant :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17

debug="5"
docBase="projettest"
path="/projettest"
reloadable="true">
driverClassName="com.mysql.jdbc.Driver"
maxActive="20"
maxIdle="10"
maxWait="-1"
name="jdbc/projettestDatasource"
type="javax.sql.DataSource"
url="jdbc:mysql://localhost:3306/test"
username="votre_utilisateur_mysql"
password="celui_du_username" />

Copier le tag « Ressource » ci-dessus dans (répertoire Tomcat)/conf/Catalina/localhost/projettest.xml, à l’intérieur du tag « Context ». Le fichier projettest.xml doit ressembler à ceci :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

reloadable="true"
docBase="/home/plemenager/workspace/projettest/WebContent"
workDir="/home/plemenager/workspace/projettest/work" >
verbosity="4"
timestamp="true"/>
driverClassName="com.mysql.jdbc.Driver"
maxActive="20"
maxIdle="10"
maxWait="-1"
name="jdbc/projettestDatasource"
type="javax.sql.DataSource"
url="jdbc:mysql://localhost:3306/test"
username="votre_utilisateur_mysql"
password="celui_du_username" />

Ouvrir le fichier /projettest/src/META-INF/persistence.xml. Dans le tag « persistence-unit », y ajouter le code nécessaire pour que le fichier complet ressemble à ceci :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

xmlns="http://java.sun.com/xml/ns/persistence"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/persistence http://java.sun.com/xml/ns/persistence/persistence_1_0.xsd"
>

org.hibernate.ejb.HibernatePersistence

java:comp/env/jdbc/projettestDatasource

Ouvrez le fichier projettest/WebContent/components.xml. Supprimez les paramètres debug et jndi-pattern du tag « core:init » qui ne doit donc plus en contenir.
[M]Ajouter :

1
2
3

xmlns:transaction="http://jboss.com/products/seam/transaction"
http://jboss.com/products/seam/transaction http://jboss.com/products/seam/transaction-2.2.xsd

Le début du fichier doit ressembler à ça :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30

xmlns:core="http://jboss.com/products/seam/core"
xmlns:persistence="http://jboss.com/products/seam/persistence"
xmlns:drools="http://jboss.com/products/seam/drools"
xmlns:bpm="http://jboss.com/products/seam/bpm"
xmlns:security="http://jboss.com/products/seam/security"
xmlns:mail="http://jboss.com/products/seam/mail"
xmlns:web="http://jboss.com/products/seam/web"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:transaction="http://jboss.com/products/seam/transaction"
xsi:schemaLocation=
"http://jboss.com/products/seam/core http://jboss.com/products/seam/core-2.2.xsd
http://jboss.com/products/seam/persistence http://jboss.com/products/seam/persistence-2.2.xsd
http://jboss.com/products/seam/drools http://jboss.com/products/seam/drools-2.2.xsd
http://jboss.com/products/seam/bpm http://jboss.com/products/seam/bpm-2.2.xsd
http://jboss.com/products/seam/security http://jboss.com/products/seam/security-2.2.xsd
http://jboss.com/products/seam/mail http://jboss.com/products/seam/mail-2.2.xsd
http://jboss.com/products/seam/web http://jboss.com/products/seam/web-2.2.xsd
http://jboss.com/products/seam/components http://jboss.com/products/seam/components-2.2.xsd
http://jboss.com/products/seam/transaction http://jboss.com/products/seam/transaction-2.2.xsd">

conversation-timeout="120000"
conversation-id-parameter="cid"
parent-conversation-id-parameter="pid"/>

[/M]

Ouvrez le fichier projettest/WebContent/WEB-INF/pages.xml. Commentez le dernier tag « exception » tel que ci-dessous :

1
2
3
4
5

[M]Ouvrir le fichier projettest/WebContent/WEB-INF/web.xml et cliquer sur l’onglet Source.
Commenter la partie :

1
2
3

com.sun.faces.config.ConfigureListener

Copier le fichier jboss-seam-2.2.0.GA/examples/jpa/resources-tomcat/WEB-INF/classes/logj4.xml dans projettest/WebContent/WEB-INF/classes/
[/M]

Si vous avez correctement fait tout cela, et si je n’ai rien oublié, vous pouvez maintenant démarrer Tomcat. Le seul problème restant à résoudre est un couple de WARN concernant log4j.

Allez dans votre navigateur préféré et lancez votre application, via le Tomcat Manager ou par une URL du type http://localhost:8080/projettest. Vous devriez alors voir apparaître un superbe : « Welcome to Seam!«