CONSUMER-API

Objetivo do projeto

O projeto tem como objetivo consumir a api do site https://openweathermap.org/ nele estão armazenados todos os dados meteorologicos do mundo inteiro, através da latitude e longitude da cidade/pais é possivel acessar os dados meteorologicos da cidade/pais solicitados

✔️ Técnicas ferramentas e tecnologias utilizadas

• Java 8
• InteliJ IDEA
• Insomnia
• PostgreSQL
• Paradigma de orientação a objetos
• Design Pattern

Frameworks utilizados:

jpa:

framework utilizado para persistencia de objetos

hibernate:

framework utilizado para mapear os relacionamentos das entidades.

org.json:

framwork utilizado para trabalhar com json retornado nos requests feitos.

swagger-ui:

framework de documentação onde ficam disponiveis todos os end-points da api

com.vladmihalcea:

framwork utilizado para tipos de dados objetivo dele na api é salvar tipo de dado jsonb no banco

Configurando ambiente do projeto

1ª - Crie um banco de dados chamado workdbtest

-- Database: workdbtest

-- DROP DATABASE IF EXISTS workdbtest;

CREATE DATABASE workdbtest
   WITH
   OWNER = postgres
   ENCODING = 'UTF8'
   LC_COLLATE = 'Portuguese_Brazil.1252'
   LC_CTYPE = 'Portuguese_Brazil.1252'
   TABLESPACE = pg_default
   CONNECTION LIMIT = -1
   IS_TEMPLATE = False;
   

2ª Faça um clone da aplicação

• git clone https://github.com/Felipeisantos/consumer-api
• cd consumer-api

3º Edite os campos de usuario se senha no arquivo: aplication.properties

spring.datasource.username=postgres
spring.datasource.password=admin

4º Não se preocupe com as tabelas, elas serão geradas automaticamente pela aplicação caso queira desabilitar é só alterar para none o parametro do ddl-auto

spring.jpa.hibernate.ddl-auto = none

Usando o maven para executar a aplicação

1º no diretorio da aplicação com o apache maven instalado, abra o terminal e execute o seguinte comando

mvn spring-boot:run

2ª Quando a api for iniciada, você pode fazer as requisições pelo insomnia postman etc e ainda acessar o swagger da aplicação

http://localhost:8080/swagger-ui/index.html

Existem 2 end-points principais usados na api

Uma requisição POST que é passado como parametro Json o nome da cidade

/api/weatherforecast/

{
	"cityname":"campinas"
}

Uma requisição GET que é passasdo via url o id da cidade que foi salvo no banco de dados

/api/weatherforecast/{id}

Tambem é possivel acessar todo o historico de consultas através do end-point

/api/consulthistory