Introducción a JAX-WS Web Services

Transcripción

1 INSTITUTO POLITECNICO NACIONAL ESCUELA SUPERIOR DE CÓMPUTO ALUMNO: SANLUIS CASTILLO JOSE DAVID PROFESOR: CIFUENTES ALVAREZ ALEJANDRO SIGFRIDO MATERIA: WEB APPLICATION DEVEPLOMENT Introducción a JAX-WS Web Services GRUPO: 3CM2

2 Introducción a JAX-WS Web Services API Java para XML Web Services (JAX-WS), JSR 224, es una parte importante de los de Java EE 5 y 6 plataformas de EE. Un seguimiento a la liberación de la API Java para RPC basado en XML 1.1 (JAX-RPC), JAX-WS simplifica la tarea de desarrollar servicios web utilizando la tecnología Java. Se ocupa de algunos de los temas de JAX-RPC 1.1, proporcionando soporte para múltiples protocolos como SOAP 1.1, SOAP 1.2, XML, y proporcionando un servicio de apoyo a los protocolos adicionales, junto con HTTP. JAX-WS utiliza JAXB 2.0 para el enlace de datos y es compatible con personalizaciones para el control de las interfaces generadas extremo de servicio. Con su soporte para anotaciones, JAX-WS simplifica el desarrollo de servicios web y reduce el tamaño de los archivos JAR de tiempo de ejecución. Este documento muestra los fundamentos del uso de la IDE para desarrollar un servicio web JAX-WS. Después de crear el servicio web, escribir tres diferentes clientes de servicios Web que utilizan el servicio web a través de una red, que se llama "consumo" de un servicio web. Los tres clientes son una clase de Java en una aplicación Java SE, un servlet y una página JSP en una aplicación web. Un tutorial más avanzado se centra en los clientes está en desarrollo JAX-WS clientes de servicios Web. Contenido o o o Crear un servicio Web Diseñar el servicio Web Implementar y probar el servicio Web Las muestras Consumir el servicio Web en una clase Java en una aplicación de Java SE un servlet de una aplicación web una página JSP en una aplicación web Crear un servicio Web El objetivo de este ejercicio es crear un proyecto adecuado para el contenedor de implementación que se decida utilizar. Una vez que tenga un proyecto, se creará un servicio web en el mismo.

3 La elección de un contenedor Usted puede instalar el servicio web en un contenedor web o en un contenedor EJB. Esto depende de la elección de la aplicación. Si va a crear una aplicación Java EE 6, utilice un contenedor web, en cualquier caso, porque usted puede poner EJB s directamente en una aplicación web. Por ejemplo, si va a implementar en el servidor web Tomcat, que sólo tiene un contenedor web, crear una aplicación web, no un módulo EJB. 1. Elija Archivo> Nuevo Proyecto (Ctrl + Mayúsculas + N en Linux y Windows, + Mayúsculas + N en Mac OS). Seleccione la aplicación web desde la categoría de Java Web o módulo EJB de la categoría de Java EE. Puede crear un servicio web JAX-WS en un proyecto Maven. Elija Archivo> Nuevo Proyecto (Ctrl + Mayúsculas + N en Linux y Windows, + Mayúsculas + N en Mac OS) y luego Maven de aplicaciones Web o Maven módulo EJB de la categoría de Maven. Si usted no ha utilizado Maven con NetBeans antes, ver las mejores prácticas de Maven. 2. Nombre del proyecto CalculatorWSApplication. Seleccione una ubicación para el proyecto. Haga clic en Siguiente.

4 3. Seleccione el servidor y la versión Java EE y haga clic en Finalizar.

5 Para utilizar el servidor de Oracle WebLogic, registrar el servidor en el IDE. Además, si usted está utilizando el servidor WebLogic, ver el screencast de implementar una aplicación Web para Oracle WebLogic. Crear un servicio Web desde una clase Java 1. Haga clic con el CalculatorWSApplication nodo y seleccione Nuevo> Web Service. 2. El nombre del servicio web CalculatorWS y tipo de en el paquete. Deja Crear servicios Web desde cero seleccionado.

