Consumindo dados de um Web Service com Android

Atualmente as aplica��es Android est�o cada vez mais comuns e com isso surge a necessidade delas fazerem algumas tarefas gen�ricas, como acessar a um Web Service qualquer. Por exemplo, � poss�vel acessar um servidor de aplica��o e recuperar informa��es do banco de dados.

Algo muito importante que deve ser lembrado � que NUNCA um aplicativo Android deve acessar diretamente um banco de dados para recuperar ou adicionar informa��es. Isso porque, primeiramente, n�o seria nada seguro: imagine um sistema em que uma aplica��o Android se conectasse a um banco de dados remoto e trabalhasse com os dados sem nenhum tipo de intermedi�rio. Outro ponto que devemos lembrar � que o acesso a um web service � muito importante por quest�es de padroniza��o, pois um mesmo cliente SPA (Single Page Application) pode fazer um acesso ao mesmo servidor com uma aplica��o Android ou iOS apenas seguindo um padr�o de requisi��es e interpretando corretamente as respostas.

Na pr�xima se��o vamos entender melhor como funciona esse padr�o de requisi��es.

Trabalhando com requisi��es

Para criar um web service existem muitas maneiras e a mais simples delas � usando as requisi��es GET e POST, que podem ser feitas como em um formul�rio HTML. Existe tamb�m o formato REST, que � muito utilizado atualmente e seu retorno normalmente � um JSON contendo as informa��es. Esse executa em cima do protocolo de aplica��o HTTP. Existe tamb�m o protocolo SOAP, mas esse n�o � muito utilizado por ter uma resposta um pouco exagerada para sistemas mobile.

O protocolo HTTP � definido pelas RFCs 1945 e 2616, que definem a estrutura de mensagens que ser�o trocadas entre o cliente o servidor de aplica��o. O formato geral de uma requisi��o � bem simples, pois possui uma linha onde se localiza o m�todo que requisitar�, a URL e a vers�o do protocolo.

Na Listagem 1 vemos o exemplo das linhas de cabe�alho que tem o host e que faz a requisi��o HTTP, pedindo que determinada p�gina seja exibida no browser.


GET /diretorio/pagina1.htm HTTP/1.1
Host: www.seusite.com.br
Connection: close
User-agent: Mozilla/2.0
Accept-language: en

Listagem 1. T�pica requisi��o HTTP

Como toda requisi��o, uma resposta est� atrelada a ela ap�s o processamento e a estrutura da resposta HTTP � bem parecida com a da requisi��o. Primeiro existe a linha de estado, onde se localiza a vers�o, seguida do c�digo do estado e a frase. As linhas posteriores s�o bem parecidas, como mostra a Listagem 2, com uma t�pica resposta HTTP.


HTTP/1.1 200 OK
Connection: close
Date: Wed. 04 Nov 2015 11:31:24 GMT
Server: Apache/2.0 (Unix)
Last-Modified: Wed. 04 Nov 2015 11:31:24 GMT
Content-Length: 2134
Content-type: text/html
 
(dados a serem exibidos no browser)

Listagem 2. T�pica resposta HTTP

Para entendermos na pr�tica como funcionam as requisi��es vamos fazer um teste abrindo o terminal do Linux ou do Mac, ou o prompt do Windows e digite o conte�do da Listagem 3 para ver o resultado.


telnet google.com 80
 
GET / HTTP1.1
Host: google.com

Listagem 3. Telnet

Como o objetivo do artigo n�o � o desenvolvimento de um web service e sim o consumo de seus dados, uma API online ser� utilizada e a requisi��o ser� feita para esse servidor. Sua resposta ser� interpretada, manipulada e exibida na tela da aplica��o Android. Est� ser� no formato JSON, que aprenderemos mais na pr�xima se��o.

Arquivo JSON

A API a ser usada � do site randomuser.me, que gera informa��es rand�micas sobre pessoas. Ao ser feita a requisi��o, um JSON � retornado com as informa��es a serem trabalhadas. A Listagem 4 mostra a estrutura do arquivo JSON que nos � retornada randomicamente quando o acesso � feito.


{
  "results": [
    {
      "user": {
          "gender": "female",
          "name": {
            "title": "mrs",
            "first": "jetske",
            "last": "van steen"
          },
          "location": {
            "street": "1379 twijnstraat aan de werf",
            "city": "delfzijl",
            "state": "gelderland",
            "zip": 51641
          },
          "email": "jetske.van steen@example.com",
          "username": "heavyladybug279",
          "password": "stoner",
          "salt": "48ECNLyZ",
          "md5": "cb3075f0e4f756bc8b65e366dc24335b",
          "sha1": "c1be88f6529f468c975803fabada5ff4d0feae44",
          "sha256": "8d8e3929260010615d804a6feb0fcc42db6e0cbc6ca613087f456d509dedda01",
          "registered": 916019317,
          "dob": 191584837,
          "phone": "(407)-180-6810",
          "cell": "(043)-907-1117",
          "BSN": "65431107",
          "picture": {
            "large": "https://randomuser.me/api/portraits/women/24.jpg",
            "medium": "https://randomuser.me/api/portraits/med/women/24.jpg",
            "thumbnail": "https://randomuser.me/api/portraits/thumb/women/24.jpg"
          }
      }
    }
  ],
  "nationality": "NL",
  "seed": "0933cf33c4bf81d506",
  "version": "0.7"
}

