중첩 클래스 검증

개요

Command에 Request가 빠져 있다면? Query에 Response가 없다면? Mediator 파이프라인이 런타임에 실패하고 나서야 “중첩 클래스를 깜빡했다”는 사실을 알게 됩니다. 이런 구조적 누락은 컴파일러가 잡아주지 않습니다.

이 챕터에서는 RequireNestedClass()와 RequireNestedClassIfExists()를 사용하여 중첩 클래스의 존재와 구조를 컴파일 타임이 아닌 테스트 타임에 자동으로 검증하는 방법을 학습합니다.

“구조적 규칙은 코드 리뷰에서 잡기엔 너무 쉽게 빠집니다. 테스트가 ‘이 Command에 Request가 없습니다’라고 알려주면, 누락은 커밋 전에 발견됩니다.”

학습 목표

핵심 학습 목표

RequireNestedClass()로 필수 중첩 클래스 검증
- 지정된 이름의 중첩 클래스가 반드시 존재해야 하는 규칙
- 두 번째 매개변수로 중첩 클래스에 대한 추가 규칙 체이닝
RequireNestedClassIfExists()로 선택적 중첩 클래스 검증
- 중첩 클래스가 있을 때만 검증하고, 없으면 통과하는 패턴
- Validator처럼 선택적 요소에 적합한 검증 전략
.AreNotNested() 필터의 역할
- 최상위 클래스만 대상으로 하여 중첩 클래스 자체가 검증 대상이 되는 것을 방지

실습을 통해 확인할 내용

CreateOrder: Command 패턴 — sealed Request와 Response 중첩 클래스 포함
GetOrderById: Query 패턴 — 동일한 중첩 클래스 구조
선택적 Validator: 존재할 때만 sealed 여부를 검증하는 패턴

도메인 코드

CreateOrder - Command 패턴

public sealed class CreateOrder
{
    public sealed class Request
    {
        public string CustomerName { get; }
        public string ProductName { get; }

        private Request(string customerName, string productName)
        {
            CustomerName = customerName;
            ProductName = productName;
        }

        public static Request Create(string customerName, string productName)
            => new(customerName, productName);
    }

    public sealed class Response
    {
        public string OrderId { get; }
        public bool Success { get; }

        private Response(string orderId, bool success)
        {
            OrderId = orderId;
            Success = success;
        }

        public static Response Create(string orderId, bool success)
            => new(orderId, success);
    }
}

GetOrderById - Query 패턴

public sealed class GetOrderById
{
    public sealed class Request
    {
        public string OrderId { get; }
        private Request(string orderId) => OrderId = orderId;
        public static Request Create(string orderId) => new(orderId);
    }

    public sealed class Response
    {
        public string OrderId { get; }
        public string CustomerName { get; }

        private Response(string orderId, string customerName)
        {
            OrderId = orderId;
            CustomerName = customerName;
        }

        public static Response Create(string orderId, string customerName)
            => new(orderId, customerName);
    }
}

두 클래스 모두 Request와 Response 중첩 클래스를 포함하며, 각각 불변 패턴을 따릅니다.

테스트 코드

필수 중첩 클래스 검증

RequireNestedClass()는 지정된 이름의 중첩 클래스가 반드시 존재해야 하며, 존재하지 않으면 위반을 보고합니다. 두 번째 매개변수로 중첩 클래스에 대한 추가 검증을 수행할 수 있습니다.

[Fact]
public void CommandClasses_ShouldHave_SealedRequestAndResponse()
{
    ArchRuleDefinition.Classes()
        .That()
        .ResideInNamespace(ApplicationNamespace)
        .And()
        .AreNotNested()
        .ValidateAllClasses(Architecture, @class => @class
            .RequireNestedClass("Request", nested => nested
                .RequireSealed())
            .RequireNestedClass("Response", nested => nested
                .RequireSealed()),
            verbose: true)
        .ThrowIfAnyFailures("Command Nested Class Rule");
}

.AreNotNested()를 사용하여 최상위 클래스만 대상으로 합니다. 중첩 클래스 자체가 검증 대상이 되는 것을 방지합니다.

중첩 클래스의 불변성 검증

[Fact]
public void CommandClasses_ShouldHave_ImmutableNestedClasses()
{
    ArchRuleDefinition.Classes()
        .That()
        .ResideInNamespace(ApplicationNamespace)
        .And()
        .AreNotNested()
        .ValidateAllClasses(Architecture, @class => @class
            .RequireNestedClass("Request", nested => nested
                .RequireSealed()
                .RequireImmutable())
            .RequireNestedClass("Response", nested => nested
                .RequireSealed()
                .RequireImmutable()),
            verbose: true)
        .ThrowIfAnyFailures("Command Nested Immutability Rule");
}

중첩 클래스 검증 콜백 안에서 RequireImmutable()을 체이닝할 수 있습니다.

선택적 중첩 클래스 검증

RequireNestedClassIfExists()는 중첩 클래스가 있을 때만 검증하고, 없으면 통과합니다.

[Fact]
public void CommandClasses_ShouldOptionallyHave_Validator()
{
    ArchRuleDefinition.Classes()
        .That()
        .ResideInNamespace(ApplicationNamespace)
        .And()
        .AreNotNested()
        .ValidateAllClasses(Architecture, @class => @class
            .RequireNestedClassIfExists("Validator", nested => nested
                .RequireSealed()),
            verbose: true)
        .ThrowIfAnyFailures("Optional Validator Nested Class Rule");
}

한눈에 보는 정리

다음 표는 중첩 클래스 검증 메서드의 동작 차이를 비교합니다.