6 3. Si va a crear un proyecto Java EE 6 en GlassFish o WebLogic, seleccione Implementar el servicio Web como un bean de sesión sin estado. De forma predeterminada, el servidor web Tomcat no es compatible con Enterprise Java Beans (EJB). Por lo tanto no se puede implementar un servicio web EE6 como un bean de sesión sin estado en una instalación fuera de la caja de Tomcat 7. Sin embargo, ver el proyecto de Apache TomEE (especialmente OpenEJB) para las ampliaciones de Tomcat. 4. Haga clic en Finalizar. La ventana de proyectos muestra la estructura del nuevo servicio web y el código fuente se muestra en el área de edición.

7 Adición de una operación para el servicio Web El objetivo de este ejercicio consiste en añadir al servicio web de una operación que suma dos números recibidos de un cliente. El NetBeans IDE proporciona un cuadro de diálogo para añadir una operación a un servicio web. Puede abrir este diálogo, ya sea en el diseñador visual o servicio web en el menú de contexto del servicio web. Advertencia: El diseñador visual no está disponible en los proyectos de Maven. Para agregar una operación para el servicio web: 1. O bien: o Cambie a la vista Diseño en el editor. 2. Haga clic en Agregar operación, ya sea en el diseñador visual o el menú contextual. El cuadro de diálogo Agregar se abre la Operación.

8 3. En la parte superior de la caja de la Operación de diálogo Agregar, escriba agregar en el nombre y el tipo int en el Tipo de valor devuelto en la lista desplegable. 4. En la parte inferior del cuadro de diálogo Agregar Operación, haga clic en Agregar y crear un parámetro de tipo int llamada i. 5. Haga clic en Agregar nuevo y crear un parámetro de tipo int llamada j. Ahora puede ver lo siguiente:

9 6. Haga clic en Aceptar en la parte inferior del cuadro de diálogo Agregar Operación. Volverá a la editora. 7. Eliminar el valor por defecto hola operación, ya sea mediante la supresión de la hello () método en el código fuente o seleccionando el hola operación en el diseñador visual y haciendo clic en Quitar la Operación. El diseñador visual muestra ahora el siguiente:

10 8. Haga clic en Origen y ver el código que ha generado en los pasos anteriores. Se diferencia si ha creado el servicio como un grano de EE6 apátridas o no. Puede usted ver la diferencia en las capturas de pantalla por debajo? (Un servicio EE6 que no se implementa como un bean sin estado se asemeja a un servicio de EE5).

11 9. En el editor, extender el esqueleto de añadir la operación a la public int add(@webparam(name = "i") int = "j") int j) { int k = i + j; return k; } Como se puede ver en el código anterior, el servicio web se limita a recibir dos números y devuelve su suma. En la siguiente sección, se utiliza el IDE para probar el servicio web. Implementar y probar el servicio Web Después de implementar un servicio web a un servidor, puede utilizar el IDE para abrir el cliente del servidor de prueba, si el servidor tiene un cliente de prueba. El GlassFish y servidores WebLogic proporcionar a los clientes de prueba. Si usted está utilizando el servidor web Tomcat, no hay ningún cliente de prueba. Sólo se puede ejecutar el proyecto y ver si la web Tomcat Servicios de la página se abre. En este caso, antes de ejecutar el proyecto, es necesario hacer que el servicio web del punto de entrada a su solicitud. Para hacer que el servicio web del punto de entrada a su solicitud, haga clic en el nodo del proyecto CalculatorWSApplication y seleccione Propiedades. Abra las propiedades de Ejecutar y escriba CalculatorWS en el campo de dirección URL relativa. Haga clic en Aceptar. Para ejecutar el proyecto, haga clic en el nodo del proyecto de nuevo y seleccione Ejecutar. Para probar la implementación exitosa de un servidor GlassFish o WebLogic: 1. Haga clic con el proyecto y elija Implementar. El IDE se inicia el servidor de aplicaciones, se basa la solicitud, e implementa la aplicación en el servidor. Puedes seguir el progreso de estas operaciones en el CalculatorWSApplication (run-deploy) y el servidor GlassFish o Tomcat pestañas en la vista de salida.

