El patrón Repository en la Arquitectura Limpia
Implemente el patrón Repository para abstraer el acceso a los datos y permitir que los casos de uso interactúen con la persistencia sin conocer sus detalles.
El patrón Repository en la Arquitectura Limpia es una lección gratuita de Clean Architecture & Design Patterns in Practice en CoddyKit. Esta es la lección 1 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Clean Architecture & Design Patterns in Practice, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Clean Architecture & Design Patterns in Practice incluye 4 lecciones en total.
Partes de esta lección aún no han sido traducidas y se muestran en inglés.
What's the Repository Pattern?
In Clean Architecture, we want our core business logic (Use Cases) to be independent of external details like databases or web frameworks.
The Repository Pattern helps achieve this by abstracting the way data is stored and retrieved. It acts as a mediator between the domain and data mapping layers.
The Problem: Direct Data Access
Imagine your Use Case directly querying a database or calling an ORM (Object-Relational Mapper) like Hibernate or Entity Framework.
- Your Use Case becomes coupled to the database technology.
- Changing the database means changing the Use Case.
- Testing Use Cases requires a live database connection.
This violates the Dependency Rule of Clean Architecture, which states that dependencies should only point inwards.
Introducing the Repository Interface
The solution is to define an interface (a contract) for data access within your Use Case layer. This interface is the Repository.
It declares methods like findById(), save(), or findAll(). The Use Case layer owns this interface, meaning it defines what data operations it needs.
Code: User & Repository Interface
First, we define a simple User entity. Then, the UserRepository interface specifies the contract for how we'll interact with User data.
public class User {
String id;
String name;
public User(String id, String name) {
this.id = id; this.name = name;
}
public String getId() { return id; }
public String getName() { return name; }
@Override public String toString() {
return name + " (" + id + ")";
}
}
public interface UserRepository {
User findById(String id);
void save(User user);
}
public class Main {
public static void main(String[] args) {
System.out.println("User entity and UserRepository interface defined.");
}
}Repository Implementations
While the interface lives in your core domain, the concrete implementation of the Repository lives in an outer layer, typically the 'Interface Adapters' or 'Frameworks/Drivers' layer.
This implementation knows the details of the specific persistence technology (e.g., SQL database, NoSQL database, external API, or even in-memory storage).
Code: In-Memory Implementation
Here's an example of an InMemoryUserRepository. It implements the UserRepository interface using a simple HashMap, simulating a database for testing or simple applications.
// Assume User and UserRepository exist
import java.util.HashMap;
import java.util.Map;
public class InMemoryUserRepository implements UserRepository {
private final Map<String, User> users = new HashMap<>();
@Override
public User findById(String id) {
return users.get(id);
}
@Override
public void save(User user) {
users.put(user.getId(), user);
}
}
public class Main {
public static void main(String[] args) {
InMemoryUserRepository repo = new InMemoryUserRepository();
User newUser = new User("001", "Charlie");
repo.save(newUser);
User found = repo.findById("001");
System.out.println("Found user: " + found.getName());
}
}Use Cases & Repositories
A Use Case receives an instance of the UserRepository interface through dependency injection (e.g., via its constructor).
The Use Case then calls methods on this interface, completely unaware of whether it's talking to an in-memory map, a SQL database, or a remote API. This is true decoupling!
Code: Use Case with Repository
This CreateUserUseCase depends only on the UserRepository interface, not its specific implementation. This makes it highly testable and flexible.
// Assume User, UserRepository, InMemoryUserRepository exist
public class CreateUserUseCase {
private final UserRepository userRepository;
public CreateUserUseCase(UserRepository userRepository) {
this.userRepository = userRepository;
}
public User execute(String id, String name) {
User newUser = new User(id, name);
userRepository.save(newUser);
return newUser;
}
}
public class Main {
public static void main(String[] args) {
// Inject the in-memory implementation
UserRepository repo = new InMemoryUserRepository();
CreateUserUseCase createUser = new CreateUserUseCase(repo);
User createdUser = createUser.execute("002", "Diana");
System.out.println("Created user: " + createdUser.getName());
User found = repo.findById("002");
System.out.println("Verified in repo: " + found.getName());
}
}Benefits of Repositories in Clean Arch
Using the Repository Pattern offers significant advantages:
- Decoupling: Business rules are isolated from data storage details.
- Testability: Use Cases can be tested with mock or in-memory repositories.
- Flexibility: Easily swap data sources (e.g., from SQL to NoSQL) without changing core logic.
- Maintainability: Changes in data access technology are localized to repository implementations.
Quick Check on Repositories
The Repository Pattern is a cornerstone for maintaining separation of concerns in Clean Architecture.
Repository Pattern: Recap
You've learned about the Repository Pattern and its crucial role in Clean Architecture!
- It abstracts data access from your core business logic.
- It uses an interface (owned by the domain) and concrete implementations (in outer layers).
- This approach greatly enhances decoupling, testability, and flexibility.
By implementing Repositories, you ensure your Use Cases remain clean, focused, and independent of external data storage mechanisms.
Preguntas frecuentes
¿La lección «El patrón Repository en la Arquitectura Limpia» es gratis?
Sí — el texto completo de «El patrón Repository en la Arquitectura Limpia» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Clean Architecture & Design Patterns in Practice, actualiza a CoddyKit PRO. El curso de Clean Architecture & Design Patterns in Practice incluye 4 lecciones en total.
¿Qué aprenderé en «El patrón Repository en la Arquitectura Limpia»?
Implemente el patrón Repository para abstraer el acceso a los datos y permitir que los casos de uso interactúen con la persistencia sin conocer sus detalles. Practicas Clean Architecture & Design Patterns in Practice con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar Clean Architecture & Design Patterns in Practice?
No se requiere experiencia previa. Clean Architecture & Design Patterns in Practice en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 1 de 4.
¿Cuánto tiempo toma la lección «El patrón Repository en la Arquitectura Limpia»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de Clean Architecture & Design Patterns in Practice?
Sí. Cada lección de Clean Architecture & Design Patterns in Practice incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- El patrón Repository en la Arquitectura Limpia
- Interfaces Gateway para sistemas externos
- Data Mappers y DTO
- Capas anticorrupción para API de terceros