Jersey , implémentation de référence pour développer un service Web RESTful basé sur JAX-RS (JSR 311 ) spécification.
Dans ce didacticiel, nous vous montrons comment développer une application Web REST Hello World avec Simple Jersey .
Technologies et outils utilisés dans cet article:
-
Jersey 1.8
-
JDK 1.6
-
Tomcat 6.0
-
Maven 3.0.3
-
Eclipse 3.6
1. Structure de l’annuaire
Ceci est la structure finale du projet Web de ce tutoriel.
2. Projet Web standard
Créez une structure de projet Web Maven standard.
mvn archetype:generate -DgroupId=com.mkyong.rest -DartifactId=RESTfulExample -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false
-
Remarque ** Pour prendre en charge Eclipse, utilisez la commande Maven:
mvn eclipse:eclipse -Dwtpversion=2.0
3. Dépendances du projet
Jersey est publié dans le référentiel Java.net Maven. Pour développer l’application Jersey REST, déclarez simplement “ jersey-server ” dans Maven `pom.xm`l.
Fichier: pom.xml
<project ...> <repositories> <repository> <id>maven2-repository.java.net</id> <name>Java.net Repository for Maven</name> <url>http://download.java.net/maven/2/</url> <layout>default</layout> </repository> </repositories> <dependencies> <dependency> <groupId>com.sun.jersey</groupId> <artifactId>jersey-server</artifactId> <version>1.8</version> </dependency> </dependencies> </project>
4. Service REST
Service REST simple avec Jersey.
package com.mkyong.rest; import javax.ws.rs.GET; import javax.ws.rs.Path; import javax.ws.rs.PathParam; import javax.ws.rs.core.Response; @Path("/hello") public class HelloWorldService { @GET @Path("/{param}") public Response getMsg(@PathParam("param") String msg) { String output = "Jersey say : " + msg; return Response.status(200).entity(output).build(); } }
5. web.xml
Dans
web.xml
, enregistrez«
com.sun.jersey.spi.container.servlet.ServletContainer
» et place votre dossier de service Jersey sous «
init-param
», «` com.sun.jersey.config .property.packages` “.
Fichier: web.xml
<web-app id="WebApp__ID" version="2.4" xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app__2__4.xsd"> <display-name>Restful Web Application</display-name> <servlet> <servlet-name>jersey-serlvet</servlet-name> <servlet-class> com.sun.jersey.spi.container.servlet.ServletContainer </servlet-class> <init-param> <param-name>com.sun.jersey.config.property.packages</param-name> <param-value>com.mkyong.rest</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>jersey-serlvet</servlet-name> <url-pattern>/rest/** </url-pattern> </servlet-mapping> </web-app>
6. Démo
Dans cet exemple, la requête Web de «
projectURL/rest/hello/
» correspondra à «
HelloWorldService
», via
@Path ("/hello ")
.
Et le "
\ {toutes les valeurs}
" de "
projectURL/rest/hello/\ {les valeurs}
" correspondra au paramètre annoté avec
@ PathParam
.
URL: http://localhost : 8080/RESTfulExample/rest/hello/mkyong
Télécharger le code source
Téléchargez le - lien://wp-content/uploads/2011/07/JAX-RS-Hello-World-Jersey-Example.zip[JAX-RS-Hello-World-Jersey-Example.zip](6 KB)
Références
-
lien://services web/jax-rs/resteasy-hello-world-example/[RESTEasy hello
exemple du monde]. http://www.vogella.de/articles/REST/article.html [REST avec Java
(JAX-RS) sous Jersey - Tutoriel]. http://www.ibm.com/developerworks/webservices/library/ws-restful/ [IBM
: RESTful Web services: The basics]. http://www.oracle.com/technetwork/articles/javase/index-137171.html [RESTful
Services Web]
lien://tag/salut-monde/[salut monde]lien://tag/jax-rs/[jax-rs]lien://tag/maillot/[maillot]