12 2. En la ficha de la IDE de proyectos, expanda el nodo de Servicios Web del proyecto CalculatorWSApplication. Haga clic en el nodo CalculatorWS, y elegir de pruebas de servicio Web. El IDE abre la página de probador en su navegador, si ha implementado una aplicación Web en el servidor GlassFish. Para el servidor web Tomcat y despliegue de módulos EJB, la situación es diferente: Si implementa en el servidor GlassFish, el tipo de dos números en la página de probador, tal como se muestra a continuación:

13 La suma de los dos números en la pantalla: Las muestras Usted puede abrir una versión completa EE6 bean sin estado del servicio de Calculadora seleccionando Archivo> Nuevo proyecto (Ctrl + Mayúsculas + N en Linux y Windows, + Mayúsculas + N en Mac OS) y la navegación de muestras> Servicios Web en Java> Calculadora (EE6 ).

14 Un servicio de calculadora de Maven y un cliente Calculadora de Maven están disponibles en muestras> Maven. Consumir el servicio Web Ahora que ha desplegado el servicio web, es necesario crear un cliente para hacer uso del servicio web de la extensión método.en este caso, se crean tres clientes-una clase de Java en una aplicación Java SE, un servlet y una página JSP en una aplicación web. Nota: Un tutorial más avanzado se centra en los clientes está en desarrollo JAX-WS clientes de servicios Web. Cliente 1: Java Class en Java SE Aplicación En esta sección, puede crear una aplicación estándar de Java. El asistente que se utiliza para crear la aplicación también crea una clase Java. A continuación, utilizar las herramientas del IDE para crear un cliente y consumir el servicio Web que creó en el comienzo de este tutorial. 1. Elija Archivo> Nuevo Proyecto (Ctrl + Mayúsculas + N en Linux y Windows, + Mayúsculas + N en Mac OS). Seleccione la aplicación Java desde la categoría de Java. Nombre del proyecto CalculatorWS_Client_Application. Deja Crear clase principal seleccionada y aceptar todos los valores predeterminados. Haga clic en Finalizar.

15 2. Haga clic con el CalculatorWS_Client_Application nodo y seleccione Nuevo> cliente de servicios Web. El nuevo servicio Web Client se abre el asistente.

16 3. Seleccione Proyecto como la fuente de WSDL. Haga clic en Examinar. Busque el servicio web CalculatorWS en el proyecto CalculatorWSApplication. Cuando haya seleccionado el servicio Web, haga clic en Aceptar.

17 4. No seleccione el nombre del paquete. Deje este campo vacío. 5. Deje los otros valores por defecto y haga clic en Finalizar. La ventana muestra los proyectos del cliente de servicios web nueva, con un nodo para el complemento el método que ha creado:

