1️⃣ Cliente

• Qué es: Es quien hace la solicitud a tu aplicación REST.

• Ejemplos: Un navegador web, una app móvil, Postman, u otra aplicación que consuma tu API.

• Función: Envía peticiones HTTP (GET, POST, PUT, DELETE) y recibe respuestas JSON o XML.

• Analogía: Es como un cliente que pide un producto en una tienda.

2️⃣ Controlador (Controller)

• Qué es: Es la capa que recibe las solicitudes del cliente.

• Función:

  • Escucha rutas específicas (URLs) de la API.

  • Llama al servicio para realizar la lógica del negocio.

  • Devuelve la respuesta al cliente.

• Ejemplo:

@RestController
@RequestMapping("/usuarios")
public class UsuarioController {
    @Autowired
    private UsuarioService usuarioService;

    @GetMapping("/{id}")
    public Usuario obtenerUsuario(@PathVariable Long id) {
        return usuarioService.obtenerUsuarioPorId(id);
    }
}

• Aquí, cuando el cliente pide /usuarios/1, el controlador llama al servicio para obtener el usuario con ID 1.

3️⃣ Modelo (Model)

• Qué es: Representa los datos de tu aplicación.

• Función:

  • Define la estructura de tus objetos, que usualmente se mapean a una base de datos.

  • Puede incluir clases como Usuario, Producto, Pedido, etc.

• Ejemplo:

@Entity
public class Usuario {
    @Id
    private Long id;
    private String nombre;
    private String email;
    // getters y setters
}

• Es básicamente tu "molde" de datos.

4️⃣ Servicio (Service)

• Qué es: La capa donde resides la lógica del negocio.

• Función:

  • Procesa información.

  • Valida datos.

  • Decide qué hacer con los datos antes de enviarlos al repositorio o al controlador.

• Ejemplo:

@Service
public class UsuarioService {
    @Autowired
    private UsuarioRepository usuarioRepository;

    public Usuario obtenerUsuarioPorId(Long id) {
        return usuarioRepository.findById(id).orElse(null);
    }
}

• Es como el “cerebro” que decide cómo manejar la información.

5️⃣ Repositorio (Repository)

• Qué es: La capa que interactúa directamente con la base de datos.

• Función:

  • Guardar, actualizar, eliminar y buscar datos.

  • Normalmente usa un ORM como Hibernate en Java.

• Ejemplo:

@Repository
public interface UsuarioRepository extends JpaRepository<Usuario, Long> {
}

• Aquí, no necesitas escribir SQL directamente; Spring Data lo hace por ti.

🔄 Cómo fluye todo junto en REST

1. Cliente hace una petición (GET/POST/PUT/DELETE).

2. Controlador recibe la petición y llama al servicio.

3. Servicio aplica la lógica de negocio y llama al repositorio si necesita datos de la base.

4. Repositorio obtiene o guarda los datos en la base.

5. Servicio procesa los resultados y los devuelve al controlador.

6. Controlador envía la respuesta al cliente en JSON o XML.