Conteúdo

Edição atualizada em 09/2024.

Kotlin é uma linguagem extremamente promissora que vem ganhando cada vez mais popularidade. Porém, ainda é percebida pelo mercado como uma linguagem focada no desenvolvimento de aplicativos para Android, e não para aplicações de backend. Kotlin permite escrita de códigos tanto sob o paradigma orientado a objetos quanto funcional, de maneira harmônica entre ambos. Ao utilizá-la para desenvolver serviços REST, é possível realizar a comunicação entre dois sistemas diferentes, pois REST estabelece um conjunto de padrões que permite realizá-lo de forma eficiente e interoperável.

Neste livro, Alexandre Saudate aborda os serviços REST pelo viés prático, explicando os conceitos conforme vamos desenvolvendo uma aplicação em Kotlin ao longo dos capítulos. Será utilizado o Spring Boot como framework para basear tudo e Gradle como controlador de build, para que você esteja o mais imerso possível no poderoso mundo Kotlin. Você vai aprender como criar um cliente para o serviço REST do Google Maps, além de como estabelecer relacionamentos, implementar testes e criar camadas de segurança. Na segunda parte do livro, você entrará ainda mais a fundo sobre APIs e até implementará algumas com ferramentas como o API Gateway da AWS e o Ngrok.

Versão utilizada do Spring Boot: 3.3.1

Assista à live de lançamento deste livro aqui.

Saiba o que você vai aprender

Sumário

Parte 1 — Serviços em REST

• 1 O que é REST, afinal?
• 1.1 Utilizando o Spring Boot para criar uma primeira API
• 1.2 O primeiro caso de uso: a listagem de novos motoristas
• 1.3 Quais são os métodos HTTP e como escolher entre eles?

• 2 Expandindo nosso serviço inicial
• 2.1 Recuperando os dados de um motorista específico
• 2.2 Conhecendo os códigos de status
• 2.3 Utilizando um cliente adequado - Introdução ao Postman
• 2.4 Negociação de conteúdo
• 2.5 Enviando dados para o servidor
• 2.6 Idempotência: os efeitos de invocações sucessivas
• 2.7 Atualizando os dados enviados com PUT e PATCH
• 2.8 Apagando os dados de um determinado motorista

• 3 Criando relacionamentos entre recursos
• 3.1 Criando a API de passageiros
• 3.2 Criando a API de solicitação de viagens
• 3.3 Criando o serviço de solicitação de viagens
• 3.4 Inserindo links: primeiro uso de HATEOAS

• 4 Criando clientes REST
• 4.1 Reorganizando o projeto
• 4.2 Criando a chave de API do Google
• 4.3 Criando o código do cliente
• 4.4 Recuperando os dados com JSONPath
• 4.5 Integrando a consulta no projeto
• 4.6 Testando a nova API

• 5 Criando os testes automatizados
• 5.1 Conhecendo as estratégias de teste
• 5.2 Criando os testes da API de passageiros com REST Assured
• 5.3 Executando o teste
• 5.4 Testes mais completos com WireMock
• 5.5 Configuração do mock do Google Maps

• 6 Segurança
• 6.1 Conhecendo HTTPS
• 6.2 Implementando HTTPS na nossa API
• 6.3 Incluindo autenticação básica
• 6.4 Criando sistema de autorização
• 6.5 Carregando os usuários pelo banco de dados
• 6.6 Atualização dos testes integrados

Parte 2 - APIs

• 7 APIs
• 7.1 Como criar URLs significativas
• 7.2 Utilização dos códigos HTTP corretos
• 7.3 Fornecer mensagens de erro significativas
• 7.4 Internacionalizando as mensagens de erro
• 7.5 Como criar uma API retrocompatível (ou: como versionar uma API)

• 8 Documentando a API
• 8.1 Criando uma documentação viva com Swagger/OpenAPI
• 8.2 Utilizando o documenter do Postman

• 9 Outras técnicas
• 9.1 Paginação
• 9.2 CORS
• 9.3 OAuth
• 9.4 AWS API Gateway

• 10 Considerações finais

• 11 Referências bibliográficas