18 6. Haga doble clic en la clase principal, de modo que se abre en el Editor de código fuente. Arrastre el complemento nodo por debajo de la main () método. Ahora puede ver lo siguiente: Nota: Como alternativa, en lugar de arrastrar el complemento nodo, puede hacer clic derecho en el editor de código y elija Insertar> Operación de llamadas de servicio web. 7. En el main () cuerpo del método, reemplace el comentario TODO con el código que inicializa los valores de i y j, llama a add (), e imprime el resultado. } public static void main(string[] args) { int i = 3; int j = 4; int result = add(i, j); System.out.println("Result = " + result);

19 8. Rodea el main () el código del método con un bloque try / catch que imprime una excepción. 9. Haga clic derecho en el nodo del proyecto y seleccione Ejecutar. La ventana de resultados muestra ahora la suma: Cliente 2: Servlet en aplicaciones Web En esta sección, se crea una nueva aplicación web, después de lo cual se crea un servlet. A continuación, utilizar el servlet para consumir el servicio Web que creó en el comienzo de este tutorial. 1. Elija Archivo> Nuevo Proyecto (Ctrl + Mayúsculas + N en Linux y Windows, + Mayúsculas + N en Mac OS). Seleccione Aplicación Web de la categoría Web Java. Nombre del proyecto CalculatorWSServletClient. Haga clic en Siguiente y luego haga clic en Finalizar.

20

21 2. Haga clic con el CalculatorWSServletClient nodo y seleccione Nuevo> cliente de servicios Web. El nuevo servicio Web asistente de cliente aparece. 3. Seleccione Proyecto como la fuente de WSDL. Haga clic en Examinar. Busque el servicio web CalculatorWS en el proyecto CalculatorWSApplication. Cuando haya seleccionado el servicio Web, haga clic en Aceptar.

22 4. No seleccione el nombre del paquete. Deje este campo vacío

23 5. Deje los otros valores por defecto y haga clic en Finalizar. El Servicio de Referencias Web nodo en la ventana de proyectos muestra la estructura de su nuevo cliente, incluyendo elcomplemento operación que creó anteriormente en este tutorial: 6. Haga clic con el CalculatorWSServletClient nodo del proyecto y elija New Servlet>. Nombre del servletclientservlet y lo coloca en un paquete llamado org.me.calculator.client. Haga clic en Finalizar.

24 7. Para hacer el servlet el punto de entrada a su solicitud, haga clic en el nodo del proyecto CalculatorWSServletClient y seleccione Propiedades. Abra las propiedades de Ejecutar y escriba / ClientServlet en el campo de dirección URL relativa. Haga clic en Aceptar.

25 8. Si no hay iconos de error para ClientServlet.java, haga clic en el nodo del proyecto y seleccione limpiar y construir. 9. En el Editor de código fuente, arrastre el complemento la operación en cualquier parte del cuerpo de la ClientServletclase. El complemento () el método aparece al final del código de la clase. 10. En el processrequest () método, agregar algunas líneas en blanco después de esta línea: out.println ("<h1> ClientServlet Servlet en" + request.getcontextpath () + "</ h1>");

26 11. Agregue el código que inicializa los valores de i y j, llama a add (), e imprime el resultado. El código agregado está en negrita :

27 12. Haga clic derecho en el nodo del proyecto y seleccione Ejecutar. El servidor se inicia, la aplicación está desarrollada y desplegada, y el navegador se abre y muestra el resultado del cálculo, como se muestra a continuación: Cliente 3: Página JSP en aplicaciones Web En esta sección, se crea una nueva aplicación web y luego consumir el servicio web en la página por defecto JSP que el asistente de aplicaciones Web crea. Nota: Si desea ejecutar una aplicación cliente web de JSP en Oracle WebLogic, consulte Ejecución de un Java Server Faces 2.0 Aplicación en WebLogic. 1. Elija Archivo> Nuevo Proyecto (Ctrl + Mayúsculas + N en Linux y Windows, + Mayúsculas + N en Mac OS). Seleccione Aplicación Web de la categoría Web Java. Nombre del proyecto CalculatorWSJSPClient. Haga clic en Finalizar.

28 2. Haga clic con el CalculatorWSJSPClient nodo y seleccione Nuevo cliente de servicios Web>. 3. Seleccione Proyecto como la fuente de WSDL. Haga clic en Examinar. Busque el servicio web CalculatorWS en el proyecto CalculatorWSApplication. Cuando haya seleccionado el servicio Web, haga clic en Aceptar. 4. No seleccione el nombre del paquete. Deje este campo vacío.

29 5. Deje los otros valores por defecto y haga clic en Finalizar. La ventana de proyectos muestra el cliente de servicio Web, como se muestra a continuación: 6. En el Servicio de Referencias Web nodo, expanda el nodo que representa el servicio web. El complemento operación, que se invoca desde el cliente, se encuentra expuesto. 7. Arrastre el complemento de la operación del cliente index.jsp página y colóquelo debajo de las etiquetas H1. El código para invocar la operación del servicio se genera ahora en el index.jsp página, como se puede ver aquí:

30 Cambie el valor de i y j entre 0 y enteros, tales como 3 y 4. Vuelva a colocar la comentada línea de TODO en el bloque catch con out.println ("excepción" + ex);. 8. Haga clic derecho en el nodo del proyecto y seleccione Ejecutar. El servidor se inicia, si no se estaba ejecutando ya. La aplicación está desarrollada y desplegada, y el navegador se abre y muestra el resultado del cálculo: