Présentation d'une demi journée de Maven en Master à Paris VI

1. Apache Maven Initiation Paris VI - Master STL-TA Jeudi 23 Octobre 2008

2. Arnaud Héritier OCTO Technology Expert sénior aheritier AT octo DOT com http://www.octo.com Maven Committer depuis 2004 Membre du PMC (Project Management Committee) depuis 2005 aheritier AT apache DOT org http://maven.apache.org DESS GLA (ex Master STL-TA) Promotion 1999 2

3. http://tinyurl.com/6r5v8p http://tinyurl.com/5uv6lg 3 Bibliographie

4. Licence Creative Commons Contrat Paternité Pas d'Utilisation Commerciale Partage des Conditions Initiales à l'Identique 2.0 France http://creativecommons.org/licenses/by-nc-sa/2.0/fr/ 4

5. Aujourd’hui Pourquoi Maven ? Maven, les concepts Maven, sa place dans l’entreprise Comment faire échouer son projet avec Maven ? Démonstration 5

6. Pourquoi Maven ? Apache Maven 6

7. Construction d’un war en 2002 Construire un war Utilisation d’Eclipse limitée En ces temps reculés où WTP n’existait pas (uniquement dans la version payante d’IBM), eclipse ne permettait pas d’exporter des Wars Gestion manuelle Modifier les fichiers de paramétrage Exporter les différents jar Copier les dépendances (et nos jars), dans un répertoire lib Faire un zip que l’on renomme en war Tagguer l’ensemble des sources dans le répertoire de sources (CVS) Envoi du fichier par FTP sur le serveur d’intégration Se connecter à la console d’administration du serveur et déployer l’application

8. Construction d’un war en 2002 Combien de temps ça prend ? Quand tout va bien : 15 minutes Quand il y a des problèmes : ½ journée Un seul problème, Y’a toujours des problèmes Erreur dans la configuration Oublie d’une dépendance Oublie d’un fichier Correction de dernière minute qui introduit une régression… Autres

9. Une première réponse : ANT Ecriture d’un script Permet d’automatiser le processus Durée réduite du processus réduite de moitié Le processus ne monopolise personne On le lance et on passe à autre chose

10. Les limites de ANT Ecrire le script, c’est long Modifier un script, c’est très long Au final, le gains de temps n’est pas évident Mais c’est quand même plus amusant Il est possible de réutiliser le script !

11. La réutilisation de scripts ANT Les scripts ne sont pas directement réutilisables Structure de projets différents Besoins différents Encore du temps perdu Modification du script Réécriture pour le rendre plus générique  Un nouveau métier s’est créé : scripteur ANT

12. Quelques exemples http://anonsvn.jboss.org/repos/seam/branches/community/Seam_2_0 http://junit.cvs.sourceforge.net/viewvc/junit/junit/build.xml?view=markup http://findbugs.googlecode.com/svn/trunk/findbugs/build.xml

13. Les CONCEPTS Apache Maven 13

14. L’arrivée de Maven Convention Over Configuration On ne script plus, on décrit son projet (POM) Architecture extensible Des plugins réutilisables évitent la multiplication des scripts de build Gestion des librairies du projet (versions, partage, ..) Référentiels de librairies Dépendances déclaratives Dépendances transitives Amélioration de la qualité des livrables Contrôles Rapports

15. Les conventions 1 projet Maven = 1 artéfact (pom, jar, war, ear, …) 1 organisation des répertoires prédéfinie 1 descripteur standardisé Des cycles de construction standardisés 15

16. Le POM Un fichier XML (pom.xml) Décrivant : Identification du projet Version du projet Description du projet Liste des développeurs Dépendances … <?xml version="1.0" encoding="UTF-8"?> <project> <modelVersion>4.0.0</modelVersion> <groupId>com.octo</groupId> <artifactId>webapp-sample</artifactId> <version>1.1-SNAPSHOT</version> <packaging>war</packaging> <name>Simple webapp</name> <inceptionYear>2007</inceptionYear> <dependencies> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-struts</artifactId> <version>2.0.2</version> </dependency> … </dependencies> </project> 16

17. Cycle de vie et plugins 17

