martes, 10 de diciembre de 2013

Consumir Servicios Web WCF con KSOAP2 - Android

A continuación detallo, como consumir servicios web con Android. KSOAP2, REST, y otros modos alternativos e igualmente útiles serán tratados. El mejor a vuestra elección, según la carga de la API, el dispositivo, ancho de banda disponible, etc..

De entre los más usuados en la mayoría de los casos se encuentra la librería independiente KSOAP2 creada para J2ME.. (aún me acuerdo de los cursos de master que prepare utilizando esto..) .

KSOAP2 es una librería ligera y eficiente, características imprescindibles para su utilización en entornos de aplicaciones móviles.  Desde la página del proyecto hospedado en Google Code podemos bajarnos la última versión de la librería para incluir en nuestro proyecto de Eclipse.

Pasos iniciales a seguir:

1- Bajar la última versión del jar (a fecha 7/04/2011) - http://code.google.com/p/ksoap2-android/source/browse/m2-repo/com/google/code/ksoap2-android/ksoap2-android-assembly/2.5.4/ksoap2-android-assembly-2.5.4-jar-with-dependencies.jar
2- Crear un proyecto de Android.
3- Incluir la librería en el proyecto de Eclipse.



Bueno... ya estamos listos para utilizarla. Lo primero, vamos a explicar los conceptos fundamentales.

Necesitamos datos sobre el ENDPOINT, es decir:
1- Dirección url del servicio web.
2- Namespace
3- Método a ejecutar del servicio web.
4- Derivado --> La acción SOAP a ejecutar.

Ejemplo:

1
2
3
4
private static final String url = "http://www.webservicex.net/geoipservice.asmx"; 
private static final String namespace = "http://www.webservicex.net/"; 
private static final String Metodo_GetGeoIP = "GetGeoIP"; 
private static final String accionSoap_GetGeoIP = "http://www.webservicex.net/GetGeoIP"; 
Una vez identificados los datos que necesitamos, podemos proceder a construir la solicitud al método del servicio.
  1. Primero hemos de identificar los parámetros y el tipo de datos devuelto por el método del servicio.
  2. Una vez identificados, se procede a construir la petición SOAP utilizando la clase SoapObject.
  3. Seguidamente se construye el "sobre" del mensaje SOAP: En la parametrización, se especifica el tipo de protocolo de comunicación (SOAP1.1 / 1.2, etc..) y como característica especial si el EndPoint es un servicio dotNet
  4. A la petición (objeto request) se la añaden los parámetros con el método AddProperty.
  5. Se construye el objeto de transporte para invocar el método (clase HttpTransportSE).
  6. Al invocar al método "call" de la clase "HttpTransportSE" se recogen los resultados del servicio.
  7. Finalmente se recogen los resultados utilizando el objeto devuelto (response) e invocando al método getProperty.

1
2
3
4
56
7
8
9
1011
12
13
14
1516
17
18
19
2021
22
23
24
2526
27
28
29
3031
32
33
34
3536
37
38
39
4041
public class ResultadoGeoIPService {
        private String NombrePais; 
        private String CodigoPais;
        public String getNombrePais() {
                return NombrePais;        }
        public void setNombrePais(String nombrePais) {
                NombrePais = nombrePais;
        }
        public String getCodigoPais() {                return CodigoPais;
        }
        public void setCodigoPais(String codigoPais) {
                CodigoPais = codigoPais;
        }}
 
 
 //... EN LA CLASE PROXY DEL SERVICIO ...
        public ResultadoGeoIPService GetGeoIP(String IP) throws Exception{                try {   
                   SoapObject request = new SoapObject(namespace, Metodo_GetGeoIP);
                   SoapSerializationEnvelope sobre = new SoapSerializationEnvelope(SoapEnvelope.VER11);
                   sobre.dotNet = true;
                   request.addProperty("IPAddress", IP);                   sobre.setOutputSoapObject(request);
                   
                   HttpTransportSE transporte = new HttpTransportSE(url);
                   transporte.call(accionSoap_GetGeoIP, sobre);
                   SoapObject resultado = (SoapObject) sobre.getResponse();        
                   ResultadoGeoIPService res=new ResultadoGeoIPService();
                   
                   res.setNombrePais(resultado.getProperty("CountryName").toString());
                   res.setCodigoPais(resultado.getProperty("CountryCode").toString());                   return res;
                
                }catch (Exception e){
                         throw(e);
                }         }
A continuación dejo un ejemplo de código completo en un proyecto de Eclipse. En este ejemplo encontrareís:
  • La clase "ProxyGeoIPService" que utiliza un servicio web que averigua el país de una dirección IP. También posee otro método (GetGeoIPContext) que en función de la dirección IP origen de la petición recibida devuelve el país al que corresponde la solicitud.
  • Una clase "InetManager" que permite obtener la dirección IP del dispositivo Android.

El código que dispará la invocación al servicio web lo podeís encontrar en el evento OnClick (OnClickbtnLlamarGeoIPService) del Botón de la interfaz de la actividad principal.
1
2
3
4
56
7
8
9
1011
12
13
14
1516
    private OnClickListener OnClickbtnLlamarGeoIPService = new OnClickListener() {
                public void onClick(View v) {
                        ProxyGeoIPService srvGeoIP=new ProxyGeoIPService();
                        String IP=InetManager.getLocalIpAddress();
                        lblIP.setText(IP);                        try {
                                //ResultadoGeoIPService res=srvGeoIP.GetGeoIP(IP);
                                ResultadoGeoIPService res=srvGeoIP.GetGeoIPContext();
                                lblResultado.setText(res.getNombrePais());
                        } catch (Exception e) {                                // TODO Auto-generated catch block
                                Log.e(Config.LOGKSOAP,e.toString());
                        }
 
                }            };



By. Edner Llacsa
 http://ednerllacsa.blogspot.com/

1 comentario:

  1. y luego ? el ejemplo de como funciona''?????????????????????

    ResponderEliminar