Listagem 4. Estrutura arquivo JSON

Note que as v�rias informa��es retornadas nesse arquivo JSON podem ser tratadas e exibidas sem problema algum. Mas para isso precisamos entender melhor como ser� a conex�o com o nosso servidor para ter essas informa��es, como acompanharemos na pr�xima se��o.

Conex�o com o servidor

Para captura e interpreta��o das informa��es primeiramente analisaremos a classe respons�vel por se conectar ao servidor e receber esses dados fornecidos. A Listagem 5 mostra o c�digo respons�vel por isso.


package br.com.home.webservice;
 
import java.io.BufferedReader;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.net.HttpURLConnection;
import java.net.MalformedURLException;
import java.net.URL;
 
/**
 * Created by allanromanato on 11/4/15.
 */
public class NetworkUtils {
 
    //Responsavel por carregar o Objeto JSON
    public static String getJSONFromAPI(String url){
        String retorno = "";
        try {
           URL apiEnd = new URL(url);
            int codigoResposta;
            HttpURLConnection conexao;
            InputStream is;
 
            conexao = (HttpURLConnection) apiEnd.openConnection();
            conexao.setRequestMethod("GET");
            conexao.setReadTimeout(15000);
            conexao.setConnectTimeout(15000);
            conexao.connect();
 
            codigoResposta = conexao.getResponseCode();
            if(codigoResposta < HttpURLConnection.HTTP_BAD_REQUEST){
                is = conexao.getInputStream();
            }else{
                is = conexao.getErrorStream();
            }
 
            retorno = converterInputStreamToString(is);
            is.close();
            conexao.disconnect();
 
        } catch (MalformedURLException e) {
            e.printStackTrace();
        }catch (IOException e){
            e.printStackTrace();
        }
 
        return retorno;
    }
 
    private static String converterInputStreamToString(InputStream is){
        StringBuffer buffer = new StringBuffer();
        try{
            BufferedReader br;
            String linha;
 
            br = new BufferedReader(new InputStreamReader(is));
            while((linha = br.readLine())!=null){
                buffer.append(linha);
            }
 
            br.close();
        }catch(IOException e){
            e.printStackTrace();
        }
 
        return buffer.toString();
    }
}

Listagem 5. C�digo respons�vel pela camada de rede

Ao analisar o m�todo getJSONFromAPI() nota-se que um objeto do tipo URL � instanciado. Este � respons�vel por abrir uma conex�o com o endere�o onde os dados do web service est�o localizados. J� o objeto do tipo HttpURLConnection � o respons�vel por estabelecer a conex�o utilizando o protocolo HTTP.

A Listagem 6 mostra mais detalhes sobre esse objeto: repare que um InputStream � declarado e ser� respons�vel por receber o Stream do servidor. Por fim um atributo primitivo do tipo int � teclado para receber o c�digo da resposta.


conexao = (HttpURLConnection) apiEnd.openConnection();
conexao.setRequestMethod("GET");
conexao.setReadTimeout(15000);
conexao.setConnectTimeout(15000);
conexao.connect();

Listagem 6. Fragmento de c�digo InputStream

Como o objeto conex�o � do tipo InputStream, nota-se que um cast � feito com o objeto apiEnd do tipo URL e o armazena no objeto conex�o. Isso significa que o tratamento de conex�o aberta ser� feita com o protocolo HTTP. O tipo de requisi��o � setado como GET e os tempos de timeout tamb�m s�o setados para 15000 milissegundos. Por fim, a comunica��o � estabelecida com o servidor utilizando o protocolo HTTP e o tipo de requisi��o GET. A Listagem 7 mostra a continua��o do m�todo de conex�o.


codigoResposta = conexao.getResponseCode();
if(codigoResposta < HttpURLConnection.HTTP_BAD_REQUEST){
  is = conexao.getInputStream();
}else{
 is = conexao.getErrorStream();
}
   
retorno = converterInputStreamToString(is);
is.close();
conexao.disconnect();

Listagem 7. Fragmento de c�digo recebendo dados

O c�digo da resposta � setado no atributo codigoResposta, que � um int. Dentro do bloco if pode-se notar que qualquer c�digo de resposta inferior ao c�digo contido na constante HTTP_BAD_REQUEST, que tem o valor de 400, ser� dado ao atributo is do tipo InputStream. Se a condi��o n�o for v�lida, um errorStream ser� atribu�do. O retorno recebe o resultado do m�todo, que ser� analisado em detalhes na Listagem 8, onde o is � encerrado e a conex�o fechada. Com isso o m�todo j� pode retornar o JSON para ser utilizado na aplica��o.


private static String converterInputStreamToString(InputStream is){
  StringBuffer buffer = new StringBuffer();
  try{
    BufferedReader br;
    String linha;

    br = new BufferedReader(new InputStreamReader(is));
    while((linha = br.readLine())!=null){
        buffer.append(linha);
    }

    br.close();
  }catch(IOException e){
      e.printStackTrace();
  }

  return buffer.toString();
}

