Crear un servicio web JAX-RS
Antes de empezar
- WebSphere Application Server v7.0 o v8.0, seleccionando la instalación del paquete de características para Web 2.0 y Mobile, y las herramientas para el desarrollo de WebSphere Application Server
Si opta por desplegar en un servidor distinto de WebSphere Application Server, no puede utilizar la biblioteca JAX-RS de IBM®, y debe instalar y configurar sus propias bibliotecas JAX-RS a través de la página de preferencias Facetas del proyecto > JAX-RS.
Para obtener información detallada sobre la utilización de los servicios web JAX-RS en WebSphere Application Server, consulte:WebSphere Application Server Information Center
Crear un proyecto web habilitado para JAX-RS
Acerca de esta tarea
[WebSphere Application Server traditional] WebSphere Application Server traditional V9 da soporte a JAX-RS 1.1 y 2.0. La versión de JAX-RS que se utiliza en el proyecto debe coincidir con la versión de JAX-RS que se utiliza en la instalación de la versión tradicional de WebSphere Application Server V9. Si estas versiones no coinciden, las herramientas muestran un aviso cuando se despliega el proyecto en el servidor. Si crea un proyecto JAX-RS sin especificar un nivel de faceta, las herramientas utilizan JAX-RS 2.0 de manera predeterminada.
com.ibm.ws.jaxrs.jar
com.ibm.ws.prereq.jaxrs.jar
javax.j2ee.jaxrs.jar
com.ibm.ws.jaxrs20.jar
com.ibm.ws.prereq.jaxrs20.jar
javax.ws.rs-api-2.0.jar
Procedimiento
Crear un servicio web JAX-RS
Procedimiento
- En el proyecto web, cree un paquete (pulse con el botón derecho del ratón en y seleccione ). Importe las clases para el servicio web al paquete.
- Abra WebContent/WEB-INF/web.xml. En la vista Diseño, seleccione el servlet JAX-RS Servlet, pulse Añadir y añada un parámetro de inicialización del servlet de JAX-RS, dejando vacíos los campos de nombre y valor. Guarde web.xml omitiendo los errores que podrían visualizarse.
- En la vista Marcadores, seleccione el error de web.xml sobre el param-name, pulse con el botón derecho del ratón y seleccione Arreglo rápido. Vaya a la aplicación y selecciónela.
- Añada el EAR que contiene el proyecto JAX-RS al servidor e inícielo.
Resultados
Cada aplicación web debe tener una raíz de contexto para que la aplicación web se despliegue satisfactoriamente. Durante el ensamblaje o el despliegue de las aplicaciones se define una raíz de contexto para cada módulo web en el descriptor de despliegue de las aplicaciones. La raíz de contexto se combina con la correlación de servlet definida del archivo WAR para componer el URL completo que los usuarios escriben para acceder al servlet. La raíz de contexto de cada aplicación web desplegada debe ser exclusiva en el servidor. La raíz de contexto también puede estar vacía.
Por ejemplo, si una aplicación web ha utilizado una raíz de contexto de sample/application/, el URL de solicitud de la aplicación web comenzará por http://<nombre_host>:<puerto>/sample/application/. El patrón URL de un servlet se añade a la raíz de contexto de la aplicación web. Por ejemplo, si la raíz de contexto es sample/application/ y l a correlación de URL de servlet es rest/api/*, el URI de base de la aplicación web JAX-RS es http://<nombre_host>:<puerto>/sample/application/rest/api.
Edición de un proyecto JAX-RS
- Tipo de biblioteca
- Nombre de servlet JAX-RS
- Nombre de clase de servlet JAX-RS
- Patrones de correlación URL