Mock 객체
1. 개요
1. 개요
Mock 객체는 단위 테스트를 수행할 때 테스트 대상이 의존하는 다른 객체를 대체하기 위해 사용되는 테스트 더블의 일종이다. 실제 객체를 사용하기 어려운 상황, 예를 들어 데이터베이스 접속이나 네트워크 호출, 외부 API 연동과 같이 실행이 느리거나 상태가 불안정한 의존성을 격리하고 제어할 수 있게 해준다.
이 객체의 핵심은 사전에 정의된 특정 동작을 시뮬레이션하여 테스트에 필요한 응답을 제공하거나, 테스트 중에 자신이 어떻게 호출되었는지에 대한 정보를 기록하고 검증하는 데 있다. 이를 통해 개발자는 테스트 대상 코드의 로직에만 집중할 수 있으며, 외부 요인으로 인한 테스트 실패를 방지하고 테스트 실행 속도를 크게 향상시킬 수 있다.
Mock 객체는 스텁, 스파이, 페이크 등 다른 유형의 테스트 더블과 함께 논의되며, 각각은 테스트에서 수행하는 역할에 따라 미묘한 차이가 있다. 현대 소프트웨어 개발에서 Mock 객체의 사용은 테스트 주도 개발 및 애자일 방법론과 깊이 연관되어 있으며, 다양한 프로그래밍 언어를 위한 전용 Mock 프레임워크들이 널리 보급되어 있다.
2. Mock 객체의 개념
2. Mock 객체의 개념
Mock 객체는 소프트웨어 테스트, 특히 단위 테스트에서 사용되는 테스트 더블의 한 종류이다. 이는 실제 객체를 대신하여 동작하는 가짜 객체로, 테스트 대상 객체가 의존하는 다른 객체들을 격리시키는 데 핵심적인 역할을 한다. 테스트의 목적은 특정 모듈이나 클래스 하나의 로직이 올바르게 작동하는지 확인하는 것이므로, 데이터베이스나 외부 API 호출과 같이 느리거나 상태가 변할 수 있는 실제 의존 객체를 직접 사용하면 테스트의 속도와 안정성이 떨어질 수 있다. Mock 객체는 이러한 외부 의존성을 대체하여 테스트를 단순화하고 예측 가능하게 만든다.
Mock 객체의 핵심 기능은 사전에 정의된 행동을 시뮬레이션하고, 테스트 중에 자신이 어떻게 호출되었는지를 기록하여 나중에 그 호출을 검증할 수 있도록 하는 데 있다. 예를 들어, 사용자 정보를 조회하는 메서드를 테스트할 때, 실제 데이터베이스에 연결하는 대신 Mock 객체를 사용하면 "특정 ID로 조회 요청이 오면 미리 준비해둔 가짜 사용자 데이터를 반환하라"라고 행위를 정의할 수 있다. 이렇게 하면 네트워크 지연이나 데이터베이스 상태와 무관하게 항상 동일한 조건에서 테스트를 반복 실행할 수 있다.
또한 Mock 객체는 테스트 대상 객체와 의존 객체 간의 상호작용을 검증하는 데 유용하다. "메서드 A가 정확히 한 번 호출되었는가?", "특정 매개변수와 함께 호출되었는가?"와 같은 질문에 답할 수 있어, 객체 간의 통신 프로토콜이 제대로 지켜지고 있는지 확인하는 데 도움을 준다. 이는 테스트 주도 개발에서 시스템의 설계와 명세를 검증하는 강력한 도구로 활용된다.
따라서 Mock 객체는 단순히 값을 반환하는 스텁이나 실제 객체를 감싸는 스파이와는 구별되는 개념으로, 행위 검증에 초점을 맞춘 테스트 더블이다. 이를 효과적으로 사용하기 위해서는 Mockito, JMockit, EasyMock과 같은 전용 Mock 프레임워크를 활용하는 것이 일반적이다.
3. Mock 객체의 필요성
3. Mock 객체의 필요성
단위 테스트를 작성할 때 테스트 대상 객체는 종종 다른 객체에 의존한다. 예를 들어, 사용자 서비스 객체는 데이터베이스 접근을 담당하는 레포지토리 객체에 의존할 수 있다. 이때 실제 데이터베이스를 사용하는 테스트는 여러 문제를 야기한다. 테스트 실행 속도가 느려지고, 데이터베이스 서버의 상태나 네트워크 연결에 따라 테스트 결과가 불안정해질 수 있으며, 테스트를 위해 매번 데이터를 설정하고 정리하는 번거로움이 따른다.
Mock 객체는 바로 이러한 의존성을 격리하여 테스트의 독립성과 신뢰성을 높이는 데 필요하다. 테스트 대상 객체가 의존하는 외부 컴포넌트, 예를 들어 네트워크 호출이나 파일 시스템 접근, 타사 API와 같은 느리거나 통제하기 어려운 요소를 Mock 객체로 대체하면, 테스트는 오직 대상 객체의 로직에만 집중할 수 있다. 이는 테스트를 빠르고, 결정적이며, 반복 가능하게 만든다.
또한, Mock 객체는 테스트 중 발생해야 하는 상호작용을 검증하는 데 필요하다. 특정 메서드가 몇 번 호출되었는지, 어떤 매개변수와 함께 호출되었는지 등을 확인함으로써 객체 간의 협력 관계가 예상대로 이루어졌는지를 테스트할 수 있다. 이는 단순히 상태를 검증하는 것보다 더 정밀한 테스트를 가능하게 한다.
따라서 Mock 객체는 단위 테스트의 핵심 원칙인 격리와 빠른 실행을 실현하고, 객체의 행위를 검증하는 수단을 제공함으로써 견고한 테스트 코드 작성에 필수적이다.
4. Mock 객체의 주요 특징
4. Mock 객체의 주요 특징
Mock 객체는 단위 테스트를 효과적으로 수행하기 위해 설계된 테스트 더블로서 몇 가지 핵심적인 특징을 가진다. 첫째, Mock 객체는 테스트 대상 객체와 협력하는 외부 의존성을 완전히 격리시킨다. 이는 데이터베이스나 네트워크 호출, 외부 API와 같이 테스트 환경에서 제어하기 어렵거나 실행 속도가 느린 실제 객체를 대체함으로써, 테스트의 속도와 안정성을 크게 향상시킨다.
둘째, Mock 객체는 사전에 정의된 행동을 수행하도록 프로그래밍이 가능하다. 이를 스터빙(Stubbing)이라고 하며, 특정 메서드가 호출되었을 때 미리 지정된 값을 반환하거나 예외를 발생시키도록 설정할 수 있다. 이 특징 덕분에 테스트는 다양한 시나리오와 경계 조건을 쉽고 빠르게 시뮬레이션할 수 있다.
마지막으로, Mock 객체는 자신이 어떻게 호출되었는지에 대한 정보를 기록하고 이를 검증하는 기능을 제공한다. 테스트 중에 특정 메서드가 예상된 횟수로, 올바른 매개변수와 함께 호출되었는지 확인하는 검증(Verification) 과정을 통해, 테스트 대상 객체와 협력 객체 간의 상호작용 로직을 테스트할 수 있다. 이는 Mock 객체를 단순한 값 반환 도구인 스텁(Stub)이나 실제 객체의 호출을 감시하는 스파이(Spy)와 구분하는 중요한 차이점이다.
5. Mock 객체 사용 방법
5. Mock 객체 사용 방법
5.1. Mock 객체 생성
5.1. Mock 객체 생성
Mock 객체를 생성하는 방법은 주로 사용하는 프로그래밍 언어와 테스트 프레임워크에 따라 달라진다. 대부분의 현대적인 단위 테스트 도구는 Mock 객체를 손쉽게 생성할 수 있는 기능을 내장하고 있다. 일반적으로는 Mock 프레임워크가 제공하는 API를 호출하여 원하는 클래스나 인터페이스에 대한 Mock 인스턴스를 만드는 방식이다. 예를 들어, Java의 JUnit과 Mockito를 함께 사용한다면 Mockito.mock() 메서드를, Python의 pytest에서는 unittest.mock 모듈의 Mock() 클래스를 사용하여 생성한다.
Mock 객체 생성의 핵심은 테스트 대상 코드가 의존하는 실제 객체 대신, 제어 가능한 가짜 객체를 주입하는 데 있다. 이를 위해 의존성 주입(Dependency Injection) 패턴이 흔히 활용된다. 테스트 작성자는 생성자를 통하거나 세터(Setter) 메서드를 이용해 Mock 객체를 테스트 대상 객체에 넘겨준다. 이렇게 하면 테스트는 데이터베이스나 외부 API 같은 느리고 불안정한 실제 의존성과 분리되어 실행 속도가 빨라지고, 외부 요인에 영향을 받지 않는 격리된 환경을 구성할 수 있다.
생성된 Mock 객체는 처음에는 아무런 동작도 정의되어 있지 않은 '빈 껍데기' 상태이다. 따라서 테스트 시나리오에 맞게 특정 메서드가 호출될 때 어떤 값을 반환할지(행위 정의, Stubbing) 또는 메서드가 특정 조건으로 호출되었는지(행위 검증, Verification)를 이후 단계에서 설정해야 비로소 유용한 테스트 더블이 된다. 생성 단계는 단지 원본 객체의 형식(Type)을 따르는 가짜 인스턴스를 메모리에 만드는 과정에 불과하다.
5.2. 행위 정의 (Stubbing)
5.2. 행위 정의 (Stubbing)
행위 정의는 Mock 객체를 사용하는 핵심 단계로, 테스트 더블이 테스트 중에 어떻게 반응해야 하는지를 미리 지정하는 과정이다. 이를 스터빙(Stubbing)이라고도 부른다. 테스트 작성자는 Mock 객체의 특정 메서드가 호출될 때 어떤 값을 반환할지, 또는 어떤 예외를 발생시킬지 등을 사전에 정의한다. 이렇게 함으로써 테스트 대상 객체는 외부 데이터베이스나 네트워크 호출과 같은 실제 의존성과 상호작용하지 않고도, 예측 가능한 환경에서 격리되어 테스트될 수 있다.
스터빙은 일반적으로 "given-when-then" 패턴을 따른다. 즉, "주어진(Mock 객체의 행위가 정의된) 조건에서, 테스트 대상 메서드를 실행하면(when), 기대하는 결과(then)가 나와야 한다"는 논리로 테스트를 구성한다. 예를 들어, 사용자 정보를 조회하는 외부 API를 호출하는 메서드를 테스트할 때, 해당 Mock 객체의 getUserInfo 메서드에 대해 "아이디 'testUser'가 입력되면, 미리 준비된 가짜 사용자 객체를 반환하라"고 행위를 정의할 수 있다. 이를 통해 네트워크 지연이나 서버 장애 없이도 메서드의 논리만을 빠르고 안정적으로 검증할 수 있다.
대부분의 Mock 프레임워크는 풍부한 스터빙 API를 제공하여 다양한 시나리오를 쉽게 정의할 수 있도록 돕는다. 연속적인 호출에 대해 각기 다른 값을 반환하도록 설정하거나, 특정 타입의 인자를 받았을 때만 반응하도록 조건을 걸 수도 있다. 이렇게 사전 정의된 행위는 해당 테스트 케이스의 범위 내에서만 유효하며, 테스트의 독립성을 보장하는 데 기여한다.
5.3. 검증 (Verification)
5.3. 검증 (Verification)
검증은 Mock 객체를 사용하는 핵심 목적 중 하나로, 테스트 대상 객체가 의존하는 Mock 객체와의 상호작용이 예상대로 이루어졌는지를 확인하는 과정이다. 단순히 특정 메서드가 호출되었는지 여부뿐만 아니라, 호출 횟수, 전달된 인자 값, 호출 순서 등 세부적인 상호작용을 검증할 수 있다.
대부분의 Mock 프레임워크는 이러한 검증을 위한 전용 API를 제공한다. 예를 들어, 특정 메서드가 정확히 한 번 호출되었는지, 혹은 전혀 호출되지 않았는지를 검증하거나, 메서드가 특정 인자 값과 함께 호출되었는지를 확인할 수 있다. 이는 단위 테스트가 단순히 결과 값의 정합성뿐 아니라, 객체 간의 협력 관계와 프로그램 로직의 흐름이 설계 의도대로 구현되었는지를 검증하는 데 필수적이다.
검증은 주로 테스트 메서드의 실행 단계 이후, 즉 테스트 대상 코드를 실행한 후에 수행된다. 이는 테스트의 '준비-실행-검증' 단계 중 마지막 단계에 해당한다. 검증이 실패하면 테스트는 실패로 처리되며, 이는 Mock 객체와의 예상되지 않은 상호작용이 발생했음을 의미한다.
검증 기능을 통해 개발자는 외부 데이터베이스나 네트워크 서비스와 같은 실제 의존 객체 없이도, 테스트 대상 객체가 올바른 방식으로 다른 객체와 통신하는지를 보장할 수 있다. 이는 테스트 더블을 사용하는 궁극적인 목적인 테스트의 격리성과 신뢰성을 높이는 데 기여한다.
6. Mock 객체와 관련 개념 비교
6. Mock 객체와 관련 개념 비교
6.1. Stub
6.1. Stub
스텁은 단위 테스트에서 테스트 대상이 의존하는 실제 객체를 대신하여 사용되는 가짜 객체이다. 이는 테스트 더블의 한 종류로, 테스트의 안정성과 속도를 높이기 위해 외부 의존성을 격리하는 데 주로 활용된다. 스텁은 실제 객체의 복잡한 내부 로직이나 외부 시스템과의 상호작용을 단순화하여, 테스트가 특정 조건 하에서만 예측 가능한 방식으로 동작하도록 만든다.
주요 용도는 데이터베이스 조회, 네트워크 호출, 외부 API 연동과 같이 실행 속도가 느리거나 상태가 변할 수 있어 테스트 결과를 불안정하게 만드는 의존 객체를 대체하는 것이다. 예를 들어, 사용자 정보를 조회하는 메서드를 테스트할 때 실제 데이터베이스 서버에 연결하는 대신, 미리 정의된 사용자 데이터를 반환하는 스텁 객체를 사용하면 테스트 실행 시간을 크게 단축하고 네트워크 장애 등의 외부 요인으로부터 테스트를 보호할 수 있다.
스텁의 핵심 특징은 사전에 정의된 동작만을 수행한다는 점이다. 개발자는 테스트 시나리오에 필요한 특정 입력값에 대해 어떤 값을 반환할지, 또는 어떤 예외를 발생시킬지를 스텁 객체에 미리 프로그래밍한다. 이렇게 정의된 동작은 테스트 중에 변경되지 않으며, 스텁 객체가 어떻게 호출되었는지에 대한 검증은 일반적으로 수행하지 않는다. 그 목적은 단순히 테스트 대상 객체에 필요한 응답을 제공하여 테스트를 진행할 수 있는 환경을 조성하는 데 있다.
Mock 객체와의 주요 차이점은 여기에 있다. Mock 객체는 테스트 대상 객체와의 상호작용(예: 특정 메서드가 몇 번 호출되었는지, 어떤 매개변수로 호출되었는지)을 검증하는 데 중점을 두는 반면, 스텁은 그러한 검증 없이 미리 정해진 답변만을 제공하는 데 초점을 맞춘다. 따라서 스텁은 상태 검증 위주의 테스트에, Mock 객체는 행위 검증 위주의 테스트에 각각 더 적합하다고 볼 수 있다.
6.2. Fake
6.2. Fake
페이크(Fake)는 테스트 더블의 한 종류로, 실제 객체를 단순화하거나 경량화한 버전을 의미한다. 실제 객체와 동일한 기능적 인터페이스를 제공하지만, 내부 구현은 테스트를 위해 단순화되어 있다. 예를 들어, 실제 데이터베이스나 외부 API 호출 대신 메모리 상의 자료 구조를 사용하여 데이터를 저장하고 조회하는 객체가 페이크의 대표적인 예이다. 이는 테스트의 속도를 높이고 외부 시스템의 불안정성으로부터 테스트를 격리시키는 데 주로 사용된다.
페이크는 스텁(Stub)이나 모의 객체(Mock)와는 구분되는 개념이다. 스텁은 미리 정의된 답변만을 반환하는 수동적인 객체인 반면, 페이크는 실제 로직을 단순화하여 가지고 있어 일정 수준의 능동적인 동작을 수행할 수 있다. 또한 모의 객체가 객체의 상호작용을 검증하는 데 중점을 둔다면, 페이크는 실제 객체를 대체하여 기능 자체를 제공하는 데 중점을 둔다. 따라서 페이크는 테스트 중인 시스템(SUT)이 의존하는 복잡한 컴포넌트를 안정적이고 빠르게 대체할 필요가 있을 때 유용하다.
일반적인 사용 예시로는 다음과 같은 것들이 있다.
의존성 유형 | 페이크 객체 예시 |
|---|---|
이메일 서비스 | 실제로 이메일을 발송하지 않고, 발송 요청을 내부 리스트에 기록하는 서비스 |
실제 디스크 I/O 대신 메모리 상의 가상 파일 시스템을 에뮬레이션하는 객체 | |
실제 결제를 수행하지 않고, 성공/실패 시나리오를 시뮬레이션하는 객체 |
페이크를 구현할 때는 실제 객체의 핵심 비즈니스 로직을 정확히 반영해야 하며, 너무 단순화하여 테스트의 신뢰성을 떨어뜨리지 않도록 주의해야 한다. 잘 설계된 페이크는 단위 테스트의 효율성을 극대화하는 강력한 도구가 된다.
6.3. Spy
6.3. Spy
스파이는 테스트 더블의 한 유형으로, 실제 객체를 감싸거나 부분적으로 대체하면서 해당 객체에 대한 호출 정보를 기록하고 검증할 수 있는 객체이다. 스텁이나 Mock 객체가 가짜 동작을 미리 정의하는 것과 달리, 스파이는 기존의 실제 객체를 그대로 사용하되, 그 객체가 어떻게 사용되었는지(예: 특정 메서드가 몇 번 호출되었는지, 어떤 인자로 호출되었는지)를 모니터링하고 검증하는 데 초점을 둔다.
스파이는 주로 실제 객체의 내부 동작을 변경하지 않으면서도 그 상호작용을 관찰해야 할 때 유용하다. 예를 들어, 복잡한 로직을 가진 서비스 객체의 메서드가 테스트 중에 정상적으로 호출되었는지, 예상한 횟수만큼 실행되었는지를 확인할 때 사용된다. 이는 테스트 대상 코드가 의존하는 객체와 올바르게 협력하는지를 검증하는 행위 주도 개발 시나리오에서 특히 중요하다.
주요 Mock 프레임워크들은 대부분 스파이 기능을 제공한다. 사용법은 일반적으로 실제 객체를 인자로 전달하여 스파이 객체를 생성한 후, 특정 메서드의 호출 여부나 횟수 등을 검증하는 단위 테스트 코드를 작성하는 것이다. 스파이를 사용하면 실제 객체의 대부분의 동작은 그대로 유지한 채, 관심 있는 특정 상호작용만 선택적으로 검증할 수 있다는 장점이 있다.
스파이는 Mock 객체와 유사하게 상호작용 검증에 사용되지만, Mock 객체는 가짜 객체 전체를 정의하는 반면 스파이는 기존 실제 객체를 기반으로 한다는 점에서 차이가 있다. 또한, 단순히 미리 정해진 값을 반환하는 역할만 하는 스텁이나, 실제 동작을 단순화하여 구현한 페이크 객체와도 구분된다.
7. 주요 Mock 프레임워크
7. 주요 Mock 프레임워크
단위 테스트를 효율적으로 작성하기 위해 다양한 프로그래밍 언어와 환경을 위한 Mock 프레임워크가 개발되어 있다. 이러한 프레임워크들은 Mock 객체의 생성, 행위 정의, 상호작용 검증을 표준화된 방식으로 제공하여 개발자가 테스트 코드를 더 쉽게 작성하고 유지보수할 수 있도록 돕는다.
가장 널리 알려진 프레임워크로는 Java 진영의 Mockito가 있다. Mockito는 직관적인 API를 제공하여 테스트 코드의 가독성을 높이고, 행위 주도 개발(Behavior-Driven Development) 스타일의 검증을 지원하는 것으로 유명하다. Python에서는 unittest.mock 모듈이 표준 라이브러리에 포함되어 있어 별도의 설치 없이 Mock 객체를 활용할 수 있으며, pytest와 같은 테스트 러너와도 잘 통합된다. JavaScript 및 TypeScript 환경에서는 Jest가 내장된 Mock 기능을 제공하며, Sinon.JS는 독립적인 라이브러리로 스텁, 스파이, Mock 생성 등 다양한 테스트 더블 기능을 포함한다.
이 외에도 .NET 플랫폼의 Moq, C++용 Google Mock, Ruby의 RSpec Mocks 등 언어별로 활발히 사용되는 프레임워크들이 존재한다. 각 프레임워크는 특정 언어의 관용구와 테스트 문화에 맞춰 설계되었지만, 공통적으로 Mock 객체를 통해 의존성을 격리하고 테스트 대상의 행위를 검증하는 핵심 기능을 제공한다. 개발 팀은 프로젝트의 기술 스택, 테스트 철학, 그리고 프레임워크의 학습 곡선과 생산성을 고려하여 적합한 도구를 선택하게 된다.
8. Mock 객체 사용 시 주의사항
8. Mock 객체 사용 시 주의사항
Mock 객체를 사용할 때는 테스트의 신뢰성을 유지하고 유지보수성을 높이기 위해 몇 가지 주의해야 할 점이 있다. 첫째, Mock 객체는 테스트 대상 객체의 의존성을 격리하는 도구이지, 테스트 자체의 목적이 되어서는 안 된다. 과도하게 Mock 객체에 의존하면 실제 시스템의 동작과 테스트 시나리오가 괴리될 수 있으며, 이는 리팩토링에 대한 내성을 떨어뜨리는 원인이 된다. 즉, 구현 세부사항을 과도하게 검증하는 테스트는 코드 변경 시 테스트가 쉽게 깨질 수 있다.
둘째, Mock 객체는 주로 외부 시스템과의 상호작용을 검증하는 데 적합하다. 예를 들어 데이터베이스에 쿼리가 전송되었는지, 특정 API가 호출되었는지 확인하는 경우에 유용하다. 반면, 객체의 내부 상태나 복잡한 비즈니스 로직을 검증하는 데는 단위 테스트에서 실제 객체나 Fake 객체를 사용하는 것이 더 나을 수 있다. Mock 객체의 남용은 테스트를 복잡하게 만들고 이해하기 어렵게 할 수 있다.
마지막으로, Mock 객체의 설정과 검증 코드는 명확하고 간결해야 한다. 복잡한 Stubbing이나 여러 단계의 행위 검증은 테스트 코드를 읽기 어렵게 하며, 테스트의 의도를 흐릴 수 있다. 또한, Mock 프레임워크의 고급 기능을 남용하기보다는 기본적인 기능을 사용하여 테스트를 작성하는 것이 장기적으로 유지보수에 유리하다. 테스트의 목적은 버그를 발견하고 코드의 동작을 문서화하는 것이므로, Mock 객체 사용으로 인해 이 목적이 흐려지지 않도록 주의해야 한다.
