#2 – Контроллеры и маршруты

Контроллеры и маршруты в NestJS — это фундаментальная часть любого приложения на этом фреймворке. Контроллер отвечает за приём входящих HTTP-запросов и отправку ответа пользователю. Именно в нём мы определяем, какие URL-адреса (маршруты) будут существовать в нашем приложении и как они будут обрабатываться.

Контроллеры в NestJS создаются с помощью декоратора @Controller(). Внутри класса можно описывать методы, которые будут обрабатывать запросы по определённым HTTP-методам — @Get(), @Post(), @Put(), @Delete() и другим. Такой подход упрощает организацию кода и делает структуру приложения понятной и предсказуемой.

Передача данных в контроллер возможна несколькими способами. Если данные приходят в самом URL, мы можем получить их через @Param(). Если они находятся в строке запроса (?key=value), используется @Query(). Для передачи данных через тело запроса, например при POST-запросах, применяется @Body().

NestJS также предоставляет встроенные механизмы для обработки ошибок. Если необходимо вернуть пользователю код ответа 404, можно использовать NotFoundException, а для ошибок 400 — BadRequestException. Это позволяет чётко контролировать, какой статус и сообщение увидит клиент.