blog.bressure.net

Le gestionnaire de source installé et paramétré, il est maintenant possible d’y importer la première mouture de l’arborescence du projet. Il s’agit de l’étape sine-qua-none d’un développement distribué et multi-utilisateur. Comme nous utilisons un gestionnaire de source gérant le renommage et le déplacement de fichier, il n’est pas nécessaire d’avoir la structure de répertoire définitive. Il suffit d’ajouter au repository une structure fonctionnel c’est-à-dire qui compile au moins et nous pourrons toujours la modifier par la suite.

Nous adoptons l’arborescence de projet définie par Maven 2 et l »DE utilisé Netbeans, va nous simplifier la tâche en nous apportant une intégration poussée avec Maven. Pour cela aller dans le menu Tools > plugin puis l’onglet Available Plugins. Sélectionner Maven puis cliquer sur Installer.

Le plugin maven permet d’ajouter dans Netbeans des menus pour lancer des goals maven et une intégration poussée des concepts de Maven dans les fenêtres d’éditions.

La création d’un projet Maven dans Netbeans est alors très simplifiée. Aller dans le menu File > New Project puis choisir la catégorie Maven et le type Maven Project. Cela donne accès à une liste d’archetype c’est-à-dire de modèle de projet Maven. Il en existe de trés nombreux et le chargement de cette liste est un peu long  la première fois qu’on l’utilise (En effet sont contenu est rapatrié depuis internet). Pour les besoins de l’article nous allons simplement choisir Maven Quickstart Archetype. Il permet de créer un projet qui génère un jar. Il en existe de beaucoup plus complexe et Maven nous  permet d’en créer nous même afin de répondre à tous les besoins. Le dernier écran permet de renseigner les informations primordiales du nouveau projet: nom, paquet, version.

La création du projet va prendre quelque seconde la première fois que vous utilisez cette fonction. En effet le principe de maven est de ne pas inclure les dépendances d’un projet. L’éxecution de l’archétype pour le création d’un projet est un cas particulier de build maven. Les dépendances sont donc téléchargées depuis le repository central de Maven. Ce téléchargement n’interviendra qu’une seule fois et les dépendances seront conservées dans le repository maven 2 du plugin Netbeans i.e. quelque part dans les fichiers internes de Netbeans.

Voici un exemple de log d’éxecution quand il n’est pas nécessaire de résoudre par internet les dépendances manquantes:

Scanning for projects…
project-execute
Setting property: classpath.resource.loader.class => ‘org.codehaus.plexus.velocity.ContextClassLoaderResourceLoader’.
Setting property: velocimacro.messages.on => ‘false’.
Setting property: resource.loader => ‘classpath’.
Setting property: resource.manager.logwhenfound => ‘false’.
**************************************************************
Starting Jakarta Velocity v1.4
RuntimeInstance initializing.
Default Properties File: org/apache/velocity/runtime/defaults/velocity.properties
Default ResourceManager initializing. (class org.apache.velocity.runtime.resource.ResourceManagerImpl)
Resource Loader Instantiated: org.codehaus.plexus.velocity.ContextClassLoaderResourceLoader
ClasspathResourceLoader : initialization starting.
ClasspathResourceLoader : initialization complete.
ResourceCache : initialized. (class org.apache.velocity.runtime.resource.ResourceCacheImpl)
Default ResourceManager initialization complete.
Loaded System Directive: org.apache.velocity.runtime.directive.Literal
Loaded System Directive: org.apache.velocity.runtime.directive.Macro
Loaded System Directive: org.apache.velocity.runtime.directive.Parse
Loaded System Directive: org.apache.velocity.runtime.directive.Include
Loaded System Directive: org.apache.velocity.runtime.directive.Foreach
Created: 20 parsers.
Velocimacro : initialization starting.
Velocimacro : adding VMs from VM library template : VM_global_library.vm
[ERROR]ResourceManager : unable to find resource ‘VM_global_library.vm’ in any resource loader.
Velocimacro : error using  VM library template VM_global_library.vm : org.apache.velocity.exception.ResourceNotFoundException: Unable to find resource ‘VM_global_library.vm’
Velocimacro :  VM library template macro registration complete.
Velocimacro : allowInline = true : VMs can be defined inline in templates
Velocimacro : allowInlineToOverride = false : VMs defined inline may NOT replace previous VM definitions
Velocimacro : allowInlineLocal = false : VMs defined inline will be  global in scope if allowed.
Velocimacro : initialization complete.
Velocity successfully started.
[archetype:create]
—————————————————————————-
Using following parameters for creating Archetype: maven-archetype-quickstart:1.0
—————————————————————————-
Parameter: groupId, Value: net.bressure
Parameter: packageName, Value: net.bressure.vroom
Parameter: package, Value: net.bressure.vroom
Parameter: artifactId, Value: vroom
Parameter: basedir, Value: /home/thierry/NetBeansProjects
Parameter: version, Value: 1.0-SNAPSHOT
********************* End of debug info from resources from generated POM ***********************
Archetype created in dir: /home/thierry/NetBeansProjects/vroom
————————————————————————
BUILD SUCCESSFUL
————————————————————————
Total time: < 1 second
Finished at: Mon Oct 06 12:50:15 CEST 2008
Final Memory: 66M/69M
————————————————————————

Le projet qui vien d’être créé est compilable et comporte déjà les prémices de l’atelier de développement Java agile. Le build du projet passe par une phase d’éxécution des tests unitaires. Voici un exemple de sortie en faisant un clic-droit sur le projet et sélectionnant build :

Scanning for projects…
project-execute
[#process-resources]
[resources:resources]
Using default encoding to copy filtered resources.
[#compile]
[compiler:compile]
Nothing to compile – all classes are up to date
[#process-test-resources]
[resources:testResources]
Using default encoding to copy filtered resources.
[#test-compile]
[compiler:testCompile]
Nothing to compile – all classes are up to date
[#test]
[surefire:test]
Surefire report directory: /home/thierry/NetBeansProjects/vroom/target/surefire-reports
——————————————————-
T E S T S
——————————————————-
Running net.bressure.vroom.AppTest
Results :
[#package]
[jar:jar]
[#install]
[install:install]
Installing /home/thierry/NetBeansProjects/vroom/target/vroom-1.0-SNAPSHOT.jar to /home/thierry/.m2/repository/net/bressure/vroom/1.0-SNAPSHOT/vroom-1.0-SNAPSHOT.jar
————————————————————————
BUILD SUCCESSFUL
————————————————————————
Total time: 1 second
Finished at: Mon Oct 06 16:23:49 CEST 2008
Final Memory: 18M/56M
————————————————————————

Un projet qui build est un projet qui doit être partagé. Nous allons importer dans le repository l’arborescence du projet. Pour ce faire Netbeans s’interface avec Subversion à merveille. Sur le projet utiliser un clic droit > Versionning > Import to Subversion Repository pour accéder à la fenêtre de dialogue pour choisir l’emplacement sur le serveur subversion.

L’url à renseignée est de la forme svn://<serveur>/<projet>/trunk et dans le cas de l’article cela donne svn://localhost/vroom/trunk

Dans la boite de dialogue suivante supprimer le dernier répertoire pour ne garder que <projet>/trunk

Le trunk final est important car cela respecte l’arborescence classique des projets sous Subversion. Le trunk est l’équivalent de la HEAD sous CVS.

Nous avons créé un projet maven 2 en utilisant un archétype. Le projet est disponible dans le référentiel de source Subversion. La prochaine étape va être la mise en place de l’intégration continue.