Listagem 8. M�todo converterInputStreamToString

Como o retorno obtido anteriormente foi um InputStream, nossa aplica��o trabalharia muito melhor com uma String contendo o JSON completo e, como � mais f�cil fazer o parse, esse m�todo auxiliar ser� respons�vel por converter um InputStream para String.

Um StringBuilder � declarado e ser� respons�vel por montar a string JSON a ser retornada. Um BufferedReader tamb�m � declarado e ser� respons�vel por fazer a leitura do buffer InputStream, juntamente com uma String para receber a linha lida do BufferedReader.

Em seguida o objeto br � inicializado recebendo um novo InputStreamReader, que nada mais � do que a classe lida com o InputStream que foi passado por par�metro. Um while simples � feito, recebendo a linha atual e, caso seja diferente de nulo, essa linha � inserida no StringBuffer, sen�o, o loop termina e a String montada � retornada para o m�todo principal.

Vale notar que sempre que quiser um StringBuffer retornado como String � necess�rio invocar o m�todo toString() dele.

A parte de conex�o e recebimento de dados do web wervice est� conclu�da. Agora o que ser� feito s�o as transforma��es necess�rias para que as informa��es recebidas pelo JSON sejam interpretadas e exibidas na tela para o usu�rio.

Tela do usu�rio

Um objeto simples foi criado para receber as informa��es contidas no resultado do web service: trata-se de um POJO simples que cont�m v�rias Strings e um Bitmap que ser� respons�vel por armazenar uma imagem. A Listagem 9 mostra esse c�digo.


package br.com.home.webservice;
 
import android.graphics.Bitmap;
 
// Created by allanromanato on 11/4/15.
public class PessoaObj {
    private String nome;
    private String sobrenome;
    private String email;
    private String endereco;
    private String cidade;
    private String estado;
    private String username;
    private String senha;
    private String nascimento;
    private String telefone;
    private Bitmap foto;
 
    public String getNome() {
        return nome;
    }
 
    public void setNome(String nome) {
        this.nome = nome;
    }
 
    public String getSobrenome() {
        return sobrenome;
    }
 
    public void setSobrenome(String sobrenome) {
        this.sobrenome = sobrenome;
    }
 
    public String getEmail() {
        return email;
    }
 
    public void setEmail(String email) {
        this.email = email;
    }
 
    public String getEndereco() {
        return endereco;
    }
 
    public void setEndereco(String endereco) {
        this.endereco = endereco;
    }
 
    public String getCidade() {
        return cidade;
    }
 
    public void setCidade(String cidade) {
        this.cidade = cidade;
    }
 
    public String getEstado() {
        return estado;
    }
 
    public void setEstado(String estado) {
        this.estado = estado;
    }
 
    public String getUsername() {
        return username;
    }
 
    public void setUsername(String username) {
        this.username = username;
    }
 
    public String getSenha() {
        return senha;
    }
 
    public void setSenha(String senha) {
        this.senha = senha;
    }
 
    public String getNascimento() {
        return nascimento;
    }
 
    public void setNascimento(String nascimento) {
        this.nascimento = nascimento;
    }
 
    public String getTelefone() {
        return telefone;
    }
 
    public void setTelefone(String telefone) {
        this.telefone = telefone;
    }
 
    public Bitmap getFoto() {
        return foto;
    }
 
    public void setFoto(Bitmap foto) {
        this.foto = foto;
    }
}

Listagem 9. C�digo do POJO

Uma outra classe com m�todos gerais para executar as opera��es de parse e o download de imagem foi criada e pode ser observada na Listagem 10.


package br.com.home.webservice;
 
import android.graphics.Bitmap;
import android.graphics.BitmapFactory;
import android.util.Log;
 
import org.json.JSONArray;
import org.json.JSONException;
import org.json.JSONObject;
 
import java.io.IOException;
import java.io.InputStream;
import java.net.URL;
import java.text.SimpleDateFormat;
import java.util.Date;
 
/**
 * Created by allanromanato on 11/4/15.
 */
public class Utils {
 
    public PessoaObj getInformacao(String end){
        String json;
        PessoaObj retorno;
        json = NetworkUtils.getJSONFromAPI(end);
        Log.i("Resultado", json);
        retorno = parseJson(json);
 
        return retorno;
    }
 
