Services Web RESTful - Configuration de l'environnement
Ce tutoriel vous guidera sur la façon de préparer un environnement de développement pour commencer votre travail avec Jersey Frameworkpour créer des services Web RESTful. Outils de cadre JerseyJAX-RS 2.0API, qui est une spécification standard pour créer des services Web RESTful. Ce tutoriel vous apprendra également comment configurerJDK, Tomcat et Eclipse sur votre ordinateur avant la configuration de Jersey Framework.
Configurer le kit de développement Java (JDK)
Vous pouvez télécharger la dernière version du SDK à partir du site Java d'Oracle - Téléchargements Java SE . Vous trouverez les instructions d'installation de JDK dans les fichiers téléchargés. Suivez les instructions données pour installer et configurer la configuration. Enfin, définissez lePATH et JAVA_HOME variables d'environnement pour faire référence au répertoire qui contient Java et Javac, généralement rép_install_java / bin et rép_install_java respectivement.
Si vous exécutez Windows et avez installé le JDK dans C: \ jdk1.7.0_75, vous devrez mettre la ligne suivante dans votre fichier C: \ autoexec.bat.
set PATH = C:\jdk1.7.0_75\bin;%PATH%
set JAVA_HOME = C:\jdk1.7.0_75Alternativement, sous Windows NT / 2000 / XP, vous pouvez également cliquer avec le bouton droit sur Poste de travail → sélectionner Propriétés → puis Avancé → puis Variables d'environnement. Ensuite, vous mettriez à jour la valeur PATH et appuyez sur le bouton OK.
Sous Unix (Solaris, Linux, etc.), si le SDK est installé dans /usr/local/jdk1.7.0_75 et que vous utilisez le shell C, vous mettriez ce qui suit dans votre fichier .cshrc.
setenv PATH /usr/local/jdk1.7.0_75/bin:$PATH
setenv JAVA_HOME /usr/local/jdk1.7.0_75Sinon, si vous utilisez un environnement de développement intégré (IDE) tel que Borland JBuilder, Eclipse, IntelliJ IDEA ou Sun ONE Studio, compilez et exécutez un programme simple pour confirmer que l'EDI sait où vous avez installé Java, sinon effectuez la configuration appropriée comme document donné de l'IDE.
Configurer l'IDE Eclipse
Tous les exemples de ce didacticiel ont été écrits à l'aide de l'IDE Eclipse. Donc, je suggère que vous devriez avoir la dernière version d'Eclipse installée sur votre machine.
Pour installer Eclipse IDE, téléchargez les derniers binaires Eclipse à partir de https://www.eclipse.org/downloads/. Une fois que vous avez téléchargé l'installation, décompressez la distribution binaire dans un emplacement pratique. Par exemple, dans C: \ eclipse sous Windows, ou / usr / local / eclipse sous Linux / Unix et définissez enfin la variable PATH de manière appropriée.
Eclipse peut être démarré en exécutant les commandes suivantes sur une machine Windows, ou vous pouvez simplement double-cliquer sur eclipse.exe.
%C:\eclipse\eclipse.exeEclipse peut être démarré en exécutant les commandes suivantes sur une machine Unix (Solaris, Linux, etc.) -
$/usr/local/eclipse/eclipseAprès un démarrage réussi, si tout va bien, votre écran devrait afficher le résultat suivant -
Configurer les bibliothèques Jersey Framework
Maintenant, si tout va bien, vous pouvez procéder à la configuration du framework Jersey. Voici quelques étapes simples pour télécharger et installer le framework sur votre machine.
Choisissez si vous souhaitez installer Jersey sous Windows ou Unix, puis passez à l'étape suivante pour télécharger le fichier .zip pour Windows, puis le fichier .tz pour Unix.
Téléchargez la dernière version des binaires du framework Jersey à partir du lien suivant - https://jersey.java.net/download.html.
Au moment de la rédaction de ce tutoriel, j'ai téléchargé jaxrs-ri-2.17.zip sur ma machine Windows et lorsque vous décompressez le fichier téléchargé, il vous donnera la structure de répertoire dans E: \ jaxrs-ri-2.17 \ jaxrs-ri comme indiqué dans la capture d'écran suivante.
Vous trouverez toutes les bibliothèques Jersey dans les répertoires C:\jaxrs-ri-2.17\jaxrs-ri\lib et dépendances dans C:\jaxrs-ri-2.17\jaxrs-ri\ext. Assurez-vous de définir correctement votre variable CLASSPATH sur ce répertoire, sinon vous rencontrerez des problèmes lors de l'exécution de votre application. Si vous utilisez Eclipse, il n'est pas nécessaire de définir le CLASSPATH car tous les paramètres seront définis via Eclipse.
Configurer Apache Tomcat
Vous pouvez télécharger la dernière version de Tomcat sur https://tomcat.apache.org/. Une fois que vous avez téléchargé l'installation, décompressez la distribution binaire dans un emplacement pratique. Par exemple dans C: \ apache-tomcat-7.0.59 sous Windows, ou /usr/local/apache-tomcat-7.0.59 sous Linux / Unix et définissez la variable d'environnement CATALINA_HOME pointant vers les emplacements d'installation.
Tomcat peut être démarré en exécutant les commandes suivantes sur une machine Windows, ou vous pouvez simplement double-cliquer sur startup.bat.
%CATALINA_HOME%\bin\startup.batou
C:\apache-tomcat-7.0.59\bin\startup.batTomcat peut être démarré en exécutant les commandes suivantes sur une machine Unix (Solaris, Linux, etc.) -
$CATALINA_HOME/bin/startup.shou
/usr/local/apache-tomcat-7.0.59/bin/startup.shAprès un démarrage réussi, les applications Web par défaut incluses avec Tomcat seront disponibles en visitant http://localhost:8080/. Si tout va bien, il devrait afficher le résultat suivant -
Vous trouverez de plus amples informations sur la configuration et l'exécution de Tomcat dans la documentation incluse sur cette page. Ces informations sont également disponibles sur le site Web de Tomcat -https://tomcat.apache.org.
Tomcat peut être arrêté en exécutant les commandes suivantes sur une machine Windows -
%CATALINA_HOME%\bin\shutdownou
C:\apache-tomcat-7.0.59\bin\shutdownTomcat peut être arrêté en exécutant les commandes suivantes sur une machine Unix (Solaris, Linux, etc.) -
$CATALINA_HOME/bin/shutdown.shou
/usr/local/apache-tomcat-7.0.59/bin/shutdown.shUne fois que vous avez terminé cette dernière étape, vous êtes prêt à passer à votre premier exemple de Jersey que vous verrez dans le chapitre suivant.