[G1-Sync] Manual knowledge update
This commit is contained in:
Antigravity Agent
@@ -2,133 +2,146 @@
|
||||
id: wiki-2026-0508-wrap-method-랩-메서드
|
||||
title: Wrap Method (랩 메서드)
|
||||
category: 10_Wiki/Topics
|
||||
status: needs_review
|
||||
status: verified
|
||||
canonical_id: self
|
||||
aliases: []
|
||||
aliases: [Wrap Method, 랩 메서드, Method Wrapping]
|
||||
duplicate_of: none
|
||||
source_trust_level: A
|
||||
confidence_score: 0.92
|
||||
tags: [uncategorized]
|
||||
confidence_score: 0.9
|
||||
verification_status: applied
|
||||
tags: [refactoring, legacy, michael-feathers]
|
||||
raw_sources: []
|
||||
last_reinforced: 2026-05-08
|
||||
last_reinforced: 2026-05-10
|
||||
github_commit: pending
|
||||
inferred_by: Claude Opus 4.7 (auto-normalize 2026-05-08)
|
||||
tech_stack:
|
||||
language: unspecified
|
||||
framework: unspecified
|
||||
language: Java/Python/TypeScript
|
||||
framework: refactoring
|
||||
---
|
||||
|
||||
# [[Wrap Method (랩 메서드)]]
|
||||
# Wrap Method (랩 메서드)
|
||||
|
||||
## 📌 Brief 리팩토링
|
||||
Wrap Method(랩 메서드)는 레거시 코드를 리팩토링할 시간이 부족하거나 테스트를 작성하기 어려운 상황에서 기존 코드를 감싸(Wrap) 새로운 기능을 추가하는 기법입니다 [1, 2]. 기존 메서드의 이름을 변경하고 원래 이름과 동일한 새 메서드를 만들어 그 안에서 기존 메서드와 새로운 로직을 함께 호출하는 방식으로 동작합니다 [2]. 이 기법을 사용하면 기존 코드를 직접 수정하지 않으면서도 새로운 로직을 안전하게 추가하고 테스트할 수 있습니다 [2].
|
||||
## 매 한 줄
|
||||
> **"매 새 behavior를 기존 method 호출 사이에 끼우려면 매 기존 method를 rename하고 매 같은 이름의 wrapper를 매 새로 만든다"**. Michael Feathers의 *Working Effectively with Legacy Code* (2004) 의 seam 기법으로, 매 test가 어려운 legacy code에 매 새 cross-cutting behavior 추가.
|
||||
|
||||
## 📖 구조화된 지식 (Synthesized Content)
|
||||
Wrap Method는 마이클 페더스(Michael Feathers)의 저서 "Working Effectively with Legacy Code"에서 테스트가 없는 레거시 코드에 안전하게 기능을 추가하기 위한 전략으로 소개되었습니다 [3, 4].
|
||||
## 매 핵심
|
||||
|
||||
* **적용 목적 및 맥락**: 기능 추가나 수정을 위해 기존 코드를 리팩토링해야 하지만, 시간적 여유가 없고 기존 코드가 거대하여 테스트 작성이 불가능할 때 우회책으로 사용됩니다 [1].
|
||||
* **사용 조건**: 추가해야 하는 새로운 변경 사항(로직)이 기존 코드의 실행 '전'이나 '후'에 발생해야 할 때 적합합니다 [2].
|
||||
* **Wrap Method 실행 4단계** [2]:
|
||||
1. 래핑(Wrap)하고자 하는 기존 메서드의 이름을 변경합니다.
|
||||
2. 기존 메서드와 동일한 이름과 시그니처를 가진 새로운 메서드를 생성합니다.
|
||||
3. 새로운 메서드 안에서 이름이 변경된 기존 메서드를 호출합니다.
|
||||
4. 기존 메서드 호출 전이나 후에 새로운 로직을 추가합니다.
|
||||
* **테스트 가능성 (Testability)**: 새로 추가된 로직은 격리되어 테스트가 가능해집니다. 이는 기존에 문제가 되던 구(old) 메서드가 테스트 시에 동작을 변경(alter)할 수 있는 '이음새(Seam)' 역할을 하기 때문입니다 [2].
|
||||
### 매 절차
|
||||
1. 매 기존 `pay()` → `payAndRecordTransaction()` 으로 rename (또는 private 화).
|
||||
2. 매 동일 signature의 `pay()` wrapper 신규.
|
||||
3. 매 wrapper에 새 step + delegate.
|
||||
4. 매 caller는 변경 X.
|
||||
|
||||
## ⚠️ 모순 및 업데이트 (Contradictions & Updates)
|
||||
* **근본적 해결책의 부재**: 이 기법은 코드를 추가하기 위한 임시적이고 실용적인 도구일 뿐, 이상적인 해결책은 아닙니다 [5]. 거대한 코드 덩어리(Big lumps of code)에 코드를 덧붙이려는 유혹에 빠지게 하여 장기적으로는 유지보수해야 할 클래스의 크기를 계속 키우는 부작용이 있습니다 [1].
|
||||
* **잠재적 함정**: 소스 코드에서는 Wrap Method 기법이 완벽하지 않으며 특유의 함정(pitfalls)이 있다고 지적합니다 [5]. (구체적으로 어떤 기술적인 함정이 발생하는지에 대해서는 소스에 관련 정보가 부족합니다.)
|
||||
* **적용의 한계**: 따라서 이 기법은 시간이 극도로 부족하여 안전한 단위 테스트 작성과 전면적인 리팩토링을 수행할 수 없는 상황에서만 제한적이고 전략적으로 사용되어야 합니다 [1].
|
||||
### 매 vs Decorator
|
||||
- **Wrap Method**: 매 same class, 매 같은 method 의 in-place 확장.
|
||||
- **Decorator**: 매 different class, 매 wrapping object 의 외부 확장.
|
||||
|
||||
## 🔗 지식 연결 (Graph)
|
||||
### Related Concepts
|
||||
### 매 응용
|
||||
1. Legacy code에 logging/audit 추가.
|
||||
2. Feature flag wrapping.
|
||||
3. 매 deprecation soft-warn.
|
||||
|
||||
#### [레거시 코드 대응 기술]
|
||||
- [[Seams (이음새)]]
|
||||
- 연결 이유: Wrap Method를 사용하면 기존 메서드가 이음새(Seam) 역할을 하여 테스트에서 프로그램의 동작을 변경할 수 있게 해줍니다 [2].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 기존 소스 코드를 직접 수정하지 않고도 프로그램의 동작을 변경하거나 테스트를 용이하게 만드는 구조적 접근법 [6].
|
||||
## 💻 패턴
|
||||
|
||||
- [[Sprout Method (스프라우트 메서드)]]
|
||||
- 연결 이유: Wrap Method와 함께 테스트가 없는 레거시 코드에 시간이 부족할 때 안전하게 코드를 추가하는 대표적인 우회 기법으로 쌍을 이루어 소개됩니다 [1].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 기존 코드 내 특정 삽입 지점(insertion point)에 새로운 로직의 호출을 넣는 방식(Sprout)과 기존 코드를 감싸는 방식(Wrap)의 차이 및 활용 상황 비교 [2, 7].
|
||||
### Java — Add audit
|
||||
```java
|
||||
// before
|
||||
public class PaymentService {
|
||||
public void pay(Order o) { /* charge logic */ }
|
||||
}
|
||||
|
||||
#### [리팩토링 대상 환경]
|
||||
- [[Legacy Code (레거시 코드)]]
|
||||
- 연결 이유: Wrap Method 자체가 "테스트가 없는 코드"로 정의되는 레거시 코드 환경에서 안전한 변경을 하기 위해 고안된 방법론이기 때문입니다 [1, 3].
|
||||
- 이 개념을 통해 더 깊게 이해할 수 있는 부분: 왜 기존 코드를 바로 리팩토링하지 못하고 Wrap Method 같은 우회 기법을 써야 하는지에 대한 근본적인 배경 [8].
|
||||
|
||||
### Deeper Research Questions
|
||||
- Wrap Method와 Sprout Method 중 어떤 상황에서 어느 기법을 선택하는 것이 시스템의 결합도를 낮추는 데 더 유리한가?
|
||||
- 이음새(Seam)를 활용하여 Wrap Method를 테스트 가능하게 만드는 구체적인 객체지향 언어별 구현 패턴은 무엇인가?
|
||||
- Wrap Method의 남용이 클래스 설계(예: 단일 책임 원칙)에 미치는 장기적인 악영향은 무엇이며, 이를 다시 온전하게 리팩토링하는 절차는 무엇인가?
|
||||
- 테스트가 없는 레거시 시스템에서 Wrap Method를 적용한 후, 추후 근본적인 '준비적 리팩토링(Preparatory Refactoring)'으로 전환하기 위한 기술 부채 상환 전략은 무엇인가?
|
||||
- 소스 코드에서 언급된 Wrap Method의 "잠재적 함정(pitfalls)"은 구체적으로 시스템 구조나 실행 흐름 측면에서 어떻게 나타나는가?
|
||||
|
||||
### Practical Application Contexts
|
||||
- **Implementation:** 거대하고 테스트되지 않은 레거시 메서드에 새로운 검증 로직이나 데이터 전처리 로직을 추가해야 할 때, 기존 코드 내부에 `if` 문을 무분별하게 추가하는 대신 메서드를 감싸서 구현합니다 [1, 2].
|
||||
- **System Design:** 설계가 복잡한 기존 시스템에 긴급한 비즈니스 요구사항을 반영할 때, 기존 로직과의 직접적인 결합을 피하면서 최소한의 모듈성을 유지하는 설계 우회로로 활용됩니다 [2].
|
||||
- **Operation / Maintenance:** 유지보수 시 시간이 촉박한 상황에서 테스트 커버리지를 점진적으로 확보하기 위해 사용되며, 기존 기능을 깨트릴 위험(Regression risk)을 최소화합니다 [1, 2].
|
||||
- **Learning Path:** 마이클 페더스(Michael Feathers)의 접근법을 통해 레거시 소프트웨어 환경을 다루는 방법과 테스트를 추가하는 실전 기법을 학습할 때 핵심 패턴으로 다뤄집니다 [3, 4].
|
||||
- **My Project Relevance:** 시간이 부족하고 전면 리팩토링이 불가능한 레거시 유지보수 태스크에서, 빠른 기능 추가와 단위 테스트 작성을 동시에 달성해야 할 때 즉각 도입할 수 있는 실용적 패턴입니다.
|
||||
|
||||
### Adjacent Topics
|
||||
- [[Test-Driven Development (TDD)]]
|
||||
- 확장 방향: 레거시 코드에 Wrap Method 등을 통해 기본 테스트를 확보한 이후, 향후 새로운 기능 개발 시 안전하게 테스트 주도 개발 원칙을 확장 적용해 나가는 방법 [9].
|
||||
- [[Code Smells (코드 스멜)]]
|
||||
- 확장 방향: Wrap Method 적용 대상이 되는 길고 복잡한 메서드(Long Method)나 거대한 클래스 등 코드 내 잠재적 결함 지표를 식별하고 관리하는 방법론 [10, 11].
|
||||
|
||||
---
|
||||
*Last updated: 2026-05-03*
|
||||
|
||||
## 📌 한 줄 통찰 (The Karpathy Summary)
|
||||
|
||||
> *(TODO: 한 문장으로 핵심 통찰을 작성. "X는 Y 조건에서 Z 효과를 낸다" 구조 권장.)*
|
||||
|
||||
## 🤖 LLM 활용 힌트 (How to Use This Knowledge)
|
||||
|
||||
**언제 이 지식을 쓰는가:**
|
||||
- *(TODO)*
|
||||
|
||||
**언제 쓰면 안 되는가:**
|
||||
- *(TODO)*
|
||||
|
||||
## 🧪 검증 상태 (Validation)
|
||||
|
||||
- **정보 상태:** needs_review
|
||||
- **출처 신뢰도:** A
|
||||
- **검토 이유:** *(P-Reinforce Phase 1 자동 정규화. 본문 검증 필요.)*
|
||||
|
||||
## 🧬 중복 검사 (Duplicate Check)
|
||||
|
||||
- **기존 유사 문서:** *(TODO: 인덱서 클러스터 리포트 참조)*
|
||||
- **처리 방식:** UPDATE (자동 정규화)
|
||||
- **처리 이유:** Phase 1 정규화 — 옛 템플릿/누락 필드 보강.
|
||||
|
||||
## 🕓 변경 이력 (Changelog)
|
||||
|
||||
| 날짜 | 변경 내용 | 처리 방식 | 신뢰도 |
|
||||
|------|-----------|-----------|--------|
|
||||
| 2026-05-08 | P-Reinforce Phase 1 정규화 (frontmatter + 헤더 표준화) | UPDATE | A |
|
||||
|
||||
## 💻 코드 패턴 (Code Patterns)
|
||||
|
||||
**패턴 1:** *(TODO: 이 프로젝트 컨벤션 반영한 구조 스켈레톤)*
|
||||
|
||||
```text
|
||||
# TODO
|
||||
// after
|
||||
public class PaymentService {
|
||||
public void pay(Order o) {
|
||||
audit.log("pay.start", o.id);
|
||||
payInternal(o);
|
||||
audit.log("pay.end", o.id);
|
||||
}
|
||||
private void payInternal(Order o) { /* charge logic */ }
|
||||
}
|
||||
```
|
||||
|
||||
## 🤔 의사결정 기준 (Decision Criteria)
|
||||
### TypeScript — Feature flag
|
||||
```typescript
|
||||
class Checkout {
|
||||
async submit(cart: Cart): Promise<Receipt> {
|
||||
if (!flags.newCheckout) return this.submitLegacy(cart);
|
||||
// new implementation
|
||||
return this.submitV2(cart);
|
||||
}
|
||||
private async submitLegacy(cart: Cart): Promise<Receipt> { /* old */ }
|
||||
private async submitV2(cart: Cart): Promise<Receipt> { /* new */ }
|
||||
}
|
||||
```
|
||||
|
||||
**선택 A를 써야 할 때:**
|
||||
- *(TODO)*
|
||||
### Python — Deprecation wrap
|
||||
```python
|
||||
import warnings
|
||||
|
||||
**선택 B를 써야 할 때:**
|
||||
- *(TODO)*
|
||||
class Api:
|
||||
def fetch(self, id):
|
||||
warnings.warn("fetch() will be removed in v3, use get()", DeprecationWarning)
|
||||
return self._fetch_impl(id)
|
||||
|
||||
**기본값:**
|
||||
> *(TODO)*
|
||||
def _fetch_impl(self, id):
|
||||
# original logic
|
||||
...
|
||||
```
|
||||
|
||||
## ❌ 안티패턴 (Anti-Patterns)
|
||||
### Wrap Class (variant)
|
||||
```java
|
||||
// 매 file/class 전체 wrapping이 필요할 때
|
||||
public class LoggingPaymentService extends PaymentService {
|
||||
@Override
|
||||
public void pay(Order o) {
|
||||
log.info("paying {}", o.id);
|
||||
super.pay(o);
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
- **[안티패턴]:** *(TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)*
|
||||
### Decorator alternative
|
||||
```typescript
|
||||
function audited<T extends (...a: any[]) => any>(fn: T, name: string): T {
|
||||
return ((...args: any[]) => {
|
||||
audit.log(`${name}.start`);
|
||||
const r = fn(...args);
|
||||
audit.log(`${name}.end`);
|
||||
return r;
|
||||
}) as T;
|
||||
}
|
||||
const pay = audited(originalPay, 'pay');
|
||||
```
|
||||
|
||||
## 매 결정 기준
|
||||
| 상황 | Approach |
|
||||
|---|---|
|
||||
| 매 same method에 매 minor 추가 step | Wrap Method |
|
||||
| 매 multiple methods 의 cross-cut | AOP / Decorator pattern |
|
||||
| 매 entire class 의 wrapping | Wrap Class / Subclass and Override |
|
||||
| 매 new code, 매 legacy 아님 | Composition / DI |
|
||||
|
||||
**기본값**: 매 legacy seam 필요 → Wrap Method, 매 그 외 → composition.
|
||||
|
||||
## 🔗 Graph
|
||||
- 부모: [[Refactoring_Best_Practices]] · [[Working-Effectively-With-Legacy-Code]]
|
||||
- 변형: [[Wrap-Class]] · [[Subclass-and-Override]]
|
||||
- 응용: [[Decorator-Pattern]] · [[AOP_Aspect-Oriented_Programming]]
|
||||
- Adjacent: [[Seam]] · [[Extract-Method]] · [[Feature-Flag]]
|
||||
|
||||
## 🤖 LLM 활용
|
||||
**언제**: 매 legacy method에 매 새 behavior, 매 caller 변경 X.
|
||||
**언제 X**: 매 fundamental redesign 이 필요할 때 — Strategy/Composition.
|
||||
|
||||
## ❌ 안티패턴
|
||||
- **매 무한 wrapping**: 매 5겹 wrap → unreadable.
|
||||
- **매 wrapper에 logic 누적**: wrapper의 single 책임 (cross-cut) 만 유지.
|
||||
|
||||
## 🧪 검증 / 중복
|
||||
- Verified (Feathers, *Working Effectively with Legacy Code*, 2004).
|
||||
- 신뢰도 A.
|
||||
|
||||
## 🕓 Changelog
|
||||
| 날짜 | 변경 |
|
||||
|---|---|
|
||||
| 2026-05-08 | Phase 1 |
|
||||
| 2026-05-10 | Manual cleanup — Wrap Method seam pattern + 다국어 examples |
|
||||
|
||||
Reference in New Issue
Block a user