    private PessoaObj parseJson(String json){
      try {
        PessoaObj pessoa = new PessoaObj();

        JSONObject jsonObj = new JSONObject(json);
        JSONArray array = jsonObj.getJSONArray("results");

        SimpleDateFormat sdf = new SimpleDateFormat("dd/MM/yyyy");
        Date data;

        JSONObject objArray = array.getJSONObject(0);

        JSONObject obj = objArray.getJSONObject("user");
        //Atribui os objetos que est�o nas camadas mais altas
        pessoa.setEmail(obj.getString("email"));
        pessoa.setUsername(obj.getString("username"));
        pessoa.setSenha(obj.getString("password"));
        pessoa.setTelefone(obj.getString("phone"));
        data = new Date(obj.getLong("dob")*1000);
        pessoa.setNascimento(sdf.format(data));

        //Nome da pessoa � um objeto, instancia um novo JSONObject
        JSONObject nome = obj.getJSONObject("name");
        pessoa.setNome(nome.getString("first"));
        pessoa.setSobrenome(nome.getString("last"));

        //Endereco tambem � um Objeto
        JSONObject endereco = obj.getJSONObject("location");
        pessoa.setEndereco(endereco.getString("street"));
        pessoa.setEstado(endereco.getString("state"));
        pessoa.setCidade(endereco.getString("city"));

        //Imagem eh um objeto
        JSONObject foto = obj.getJSONObject("picture");
        pessoa.setFoto(baixarImagem(foto.getString("large")));

        return pessoa;
      }catch (JSONException e){
          e.printStackTrace();
          return null;
      }
  }
 
    private Bitmap baixarImagem(String url) {
      try{
          URL endereco;
          InputStream inputStream;
          Bitmap imagem; endereco = new URL(url);
          inputStream = endereco.openStream();
          imagem = BitmapFactory.decodeStream(inputStream);
          inputStream.close();
          return imagem;
      }catch (IOException e) {
          e.printStackTrace();
          return null;
      }
  }
}

Listagem 10. Classe respons�vel por opera��es gerais

A classe mostrada na Listagem 10 est� dividida em tr�s m�todos: getInformacao, parseJson e baixarImagem.

O m�todo getInformacao retornar� um objeto do tipo PessoaObj, que ser� utilizado para popular a interface com o usu�rio. Esse m�todo � p�blico, pois � chamado fora dessa classe. Nota-se que � feita uma chamada ao m�todo est�tico getJSONFromAPI() (j� analisado na Listagem 5), e seu retorno � armazenado em um objeto do tipo String. Um log � invocado para que o desenvolvedor possa ver se as informa��es est�o chegando corretamente do servidor.

O m�todo parseJson armazena o resultado do m�todo getJSONFromAPI() em um objeto do tipo PessoaObj e este � retornado para quem o invocou. Esse m�todo � privado, pois ele ser� acessado apenas dentro de sua classe de origem. � importante notar tamb�m que ele recebe uma String com o JSON completo recebido do servidor.

O que precisamos fazer agora � o parse, ou seja, capturar nesse objeto JSON as informa��es que ser�o exibidas na interface com o usu�rio. Ser�o utilizadas tr�s classes que est�o embutidas na API do Android para que o parse seja executado: JSONArray, JSONObject, JSONException. Essas tr�s classes est�o localizadas no pacote org.json.

Ao analisar o objeto JSON contido na Listagem 4 pode-se observar um padr�o na cria��o e, a partir deste deve ser feito o parse. A Listagem 11 mostra em detalhes algumas chamadas nos n�veis mais superiores do objeto JSON.


JSONObject jsonObj = new JSONObject(json);
JSONArray array = jsonObj.getJSONArray("results");
   
SimpleDateFormat sdf = new SimpleDateFormat("dd/MM/yyyy");
Date data;
   
JSONObject objArray = array.getJSONObject(0);
   
JSONObject obj = objArray.getJSONObject("user");
//Atribui os objetos que est�o nas camadas mais altas
pessoa.setEmail(obj.getString("email"));
pessoa.setUsername(obj.getString("username"));
pessoa.setSenha(obj.getString("password"));
pessoa.setTelefone(obj.getString("phone"));
data = new Date(obj.getLong("dob")*1000);
pessoa.setNascimento(sdf.format(data));

Listagem 11. C�digo para fazer parse dos n�veis mais altos

Primeiramente um JSONObject � instanciado passando por par�metro a String que cont�m o objeto. Logo abaixo o Array chamado results � instanciado como um JSONArray. Um SimpleDateFormat � instanciado para que se possa trabalhar com a data de nascimento, o mesmo com o objeto Data. Outro JSONObject � declarado e todos os objetos que est�o contidos na primeira posi��o desse array de JSON s�o colocados nele. Notem que esse array tem apenas uma posi��o, ent�o � acessado pela posi��o 0. Agora o que � feito � atribuir o JSONObject e o conte�do do objeto user.

Por fim, os m�todos getString e getLong s�o chamados para as informa��es serem carregadas para os campos do objeto PessoaObj.

Notem a seguinte linha:


data = new Date(obj.getLong(�dob�)*1000);

Isso acontece porque a data � dada em formato EPOCH, ou seja, a quantidade de segundos passados do dia 1 de janeiro de 1970 at� a data que se quer ver, ent�o a quantidade � multiplicada por 1000, pois ser� trabalhado com milissegundos para que a classe Date possa exibi-la como uma data. Veja que o SimpleDateFormat formata para dia/m�s/ano.


//Nome da pessoa � um objeto, instancia um novo JSONObject
JSONObject nome = obj.getJSONObject("name");
pessoa.setNome(nome.getString("first"));
pessoa.setSobrenome(nome.getString("last"));
   
