Androcode

SOAP es uno de lo protocolos para comunicación de datos más usados auspiciado por la W3C, existiendo multitud de servicios web implementados bajo esta tecnología. Partiendo de esta situación es importante tener unos conocimientos de partida que nos permita enfrentarnos al uso de los mismos en los proyectos que emprendamos. A continuación os guiaremos en el uso de ksoap2-android, el fork de la famosa kSOAP2 library adaptado para su uso en Android.

Una vez creado nuestro proyecto Android deberemos bajarnos la librería en cuestión y incluirla en nuestro build path:

download

Llegados este punto vayamos a la miga, como acceder y consumir el web service y para ello necesitaremos una serie de variables que usaremos en los posteriores m´rtodos:

// Metodo que queremos ejecutar en el servicio web
private static final String Metodo = "GetCitiesByCountry";
// Namespace definido en el servicio web
private static final String namespace = "http://www.webserviceX.NET";
// namespace + metodo
private static final String accionSoap = "http://www.webserviceX.NET/GetCitiesByCountry";
// Fichero de definicion del servcio web
private static final String url = "http://www.webservicex.net/globalweather.asmx";

Una vez tenemos claros estos parámetros necesarios para las peticiones pasamos al siguiente paso. El protocolo SOAP se basa en cinco pasos básicamente, definir la petición (request), configurar un sobre (envelope) (define que hay en el mensaje y como procesarlo), definir el canal de transporte, hacer la llamada y recoger los datos. Estos datos ya los procesaríamos en función del caso (XML, JSON, texto plano…).

A continuación os mostramos el fragmento de código en el que realizaríamos estos pasos y que incluiríamos en aquel sitio donde deseáramos realizar la petición:

try {

	// Modelo el request
	SoapObject request = new SoapObject(namespace, Metodo);
	request.addProperty("Param", "valor"); // Paso parametros al WS

	// Modelo el Sobre
	SoapSerializationEnvelope sobre = new SoapSerializationEnvelope(SoapEnvelope.VER11);
	sobre.dotNet = true;
	sobre.setOutputSoapObject(request);

	// Modelo el transporte
	HttpTransportSE transporte = new HttpTransportSE(url);

	// Llamada
	transporte.call(accionSoap, sobre);

	// Resultado
	SoapPrimitive resultado = (SoapPrimitive) sobre.getResponse();

	Log.i("Resultado", resultado.toString());

} catch (Exception e) {
	Log.e("ERROR", e.getMessage());
}

En próximos tutoriales os mostraremos como procesar estos datos devueltos.

NOTA: Para el consumo de servicios web es necesaria la conexión a Internet y por tanto deberemos solicitar dicho permiso en el manifiesto.

<uses-permission android:name="android.permission.INTERNET"/>

Vía | Ingens Blog