LG

Les projets dynamiques nécessitent d'avoir Tomcat installé.

Faire File|New|Dynamic Web Project.

Il est alors nécessaire de configurer la version de Tomcat à utiliser, de préférence utiliser la dernière version disponible.

Sélectionnez la Target runtime ou créez en une via New Runtime….

Sélectionnez Next puis Next et cochez si nécessaire Generate web.xml deployment descriptor avant la création du projet. Normalement, le fichier web.xml devient facultatif avec les annotations depuis Java 1.5 mais il peut être préférable de le générer au cas où, quitte à le laisser vide.

Dans le menu Project|Properties, allez dans l'onglet Project Facets et cochez JavaServer Faces dans sa dernière version. Puis cliquez sur Further configuration required en bas de la fenêtre. Il est indiqué qu'il y a besoin d'une JSF Implementation Library. Cliquez simplement sur l’icône Download library… et cochez la dernière version de Mojarra. Veillez bien à laisser cocher la case Configure JSF servlet in deployment descriptor.

Dans le menu Project|Properties, allez dans l'onglet Project Facets et cochez JAX-RS (REST Web Services) dans sa dernière version.

Puis cliquez sur Further configuration required en bas de la fenêtre. Il est indiqué qu'il y a besoin d'une User Library. Cliquez simplement sur l’icône Manage libraries….

Ajoutez une nouvelle librairie ainsi que le jar javax.ws.rs-api.jar et validez. Cette librairie se trouve dans Jersey 2.25, Archive

Veillez bien cocher (si nécessaire) la case Update Deployment Descriptor qui va mettre à jour le fichier web.xml.

Avant de valider la migration, vérifier que le bon Runtime (serveur Tomcat) est sélectionné.

Ensuite ajouter toutes les librairies de Jersey, celles du dossier lib, ext et api dans le Classpath de Tomcat. Avec le …-api.jar, Java a tout ce qu'il faut pour compiler les .class. Mais c'est Tomcat qui devra exécuter le tout. Il n'est pas nécessaire de les dans le buildpath au projet mais il faut mettre les librairies dans le dossier WebContent/lib.

Pour mémoire :

Méthode EclipseLink

Commencer par créer un projet Java ou Dynamic Web Project en fonction des besoins. Puis éditez les propriétés du projet Project|Properties et ajoutez la fonction JPA dans l'onglet Project Facets. Sélectionnez ensuite l'implémentation de JPA : EclipseLink ou Generic et téléchargez-le.

Ajoutez la connexion via Add connection… en choisissant le type de base de donnée (MySQL, Oracle, …) et enfin le driver. Dans la fenêtre New Driver Definition, prenez le driver. Dans ce cas, Eclipse ne permet pas un téléchargement automatique. Téléchargez alors le fichier jar demandé, mysql-connector-java-5.1.0-bin.jar et DBCP par exemple, dans le dossier lib (ou WebContent/WEB-INF/lib), éditez-le via l'onglet JAR List et complétez les données de connexion (URL, utilisateur et mot de passe). Dans la fenêtre principale, cochez Add driver library to build path ainsi que Override default schema from connection. Enfin, sélectionnez le runtime.

À ce stade, le fichier persistence.xml est vide et doit être rempli soit manuellement, soit via l'IHM d'Eclipse.

Méthode Hibernate

Si vous préférez utiliser Hibernate :

• - Téléchargez le plugin pour Eclipse et redémarrez Eclipse,
• - Dans l'étape précédente, lors de la configuration de JPA, sélectionnez Hibernate,
• - Il n'est pas possible de télécharger automatiquement Hibernate. Téléchargez Hibernate manuellement et copiez le contenu du dossier lib/required (à l'exception éventuelle de el-api-2.2.jar qui est peut-être déjà ajouté dans le build path avec Tomcat) dans le dossier WebContent/WEB-INF/lib/hibernate (actualisez ci-nécessaire l'arborescence pour qu'Eclipse détecte le changement).

Commencez par créer le projet File|New|Maven Project, passez la première page Next et sélectionnez l'Artifact maven-archetype-webapp. Choisissez un Group Id : com.llgc et un Artifact Id : le nom du projet puis validez.

Activez les JavaServer Faces en version 1.1 avec l'installation de la librairie nécessaire (voir paragraphe précédent). Maven par défaut ne supporte pas une version supérieure.

Allez dans le fichier pom.xml, ajoutez la structure suivante dans la balise <build> puis validez par un Maven|Update Project….

<plugins>
  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-compiler-plugin</artifactId>
    <version>3.1</version>
    <configuration>
      <source>1.8</source>
      <target>1.8</target>
    </configuration>
  </plugin>
</plugins>

Ensuite, modifier l'entête du fichier web.xml de

<!DOCTYPE web-app PUBLIC
 "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"
 "http://java.sun.com/dtd/web-app_2_3.dtd" >
<web-app>

en

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xmlns="http://xmlns.jcp.org/xml/ns/javaee"
  xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
  version="3.1">

puis faire un Maven|Update Project….

