Visitor Pattern 실무 활용 가이드

객체 구조를 변경하지 않고 새로운 동작을 추가할 수 있는 Visitor 패턴의 실무 활용 방법을 소개합니다. 실제 프로젝트에서 자주 마주치는 상황을 예제로 설명합니다.

---

---

들어가며

이 글에서는 Visitor Pattern 실무 활용 가이드에 대해 상세히 알아보겠습니다. 총 8가지 주요 개념을 다루며, 각각의 개념에 대한 설명과 실제 코드 예제를 함께 제공합니다.

목차

1. Visitor_패턴_기본_구조
2. 파일_시스템_예제_구현
3. 파일_크기_계산_Visitor
4. 파일_이름_출력_Visitor
5. 검색_기능_Visitor
6. JSON_직렬화_Visitor
7. 파일_삭제_권한_검증_Visitor
8. 실전_활용_예제

---

1. Visitor 패턴 기본 구조

개요

Visitor 패턴은 요소(Element)와 방문자(Visitor) 인터페이스로 구성됩니다. 요소는 accept 메서드를 통해 방문자를 받아들입니다.

코드 예제

interface Visitor {
  visitFile(file: File): void;
  visitFolder(folder: Folder): void;
}

interface Element {
  accept(visitor: Visitor): void;
}

설명

Element는 accept 메서드로 Visitor를 받고, Visitor는 각 타입별 visit 메서드를 정의합니다. 이를 통해 구조와 동작을 분리할 수 있습니다.

---

2. 파일 시스템 예제 구현

개요

파일과 폴더를 나타내는 클래스를 만들고 각각 accept 메서드를 구현합니다. 실제 파일 시스템처럼 동작하는 구조입니다.

코드 예제

class File implements Element {
  constructor(public name: string, public size: number) {}

  accept(visitor: Visitor): void {
    visitor.visitFile(this);
  }
}

class Folder implements Element {
  items: Element[] = [];
  accept(visitor: Visitor): void {
    visitor.visitFolder(this);
  }
}

설명

File과 Folder가 각각 자신에게 맞는 visitor 메서드를 호출합니다. 이렇게 하면 타입별로 다른 처리가 가능합니다.

---

3. 파일 크기 계산 Visitor

개요

전체 파일 시스템의 크기를 계산하는 Visitor를 구현합니다. 폴더는 재귀적으로 하위 항목들을 방문합니다.

코드 예제

class SizeCalculator implements Visitor {
  totalSize = 0;

  visitFile(file: File): void {
    this.totalSize += file.size;
  }

  visitFolder(folder: Folder): void {
    folder.items.forEach(item => item.accept(this));
  }
}

설명

파일을 만나면 크기를 더하고, 폴더를 만나면 하위 항목들을 순회합니다. 구조 변경 없이 크기 계산 기능을 추가했습니다.

---

4. 파일 이름 출력 Visitor

개요

모든 파일과 폴더의 이름을 계층 구조에 맞게 출력하는 Visitor입니다. depth를 추적하여 들여쓰기를 표현합니다.

코드 예제

class NamePrinter implements Visitor {
  constructor(private depth = 0) {}

  visitFile(file: File): void {
    console.log('  '.repeat(this.depth) + file.name);
  }

  visitFolder(folder: Folder): void {
    folder.items.forEach(item => {
      new NamePrinter(this.depth + 1).accept(item);
    });
  }
}

설명

depth 변수로 계층 깊이를 관리하여 트리 구조를 시각화합니다. 기존 클래스는 전혀 수정하지 않았습니다.

---

5. 검색 기능 Visitor

개요

특정 확장자나 이름 패턴으로 파일을 검색하는 Visitor입니다. 검색 결과를 배열로 수집합니다.

코드 예제

class FileSearcher implements Visitor {
  results: File[] = [];

  constructor(private pattern: RegExp) {}

  visitFile(file: File): void {
    if (this.pattern.test(file.name)) {
      this.results.push(file);
    }
  }

  visitFolder(folder: Folder): void {
    folder.items.forEach(item => item.accept(this));
  }
}

설명

정규식 패턴으로 파일명을 검사하여 일치하는 파일만 수집합니다. 폴더는 재귀적으로 탐색하여 모든 하위 파일을 검사합니다.

---

6. JSON 직렬화 Visitor

개요

파일 시스템 구조를 JSON 형식으로 변환하는 Visitor입니다. 백엔드 API로 전송하거나 저장할 때 유용합니다.

코드 예제

class JsonSerializer implements Visitor {
  result: any = {};

  visitFile(file: File): void {
    this.result = { type: 'file', name: file.name, size: file.size };
  }

  visitFolder(folder: Folder): void {
    this.result = { type: 'folder', items: folder.items.map(/* ... */) };
  }
}

설명

각 요소를 JSON 객체로 변환합니다. 타입 정보를 포함하여 역직렬화 시 복원이 가능하도록 구조화합니다.

---

7. 파일 삭제 권한 검증 Visitor

개요

파일이나 폴더를 삭제하기 전에 권한을 검증하는 Visitor입니다. 읽기 전용 파일이 있으면 경고를 반환합니다.

코드 예제

class DeleteValidator implements Visitor {
  canDelete = true;

  visitFile(file: File): void {
    if (file.name.startsWith('.readonly')) {
      this.canDelete = false;
    }
  }

  visitFolder(folder: Folder): void {
    folder.items.forEach(item => item.accept(this));
  }
}

설명

특정 조건(읽기 전용 파일)을 검사하여 삭제 가능 여부를 판단합니다. 실제로는 파일 속성이나 권한을 체크하도록 확장 가능합니다.

---

8. 실전 활용 예제

개요

여러 Visitor를 조합하여 실제 파일 시스템 작업을 수행합니다. 한 구조에 다양한 동작을 적용하는 패턴의 강점을 보여줍니다.

코드 예제

const root = new Folder();
root.items.push(new File('app.ts', 1024));
root.items.push(new File('test.ts', 512));

const sizeCalc = new SizeCalculator();
root.accept(sizeCalc);
console.log(`Total: ${sizeCalc.totalSize}KB`);

const searcher = new FileSearcher(/\.ts$/);
root.accept(searcher);

설명

같은 파일 구조에 크기 계산, 검색 등 다른 Visitor를 적용합니다. 구조 변경 없이 기능을 자유롭게 추가할 수 있는 것이 핵심입니다.

---

마치며

이번 글에서는 Visitor Pattern 실무 활용 가이드에 대해 알아보았습니다. 총 8가지 개념을 다루었으며, 각각의 사용법과 예제를 살펴보았습니다.

관련 태그

#TypeScript #DesignPattern #Visitor #ObjectOriented #SoftwareArchitecture