Repository Pattern 최신 기능 완벽 가이드

Repository Pattern의 최신 기능과 활용법을 초급 개발자도 쉽게 이해할 수 있도록 소개합니다. 데이터 접근 계층을 추상화하여 유지보수성과 테스트 용이성을 높이는 방법을 배워보세요.

---

---

들어가며

이 글에서는 Repository Pattern 최신 기능 완벽 가이드에 대해 상세히 알아보겠습니다. 총 10가지 주요 개념을 다루며, 각각의 개념에 대한 설명과 실제 코드 예제를 함께 제공합니다.

목차

1. 기본_Repository_인터페이스
2. 구체적인_Repository_구현
3. Specification_Pattern_활용
4. Repository_with_Specification
5. 트랜잭션_지원_Repository
6. 페이지네이션_Repository
7. 캐싱_Repository_Decorator
8. 소프트_삭제_Repository
9. 배치_작업_Repository
10. Repository_팩토리_패턴

---

1. 기본 Repository 인터페이스

개요

Repository의 기본 구조를 정의하는 인터페이스입니다. 데이터 조작의 기본 메서드를 선언합니다.

코드 예제

interface Repository<T> {
  findById(id: string): Promise<T | null>;
  findAll(): Promise<T[]>;
  create(data: T): Promise<T>;
  update(id: string, data: Partial<T>): Promise<T>;
  delete(id: string): Promise<void>;
}

설명

제네릭을 사용하여 모든 엔티티에 재사용 가능한 Repository 인터페이스를 정의합니다. CRUD 작업의 표준을 제공합니다.

---

2. 구체적인 Repository 구현

개요

실제 데이터베이스와 연결되는 Repository 구현체입니다. 인터페이스를 구현하여 데이터 접근 로직을 캡슐화합니다.

코드 예제

class UserRepository implements Repository<User> {
  async findById(id: string): Promise<User | null> {
    return await db.users.findUnique({ where: { id } });
  }

  async findAll(): Promise<User[]> {
    return await db.users.findMany();
  }
}

설명

Prisma를 사용한 실제 구현 예제입니다. 데이터베이스 접근 로직을 Repository에 숨겨 비즈니스 로직과 분리합니다.

---

3. Specification Pattern 활용

개요

복잡한 쿼리 조건을 객체로 표현하는 Specification Pattern입니다. 쿼리 로직을 재사용 가능하게 만듭니다.

코드 예제

interface Specification<T> {
  toQuery(): any;
}

class ActiveUserSpec implements Specification<User> {
  toQuery() {
    return { where: { isActive: true } };
  }
}

설명

쿼리 조건을 재사용 가능한 객체로 만들어 코드 중복을 줄이고 테스트를 쉽게 합니다.

---

4. Repository with Specification

개요

Specification을 받아서 동적으로 쿼리를 실행하는 Repository 메서드입니다.

코드 예제

class UserRepository implements Repository<User> {
  async findBySpec(spec: Specification<User>): Promise<User[]> {
    const query = spec.toQuery();
    return await db.users.findMany(query);
  }
}

설명

Specification Pattern을 Repository와 결합하여 유연하고 재사용 가능한 쿼리 시스템을 구축합니다.

---

5. 트랜잭션 지원 Repository

개요

여러 작업을 하나의 트랜잭션으로 묶어 데이터 일관성을 보장합니다.

코드 예제

class UserRepository {
  async createWithProfile(user: User, profile: Profile) {
    return await db.$transaction(async (tx) => {
      const newUser = await tx.users.create({ data: user });
      await tx.profiles.create({ data: { ...profile, userId: newUser.id } });
      return newUser;
    });
  }
}

설명

트랜잭션을 사용하여 사용자와 프로필 생성을 원자적으로 처리합니다. 실패 시 자동으로 롤백됩니다.

---

6. 페이지네이션 Repository

개요

대량의 데이터를 효율적으로 조회하기 위한 페이지네이션 기능입니다.

코드 예제

interface PaginationOptions {
  page: number;
  limit: number;
}

async findPaginated(options: PaginationOptions) {
  const skip = (options.page - 1) * options.limit;
  return await db.users.findMany({ skip, take: options.limit });
}

설명

페이지 번호와 페이지 크기를 받아 효율적으로 데이터를 조회합니다. 대용량 데이터 처리에 필수적입니다.

---

7. 캐싱 Repository Decorator

개요

Repository에 캐싱 기능을 추가하는 데코레이터 패턴입니다. 성능을 향상시킵니다.

코드 예제

class CachedRepository<T> implements Repository<T> {
  constructor(private repo: Repository<T>, private cache: Cache) {}

  async findById(id: string): Promise<T | null> {
    const cached = await this.cache.get(id);
    return cached ?? await this.repo.findById(id);
  }
}

설명

기존 Repository를 감싸서 캐싱 기능을 추가합니다. 원본 코드를 수정하지 않고 기능을 확장합니다.

---

8. 소프트 삭제 Repository

개요

데이터를 실제로 삭제하지 않고 삭제 표시만 하는 소프트 삭제 기능입니다.

코드 예제

class UserRepository {
  async softDelete(id: string): Promise<void> {
    await db.users.update({
      where: { id },
      data: { deletedAt: new Date(), isDeleted: true }
    });
  }
}

설명

데이터를 보존하면서 삭제 처리합니다. 데이터 복구나 감사(audit) 추적이 필요할 때 유용합니다.

---

9. 배치 작업 Repository

개요

여러 개의 데이터를 한 번에 처리하는 배치 작업 메서드입니다.

코드 예제

class UserRepository {
  async createMany(users: User[]): Promise<number> {
    const result = await db.users.createMany({
      data: users,
      skipDuplicates: true
    });
    return result.count;
  }
}

설명

여러 사용자를 한 번의 쿼리로 생성합니다. 중복을 건너뛰고 생성된 개수를 반환합니다.

---

10. Repository 팩토리 패턴

개요

런타임에 적절한 Repository 구현체를 선택하는 팩토리 패턴입니다.

코드 예제

class RepositoryFactory {
  static create<T>(type: string): Repository<T> {
    if (process.env.NODE_ENV === 'test') {
      return new MockRepository<T>();
    }
    return new DatabaseRepository<T>(type);
  }
}

설명

환경에 따라 다른 Repository를 반환합니다. 테스트 환경에서는 Mock을 사용하여 빠른 테스트가 가능합니다.

---

마치며

이번 글에서는 Repository Pattern 최신 기능 완벽 가이드에 대해 알아보았습니다. 총 10가지 개념을 다루었으며, 각각의 사용법과 예제를 살펴보았습니다.

관련 태그

#TypeScript #Repository #Pattern #DataAccess #CleanArchitecture