[Node.js][Nest.js] 유효성 검사와 Data 형식 변환하기 - Pipe

 

🚀 Pipe

    🔽  개요

`Pipe`는 `Controller` 경로 처리기에 의해 처리되는 매개 변수에 의해 작동하는 것이에요.

`Nest.js`는 Method가 호출되기 직전에 `Pipe`를 삽입하고, `Pipe`는 Method를 향하는 매개 변수를 받은 뒤 이에 대해 작동하는 것이에요.

 

Pipe 작동 원리

 

► Data Transformation

입력 Data를 원하는 형식으로 변환 해주는 기능인 것이에요. (예 : 문자열을 정수로 변환)

만약 정수값을 `Client`가 보냈으면 하는데, 문자열 형식으로 온다면 `Pipe`에서 자동으로 숫자로 바꿔주는 것이에요.

 

 

► Data Validation

`Nest.js`에서는 `Pipe`를 이용하면 `@Valid`와 거의 똑같이 유효성 검사 기능을 이용할 수 있는 것이에요.

즉, 입력 Data를 검증하고, 유효한 경우 변경되지 않은 상태로 전달하면 되는 것이에요. 만약 그렇지 않다면 Data가 올바르지 않다는 `Exception`을 던져주면 되는 것이에요.

예를 들어 회원 이름이 10자 이하여야 하는데, 10자 이상 입력이 오면 `Exception`이 터지고 해당 내용을 반환하는 것이에요. 

 

        📦 Pipe의 모든 기능

또한 `Pipe`는 Method 동작 바로 직전에 작동 시켜 Method로 향하는 매개 변수에 대해 변화할 것이 있으면 변환하고, 동시에 유효성 검사를 위해서도 작동하는 것이에요.

 

 

 

 

    🔽  사용하는 방법 (Binding Pipes)

`Pipe`를 이용하는 방법은 크게 세가지로 구분할 수 있는 것이에요.

`Hendler-level Pipes`, `Parameter-level Pipes`, `Global-level Pipes`로 구분할 수 있는 것이에요.

 

        📦 Handler-level Pipes

`@UsePips()`를 이용해서 사용할 수 있는 것이에요.

이 `Pipe`는 모든 매개 변수(Parameter)에 적용이 되는 것이에요.

 

Handler-level Pipes 예시 코드

 

 

 

        📦 Parameter-level Pipes

 

Parameter-level Pipes 예시 코드

반응형

 

 

 

        📦 Global-level Pipes

 

Global-level Pipes 예시 코드

 

​

 

 

 

    🔽 Built-in Pipes

`Nest.js`에 기본적으로 이용할 수 있는 6가지 `Pipe`가 있는 것이에요.

● ValidationPipe
● ParseIntPipe
●  ParseBoolPipe
● ParseArrayPipe
● ParseUUIDPipe
​​

 

​

 

참고 자료 및 출처 : 인프런 - 따라하며 배우는 NestJS 강의