집중적인 도메인 애플리케이션 생성. Symfony 접근 방식(검증 오류 관리)

소개

지난 게시물에서 우리는 직렬 변환기 및 유효성 검사기 심포니 구성 요소가 애플리케이션에서 일반적인 작업을 수행하는 데 도움이 되는 도구를 제공하는 인프라 서비스로 어떻게 작동하는지 분석했습니다. 또한 UserInputDTO 클래스가 비즈니스 규칙을 포함하고 있기 때문에 우리 도메인에 속한 요소인 이유와 데이터 흐름 추출 및 유효성 검사를 수행하는 애플리케이션 계층 서비스를 생성하는 방법도 배웠습니다.

이번 두 번째 부분에서는 유효성 검사 오류를 관리하는 방법을 살펴보고 첫 번째 부분과 마찬가지로 어떤 부분이 도메인에 속하는지 식별합니다.

유효성 검사 오류

검증 제약 조건을 사용하여 설정된 규칙에 따라 UserInputDTO를 검증한 후 Symfony 검증기 구성 요소에서 검증 오류가 반환됩니다.

public function processData(string $content, string $dtoClass): object
{
     $requestData = json_decode($content, true);
     $userInputDTO = $serializer->denormalize($requestData, UserInputDTO::class);
     $errors = $validator->validate($userInputDTO);
     if(count($errors) > 0) {
         throw new ValidationFailedException($errors);
     }

     return $userInputDTO
}

위 코드에서 볼 수 있듯이 유효성 검사 메서드에서 오류가 발견되면 ValidationException 유형의 예외가 발생합니다. 여기에서 사용자에게 오류를 표시하는 방법(도메인/비즈니스 규칙)과 오류가 사용자에게 올바르게 도달하도록 사용할 도구(인프라 및 애플리케이션)를 결정해야 합니다.

검증 오류 포착을 중앙 집중화

가장 먼저 고려해야 할 점은 유효성 검사 오류가 발생할 때마다 이를 포착해야 한다는 것입니다. 이를 달성하기 위해 우리는 인프라 계층에 의존할 것입니다.
Symfony 커널에는 특수 이벤트를 수신하기 위한 내장 커널 이벤트 세트가 함께 제공됩니다. 이 이벤트 중 하나는 예외가 발생할 때 트리거되는 커널 예외 이벤트입니다. ValidationException 오류를 잡는 데 사용해 보겠습니다.

class KernelSubscriber implements EventSubscriberInterface
{
    public static function getSubscribedEvents(): array
    {
        return [
            KernelEvents::EXCEPTION => 'onException'
        ];
    }

    public function onException(ExceptionEvent $event): void
    {
        $exception = $event->getThrowable();
        if($exception instanceof ValidationFailedException){
            // Business rules to build the errors
        }
    }
}

위 코드에서 볼 수 있듯이 KernelSubscriber는 KernelException 이벤트를 계속 수신하고 포착된 예외가 ValidationFailedException 클래스. 여기서는
onException 메소드가 유효성 검사 오류임을 감지할 때 실행될 로직을 정의해야 합니다.

오류 배열을 구성하기 위한 도메인 서비스 만들기

오류를 구조화하는 방법(비즈니스 규칙 정의)을 결정하는 책임은 우리가 담당하므로 논리를 수행하는 서비스는 우리 도메인에 속하게 됩니다. 코딩해보자

class ValidationErrorsBuilder {

    public function buildErrors(ValidationFailedException $exception): array
    {
        $errors = [];
        foreach ($exception->getViolations() as $violation) {
            $errors[$violation->getPropertyPath()] = $violation->getMessage();
        }

        return $errors;
    }
}

ValidationErrorsBuilder 코드는 매우 간단합니다. 위반 오류를 반복하고 키가 오류를 생성한 속성이고 값이 오류 메시지인 연관 배열을 생성합니다.

ValidationErrorsBuilder 사용

이제 ValidationErrorsBuilder 도메인 서비스를 사용할 차례입니다. 우리는 이를 KernelSubscriber onException 메소드에서 사용하고 있습니다.

public function processData(string $content, string $dtoClass): object
{
     $requestData = json_decode($content, true);
     $userInputDTO = $serializer->denormalize($requestData, UserInputDTO::class);
     $errors = $validator->validate($userInputDTO);
     if(count($errors) > 0) {
         throw new ValidationFailedException($errors);
     }

     return $userInputDTO
}

