Servicios web RESTful: configuración del entorno

Este tutorial lo guiará sobre cómo preparar un entorno de desarrollo para comenzar su trabajo Jersey Frameworkpara crear servicios web RESTful. Implementos del marco de JerseyJAX-RS 2.0API, que es una especificación estándar para crear servicios web RESTful. Este tutorial también le enseñará cómo configurarJDK, Tomcat y Eclipse en su máquina antes de que se configure Jersey Framework.

Configurar el kit de desarrollo de Java (JDK)

Puede descargar la última versión del SDK del sitio Java de Oracle: Descargas de Java SE . Encontrará las instrucciones para instalar JDK en los archivos descargados. Siga las instrucciones dadas para instalar y configurar la instalación. Finalmente configure elPATH y JAVA_HOME variables de entorno para hacer referencia al directorio que contiene Java y Javac, normalmente java_install_dir / bin y java_install_dir respectivamente.

Si está ejecutando Windows e instaló el JDK en C: \ jdk1.7.0_75, tendría que poner la siguiente línea en su archivo C: \ autoexec.bat.

set PATH = C:\jdk1.7.0_75\bin;%PATH% 
set JAVA_HOME = C:\jdk1.7.0_75

Alternativamente, en Windows NT / 2000 / XP, también puede hacer clic con el botón derecho en Mi PC → seleccionar Propiedades → luego Avanzado → luego Variables de entorno. Luego, actualizaría el valor PATH y presionaría el botón OK.

En Unix (Solaris, Linux, etc.), si el SDK está instalado en /usr/local/jdk1.7.0_75 y usa C Shell, pondría lo siguiente en su archivo .cshrc.

setenv PATH /usr/local/jdk1.7.0_75/bin:$PATH 
setenv JAVA_HOME /usr/local/jdk1.7.0_75

Alternativamente, si usa un entorno de desarrollo integrado (IDE) como Borland JBuilder, Eclipse, IntelliJ IDEA o Sun ONE Studio, compile y ejecute un programa simple para confirmar que el IDE sabe dónde instaló Java; de lo contrario, realice la configuración adecuada como se indica en el documento. del IDE.

Configurar Eclipse IDE

Todos los ejemplos de este tutorial se han escrito utilizando el IDE de Eclipse. Por lo tanto, le sugiero que tenga instalada la última versión de Eclipse en su máquina.

Para instalar Eclipse IDE, descargue los últimos binarios de Eclipse desde https://www.eclipse.org/downloads/. Una vez que descargó la instalación, descomprima la distribución binaria en una ubicación conveniente. Por ejemplo, en C: \ eclipse en Windows, o / usr / local / eclipse en Linux / Unix y finalmente configure la variable PATH apropiadamente.

Eclipse se puede iniciar ejecutando los siguientes comandos en una máquina con Windows, o simplemente puede hacer doble clic en eclipse.exe.

%C:\eclipse\eclipse.exe

Eclipse se puede iniciar ejecutando los siguientes comandos en una máquina Unix (Solaris, Linux, etc.):

$/usr/local/eclipse/eclipse

Después de un inicio exitoso, si todo está bien, entonces su pantalla debería mostrar el siguiente resultado:

Configurar bibliotecas de Jersey Framework

Ahora, si todo está bien, puede proceder a configurar el marco de Jersey. A continuación se muestran algunos pasos sencillos para descargar e instalar el marco en su máquina.

  • Elija si desea instalar Jersey en Windows o Unix y luego continúe con el siguiente paso para descargar el archivo .zip para Windows y luego el archivo .tz para Unix.

  • Descargue la última versión de los binarios del marco de Jersey desde el siguiente enlace: https://jersey.java.net/download.html.

  • En el momento de escribir este tutorial, descargué jaxrs-ri-2.17.zip en mi máquina con Windows y cuando descomprima el archivo descargado, le dará la estructura de directorio dentro de E: \ jaxrs-ri-2.17 \ jaxrs-ri como se muestra en la siguiente captura de pantalla.

Encontrará todas las bibliotecas de Jersey en los directorios C:\jaxrs-ri-2.17\jaxrs-ri\lib y dependencias en C:\jaxrs-ri-2.17\jaxrs-ri\ext. Asegúrese de configurar su variable CLASSPATH en este directorio correctamente, de lo contrario, tendrá problemas al ejecutar su aplicación. Si está utilizando Eclipse, no es necesario que configure CLASSPATH porque todos los ajustes se realizarán a través de Eclipse.

Configurar Apache Tomcat

Puede descargar la última versión de Tomcat desde https://tomcat.apache.org/. Una vez que descargó la instalación, descomprima la distribución binaria en una ubicación conveniente. Por ejemplo, en C: \ apache-tomcat-7.0.59 en Windows, o /usr/local/apache-tomcat-7.0.59 en Linux / Unix y establezca la variable de entorno CATALINA_HOME apuntando a las ubicaciones de instalación.

Tomcat se puede iniciar ejecutando los siguientes comandos en una máquina con Windows, o simplemente puede hacer doble clic en startup.bat.

%CATALINA_HOME%\bin\startup.bat

o

C:\apache-tomcat-7.0.59\bin\startup.bat

Tomcat se puede iniciar ejecutando los siguientes comandos en una máquina Unix (Solaris, Linux, etc.):

$CATALINA_HOME/bin/startup.sh

o

/usr/local/apache-tomcat-7.0.59/bin/startup.sh

Después de un inicio exitoso, las aplicaciones web predeterminadas incluidas con Tomcat estarán disponibles visitando http://localhost:8080/. Si todo está bien, debería mostrar el siguiente resultado:

Puede encontrar más información sobre la configuración y ejecución de Tomcat en la documentación incluida en esta página. Esta información también se puede encontrar en el sitio web de Tomcat:https://tomcat.apache.org.

Tomcat se puede detener ejecutando los siguientes comandos en una máquina con Windows:

%CATALINA_HOME%\bin\shutdown

o

C:\apache-tomcat-7.0.59\bin\shutdown

Tomcat se puede detener ejecutando los siguientes comandos en una máquina Unix (Solaris, Linux, etc.):

$CATALINA_HOME/bin/shutdown.sh

o

/usr/local/apache-tomcat-7.0.59/bin/shutdown.sh

Una vez que haya terminado con este último paso, estará listo para continuar con su primer ejemplo de Jersey, que verá en el siguiente capítulo.