18. Les référentiels de d’artéfacts Par défaut : Un central http://repo1.maven.org/maven2 Propose plusieurs dizaines de Go de librairies OSS. Un local ${user.home}/.m2/repository Centralise tous les artéfacts utilisés et créés par vos projets 18

19. Sans Maven Avec Maven 19 Les dépendances

20. Les dépendances Déclaratives groupId + artifactId + version (+ classifier) Transitives Lib A  Lib B Lib B  Lib C Alors Lib A  Lib C Scopes d’utilisation Runtime : Taglibs Provided : API Servlet, Driver SGBD, … Compile : par défaut Test : Junit, DBUnit… System : non recommandé 20

21. Le reactor Construit un projet et tous ces modules en résolvant l’ordre de leurs dépendances Projet 1 Module A (dépend de B) Module B Module C (dépend de A)  Construira B puis A puis C pom.xml de projet 1 <modules> <module>moduleA</module> <module>moduleC</module> <module>moduleB</module> </modules> 21

22. L’héritage Factorisation de paramètres entre projets/modules L’organisation des sous modules et de l’héritage doit être technique (ejbs, wars, jars) et non pas fonctionnel (serviceA, serviceB, …) Projet1 Jars Jar1 Jar2 Wars War1 … pom.xml de module Jar1 <parent> <groupId>X.Y.Z</groupId> <artifactId>jars</artifactId> <version>1.0-SNAPSHOT</version> </parent> 22

23. L’héritage naturel Lorsque le parent sert aussi de reactor A condition que nom du module = son artifactId Evite la re-définition de certains éléments du pom : Url du site Déploiement du site Informations SCMs 23

24. Site / Documentation Génération d’un site documentaire à partir de documents dans différents formats : Xdocs (xml) Apt (wiki) Docbook …. Génération de rapports sur le projet Descriptif Informations sur les dépendances Documentation automatique des plugins maven Javadoc Xref 24

25. Site / Documentation 25

26. Reporting / Contrôle qualité Reporting - Réactif Je corrige les problèmes une fois étudié le rapport Les problèmes sont dans le gestionnaire de versions Contrôle - Pro-actif Le build échoue si mon code ne respecte pas certaines règles Les problèmes ne sont pas dans le gestionnaire de versions puisque je ne commit jamais un code qui ne build pas Types de contrôles / reporting Résultat de l’exécution des tests : surefire Couverture de tests : clover, cobertura Qualité du code : findbugs Conformité aux standards : checkstyle Patterns / Antipatterns : pmd 26

27. Reporting / Contrôle qualité 27

28. Et encore . . . Profiles Properties Assemblies Archetypes 28

29. Sa place dans l’entreprise Apache Maven 29

30. Référentiels de librairies 30 © OCTO Technology 2008

31. L’intégration continue

32. L’intégration continue – Multi-projets 32

33. Le processus de release 33

34. Comment faire échouer son projet avec Maven ? Apache Maven 34

35. 10 bonnes pratiques pour faire échouer son projet Ne pas utiliser les conventions Mettre tout ce qui est possible de mettre dans le pom Se rendre dépendant de l’environnement Multiplier les niveauxd’héritage Utiliser systématiquement "-Dmaven.test.skip=true » Faire les releases à la main S’échanger les jars par mail Utilisation massive du plugin antrun Essayer de définir les dépendances pour les autres 35

36. 10. Passer son temps dans la console

37. Démonstration Apache Maven 37

38. Initialiser un projet From scratch A l’ancienne Avec m2eclipse Depuis un modèle (archetype) En ligne de commande Avec m2eclipse 38

39. Gérer les dépendances Recherche de dépendances Mvnrepository.com m2eclipse Dépendances simples Dépendances avancées Ranges Scopes Excludes Analyse des dépendances dependency:tree dependency:analyze 39

40. Multi-modules Ajout de modules Dépendances entre modules Le reactor Son rôle Le plugin du même nom 40

41. Héritage Héritage entre modules Mise en place d’un dependencyManagement 41

42. Plugins Configuration des plugins PluginsManagement 42

43. Documentation & Reporting Différents formats pour la documentation : Xdoc, APT Configuration des rapports Descripteur de site 43

44. Questions ? Merci pour votre attention 44