Usuario:ManuelRomero/PHP/servicioWeb

http://www.w3c.es/Divulgacion/GuiasBreves/ServiciosWeb

Qué es un servicio web

Es una aplicación disponible en la web que responde a una solicitud de otra aplicación. La solicitud puede implicar solicitud de datos o realizar acciones. Esto facilita que nuestras aplicaciones puedan ser usadas por otras aplicaciones en la web.

En la imagen vemos cómo un cliente solicita una página web, y para poder visualizar la información, ésta solicita información a otra, que se la solicita a otra ,... Usar o crear un servicio web es una buena solución cuando queremos que una aplicación comparta información con otra u otras, o cuando quieres usar el resultado que una aplicación produce a otra sin que esta segunda acceda directamente a los datos.

Supongamos que hacemos una aplicación que gestiona libros y los almacena en una base de datos. Posteriormente realizamos otra aplicación u otra persona desarrolla otra aplicación que necesita los libros que la primera gestionó. Una solución es ofrecer la base de datos a esta segunda aplicación.

Pero esta no es una solución buena en todos los casos; primero por rendimiento y segundo por temas de seguridad o confidencialidad. Una segunda solución es que la app 1 se convirtiera en un servicio web que lo pudieran consultar otras aplicaciones en los términos que yo decida. Además usar la aplicación primera implica usar toda la lógica de negocio que en ella haya plasmado

Características de un servicicio Web

Los servicios web se crearon para permitir el intercambio de información. Para este cometido hay muchos protocolos de nivel de aplicacion (FTP, telnet, ssh, pop3, smtp, ...). Por ser un servicio web el protocolo base será HTTP (de ahí el término web).

A diferencia de lo que estamos acostumbrados hasta ahora donde un cliente utiliza este protocolo y obtiene como resultado una página web,lLa respuesta obtenida obtenida ahora, no será una página web, sino la información que se solicitó, o bien haber realizado la acción solicitada. Por tanto, cualquier ordenador que pueda consultar una página web, podrá también solicitar información de un servicio web.

Ahora entre otras cuestiones, para poder crear un servicio web, o bien usar un servicio web existente, debemos tener claro:

1. Cómo crear la solicitud y como construir la respuesta para el cliente
2. Cómo conocer o publicar las funciones para que el cliente las utilice

Dependiendo de la tecnología o estándar que vamos a utilizar para implementar el servicio web, estas cuestiones se resolverán de diferentes formas.

Existen dos formas mas o menos estandares que son SOAP y REST. Ambas se usan bastante, si bien para desarrollos rápidos se usa mucho mas REST. En este cusro veremos las dos formas de crear/usar servicios web. En este tema abordaremos SOAP

SOAP

• Es un protocolo que indica cómo se tienen que intercambiar mensajes entre cliente y servidor
• Utiliza xml para este intercambio
• SOAP se acompaña de un lenguaje llamada WSDL, usado para describir y publicar las funciones que el servicio ofrece a sus clientes.
• A continuación vamos a entender y profundizar en las diferentes partes de un fichero xml de soap para poder entenderlo

Ficheros xml que soap crea para el intercambio

Un mensaje SOAP viaja en un fichero xml con la siguiente estructura

1. Elemento principal o Envelope o elemento raiź que identifica el mensaje
2. cabecera o header opcional. se componen de uno o varios header blocks; cada uno de ellos detalla como se debe procesar el mensaje
3. body : Es una parte obligatoria, y contiene la información relativa a la llamada y la respuesta.

En el elemento Envelope se especifica la versión de soap

• En la version 1.1

<soap:Envelope
  xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
  soap:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">

• En la versión 1.2

<soap:Envelope
  xmlns:soap=http://www.w3.org/2003/05/soap-envelope/"
  http://www.w3.org/2003/05/soap-encoding/">

La gestión de este fichero, tanto el hecho de crearlo para responder a una solicitud como la tarea de leerlo e interpretarlo, sería un labor tediosa. Existen librerías en los diferentes lenguajes de programación que automatizan este proceso. Para php vamos a ver PHP5 SOAP, disponible a partir de la versión 5

PHP5 SOAP es la implementación de SOAP que se incluye con PHP a partir de la versión 5 del lenguaje. En versiones anteriores se tenía que recurrir a otras opciones para trabajar con SOAP. Es una extensión nativa (escrita en lenguaje C) y por tanto más rápida que otras posibilidades (NuSOAP -http://code.google.com/p/nusoap-for-php5/- o PEAR::SOAP --). Como veremos más adelante, su gran inconveniente es que no permite la generación automática del documento WSDL una vez programado el servidor SOAP correspondiente.

Describir un servicio

Consiste es publicar qué funciones ofrece mi servicio web, así como qué parámetros necesita y que valor/es retorna dicha función Este paso es importante sobre todo si no es la personas que ha desarrollado el servicio la única que va a utilizarlo. En SOAP esto se hace usando el leguaje de descrición WSDL (Lenguaje de Descripción de Servicios Web).

WSDL es un lenguaje basado en XML que utiliza unas reglas determinadas para generar el documento de descripción de un servicio web. Una vez generado, ese documento se suele poner a disposición de los posibles usuarios del servicio (normalmente se accede al documento WSDL añadiendo ?wsdl a la URL del servicio). En la siguiente imagen podemos ver las diferentes partes de un fichero xml wsdl. Vemos como cambia según estemos en la version 1.1 o la versión 2.

types y message

• En la versión 2 solo existe el elemento types
• Describe las definiciones de tipos de datos que se usan en el servicio, como lista de parámetros que recibe una función o los valores que retorna

portType o interfaces

Cada uno de estos elementos es cada una de las funciones que el servicio ofrece Cada función se define es una operation con sus input y output como podemos ver en la imagen

bindinn

• Define como va a transmitirse la información de cada portType

service

• Contiene una lista de las diferentes url (1 o varias) en donde se puede acceder al servicio web
• Definir, construir e interpretar el contenido de un fichero wsdl, puede ser de nuevo una tarea de gran calibre
• En lugar de hacerlo, usaremos herramientas que nos construyan este fichero como vamos a ver a continuación

PHP SOAP

• Pasa implementar un servicio web vamos a usar esta exténsión nativa de php.
• Primero verificamos que la tenemos instalada