TL;DR: Use separate exception hierarchies for business and technical errors.
Problems Addressed 😔
- Confused contracts
- Mixed responsibilities and error treatment
- Difficult handling
- Poor readability
- Misleading signals
- Exceptions for expected cases
- Nested Exceptions
- Mixed exception hierarchies
- Improper error responses
- Tangled architectural concerns
- Mixed alarms
Steps 👣
- Identify business exceptions
- Identify technical exceptions
- Create two separate exception hierarchies
- Update the code to throw the right one
- Adjust handlers accordingly
Sample Code 💻
Before 🚨
public void Withdraw(int amount) {
if (amount > Balance) {
throw new Exception("Insufficient funds");
}
if (connection == null) {
throw new Exception("Database not available");
}
Balance -= amount;
}
After 👉
public class BusinessException : Exception {}
public class InsufficientFunds : BusinessException {}
public class TechnicalException : Exception {}
public class DatabaseUnavailable : TechnicalException {}
public void Withdraw(int amount) {
if (amount > Balance) {
throw new InsufficientFunds();
}
if (connection == null) {
throw new DatabaseUnavailable();
}
Balance -= amount;
}
Type 📝
[X] Manual
Safety 🛡️
This refactoring is safe if you apply it gradually and update your code with care.
You must ensure all thrown exceptions are caught at the proper architectural level.
Why is the Code Better? ✨
You make the code clearer and more predictable.
You express technical failures and business rules separately, taking corrective actions with different stakeholders.
You also reduce confusion for the caller and improve
maintainability.
How Does it Improve the Bijection? 🗺️
This refactoring strengthens the mapping between real-world concepts and code representation.
In reality, business rule violations and technical failures are fundamentally different situations.
Business exceptions represent expected alternative flows in your domain model.
Technical exceptions represent unexpected system problems that break the execution environment.
By separating these concerns, your code more accurately reflects the real-world distinction between "business says no" and "system cannot proceed".
Limitations ⚠️
You need discipline to maintain two hierarchies.
If you misuse them, the benefits are lost. You also need to communicate the contract clearly to the clients of your code.
You should also create your own integrity tests to enforce these rules.
Refactor with AI 🤖
Suggested Prompt: 1. Identify business exceptions 2. Identify technical exceptions 3. Create two separate hierarchies 4. Update code to throw the right one
- Adjust handlers accordingly
Level 🔋
[X] Intermediate
Credits 🙏
Image by Ottó on Pixabay
This article is part of the Refactoring Series.
