WSDL (Web Service Defini/on Language)

Transcripción

1 WSDL

2 WSDL (Web Service Defini/on Language)

3 Autodescripción del Servicio Web h"p:// Lenguaje para la descripción estándar de un Servicio Web. Tecnología XML que estandariza la representación de los parámetros de entrada y de salida que provienen de una invocación externa y permite a los diferentes clientes entender automá/camente cómo interactuar con el Servicio Web. ar Independencia de Lenguaje y Plataforma.

4 Estructura de un Documento WSDL (I) 8 Elementos: <defini/ons> <types> <message> <porttype> <opera/on> <binding> <service> <port>

5 Estructura de un Documento WSDL (II) Los documentos WSDL constan de dos partes: Definición de la Interfaz del Servicio: Tipos (Types): Esquemas XML que describen los /pos de datos u/lizados. Mensaje (Message): Descripción del mensaje. Tipo del Puerto (porttype): Especificación del conjunto de operaciones soportadas por un punto final de un Servicio Web.

6 Estructura de un Documento WSDL (III) Definición de la Implementación del Servicio: Enlaces (Binding): Especifica como se enlaza una operación con un protocolo (hqp, smtp,...) y un modo de comunicación (transferencia de documento, RPC,...). Servicio (Service): Representa a la localización exacta de un Servicio Web para poder ser accedido.

7 Documento WSDL - Servicio Web HolaPersona.java public class HolaPersona { public String hola(persona p) { return "Hola "+p.getnombre()+" "+p.getapellidos()+ " empleado de "+p.getempresa()+", Bienvenido a Axis!!!"; } } Persona.java public class Persona { private String nombre; private String apellidos; private String empresa; public String getnombre() { return nombre; } public void setnombre(string n) { nombre=n; } public String getapellidos() { return apellidos; } public void setapellidos(string a) { apellidos=a; } public String getempresa() { return empresa; } public void setempresa(string e) { empresa=e; } }

8 Documento WSDL - <defini/ons> Contenedor de la descripción del servicio. Contendra las declaraciones globales de espacios de nombres empleados en el documento. <definitions> <! Declaración types--> <! Declaración message--> <! Declaración porttype--> <! Declaración binding--> <! Declaración service--> </definitions>

9 Documento WSDL - <types> Contendra las declaraciones globales de espacios de nombres empleados en el documento. <types> <complextype name="persona"> <sequence> <element name="nombre nombre type= string" /> <element name="apellidos type= string" /> <element name="empresa type= string" /> </sequence> </complextype> </schema> </types>

10 Documento WSDL - <message> Modela los datos que se intercambiarán en las pe/ciones y respuestas de los Servicios Web. Con/ene uno o más subelementos de /po <part> que iden/fican a los datos individuales y sus /pos, que forman parte del mensaje de datos. <messagename="holarequest"> l R q " <part name="p" type= Persona" /> </message> <messagename="holaresponse"> p <part name="holareturn" type= string" /> </message>

11 Documento WSDL - <porttype> Especifica un conjunto de operaciones soportadas por un punto final de un Servicio Web. Con/ene subelementos de /po <opera/on> que representa a las operaciones (como la declaración de métodos en una clase). Dentro de la operación se definen parámetros de entrada <input> o salida <output>, que son mensajes previamente definidos con la e/queta <message>. <porttype name="holapersona"> <operation name="hola" parameterorder="p"> <input message= holarequest" name="holarequest" /> <output message= holaresponse" name="holaresponse" /> </operation> </porttype>

12 Documento WSDL - <porttype> Mensajes en un sen/do Pe/ción/Respuesta Pe/ción/N*Respuesta No/ficación Solicitud respuesta a Cliente SOAP ntido sta Mensaje SOAP Mensaje Petición SOAP Mensaje Respuesta SOAP Mensaje Petición SOAP Mensaje Respuesta SOAP... Mensaje Respuesta SOAP Mensaje SOAP Servidor SOAP Mensaje SOAP Mensaje Respuesta SOAP

13 Documento WSDL - <binding> El elemento <binding> especifica un protocolo (HTTP, SOAP, MIME o uno nuevo) y un formato de datos concreto para un elemento <porttype>. Cada elemento <binding> /ene subelementos de /po <opera/on> que indica si los mensajes van en la cabecera, en el cuerpo, como dato adjunto,..., que están codificados, etc.

