Serviços Distribuídos com Spring

Arquitetura de microsserviços distribuídos usando Spring Boot e MongoDB. Demonstra comunicação entre serviços via OpenFeign, sincronização de dados com API externa (JsonPlaceholder), e gerenciamento de posts e comentários com persistência NoSQL.

---

Funcionalidades

Gerenciamento de Posts

• Sincronização de posts da API JsonPlaceholder
• CRUD completo: Criar, listar, buscar, atualizar e deletar posts
• Persistência em MongoDB

Gerenciamento de Comentários

• Sincronização de comentários da API JsonPlaceholder
• CRUD completo: Criar, listar, buscar, atualizar e deletar comentários
• Relacionamento com posts

Arquitetura Distribuída

• Comunicação entre serviços via OpenFeign
• Separação de responsabilidades: Gateway vs Data Service
• Integração com API externa (JsonPlaceholder)
• Banco de dados NoSQL (MongoDB)

---

Arquitetura

Arquitetura de Microsserviços

graph TB
    subgraph "Client Layer"
        Client[Cliente<br/>Postman/Frontend]
    end
    
    subgraph "MicroserviceA - Gateway Layer"
        MSA[MicroserviceA<br/>Port 8080<br/>Client-Facing API]
        FeignClient[OpenFeign Client]
    end
    
    subgraph "MicroserviceB - Data Layer"
        MSB[MicroserviceB<br/>Port 8081<br/>Data Management API]
        Controller[Controllers<br/>Posts & Comments]
        Service[Services<br/>Business Logic]
        Repository[Repositories<br/>MongoDB Access]
    end
    
    subgraph "Data Store"
        MongoDB[(MongoDB<br/>Port 27017<br/>Database)]
    end
    
    subgraph "External Services"
        JsonAPI[JsonPlaceholder API<br/>jsonplaceholder.typicode.com]
    end
    
    Client -->|HTTP REST| MSA
    MSA -->|OpenFeign| FeignClient
    FeignClient -->|HTTP| MSB
    MSB --> Controller
    Controller --> Service
    Service --> Repository
    Repository -->|CRUD| MongoDB
    Service -->|Sync Data| JsonAPI

Loading

Comparação dos Microsserviços

Aspecto	MicroserviceA (Gateway)	MicroserviceB (Data API)
Porta	8080	8081
Propósito	Cliente externo, gateway	Lógica de dados e persistência
Responsabilidades	Receber requisições, delegar para B	CRUD, sync com JsonPlaceholder, MongoDB
Banco de Dados	Não acessa diretamente	MongoDB (posts, comments)
Comunicação	OpenFeign (cliente HTTP)	REST API (servidor)
Dependências	MicroserviceB	MongoDB, JsonPlaceholder API

Fluxo de Comunicação (OpenFeign)

sequenceDiagram
    actor User
    participant MSA as MicroserviceA<br/>(Port 8080)
    participant Feign as OpenFeign Client
    participant MSB as MicroserviceB<br/>(Port 8081)
    participant DB as MongoDB
    
    Note over User,DB: Exemplo: Criar Post
    
    User->>+MSA: POST /api/posts<br/>{userId, title, body}
    MSA->>+Feign: createPost(postDTO)
    Feign->>+MSB: POST http://localhost:8081/api/posts
    MSB->>MSB: Validar dados
    MSB->>DB: Salvar post
    DB-->>MSB: Post salvo (id gerado)
    MSB-->>-Feign: 201 Created {post}
    Feign-->>-MSA: PostDTO
    MSA-->>-User: 201 Created {post}

Loading

Fluxo de Sincronização de Dados

sequenceDiagram
    actor Admin
    participant MSB as MicroserviceB
    participant JsonAPI as JsonPlaceholder API
    participant DB as MongoDB
    
    Note over Admin,DB: Sincronizar Posts
    
    Admin->>+MSB: POST /api/posts/syncData
    MSB->>+JsonAPI: GET /posts
    JsonAPI-->>-MSB: 100 posts JSON
    
    loop Para cada post
        MSB->>MSB: Mapear JSON para entity
        MSB->>DB: Salvar post
    end
    
    MSB-->>-Admin: 200 OK "Posts sincronizados"

Loading

---

Tecnologias

Backend

Tecnologia	Versão	Propósito
Java	17	Linguagem de programação
Spring Boot	3.4.0	Framework de aplicação
Spring Web	6.x	APIs REST
Spring Data MongoDB	4.x	Persistência NoSQL
Spring Cloud OpenFeign	4.x	Comunicação entre microsserviços
Maven	3.6+	Build e gerenciamento de dependências