Fermez ensuite le projet et éditez le fichier .settings\org.eclipse.wst.common.project.facet.core.xml en remplaçant les lignes <installed facet=“jst.web” version=“2.3”/> par <installed facet=“jst.web” version=“3.1”/> et <installed facet=“jst.jsf” version=“1.1”/> par <installed facet=“jst.jsf” version=“2.2”/>. Rouvrez le projet et laisser Maven faire la mise à jour automatiquement.

Créez un serveur en faisant File|New|Other et sélectionnez Server puis suivez les instructions du paragraphe Création d'un Dynamic Web Project avec un serveur Tomcat v8.0.

Allez dans le menu Project|Properties et l'onglet Project Facets. Déselectionnez JavaServer Faces et appliquez puis resélectionnez et ensuite téléchargez la librairie en version 2.2 puis revalidez encore. Et enfin, sélectionnez le runtime nouvellement créé Tomcat v8.0.

Si besoin, ajouter la dépendance à JSTL dans pom.xml :

<dependency>
  <groupId>jstl</groupId>
  <artifactId>jstl</artifactId>
  <version>1.2</version>
</dependency>

Il suffit d'installer Spring Tool Suite (STS) for Eclipse depuis Eclipse Marketplace. Selon Spring Source, Archive, c'est ce qu'il y a de plus complet.

Il peut être aussi nécessaire d'installer avec http://dist.springsource.org/snapshot/GRECLIPSE/e4.6 si vous rencontrez lors d'une mise à jour ultérieure le message suivant : Searching alternate solutions…“: org.codehaus.groovy.eclipse 2.9.2.xx-201608111527-e45 is unknown in the solver!. Buildship Gradle Integration _ Eclipse Plugins, Bundles and Products - Eclipse Marketplace

Ensuite, pour créer un projet Spring, c'est très certainement la variante Spring Legacy Project que vous voulez.

Il reste ensuite à télécharger la libraire Spring et installer au minimum les jar suivants (pour l'utilisation des Beans) : spring-beans, spring-context, spring-core et spring-expression. La librairie Apache Logging, Archive est également nécessaire.

Pour utiliser les aspects, il ne faut surtout pas configurer son projet en AspectJ mais mettre les librairies aspectrt.jar et aspectjweaver.jar dans le Build Path ainsi que la libraire spring-aop. Si le projet est configuré est AspectJ, le compilateur aj va faire tout le travail et le fichier Beans.xml ne servira à rien.

L'installation efficace d'une librairie nécessite d'avoir son fichier .jar ainsi que sa documentation au format javadoc. Ces deux fichiers seront à copier dans le dossier lib de chaque projet (ou WebContent/WEB-INF/lib dans le cas d'un projet Dynamic Web Project). Si cette opération est effectuée alors que le projet est ouvert sous Eclispe, bien penser à faire un Rafraîchir via le menu contextuel sur l'arborescence du projet.

Puis sélectionnez le projet, allez dans Project|Properties puis Java Build Path|Libraries et ajoutez la librairie, sans son fichier javadoc, via le bouton Add JARs… et surtout pas Add External JARs…. Maintenant que la librairie a été ajoutée, il faut la développer, sélectionner la ligne Javadoc location: (None) et cliquer sur le bouton Edit…. Sélectionnez Javadoc in archive|Workspace file|Browse et validez avec le fichier javadoc.

File|New|Other, XML File, Next, Create XML file from a DTD file/Create XML file from an XML schema file, Select XML Catalog entry avec la clé -//Hibernate/Hibernate Configuration DTD 3.0//EN/http://xmlns.jcp.org/xml/ns/persistence/persistence_2_1.xsd (par exemple), et enfin sélectionner l'élément racine.

Dans l'exemple, le fichier XSD se trouve dans une archive JAR. On va créer le fichier Beans.xml pour Spring dans la racine du dossier src.

Allez dans le menu Window|Preferences puis dans la rubrique XML|XML Catalog. Sélectionnez User Specified Entries et cliquez sur Add….

Il faut ajouter un Catalog Entry et dans Location mettre : jar:file:…/eclipse-jee-neon-1a-linux-gtk-x86_64/plugins/org.springframework.aop_4.3.0.20160611-RELEASE.jar!/org/springframework/aop/factory/xml/spring-beans-4.3.xsd puis sélectionnez dans Key type : Schema location et enfin dans Key mettre http://www.springframework.org/schema/beans/spring-beans-4.3.xsd.

Recommencez pour Spring AOP :

• jar:file:…/eclipse-jee-neon-1a-linux-gtk-x86_64/plugins/org.springframework.aop_4.3.0.20160611-RELEASE.jar!/org/springframework/aop/config/spring-aop-4.3.xsd
• http://www.springframework.org/schema/aop/spring-aop-4.3.xsd.

Et enfin, il est possible de créer le fichier Beans.xml par la méthode précédente en commençant par sélectionner le schéma Beans.xsd.

Choisir comme Root element beans. Changer le prefix de beans de p à beans ou rien selon l'habitude. Ajoutez le Namespace Name http://www.w3.org/2001/XMLSchema-instance en cochant la case xsi. Et enfin, ajoutez Spring AOP. Le Namespace Name ne se complète pas automatiquement, il suffit de recopier la ligne Location Hint en enlevant le nom du fichier.

Et pour terminer, faire un clique-droit sur le fichier, Spring Tools et sélectionnez Add as Bean Configuration.