14 Documento WSDL - <binding> <binding name="holapersonasoapbinding" type= HolaPersona"> <binding style="rpc" transport=" / <operation name="hola"> <operation soapaction="" /> <input name="holarequest"> q <body encodingstyle=" /> </input> <output name="holaresponse"> p <body encodingstyle=" /> </output> </operation> </binding> máster online en Dirección e Ingeniería de Sitios Web

15 Documento WSDL - <service> Iden/fica a un Servicio Web concreto. Con/ene uno o más subelementos <port> que representan a un punto final. <service name="holapersonaservice"> <port binding= HolaPersonaSoapBinding" name="holapersona"> <address location=" </port> </service>

16 Prac/ca 2 1. Ponga en funcionamiento la prác/ca que se presenta a con/nuación. 2. Posteriormente, cree su propio servicio web y genere automá/camente su documento wsdl. 3. Localice un servicio web de xmethods.org y cree un cliente a par/r de su documento wsdl y ejecútelo. 4. Por úl/mo, haga un manual de los pasos que ha ido realizando y resultados en los apartados 2 y 3 (incluya pantallazo de cada paso). Debera enviar este manual.

17 Prác/ca 2 Netbeans Herramienta: Netbeans: h"p://

18 Prác/ca 2 Pasos 1. Generar WSDL de un Servicio Web 2. Consulta de Servicios Web en Internet 3. Crear un cliente a par/r del WSDL

19 Prác/ca Generar WSDL U/lizar el proyecto creado en la prác/ca1 (ver prác/ca 1.1 y 1.2) 1 2

20 <?xml version="1.0" encoding="utf- 8" standalone="yes"?> <!- - Generated by JAX- WS RI at hqp://jaxws.dev.java.net. RI's version is Metro/ (tags/ 2.2.0u1-7139; T10:55: ) JAXWS- RI/ JAXWS/2.2 svn- revision#unknown. - - > <defini/ons targetnamespace="hqp://serviciosweb/" name="holaws" xmlns="hqp:// schemas.xmlsoap.org/wsdl/" xmlns:wsp="hqp:// policy" xmlns:tns="hqp:// serviciosweb/" xmlns:xsd="hqp:// xmlns:wsp1_2="hqp:// schemas.xmlsoap.org/ws/2004/09/policy" xmlns:soap="hqp://schemas.xmlsoap.org/wsdl/soap/" xmlns:wsam="hqp:// xmlns:wsu="hqp://docs.oasis- open.org/wss/2004/01/oasis wss- wssecurity- u/lity- 1.0.xsd"> <types> <xsd:schema> <xsd:import namespace="hqp://serviciosweb/" schemaloca/on="holaws_schema1.xsd"/> </xsd:schema> </types> <message name="hello"> <part name="parameters" element="tns:hello"/> </message> <message name="helloresponse"> <part name="parameters" element="tns:helloresponse"/> </message> <message name="hola"> <part name="parameters" element="tns:hola"/> </message> <message name="holaresponse"> <part name="parameters" element="tns:holaresponse"/> </message>

21 <porttype name="holaws"> <opera/on name="hello"> <input wsam:ac/on="hqp://serviciosweb/holaws/hellorequest" message="tns:hello"/> <output wsam:ac/on="hqp://serviciosweb/holaws/helloresponse" message="tns:helloresponse"/> </opera/on> <opera/on name="hola"> <input wsam:ac/on="hqp://serviciosweb/holaws/holarequest" message="tns:hola"/> <output wsam:ac/on="hqp://serviciosweb/holaws/holaresponse" message="tns:holaresponse"/> </opera/on> </porttype> <binding name="holawsportbinding" type="tns:holaws"> <soap:binding transport="hqp://schemas.xmlsoap.org/soap/hqp" style="document"/> <opera/on name="hello"> <soap:opera/on soapac/on=""/> <input> <soap:body use="literal"/> </input> <output> <soap:body use="literal"/> </output> </opera/on> <opera/on name="hola"> <soap:opera/on soapac/on=""/> <input> <soap:body use="literal"/> </input> <output> <soap:body use="literal"/> </output> </opera/on> </binding> <service name="holaws"> <port name="holawsport" binding="tns:holawsportbinding"> <soap:address loca/on="replace_with_actual_url"/> </port> </service> </defini/ons>

22 Prác/ca 2.2 Consultar Servicios Web en Internet (I) hqp://

23 Prác/ca 2.2 Consultar Servicios Web en Internet (I)

