Desarrollo de servicios distribuidos usando gsoap

Transcripción

1 Desarrollo de servicios distribuidos usando gsoap Introducción a SOAP En los últimos años se han presentado varias plataformas de propósito general para hacer computación distribuida. El objetivo es asegurar un mínimo de seguridad, disponibilidad, escalabilidad, confiabilidad y manejabilidad en aplicaciones distribuidas. Algunos ejemplos son Charlotte, Javalin++, HARNESS, Legion y Globus (entre otros). Estas infraestructuras incluyen las tecnologías necesarias para desarrollar grids computacionales. Un grid es un entorno persistente que permite a las aplicaciones software integrar instrumentos de cualquier tipo junto con recursos computacionales y de información que son gestionados por varias organizaciones. Muchas de estas infraestructuras usan Java como el lenguaje de programación único. Este lenguaje tiene muchas características que lo hacen adecuado para computación distribuida. A pesar de la baja eficiencia de los programas Java, siempre se puede mejorar usando paquetes propietarios y mediante técnicas de compilación. Sin embargo, la integración de software de sistema, el software de tiempo real o los sistemas embebidos aún resultan problemáticos. En 1998 Microsoft, IBM y otros crearon el protocolo SOAP (Service Oriented Architecture Protocol), que se convirtió en estándar del W3C. SOAP es un formato de intercambio de mensajes bastante simple y muy ligero. SOAP define cómo dos objetos en diferentes procesos pueden comunicarse por medio de intercambio de datos XML. SOAP es uno de los protocolos utilizados en los servicios Web. Está basado en XML y es neutral tanto en cuanto al lenguaje de programación como en cuanto a la plataforma hardware. SOAP tiene un diseño que cumple el patrón cabecera desarrollo de diseño de software, como otros muchos diseños (p.ej. HTML). La cabecera Header es opcional y contiene metadatos sobre enrutamiento (routing), seguridad o transacciones. El desarrollo Body contiene la información principal, que se conoce como carga útil (payload). A diferencia de DCOM y CORBA, que son binarios, SOAP usa el código en XML. Esto es una ventaja ya que facilita su lectura por parte de humanos, pero también es un inconveniente dado que los mensajes resultantes son más largos. El intercambio de mensajes se realiza mediante tecnología de componentes. SOAP es un marco extensible y descentralizado que permite trabajar sobre múltiples pilas de protocolos de redes informáticas. Los procedimientos de llamadas remotas pueden ser modelados en la forma de varios mensajes SOAP interactuando entre sí. CORBA, DCOM y Enterprise Java permiten compartir recursos dentro de una organización, mientras que la tecnología SOAP permite compartir recursos entre organizaciones muy diferentes, con plataformas y flujos de información muy dispares, incluso estando detrás de cortafuegos. SOAP funciona sobre cualquier protocolo de Internet, generalmente HTTP, que es el único homologado por el W3C. Esto permite el desarrollo de agentes que acceden a la información en 1

2 tiempo real. Como ejemplos, cabe destacar la posibilidad de acceder a datos de un proceso de fabricación y su visualización en una PDA, el control y visualización de simulaciones desde un ordenador portátil, el acceso a bases de datos remotas, o el intercambio de resultados de un experimento de laboratorio utilizando teléfonos móviles. Qué es SOAP? SOAP significa Simple Object Access Protocol SOAP es un protocolo de comunicaciones SOAP está pensado para comunicar aplicaciones SOAP es un formato para enviar mensajes SOAP está diseñado para comunicaciones via Internet SOAP es independente de la plataforma SOAP es independente del lenguaje SOAP está basado en XML SOAP es un protocolo simple y extensible SOAP funciona aún cuando haya cortafuegos SOAP es un estándar del W3C La comunicación entre aplicaciones a través de Internet es muy importante. Hasta hace poco, las aplicaciones solían comunicarse a través de RPC (Remote Procedure Calls) entre objetos, como DCOM o CORBA, pero HTTP no se diseñó para estos procedimientos. RPC plantean problemas de compatibilidad y seguridad, además, los cortafuegos y proxys suelen bloquear este tipo de tráfico. La solución es comunicarse a través de HTTP, que es soportado por todos los navegadores y servidores. Así, SOAP representa un medio para comunicar aplicaciones que se están ejecutando en diferentes sistemas operativos, con diferentes tecnologías y lenguajes de programación. Reglas de sintaxis en SOAP Un mensaje SOAP debe codificarse usando XML Un mensaje SOAP debe usar el espacio de nombres (namespace) de SOAP Envelope Un mensaje SOAP debe usar el namespace de SOAP Encoding Un mensaje SOAP no debe contener referencias a un DTD Un mensaje SOAP no debe contener instrucciones de procesamiento XML A continuación mostramos un ejemplo de mensaje SOAP (el esqueleto básico) en el que podemos apreciar cómo se trata de un documento XML en el que la etiqueta <soap:envelope> engloba el resto del mensaje, que debe incluir la cabecera <soap:header> y el cuerpo <soap:body> : <?xml version="1.0"?> 2

