Files

T

koriweb 5ba5a55c78 feat: Wiki 지식 자산 업데이트 - UX Scenarios, Frontend, Game Design, Topics 추가 [2026-05-08]

2026-05-08 19:52:07 +09:00

5.5 KiB

Raw Blame History

id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, tags, raw_sources, last_reinforced, github_commit, inferred_by, tech_stack

title

Pull Up Method

📌 한 줄 통찰 (The Karpathy Summary)

Pull Up Method(메서드 올리기)는 형제 하위 클래스(sibling classes)들에 중복으로 존재하는 동일한 메서드를 부모 클래스(superclass)로 끌어올려 중앙집중화하는 리팩토링 기법이다 [1], [2]. 이 기법은 코드 중복을 제거하여 불필요한 노력을 줄이고, 한쪽 메서드만 수정되어 발생할 수 있는 잠재적 버그를 예방하기 위해 사용된다 [1], [3]. 자식 클래스들이 완전히 동일한 본문을 가진 메서드를 공유할 때 가장 직관적으로 적용할 수 있는 일반화(Generalization) 리팩토링 중 하나이다 [4], [5].

📖 구조화된 지식 (Synthesized Content)

적용 동기: 여러 하위 클래스에서 동일한 동작을 수행하는 두 메서드가 그대로 방치될 경우 향후 버그의 온상이 될 수 있다 [3]. 중복된 메서드가 존재하면 코드 수정 시 한쪽만 변경하고 다른 하나는 변경하지 않고 누락할 위험이 있기 때문에 이를 슈퍼클래스로 올려 단일화해야 한다 [3]. 또한, 하위 클래스의 메서드가 상위 클래스의 메서드를 재정의(override)하면서 실제로는 동일한 작업을 수행하는 특수한 경우에도 이 기법이 필요하다 [6].
실행 절차:
1. 형제 클래스 간의 메서드를 검사하여 두 메서드의 구현이 정말로 완벽하게 동일한지 확인 및 분석한다 [1], [7]. 만약 시그니처가 다르다면 슈퍼클래스에서 사용할 형태로 시그니처를 일치시킨다 [7].
2. 부모 클래스에 새로운 메서드를 생성한 후, 중복 메서드의 본문을 복사하여 붙여넣고 조정한다 [1], [7]. 필요하다면 가시성(visibility)을 protected로 변경한다 [1].
3. 하위 클래스들에서 중복된 메서드 구현을 삭제하고 코드를 컴파일 및 테스트한다 [1], [8].
4. 오직 슈퍼클래스의 메서드만 남을 때까지 모든 하위 클래스에서 해당 메서드를 삭제하고 테스트하는 과정을 반복한다 [8].
관련 기법의 활용: 두 메서드가 비슷하지만 완전히 같지 않은 경우에는 '메서드 올리기'를 바로 적용할 수 없다 [7]. 이럴 때는 먼저 '알고리즘 전환(Substitute Algorithm)'이나 '템플릿 메서드 형성(Form Template Method)'을 사용하여 차이점을 분리하고 공통점을 추출하는 작업이 선행되어야 한다 [7].

⚠️ 모순 및 업데이트 (Contradictions & Updates)

하위 클래스 종속성 문제: '메서드 올리기'를 적용할 때 가장 다루기 까다로운 부분은 끌어올리려는 메서드의 본문이 슈퍼클래스에는 없고 하위 클래스에만 존재하는 기능(메서드나 필드)을 참조하는 경우이다 [6].
하위 메서드 참조 시 제약: 끌어올린 메서드가 하위 클래스에만 존재하는 다른 메서드를 호출하는 경우, 해당 메서드도 함께 일반화하여 끌어올리거나 슈퍼클래스에 추상 메서드(abstract method)로 선언해야만 정상적으로 컴파일되고 동작할 수 있다 [6], [8]. 이를 해결하기 위해 메서드의 시그니처를 변경하거나 별도의 위임(delegating) 메서드를 만들어야 하는 복잡함이 수반될 수 있다 [6].
하위 필드 참조 시 제약: 끌어올린 메서드가 하위 클래스의 특정 필드를 사용하는 경우라면, '필드 올리기(Pull Up Field)'나 '필드 자가 캡슐화(Self Encapsulate Field)'를 적용해야 하며, 슈퍼클래스에 추상화된 getter 메서드를 선언하여 접근해야 하는 구조적 제약이 따른다 [8].

Last updated: 2026-05-03

🤖 LLM 활용 힌트 (How to Use This Knowledge)

언제 이 지식을 쓰는가:

(TODO)

언제 쓰면 안 되는가:

(TODO)

🧪 검증 상태 (Validation)

정보 상태: needs_review
출처 신뢰도: A
검토 이유: (P-Reinforce Phase 1 자동 정규화. 본문 검증 필요.)

🧬 중복 검사 (Duplicate Check)

기존 유사 문서: (TODO: 인덱서 클러스터 리포트 참조)
처리 방식: UPDATE (자동 정규화)
처리 이유: Phase 1 정규화 — 옛 템플릿/누락 필드 보강.

🔗 지식 연결 (Graph)

Parent: 10_Wiki/Topics
Related: (TODO: 최소 2개)
Opposite / Trade-off: (TODO)
Raw Source: 직접 입력

🕓 변경 이력 (Changelog)

날짜	변경 내용	처리 방식	신뢰도
2026-05-08	P-Reinforce Phase 1 정규화 (frontmatter + 헤더 표준화)	UPDATE	A

💻 코드 패턴 (Code Patterns)

패턴 1: (TODO: 이 프로젝트 컨벤션 반영한 구조 스켈레톤)

# TODO

🤔 의사결정 기준 (Decision Criteria)

선택 A를 써야 할 때:

(TODO)

선택 B를 써야 할 때:

(TODO)

기본값:

(TODO)

❌ 안티패턴 (Anti-Patterns)

[안티패턴]: (TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)

5.5 KiB Raw Blame History