Особенности_NestJS_197863_b98adf-256522-cb6a13

Меня хорошо видно && слышно?
Ставьте , если все хорошо
Напишите в чат, если есть проблемы
+

Проверить, идет ли запись!

Активно участвуем
Задаем вопрос в чат или голосом
Off-topic обсуждаем в Slack #канал группы или #general
Вопросы вижу в чате, могу ответить не сразу
Правила вебинара

Особенности Nest.js
Николай Лапшин

Маршрут вебинара
Exception filters
Pipes
Рефлексия, ответы на вопросы
Кодинг
Guards
Custom Decorators
Авторизация, аутентификация
Кодинг

Exception filters

Exception filters

Exception filters
Nest имеет встроенный уровень исключений, который отвечает за обработку всех необработанных исключений в приложении.
Когда исключение не обрабатывается кодом вашего приложения, оно перехватывается этим уровнем.
{
"statusCode": 500,
"message": "Internal server error"
}

Фильтры по умолчанию

Exception filters

Exception filters: Стандартные исключения
@Catch()
export class AllExceptionsFilter implements ExceptionFilter {
catch(exception: any, host: ArgumentsHost) {
const ctx = host.switchToHttp();
const response = ctx.getResponse();
const request = ctx.getRequest();
const status =
exception instanceof HttpException
? exception.getStatus()
: HttpStatus.INTERNAL_SERVER_ERROR;
response.status(status).json({
statusCode: status,
error:exception,
timestamp: new Date().toISOString(),
path: request.url,
});
}
}

Exception filters: Стандартные исключения

Pipes

Nest Pipes

Nest Pipes

Nest Pipes
Используются для преобразования аргументов запросов
Также используются для валидации
Срабатываю перед вызовом метода
Аннотируются декоратором @Injectable()
Реализуют интерфейс PipeTransform

Nest Pipes
Pipes - класс, аннотированный с помощью декоратора @Injectable()
Выполняются перед вызовом метода
Реализуют интерфейс PipeTransform
Pipes имеют два типичных варианта использования:
Преобразование
Валидация

Nest Pipes
Pipes из коробки:
ValidationPipe
ParseIntPipe
ParseBoolPipe
ParseArrayPipe
ParseUUIDPipe
DefaultValuePipe
@Get(':id')
async findOne(@Param('id', ParseIntPipe) id: number) {
return this.catsService.findOne(id);
}
@Get()
async find(@Query('id', ParseArrayPipe) id: string[]) {
return this.catsService.find({ id });
}

Nest Pipes
Каждый pipe должен реализовывать метод transform
Метод имеет два параметра: входящее значение (value) и данные запроса (metadata)

Guards

Guards

Guards
Guard - это класс, определяющий, доступен ли запрос для выполнения по условиям
аннотируется @Injectable()
должен реализовать интерфейс CanActivate
выполняется после middleware, но перед любым перехватчиком (Interceptor) или Pipe

Guards: Authorization guard
import { Injectable, CanActivate, ExecutionContext } from '@nestjs/common';
import { Observable } from 'rxjs';
@Injectable()
export class AuthGuard implements CanActivate {
canActivate(
context: ExecutionContext,
): boolean | Promise
| Observable
{
const request = context.switchToHttp().getRequest();
return validateRequest(request);
}
}

Interceptors

Interceptors

Interceptors
Interceptor (Перехватчик) - это класс, аннотированный с помощью декоратора @Injectable()
Перехватчики должны реализовывать интерфейс NestInterceptor.

Interceptors
Interceptor (перехватчик) – класс, аннотированный @Injectable()
Реализует интерфейс NestInterceptor
Позволяют
привязать дополнительную логику до или после вызова метода
преобразовать результат, возвращаемый функцией
преобразовать исключение, выброшенное из функции
расширить основные функции поведения
полностью переопределить функцию в зависимости от конкретных условий

Interceptors: Создание перехватчика

Custom decorators

Custom decorators
Что такое декоратор?

Custom decorators

Custom decorators
Nest использует концепцию декораторов.
Декораторы в JavaScript на текущий момент находятся в Stage 2 (черновик)
Декораторы могут быть определены для класса, метода или свойства.

Custom decorators
Как мне работать с декораторами в других проектах?
Javascript: Для работы с декораторами необходим babel версии ^7.1.0 + плагин @babel/plugin-proposal-decorators
Typescript: В файле tsconfig.json в свойство compilerOptions выставить флаг "experimentalDecorators": true

Custom decorators
В Nest по умолчанию входит стандартный набор декораторов параметров (из пакета @nestjs/common)

Custom decorators: Создание декоратора

Аутентификация

Аутентификация
В чем различие аутентификации против авторизации?

Аутентификация

Аутентификация: Passport
Passport - самая популярная библиотека аутентификации node.js, хорошо известная сообществу и успешно используемая во многих производственных приложениях.

Аутентификация: JWT

Аутентификация: Установка Passport
$ npm install --save @nestjs/passport passport passport-local
$ npm install --save-dev @types/passport-local
Passport предоставляет стратегию, называемую локальным паспортом, которая реализует механизм аутентификации по имени пользователя и паролю

Итоги - тезисы
Познакомились с основными механизмами работы с запросами в nest.js:
exception filters, interceptors
1
Изучили, как преобразовывать параметры запроса при помощи pipes
Рассмотрели на практике как работает авторизация/аутентификаци
в nestjs
2
3

Список материалов для изучения
Nest Pipes
Class validator
Passport JS
Custom Decorators
Proposal-decorators
Про токены, JSON Web Tokens (JWT), аутентификацию и авторизацию. Token-Based Authentication