3 <soap:envelope xmlns:soap=" envelope" soap:encodingstyle=" encoding"> <soap:header> </soap:header> <soap:body> <soap:fault> </soap:fault> </soap:body> </soap:envelope> Interoperabilidad del protocolo SOAP Como hemos comentado, SOAP es un protocolo de llamadas remotas neutral desde el punto de vista de la plataforma y del lenguaje de programación y que usa XML como formato. Además, usa el protocolo HTTP (lo que ahorra problemas con los cortafuegos). Estas ventajas y otras están detalladas a continuación: Ubicuidad: SOAP tiene un buen soporte en la industria, lo que le asegura poder ofrecer servicios a cualquier usuario en cualquier sitio (teléfonos móviles, PDAs, sistemas empotrados o aplicaciones de escritorio). Simplicidad: SOAP es un protocolo muy ligero basado en XML. Un ejemplo de un servicio SOAP podría ser un dispositivo con un sensor que responde a una petición enviando una cadena XML con el valor leido por el sensor. Dicho dispositivo requeriría pocos recursos computacionales y se podría incluir fácilmente en un sistema empotrado. Servicios: los servicios Web creados con SOAP ofrecen datos y servicios software a otras aplicaciones sobre Internet o en una intranet. Un servicio Web puede ser un simple script de shell o un CGI o un servidor Apache o un ASP, JSP o PHP... WSDL: el Web Service Description Language es un formato XML para describir servicios en red. Al igual que SOAP, WSDL es neutral respecto a la plataforma y el lenguaje, lo que facilita la creación automática de funciones software para desarrollar clientes en cualquier lenguaje. Esas funciones se usarían para acceder a los métodos remotos del servicio Web. UDDI: la especificación Universal Description, Discovery and Integration ofrece un servicio universal para registrar, buscar, descubrir e integrar servicios Web. WSDL complementa al UDDI, facilitando interfaces para los servicios. Transporte: un mensaje SOAP se puede enviar usando HTTP, SMTP, TCP, UDP, etc. Además puede ser enrutado utilizando diferentes protocolos de transporte entre los diferentes nodos. Seguridad: SOAP sobre HTTPS es seguro. El mensaje HTTP completo, incluyendo la 3

