Acessando um Web Service

6.1 - Integração entre sistemas

No capítulo anterior resolvemos o problema de como interpretar os dados oriundos de um arquivo XML, apesar disso, no mundo real, dados são gerados dinamicamente a todo instante das mais diversas fontes.

No mercado de bolsa de valores é comum o uso de aplicações que permitem aos seus usuários analisar o mercado, e até mesmo comprar e vender ações em tempo real. Mas como é possível analisar o mercado se não temos acesso aos dados da Bovespa?

A integração e a comunicação com o sistema da Bovespa se faz necessária para que possamos receber dados sempre atualizados. Geralmente essa comunicação se dá pelo próprio protocolo da web, o HTTP, com o formato difundido e já estudado XML. Essa integração e comunicação entre aplicações possui o nome de Web Service.

6.2 - Consumindo dados de um Web Service

Para consumir dados vindos de outra aplicação, a primeira coisa importante é saber onde essa aplicação se encontra. Em termos técnicos, qual a URL desse web service. Em nosso projeto a URL específica da aplicação será http://argentumws.caelum.com.br/negociacoes.

Podemos testar essa URL facilmente dentro do navegador, basta copiar e colar na barra de endereço. Ao executar, o navegador recebe como resposta o XML de negócios que já conhecemos, por exemplo:

6.3 - Criando o cliente Java

Já sabemos de onde consumir, resta saber como consumir esses dados pela web. No mundo web trabalhamos com o conceito de requisição e resposta. Se queremos os dados precisamos realizar uma requisição para aquela URL, mas como?

Na própria API do Java temos classes que tornam possível essa tarefa. Como é o caso da classe URL que nos permite referenciar um recurso na Web, seja ele um arquivo ou até mesmo um diretório.

URL url = new URL("http://argentumws.caelum.com.br/negociacoes");

Conhecendo a URL falta agora que uma requisição HTTP seja feita para ela. Faremos isso através do método openConnection que nos devolve um URLConnection. Entretanto, como uma requisição HTTP se faz necessária, usaremos uma subclasse de URLConnection que é a HttpURLConnection.

URL url = new URL("http://argentumws.caelum.com.br/negociacoes");
HttpURLConnection connection = (HttpURLConnection) url.openConnection();

Dessa conexão pediremos um InputStream que será usado pelo nosso LeitorXML.

URL url = new URL("http://argentumws.caelum.com.br/negociacoes");
HttpURLConnection connection = (HttpURLConnection) url.openConnection();
InputStream content = connection.getInputStream();
List<Negociacao> negociacoes = new LeitorXML().carrega(content);

Dessa forma já temos em mãos a lista de negociações que era o nosso objetivo principal. Resta agora encapsularmos este código em alguma classe, para que não seja necessário repeti-lo toda vez que precisamos receber os dados da negociação. Vamos implementar a classe ClienteWebService e nela deixar explícito qual o caminho da aplicação que a conexão será feita.

public class ClienteWebService {

  private static final String URL_WEBSERVICE  =
    "http://argentumws.caelum.com.br/negociacoes";
}

Por último, e não menos importante, declararemos um método que retorna uma lista de negociações, justamente o que usaremos no projeto.

public class ClienteWebService {

  private static final String URL_WEBSERVICE  =
    "http://argentumws.caelum.com.br/negociacoes";

  public List<Negociacao> getNegociacoes() {

    URL url = new URL(URL_WEBSERVICE);  
    HttpURLConnection connection = (HttpURLConnection)url.openConnection();
    InputStream content = connection.getInputStream();
    return new LeitorXML().carrega(content);
  }
}

Nossa classe ainda não compila, pois tanto o construtor de URL quanto os métodos de HttpURLConnection lançam exceções que são do tipo IOException. Vamos tratar o erro e fechar a conexão que foi aberta pelo método getInputStream, em um bloco finally.

...
public List<Negociacao> getNegociacoes() {

  HttpURLConnection connection = null;

  try {
      URL url = new URL(URL_WEBSERVICE);      
      connection = (HttpURLConnection)url.openConnection();
      InputStream content = connection.getInputStream();    
      return new LeitorXML().carrega(content);
  } catch (IOException e) {
    throw new RuntimeException(e);
  } finally {
    connection.disconnect();
  }
}
...

Dessa forma conseguimos nos comunicar com um Web Service e consumir os dados disponibilizados por ele através de um XML. Esta é uma prática bastante utilizada pelo mercado e estudada com mais aprofundamento no curso FJ-31 | Curso Java EE avançado e Web Services.

HttpClient client = new DefaultHttpClient();
HttpGet request = new HttpGet(URL_DO_WEBSERVICE); 
HttpResponse response = client.execute(request);
InputStream content = response.getEntity().getContent();

6.4 - Exercícios: Nosso cliente Web Service

1. Vamos agora implementar o cliente do Web Service, primeiramente criaremos a classe ClienteWebService, dentro do pacote br.com.caelum.argentum.ws na pasta src/main/java. Vamos criar também uma constante com a URL para onde será feita a requisição.

   public class ClienteWebService {
   
     private static final String URL_WEBSERVICE = 
       "http://argentumws.caelum.com.br/negociacoes";
   }
   

2. Agora vamos criar o método getNegociacoes(), que retorna a nossa lista de negociações:

   public class ClienteWebService {
   
     private static final String URL_WEBSERVICE = 
       "http://argentumws.caelum.com.br/negociacoes";
   
     public List<Negociacao> getNegociacoes() {
   
       HttpURLConnection connection = null;
   
       URL url = new URL(URL_WEBSERVICE);
   
       connection = (HttpURLConnection)url.openConnection();
       
       InputStream content = connection.getInputStream();
   
       return new LeitorXML().carrega(content);
     }
   }
   

3. Não podemos esquecer de colocar o try/catch para tratar possíveis erros e logo em seguida fechar a conexão:

   public class ClienteWebService {
   
     private static final String URL_WEBSERVICE = 
       "http://argentumws.caelum.com.br/negociacoes";
   
     public List<Negociacao> getNegociacoes() {
   
       HttpURLConnection connection = null;
       
       try {
         URL url = new URL(URL_WEBSERVICE);
   
         connection = (HttpURLConnection)url.openConnection();
           
         InputStream content = connection.getInputStream();
   
         return new LeitorXML().carrega(content);
   
       } catch (IOException e) {
         throw new RuntimeException(e);
       } finally {
         connection.disconnect();
       }
     }
   }
   

6.5 - Discussão em aula: Como testar o cliente do web service?