10.6. Criando uma API REST básica com NodeJS e ExpressJS: Implementação dos métodos HTTP

Página 71

10.6. Criando uma API REST básica com NodeJS e ExpressJS: Implementação dos métodos HTTP

NodeJS é uma plataforma de desenvolvimento de software que permite a execução de JavaScript no lado do servidor. ExpressJS, por outro lado, é um framework para NodeJS que fornece recursos para a construção de APIs web de uma maneira rápida e fácil. Neste capítulo, exploraremos como criar uma API REST básica usando NodeJS e ExpressJS, com foco na implementação dos métodos HTTP.

Configurando o ambiente

Antes de começar a construir nossa API, precisamos instalar o NodeJS e o ExpressJS. Você pode baixar o NodeJS do site oficial e, após a instalação, pode instalar o ExpressJS usando o gerenciador de pacotes npm que vem com o NodeJS. O comando a seguir instala o ExpressJS:

npm install express

Criando a estrutura básica do projeto

Para o nosso projeto, vamos criar uma pasta chamada "api-rest-node", e dentro dela, vamos criar um arquivo chamado "app.js". Este arquivo será o ponto de entrada para nossa aplicação. Dentro do "app.js", vamos importar o express e criar uma instância do mesmo:

const express = require('express'); const app = express();

Em seguida, vamos dizer ao nosso aplicativo para escutar na porta 3000:

app.listen(3000);

Implementação dos métodos HTTP

Os métodos HTTP são as operações que podemos realizar em um recurso em uma API REST. Os mais comuns são GET, POST, PUT e DELETE. Vamos implementar cada um deles.

GET

O método GET é usado para recuperar dados de um recurso. No ExpressJS, podemos implementar uma rota GET da seguinte maneira:

app.get('/recursos', (req, res) => { res.send('Recuperando recursos'); });

Aqui, estamos dizendo ao ExpressJS para responder com "Recuperando recursos" quando um cliente faz uma solicitação GET para "/recursos".

POST

O método POST é usado para enviar dados a um recurso. A implementação de uma rota POST é semelhante à de uma rota GET:

app.post('/recursos', (req, res) => { res.send('Criando um recurso'); });

Aqui, estamos respondendo com "Criando um recurso" quando um cliente faz uma solicitação POST para "/recursos".

PUT

O método PUT é usado para atualizar um recurso existente. A implementação de uma rota PUT é a seguinte:

app.put('/recursos/:id', (req, res) => { res.send(`Atualizando o recurso com id ${req.params.id}`); });

Aqui, estamos respondendo com "Atualizando o recurso com id {id}" quando um cliente faz uma solicitação PUT para "/recursos/{id}".

DELETE

O método DELETE é usado para excluir um recurso. A implementação de uma rota DELETE é a seguinte:

app.delete('/recursos/:id', (req, res) => { res.send(`Excluindo o recurso com id ${req.params.id}`); });

Aqui, estamos respondendo com "Excluindo o recurso com id {id}" quando um cliente faz uma solicitação DELETE para "/recursos/{id}".

Conclusão

Com isso, criamos uma API REST básica com NodeJS e ExpressJS, implementando os métodos HTTP mais comuns. No entanto, esta é apenas a ponta do iceberg. Há muito mais que você pode fazer com NodeJS e ExpressJS, incluindo autenticação, validação de dados, manipulação de erros e muito mais. Esperamos que este guia tenha te dado uma boa base para começar a explorar mais.

Next page of the Free Ebook:

7210.7. Criando uma API REST básica com NodeJS e ExpressJS: Validação de dados