The Dependency Rule Explained
Grasp the fundamental Dependency Rule, which dictates that dependencies can only flow inwards, ensuring core business logic remains isolated.
The Dependency Rule Explained is a free Clean Architecture & Design Patterns in Practice lesson on CoddyKit — lesson 3 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Clean Architecture & Design Patterns in Practice learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.
The Core of Clean Architecture
Welcome to our lesson on the Dependency Rule! This principle is the cornerstone of Clean Architecture, ensuring your core business logic remains isolated and independent.
It's all about directing the flow of dependencies in your application in a very specific way.
Dependencies Flow Inwards
The fundamental idea is simple: dependencies can only flow inwards. This means outer layers of your architecture must depend on inner layers, but inner layers must never depend on outer layers.
Think of it as a one-way street, always leading towards the center of your application's logic.
Visualizing the Rule
Recall the concentric circles of Clean Architecture (Entities, Use Cases, Interface Adapters, Frameworks/Drivers). The Dependency Rule dictates that code in an outer circle can depend on code in an inner circle, but never the other way around.
- Inner layers: Core business rules, independent.
- Outer layers: UI, databases, web frameworks, external services.
Why This Rule Matters
Strictly following the Dependency Rule brings significant benefits:
- Isolation: Your core business logic is protected from changes in UI, databases, or frameworks.
- Testability: You can test your core logic without needing to set up a database or a web server.
- Flexibility: You can swap out external components (e.g., change from SQL to NoSQL, or from one web framework to another) with minimal impact on your core.
Outer Layer Calling Inward
This is the natural and allowed flow. An outer layer, like a web controller, depends on an inner layer, like a Use Case, to perform an action. The controller knows about the use case.
Try running this example:
class CreateUserUseCase {
public void execute(String username) {
System.out.println("Logic to create user: " + username);
}
}
// Outer layer (e.g., Web Controller)
class UserController {
private final CreateUserUseCase createUserUseCase;
public UserController(CreateUserUseCase useCase) {
this.createUserUseCase = useCase;
}
public String register(String username) {
createUserUseCase.execute(username);
return "User registration initiated for " + username;
}
}
public class Main {
public static void main(String[] args) {
CreateUserUseCase useCase = new CreateUserUseCase();
UserController controller = new UserController(useCase);
System.out.println(controller.register("Alice"));
}
}Inner Layer Independence
Now, what if our CreateUserUseCase (inner layer) needs to send a success message back to the UserController (outer layer)?
It cannot directly call a method on the UserController. That would mean the inner layer depends on the outer layer, breaking the Dependency Rule!
Inverting the Dependency
To solve this, we use Dependency Inversion. The inner layer (Use Case) defines an interface (often called a 'Port' or 'Output Port') that it expects to communicate through.
The outer layer (Controller/Presenter) then implements this interface and provides itself to the inner layer. This reverses the flow of dependency at compile time.
Code: Inverted Dependency
Observe how the CreateUserUseCase now depends only on its own interface, UserOutputPort. The UserController implements this port, allowing the Use Case to 'talk back' without knowing the specific UI details.
Try running this example:
// 1. Inner layer defines its 'output port' (interface)
interface UserOutputPort {
void presentUserCreationResult(String message);
}
// 2. Inner layer (Use Case) depends on its own interface
class CreateUserUseCase {
private final UserOutputPort outputPort;
public CreateUserUseCase(UserOutputPort outputPort) {
this.outputPort = outputPort;
}
public void execute(String username) {
// Simulate user creation logic
System.out.println("Processing creation for: " + username);
outputPort.presentUserCreationResult("User '" + username + "' created!");
}
}
// 3. Outer layer (e.g., Web Controller) implements the 'port'
class UserController implements UserOutputPort {
private final CreateUserUseCase createUserUseCase;
public UserController() {
// Controller provides itself as the output port
this.createUserUseCase = new CreateUserUseCase(this);
}
public void registerUser(String username) {
createUserUseCase.execute(username);
}
@Override
public void presentUserCreationResult(String message) {
System.out.println("UI Update: " + message);
}
}
public class Main {
public static void main(String[] args) {
UserController controller = new UserController();
controller.registerUser("Bob");
}
}Consequences of Breaking the Rule
Violating the Dependency Rule leads to a fragile and rigid architecture:
- Tight Coupling: Your core logic becomes tied to external details (UI, DB).
- Difficult Testing: Testing business rules requires setting up external components.
- Reduced Flexibility: Changing frameworks or databases becomes a massive undertaking.
- Leaky Abstractions: Inner layers expose knowledge of outer layers, making the system harder to understand and maintain.
Quick Check
The Dependency Rule is crucial for maintaining a clean and flexible architecture. Let's test your understanding of how dependencies should flow.
Recap: The Dependency Rule
You've learned that the Dependency Rule is the core principle of Clean Architecture, dictating that dependencies must always flow inwards, from outer layers to inner layers.
- It protects your core business logic.
- It enhances testability and flexibility.
- Dependency Inversion (using interfaces) is key to allowing inner layers to communicate outwards without direct dependencies.
Mastering this rule is essential for building robust and maintainable software systems!
Frequently asked questions
Is the “The Dependency Rule Explained” lesson free?
Yes — the full text of “The Dependency Rule Explained” is free to read here on the web, and the Clean Architecture & Design Patterns in Practice course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Clean Architecture & Design Patterns in Practice course, upgrade to CoddyKit PRO.
What will I learn in “The Dependency Rule Explained”?
Grasp the fundamental Dependency Rule, which dictates that dependencies can only flow inwards, ensuring core business logic remains isolated. You practise Clean Architecture & Design Patterns in Practice with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.
Do I need any experience to start Clean Architecture & Design Patterns in Practice?
No prior experience is required. Clean Architecture & Design Patterns in Practice on CoddyKit is structured for beginners through advanced learners; this is — lesson 3 of 4, so you can start here or from the beginning and move at your own pace.
How long does the “The Dependency Rule Explained” lesson take?
Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.
Can I write and run code in this Clean Architecture & Design Patterns in Practice lesson?
Yes. Every Clean Architecture & Design Patterns in Practice lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.
All lessons in this course
- What is Clean Architecture?
- Understanding Architectural Layers
- The Dependency Rule Explained
- Screaming Architecture and Use-Case Intent