Consumindo Web Services (WS) em Aplicações Android. Prof. Fellipe Aleixo

Transcrição

1 Consumindo Web Services (WS) em Aplicações Android Prof. Fellipe Aleixo

2 O Que é um WS? Solução utilizada na integração de sistemas e na comunicação de aplicações diferentes Exemplo: WS que retorna as informações de um endereço dado um CEP

3 Abordagens de WS WS SOAP Comunicação através do protocolo SOAP (XML) Exporta as descrições dos serviços em WSDL Compartilha dados por serialização em XML WS RESTFul Comunicação através da infraestrutura HTTP Servidor Web é suficiente para aceitar requisições Compartilha dados por serialização em JSON

4 APIs Relacionadas WS SOAP KSOAP2 e KXML DOM e SAX escrever e ler dados em XML WS RESTFul Restlet Jersey GSON e Jackson escrever e ler dados em JSON

5 Mais detalhes sobre o WS SOAP

6 KSOAP2 Framework para permitir o acesso à WS baseados em SOAP Para utilizar: Criar um projeto Android e adicionar a respectiva biblioteca ao Build Path do projeto ksoap2-j2se-full jar Download:

7 Exemplo KSOAP2 Acessando um WS definido em.net Interface do WS: using System; namespace Exemple { public interface ICurrencyService { decimal Convert(string from, string to, decimal value);

8 Exemplo KSOAP2 Implementação do acesso ao WS em uma classe específica ConvertService package br.edu.ifrn.exemplo; import org.ksoap2.soapenvelope; import org.ksoap2.serialization.soapobject; import org.ksoap2.serialization.soapprimitive; import org.ksoap2.serialization.soapserializationenvelope; import org.ksoap2.transport.httptransportse; public class ConvertService {... // FIM da classe

9 public class ConvertService { private static final String SOAP_ACTION = " private static final String METHOD = "Convert"; private static final String NAMESPACE = " private static final String URL = " public String Convert(String fromcurr, String tocurr, String amount) { SoapObject request = new SoapObject(NAMESPACE, METHOD); request.addproperty("from", fromcurr); request.addproperty("to", tocurr); request.addproperty("value", amount); SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER11); envelope.dotnet = true; envelope.setoutputsoapobject(request);

10 try { HttpTransportSE androidhttptransport = new HttpTransportSE(URL); androidhttptransport.call(soap_action, envelope); SoapPrimitive result = (SoapPrimitive) envelope.getresponse(); return result.tostring(); catch (Exception e) { return e.getmessage(); // FIM da classe

11 Exemplo KSOAP2 A classe que encapsula a comunicação é então invocada a partir de uma Activity package br.edu.ifrn.exemplo; import android.app.activity; import android.os.bundle; import android.view.view; import android.widget.edittext; import android.widget.spinner; public class Main extends Activity {... // Fim da Activity

12 public class Main extends Activity { private Spinner fromcurrencyspinner; private Spinner tocurrencyspinner; private EditText amountedit; private EditText public void oncreate(bundle savedinstancestate) { super.oncreate(savedinstancestate); setcontentview(r.layout.main); bindcontrols(); private void bindcontrols() { fromcurrencyspinner = (Spinner) findviewbyid(r.id.from_currency_edit); tocurrencyspinner = (Spinner) findviewbyid(r.id.to_currency_edit); amountedit = (EditText) findviewbyid(r.id.amount_edit); resultedit = (EditText) findviewbyid(r.id.result_edit);

13 public void onconvertbtnclick(view v) { String fromcurrency = (String) fromcurrencyspinner.getselecteditem(); String tocurrency = (String) tocurrencyspinner.getselecteditem(); String amount = amountedit.gettext().tostring(); ConvertService service = new ConvertService(); String result = service.convert(fromcurrency, tocurrency, amount); resultedit.settext(result); // Fim da Activity

14 AndroidManifest.xml <?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android=" package="br.com.zbra.android.sample" android:versioncode="1" android:versionname="1.0"> <uses-sdk android:minsdkversion="8" /> <uses-permission android:name="android.permission.internet /> <application <activity android:name=".main" <intent-filter> <action android:name="android.intent.action.main" /> <category android:name="android.intent.category.launcher" /> </intent-filter> </activity> </application> </manifest>

15 Resultado

16 Mais detalhes sobre o WS RESTFUL

17 Consumindo um WS RESTFul Facilita a comunicação entre aplicações móveis e sistemas executando em servidores Web ou de aplicação Também requer a permissão: android.permission.internet Troca dados no formato JSON

18 Acessando o Serviço Duas APIs que podem ser utilizadas para enviar requisições para servidores Web E receberem as respectivas respostas (1) Apache HTTP Client (2) HttpUrlConnection (preferida)

19 Exemplo com HttpUrlConnection public static JSONObject requestwebservice(string serviceurl) { disableconnectionreuseifnecessary(); HttpURLConnection urlconnection = null; try { URL urltorequest = new URL(serviceUrl); urlconnection = (HttpURLConnection) urltorequest.openconnection(); urlconnection.setconnecttimeout(connection_timeout); urlconnection.setreadtimeout(dataretrieval_timeout); int statuscode = urlconnection.getresponsecode(); if (statuscode == HttpURLConnection.HTTP_UNAUTHORIZED) { // handle unauthorized (if service requires user login) else if (statuscode!= HttpURLConnection.HTTP_OK) { // handle any other errors, like 404, 500,.. InputStream in = new BufferedInputStream(urlConnection.getInputStream()); return new JSONObject(getResponseText(in));

20 Exemplo com HttpUrlConnection try {... catch (MalformedURLException e) { // URL is invalid catch (SocketTimeoutException e) { // data retrieval or connection timed out catch (IOException e) { // could not read response body (could not create input stream) catch (JSONException e) { // response body is no valid JSON string finally { if (urlconnection!= null) { urlconnection.disconnect(); return null;

21 Exemplo com HttpUrlConnection private static void disableconnectionreuseifnecessary() { // see HttpURLConnection API doc if (Integer.parseInt(Build.VERSION.SDK) < Build.VERSION_CODES.FROYO) { System.setProperty("http.keepAlive", "false"); private static String getresponsetext(inputstream instream) { // very nice trick from // return new Scanner(inStream).useDelimiter("\\A").next();

22 Exemplo com HttpUrlConnection public List<MyItem> findallitems() { JSONObject serviceresult = WebServiceUtil.requestWebService( " List<MyItem> founditems = new ArrayList<MyItem>(20); try { JSONArray items = serviceresult.getjsonarray("items"); for (int i = 0; i < items.length(); i++) { JSONObject obj = items.getjsonobject(i); founditems.add(new Item(obj.getInt("id"), obj.getstring("name"), obj.getboolean("active"))); catch (JSONException e) { // handle exception return founditems;

23 Enviando Parâmetros com POST URL urltorequest = new URL(urlStr); HttpURLConnection urlconnection = (HttpURLConnection) urltorequest.openconnection(); urlconnection.setdooutput(true); urlconnection.setrequestmethod("post"); urlconnection.setrequestproperty("content-type", "application/x-www-form-urlencoded");... urlconnection.setfixedlengthstreamingmode( postparameters.getbytes().length); PrintWriter out = new PrintWriter(urlConnection.getOutputStream()); out.print(postparameters); out.close(); // postparameters == param1=value1&param2=value2

24 Otimizando WS para Aplicações Móveis 1) Utilize URLs curtas 2) Envie só os dados realmente necessários 3) Nomes de atributos com dois caracteres 4) Remova cabeçalhos HTTP não necessários 5) Não renderize espaços em branco 6) Número máximo de registros para coleções 7) Siga as boas práticas ao introduzir novos serviços

25 COMPARTILHAMENTO DE INFORMAÇÕES

26 Dados no formato JSON

27 Representação JSON

28 Exemplo JSON

29 Utilizando o GSON Biblioteca Java para processamento de JSON Versão Processa JSON em arquivo ou texto

30 Utilizando o GSON Métodos: tojson(object) fromjson(string, class) Cliente c = new Cliente(); Gson gson = new Gson(); String json = gson.tojson(c);... Cliente recuperado = gson.fromjson(json, Cliente.class);