< Anterior | Siguiente >

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

En esta lección, aprenderá a crear un servidor y un proyecto web para su uso con los servicios web.

Creación de un servidor habilitado para JAX-WS

Antes de crear el servicio web, debe asegurarse de que tiene definido e iniciado un servidor WebSphere Application Server v8.0 y posteriores. 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 servidor nuevo, siga estos pasos:
  1. En el menú Archivo, seleccione Nuevo > Otros > Servidor > Servidor > Siguiente.
  2. Seleccione WebSphere Application Server v8.0 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.

Creación de un proyecto web para el servicio web

Los asistentes de servicios web pueden crear un proyecto web para el servicio web y habilitar las facetas automáticamente, aunque en esta guía de aprendizaje creará el proyecto manualmente.
  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 jwsAddressBook.
  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 v7 o v8 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 jwsAddressBookEAR 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 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.
  9. Pulse Finalizar.

Creación de un proyecto web para el cliente de servicio web

Los asistentes de servicios web pueden crear un proyecto web para el cliente y habilitar las facetas automáticamente, aunque en esta guía de aprendizaje creará el proyecto manualmente.
  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 jwsAddressBookClient.
  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 v7 o v8 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 jwsAddressBookEAR 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 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.
  9. Pulse Finalizar.

Descarga del archivo WSDL de la libreta de direcciones

Descargue el archivo WSDL necesario.

Punto de comprobación de la lección

Ahora ya está preparado para comenzar la Lección 2: Creación 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: jaxwstd_exercise11.html