보시다시피 예외가 ValidationFailedException이라는 것을 확인한 후 도메인 서비스를 사용하여 유효성 검사 오류 배열을 가져옵니다.
이제 다음 코드를 살펴보겠습니다.

class KernelSubscriber implements EventSubscriberInterface
{
    public static function getSubscribedEvents(): array
    {
        return [
            KernelEvents::EXCEPTION => 'onException'
        ];
    }

    public function onException(ExceptionEvent $event): void
    {
        $exception = $event->getThrowable();
        if($exception instanceof ValidationFailedException){
            // Business rules to build the errors
        }
    }
}

오류 배열을 포함하는 Symfony JsonResponse를 새 응답으로 설정하고 반환된 HTTP 코드가 400 잘못된 요청이 되도록 지정하는 새 줄을 추가했습니다.
우리는 Symfony Response HTTP_BAD_REQUEST 상수를 사용하여 응답 HTTP 코드를 지정했습니다. 도메인 중심 환경에서 작업하고 있으므로 사용자 정의 도메인 클래스(예: PHP 열거형)를 생성할 수 있었지만 표준 HTTP 코드만 처리하면 되고 특별히 사용자 정의할 필요가 없으므로 다음을 사용할 수 있습니다. Symfony HTTP 코드는 프레임워크에 좀 더 의존하게 만듭니다.

그리고 애플리케이션 레이어는요?

지금까지 애플리케이션 레이어에 대해 이야기하지 않았습니다. 기사의 시작 부분에서 Symfony 프레임워크에는 우리가 사용한 것과 같은 유용한 내장 이벤트가 포함되어 있다고 말했습니다: 커널 예외 이벤트. 게다가, 심포니 프레임워크는 맞춤형 이벤트 구독자를 생성하고 필요한 이벤트를 들을 수 있는 EventSubscriberInterface도 제공합니다.
이 정보를 통해 우리는 Symfony가 커널 예외 이벤트와 EventSubscriberInterface를 제공한다는 결론을 내릴 수 있지만, 우리가 수신할 이벤트를 지정하는 구독자를 생성하려면 인터페이스를 사용해야 합니다. 다시 시작하겠습니다:

• 이벤트 구독자는 커널 예외 이벤트를 수신하도록 지정합니다.
• 이벤트 구독자는 예외가 ValidationFailedException의 인스턴스인지 확인합니다.
• 이벤트 구독자는 도메인 서비스를 사용하여 오류 배열을 구축합니다.
• 이벤트 구독자는 오류가 포함된 JsonResponse를 생성하여 최종 응답으로 설정합니다.

이 말이 익숙하게 들리나요? 예, 이벤트 구독자는 예외가 발생한 후 유효성 검사 오류를 관리하는 조정 및 조정을 담당하므로 이벤트 구독자가 애플리케이션 서비스 역할을 한다고 말할 수 있습니다.
한 단계 더 나아가고 싶다면 애플리케이션 계층 서비스를 생성하여 구독자에서 사용할 수 있습니다.

class ValidationErrorsBuilder {

    public function buildErrors(ValidationFailedException $exception): array
    {
        $errors = [];
        foreach ($exception->getViolations() as $violation) {
            $errors[$violation->getPropertyPath()] = $violation->getMessage();
        }

        return $errors;
    }
}

public function onException(ExceptionEvent $event): void
{
    $exception = $event->getThrowable();
    if($exception instanceof ValidationFailedException){
       $errors = $this->validationErrorsBuilder->buildErrors($exception);
    }
}

이제 ValidationErrorsProcessor는 유효성 검사 오류 응답 관리를 조정하고 ValidationErrorsBuilder 도메인 서비스

를 사용하는 애플리케이션 서비스 역할을 합니다.

결론

이 시리즈의 두 번째 기사에서는 유효성 검사 오류 관리 프로세스의 어떤 구성 요소가 도메인에 속하는지, 우리가 사용한 인프라 요소는 무엇인지, 커널 구독자가 애플리케이션 서비스 역할을 할 수 있는 방법을 식별했습니다.
다음 글에서는 데이터베이스에 엔터티를 유지하고 DTO를 지속 가능한 엔터티로 변환하는 논리를 분리하는 방법을 분석하겠습니다.

위 내용은 집중적인 도메인 애플리케이션 생성. Symfony 접근 방식(검증 오류 관리)의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!