El servicio web JAX-RS tiene que residir en un proyecto con la faceta JAX-RS habilitada.
- En la perspectiva Java EE, pulse con el botón derecho en el proyecto de aplicación empresarial y seleccione para abrir el asistente de proyecto web.
- En el campo Nombre, escriba el nombre del proyecto web. Durante esta guía de aprendizaje, utilice JAXRS.
- En la sección Plantillas de proyecto, seleccione el tipo de plantilla web que desee utilizar: Durante esta guía de aprendizaje, seleccione Simple.
Opción |
Descripción |
Toolkit Dojo |
Configura el proyecto para que tenga prestaciones de Dojo. Los recursos de Dojo pueden estar en el mismo proyecto, en un proyecto aparte o en una ubicación remota, accesible vía HTTP. |
JavaServer Faces |
Habilita el despliegue del proyecto con prestaciones de JSF.
Se proporciona una configuración tanto para JSP como para Facelets. |
Servicios REST |
Un proyecto configurado para servicios REST basados en JAX-RS |
Simple |
Crea un proyecto web básico. |
- En la sección Modelo de programación, seleccione el modelo de programación que desea utilizar: Durante esta guía de aprendizaje, seleccione Java EE.
- Solo de cliente (HTML, JavaScript,...)
- Java EE
- OSGi
- Pulse Siguiente para configurar el proyecto web nuevo.
- En la página de despliegue, en la lista de opciones de configuración disponibles, pulse Despliegue para abrir la página Configuración del despliegue.
- En el campo Tiempo de ejecución de destino, seleccione el WebSphere Application Server que ha instalado anteriormente en la guía de aprendizaje.
- En el campo Versión de módulo web, acepte el valor predeterminado, que se selecciona automáticamente basándose en el WebSphere Application Server que ha seleccionado.
- En el campo Pertenencia a EAR, seleccione Añadir un proyecto a un EAR y asegúrese de que JAXRSEAR sea el nombre del proyecto EAR.
- En la sección Despliegue, seleccione Cambiar características. En la página Facetas de proyecto, seleccione JAX-RS (REST Web Services), versión 1.1 y pulse Aceptar.
- En la lista de opciones de configuración disponibles, pulse Java para abrir la
página de configuración de Java.
- En el campo Carpetas de orígenes en la vía de acceso de creación, acepte el directorio predeterminado src o pulse Añadir carpetas, Editar... o Eliminar para especificar una carpeta de archivos de origen.
- En el campo Carpeta de salida predeterminada:, especifique una carpeta para los archivos de salida o acepte el valor predeterminado (WebContent\WEB-INF\classes).
Importante: Si elige una carpeta que no sea WebContent\WEB-INF\classes para la carpeta de salida predeterminada, la vista de problemas contiene el siguiente aviso:
El valor predeterminado de los problemas de raíz única se establece a aviso. Para cambiar este valor, utilice la página
Filtros de validación para validador de estructura de proyectos:
- Pulse y, a continuación, pulse el botón ... para Valores.
- En la página Filtros de validación para validador de estructura de proyectos, especifique el nivel de gravedad predeterminado. Los niveles de gravedad disponibles son Error, Aviso e
Ignorar.
- En la lista de opciones de configuración disponibles, pulse Servicios REST para abrir la página Servicios REST. En el campo Biblioteca de implementación JAX-RS, seleccione Biblioteca JAX-RS de IBM WebSphere Application Server v<x>. Asegúrese de que aparezcan los siguientes valores:
- En el campo Nombre de servlet JAX-RS:, asegúrese de que aparezca JAX-RS Servlet.
- En el campo Nombre de clase de servlet JAX-RS:, asegúrese de que aparezca com.ibm.websphere.jaxrs.server.IBMRestServlet.
- En el campo Patrones de correlación URL:, asegúrese de que aparezca /jaxrs/*.
Más información sobre bibliotecas: Las bibliotecas JAX-RS para cada WebSphere Application Server que haya instalado aparecerán en este recuadro desplegable. Si desea utilizar una biblioteca que no sea de WebSphere, se puede importar mediante la página de preferencias Bibliotecas de usuario. Si selecciona Biblioteca de usuario, puede iniciar la página de preferencias Bibliotecas de usuario y añadir una biblioteca. Una vez creado un proyecto, puede cambiar la biblioteca en la página .
- EN la lista de opciones de configuración disponibles, pulse Módulo web. En la página Configuración de módulo web:
- En el campo Raíz de contexto, escriba el nombre de la raíz de contexto del proyecto, o acepte el valor predeterminado (que es el nombre del proyecto web).
- En el campo Directorio de contenido, escriba el nombre del directorio
de contenido o acepte el valor predeterminado (WebContent).
- Seleccione Generar descriptor de despliegue web.xml si desea crear un descriptor de despliegue. También podrá añadir un descriptor de despliegue para el módulo web más adelante. Debe utilizar un archivo web.xml para configurar las restricciones de seguridad y otros comportamientos.
- Pulse Finalizar.
La faceta añade la biblioteca, la información de servlet y el soporte para el proceso de anotaciones JAX-RS y los arreglos rápidos JAX-RS.
Ahora ya está preparado para iniciar el módulo siguiente: Creación y prueba del servicio web.