Code Quality Topic

Code Quality

Code quality is what you wish past-you had cared about. These posts cover when to refactor and when to leave it alone, why premature abstraction is worse than duplication, and how to organize code so the structure reflects the problem rather than the framework.

Backend

Posted on May 14, 2026

Checked Exceptions Were a Mistake and Spring Proved It

Checked exceptions force callers to acknowledge errors, not handle them. Spring's unchecked hierarchy and the @Transactional rollback default show the cost.

Nobody Reads a 1,000-Line Diff

The math on PR review quality is brutal. Past 400 lines, defect detection collapses, approvals get rubber-stamped, and your review process is theatre.

Premature Abstraction Is Worse Than Duplication

DRY is right, but not yet. Three identical code blocks are better than one wrong abstraction that fights you for months. Wait until the pattern is obvious.

Why Component-Based Structure Beats Traditional Package-by-Layer in Java

Why organizing Java code by feature instead of by layer (controller/service/repository) gives you better modularity, easier navigation, and real encapsulation.