26 Prác/ca 2.2 Consultar Servicios Web en Internet (I) hqp://

29 Prác/ca 2.2 Consultar Servicios Web en Internet (II) máster online Direcci Ingenie de Sitio Web

30 Prác/ca 2.2 Consultar Servicios Web en Internet (II) máster online en Dirección e Ingeniería de Sitios Web url del wsdl:

31 Prác/ca 2.2 Consultar Servicios Web en Internet (II) máster online en Dirección Ingeniería de Sitios Web Spain Coordinador: Dr. Javier Parra Fuente

32 Prác/ca 2.2 Consultar Servicios Web en Internet (III) hqp:// repository.com/

33 Prác/ca 2.2 Consultar Servicios Web en Internet (III) hqp:// repository.com/service/overview/

34 Prác/ca 2.2 Consultar Servicios Web en Internet (III) hqp://peopleask.ooz.ie/soap.wsdl

35 Prác/ca 2.2 Consultar Servicios Web en Internet (III)

36 Prác/ca 2.2 Consultar Servicios Web en Internet (III)

37 Prác/ca 2.3 Crear Cliente a par/r del WSDL Previo: crear un proyecto web (verprác/ca1.1) Crear un cliente del servicio web

38 Prác/ca 2.3 Crear Cliente a par/r del WSDL Generación automá/ca de las clases necesarias para llamar al servicio web

39 Prác/ca 2.3 Crear Cliente a par/r del WSDL 1 We 3 Ing de We

40 Prác/ca 2.3 Crear Cliente a par/r del WSDL <%@page contenttype="text/html" pageencoding="utf- 8"%> <!DOCTYPE html> <html> <head> <meta hqp- equiv="content- Type" content="text/html; charset=utf- 8"> </tle>jsp Page<//tle> </head> <body> <h1>información de la URL</h1> <%- - start web service invoca/on - - %><hr/> <% try { net.webservicex.whois service = new net.webservicex.whois(); net.webservicex.whoissoap port = service.getwhoissoap(); // TODO ini/alize WS opera/on arguments here java.lang.string hostname = "udistrital.edu.co"; // TODO process result here java.lang.string result = port.getwhois(hostname); out.println("result = "+result); } catch (Excep/on ex) { // TODO handle custom excep/ons here } %> <%- - end web service invoca/on - - %><hr/> </body> </html>

41 Prác/ca 2.3 Crear Cliente a par/r del WSDL Ejecución del proyecto

42 Prác/ca 2.3 Crear Cliente a par/r del WSDL Ejecución del proyecto

43 Direcci Ingenie de Sitio Web Prác/ca 2.3 Crear Cliente a par/r del WSDL (II) url del wsdl: tb l t /d t /i f Coordinador: Dr. Javier Parra Fuente

44 Prác/ca 2.3 Crear Cliente a par/r del WSDL (II)

45 Prác/ca 2.3 Crear Cliente a par/r del WSDL (II) 1 online Direcci Ingenie de Sitio Web 3 4 2

46 Prác/ca 2.3 Crear Cliente a par/r del WSDL (II) Añade el Código Automá/camente <% try { eu.dataaccess.footballpool.info service = new eu.dataaccess.footballpool.info(); eu.dataaccess.footballpool.infosoaptype port = service.getinfosoap(); // TODO ini/alize WS opera/on arguments here java.lang.string scountryname = ""; // TODO process result here eu.dataaccess.footballpool.arrayofstring result = port.alldefenders(scountryname); out.println("result = "+result); } catch (Excep/on ex) { // TODO handle custom excep/ons here } %>

47 Prác/ca 2.3 Crear Cliente a par/r del WSDL (II) Modificar el Código Generado <%@page import="java.u/l.list"%> <% try { eu.dataaccess.footballpool.info service = new eu.dataaccess.footballpool.info(); eu.dataaccess.footballpool.infosoaptype port = service.getinfosoap(); // TODO ini/alize WS opera/on arguments here java.lang.string scountryname = "Spain"; // TODO process result here eu.dataaccess.footballpool.arrayofstring result = port.alldefenders(scountryname); List <String> lista = result.getstring(); for (String jugador : lista) { out.println("nombre: " + jugador + "<br>"); } } catch (Excep/on ex) { // TODO handle custom excep/ons here } %>

48 Prác/ca 2.3 Crear Cliente a par/r del WSDL (II) Ejecución del proyecto