servicios web xml
TRANSCRIPT
5 Servicios Web XML. 5.1 Visión general de servicios Web XML. 5.2 Tecnologías subyacentes. 5.2.1 SOAP 5.2.2 WSDL 5.2.3 UDDI 5.3 Publicación de un servicio WEB. 5.4 Consumo de un servicio WEB.
5.1 Visión general de servicios Web XML.
Los servicios Web XML son un conjunto de aplicaciones o de tecnologías con capacidad para interoperar en la Web. Estas aplicaciones o tecnologías intercambian datos entre sí con el objetivo de ofrecer unos servicios. Los proveedores ofrecen sus servicios como procedimientos remotos y los usuarios solicitan un servicio llamando a estos procedimientos a través de la Web, por lo que estos servicios deben estar alojados en un servidor Web. Los servicios Web XML permiten el manejo distribuido de componentes, estos permiten tomar ventaja de la infraestructura de Internet para la distribución de funcionalidad y paquetes de datos. Las principales características de los servicios Web XML son:
Están basados en protocolos estándar para la Web. Los servicios Web XML realizan las peticiones y proporcionan las respuestas utilizando protocolos estándar de la Web, como los son HTTP (Hyper Text Transfer Protocol), XML (Extensible Markup Language), y SOAP (Simple Object Access Protocol), toda plataforma que maneje dichos protocolos, podrá aprovechar la funcionalidad de los servicios Web XML.
Comunicación de aplicación a aplicación basada en Internet. Al utilizar un servicio Web XML no se tienen una interfaz de usuario visible; realmente se trata de un componente que puede ser consumido de manera programática de aplicación a aplicación. Los servicios Web XML proporcionan una interfaz estándar para la recepción de peticiones y envío de respuesta, denominada contrato, dicho contrato pone a disposición de los usuarios la información requerida por el componente, describe los comportamientos del mismo, y relaciona los datos de entrada con la salida del componete.
Independencia del lenguaje. Los servicios Web XML pueden ser consumidos desde programas escritos en cualquier lenguaje .NET, por lo cual no es necesario aprender un lenguaje determinado para poder tener acceso a su funcionalidad.
Independencia de la plataforma. Independientemente de la plataforma que dispongan los clientes de una aplicación, el contrato se encarga de hacer la petición en un formato estándar, y de recibir la respuesta correspondiente.
Arquitectura libre del manejo de estados (stateless architecture). Los servicios Web XML no manejan estados de objetos; cada respuesta brindada por un servicio Web XML es una nueva instancia de un objeto, con su estado particular. Lo que una petición realiza no impacta lo realizado por otras peticiones.
Comunicación síncrona y asíncrona. El requerimiento de ejecución de un método de servicio Web XML, y el requerimiento de la respuesta, son independientes. La aplicación que consume el servicio Web XML, y el servicio Web XML mismo, pueden operar con mayor disponibilidad, ya que liberan recursos mientras se está en tiempo de espera.
Las aplicaciones intercambian datos entre sí en un medio ambiente seguro usando XML signature y XML encryption, XML signature ofrece servicios de integridad y autenticación de mensajes para los datos, XML encryption es el proceso para codificar datos de tal manera que usuarios no autenticados no puedan entenderlos.
Los principales usos que tienen los servicios Web XML son los siguientes:
Cuando se requiere compartir funcionalidad libre de interfaz de usuario. Los servicios Web son útiles en cuando se desea consumir la funcionalidad de un componente, sin la intermediación de una interfaz de usuario. Ejemplos de esto es el consumo de servicios que proporcionan información, como tipos de cambio, estado del clima, precios de productos, disponibilidad de lugares en eventos, sin tener que responder a alguna interfaz de usuario.
Cuando se quiere comercializar un servicio de uso de software, y no un producto de software. En el futuro, no se venderá software, sino la funcionalidad que el software brinda estará disponible como servicio en la Web.
Cuando el equipo cliente y servidor requieren compartir funcionalidad en Internet, pero difieren en su plataforma operativa.
5.2 Tecnologías subyacentes. Las especificaciones que se han desarrollado para implementar los servicios Web se presentan como una pila de tecnologías donde las especificaciones superiores hacen uso de las inferiores, como se muestra en la figura 5.1.
Figura 5.1
5.2.1 SOAP (Simple Object Access Protocol).
Para ser capaces de comunicarse entre sí, un servicio Web y una aplicación cliente deben concordar sobre un protocolo común. SOAP es un protocolo estándar de comunicación para intercambiar información en un formato estructurado en un medio ambiente distribuido. La información intercambiada entre la aplicación cliente y el servicio Web es llamado mensaje. Los mensajes incluyen las llamadas hechas por una aplicación cliente a un método Web y los datos retornados por el método Web al cliente. Cuando una aplicación cliente hace una solicitud a un método Web, un paquete SOAP es creado. Este paquete contiene el nombre del método Web invocado y los parámetros pasados al método Web en un formato XML. Esta información es usada para invocar el método Web con los parámetros apropiados. Cuando el paquete SOAP llega al servidor Web en el cual reside el servicio Web, el nombre del método Web y sus parámetros son extraídos del paquete SOAP y el método Web apropiado es invocado.
SOAP especifica lo siguiente:
Un formato de mensaje para una comunicación unidireccional, describiendo cómo se empaqueta la información en documentos XML.
Un conjunto de convenciones para usar mensajes SOAP para implementar el patrón de interacción RPC (Remote Procedure Call), definiendo cómo los clientes pueden invocar un Procedimiento Remoto enviando un mensaje SOAP y cómo los servicios pueden responder enviando otro mensaje al llamador.
Un conjunto de reglas que una entidad que procesa mensajes SOAP debe seguir, definiendo en particular los elementos XML que una entidad debe leer y entender, así como las acciones que deben tomar si no entienden el contenido, estas reglas son llamadas: Reglas de Codificación de los Datos.
Una descripción de cómo se debe transportar un mensaje SOAP sobre HTTP y SMTP. Cada mensaje contiene los siguientes elementos:
Elemento envelope, este es el elemento raíz de un documento SOAP, este elemento contiene los elementos header y body del mensaje SOAP, este elemento es obligatorio.
Elemento header, este elemento es opcional y da al servidor información extra, como autenticación y manejo de transacciones.
Elemento body, este elemento es obligatorio que contiene datos concretos del mensaje SOAP, este elemento contiene información tal como nombre del método, parámetros, y los valores en la invocación del método.
Elemento fault, este elemento es utilizado para determinar si existe algún error en el mensaje SOAP y no desplegar mensajes de error.
La cabecera y el cuerpo pueden tener múltiples subpartes en forma de bloques de la cabecera y bloques del cuerpo. Cuando una aplicación cliente hace una solicitud a un método Web, un paquete SOAP es creado. Este paquete contiene el nombre del método Web que es invocado, y los parámetros que son pasados al método Web en un formato XML. Cuando el paquete SOAP llega al servidor Web en el cual reside el servicio Web, el método Web y sus parámetros son extraídos del paquete SOAP y el método es invocado. Este son unos ejemplos de una solicitud SOAP. En esta liga se puede revisar un servicio Web que proporciona información del clima http://www.webservicex.net/globalweather.asmx?op=GetWeather Esta es la solicitud del servicio de clima:
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-
instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<GetWeather xmlns="http://www.webserviceX.NET">
<CityName>string</CityName>
<CountryName>string</CountryName>
</GetWeather>
</soap:Body>
</soap:Envelope>
Esta es la respuesta del servicio de clima:
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-
instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<GetWeatherResponse xmlns="http://www.webserviceX.NET">
<GetWeatherResult>string</GetWeatherResult>
</GetWeatherResponse>
</soap:Body>
</soap:Envelope>
5.2.2 WSDL (Web Services Description Language). El Lenguaje de Descripción. WSDL es un lenguaje estándar basado en XML, que define como los servicios Web XML son descritos cuando son publicados en un registro. La información del servicio Web XML es publicada en registros como documentos WSDL. El documento WSDL es un archivo XML que incluye el esquema de interfaz del servicio Web XML. WSDL reconoce los métodos que son intercambiados entre el proveedor del servicio Web XML y el consumidor del servicio Web XML. Un documento WSDL proporciona información a los clientes de cómo acceder a los
servicios Web XML. WSDL proporciona la información usando varios elementos. Estos elementos de un archivo WSDL incluyen lo siguiente:
Types. Define los tipos de datos utilizados para el intercambio de mensajes entre el consumidor y el servicio.
Message. Describe los mensajes que serán comunicados entre el consumidor y el servicio.
portType. Identifica el conjunto de operaciones que realiza el servicio, y los mensajes involucrados en dichas operaciones.
Binding. Específica los detalles de protocolo para el intercambio de mensajes entre las operaciones, describiendo cómo traducir contenido abstracto a un formato estándar.
Service. Agrupa aquellos puertos que estén relacionados, y que implementan un servicio Web.
Para poder ver un documento WSDL utilizamos el mismo servicio de clima utilizado anteriormente y lo invocamos agregándole ?WSDL al final del URL http://www.webservicex.net/globalweather.asmx?WSDL
El documento WSDL obtenido es el siguiente:
<?xml version="1.0" encoding="utf-8" ?>
<wsdl:definitions xmlns:http="http://schemas.xmlsoap.org/wsdl/http/"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:s="http://www.w3.org/2001/XMLSchema"
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:tns="http://www.webserviceX.NET"
xmlns:tm="http://microsoft.com/wsdl/mime/textMatching/"
xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/"
targetNamespace="http://www.webserviceX.NET"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
<wsdl:types>
<s:schema elementFormDefault="qualified"
targetNamespace="http://www.webserviceX.NET">
<s:element name="GetWeather">
<s:complexType>
<s:sequence> <s:element minOccurs="0" maxOccurs="1" name="CityName" type="s:string"
/> <s:element minOccurs="0" maxOccurs="1" name="CountryName"
type="s:string" /> </s:sequence>
</s:complexType>
</s:element>
<s:element name="GetWeatherResponse">
<s:complexType>
<s:sequence> <s:element minOccurs="0" maxOccurs="1" name="GetWeatherResult"
type="s:string" /> </s:sequence>
</s:complexType>
</s:element>
<s:element name="GetCitiesByCountry">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="CountryName"
type="s:string" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="GetCitiesByCountryResponse">
<s:complexType>
<s:sequence>
<s:element minOccurs="0" maxOccurs="1" name="GetCitiesByCountryResult"
type="s:string" />
</s:sequence>
</s:complexType>
</s:element>
<s:element name="string" nillable="true" type="s:string" />
</s:schema>
</wsdl:types>
<wsdl:message name="GetWeatherSoapIn"> <wsdl:part name="parameters" element="tns:GetWeather" />
</wsdl:message>
<wsdl:message name="GetWeatherSoapOut">
<wsdl:part name="parameters" element="tns:GetWeatherResponse" />
</wsdl:message>
<wsdl:message name="GetCitiesByCountrySoapIn">
<wsdl:part name="parameters" element="tns:GetCitiesByCountry" />
</wsdl:message>
<wsdl:message name="GetCitiesByCountrySoapOut">
<wsdl:part name="parameters" element="tns:GetCitiesByCountryResponse"
/>
</wsdl:message>
<wsdl:message name="GetWeatherHttpGetIn">
<wsdl:part name="CityName" type="s:string" />
<wsdl:part name="CountryName" type="s:string" />
</wsdl:message>
<wsdl:message name="GetWeatherHttpGetOut"> <wsdl:part name="Body" element="tns:string" />
</wsdl:message>
<wsdl:message name="GetCitiesByCountryHttpGetIn"> <wsdl:part name="CountryName" type="s:string" />
</wsdl:message>
<wsdl:message name="GetCitiesByCountryHttpGetOut">
<wsdl:part name="Body" element="tns:string" /> </wsdl:message>
<wsdl:message name="GetWeatherHttpPostIn">
<wsdl:part name="CityName" type="s:string" />
<wsdl:part name="CountryName" type="s:string" />
</wsdl:message>
<wsdl:message name="GetWeatherHttpPostOut"> <wsdl:part name="Body" element="tns:string" />
</wsdl:message>
<wsdl:message name="GetCitiesByCountryHttpPostIn"> <wsdl:part name="CountryName" type="s:string" />
</wsdl:message>
<wsdl:message name="GetCitiesByCountryHttpPostOut"> <wsdl:part name="Body" element="tns:string" />
</wsdl:message>
<wsdl:portType name="GlobalWeatherSoap">
<wsdl:operation name="GetWeather">
<documentation xmlns="http://schemas.xmlsoap.org/wsdl/">Get weather
report for all major cities around the world.</documentation>
<wsdl:input message="tns:GetWeatherSoapIn" />
<wsdl:output message="tns:GetWeatherSoapOut" />
</wsdl:operation>
<wsdl:operation name="GetCitiesByCountry"> <documentation xmlns="http://schemas.xmlsoap.org/wsdl/">Get all major
cities by country name(full / part).</documentation> <wsdl:input message="tns:GetCitiesByCountrySoapIn" />
<wsdl:output message="tns:GetCitiesByCountrySoapOut" />
</wsdl:operation>
</wsdl:portType>
<wsdl:portType name="GlobalWeatherHttpGet">
<wsdl:operation name="GetWeather"> <documentation xmlns="http://schemas.xmlsoap.org/wsdl/">Get weather
report for all major cities around the world.</documentation> <wsdl:input message="tns:GetWeatherHttpGetIn" />
<wsdl:output message="tns:GetWeatherHttpGetOut" />
</wsdl:operation>
<wsdl:operation name="GetCitiesByCountry"> <documentation xmlns="http://schemas.xmlsoap.org/wsdl/">Get all major
cities by country name(full / part).</documentation> <wsdl:input message="tns:GetCitiesByCountryHttpGetIn" />
<wsdl:output message="tns:GetCitiesByCountryHttpGetOut" />
</wsdl:operation>
</wsdl:portType>
<wsdl:portType name="GlobalWeatherHttpPost">
<wsdl:operation name="GetWeather">
<documentation xmlns="http://schemas.xmlsoap.org/wsdl/">Get weather
report for all major cities around the world.</documentation>
<wsdl:input message="tns:GetWeatherHttpPostIn" />
<wsdl:output message="tns:GetWeatherHttpPostOut" />
</wsdl:operation>
<wsdl:operation name="GetCitiesByCountry"> <documentation xmlns="http://schemas.xmlsoap.org/wsdl/">Get all major
cities by country name(full / part).</documentation>
<wsdl:input message="tns:GetCitiesByCountryHttpPostIn" />
<wsdl:output message="tns:GetCitiesByCountryHttpPostOut" />
</wsdl:operation>
</wsdl:portType>
<wsdl:binding name="GlobalWeatherSoap" type="tns:GlobalWeatherSoap"> <soap:binding transport="http://schemas.xmlsoap.org/soap/http"
style="document" />
<wsdl:operation name="GetWeather"> <soap:operation soapAction="http://www.webserviceX.NET/GetWeather"
style="document" />
<wsdl:input>
<soap:body use="literal" />
</wsdl:input>
<wsdl:output>
<soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="GetCitiesByCountry">
<soap:operation
soapAction="http://www.webserviceX.NET/GetCitiesByCountry"
style="document" />
<wsdl:input> <soap:body use="literal" />
</wsdl:input>
<wsdl:output> <soap:body use="literal" />
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:binding name="GlobalWeatherHttpGet"
type="tns:GlobalWeatherHttpGet">
<http:binding verb="GET" />
<wsdl:operation name="GetWeather"> <http:operation location="/GetWeather" />
<wsdl:input> <http:urlEncoded />
</wsdl:input>
<wsdl:output>
<mime:mimeXml part="Body" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="GetCitiesByCountry"> <http:operation location="/GetCitiesByCountry" />
<wsdl:input>
<http:urlEncoded />
</wsdl:input>
<wsdl:output> <mime:mimeXml part="Body" />
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:binding name="GlobalWeatherHttpPost"
type="tns:GlobalWeatherHttpPost"> <http:binding verb="POST" />
<wsdl:operation name="GetWeather"> <http:operation location="/GetWeather" />
<wsdl:input> <mime:content type="application/x-www-form-urlencoded" />
</wsdl:input>
<wsdl:output> <mime:mimeXml part="Body" />
</wsdl:output>
</wsdl:operation>
<wsdl:operation name="GetCitiesByCountry"> <http:operation location="/GetCitiesByCountry" />
<wsdl:input> <mime:content type="application/x-www-form-urlencoded" />
</wsdl:input>
<wsdl:output> <mime:mimeXml part="Body" />
</wsdl:output>
</wsdl:operation>
</wsdl:binding>
<wsdl:service name="GlobalWeather">
<wsdl:port name="GlobalWeatherSoap" binding="tns:GlobalWeatherSoap"> <soap:address location="http://www.webservicex.net/globalweather.asmx"
/> </wsdl:port>
<wsdl:port name="GlobalWeatherHttpGet"
binding="tns:GlobalWeatherHttpGet"> <http:address location="http://www.webservicex.net/globalweather.asmx"
/> </wsdl:port>
<wsdl:port name="GlobalWeatherHttpPost"
binding="tns:GlobalWeatherHttpPost"> <http:address location="http://www.webservicex.net/globalweather.asmx"
/> </wsdl:port>
</wsdl:service>
</wsdl:definitions>
Este documento muestra los elementos de un documento WSDL, especificando los tipos, mensajes, operaciones y enlaces que ofrece este servicio Web.
5.2.3 UDDI (Universal Description, Discovery, and Integration). El Repositorio de Servicios.
Uno de los puntos más importantes de un servicio es su publicidad, pensando en ello, se ha definido un mecanismo para darles publicidad a los servicios Web XML que las empresas desarrollan, denominado UDDI. Cuando un proveedor de servicios Web quiere poner un servicio Web disponible para clientes de aplicación, el proveedor describe el servicio Web usando un documento WSDL. Entonces el proveedor registra el servicio Web en el directorio UDDI. El directorio UDDI contiene apuntadores a el servicio Web y el documento WSDL de el servicio Web. De esta manera las aplicaciones Cliente pueden descubrir el servicio Web usando el directorio UDDI. La especificación UDDI tiene dos objetivos esenciales: (1) ser un soporte a los desarrolladores para encontrar información sobre servicios web y poder construir clientes, (2) facilitar el Enlace Dinámico de Servicios Web, permitiendo consultar referencias y acceder a servicios de interés. La información en un registro UDDI se almacena en archivos XML con una estructura jerárquica, Los elementos de esta estructura son:
businessEntity: Describe la organización que ofrece el servicio (Nombre, dirección, etc.)
businessService: Grupo de servicios Web relacionados ofrecido por una BusinessEntity (empresa), pero ofrecida en diferentes direcciones, versiones, y tecnologías. Al igual que las BusinessEntity, pueden incluir información de clasificación.
bindingTemplate: Información técnica para utilizar el servicio, (Dirección del servicio, Referencias documentos (tModels) describiendo la interfaz u otras propiedades, Como dar valor a los parámetros y valores por defecto).
tModel: (Technology Model). Estructura de Metadatos Genérica para representar cualquier concepto o construcción (definiciones de protocolos, ficheros WSDL, XML schemas, Espacios de Nombres, esquemas de categorías, etc.).
La figura 5.2 muestra un ejemplo de cómo están estructurados los datos en un registro UDDI.
Figura 5.2
La figura 5.3 muestra la relación entre las tecnologías usadas para implementar un servicio Web. La aplicación Cliente localiza un servicio Web XML mediante un Registro UDDI que contiene apuntadores a los documentos WSDL y servicios Web XML, una vez localizado el servicio Web XML la aplicación Cliente se comunica con el servicio Web mediante mensajes SOAP.
Figura 5.3
Registro
UDDI
Documento
WSDL
Aplicación
Cliente
Servicio Web
Localiza un
servicio Web
Comunicación mediante Mensajes SOAP
5.3 Publicación de un servicio WEB.
Los servicios Web XML desde el punto de vista de programación, son muy parecidos a un programa, mientras que en su consumo son más orientados al ambiente Web. Estos servicios están constituidos por un archivo de extensión .asmx, y este archivo debe contener lo siguiente:
1. La directiva @WebService. Esta directiva específica los atributos de servicio Web XML. Esta directiva es el equivalente a @Page de las páginas Web. Los atributos que utiliza esta directiva son:
Class. Específica la clase implementada por el servicio Web XML, esta se compila automáticamente la primera vez que se tiene acceso al servicio Web XML, o después de que se operan cambios en él.
CodeBehind. Específica el archivo de código fuente que contiene la clase utilizada por el servicio Web XML.
Language. Específica el lenguaje .NET utilizado para codificar la clase que implementa el servicio Web XML.
La sintaxis de cómo utilizar la directiva @WebService y sus atributos es la siguiente: <%@ WebService Language="C#" CodeBehind="NombreArchivo"
Class="NombreClase" %>
La directive @WebService se deberá colocar al principio del código del servicio Web XML.
2. Importar el espacio de nombres System.Web.Services. El espacio de nombres System.Web.Services es el espacio de nombres que contiene las clases que permiten crear servicios Web XML, tales como WebService y WebMethodAttribute. La sintaxis para importar el espacio de nombres es la siguiente. using System.Web.Services;
Después de importar el espacio de nombres, se puede escribir el código de la clase que constituirá el servicio Web; esta clase deberá heredar la funcionalidad de System.Web.Services.WebService.
3. Crear una clase, ya sea dentro de la página o en modo Code Behind. Después de establecer las directivas y haber importado los espacios de nombres, se deberá codificar una clase, que contendrá el bloque de código que constituye el servicio Web XML. Debe ser una clase porque al consumir un servicio Web XML programáticamente, es necesario manejar la funcionalidad en modo objeto y éstos no son otra cosa que instancias de una clase. La clase debe tener suficientes permisos, de preferencia ser pública, sobre todo si el servicio Web XML podrá ser consumido desde Internet. La sintaxis que se utiliza para declarar una clase es la siguiente: public class NombreClase : System.Web.Services.WebService {
WebMetodos
}
4. Declarar como [WebMethod()] las funciones del servicio Web XML. Las funciones
incluidas en la clase constituyen el comportamiento del servicio Web XML, en su definición, las funciones se asemejan mucho a las funciones que conocemos en programación. Su diferencia radica en que deben ser de acceso público, y que deben estar habilitadas para ser acreditadas por clientes remotos a través de la Web, agregándoles el atributo WebMethod(). La sintaxis para declarar un WebMethod es la siguiente: [WebMethod(Description="Descripción del método")]
public TipoFuncion NombreFuncion(Parametros){
return ValorRetorno
}
Para crear un servicio Web con la herramienta Microsoft Visual Web Developer 2005, el primer paso es crear el servicio Web, en el menú principal de esta herramienta seleccionamos la
opción Archivo y el menú que aparece seleccionamos la opción Nuevo sitio Web como se muestra en la figura 5.4.
Figura 5.4
Aparece una ventana donde vamos a crear el nuevo sitio Web que contendrá el servicio Web, seleccionamos la plantilla correspondiente al Servicio Web ASP.NET y proporcionamos la ruta física donde va a estar almacenado este sitio y el lenguaje que se va a utilizar, en este caso el lenguaje que seleccionamos es C#, como se muestra en la figura 5.5
Figura 5.5
Una vez que creamos el sitio Web, agregamos un nuevo elemento como se muestra en la figura 5.6, que será la clase que contenga la funcionalidad del servicio Web.
Figura 5.6 En seguida aparece una pantalla donde vamos a seleccionar la plantilla correspondiente al servicio Web, y proporcionamos el nombre del archivo que contenga el servicio Web con extensión asmx, como se muestra en la figura 5.7.
Figura 5.7 Modificamos el código del archivo Aritmetica.cs para que quede de la siguiente manera: using System;
using System.Web;
using System.Collections;
using System.Web.Services;
using System.Web.Services.Protocols;
/// <summary>
/// Descripción breve de Aritmetica
/// </summary>
[WebService(Namespace = "http://tempuri.org/")]
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
public class Aritmetica : System.Web.Services.WebService {
public Aritmetica () {
}
[WebMethod(Description="Suma dos números enteros")]
public int Suma(int N1, int N2)
{
return (N1 + N2);
}
[WebMethod(Description="Multiplicacion dos números enteros")]
public int Multiplicacion(int N1, int N2)
{
return (N1 * N2);
}
[WebMethod(Description = "Division entre dos números enteros")]
public int Division(int N1, int N2)
{
return (N1 / N2);
}
}
Generamos el sitio Web como se muestra en la figura 5.8.
Figura 5.8
Una vez que se ha desarrollado el servicio Web, el siguiente paso es desplegar el servicio Web en un servidor Web, como el IIS Internet Information Services, para que esté disponible para usuarios o aplicaciones cliente, para esto seleccionamos la opción Stio Web del menú principal y del menú que aparece seleccionamos la opción Copiar sitio Web como en la figura 5.9.
Figura 5.9 Posteriormente se indica el sitio donde se va a desplegar el servicio Web, ya sea en el servidor local o en un servidor remoto, como en la figura 5.10.
Figura 5.10 Y por último se seleccionan los archivos que se van a copiar en el servidor web, como en la figura 5.11.
Figura 5.11 Para probar que el servicio Web quedo desplegado en el servidor web abrimos el IIS (Internet Information Services) en esta herramienta el servicio Web se debe mostrar como una carpeta virtual Figura 5.12.
Figura 5.12 Para publicar el servicio Web en el registro UDDI y este pueda ser descubierto por algún cliente existen varias herramientas, una de ellas viene integrada en Windows Server 2003, para poder utilizar esta herramienta primero se deben instalar los servicios UDDI, esto lo podemos hacer en la opción Agregar Componentes de Windows como se muestra en la figura 5.13.
Figura 5.13 Una vez instalados los servicios UDDI utilizamos la interface web de esta herramienta, en un
navegador de internet tecleamos la dirección http://localhost/uddi figura 5.14.
Figura 5.14
Antes de publicar el servicio Web en el registro UDDI es necesario dar de alta el proveedor del servicio Web (businessEntity), esto en la ventana correspondiente, Figura 5.15, especificando la información necesaria de dicho proveedor.
Figura 5.15
Para agregar un nuevo servicio Web se utiliza la pestaña Services y en la ventana correspondiente Figura 5.16 se asigna el nombre y la descripción del servicio, dentro de esta misma ventana en la pestaña Bindings se especifica la ubicación del servicio Web, así como la descripción de dicho servicio (bindingTemplate).
Figura 5.16
El paso final es proveer información técnica, parámetros, etc del servicio Web (tModel), Figura 5.17.
Figura 5.17
Este tmodel creado se asocia con el servicio Web Figura 5.18 y de esta manera el servicio Web es publicado.
Figura 5.18
5.4 Consumo de un servicio WEB. Los servicios Web XML pueden ser consumidos de dos maneras, directamente desde un navegador o desde una aplicación de forma programática. Las diferencias entre estas dos formas son las siguientes:
Directamente desde el navegador. La petición se realiza vía HTTP al servidor, este mostrará la página de hipertexto de descripción, que lista los métodos disponibles en el servicio Web XML. En dicha página puede seleccionar algún método disponible, interactuar con la interfaz proporcionando datos y recibir la respuesta del servicio Web XML. La respuesta que se recibe está en XML
Desde una aplicación, programáticamente. Se debe establecer una referencia hacia el servicio Web XML, dicha referencia es un objeto que es utilizado para comunicarse con el servicio Web utilizando SOAP. La clase que se genera es una equivalencia de la clase original del servicio Web XML, con la diferencia de que no contiene la lógica de la aplicación, en lugar de eso, la clase contiene la lógica de clasificación y transporte de datos. La clase permite a la aplicación que consume el servicio Web XML disponer de una respuesta manejada a través de SOAP, que permite manejar objetos más complejos que HTTP. Se deberá en el programa generar una instancia de la clase, utilizar los métodos del servicio Web XML y recibir los datos de la aplicación.
Cuando se realiza el consumo desde el navegador, todo el proceso ocurre ahí mismo en el navegador.
1. Se debe hacer una solicitud del servicio Web XML utilizando HTTP. 2. Aparecerá la página de descripción, que expone todos los métodos del servicio, figura
5.19. 3. Se selecciona un método del servicio. 4. Se proporcionan los datos que el método requiere, figura 5.20. 5. Se reciben los resultados del método en formato XML.
Figura 5.19
Figura 5.20
El protocolo HTTP es textual, y es incapaz de manejar objetos complejos. Como este tipo de consumo del servicio Web XML se realiza utilizando el protocolo HTTP, la respuesta sólo puede ofrecerse mediante XML, por lo que el resultado de esta llamada queda de la siguiente manera:
<?xml version="1.0" encoding="utf-8" ?> <int xmlns="http://tempuri.org/">1</int>
Para poder probar este servicio Web programatica se agrega una página a un proyecto web desarrollado en Microsoft Visual Web Developer 2005 y se le llama ConsumeWS, a esta página se le agrega tres controles de tipo Label llamados “ResultadoSuma”, “ResultadoMultiplicacion”, “ResultadoDivision”, el código html quedaría de la siguiente manera: <%@ Page Language="C#" AutoEventWireup="true"
CodeFile="ConsumeWS.aspx.cs" Inherits="ConsumeWS" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Página sin título</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:Label ID="ResultadoSuma" runat="server" />
<asp:Label ID="ResultadoMultiplicacion" runat="server" />
<asp:Label ID="ResultadoDivision" runat="server" />
</div>
</form>
</body>
</html>
Al Proyecto se le agrega una referencia web, Figura 5.21 que es el servicio Web creado anteriormente, al cual se le denomina Aritmetica, esta referencia se importa dentro de la página y en el evento Load de la página se crea una instancia de la clase Aritmetica y se ejecuta el método Suma del servicio Web, el resultado se muestra en la etiqueta llamada
ResultadoSuma, el método Multiplicación se muestra en la etiqueta ResultadoMultiplicacion y el método Division se muestra en la etiqueta ResultadoDivision.
Figura 5.21 El código subyacente quedaría de la siguiente manera: using System;
using System.Data;
using System.Configuration;
using System.Collections;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;
using Aritmetica;
public partial class ConsumeWS : System.Web.UI.Page
{
protected void Page_Load(object sender, EventArgs e)
{
Aritmetica.Aritmetica Consumidor = new
Aritmetica.Aritmetica();
ResultadoSuma.Text = Consumidor.Suma(20, 30).ToString();
ResultadoMultiplicacion.Text =
Consumidor.Multiplicacion(2,3).ToString();
ResultadoDivision.Text = Consumidor.Division(20,
2).ToString();
}
}
El resultado obtenido es el siguiente:
Otra manera de utilizar un servicio Web de manera programática es mediante una clase proxy, el procedimiento general es el siguiente:
1. Se debe tener desarrollado un servicio Web XML(.asmx). 2. Se debe descubrir el servicio Web mediante la herramienta disco.exe 3. Se debe crear una clase para el servicio Web XML mediante la herramienta wsdl.exe. 4. Se debe compilar la clase como librería. 5. En el proyecto donde se va a consumir el servicio Web se debe agregar una referencia
a la librería creada. 6. En el código del programa que consume el servicio Web XML deberá crearse una
instancia de la clase. 7. Se deberá invocar el método del servicio Web XML a través de la instancia de la clase
que se ha instanciado. 8. Se utiliza el resultado retornado por el servicio.
Una vez que se tiene desarrollado el servicio Web el siguiente paso es descubrir dicho servicio, se conoce como descubrimiento de servicio Web al proceso por medio del cual se localiza un servicio Web y su descripción, de tal manera que esté disponible para los programas que consumen estos servicios, la herramienta que se utiliza para descubrir los servicios Web se llama disco.exe, su sintaxis es la siguiente. Disco.exe URL_Servicio
Donde URL_Servicio es la dirección del servicio Web, una vez que se ejecute este programa se van a generar archivos de extensión .wsdl y .disco. Una vez que se ha descubierto el servicio Web, el siguiente paso es crear una clase que contenga cada método del servicio Web, esta clase se va a generar con la herramienta wsdl.exe, su sintaxis es la siguiente: wsdl [options] {URL|path} Existen varias opciones que podemos usar al invocar la utilería wsdl.exe:
/baseurl: baseurl, esta opción convierte la URL relativa dada en esta opción en la URL dada en el documento WSDL
/d:[domain], nombre de dominio.
/l:[lenguaje], lenguaje que se va a utilizar para crear la clase proxy, por ejemplo CS para C# o VB para Visual Basic.
/n:[espacio de nombres], menciona el espacio de nombres para el proxy creado.
/o:[archivo de salida], menciona el nombre del archivo en el cual se va a guardar el código del proxy generado.
/protocol: protocolo, menciona el protocolo que se va a implementar, estos pueden ser SOAP, Httpget o HttpPost.
/proxy: URL, menciona el URL del servidor proxy para utilizar solicitudes HTTP. La ejecución de wsdl.exe producirá un programa generado en el lenguaje especificado, que deberá ser compilado como librería para su uso programático. Dicho programa contendrá la misma funcionalidad del servicio Web XML, con todas las especificaciones descriptivas, para compilar este programa se va a utilizar el compilador del lenguaje que se va a utilizar (visual basic, c sharp). Para crear la clase proxy del servicio Web generado anteriormente, realizamos los tres pasos antes mencionados:
Descubrimos el servicio Web: disco.exe http://localhost/Aritmetica/Aritmetica.asmx
Generamos la clase con la herramienta wsdl.exe: wsdl /l:cs /n:AritmeticaWS Aritmetica.wsdl.
Generamos la librería del servicio Web con el compilador csc.exe csc /target:library /out:Aritmeticadll.dll Aritmetica.cs /r:System.dll /r:System.web.Services.dll /r:System.XML.dll
Para poder probar la librería generada del servicio Web en forma programática se agrega una página a un proyecto web desarrollado en Microsoft Visual Web Developer 2005 y se le llama ConsumeWSdll, a esta página se le agrega tres controles de tipo Label llamados “ResultadoSuma”, “ResultadoMultiplicacion”, “ResultadoDivision”, el código html quedaría de la siguiente manera: <%@ Page Language="C#" AutoEventWireup="true"
CodeFile="ConsumeWSdll.aspx.cs" Inherits="ConsumeWSdll" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" >
<head runat="server">
<title>Página sin título</title>
</head>
<body>
<form id="form1" runat="server">
<div>
<asp:Label ID="ResultadoSuma" runat="server" />
<asp:Label ID="ResultadoMultiplicacion" runat="server" />
<asp:Label ID="ResultadoDivision" runat="server" />
</div>
</form>
</body>
</html>
Agregamos una referencia al proyecto como se muestra en la figura 5.22.
Figura 5.22
Creamos una instancia de la clase generada y utilizamos sus métodos, el código subyacente quedaría de la siguiente manera: using System;
using System.Data;
using System.Configuration;
using System.Collections;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Web.UI.HtmlControls;
public partial class ConsumeWSdll : System.Web.UI.Page
{
protected void Page_Load(object sender, EventArgs e)
{
AritmeticaWS.Aritmetica Servicio = new
AritmeticaWS.Aritmetica();
ResultadoSuma.Text = Servicio.Suma(5, 5).ToString();
ResultadoMultiplicacion.Text =
Servicio.Multiplicacion(5,5).ToString();
ResultadoDivision.Text = Servicio.Division(25,5).ToString();
}
}
El resultado obtenido es el siguiente: