Repository 패턴이란 무엇인가요?

Question

Accepted Answer

**Repository** 패턴은 **데이터 접근**을 컬렉션과 유사한 인터페이스 뒤로 추상화합니다 — 비즈니스 로직을 데이터가 저장되고 조회되는 방식으로부터 분리합니다. 애플리케이션을 데이터 소스(데이터베이스, API)로부터 분리하여 테스트 용이성과 유지보수성을 향상시킵니다.

## Repository 패턴이 하는 일

```text
REPOSITORY → 비즈니스 로직과 데이터 접근 사이의 추상화 계층:
  → 깔끔한 인터페이스를 제공 (컬렉션처럼: findById, save, delete, findAll)
  → 데이터가 실제로 어떻게/어디에 저장되는지(데이터베이스, API, 캐시, 파일) 숨김
  → 비즈니스 로직은 데이터베이스를 직접 쓰지 않고 repository를 사용
→ 무엇을 하는 데이터 연산인지를, 그것이 어떻게 구현되는지로부터 분리
```

## 예시

```js
// repository 인터페이스 — 비즈니스 로직은 DB가 아니라 이것에 의존
class UserRepository {
  async findById(id) { /* 데이터베이스를 쿼리 (여기 뒤에 숨겨짐) */ }
  async save(user) { /* insert/update */ }
  async findByEmail(email) { /* ... */ }
}
// 비즈니스 로직은 데이터 소스를 모른 채 repository를 사용
const user = await userRepository.findById(42);
// → DB를 교체하거나, 테스트에서 mock을 사용해도 비즈니스 로직을 변경하지 않음
```

## 이점

```text
✓ 분리(DECOUPLING) → 비즈니스 로직이 데이터 접근 세부사항(DB, ORM, API)에 의존하지 않음 →
  비즈니스 로직 변경 없이 데이터 소스 교체
✓ 테스트 용이성 → 테스트에서 mock/fake repository 사용 (실제 데이터베이스 불필요)
✓ 중앙화된 데이터 접근 → 쿼리 로직이 한 곳에 (유지보수 가능, 일관성)
✓ 더 깔끔한 아키텍처 → 도메인/비즈니스 로직과 데이터 간 명확한 분리
→ 계층형/클린 아키텍처에서 흔함; DI와 함께 작동
```

## 왜 중요한가

Repository 패턴을 이해하는 것은 가치가 있습니다. 이는 비즈니스 로직을 데이터 접근으로부터 깔끔하게 분리하는 **흔하고 실용적인 패턴**이므로 관련 있는 설계 지식이기 때문입니다.

Repository 패턴은 데이터 접근을 컬렉션과 유사한 인터페이스(findById, save, delete) 뒤로 추상화하여, **데이터가 어떻게 그리고 어디에 저장되는지를 숨겨** 비즈니스 로직이 데이터베이스를 직접 쓰는 대신 repository를 사용하게 합니다.

그것이 하는 일(실제 저장소를 숨기는 깔끔한 데이터 접근 인터페이스를 제공하여, *무엇을* 하는 데이터 연산인지를 *어떻게* 구현되는지로부터 분리함)을 이해하는 것이 핵심 지식입니다.

**이점**을 이해하는 것이 중요합니다. **분리**(비즈니스 로직이 특정 데이터베이스, ORM, API 같은 데이터 접근 세부사항에 의존하지 않아, 비즈니스 로직을 변경하지 않고 데이터 소스를 교체할 수 있음 — 가치 있는 아키텍처적 이점), **테스트 용이성**(테스트에서 mock/fake repository를 사용하여 실제 데이터베이스가 필요 없음 — 비즈니스 로직 단위 테스트에 중요함), **중앙화된 데이터 접근**(쿼리 로직이 한 곳에 있어 유지보수성과 일관성), **더 깔끔한 아키텍처**(도메인/비즈니스 로직과 데이터 간 명확한 분리).

이런 이점들이 Repository 패턴을 유지보수 가능하고 테스트 가능한 애플리케이션에 실무적으로 가치 있게 만듭니다.

그것이 **계층형/클린 아키텍처**에서 흔하고 dependency injection과 함께 작동한다는 것을 이해하면 현대 아키텍처에서의 위치가 명확해집니다.

Repository 패턴은 널리 사용되는데, 비즈니스 로직을 데이터 접근으로부터 분리하는 것(테스트 용이성, 유지보수성, 유연성을 위해)이 흔하고 중요한 필요이기 때문입니다.

Repository 패턴은 비즈니스 로직을 데이터 접근으로부터 깔끔하게 분리하는(분리, 테스트 용이성, 중앙화된 데이터 접근, 더 깔끔한 아키텍처) 흔하고 실용적인 패턴이며 — 흔하고 중요한 필요 — 계층형/클린 아키텍처의 핵심이고, 그것이 하는 일과 이점을 이해하는 것이 유지보수 가능한 애플리케이션 구축에 관련 있으므로, Repository 패턴을 이해하는 것은 가치 있고 실무적으로 관련 있는 설계 지식입니다. 이는 비즈니스 로직을 데이터 접근으로부터 분리하는 데 자주 사용되는 패턴으로, 분리와 테스트 용이성을 제공하고, 클린/계층형 아키텍처의 핵심이며, 로직과 데이터 간의 깔끔한 분리로 유지보수 가능하고 테스트 가능한 애플리케이션을 구축하는 데 중요한 설계 지식입니다.