4 cabecera y el cuerpo del mensaje HTTP se encriptan. Además, para desarrollar sistemas de computación en grid se pueden utilizar fácilmente mecanismos de autentificación y delegación en SOAP. Cortafuegos: se pueden configurar los cortafuegos para permitir pasar los mensajes SOAP, ya que la cabecera del mensaje contiene la información sobre destino y puertos. Compresión: el protocolo HTTP 1.1 permite transferencias usando el formato GZIP, lo cual comprime los mensajes SOAP sobre la marcha. Persistencia: las aplicaciones suelen actualizarsee incluso pueden dejar de recibir soporte. Esto puede complicar la extracción de ciertos datos guardados con formatos binarios o propietarios, lo que puede significar la pérdida de información valiosa. Sin embargo, un mensaje SOAP, al estar basado en XML permite leer su contenido fácilmente (la estructura del documento XML lo hace auto descriptivo), lo que lo hace persistente. Transacciones: la cabecera del mensaje SOAP facilita el manejo de transacciones. Excepciones: SOAP soporta el manejo de excepciones remotas. Por otro lado, las posibles desventajas de SOAP son: Recogida de basura (garbage collection): no posee dicho mecanismo. Tampoco la posibilidad de hacer referencias a objetos. Representación de números en coma flotante: este formato numérico se representa en formato decimal (texto) en el XML, lo que puede suponer una pérdida de precisión. Otras codificaciones SOAP, como hexbinary y Base64 se pueden usar para codificar números en el formato estándar IEEE754, pero eso puede suponer un problema para la interoperabilidad de los sistemas (si en alguna plataforma no se usa dicha representación). A modo de ejemplo, a continuación se muestra un mensaje SOAP en formato XML. Primero vemos la forma en que un cliente solicitaría información de un producto a un proveedor de servicios Web: <soap:envelope xmlns:soap=" <soap:body> <getproductdetails xmlns=" <DECODE>ASCII</DECODE> <IP> </IP> <USER>MICUENTA</USER> <PASS>CLAVE</PASS> <BASE>MUSICA</BASE> <TABLA>CANCIONES</TABLA> <MAXREG>10</MAXREG> <PARAMETROS>[TITULO == 'ZOOROPA']</PARAMETROS> </getproductdetails> </soap:body> </soap:envelope> Y esta sería la respuesta del proveedor: <soap:envelope xmlns:soap=" <soap:body_musica> 4

