Servicios RESTful con Tomcat 7 y Jersey

24/Oct/2015 Java , , ,

Si queremos utilizar JAX-RS para crear nuestros servicios RESTful de una forma sencilla podremos apoyarnos en la implementación que ha hecho Jersey del estándar JAX-RS (JSR 311 y JSR 339). Si bien necesitaremos un servidor para desplegarlos y en este caso vamos a utilizar Tomcat 7 con nuestro ejemplo.

Así que veamos que pasos tenemos que dar para poder crear servicios RESTful con Tomcat 7 y Jersey. En todo el proceso de creación de nuestra aplicación Java con servicios RESTful nos vamos a apoyar en Maven como gestor de dependencias.

Tomcat 7

Lo primero de todo será utilizar Tomcat 7 para poder disponer de un contenedor de Servlets. Ya que al final Jersey lo que nos va a proporcionar es un Servlet el cual deberemos de configurar dentro de nuestro contenedor.

Para utilizar Tomcat 7 vamos a apoyarnos en el plugin de Tomcat para Maven. Así que lo que haremos será configurar el fichero pom.xml para añadir la referencia a este plugin.

  1. <build>
  2. <plugins>
  3. <plugin>
  4. <groupId>org.apache.tomcat.maven</groupId>
  5. <artifactId>tomcat7-maven-plugin</artifactId>
  6. <version>2.2</version>
  7. <configuration>
  8. <url>http://localhost:8080/manager/text</url>
  9. <server>miservidor</server>
  10. <path>/miapp</path>
  11. </configuration>
  12. </plugin>
  13. </plugins>
  14. </build>

Jersey

Para utilizar Jersey necesitamos en primer lugar tener sus librerías, para lo cual lo añadiremos como dependencias Maven y luego configurar el Servlet que tienen para escuchar las peticiones.

Añadir dependencia Jersey

Ahora pasamos a añadir la dependencia de Jersey en Maven. Para ello añadimos el siguiente código al fichero pom.xml.

  1. <dependency>
  2. <groupId>com.sun.jersey</groupId>
  3. <artifactId>jersey-server</artifactId>
  4. <version>1.8</version>
  5. </dependency>

Con esto conseguimos que cuando construyamos nuestro proyecto mediante Maven se gestionen y descarguen las dependencias y sus librerías relacionadas. En este caso: jersey-core-1.10.jar, jersey-server-1.10.jar,...

Configurar el Servlet Jersey

Una vez tenemos configurado Jersey en nuestro proyecto vamos a dar de alta el Servlet que atenderá las peticiones para los servicios RESTful. Así que vamos al fichero web.xml y damos de alta el Servlet.

  1. <servlet>
  2. <servlet-name>Jersey REST Service</servlet-name>
  3. <servlet-class>com.sun.jersey.spi.container.servlet.ServletContainer</servlet-class>
  4. <init-param>
  5. <param-name>com.sun.jersey.config.property.packages</param-name>
  6. <param-value>com.lineadecodigo.javaee.rest</param-value>
  7. </init-param>
  8. <load-on-startup>1</load-on-startup>
  9. </servlet>

En la configuración del Servlet de Jersey vemos varias cosas relevantes. La primera es que el Servlet está en la clase com.sun.jersey.spi.container.servlet.ServletContainer y el segundo y más importante es que le tenemos que decir cual es la clase base de nuestros servicios RESTful. Para ello utilizamos el parámetro com.sun.jersey.config.property.packages y en nuestro caso las clases RESTful las tenemos en el paquete com.lineadecodigo.javaee.rest

Lo siguiente será crear un mapping con la ruta en la que queremos que se sirvan los servicios RESTful, para ello incluimos en el fichero web.xml el siguiente código:

  1. <servlet-mapping>
  2. <servlet-name>Jersey REST Service</servlet-name>
  3. <url-pattern>/rest/*</url-pattern>
  4. </servlet-mapping>

Ejemplo JAX-RS

Ya solo tendremos que crear nuestro servicio RESTful con JAX-RS para poder probarlo. Un ejemplo sencillo de servicio RESTful sería el siguiente Hola Mundo con JAX-RS.

  1. package com.lineadecodigo.javaee.rest;
  2.  
  3. import javax.ws.rs.GET;
  4. import javax.ws.rs.Path;
  5. import javax.ws.rs.Produces;
  6. import javax.ws.rs.core.Context;
  7. import javax.ws.rs.core.UriInfo;
  8.  
  9. @Path("helloworld")
  10. public class HelloWorldRest {
  11.  
  12. private UriInfo context;
  13.  
  14. public HelloWorldRest() {
  15. }
  16.  
  17. @GET
  18. @Produces("text/html")
  19. public String getHtml() {
  20. return "<html lang=\"en\"><body><h1>Hola Mundo!!</h1></body></html>";
  21. }
  22.  
  23. }

Ejecutar la Aplicación

Como nos hemos basado en Maven para crear servicios RESTful con Tomcat 7 y Jersey deberemos de ejecutar los siguientes comandos para arrancar el servidor.

mvn package clean
mvn tomcat7:run-war

Ya solo nos quedará acceder a la URL

http://localhost:8080/miapp/rest/helloworld

Para ver nuestra aplicación JAX-RS funcionando. Como se puede ver miapp es el nombre del servidor en Tomcat, rest es el servlet que escucha las peticiones y helloworld el Path del servicio RESTful.

Si sigues todos estos pasos podrás ya podrás crear tus servicios RESTful con Tomcat 7 y Jersey de una forma sencilla.

Ejemplos sobre JAX-RS

Te adjuntamos algunos ejemplos sobre JAX-RS relacionados con el tema tratado.

Vídeos sobre JAX-RS

[tubepress mode="playlist" googleApiKey="AIzaSyBS-zg1hfcDxlw3mawgYwoS3Rbl3-xqep4" playlistValue="https://www.youtube.com/playlist?list=PLLVIhySQmrVbgY11w-ukKeu53L39OScWc"]

Difunde el Conocimiento

Si te ha gustado el artículo o te ha sido de utilidad, no dejes de compartirlo con tus amigos en las redes sociales... Te estaremos muy agradecidos. :-D