Conceptos básicos: XML + JAVA + JDOM + SOAP + PHP

Hablemos primero un poco acerca de XML Gracias a los protocolos para conectar XML como XML-RPC,SOAP o RSS, XML sobrevivió al desastre de convertirse en un lenguaje que no aportara nada nuevo a lo existente (HTML), y que combinado con WSDL, JAVA y PHP obtenemos las herramientas más utilizadas en la red hoy en día: servicios.

XML es robusto, podemos modificar el fichero fácilmente sin que pierda su significado dramáticamente; podemos construir una estructura para moldear la forma en que se comunican nuestros servicios con los clientes y aplicaciones con diversas reglas, me gustaría que mirárais la documentación sobre XML, XML-RPC,SOAP,RSS,SAX,DOM, JDOM y WSDL que he puesto aquí (de la UGR , y también en un comprido manuales_comunicacion.rar para tenerlo en local) ya que se explican conceptos fundamentales, como el standalone de xml (para decir si la estructura del árbol documento [DOM] se construye sólo con un fichero o por medio de varios, etc.), o lo nuevo de XML que son los namespace para que dentro del nombre de la etiqueta se pueda incrustar un diccionario: <dic:alumno>…</dic:alumno>, etc.; también, indicando donde está mediante <Nombre xmlns=”url_del_diccionario_nombre”>…

Sabiendo que DTD y un esquema XSD definen de la misma forma la estructura de un XML, estos últimos XSD son los más utilizados hoy en día, porque es realmente sencillo (al menos cuando estuve construyendo zenphp me costó mucho tener reglas DTD válidas para el generador de aplicaciones php a partir de un xml) hacer dichas reglas usando XML, ya que XSD se basa en un DTD ,son los diccionarios predefenidos que se van incrustando como las muñecas rusas.

El protocolo XML funciona normalmente a través del puerto HTTP (80) y dió lugar al XML-RPC, fué más famoso que SOAP porque éste había que introducirlo mediante un conjunto de reglas propias y era pesado de hacer, actualmente existen librerías que crean los envoltorios para enviar mensajes:

XML-RPC

Ver XML-RPC en los manuales

..embebiendo tipos en parámetros y estos en valores dando forma así a las peticiones y las respuestas de los servicios.

SOAP : es ligero, tiene pocas etiquetas y casi no pesan nada, es como la evolución de XML-RPC ,al fin y al cabo, es otro envoltorio para enviar mensajes por HTTP o SMTP , (Facebook lo usa)…

WSDL: además define reglas para un servicio web…mirar la documentación propuesta anteriormente para más información…

Para empezar, veremos como conectar Java con un WSDL y obtener resultados, siguiendo los pasos:

  1. Dispondremos primero de un editor: SOAP UI ,descargar e instalar
  2. Ahora daremos con una lista de servicios de tipo WSDL, por ejemplo los servicios de DaeHosting:
    http://webservices.daehosting.com/services/
    abrimos el servicio de fechas: http://webservices.daehosting.com/services/DatesService.wso y copiamos la dirección URL de la descripción de sus servicios ,que es el fichero WSDL [un XML] que necesitamos: http://webservices.daehosting.com/services/DatesService.wso?WSDL
  3. Abrimos SOAP UI y Vamos al menú: “File -> New soapUI Project” , insertamos la URL copiada del paso anterior en “Initial WSDL/WADL” y se pondrá automáticamente el nombre a “DatesService” pero podemos ponerle el que queramos, pinchamos en “OK” y empezará a cargar los servicios que ofrece dicho WSDL. Estos aparecerán en la pestaña “Navigator” en modo árbol, seleccionamos MonthNames y desplegamos el árbol de modo que hacemos doble click sobre “Request 1” y aparecerá una ventana con el esquema XML de la petición que se realiza al servidor, las entradas se pueden identificar por el caracter “?”
  4. Vamos a pulsar en la ventana de “Request 1″ con el segundo botón del ratón->”Validate” para validar el documento y veremos que nos aparecen mensajes para que rellenemos los datos pedidos, pero antes debemos conocer qué poner en “iLanguage”, para ello, abrimos del árbol de Servicios “DateServiceSoapBinding” el “Request1” de “MainLanguages” de forma que al ejecutarlo nos aparecerá como respuesta del servidor una lista con el formato XML del WSDL del servicio con los idiomas que soporta, copiamos el valor para el español: “LANG_SPANISH” y volvemos a la ventana del “Request 1” de la Operación “MonthNames” donde ahora sí sabemos qué valor hay que poner en el tipo de dato “iLanguage”: LANG_SPANISH.  Los otros dos parámetros :  bAbbreviated y bUse13Months son booleanos, probad vosotros mismos qué diferencias hay entre poner 0 ó 1 :)
    En cualquier caso el resultado de la ejecución correcta del servicio debe de tener una pinta como esta:
  5. Acabamos de presenciar la generación de llamadas a servicios para que devuelvan el nombre de los meses en un idioma deseado, con lo que este servicio, (por ingeniería inversa) sabemos que se trata de un traductor…
  6. Combinando los servicios podemos hacer cosas realmente interesantes…probad a usar la petición de la operación MonthName para obtener el mes de Abril en Alemán por ejemplo

