Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/maestropravaler/nestjs_api


https://github.com/maestropravaler/nestjs_api

Last synced: 1 day ago
JSON representation

Awesome Lists containing this project

README 

        
# NestJS (API REST)



O Objetivo deste curso é desenvolver uma API rest com buscas, validações e detalhes arquiteturais.



![](assets/images/titulo.png)



## Definindo domínio de Usuarios



1. Inicializando nosso projeto

  ```

  nest new nome-do-projeto

  ```

2. Separando nosso projeto por domínios (Criando a pasta `src/usuario`)

3. Criando o controller src/usuario/usuario.controller.ts

4. Criando o Metodo CRIAR (POST) src/usuario/usuario.controller.ts

5. Criando o Service src/usuario/usuario.service.ts

6. Testando as rotas api.http



## Organização do projeto e injeção de dependências



1. Decorator @Injectable()

2. Injeção de dependência no controller

3. Conceito de Provider para o NestJS (toda classe que recebe o decorator @Injectable() é um provider)

4. Todo provider precisa ser declarado entro de um Módulo da aplicação

5. Um módulo tem a função de organizar classes que tenham correlação entre si

6. Criando o módulo src/usuario/usuario.module.ts

7. Importanto do módulo criado para o módulo principal da nossa aplicação src/app.module.ts

8. Criando o arquivo entity src/usuario/usuario.entity.ts

9. Criando busca passando o nome na URL (utilização do @Param())

10. Testando as rotas api.http



## Validação de dados



1. Instalando as biliotecas de validação

  ```

  npm install [email protected] [email protected] --save-exact

  ```

2. Utilização dos decoreators @IsNotEmpty() e @IsEmail() etc...

3. Utilizando os pipes de validação - Configurando o main.ts

4. Testando as rotas api.http (Erros de Validação)

5. Criando validação personalizada src/usuario/is-nome-de-usuario-unico-validator.ts

6. Utilizando !!! Para inverter o valor de false para true

7. Passos para criar um validador personalizado com injeção de dependência:

  - Colocar um @Injectable() na classe

  - Declarar a classe de validação no usuario.module.ts

  - No arquivo main.ts, utilizar o useContainer() para que o NestJS gerencie as injeções de dependência inclusive para o class-validator.

8. Testando as rotas api.http (Cadastrar o mesmo usuário vai gerar um erro de validação).

## Serialização e tratamento de erros



1. Entendendo o conceito de serialização

2. Utilizando o class-transformer

3. Utilizando o @Exclude() para excluir propriedades da serialização

4. Utilizando o @Expose() para incluir propriedades na serialização

5. Utilizando o interceptor para tratar os dados da request e response. src/app.module.ts

6. Tratamento de erros Criando um filtro genérico para tratar as exceptions src/common/filter/filtro-de-excecao-thhp.filter.ts

7. Declarar o filtro criado no app.module.ts

8. Modelos de maturidade de Leonard Richardson. (https://martinfowler.com/articles/richardsonMaturityModel.html)



## Aplicando os padrões REST



1. Colocando no header da resposta o Location da entidade criada

2. Realizando uma modificação dentro do framework para receber a resposta, independente da utilizaçã do express ou fastify. src/core/http/nest-response.ts

3. Implementando padrão de projeto builder para facilitar a criação de objetos complexos. src/core/http/nest-response-builder.ts

4. Ensinando o NestJS a tratar a resposta NestResponse que criamos (interceptor)

5. Polimorfismo (Esquema com o HttpAdapterHost)

 ![](assets/images/http-adapter-host.png)

6. Declarar o interceptor no app.module.ts

7. Gerando o erro 404 quando não encontrar o usuário

8. testando as rotas api.http