5 <CANCIONES xmlns=" "> <RECORDSET_1> <TITULO>ZOOROPA</TITULO> <BANDA>U2</BANDA> <ALBUM>ZOOROPA</ALBUM> <COMENTARIO>texto y otras cosas</comentario> <TRACK>1</TRACK> </RECORDSET_1> </CANCIONES> </soap:body> </soap:envelope> Herramientas para desarrollar programas Hay bastantes herramientas de desarrollo, para muchos lenguajes de programación, que permiten trabajar con SOAP. Estas herramientas van desde simples APIs hasta SDK (software development kit) muy elaborados y completos para desarrollos SOAP tipo servidor cliente. Entre otros cabe destacar SOAP::Lite para Perl, Apache SOAP for Java, el.net SDK, y el gsoap Toolkit para C/C++. Para que una aplicación que usa SOAP forme parte de una infraestructura de computación distribuida más o menos compleja no se requiere necesariamente un SDK muy complejo y elaborado. La aplicación puede ser tan simple como un script de shell. Lenguajes como Perl permiten crear aplicaciones rápidamente utilizando las descripciones WSDL. Por ejemplo, el siguiente código corresponde a un cliente SOAP, desarrollado en Perl usando SOAP::Lite, para acceder al servicio Delayed Stock Quote de Xmethods: use SOAP::Lite; print SOAP::Lite >service(' >getquote('aol'); Un servicio SOAP sencillo para almacenar y recuperar valores, implementado en Perl podría ser algo similar a: use SOAP::Transport::HTTP; my $daemon = SOAP::Transport:: >new ( LocalPort => 8002 ) >dispatch_to( "/opt/programs/services", "Almacen", "Almacen::incluir", "Almacen::extraer"); print "Contact to SOAP server at ", join(':', $daemon >sockhost, $daemon >sockport), "\n"; $daemon >handle; Las herramientas SOAP para C++ ofrecen clases que facilitan la formación de tipos de datos SOAP a partir de los tipos nativos. Cada tipo de datos SOAP (viene a ser un esquema XML) tiene una clase en la librería. Normalmente el usuario está forzado a adaptar su aplicación a la lógica de las librerías, o bien a implementar funciones que transformen los datos específicos de la aplicación en estructuras SOAP y viceversa. 5

6 Ejemplo completo de cliente/servidor SOAP usando SOAP::Lite para Perl Para probar el ejemplo debemos contar con: Un servidor web que ejecute CGI Un intérprete de Perl en la misma máquina El módulo SOAP::Lite A continuacion mostramos un servidor simple que implementa dos metodos: saludo() y despedida() #!/usr/bin/perl w use SOAP::Transport::HTTP; SOAP::Transport:: > dispatch_to('demo') > handle; package Demo; sub saludo() { my ($class,$nombre)=@_; return "Hola $nombre, el ejemplo de SOAP::Lite funciona"; sub despedida() { return "Hasta luego"; Llamemos a este script servidor.cgi y coloquémoslo en el directorio correspondiente a los CGI de nuestro servidor. El método saludo() recibe el parámetro $nombre y construye un saludo en base al mismo. A continuación mostramos el código Perl de un cliente que llama a un servicio anterior: #!/usr/bin/perl use SOAP::Lite; my $soap = SOAP::Lite > uri(' > proxy(' bin/servidor.cgi'); my $result = $soap >saludo("juan"); if ($result >fault) { print "ERROR: ". $result >faultcode." ". $result >faultstring ; else { print $result >result(); El cliente comprueba si hubo algún error. En el ejemplo, uri es la url del servidor y el nombre del paquete (package), proxy es la url del script cgi que implementa el servidor. 6

7 Características de gsoap gsoap permite crear aplicaciones en C/C++ para compartir recursos computacionales y de información con otras aplicaciones, posiblemente a través de diferentes plataformas, lenguajes de programación, redes y organizaciones. Como resultado, aplicaciones científicas, sistemas empotrados, y software de tiempo real pueden interactuar como clientes o como servidores. En cuanto al tipo de arquitectura de red, gsoap no establece una estructura cliente servidor estricta pero tampoco establece una arquitectura P2P (peer to peer o entre pares). Para crear una infraestructura P2P independiente de la plataforma se puede usar JXTA o el.net SDK. Las características de diseño de gsoap son: Rutinas precompiladas: las funciones para (de)serialización están optimizadas y precompiladas para minimizar las inspecciones dinámicas de tipos de datos. Soporte de tipos nativos: las funciones precompiladas serializan y deserializan los tipos de datos nativos de C/C++ y los definidos por el usuario, sin necesidad de incluir información extra como etiquetas. De esta forma se pueden usar técnicas de compilación para, por ejemplo, optimizar la colocación de datos en memoria para reducir los accesos. Minimización de las operaciones con memoria: para evitar copiar repetidas veces los datos, las funciones de serialización se llevan a cabo in situ, sobre los datos nativos de la aplicación, ya estén en la pila o en el segmento de datos. Minimización del uso de la memoria: los ejecutables de un servidor o cliente típicos suelen ser pequeños (unos 150 KB). Esto permite implementar clientes y servidores en sistemas empotrados muy pequeños. Procesamiento eficiente del XML: la librería de gsoap incluye un procesador XML muy eficiente y modificado para procesar XML bajo demanda sin necesidad de mantener todo el documento en memoria. Preservación de la estructura: cuando una estructura se codifica en un mensaje SOAP y luego se decodifica en el destino, es una copia exacta del original. Sin embargo la copia puede ocupar una posición diferente dentro de la pila o del segmento de memoria. También los punteros en la copia pueden tener valores de las direcciones diferentes al original. En estructuras complejas se usa la codificación de objetos multireferenciados de SOAP. Integración de aplicaciones: el uso de funciones de transformación para tipos de datos nativos de C/C++ y del usuario permite incluir aplicaciones desarrolladas en C/C++ en clientes y servicios. Independencia de la plataforma: gsoap genera código C/C++ independiente de la plataforma para todas las funciones, por lo que se pueden obtener ejecutables para cualquier plataforma para la que exista un compilador de C/C++. 7

8 Para una descripción más detallada de estas características, se puede ampliar esta información en las siguientes páginas mantenidas por los creadores de gsoap: La interoperabilidad de gsoap se ha verificado con las siguientes herramientas o implementaciones: Apache 2.2 Apache Axis ASP.NET Cape Connect Delphi easysoap++ esoap Frontier GLUE Iona XMLBus ksoap MS SOAP Phalanx SIM SOAP::Lite SOAP4R Spray SQLData Wasp Adv. Wasp C++ White Mesa xsoap ZSI 4S4C Especificación del servicio y la funcionalidad El desarrollo de una aplicación con gsoap pasa por la creación de una especificación WSDL del servicio que después será traducida a una serie de declaraciones de función C/C++ que se guardarán en un archivo de cabecera estándar. Esta traducción hace que la interfaz del servicio (y la descripción del servicio en WSDL) sea transparente al usuario. La aplicación soapcpp incluida en el paquete gsoap lleva a cabo estas tareas, generando todos los ficheros WSDL y XML necesarios, sin que el usuario se deba preocupar por estos detalles. Un poco más adelante veremos un ejemplo completo de desarrollo de un servicio y de un cliente. Dicho servicio almacenará cadenas de caracteres y podrá recibir o enviar una cadena bajo demanda. Esto lo indicaremos en un archivo de cabecera llamado (p.ej.) funciones.h con las siguientes líneas: //gsoap ns service name: funciones //gsoap ns service style: rpc //gsoap ns service encoding: encoded //gsoap ns service namespace: //gsoap ns service location: //gsoap ns schema namespace: urn:func int ns enviar (unsigned nodo, std::string cadena, std::string &resultado); int ns recibir(unsigned nodo, std::string &resultado); Realmente sólo nos interesan la primera línea (nombre del servicio) y las dos últimas que definen la cabecera de las dos funciones del servicio. El cliente de dicho servicio incluirá el archivo funciones.nsmap y simplemente debe llamar a las funciones que ofrece el servicio (anteponiendo soap_call_): 8

9 #include "soaph.h" #include "funciones.nsmap" const char server[] = " :9999"; struct soap soap; soap_init(&soap); soap_call_ns enviar(&soap, server, "", nodo, cadena, resultado); Transformación de tipos de datos nativos en mensajes SOAP La herramienta soapcpp genera las funciones para transformar y codificar los tipos de datos nativos en mensajes SOAP. Estos mensajes siguen los formatos de las versiones SOAP 1.1 y 1.2. La codificación de los tipos de datos nativos de C/C++ se hace de la siguiente forma: Tipos básicos: los tipos primitivos de C (incluidos bool, char*, wchar_t*, time_t) se codifican como los tipos primitivos XML xsd:int, xsd:double, xsd:string. Con una redefinición de tipos (typedef) podemos informar a la herramienta soapcpp cómo codificar los tipos: typedef double xsd decimal; Enumeraciones: las enumeraciones de C se reconocen y serializan usando nombres simbólicos. Estructuras: existe el tipo ComplexType para transformar las estructuras en formato XML. Clases: se usa el tipo ComplexType para transformar las clases en formato XML. Sólo hay que tener en cuenta que sólo está soportada la herencia simple. Punteros: no son parte de SOAP. Sin embargo sí están soportados los objetos multireferenciados y los objetos nil, lo que permite la serialización de estructuras que usen punteros. Arrays: los arrays de tamaño fijo están soportados a través de SOAP ENC:Array. Los arrays dinámicos se pueden usar de una forma similar. Tipos especiales: los tipos xsd:base64binary, SOAP ENC:base64 y xsd:hexbinary son útiles para transmitir datos binarios tales como imágenes. Internamente son declarados como arrays dinámicos de unsigned char. Las principales funciones de la librería de gsoap para crear nuestras aplicaciones son las que aparecen en la siguiente tabla: Función Descripción soap_new() soap_init(struct soap *soap) crea e inicializa el contexto gsoap inicializa la pila gsoap (se ejecuta sólo una vez por 9

10 programa) soap_bind(struct soap *soap, char *host, int port, int backlog) soap_accept(struct soap *soap) soap_end(struct soap *soap) soap_free_temp(struct soap *soap) soap_destroy(struct soap *soap) soap_done(struct soap *soap) soap_free(struct soap *soap) soap_serve(struct soap *soap) devuelve un socket (maxreq es el tamaño máximo de la cola de peticiones). Si host es NULL entonces host es la máquina en la que está el servicio devuelve un socket esclavo destruye los datos no serializados y datos temporales (pero no las instancias de clases) destruye los datos temporales sólamente destruye las instancias de las clases cierra los sockets maestro/esclavo libera el espacio ocupado por el contexto gsoap atiende la petición de un cliente y ejecuta la función que corresponda (de las definidas en el archivo de cabecera) Para un listado completo y más detallado de las funciones disponibles así como de las características avanzadas de gsoap y ejemplos de todo tipo, se recomienda consultar el siguiente documento: Un cliente gsoap utiliza la descripción WSDL traducida a C++ para hacer la llamada al servicio implementado en el servidor: El servidor gsoap implementa varias funciones C++ que se ajustan a la descripción WSDL. Cuando 10

