< Anterior | Siguiente >

Lección 1: Crear un servidor y un proyecto web

El servicio web tiene que residir en un proyecto web con la faceta JAX-RS habilitada.

Creación de un servidor habilitado para JAX-RS

Antes de crear el servicio web, debe tener un servidor definido e iniciado con un soporte Java 5.0 o JVM posterior. De forma predeterminada, se crea un servidor automáticamente cuando se instala WebSphere Application Server. Este servidor se puede en la vista Servidores. No obstante, si desea crear un nuevo WebSphere Application Server, siga estos pasos:
  1. En el menú Archivo, seleccione Nuevo > Otros > Servidor > Servidor > Siguiente.
  2. Seleccione la versión adecuada de WebSphere Application Server como tipo de servidor. Pulse Siguiente.
  3. Si este tiempo de ejecución no se ha creado en su espacio de trabajo, se le solicitará que seleccione el directorio de instalación del servidor. Pulse Siguiente.
  4. Acepte el puerto y nombre del servidor predeterminados. Durante esta guía de aprendizaje, el nombre de servidor predeterminado utilizado será server1. Pulse Finalizar.
  5. Espere a que se inicie el servidor. Una vez iniciado, la vista Consola mostrará Servidor server1 abierto para e-business. Si el servidor no se inicia automáticamente, selecciónelo en la vista Servidores y pulse el icono de inicio: Icono de inicio de servidor.

Crear un proyecto web habilitado para JAX-RS

El servicio web JAX-RS tiene que residir en un proyecto con la faceta JAX-RS habilitada.
  1. En la perspectiva Java EE, pulse con el botón derecho en el proyecto de aplicación empresarial y seleccione Nuevo > Proyecto web para abrir el asistente de proyecto web.
  2. En el campo Nombre, escriba el nombre del proyecto web. Durante esta guía de aprendizaje, utilice JAXRS.
  3. 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.
  4. 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
  5. Pulse Siguiente para configurar el proyecto web nuevo.
  6. 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.
  7. 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:
      Aviso de raíz única
      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:
      1. Pulse Ventana > Preferencias > Validación > Validación de estructura de proyecto y, a continuación, pulse el botón ... para Valores.
      2. 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.
  8. 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 Preferencias > Facetas del proyecto > JAX-RS.
  9. 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.
  10. 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.

< Anterior | Siguiente >
Icono que indica el tipo de tema Tema de lección de guía de aprendizaje
Términos y condiciones para centros de información | Comentarios

Icono de indicación de fecha y hora Última actualización: 22 de abril de 2014

Nombre de archivo: jaxrs_exercise12.html