//Endereco tambem � um Objeto
JSONObject endereco = obj.getJSONObject("location");
pessoa.setEndereco(endereco.getString("street"));
pessoa.setEstado(endereco.getString("state"));
pessoa.setCidade(endereco.getString("city"));
   
//Imagem eh um objeto
JSONObject foto = obj.getJSONObject("picture");
pessoa.setFoto(baixarImagem(foto.getString("large")));
   
return pessoa;

Listagem 12. C�digo para fazer parse em n�veis inferiores

Nota-se na Listagem 12 que novos objetos JSON devem ser instanciados, isso ocorre por estarem em subn�veis. Por exemplo, dentro do n�vel user existe o subn�vel name, que cont�m as informa��es de nome e sobrenome, e o mesmo ocorre com endere�o. Nesse fragmento de c�digo n�o tem muito segredo, pois apenas � preciso saber quais s�o os n�veis e subn�veis e ir instanciando. Seus conte�dos tamb�m s�o carregados e armazenados nos atributos do objeto PessoaObj. Por fim, pode-se notar que ao carregar o atributo foto, o m�todo baixarFoto() � invocado. Isso acontece porque o JSON traz apenas o endere�o que a foto est� localizada, portanto, deve-se fazer o download dela, para exibir na aplica��o. A Listagem 13 mostra o m�todo respons�vel por fazer o download da imagem.


private Bitmap baixarImagem(String url) {
 try{
    URL endereco;
    InputStream inputStream;
    Bitmap imagem; endereco = new URL(url);
    inputStream = endereco.openStream();
    imagem = BitmapFactory.decodeStream(inputStream);
    inputStream.close();
    return imagem;
  }catch (IOException e) {
    e.printStackTrace();
    return null;
  }
  
}

Listagem 13. M�todo baixarFoto()

Esse � um m�todo privado bem simples respons�vel por converter um InputStream em imagem do tipo Bitmap utilizando ao m�todo est�tico decodeStream da classe BitmapFactory.

Com isso a classe utilit�ria est� finalizada, lembrando que ela � respons�vel apenas por lidar com as informa��es carregadas da API do randomuser.me. A seguir veremos como enviar essas informa��es para o usu�rio atrav�s da activity correspondente.

Activity do usu�rio

Ser� estudado agora a activity respons�vel por controlar a interface com usu�rio e fazer o link com o XML de layout. Utilizaremos o RelativeLayout, que � bem simples e tem como estrutura o c�digo exibido na Listagem 14.


<RelativeLayout xmlns:android="http://schemas.
android.com/apk/res/android"
  xmlns:tools="http://schemas.android.com/tools" 
  android:layout_width="match_parent"
  android:layout_height="match_parent" 
  android:paddingLeft="@dimen/activity_horizontal_margin"
  android:paddingRight="@dimen/activity_horizontal_margin"
  android:paddingTop="@dimen/activity_vertical_margin"
  android:paddingBottom="@dimen/activity_vertical_margin" 
  tools:context=".MainActivity">

  <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:textAppearance="?android:attr/textAppearanceLarge"
      android:text="RandomUser"
      android:id="@+id/textView"
      android:layout_alignParentTop="true"
      android:layout_centerHorizontal="true" />

  <ImageView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/imageView"
      android:layout_below="@+id/textView"
      android:layout_alignLeft="@+id/textView"
      android:layout_marginTop="30dp"
      android:layout_alignParentLeft="true"/>

  <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/textView2"
      android:layout_below="@+id/textView3"
      android:layout_centerHorizontal="true"
      android:layout_alignParentRight="true" />

  <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/textView3"
      android:layout_below="@+id/textView4"
      android:layout_centerHorizontal="true"
      android:layout_alignParentRight="true" />

  <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/textView4"
      android:layout_below="@+id/textView7"
      android:layout_centerHorizontal="true"
      android:layout_alignParentRight="true" />

  <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/textView5"
      android:layout_below="@+id/imageView"
      android:layout_centerHorizontal="true"
      android:layout_marginTop="71dp"
      android:layout_alignParentRight="true" />

  <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Nome:"
      android:id="@+id/textView6"
      android:layout_marginLeft="24dp"
      android:layout_marginStart="24dp"
      android:layout_alignBaseline="@+id/textView5"
      android:layout_alignBottom="@+id/textView5"
      android:layout_alignParentLeft="true"
      android:layout_alignParentStart="true" />

  <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/textView7"
      android:layout_below="@+id/textView8"
      android:layout_centerHorizontal="true"
      android:layout_alignParentRight="true" />

  <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/textView8"
      android:layout_below="@+id/textView11"
      android:layout_centerHorizontal="true"
      android:layout_alignParentRight="true" />

  <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/textView9"
      android:layout_below="@+id/textView10"
      android:layout_centerHorizontal="true"
      android:layout_alignParentRight="true" />

  <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/textView10"
      android:layout_below="@+id/textView2"
      android:layout_centerHorizontal="true"
      android:layout_alignParentRight="true" />

  <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/textView11"
      android:layout_below="@+id/textView5"
      android:layout_centerHorizontal="true"
      android:layout_alignParentRight="true" />

  <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:id="@+id/textView12"
      android:layout_below="@+id/textView9"
      android:layout_centerHorizontal="true"
      android:layout_alignParentRight="true" />

  <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Sobrenome:"
      android:id="@+id/textView13"
      android:layout_below="@+id/textView6"
      android:layout_alignParentLeft="true"
      android:layout_marginLeft="22dp" />

  <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Email:"
      android:id="@+id/textView14"
      android:layout_below="@+id/textView13"
      android:layout_alignLeft="@+id/textView13"
      android:layout_alignStart="@+id/textView13" />

  <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Endere�o:"
      android:id="@+id/textView15"
      android:layout_below="@+id/textView14"
      android:layout_alignLeft="@+id/textView14"
      android:layout_alignStart="@+id/textView14" />

  <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Cidade:"
      android:id="@+id/textView16"
      android:layout_below="@+id/textView15"
      android:layout_alignLeft="@+id/textView15"
      android:layout_alignStart="@+id/textView15" />

  <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Estado:"
      android:id="@+id/textView17"
      android:layout_below="@+id/textView16"
      android:layout_alignLeft="@+id/textView14"
      android:layout_alignStart="@+id/textView14" />

  <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Username:"
      android:id="@+id/textView18"
      android:layout_below="@+id/textView17"
      android:layout_alignLeft="@+id/textView16"
      android:layout_alignStart="@+id/textView16" />

  <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Senha:"
      android:id="@+id/textView19"
      android:layout_below="@+id/textView18"
      android:layout_alignLeft="@+id/textView18"
      android:layout_alignStart="@+id/textView18" />

  <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Nascimento:"
      android:id="@+id/textView20"
      android:layout_below="@+id/textView19"
      android:layout_alignLeft="@+id/textView19"
      android:layout_alignStart="@+id/textView19" />

  <TextView
      android:layout_width="wrap_content"
      android:layout_height="wrap_content"
      android:text="Telefone:"
      android:id="@+id/textView21"
      android:layout_alignTop="@+id/textView12"
      android:layout_alignLeft="@+id/textView20"
      android:layout_alignStart="@+id/textView20" />