11 recibe una petición en formato SOAP (documento XML), ésta se traduce a los tipos nativos de C++ y se ejecuta la función C++ asociada al servicio llamado en la petición SOAP: Desarrollo de una aplicación usando gsoap. Ejemplo En esta sección se describirán en detalle los pasos necesarios para crear un servicio SOAP sencillo y el cliente asociado. Se trata del ejemplo en el que basaremos las prácticas de esta parte del curso. Para desarrollar programas que utilicen gsoap para llevar a cabo las comunicaciones, debemos bajar el paquete gsoap linux 2.7.tgz disponible en: Debemos descomprimirlo y entrar en el directorio que habrá creado: tar xvfpz gsoap linux 2.7.tgz cd gsoap linux 2.7 Como ejemplo para esta práctica desarrollaremos un ejemplo sencillo que constará de un servidor y varios clientes. El servidor estará escuchando cierto puerto por el que aceptará conexiones para recibir o enviar cadenas a los clientes. Un cliente puede conectarse para enviarle una cadena o bien para solicitarla (en este caso, el servidor toma la más antigua de las que tiene almacenadas y la envía al cliente). Para trabajar crearemos una carpeta nueva llamada ejemplo_basico Una vez que sabemos qué funcionalidad debe tener el servidor, debemos crear el fichero 11

