introduce-parameter-object

Introduce Parameter Object / Preserve Whole Object

상황에 따라 두 가지 기법 중 적합한 것을 선택:

• Introduce Parameter Object (IPO): 파라미터에 행위를 추가해야 할 때 → 새 객체 생성 → 행위 이동 → Value Object 발견
• Preserve Whole Object (PWO): 기존 객체에서 값을 꺼내 전달할 때 → 객체 자체를 전달하여 파라미터 수 감소

GOAL

• 성공 = 반복 파라미터가 IPO 또는 PWO로 정리되어 커밋 완료됨
• IPO: 파라미터 그룹이 Parameter Object로 치환되고 관련 행위가 이동됨
• PWO: 객체에서 꺼낸 값들이 객체 자체 전달로 대체됨
• 사용자 확인 후 적용
• 모든 테스트 통과

기법 선택 기준

상황	적용 기법	이유
파라미터들이 이미 하나의 객체에서 꺼내져 전달됨	Preserve Whole Object	객체가 이미 존재 — 꺼내지 말고 그대로 전달
파라미터에 대한 행위를 추가해야 하는 경우	Introduce Parameter Object	새 객체 생성 → 행위 이동 → Value Object 발견

IPO의 진짜 목적

"더 큰 혜택은 파라미터 그룹에 대해서 동작하는 행위들을 파라미터 객체로 이동시킬 수 있는 것" — Fowler, Ch10

IPO는 파라미터 묶기 자체가 목적이 아니라, Value Object를 발견하는 시작점:

Introduce Parameter Object
  → Move Instance Method (관련 로직을 Parameter Object로 이동)
    → Value Object 탄생 (데이터 + 행위를 가진 객체)

적용하면 안 되는 경우

상황	이유
파라미터 간에 논리적 관계가 없음	논리 관계 없이 그룹화하면 의미 없는 객체가 생성됨
한 메서드에서만 사용되는 파라미터 조합	반복이 없으면 추상화의 가치 없음
파라미터 객체에 이동할 행위가 없음	단순 DTO가 되어 Anemic Domain Model 유발 (이 경우 PWO가 더 적합할 수 있음)

CONSTRAINTS

• 계열: System-wide — 후보 제시 후 승인 받고 적용 (../../references/refactoring-procedure.md §0·§3-B)

Hard Rules

• 동작 변경 금지 — 구조 개선만 수행
• 테스트 수정 금지 — 구조 변경이 테스트를 실패시키면 되돌리기
• 사용자 확인 없이 리팩토링 금지 — 모든 후보는 사용자 승인 후 실행
• 커밋 단위 — 1파일 x 1기법 = 1커밋 (논리적으로 연결된 파일은 함께)
• git add -A 금지 — 변경된 파일만 명시적으로 추가

적용 패턴

Introduce Parameter Object 리팩토링 단계:

1. 반복 파라미터 그룹 식별

   • 3개 이상의 파라미터가 함께 전달되는 패턴
   • 2곳 이상에서 동일한 파라미터 조합 반복

2. Parameter Object 클래스 생성

   • 논리적으로 관련된 파라미터를 하나의 클래스로
   • record 또는 immutable class 사용 (Java 14+)
   • 의미 있는 이름 부여

3. 메서드 시그니처 변경

   • 개별 파라미터를 Parameter Object로 치환
   • 호출자 코드 업데이트

4. 관련 동작 이동 (선택적)

   • Parameter Object와 관련된 로직을 객체 내부로 이동
   • Value Object로 발전 가능

Before/After 예시

// Before: 반복되는 파라미터 그룹
public class PriceService {
    public void processPrice(int originalPrice, int discountedPrice, String currency) {
        // 처리 로직
        validatePrice(originalPrice, discountedPrice, currency);
        formatPrice(originalPrice, discountedPrice, currency);
    }
    
    private void validatePrice(int originalPrice, int discountedPrice, String currency) {
        if (originalPrice < 0 || discountedPrice < 0) {
            throw new IllegalArgumentException("Price cannot be negative");
        }
        if (discountedPrice > originalPrice) {
            throw new IllegalArgumentException("Discounted price cannot exceed original");
        }
    }
    
    private String formatPrice(int originalPrice, int discountedPrice, String currency) {
        double discount = (originalPrice - discountedPrice) * 100.0 / originalPrice;
        return String.format("%s %.0f%% off: %d -> %d", 
            currency, discount, originalPrice, discountedPrice);
    }
}

// After: Parameter Object 적용
record Price(int original, int discounted, String currency) {
    // 생성자에서 검증
    public Price {
        if (original < 0 || discounted < 0) {
            throw new IllegalArgumentException("Price cannot be negative");
        }
        if (discounted > original) {
            throw new IllegalArgumentException("Discounted price cannot exceed original");
        }
    }
    
    // 관련 동작을 객체 내부로 이동
    public double discountPercentage() {
        return (original - discounted) * 100.0 / original;
    }
    
    public String formatted() {
        return String.format("%s %.0f%% off: %d -> %d", 
            currency, discountPercentage(), original, discounted);
    }
}

public class PriceService {
    public void processPrice(Price price) {
        // Parameter Object 하나만 전달
        // 검증은 Price 생성자에서 자동 수행
        String formatted = price.formatted();
    }
}