Ahora que sabemos como comunicar servicios con esquemas XML veamos como utilizar Java para implementar una aplicación que haga lo que nuestro querido SOAP UI hace tan fácilmente en una serie de sencillos pasos:

  1. Descargar, descomprimir y abrir el proyecto para NetBeans: Ejemplos XML para Java: aquí.
  2. Debe aparecer un problema de referencias al cargar el proyecto, para solucionarlo descargar las librerías aquí y en las propiedades del proyecto -> Librerías -> pestaña de Compilar -> quitáis las referencias rotas y añadir los ficheros JAR (que hay que descomprimir de  librerias.rar). Entonces deben desaparecer todos los errores de compilación en NetBeans…(BuildAll…)
  3. Ahora expandimos el paquete “EscribirXML.SOAP” y abrimos el fichero ClienteSOAP.java, donde vamos a reemplazar “localhost” de la línea 17 por nuestro servidor WSDL con soporte para acciones SOAP,en este caso es RFC, para mostrar que sirve para RPC también el mismo código:
    http://www.ebi.ac.uk/Tools/webservices/wsdl/WSDbfetch.wsdl
    si el tipo de Operación es SOAP en lugar de RPC, la acción SOAP la podemos leer en el editor SOAP UI en las propiedades de la Operación seleccionada
  4. Mirando el código comprender que se realiza una conexión al servidor y se envía por el método POST una petición HTTP con los parámetros establecidos (acción SOAP si se define) y se escribe en el búfer con wout.write() nuestro esquema XML, por lo tanto copiamos el WSDL del SOAP UI de la petición “Request 1” para la Operación “getSupportedDBs” (reemplazando los valores de las interrogantes como antes si es que los hay)…
  5. Para probar el ejemplo compilamos y tras hacer click con el segundo botón del ratón sobre ClienteSOAP.java  pulsamos en “Run” (Ejecutar) o bien editamos las opciones del proyecto -> run -> Main class -> “EscribirXML.SOAP.ClienteSOAP”, sin argumentos en este caso…
    El código ha de quedar así:

    package EscribirXML.SOAP;
    import java.net.*;
    import java.io.*;
     
    /**
    *
    * @author
    */
    public class ClienteSOAP {
     
    public final static String DEFAULT_SERVER
    = "http://www.ebi.ac.uk/Tools/webservices/wsdl/WSDbfetch.wsdl";
    // = "http://www.schemaweb.info/webservices/soap/SchemaWebSoap.asmx?WSDL";
    /* public final static String SOAP_ACTION
    = "http://www.schemaweb.info/webservices/methods/GetObjects";*/
     
    public static void main(String[] args) {
    String server = DEFAULT_SERVER;
    try {
    URL u = new URL(server);
    URLConnection uc = u.openConnection();
    HttpURLConnection connection = (HttpURLConnection) uc;
     
    connection.setDoOutput(true);
    connection.setDoInput(true);
    connection.setRequestMethod("POST");
    //connection.setRequestProperty("SOAPAction", SOAP_ACTION);
     
    OutputStream out = connection.getOutputStream();
    Writer wout = new OutputStreamWriter(out);
     
    wout.write(
    "<soapenv:Envelope xmlns:xsi=\""+
    "http://www.w3.org/2001/XMLSchema-instance\" "+
    "xmlns:xsd=\"http://www.w3.org/2001/XMLSchema\" "+
    "xmlns:soapenv=\"http://schemas.xmlsoap.org/soap/envelope/\" "+
    "xmlns:wsd=\"http://wsdbfetch.ws.jdbfetch.ebi.ac.uk\">"+
    "<soapenv:Header/>"+
    "<soapenv:Body>"+
    "<wsd:getSupportedDBs soapenv:encodingStyle=\""+
    "http://schemas.xmlsoap.org/soap/encoding/\"/>"+
    "</soapenv:Body>"+
    "</soapenv:Envelope>");
    wout.flush();
     
    wout.close();
     
    InputStream in = connection.getInputStream();
    int c;
    System.err.println( "\n\nCONTESTACION\n\n");
    while ((c = in.read()) != -1) System.out.write(c);
    in.close();
     
    }
    catch (IOException e) {
    System.err.println("HA DADO UNA EXCEPCION");
    System.err.println(e);
    }
     
    } // end main
     
    }
  6. La salida debe ser algo como:

Por último vamos a probar un ejemplo del análisis sintáctico de un fichero XML a través del uso de un ParserDOM, abriendo el paquete DOM.Parsear y dentro el fichero “ParserDOM.java” sólo hemos de pasarle la ruta por línea de comandos del fichero y observar los resultados… (ver ejemplos con SAX del mismo proyecto de NetBeans proporcionado)…

El Modelo Objeto Documento de Java además de servir de analizador sintáctico con el método parse(), proporciona interfaces para manejar ficheros como árboles de datos, se obtiene con parsed.getDocument(), si no existen excepciones se trata, en otro caso es que el documento no ha pasado la validación, encontraremos información de prefijo, etc. dentro del árbol…

« Volver al curso de Arquitectura de Servicios en Java+PHP

Artículos relacionados:

  1. JTR dice:

    Estoy probando este codigo para peticiones SOAP, y cuando pongo el localhost mi WSDL, me sale este error:

    java.io.IOException: Server returned HTTP response code: 415 for URL: http://….

    Con el del ejemplo si me funciona…

    • juaxix dice:

      @JTR: Qué raro, cuál es la url completa de tu WSDL? seguro que estás haciendo una llamada correcta? desde el navegador?…tómate un tiempo para explicar qué cambios has introducido en tu código…
      saludos

      • Juan Belón dice:

        Como decían en los foros del web, para que la respuesta sea del tipo XML en lugar de HTML tienes que especificarlo en la cabecera, como decía “avatarr”:

        connection.setRequestProperty(“Content-Type”, “text/xml; charset=utf-8”);

Please type the characters of this captcha image in the input box

Por favor escriba los caracteres de la imagen captcha en el cuadro de entrada

footer
jbelon © | sitemap.xml