12 funciones.h que especificará las funciones a las que se puede acceder, y los parámetros que se esperan. El contenido del fichero será similar al siguiente: //gsoap ns service name: funciones //gsoap ns service style: rpc //gsoap ns service encoding: encoded //gsoap ns service namespace: //gsoap ns service location: //gsoap ns schema namespace: urn:func int ns enviar (unsigned nodo, std::string cadena, std::string &resultado); int ns recibir(unsigned nodo, std::string &resultado); Vemos que en este ejemplo sólo permitimos dos tipos de acceso al servidor: para enviar un nuevo valor y para recibirlo. Una vez tenemos el fichero funciones.h debemos compilarlo para que gsoap nos genere todos los ficheros necesarios para manejar las comunicaciones:../bin/soapcpp2 funciones.h ** The gsoap Stub and Skeleton Compiler for C and C a ** Copyright (C) , Robert van Engelen, Genivia Inc. ** All Rights Reserved. This product is provided "as is", without any warranty. ** The gsoap compiler is released under one of the following three licenses: ** GPL, the gsoap public license, or the commercial license by Genivia Inc. Saving soapstub.h Saving soaph.h Saving soapc.cpp Saving soapclient.cpp Saving soapclientlib.cpp Saving soapserver.cpp Saving soapserverlib.cpp Using ns service name: funciones Using ns service style: rpc Using ns service encoding: encoded Using ns service location: Using ns schema namespace: urn:calc Saving funciones.wsdl Web Service description Compliance warning: operation 'ns enviar' is not compliant with WS I Basic Profile 1.0a, reason: uses SOAP encoding Compliance warning: operation 'ns recibir' is not compliant with WS I Basic Profile 1.0a, reason: uses SOAP encoding Saving soapfuncionesproxy.h client proxy Saving soapfuncionesobject.h server object Saving funciones.enviar.req.xml sample SOAP/XML request Saving funciones.enviar.res.xml sample SOAP/XML response Saving funciones.recibir.req.xml sample SOAP/XML request Saving funciones.recibir.res.xml sample SOAP/XML response Saving funciones.nsmap namespace mapping table Saving ns.xsd XML schema Compilation successful El código del proceso cliente (fichero cliente.c) es bastante sencillo, y sólo debe tener en cuenta contactar con el servidor adecuado: #include <stdlib.h> #include <stdio.h> #include <time.h> #include <math.h> 12

