데이터 기반 단위 테스트 만들기
관리 코드용 Microsoft 단위 테스트 프레임워크(MSTest)를 사용하여 데이터 원본에서 값을 검색하도록 단위 테스트 메서드를 설정할 수 있습니다. 이 메서드는 데이터 소스의 각 행을 대상으로 연속 실행되므로 단일 메서드를 사용하여 다양한 입력을 쉽게 테스트할 수 있습니다.
데이터 기반 단위 테스트는 다음 종류 중에서 사용할 수 있습니다.
DataRow특성을 사용하여 인라인 데이터DynamicData특성을 사용하여 멤버 데이터DataSource특성을 사용하여 일부 잘 알려진 원본 공급자에서
테스트 중인 메서드
예를 들어 다음이 있다고 가정해 보세요.
다양한 형식의 계좌에 대한 트랜잭션을 수락하고 처리하는
MyBank솔루션.계좌에 대한 트랜잭션을 관리하는
MyBank의BankDb프로젝트.모든 트랜잭션이 은행에 이로운지 확인하기 위해 수학적 함수를 실행하는
BankDb프로젝트의Maths클래스.BankDb구성 요소의 동작을 테스트하기 위한BankDbTests단위 테스트 프로젝트.Maths클래스의 동작을 확인하기 위한MathsTests단위 테스트 클래스.
루프를 사용하여 두 개의 정수를 추가하는 Maths의 메서드를 테스트합니다.
public int AddIntegers(int first, int second)
{
int sum = first;
for (int i = 0; i < second; i++)
{
sum += 1;
}
return sum;
}
테스트 메서드 테스트
인라인 데이터 기반 테스트
인라인 테스트의 경우 MSTest는 DataRow를 사용하여 데이터 기반 테스트에서 사용하는 값을 지정합니다. 이 예제의 테스트는 각 데이터 행에 대해 연속적으로 실행됩니다.
[TestMethod]
[DataRow(1, 1, 2)]
[DataRow(2, 2, 4)]
[DataRow(3, 3, 6)]
[DataRow(0, 0, 1)] // The test run with this row fails
public void AddIntegers_FromDataRowTest(int x, int y, int expected)
{
var target = new Maths();
int actual = target.AddIntegers(x, y);
Assert.AreEqual(expected, actual,
"x:<{0}> y:<{1}>",
new object[] {x, y});
}
멤버 데이터 기반 테스트
MSTest는 DynamicData 특성을 사용하여 데이터 기반 테스트에서 사용하는 데이터를 제공할 멤버의 이름, 종류(속성, 기본값 또는 메서드) 및 정의 형식(기본적으로 현재 형식이 사용됨)을 지정합니다.
public static IEnumerable<object[]> AdditionData
{
get
{
return new[]
{
new object[] { 1, 1, 2 },
new object[] { 2, 2, 4 },
new object[] { 3, 3, 6 },
new object[] { 0, 0, 1 }, // The test run with this row fails
};
}
}
[TestMethod]
[DynamicData(nameof(AdditionData))]
public void AddIntegers_FromDynamicDataTest(int x, int y, int expected)
{
var target = new Maths();
int actual = target.AddIntegers(x, y);
Assert.AreEqual(expected, actual,
"x:<{0}> y:<{1}>",
new object[] {x, y});
}
DynamicData 특성의 DynamicDataDisplayName 속성을 사용하여 기본적으로 생성된 표시 이름을 재정의할 수도 있습니다. 표시 이름 메서드 서명은 public static string이어야 하며 MethodInfo 형식의 첫 번째 매개 변수와 object[] 형식의 두 번째 매개 변수를 허용해야 합니다.
public static string GetCustomDynamicDataDisplayName(MethodInfo methodInfo, object[] data)
{
return string.Format("DynamicDataTestMethod {0} with {1} parameters", methodInfo.Name, data.Length);
}
[DynamicData(nameof(AdditionData), DynamicDataDisplayName = nameof(GetCustomDynamicDataDisplayName))]
원본 공급자 데이터 기반 테스트
데이터 원본 기반 단위 테스트를 만드는 단계는 다음과 같습니다.
테스트 메서드에서 사용할 값이 포함된 데이터 소스를 만듭니다. 테스트를 실행할 컴퓨터에 등록된 모든 형식을 데이터 소스로 사용할 수 있습니다.
TestContext 형식의 공용
TestContext속성을 테스트 클래스에 추가합니다.단위 테스트 메서드 만들기
DataSourceAttribute 특성을 추가합니다.
DataRow 인덱서 속성을 사용하여 테스트에서 사용할 값을 검색합니다.
데이터 소스 만들기
AddIntegers 메서드를 테스트하기 위해 반환되어야 하는 매개 변수 및 합계의 값 범위를 지정하는 데이터 소스를 만듭니다. 이 예제에서는 MathsData이라는 Sql Compact 데이터베이스 및 다음 열 이름과 값이 포함된 AddIntegersData라는 테이블을 만듬
| FirstNumber | SecondNumber | 합계 |
|---|---|---|
| 0 | 1 | 1 |
| 1 | 6 | 2 |
| 2 | -3 | -1 |
테스트 클래스에 TestContext 추가
단위 테스트 프레임워크는 데이터 기반 테스트를 위해 데이터 소스 정보를 저장할 TestContext 개체를 만듭니다. 그런 다음, 이 개체를 여기서 만든 TestContext 속성의 값으로 설정합니다.
public TestContext TestContext { get; set; }
테스트 메서드에서 TestContext의 DataRow 인덱서 속성을 통해 데이터에 액세스합니다.
참고
.NET Core는 DataSource 특성을 지원하지 않습니다. .NET Core, UWP 또는 WinUI 단위 테스트 프로젝트에서 이 방식으로 테스트 데이터에 액세스하려고 하면 "'TestContext'에는 'DataRow'에 대한 정의가 포함되어 있지 않으며, 'TestContext' 유형의 첫 번째 인수를 허용하는 액세스 가능한 확장 메서드 'DataRow'를 찾을 수 없음(using 지시문이나 어셈블리 참조가 누락되었나요?)"과 유사한 오류가 표시됩니다.
테스트 메서드 작성
AddIntegers에 대한 테스트 메서드는 매우 간단합니다. 데이터 소스의 각 행을 대상으로 FirstNumber 및 SecondNumber 열 값을 매개 변수로 사용하여 AddIntegers를 호출하고 Sum 열 값에 대한 반환 값을 확인합니다.
[TestMethod]
[DataSource(@"Provider=Microsoft.SqlServerCe.Client.4.0; Data Source=C:\Data\MathsData.sdf;", "Numbers")]
public void AddIntegers_FromDataSourceTest()
{
var target = new Maths();
// Access the data
int x = Convert.ToInt32(TestContext.DataRow["FirstNumber"]);
int y = Convert.ToInt32(TestContext.DataRow["SecondNumber"]);
int expected = Convert.ToInt32(TestContext.DataRow["Sum"]);
int actual = target.AddIntegers(x, y);
Assert.AreEqual(expected, actual,
"x:<{0}> y:<{1}>",
new object[] {x, y});
}
DataSourceAttribute 지정
DataSource 특성은 테스트 메서드에 사용할 테이블의 이름 및 데이터 소스의 연결 문자열을 지정합니다. 연결 문자열의 정확한 정보는 어떤 종류의 데이터 소스를 사용하는지에 따라 달라집니다. 이 예제에서는 SqlServerCe 데이터베이스를 사용했습니다.
[DataSource(@"Provider=Microsoft.SqlServerCe.Client.4.0;Data Source=C:\Data\MathsData.sdf", "AddIntegersData")]
DataSource 특성에는 세 개의 생성자가 있습니다.
[DataSource(dataSourceSettingName)]
하나의 매개 변수가 있는 생성자는 솔루션에 대한 app.config 파일에 저장된 연결 정보를 사용합니다. dataSourceSettingsName은 연결 정보를 지정하는 구성 파일의 Xml 요소 이름입니다.
app.config 파일을 사용하면 단위 테스트 자체를 변경하지 않고 데이터 원본의 위치를 변경할 수 있습니다. app.config 파일을 만들고 사용하는 방법에 대한 자세한 내용은 연습: 구성 파일을 사용하여 데이터 원본 정의를 참조하세요.
[DataSource(connectionString, tableName)]
두 개의 매개 변수가 있는 DataSource 생성자는 테스트 메서드에 대한 데이터가 포함된 테이블의 이름 및 데이터 소스의 연결 문자열을 지정합니다.
연결 문자열은 데이터 소스의 형식에 따라 달라지지만 데이터 공급자의 고정 이름을 지정하는 Provider 요소를 포함해야 합니다.
[DataSource(
dataProvider,
connectionString,
tableName,
dataAccessMethod
)]
TestContext.DataRow를 사용하여 데이터 액세스
AddIntegersData 테이블의 데이터에 액세스하려면 TestContext.DataRow 인덱서를 사용합니다. DataRow는 DataRow 개체이므로 인덱스 또는 열 이름별로 열 값을 검색합니다. 값은 개체로 반환되므로 값을 적절한 형식으로 변환합니다.
int x = Convert.ToInt32(TestContext.DataRow["FirstNumber"]);
테스트 실행 및 결과 보기
테스트 메서드 작업을 완료했으면 테스트 프로젝트를 빌드합니다. 테스트 메서드는 테스트 실행 안 함 그룹의 테스트 탐색기에 표시됩니다. 테스트를 실행하고, 작성하고, 재실행할 때 테스트 탐색기에는 실패한 테스트, 통과한 테스트 및 테스트 실행 안 함 그룹에 결과가 표시됩니다. 사용자는 모두 실행 을 선택해서 모든 테스트를 실행하거나 실행 을 선택해서 실행할 테스트 하위 집합을 선택할 수 있습니다.
테스트가 실행되면 테스트 탐색기 위쪽에 있는 테스트 결과 표시줄에 애니메이션 효과가 적용됩니다. 테스트 실행이 끝날 때 모든 테스트가 통과했으면 표시줄이 녹색이 되고 테스트가 실패하면 빨간색이 됩니다. 테스트 탐색기 창 아래쪽의 세부 정보 창에 테스트 실행의 요약이 표시됩니다. 테스트를 선택하면 아래쪽 창에 해당 테스트의 세부 정보가 표시됩니다.
참고
각 데이터 행의 결과와 하나의 요약 결과도 있습니다. 각 데이터 행에서 테스트가 통과되면 요약 실행이 통과로 표시됩니다. 데이터 행에서 테스트가 실패하면 요약 실행이 실패로 표시됩니다.
예제에서 AddIntegers_FromDataRowTest, AddIntegers_FromDynamicDataTest 또는 AddIntegers_FromDataSourceTest 메서드 중 하나를 실행한 경우 결과 표시줄이 빨간색으로 바뀌고 테스트 메서드가 실패한 테스트로 전환됩니다. 데이터 원본에서 반복된 메서드 중 하나라도 실패하면 데이터 기반 테스트에 실패합니다. 테스트 탐색기 창에서 실패한 테스트 기반 테스트를 선택하면 세부 정보 창에 데이터 행 인덱스별로 식별된 각 반복의 결과가 표시됩니다. 예제에서는 AddIntegers 알고리즘이 음수 값을 제대로 처리하지 않는 것 같습니다.
테스트 중인 메서드가 수정되고 테스트가 다시 실행되면 결과 표시줄이 녹색으로 바뀌고 테스트 메서드가 통과한 테스트 그룹으로 이동합니다.
관련 콘텐츠
- Microsoft.VisualStudio.TestTools.UnitTesting.DataSourceAttribute
- Microsoft.VisualStudio.TestTools.UnitTesting.TestContext
- Microsoft.VisualStudio.TestTools.UnitTesting.TestContext.DataRow
- Microsoft.VisualStudio.TestTools.UnitTesting.Assert
- 코드 단위 테스트
- 테스트 탐색기를 사용하여 단위 테스트 실행
- Microsoft 단위 테스트 프레임워크를 사용하여 .NET에 대한 단위 테스트 작성
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기