Antigravity Agent
7.6 KiB
category, tags, title, last_updated
| category | tags | title | last_updated | ||||
|---|---|---|---|---|---|---|---|
| Unified |
|
|
2026-05-02 |
단일 책임 원칙 (SRP)
📌 Brief Summary
단일 책임 원칙(Single Responsibility Principle, SRP)은 클래스, 모듈 또는 함수가 오직 하나의 역할(책임)만을 수행해야 하며, 코드의 변경을 요구하는 이유 또한 단 하나여야 한다는 소프트웨어 설계 원칙입니다 [1, 2]. 이는 객체 지향 프로그래밍의 핵심인 SOLID 원칙 중 하나로, 더 높은 추상화 수준의 개념인 '관심사의 분리(SoC)'를 개별 클래스나 모듈 단위에서 구체화한 것입니다 [3-6]. SRP를 준수하면 코드의 응집도를 높이고 복잡성을 줄여, 가독성과 유지보수성이 뛰어난 시스템을 구축할 수 있습니다 [2, 7].
단일 책임 원칙(SRP, Single Responsibility Principle)은 클래스나 모듈이 단 하나의 변경 이유만 가져야 한다는 소프트웨어 설계 원칙입니다 [1, 2]. 하나의 모듈에 영속성, 데이터 처리, 알림 등 여러 책임이 섞이면 코드가 불안정해지고 조그만 수정에도 예기치 않은 문제가 발생할 위험이 커집니다 [2]. 이 원칙을 준수하면 각 모듈이 한 가지 명확한 역할만 수행하게 되어, 한 영역의 코드를 수정할 때 다른 무관한 로직에 영향을 미치지 않고 안전하게 변경할 수 있습니다 [2, 3].
📖 Core Content
-
정의와 핵심 목표: SRP는 소프트웨어 구성 요소(클래스, 함수 등)가 단 하나의 관심사나 기능에만 온전히 집중해야 함을 명시합니다 [2, 8]. 예를 들어, 사용자 데이터를 저장하고 검색하는 역할을 하는 클래스가 사용자 입력 유효성 검사까지 함께 수행해서는 안 됩니다 [1]. 이 원칙의 주된 목적은 클래스를 더 이해하기 쉽고 구축하기 쉽게 만들어, 코드를 수정할 때 관련 없는 기능에 영향을 미쳐 시스템이 버그에 노출될 위험을 최소화하는 데 있습니다 [2].
-
루트 주제 '관심사의 분리(SoC)'와의 관계: SRP는 관심사의 분리(SoC) 철학을 실현하는 데 있어 가장 핵심이 되는 원칙입니다 [6]. SoC가 시스템을 구성하는 높은 추상화 수준에서 코드를 논리적인 모듈과 계층으로 뚜렷하게 격리하는 것에 초점을 맞춘다면, SRP는 그보다 낮은 개별 클래스나 모듈 수준에서 '책임'을 하나로 제한하는 데 집중합니다 [4, 7]. 모든 객체와 함수가 단 하나의 작업만 하도록 설계(SRP)하여 애플리케이션을 구축한다면, 해당 모듈들은 자연스럽게 철저히 분리된 관심사(SoC)를 형성하게 됩니다 [9]. 오늘날 SoC 철학은 이러한 SRP의 직접적인 모태로 평가받습니다 [5].
-
실무 적용 및 위반 시의 문제점: 새로운 클래스나 함수를 설계할 때는 항상 "이 클래스의 단일 책임은 무엇인가?"를 먼저 질문하는 것이 가장 적용하기 쉽고 즉각적인 이점을 줍니다 [10]. 프론트엔드 환경의 컴포넌트 개발을 예로 들면, 화면을 그리는 역할뿐만 아니라 데이터 관리, 표현 로직, 비즈니스 로직 등 너무 많은 책임을 하나의 컴포넌트에 집중시키는 것은 전형적인 SRP 위반에 해당합니다 [11]. 이를 개선하기 위해 컴포넌트는 오직 화면을 그리는 책임만 지게 하고, 비즈니스 로직이나 상태 처리는 별도의 모듈에 위임하는 방식이 SRP를 실무에 올바르게 적용하는 방법입니다 [6].
- 개념의 정의: 모듈이 변경되어야 하는 '이유'는 단 하나여야 하며, 이는 특정 이해관계자, 비즈니스 규칙 또는 외부 시스템의 요구사항을 의미합니다 [2]. 클래스나 인터페이스가 너무 많은 책임을 지게 되면 잦은 변경에 노출되고 취약해집니다 [4].
- 위반의 징후 (Red Flags): HTTP 핸들러, 비즈니스 로직, 데이터 접근 로직이 한 파일에 뒤섞여 있는 경우, 비대한 "god" 클래스로 인해 코드 병합 충돌(merge conflict)이 빈번한 경우, 그리고 코드 주석에 "~도 수행함(also does...)" 같은 설명이 붙는 메서드 등은 SRP 위반을 시사합니다 [3].
- 리팩토링 전략: 실용적인 해결책은 "비명을 지를 때까지 추출하라(extract till you scream)"는 것입니다. 가장 두드러지는 부차적인 책임을 독립된 별도의 클래스로 빼내고, 테스트를 작성하는 과정을 반복합니다 [3]. 이렇게 역할을 분리하면, 결제 로직을 건드리지 않고 이메일 제공자를 교체하거나 스키마를 안전하게 변경할 수 있습니다 [3].
- 실무 적용 사례:
- Toss Front SDK: "리소스를 만든 곳에서 닫는다"는 접근은 단일 책임 원칙을 잘 보여줍니다. 이를 통해 사용자 실수로 인한 리소스 및 리스너 누수를 방지하여 SDK 전반의 안정성을 굳건하게 지켜냅니다 [5].
- Strapi 개발: 커스텀 컨트롤러의 로직을 가볍게 유지해야 합니다. 파일 업로드, 유효성 검사, 분석 등의 작업은 하나의 컨트롤러 파일에 몰아넣지 않고 개별 서비스로 분리하여 호출하도록 설계해야 합니다 [3].
- 아키텍처 패턴의 활용: 단일 책임 원칙은 인터페이스 분리 원칙(ISP)과 궤를 같이합니다. 복잡한 시스템을 퍼사드(Facade) 패턴으로 감싸 책임을 단순화하면, 개발자의 인지 부하를 줄이고 시스템 간 결합도를 낮추는 강력한 수비 전략이 됩니다 [4].
⚖️ Trade-offs & Caveats
- 과거 데이터와의 충돌: 자동화 엔진에 의해 매핑된 지식으로, 추후 정밀 검증 필요.
- 정책 변화: Programming & Language 분야의 자동 자산화 수행.
- 과거 데이터와의 충돌: 자동화 엔진에 의해 매핑된 지식으로, 추후 정밀 검증 필요.
- 정책 변화: Programming & Language 분야의 자동 자산화 수행.
🔗 Knowledge Connections
- Related Topics: 관심사의 분리 (SoC), SOLID 원칙, 객체 지향 프로그래밍 (OOP), 응집도 (Cohesion)
- Projects/Contexts: 프론트엔드 컴포넌트 구조화, 소프트웨어 아키텍처 설계
- Contradictions/Notes: 소스에 따르면 SoC와 SRP는 서로 대립하는 개념이 아닙니다. 두 원칙 모두 소프트웨어의 모듈성을 높이는 데 기여하지만, SoC는 기능적 측면에서 코드를 구성하는 큰 그림(높은 추상화)을 다루고, SRP는 변경의 이유라는 관점에서 개별 클래스나 모듈의 단일 책임에 집중한다는 범위(Scope)와 초점의 차이가 있습니다 [4, 7].
Last updated: 2026-04-18
- Related Topics: SOLID, 인터페이스 분리 원칙(ISP), 퍼사드(Facade) 패턴
- Projects/Contexts: Toss Front SDK, Strapi
- Contradictions/Notes: 소스 내에서 단일 책임 원칙에 대한 모순점은 없으며, 제공된 모든 소스에서 모듈의 결합도를 낮추고 예측 가능성을 높이는 핵심 아키텍처 원칙으로 일관되게 강조하고 있습니다.
Last updated: 2026-04-18