13 #include <iostream> #include <fstream> #include <string> #include <vector> #include <sstream> using namespace std; #include "soaph.h" #include "funciones.nsmap" // poner la IP:PUERTO del servidor const char server[] = " :9999"; struct soap soap; int main(int argc, char **argv){ if (argc < 3){ cout << "Uso: cliente [enviar recibir] cadena nodo \n"; return 1; char *accion=argv[1]; string cadena=argv[2]; unsigned nodo = atoi(argv[3]); soap_init(&soap); string resultado; if(accion[0]=='e'){ soap_call_ns enviar(&soap, server, "", nodo, cadena, resultado); cout <<" > enviar devuelve = "<<resultado<<endl; else{ soap_call_ns recibir(&soap, server, "", nodo, resultado); cout <<" > recibir devuelve = "<<resultado<<endl; soap_destroy(&soap); soap_end(&soap); soap_done(&soap); return 0; Para compilar el cliente.c debemos usar la siguiente orden: g++ Wall O2 I.. o cliente cliente.c soapc.cpp soapclient.cpp../stdsoap2.cpp El proceso servidor (fichero servidor.c) constará de un bucle infinito en el que se aceptan conexiones SOAP y las sirve, utilizando las dos funciones creadas al principio (enviar o recibir). El servidor tiene un vector de cadenas de texto donde se van almacenando las cadenas que los clientes envían, y de donde extrae la más antigua para enviarla a un cliente que lo solicite: #include <stdlib.h> #include <stdio.h> #include <time.h> #include <math.h> #include <iostream> #include <fstream> #include <string> #include <vector> #include <sstream> using namespace std; #include "soaph.h" #include "funciones.nsmap" vector<string> almacen; 13

