Kotlin API

Ideia geral

Aplicação desenvolvida para praticar Kotlin com Spring Boot, Kafka e Avro.

A aplicação desenvolvida em Kotlin recebe uma requisição para criação de conta e encaminha ela via Kafka + Avro para um worker desenvolvido em Golang que irá realizar a real criação da conta.

Com a conta criada, o aplicação Kotlin irá consultar a aplicação Golang com o uso de Circuit Breaker para obter informações da conta.

Visão simplificada dos endpoints:

Tecnologias

Tecnologias utilizadas

Kotlin
Spring Boot 3
Kafka
Avro
Java 21

Como rodar a aplicação

1) Rodar docker-compose

Executar o docker-composer que está na pasta dockercompose.

Ex:

# na pasta do docker compose

docker compose up

2) Iniciar a aplicação

Compilar o Avro e iniciar a aplicação kotlin.

Pode ser iniciada com maven, por exemplo:

./mvnw clean install

./mvnw spring-boot:run

3) Criar conta

Realizar uma requisição de criação de conta.

Exemplo de requisição:

Método: POST
URL: http://localhost:8080/contas
Body:

{
    "nome" : "Nome da conta"
}

4) Buscar contas

Buscar todas as contas criadas que estão armazenadas no Redis.

A busca utiliza Circuit Breaker e Retry do Resilience4J.

Exemplo de requisição:

Método: GET
URL: http://localhost:8080/contas
Response:

[
  {
    "user": "Conta 27"
  },
  {
    "user": "Conta 26"
  }
]

Erros comuns

Servidor local com WSL2 e conexão recusada

Caso o app em Golang ou o Docker Compose sejam iniciados via terminal do WSL, é possível que ocorram erros de conexão com a aplicação Kotlin.

Alguns pontos de considerações e soluções:

Windows 11

Caso se esteja utilizando Windows 11, é possível ativar o "mirroring" mode para ajustar a conexão entre a aplicação Kotlin com o server Kafka e API Golang

Windows 10

No Windows 10, iniciar o docker compose pelo Intellij permite que a aplicação
É possível utilizar o seguinte comando no CMD para realizar um mapeamento de rede com o WSL:

netsh interface portproxy add v4tov4 listenport=<windows_port> listenaddress=0.0.0.0 connectport=<WSL_port> connectaddress=<WSL_IP>

Iniciar a aplicação Golang via CMD fará com que não seja necessário mapeamento de rede

Aplicação Golang

Link para o repositório da aplicação Golang: https://github.com/arielalvesdutra/golang-api-worker

arielalvesdutra/kotlin-api

ErrorLooks like something went wrong!

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Languages

Error
Looks like something went wrong!

Packages