JAX-RS: Sample Application (WebSphere Application Server)

Samples | JAX-RS: Sample Application (WebSphere Application Server)

Notes
Créer une application JAX-RS

Notes
Cette page donne les étapes pour créer une application JAX-RS.
Cette application a été développée en utilisant Eclipse et était déployée sur WebSphere Application Server.
Créer une application JAX-RS
- Créer un projet Maven:
  
  $ mvn archetype:generate \ -DarchetypeGroupId=org.apache.maven.archetypes \ -DarchetypeArtifactId=maven-archetype-webapp \ -DarchetypeVersion=1.4 \ -DgroupId=mtitek.modulez.ws.rs \ -DartifactId=mtitek-modulez-ws-rs \ -Dversion=1.0.0-SNAPSHOT \ -DinteractiveMode=false
  Notes :
  Sur Linux, le caractère "\" permet d'écrire une commande sur plusieurs lignes.
  Sur Windows, il faut utiliser le caractère "^".
  
  Créer le répertoire "java".
  $ mkdir "mtitek-modulez-ws-rs/src/main/java"
- Modifier le fichier "pom.xml":
  
  <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd"> <modelVersion>4.0.0</modelVersion> <groupId>mtitek.modulez.ws.rs</groupId> <artifactId>mtitek-modulez-ws-rs</artifactId> <version>1.0.0-SNAPSHOT</version> <packaging>war</packaging> <dependencies> <dependency> <groupId>javax</groupId> <artifactId>javaee-api</artifactId> <version>6.0</version> <scope>provided</scope> </dependency> </dependencies> </project>
- Créer une classe Java qui va servir comme resource du Service Web JAX-RS:
  
  package mtitek.modulez.ws.rs.resources; import javax.ws.rs.Consumes; import javax.ws.rs.DefaultValue; import javax.ws.rs.FormParam; import javax.ws.rs.GET; import javax.ws.rs.POST; import javax.ws.rs.Path; import javax.ws.rs.Produces; import javax.ws.rs.QueryParam; import javax.ws.rs.core.MediaType; @Path("/JAXRSFirstPath") public class JAXRSFirst { @GET @Produces(MediaType.TEXT_HTML) public String doGet(@DefaultValue("jax-rs HelloWorld Get!") @QueryParam("value") String value) { return value == null ? "" : ("<h1>" + value + "</h1>"); } @POST @Produces(MediaType.TEXT_HTML) @Consumes(MediaType.APPLICATION_FORM_URLENCODED) public String doPost(@DefaultValue("jax-rs HelloWorld Post!") @FormParam("value") String value) { return value == null ? "" : ("<h1>" + value + "</h1>"); } }
  Notes :
  Il est possible d'annoter la classe comme étant un bean "stateless" ou "singleton".
- Créer une classe Java qui va servir comme gestionnaire des resources du Service Web JAX-RS:
  
  package mtitek.modulez.ws.rs; import javax.ws.rs.ApplicationPath; import javax.ws.rs.core.Application; @ApplicationPath("jaxrsResources") public class JAXRSApplication extends Application { }
- Créer une page HTML "jaxrsFirstPost.htm" pour invoquer le Service Web avec une requête HTTP POST:
  
  <html> <head> <title>JAXRSFirst POST HTML</title> </head> <body> <form action="/mtitek-modulez-ws-rs/jaxrsResources/JAXRSFirstPath" method="post"> Value: <input name="value" value="" /><br /> <input name="submit" type="submit" value="submit" /> </form> </body> </html>
- Créer, déployer et tester le Service Web:
  Pour construire le projet il faut utiliser la commande Maven : "mvn install".
  
  Le fichier WAR créé ("mtitek-modulez-ws-rs-1.0.0-SNAPSHOT.war") peut être déployé seul ou packagé dans un EAR.
  Voir cette page pour plus de détails : Déployer une application entreprise (WebSphere Application Server)
  
  Pour tester le service Web utiliser les URLs swivantes :
  - Requête HTTP GET (sans paramètre): http://localhost:9080/mtitek-modulez-ws-rs/jaxrsResources/JAXRSFirstPath
  - Requête HTTP GET (avec paramètre): http://localhost:9080/mtitek-modulez-ws-rs/jaxrsResources/JAXRSFirstPath?value=JAX-RS
  - Requête HTTP POST : http://localhost:9080/mtitek-modulez-ws-rs/jaxrsFirstPost.htm