</RelativeLayout>

Listagem 14. Arquivo de layout

Repare que os elementos contidos nesse layout sempre est�o alinhados relativamente a outros. Repare tamb�m que identificamos as posi��es dos elementos utilizando ids dos outros. A Listagem 15 mostra efetivamente o c�digo da Activity, que ser� analisada.


package br.com.home.webservice;

import android.app.Activity;
import android.app.ProgressDialog;
import android.os.AsyncTask;
import android.os.Bundle;
import android.widget.ImageView;
import android.widget.TextView;


public class MainActivity extends Activity {
  private TextView nome;
  private TextView sobrenome;
  private TextView email;
  private TextView endereco;
  private TextView cidade;
  private TextView estado;
  private TextView username;
  private TextView senha;
  private TextView nascimento;
  private TextView telefone;
  private ImageView foto;
  private ProgressDialog load;

  @Override
  protected void onCreate(Bundle savedInstanceState) {
      super.onCreate(savedInstanceState);
      setContentView(R.layout.activity_main);

      GetJson download = new GetJson();

      nome = (TextView)findViewById(R.id.textView5);
      sobrenome = (TextView)findViewById(R.id.textView11);
      email = (TextView)findViewById(R.id.textView8);
      endereco = (TextView)findViewById(R.id.textView7);
      cidade = (TextView)findViewById(R.id.textView4);
      estado = (TextView)findViewById(R.id.textView3);
      username = (TextView)findViewById(R.id.textView2);
      senha = (TextView)findViewById(R.id.textView10);
      nascimento = (TextView)findViewById(R.id.textView9);
      telefone = (TextView)findViewById(R.id.textView12);
      foto = (ImageView)findViewById(R.id.imageView);

      //Chama Async Task
      download.execute();

  }

  private class GetJson extends AsyncTask<Void, Void, PessoaObj> {

      @Override
      protected void onPreExecute(){
          load = ProgressDialog.show(MainActivity.this, 
          "Por favor Aguarde ...", "Recuperando Informa��es do Servidor...");
      }

      @Override
       protected PessoaObj doInBackground(Void... params) {
          Utils util = new Utils();

          return util.getInformacao("https://randomuser.me/api/0.7");
      }

      @Override
      protected void onPostExecute(PessoaObj pessoa){
          nome.setText(pessoa.getNome().substring(0,1)
          .toUpperCase()+pessoa.getNome().substring(1));
          sobrenome.setText(pessoa.getSobrenome().substring(
          0,1).toUpperCase()+pessoa.getSobrenome().substring(1));
          email.setText(pessoa.getEmail());
          endereco.setText(pessoa.getEndereco());
          cidade.setText(pessoa.getCidade().substring(0,1)
          .toUpperCase()+pessoa.getCidade().substring(1));
          estado.setText(pessoa.getEstado());
          username.setText(pessoa.getUsername());
          senha.setText(pessoa.getSenha());
          nascimento.setText(pessoa.getNascimento());
          telefone.setText(pessoa.getTelefone());
          foto.setImageBitmap(pessoa.getFoto());
          load.dismiss();
      }
  }
}

