Manual de creación de WSDL y manual de uso de un SOA Web Service usando su WSDL

50 %
50 %
Information about Manual de creación de WSDL y manual de uso de un SOA Web Service usando...

Published on September 27, 2015

Author: HectorGarduoReal

Source: slideshare.net

1. Por: Héctor Garduño Real Máster en Dirección e Ingeniería de Sitios Web Servicios Web y Arquitecturas REST 01 de febrero de 2015 Página 1 de 8 Manual de creación de WSDL y uso de un SOA Web Service usando un WSDL 1. CREACIÓN DE UN ARCHIVO WSDL Web Service Description Language (WSDL) es un archivo creado usando lenguaje XML con el fin de describir un servicio web y las ope- raciones que puede negociar, con el fin de que cualquier otra aplicación lo entienda y pueda hacer peticiones. Crear un WSDL para un servicio web desarrollo desde Net- Beans es bastante fácil, simplemente se debe dar clic derecho en el ser- vicio web y en el menú contextual desplegado elegir la opción “Gene- rate and Copy WSDL…”, lo cual abrirá un cuadro de dialogo para in- dicar la ubicación en donde será copiado el archivo wsdl. Lo ideal es ubicar este archivo en el directorio raíz del sitio web para que así sea más fácil de localizar por los clientes, en este caso debe elegirse la ubi- cación “web”. Si se visualiza el archivo wsdl que ha generado el API JAX-WS, se mostrará la estructura XML como la que se muestra a continuación acompañado del XML Schema. Pantalla 1. Generar un WSDL Pantalla 2. Elegir ruta del wsdl Pantalla 3. Archivos creados Pantalla 4. Generación exitosa del WSDL

2. Por: Héctor Garduño Real Máster en Dirección e Ingeniería de Sitios Web Servicios Web y Arquitecturas REST 01 de febrero de 2015 Página 2 de 8 Pantalla 5. Archivo wsdl de un servicio web Pantalla 6. Archivo xsd con el Schema para validar la estructura del wsdl

3. Por: Héctor Garduño Real Máster en Dirección e Ingeniería de Sitios Web Servicios Web y Arquitecturas REST 01 de febrero de 2015 Página 3 de 8 2. USO DE UN SERVICIO WEB REMOTO CON SOAP + WSDL Para la realización de este manual se hará uso de un servicio web llamado “CurrencyConvertor” que devuelve la tasa de cambio actual de una amplia variedad de monedas, el servicio web se encuentra disponible en http://www.webservicex.net/CurrencyConvertor.asmx. Haciendo uso de él, se creara una calculadora que haga la conversión de una cifra de dinero. 2.1. Creación del nuevo proyecto Una vez abierto NetBeans se debe crear un nuevo proyecto el cual contendrá el sitio web de la aplicación y el servicio web. Para ello se debe dirigir al menú superior y dar clic en “File”, posteriormente dar clic en “New Project…” lo cual abrirá un cua- dro de diálogo. Ya que lo que se pretende es usar un servicio web, al crear el proyecto, en el primer paso (Elección del proyecto) se debe elegir la categoría “Java Web” y del lado derecho, en tipos de proyectos seleccionar “Web Application”. Una vez hecho esto es necesario dar clic en el botón [Next] para continuar con el proceso. El segundo paso solicitará el nombre del pro- yecto que se le designará al proyecto, en este caso se nombrará como “CalculadoraDeDivisas.com”. Opcio- nalmente se puede definir otra ubicación para guardar el proyecto usando el botón [Browse…], teniendo en cuenta el cambio de ruta no afectará al proyecto. Así mismo, al invocar el servicio web se producirán depen- dencias de librerías, y en caso de que se deseen ubicarlas en una carpeta en específico habrá que activar e indicar la ubicación para almacenarlas. Una vez definidos los parámetros deberá darse clic en el botón [Next >]. El tercer paso se debe definir el servidor sobre el que se ejecutará el servicio web así como la versión de Java EE que se desee usar para el desarrollo. Si se emplea la última versión de NetBeans se pueden em- plear los valores por defecto, es decir, servidor web “GlasFish Server 4.1” y la plataforma “Java EE 7 Web” y dar clic en el botón [Next >]. Pantalla 7. Creación de un nuevo proyecto Pantalla 8. Elección de tipo de proyecto a crear Pantalla 9. Nombrado y localización del proyecto

