NestJS Node.js (Como funciona para desenvolvedores)

Suporte a TypeScript

O TypeScript, um superconjunto de JavaScript com tipagem estática que oferece recursos sofisticados de autocompletar, segurança de tipos e funcionalidades modernas da linguagem, é utilizado na construção do NestJS. Isso aumenta a facilidade de manutenção do código e auxilia na detecção de erros durante a compilação. O NestJS oferece suporte a JavaScript e TypeScript por padrão, dando aos desenvolvedores mais liberdade.

Arquitetura Modular

O NestJS incentiva a organização do código baseada em módulos. É mais fácil manter, dimensionar e organizar o código quando componentes relacionados, como controladores, provedores e serviços, são encapsulados em um único módulo. Os módulos da aplicação podem ser utilizados em outras áreas, incentivando a filosofia DRY (Don't Repeat Yourself - Não se Repita).

Injeção de Dependência

Uma das principais funcionalidades do NestJS que facilita o gerenciamento de dependências é um sistema sofisticado de injeção de dependências. Ao injetar dependências em vez de codificá-las diretamente no código, o NestJS cria componentes fracamente vinculados e testáveis. Esse estilo também possibilita um código mais modular e uma melhor separação de responsabilidades.

Decoradores

Os decoradores são amplamente utilizados no NestJS para criar e configurar classes e seus membros. O uso de decoradores como @Controller(), @Get(), @Post(), @Injectable() e outros melhora a legibilidade e a expressividade do código, tornando evidente o que cada componente do aplicativo faz e como ele se comporta.

Compatibilidade com Express e Fastify

Graças à sua adaptabilidade, o NestJS oferece aos desenvolvedores a opção de usar o Fastify ou o Express como servidor HTTP subjacente. Embora o Fastify ofereça melhor desempenho, o Express é conhecido por ser fácil de usar e eficiente. Graças a essa versatilidade, os desenvolvedores podem adaptar seus aplicativos para atender a requisitos específicos.

Middleware

O NestJS oferece suporte a funcionalidades de middleware semelhantes ao Express. Antes que as requisições cheguem aos manipuladores de rotas, o middleware pode processá-las, fornecendo funcionalidades como análise do corpo da requisição, autenticação e registro de logs. Isso facilita a implementação de lógica reutilizável para o tratamento de solicitações.

Tratamento de Exceções

O NestJS possui um sistema robusto de tratamento de exceções que permite aos programadores criar filtros de exceção exclusivos. Esses filtros podem melhorar o gerenciamento de erros e a uniformidade de resposta em toda a aplicação, capturando e tratando exceções de maneira padronizada.

Tubos e protetores

Pipes: A transformação e validação de dados são realizadas usando pipes. Eles podem ser implementados no nível do controlador, no nível do manipulador de rotas ou globalmente. Os fluxos de validação e transformação já estão integrados, e também é possível criar fluxos personalizados.

Guardas: A lógica de autorização e autenticação é implementada pelos guardas. Eles utilizam regras específicas, como a verificação de funções ou permissões do usuário, para decidir se aprovam ou não uma solicitação.

Instale a CLI do NestJS

Primeiro, instale a CLI do NestJS globalmente, seja com o Yarn ou o npm.

npm install -g @nestjs/cli

npm install -g @nestjs/cli

Criar um novo projeto

Para iniciar um novo projeto NestJS, use a CLI. Substitua "my-nest-app" pelo nome do projeto desejado.

nest new my-nest-app

nest new my-nest-app

Estrutura do Projeto

Segue um breve resumo da estrutura padrão do projeto:

src/
├── app.controller.ts
├── app.controller.spec.ts
├── app.module.ts
├── app.service.ts
├── main.ts
test/
├── app.e2e-spec.ts
└── jest-e2e.json

• app.controller.ts: Contém o controlador principal da aplicação.
• app.service.ts: Contém o serviço principal da aplicação.
• app.module.ts: O módulo raiz da aplicação.
• main.ts: O ponto de entrada da aplicação.

Módulo de Configuração

Para gerenciar as configurações, instale o pacote @nestjs/config.

npm install @nestjs/config

npm install @nestjs/config

Adicione o módulo de configuração ao arquivo app.module.ts.

import { Module } from '@nestjs/common';
import { ConfigModule } from '@nestjs/config';
import { AppController } from './app.controller';
import { AppService } from './app.service';

@Module({
  imports: [
    ConfigModule.forRoot({
      isGlobal: true, // Make the module global
    }),
  ],
  controllers: [AppController],
  providers: [AppService],
})
export class AppModule {}

Para acessar as variáveis ​​de ambiente, utilize o serviço de configuração.

import { Injectable } from '@nestjs/common';
import { ConfigService } from '@nestjs/config';

@Injectable()
export class AppService {
  constructor(private configService: ConfigService) {}

  getHello(): string {
    return `Hello World!`;
  }
}

Funcionalidades do IronPDF

npm install @ironsoftware/ironpdf

npm install @ironsoftware/ironpdf

Criar um serviço de PDF

Para gerenciar a geração de PDFs, crie um novo serviço. Esse serviço converterá informações HTML em PDFs usando o IronPDF.

nest generate service pdf

nest generate service pdf

Aplique a lógica de geração de PDF no arquivo pdf.service.ts criado.

// src/pdf/pdf.service.ts
import { Injectable } from '@nestjs/common';
const IronPdf = require('@ironsoftware/ironpdf');
const document = IronPdf.PdfDocument;
var config = IronPdf.IronPdfGlobalConfig;
config.setConfig({ licenseKey: '' });

@Injectable()
export class PdfService {
  async generatePdf(htmlContent: string): Promise<Buffer> {
    const pdf = await document.fromHtml(htmlContent);
    const pdfBuffer = await pdf.saveAsBuffer();
    return pdfBuffer;
  }
}

Criar um controlador de PDF

Crie um controlador para disponibilizar um endpoint para a criação de PDFs.

nest generate controller pdf

nest generate controller pdf

Crie um endpoint no arquivo pdf.controller.ts resultante que receba um elemento HTML como entrada e gere um PDF como saída.

// src/pdf/pdf.controller.ts
import { Controller, Post, Body, Res } from '@nestjs/common';
import { PdfService } from './pdf.service';
import { Response } from 'express';

@Controller('pdf')
export class PdfController {
  constructor(private readonly pdfService: PdfService) {}

  @Post('generate')
  async generatePdf(@Body('html') htmlContent: string, @Res() res: Response) {
    const pdfBuffer = await this.pdfService.generatePdf(htmlContent);
    res.set({
      'Content-Type': 'application/pdf',
      'Content-Disposition': 'attachment; filename=generated.pdf',
      'Content-Length': pdfBuffer.length,
    });
    res.end(pdfBuffer);
  }
}

O IronPDF é usado para transformar o conteúdo HTML em um buffer PDF, que é então retornado usando o PdfService. O PdfService usa o IronPDF para renderizar HTML como um PDF. Essa integração é facilmente gerenciada através do controlador NestJS. O próximo passo é definir um endpoint POST, /generate, para receber o conteúdo HTML do cliente. Utilizando a biblioteca IronPDF , convertemos os dados HTML fornecidos em um PDF dentro da API.

Para sermos mais precisos, criamos um buffer binário do arquivo PDF usando pdf.saveAsBuffer() e criamos um objeto PDF a partir do conteúdo HTML usando IronPdf.fromHtml(htmlContent). Em seguida, esse buffer é retornado ao cliente com o tipo MIME apropriado (application/pdf). O servidor escuta na porta 3000 e registra quaisquer problemas encontrados durante o processo de criação do PDF. Em resposta, o cliente recebe um código de status 500 de erro. Essa configuração é útil na criação de faturas, relatórios ou outros documentos para um aplicativo web, pois permite a criação de PDFs dinâmicos a partir de conteúdo HTML.