Listagem 15. C�digo da Activity Principal

Nota-se na Listagem 15 que o m�todo onCreate � bem simples, pois apenas faz as instancia��es necess�rias para fazer a ponte entre os campos no XML e a aplica��o utilizando o m�todo findViewById, e ao final � feita a chamada de um AsyncTask.

Se n�o fizermos essa chamada nada ir� funcionar. Pode-se utilizar qualquer t�cnica que separe o processamento, tipo threads, mas o Async Task j� implementa tudo isso, facilitando o seu c�digo.

Se um processamento paralelo n�o for utilizado, uma exce��o do tipo NetworkOnMainThreadException � lan�ada. Existe uma forma de solucionar esse problema, mas � uma solu��o p�ssima do ponto de vista dos desenvolvedores Android e � mais usada como paliativo para testar a aplica��o antes de separar o processamento. Assim, o c�digo a seguir consiste em mudar as pol�ticas do Android com rela��o a sua aplica��o:


StrictMode.ThreadPolicy policy = newStrictMode.ThreadPolicy.Builder()
.permitAll().build();
.setThreadPolicy(policy);

Ao utilizar isso, podemos dizer ao Android que sua aplica��o poder� utilizar opera��es de rede na Thread principal, por�m isso � p�ssimo. Imagine uma situa��o em que as opera��es de rede est�o ocorrendo na thread principal e o servidor para de responder: em um determinado tempo sua aplica��o ser� encerrada ou o usu�rio achar� que est� tudo travado, mas ela apenas est� esperando a resposta do servidor. N�o utilizem isso para sistemas reais, pois o Async Task est� a� e resolve esses problemas sem causar danos na navega��o.

Dentro do Async Task tr�s m�todos s�o implementados: o m�todo protected void onPreExecute(), que ser� o respons�vel por exibir na tela um modal de progresso, mostrando ao usu�rio que a requisi��o dele est� em execu��o; o m�todo protected PessoaObj doInBackground(Void... params), que ir� ser o respons�vel por executar a primeira chamada que far� todo o processamento, download, parse e download de foto em uma thread separada; e por fim o m�todo protected void onPostExecute(PessoaObj pessoa), que recebe como par�metro o retorno do m�todo doInBackground, e ele � respons�vel por colocar na tela todas as informa��es contidas dentro do objeto PessoaObj e desligar o modal de progresso. Voc�s podem notar que em alguns campos o m�todo subString � chamado, mas isso � apenas para colocar a primeira letra em mai�sculo.

Por fim, n�o se pode esquecer do arquivo de manifesto, pois como a aplica��o acessar� um Web Service remoto, a permiss�o de acesso � internet deve ser dada no manifest, segundo o c�digo da Listagem 16.


<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
  package="br.com.home.webservice" >
  <uses-permission android:name="android.permission.INTERNET"/>
  <application
      android:allowBackup="true"
      android:icon="@mipmap/ic_launcher"
      android:label="@string/app_name"
      android:theme="@style/AppTheme" >
      <activity
          android:name=".MainActivity"
          android:label="@string/app_name" >
          <intent-filter>
              <action android:name="android.intent.action.MAIN" />

              <category android:name="android.intent.category.LAUNCHER" />
          </intent-filter>
      </activity>
  </application>

</manifest>

Listagem 16. Android Manifest

Na Figura 1 podem ser acompanhados os resultados da implementa��o descrita.

Pode-se aprender nesse artigo como conectar-se a um Web Service e consumir suas informa��es de forma bem simples e direta, apenas sendo necess�rios alguns conceitos de redes e de protocolo HTTP. Usamos nesse exemplo os arquivos JSON, pois eles ocupam menos espa�o que o XML e s�o altamente recomendados para o uso em dispositivos m�veis.

Confira tamb�m

Guia de REST

Guia

Um bate papo sobre REST & RESTful

V�deo

Algoritmo: O que � algoritmo

Curso

Tecnologias:

Confira outros conte�dos:

Navega��o entre telas no Android

Utiliza��o de sensores na plataforma...

Listas e Adapters no Android

Assista grátis a nossa aula inaugural

Perguntas frequentes

Quem somos?

Por que a programação se tornou a profissão mais promissora da atualidade?

Como faço para começar a estudar?

Em quanto tempo de estudo vou me tornar um programador?

Sim, você pode se tornar um programador e não precisa ter diploma de curso superior!

O que eu irei aprender estudando pela DevMedia?

Principais diferenciais da DevMedia

Qual o investimento financeiro que preciso fazer para me tornar um programador?

Como funciona a forma de pagamento da DevMedia?

Por Allan Em 2015

Coment�rios nesta publica��o Escrever um coment�rio sobre conte�do

Fabio Pereira

N�vel 15

Boa tarde parceiros!

Estou precisando ver algum conte�do para persistir dados e fotos do android num banco remoto.
Existe algum conte�do que ensine como enviar arquivos do android para uma API ao inv�s de apenas consumir dados?

Desde j�, agrade�o a todos!

há +1 ano

Ver coment�rios anteriores (6)

Marcio Souza

