Java Serveur App 1 : création du projet Maven et exécution via Eclipse

Création du projet et 1ère exécution

Pré-requis

Cette étape nécessite une installation d"Eclipse et de Maven fonctionnelle telle que décrite ici.

Création du projet Maven

Nous allons maintenant créer un projet Maven en utilisant l'archétype  maven-archetype-webapp.

Un archetype est un modèle de projet courant. En utilisant un archetype, Maven génère automatiquement un projet incluent le fichier pom.xml (Project Object Model) ainsi que la hiérarchie de dossiers et de fichiers.

Allez dans File > New > Other ... et sélectionner Maven Project dans le dossier Maven

Ensuite, continuez jusqu'à l'écran permettant de choisir l'archétype et sélectionnez maven-archetype-webapp. 

Ensuite vous devrez choisir un nom d'artefact qui sera également le nom du projet dans Eclipse:

À ce stade, vous devriez avoir un projet ressemblant à ceci:

Inclusion du serveur Jetty
Jetty est un serveur applicatif Java écrit en Java. L'existence d'un plugin Jetty pour maven va nous permettre de simplement indiquer la dépendance de notre projet à Jetty. Eclipse/Maven va s'occuper de télécharger les fichiers nécessaires.

Dans votre fichier pom.xml, à l'intérieur de la balise XML Jetty appelée dependencies, ajouter l'entrée suivante:

<dependency>
 <groupId>org.mortbay.jetty</groupId>
 <artifactId>jetty</artifactId>
 <version>6.1.26</version>
</dependency>

Il faut également configurer le plugin permettant l'exécution du serveur. Dans la balise XML build de votre pom.xml, ajoutez : 

<plugins>
  <plugin>
    <groupId>org.mortbay.jetty</groupId>
    <artifactId>maven-jetty-plugin</artifactId>
    <version>6.1.26</version>
    <configuration>
      <scanIntervalSeconds>1</scanIntervalSeconds>
      <connectors>
        <connector implementation="org.mortbay.jetty.nio.SelectChannelConnector">
          <port>7070</port>
        </connector>
      </connectors>
      <webAppConfig>
        <contextPath>/</contextPath>
      </webAppConfig>
    </configuration>
  </plugin>
</plugins>

Maven va télécharger Jetty. Grâce au plugin Maven pour Eclipse, Eclipse connaîtra automatiquement l'existence de Jetty. Quelques explications sur la configuration:

• Une fois lancé, ce serveur sera disponible à l'URL http://localhost:7070/.
• Il suffit de changer 7070 par un autre port si nécessaire.
• Si le contextPath était "/test/", l'URL serait http://localhost:7070/test/
• La balise scanIntervalSeconds le temps attendu par le serveur pour vérifier les sources et redémarrer  automatiquement si des modifications ont eu lieu. Indiquez 0 si vous ne voulez pas que le serveur se redéploie automatiquement.

Exécution du serveur

Méthode 1: l'exécution du serveur va se faire à travers maven en ligne de commande à partir du répertoire contenant le fichier pom.xml:

mvn jetty:run

Votre serveur est alors accessible avec n'importe quel navigateur à l'URL http://localhost:7070/.

Méthode 2: un des gros avantages du plugin maven pour Eclipse est de pouvoir lancer le serveur à partir d'Eclipse et donc de pouvoir utiliser le débogueur d'Eclipse sur le serveur.

Tout d'abord, entrez dans le menu des configurations d'exécution:

Commencez par créer une nouvelle configuration d'exécution Maven:

1. Sélectionner Maven Build dans la liste.
2. Cliquer sur l'icône de création d'une nouvelle configuration.

Ensuite, il faut:

1. Cliquer sur Browse Workspace va vous permettre de sélectionner le projet que vous venez de créer.
2. Une fois sélectionné, vous devriez voir apparaître un ${workspace ...} correspondant au nom de votre projet.
3. Ensuite vous devrez entrer le but à transmettre à Maven, pour nous, ce sera "jetty:run". (notre exécution est alors l'équivalent de la commande "mvn jetty:run").
4. Vous pouvez également changer le nom de cette configuration d'exécution.

Partir votre serveur

Dans le menu d'exécution à côté de la flèche verte, vous trouverez votre exécution. Il suffit de cliquer dessus.

Votre serveur est maintenant démarré, il faut alors ouvrir un navigateur et entrer l'URL:

http://localhost:7070/

Vous verrez alors le contenu du fichier index.jsp s'afficher: "Hello World". Vous pouvez modifier le contenu du fichier index.jsp, recharger la page dans le navigateur et voir l'effet des modifications.

Arrêter votre serveur

Pour arrêter votre serveur, simplement cliquez sur le bouton rouge accessible depuis la console:

Jusqu'ici, vous avez mis en place un serveur applicatif Java ... sans Java avec une page unique.

Récapitulatif

Dans cette étape, vous avez:

• Créer un projet Maven utilisable dans Eclipse.
• Ajouter un serveur Java permettant l'exécution de l'application via la gestion des dépendances de Maven.
• Démarrer et arrêter votre serveur depuis Eclipse.
• Vous n'avez pas écrit de code Java.

Le résultat final devrait ressembler à ce que vous trouverez dans le workspace contenu ici.