14 unsigned accede_nodo; int main(int argc, char **argv){ int m, s; struct soap soap; soap_init(&soap); //poner la IP y PUERTO del servidor m = soap_bind(&soap, " ", 9999, 100); if (m < 0){ soap_print_fault(&soap, stderr); exit( 1); for ( ; ; ){ s = soap_accept(&soap); if (s < 0){ soap_print_fault(&soap, stderr); exit( 1); else{ if (soap_serve(&soap)!= SOAP_OK) soap_print_fault(&soap, stderr); else cout << "servido NODO="<<accede_nodo<<" ELEMS="<<almacen.size()<<endl; soap_destroy(&soap); soap_end(&soap); return 0; // el cliente envia al servidor => insertar en el vector int ns enviar(struct soap *soap, unsigned nodo, std::string cadena, std::string &resultado){ accede_nodo = nodo; almacen.push_back( cadena ); resultado = "enviar"; return SOAP_OK; // el cliente recibe del servidor => sacar del vector y devolverlo int ns recibir(struct soap *soap, unsigned nodo, std::string &resultado){ accede_nodo = nodo; if( almacen.size() > 0 ){ resultado = (string)(almacen[0]); almacen.erase( almacen.begin(), almacen.begin()+1 ); else{ resultado="<vacio>"; return SOAP_OK; Para compilar el servidor.c debemos usar la siguiente orden: g++ Wall O2 I.. o servidor servidor.c soapc.cpp soapserver.cpp../stdsoap2.cpp lm Ahora, en la máquina que hará de servidor ejecutamos el programa servidor y en una o varias máquinas ejecutamos el programa cliente Código de ejemplo para gsoap en otros lenguajes Hemos estudiado un ejemplo en detalle para Perl y otro para C++. Sin embargo casi todos los lenguajes modernos tienen módulos para desarrollar aplicaciones compatibles con SOAP. 14

15 Veamos un ejemplo de cliente SOAP programado en Axis (programación en Java). Este cliente se supone que llamará a un servidor gsoap ya activo. El ejemplo completo se puede examinar en: El primer paso trata de la creación de las clases Java del cliente. Para ello usamos el parser WSDL (WSDL2Java) y el fichero descriptor del servicio WSDL. Esto nos generará el archivo JavaTextClient.wsdl. El valor del puerto debe ser el 1444 (tenemos que editar el archivo y asegurarnos). java org.apache.axis.wsdl.wsdl2java JavaTextClient.wsdl Se creará un directorio automáticamente en el que se alojan las clases stub, locator e interfaces. El segundo paso es crear el cliente en sí. El código debemos editarlo nosotros. A continuación mostramos cómo llamar a un método de un servicio instalado en el servidor: TextService service = new TextServiceLocator(); // use the service to get a stub which implements the SDI TextServicePortType port = service.gettextservice(); // make the actual call String response = port.processdata(stringdata); Compilamos el ejemplo: javac d build <package path>javatextclient.java y lanzamos el cliente: java <package path>javatextclient ExampleOutput_RDF Otros ejemplos (programando bajo Windows) Hay servicios web programados con gsoap bastante complejos. Un ejemplo es el desarrollo de un predictor de series temporales implementado en C++ con gsoap bajo Windows. El servicio se encuentra en: services time series forecasting tutorial cpp.ashx El tutorial detallado para el desarrollo usando Visual Studio 2005 y el código fuente está en: services time series forecasting tutorial cpp.ashx 15

16 Bibliografía A. Baratloo, M. Karaul, Z. Kedem, and P. Wyckoff. Charlotte: Metacomputing on the web. In The 9 th Int'l Conference on Parallel and Distributed Computing Systems, Beck et al. HARNESS: A next generation distributed virtual machine. Future Generation Computer Systems, 15, D. Box et al. Simple object access protocol 1.1. Technical report, W3C, I. Foster and C. Kesselman. Globus: A metacomputing infrastructure toolkit. International Jnl. of Supercomputer Applications, 11(2): , A. Grimshaw and W. Wulf. The legion vision of a worldwide virtual computer. CACM, 40(1):39 45, P. Kulchenko. Soap::lite for perl. M. Neary, S. Brydon, P. Kmiec, S. Rollins, and P. Cappello. Javalin++: Scalability issues in global computing. In ACM Java Grande, pages , San Fransisco, CA, M. Neary, B. Christansen, P. Cappello, and K. Schauser. Javalin: Parallel computing on the internet. Future Generation Computing Systems, 15: , OMG. CORBA component model. Sun Microsystems. Enterprise java beans technology. Sun Microsystems. Project JXTA: Technical specification, version 1.0, UDDI. The universal description, discovery, and integration (UDDI) specification. R. van Engelen. The gsoap toolkit 2.0. Technical report, Florida State University, XMethods. XMethods service listings

17 R. van Engelen. The gsoap toolkit 2.0. Technical report, Florida State University, P.A. Castillo, M.G.Arenas, J.C. Castellano, J. J. Merelo, V.M. Rivas, G.Romero. Optimization of Multilayer Perceptrons using a Distributed Evolutionary Algorithm with SOAP. Lecture Notes in Computer Science, Volumen 2439, pp , Springer Verlag, ISSN: Granada, 2002 J.J. Merelo; J.G. Castellano; P.A. Castillo; G. Romero. Algoritmos genéticos distribuidos usando SOAP. Actas de las XII Jornadas de Paralelismo, pp , ISBN: , Valencia, 2001 J.J. Merelo; J.G. Castellano; P.A. Castillo. Algoritmos Evolutivos P2P usando SOAP. Actas del Primer Congreso Español de Algoritmos Evolutivos y Bioinspirados (AEB02). E.Alba, F.Fernández, J.A.Gómez, F.Herrera, J.I. Hidalgo, J. Lanchares, J.J. Merelo, J.M Sánchez Editores. ISBN: pp Mérida