Universidade Eduardo Mondlane

Faculdade de Ciências

Departamento de Matemática e Informática

Licenciatura em Informática

Desenvolvimento de Aplicações Web

Tema: API

Docente: Erminio Jasse

Discentes: Assane Mateus Aide

Edmison David Novela

Edson Francisco Uamusse

Leonardo Daniel Cardoso

Maputo, Novembro de 2018

Índice

1. Introdução ........................................................................................................................... 3
1.1. OkHTTP .......................................................................................................................... 4
1.2. Criando objetos de solicitação para fazer chamadas de rede .......................................... 6
1.3. Envio e recebimento de chamadas .................................................................................. 6
1.4. Para fazer chamadas assíncronas, crie também um objeto Call, mas use o
método enqueue. ..................................................................................................................... 6

2
1. Introdução

O presente guia é parte de um trabalho da cadeira de Desenvolvimento de Aplicações Web. A

essência do trabalho é mostrar o passo a passo de como consumir uma api rest usando a
linguagem de programação JAVA para desenvolver uma mini aplicação cliente. O guia
contém capturas de tela para facilitar a compreensão. A primeira parte do guia possui trechos
de código da aplicação e sua respetiva legenda. A segunda parte contem o passo a passo de
como consumir a api usando o cliente rest, no presente guia o Postman.

3
1.1. OkHTTP
OkHTTP é um projeto de código aberto projetado para ser um cliente HTTP eficiente.
Suporta o protocolo SPDY. O SPDY é a base do HTTP 2.0 e permite que várias solicitações
HTTP sejam multiplexadas em uma conexão de soquete.

Se você estiver usando o Maven ou o Gradle como gestor de dependências , basta adicionar
uma dependência ao ID do grupo com.squareup.okhttp, artifactId okhttpe à versão 2.5.0
(atual até altura em que o grupo elaborou o presente guia ).
Nota: Para o presente guia usamos o Gradle.

Requisição do token
Para efetuar a requisição do token necessitamos de um método que possibilite fazer uma
requisição (POST) para o servidor da api carregando nossas credencias e que nos retorne o
token.
Legenda
url- url a ser requisitada via POST
json- json com as credenciais
Nota: O método retornara o resultado obtido na solicitação (no nosso caso o token, se as
credenciais estiverem corretas).

4
Executando…

Usando Postman:
1 Passo: Primeiro fazemos uma requisição POST para obter o token de autenticação. Para
isso iremos utilizar o Postman com a seguinte url: http://localhost:8080/dawapi/usuario/login
Para obter o token devemos primeiro especificar o json com as credenciais que será enviado

5
2 Passo: De seguida devemos colocar uma chave Content-Type com valor application/json
e clicar em send para obter o token.

1.2. Criando objetos de solicitação para fazer chamadas de rede

Para usar o OkHttp você precisa criar um objeto de requisição.
Legenda
token- token que será usado para autenticação.
url- url a ser requisitada

1.3. Envio e recebimento de chamadas

Para fazer uma chamada de rede síncrona, use o Client para criar um objeto Call e use o
método execute .

1.4. Para fazer chamadas assíncronas, crie também um objeto Call, mas use o
método enqueue.

6
Executando

Usando Postman:
Para ter acesso aos registos usa se o método GET, efetuando uma requisição para obter todos
os usuários com a seguinte url: http://localhost:8080/dawapi/usuario
1 Passo: Devemos colocar no header o nosso token para efetuar a autenticação.