4. Por: Héctor Garduño Real Máster en Dirección e Ingeniería de Sitios Web Servicios Web y Arquitecturas REST 01 de febrero de 2015 Página 4 de 8 En el cuarto y último paso se debe indicar si se desea emplear un framework para el desarrollo del pro- yecto, pero ya que este manual aborda un ejemplo bá- sico, no es necesario hacer la selección de ninguno de ellos, con lo cual se puede dar clic en el botón [Finish] para que comience la generación del proyecto, es decir, la estructura de carpetas y archivos esenciales necesarios del proyecto. Una vez finalizada la creación del pro- yecto, deberá aparecer el proyecto recién creado en el panel izquierdo dentro de la pestaña “Projects”. 2.2. Enlazar el proyecto con un servicio web remoto Para hacer uso de un servicio web serán necesario enlazarlo, para lo cual se debe dar clic derecho so- bre el proyecto, posicionarse sobre “New” y luego dar clic en “Web Service Client…”, si esta opción no aparece deberá seleccionarse “Other…” y bus- carse manualmente. En el nuevo cuadro de diálogo que se abre deberá elegirse la opción “WSDL URL:” y en el campo la dirección http://www.webservi- cex.net/CurrencyConvertor.asmx?WSDL que per- tenece al servicio web en cuestión. Posteriormente se debe indicar el nombre del paquete para guardar las clases requeridas para hacer uso del servicio web, para este ejemplo se usará como nombre el mismo nombre del servicio web, es decir “Cu- rrencyConvertor”, para finalmente dar clic en el botón [Finish]. Si la vinculación del servicio web se Pantalla 10. Configuración del entorno Pantalla 11. Estructura del proyecto recién creadoPantalla 12. Frameworks del nuevo proyecto Pantalla 13. Creación de nuevo servicio web cliente Pantalla 14. Definiendo el servicio web que se usará

5. Por: Héctor Garduño Real Máster en Dirección e Ingeniería de Sitios Web Servicios Web y Arquitecturas REST 01 de febrero de 2015 Página 5 de 8 realiza correctamente deberá aparecer en el panel de proyectos los nue- vos elementos como se muestra en la siguiente imagen. 2.3. Creación de página web JSP Por defecto el proyecto creará una página web estática con extensión html que se ubica en “Web Pages”, sin embargo ésta no servirá para invocar el servicio web, sino que se debe usar una página activa de java con extensión jsp, la cual permite generar de forma dinámica contenido. Así pues, para no tener archivos innecesarios, “index.html” será bo- rrado dando clic derecho sobre él y seleccionando “delete”. A continuación se creará una página activa de java, para lo cual se puede dar clic dere- cho sobre el proyecto, posicionarse sobre “New” para después dar clic so- bre “JSP…”. Esto abrirá un cuadro de diálogo para especificar el nombre del nuevo archivo, el cual se nombrará como “index” con el fin de que sea la pá- gina de inicio. Se usaran las opciones por defecto por lo que no se seleccionara otra carpeta y será un “JSP File”. Posteriormente se dará clic en el botón [Fi- nish] lo que provocara que se cree el archivo donde anteriormente se encontraba index.html. 2.4. Creación de la estructura HTML de la página web Para dar un poco de diseño a la página se usará el siguiente código HTML, el cual es muy básico pero se busca no saturar este manual con código. Como se puede observar en la siguiente hoja, se han reservado dos espacios, uno para el diseño usando CSS y otro para el Servicio Web. Adicionalmente se omitieron muchas divisas para visualizar un código más corto. Pantalla 15. Vinculación co- rrecta del servicio web Pantalla 16. Crear una página JSP

6. Por: Héctor Garduño Real Máster en Dirección e Ingeniería de Sitios Web Servicios Web y Arquitecturas REST 01 de febrero de 2015 Página 6 de 8 Pantalla 17. Código HTML de la página web cliente Este código debería visualizar una página similar a la siguiente. Pantalla 18. Página web con solamente HTML 2.5. Incrustar y configurar el servicio web en la página JSP Ya que se ha reservado un espacio a partir de la línea de código 26, ahí será donde incrustará el código Java que se encargará de realizar la ne- gociación con el servicio web. Para incrustar el servicio web solo hará falta expandir el panel del proyecto hasta llegar al método deseado, una vez ubicado, arrastrarlo a la línea de código deseada para que se genere el código automáti- camente. Pantalla 19. Arrastrar soltar el método en la línea deseada

7. Por: Héctor Garduño Real Máster en Dirección e Ingeniería de Sitios Web Servicios Web y Arquitecturas REST 01 de febrero de 2015 Página 7 de 8 El código generado automáticamente debería ser el siguiente Pantalla 20. Código generado automáticamente al insertar el método del servicio web Y el cual ha sido adaptado para tomar los datos del formulario, pasarlos al servicio web y tomar el resultado para desplegarlo acompañado de unas etiquetas HTML. Pantalla 21. Código que comunica con el servicio web, pasa los datos y obtiene el resultado 2.6. Agregar diseño a la página Si se desea agregar un poco de diseño a la página, se deberá agregar en la línea de código 14 reservada para tal fin el código mostrado a continuación. Pantalla 22. Estilos CSS para aplicar diseño a la página

8. Por: Héctor Garduño Real Máster en Dirección e Ingeniería de Sitios Web Servicios Web y Arquitecturas REST 01 de febrero de 2015 Página 8 de 8 2.7. Probando la calculadora de divisas Pantalla 23. Inserción de datos en el formulario Pantalla 24. Resultado del servicio web ya procesado y maquetado

Add a comment