Banco de Dados

Tecnologia	Versão	Propósito
MongoDB	4.4+	Banco de dados NoSQL

---

Uso

Executando os Serviços

IMPORTANTE: Execute sempre MicroserviceB antes de MicroserviceA, pois A depende de B.

Terminal 1: MicroserviceB

cd microserviceB
mvn spring-boot:run

Terminal 2: MicroserviceA

cd microserviceA
mvn spring-boot:run

Setup Inicial de Dados

Após iniciar ambos os serviços, sincronizar dados do JsonPlaceholder:

# 1. Sincronizar posts (100 posts)
curl -X POST http://localhost:8081/api/posts/syncData

# 2. Sincronizar comentários (500 comments)
curl -X POST http://localhost:8081/api/posts/syncDataComments

# 3. Verificar dados no MongoDB
mongo Desafio2_Lord-of-Springs
db.posts.count()        # Deve retornar 100
db.comments.count()     # Deve retornar 500

Exemplos de Uso

1. Listar todos os posts

curl http://localhost:8080/api/posts

2. Buscar post por ID

curl http://localhost:8080/api/posts/1

3. Criar novo post

curl -X POST http://localhost:8080/api/posts \
  -H "Content-Type: application/json" \
  -d '{
    "userId": 1,
    "title": "Meu novo post",
    "body": "Este é o conteúdo do meu post"
  }'

4. Atualizar post

curl -X PUT http://localhost:8080/api/posts/101 \
  -H "Content-Type: application/json" \
  -d '{
    "userId": 1,
    "title": "Post atualizado",
    "body": "Conteúdo modificado"
  }'

5. Deletar post

curl -X DELETE http://localhost:8080/api/posts/101

---

API Endpoints

MicroserviceA (Port 8080) - Gateway

Todos os endpoints delegam para MicroserviceB via OpenFeign

Posts

Método	Endpoint	Descrição
GET	/api/posts	Listar todos os posts
GET	/api/posts/{id}	Buscar post por ID
POST	/api/posts	Criar novo post
PUT	/api/posts/{id}	Atualizar post
DELETE	/api/posts/{id}	Deletar post

Comments

Método	Endpoint	Descrição
GET	/api/comments	Listar todos os comentários
GET	/api/comments/{id}	Buscar comentário por ID
POST	/api/comments	Criar novo comentário
PUT	/api/comments/{id}	Atualizar comentário
DELETE	/api/comments/{id}	Deletar comentário

---

MicroserviceB (Port 8081) - Data API

Posts

Método	Endpoint	Descrição
POST	/api/posts/syncData	Sincronizar posts do JsonPlaceholder
GET	/api/posts	Listar todos os posts
GET	/api/posts/{id}	Buscar post por ID
POST	/api/posts	Criar novo post
PUT	/api/posts/{id}	Atualizar post
DELETE	/api/posts/{id}	Deletar post

Comments

Método	Endpoint	Descrição
POST	/api/posts/syncDataComments	Sincronizar comentários do JsonPlaceholder
GET	/api/comments	Listar todos os comentários
GET	/api/comments/{id}	Buscar comentário por ID
POST	/api/comments	Criar novo comentário
PUT	/api/comments/{id}	Atualizar comentário
DELETE	/api/comments/{id}	Deletar comentário

---

Estrutura do Projeto

distributed-services-spring/
├── microserviceA/                 # Gateway Service
│   ├── src/main/java/
│   │   ├── controller/            # REST Controllers
│   │   ├── feign/                 # OpenFeign Clients
│   │   ├── dto/                   # Data Transfer Objects
│   │   └── MicroserviceAApp.java
│   └── pom.xml
│
├── microserviceB/                 # Data Service
│   ├── src/main/java/
│   │   ├── controller/            # REST Controllers
│   │   ├── service/               # Business Logic
│   │   ├── repository/            # MongoDB Repositories
│   │   ├── model/                 # Entities
│   │   └── MicroserviceBApp.java
│   └── pom.xml
│
└── swagger.json                   # API Documentation

---

Contribuidores

Este projeto foi desenvolvido por:

• Gabriel Felipe Birck
• Guilherme Marschall
• João Pedro Ferreira Ponchiroli
• Matheus Gotardo Reato
• Ruan Carlos Dalla Rosa