DevMedia

De nada Fabio, boa sorte com seu projeto.

há +1 ano

Wibson Teixeira

N�vel 3

Boa tarde! Ao executar esse exemplo esta acontecendo o seguinte erro:
08-08 19:08:22.551 30113-30113/projeto.aularest E/AndroidRuntime: FATAL EXCEPTION: main
Process: projeto.aularest, PID: 30113
java.lang.NullPointerException: Attempt to invoke virtual method 'java.lang.String projeto.aularest.PessoaObj.getNome()' on a null object reference
at projeto.aularest.MainActivity$GetJson.onPostExecute(MainActivity.java:64)
at projeto.aularest.MainActivity$GetJson.onPostExecute(MainActivity.java:49)
at android.os.AsyncTask.finish(AsyncTask.java:636)
at android.os.AsyncTask.access$500(AsyncTask.java:177)
at android.os.AsyncTask$InternalHandler.handleMessage(AsyncTask.java:653)
at android.os.Handler.dispatchMessage(Handler.java:102)
at android.os.Looper.loop(Looper.java:135)
at android.app.ActivityThread.main(ActivityThread.java:5254)
at java.lang.reflect.Method.invoke(Native Method)
at java.lang.reflect.Method.invoke(Method.java:372)
at com.android.internal.os.ZygoteInit$MethodAndArgsCaller.run(ZygoteInit.java:903)
at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:698)

O que eu tenho que fazer para corrigir?

há +1 ano

Ver coment�rios anteriores (8)

Daniella Gomes

DevMedia

Que bom q funcionou Wibson!!
Aproveito para informar que tbm fizemos a altera��o no artigo com a dica do consultor.
Tmj[]

há +1 ano

Estev�o Dias

N�vel 21

Muito bom pessoal, gostei bastante do tema!

há +1 ano

Ver coment�rios anteriores (2)

Douglas

N�vel 0

�timo elogio. ^^)

há +1 ano

Nossos casos de sucesso

Leonardo Carlos

Eu sabia pouqu�ssimas coisas de programa��o antes de come�ar a estudar com voc�s, fui me especializando em v�rias �reas e ferramentas que tinham na plataforma, e com essa bagagem consegui um est�gio logo no in�cio do meu primeiro per�odo na faculdade.

Lucas Rodrigues

Estudo aqui na Dev desde o meio do ano passado! Nesse per�odo a Dev me ajudou a crescer muito aqui no trampo.
Fui o primeiro desenvolvedor contratado pela minha empresa. Hoje eu lidero um time de desenvolvimento!
Minha meta � continuar estudando e praticando para ser um Full-Stack Dev!

Her�clito J�nior

Economizei 3 meses para assinar a plataforma e sendo sincero valeu muito a pena, pois a plataforma � bem intuitiva e muuuuito did�tica a metodologia de ensino. Sinto que estou EVOLUINDO a cada dia. Muito obrigado!

Julio Cablen

Nossa! Plataforma maravilhosa. To amando o curso de desenvolvimento front-end, tinha coisas que eu ainda n�o tinha visto. A did�tica � do jeito que qualquer pessoa consegue aprender. S�rio, to apaixonado, adorando demais.

Joelberth Sena

Adquiri o curso de voc�s e logo percebi que s�o os melhores do Brasil. � um passo a passo incr�vel. S� n�o aprende quem n�o quer. Foi o melhor investimento da minha vida!

Felipe Nunes

Foi um dos melhores investimentos que j� fiz na vida e tenho aprendido bastante com a plataforma. Voc�s est�o fazendo parte da minha jornada nesse mundo da programa��o, irei assinar meu contrato como programador gra�as a plataforma.

Wanderson Oliveira

Comprei a assinatura tem uma semana, aprendi mais do que 4 meses estudando outros cursos. Exerc�cios pr�ticos que n�o tem como n�o aprender, est�o de parab�ns!

Jos� Lucas

Obrigado DevMedia, nunca presenciei uma plataforma de ensino t�o presente na vida acad�mica de seus alunos, parab�ns!

Eduardo Dorneles

Aprendi React na plataforma da DevMedia h� cerca de 1 ano e meio... Hoje estou h� 1 ano empregado trabalhando 100% com React!

Adauto Junior

J� fiz alguns cursos na �rea e nenhum � t�o bom quanto o de voc�s. Estou aprendendo muito, muito obrigado por existirem. Est�o de parab�ns... Espero um dia conseguir um emprego na �rea.

Ver todos os casos de sucesso

Consumindo dados de um Web Service com Android

Veja nesse artigo como acessar um web service RandomUser com Android, consumindo, interpretando e exibindo seu conte�do.

Guia do artigo:

Trabalhando com requisi��es

Arquivo JSON

Conex�o com o servidor

Tela do usu�rio

Activity do usu�rio

Confira tamb�m

Guia de REST

Um bate papo sobre REST & RESTful

Algoritmo: O que � algoritmo

Confira outros conte�dos:

Navega��o entre telas no Android

Utiliza��o de sensores na plataforma...

Listas e Adapters no Android

Perguntas frequentes

Nossos casos de sucesso