Mudanças entre as edições de "Exemplo de CRUD no Node.js"

Edição atual tal como às 17h19min de 18 de janeiro de 2024

Antes de começar

As orientações contidas neste tutorial exigem o painel Integrator Node.js. Caso seu plano não possua suporte ao Node.js, converse com o nosso comercial sobre planos disponíveis.

Criando bancos de dados, usuário e privilégios

1. Acesse o painel de controle cPanel com seu usuário e senha. Caso não saiba como acessar o painel Clique aqui

2. Ao acessar o painel cPanel, você poderá criar seu banco de dados mysql, usuário e atribuir os privilégios corretos do usuário ao banco, veja Clicando aqui.

3. Utilizando o PhpMyAdmin você pode criar tabelas, como mostramos no exemplo do SQL abaixo que sera usado para nosso CRUD posteriormente:

CREATE TABLE usuarios (
    id INT NOT NULL PRIMARY KEY AUTO_INCREMENT,
    nome VARCHAR(255) NOT NULL,
    email VARCHAR(255) NOT NULL
);

Explicação:

Esse SQL cria uma tabela "usuarios" com três colunas: "id", "nome" e "email".

A coluna "id" é uma chave primária numérica que se autoincrementa, enquanto as colunas "nome" e "email" são strings que não podem conter valores nulos.

3. Assim que tiver o banco de dados e usuario criados com as devidas permissões, faça a liberação de acesso remoto do mysql ao seu banco de dados.

Tambem mostramos em nosso wiki estes passos ilustrados, veja Clicando aqui.

Sobre o tutorial

O exemplo disponibilizado abaixo implementa um servidor Express que oferece uma API CRUD básica para operações de criação, leitura, atualização e exclusão de usuários em um banco de dados. Os dados são manipulados por meio de consultas SQL e as requisições do cliente são interpretadas usando o body-parser para acessar e processar as informações.

Para baixar o exemplo completo, Clique Aqui.

O arquivo index.js

O arquivo index.js possui o código apresentado na Listagem abaixo. Veja o detalhe da porta que não é definida diretamente. Usamos a variável process.env.PORT para que o painel forneça a porta.

Toda explicação detalhada do arquivo index.js, esta descrita no exemplo completo disponível para baixar, citado mais acima. Ao abrir o arquivo index.js, comentamos e explicamos cada linha apresentada do código.

const express = require('express');
const bodyParser = require('body-parser');
const db = require('./db');

const app = express();
app.use(bodyParser.json());
app.use(bodyParser.urlencoded({ extended: true }));

// Create (Criação)
app.post('/usuario', (req, res) => {
    const { nome, email } = req.body;
    const query = 'INSERT INTO usuarios (nome, email) VALUES (?, ?)';
    db.query(query, [nome, email], (err, results) => {
        if(err) throw err;
        res.send('Usuário adicionado com sucesso!');
    });
});

// Read (Leitura)
app.get('/usuarios', (req, res) => {
    db.query('SELECT * FROM usuarios', (err, rows) => {
        if(err) throw err;
        res.json(rows);
    });
});

// Update (Atualização)
app.put('/usuario/:id', (req, res) => {
    const { nome, email } = req.body;
    const query = 'UPDATE usuarios SET nome = ?, email = ? WHERE id = ?';
    db.query(query, [nome, email, req.params.id], (err, results) => {
        if(err) throw err;
        res.send('Usuário atualizado com sucesso!');
    });
});

// Delete (Exclusão)
app.delete('/usuario/:id', (req, res) => {
    const query = 'DELETE FROM usuarios WHERE id = ?';
    db.query(query, [req.params.id], (err, results) => {
        if(err) throw err;
        res.send('Usuário excluído com sucesso!');
    });
});


const PORT = process.env.PORT //aqui será a porta que o PM2 irá colocar
//const PORT = 3000;

app.listen(PORT, () => {
    console.log(`Server is running on port ${PORT}`);
});

O arquivo db.js

O arquivo db.js é onde ficara configurado a conexão de seu banco de dados, onde deve utilizar os dados abaixo(alterando-os para os de seu banco e usuario criados no painel cPanel).

• Host: localhost
• Porta: 3306
• Banco: nome_do_bancodedados
• Usuário: nome_do_usuariocriado
• Senha: senha_do_usuariocriado

const mysql = require('mysql');

const connection = mysql.createConnection({
    host: 'NomeDoHost',
    user: 'UsuárioDoMySQL',
    password: 'SenhaDoMySQL',
    database: 'NomeCompletoDoBanco'
});

connection.connect((err) => {
    if(err) throw err;
    console.log('Conectado ao banco de dados!');
});

module.exports = connection;

Subindo o aplicativo e registrando no Integrator Node.js

1. Para o deploy através do painel, use a aba Deploy e selecione o arquivo compactado .zip.

2. Em seguida, com upload feito corretamente e com sucesso, basta clicar para configurar o aplicativo no domínio/subdomínio

3. O registro do aplicativo ocorre quando ele já foi levado ao servidor, no diretório do seu usuário. O aplicativo precisa ser registrado para que ele se torne funcional no servidor, tanto no acesso através da porta definida, como também pelo domínio.

Figura: Registrando o aplicativo pelo painel

• O nome do aplicativo - Ele será identificado nas configurações do usuário;
  
• Dominio para Deploy - Selecione o domínio/subdomínio onde irá acessar o aplicativo;
  
• A URL do Aplicação - A raiz do domínio é para manter barra / apenas. Se colocar /outronome, o aplicativo só será visível quando acessar essa URI;
  
• Nodejs do Aplicativo - A versão do Node.js que vai operar em seu aplicativo;
  
• Memoria do Aplicativo - A memória que será definida no aplicativo;
  
• Index do Aplicativo - O arquivo inicial do aplicativo Node.js;
  
• Caminho do aplicativo - O caminho onde se encontra o aplicativo. Se subir pelo painel, o deploy fica no diretorio applications/ do seu usuário. O nome precisa ter o diretório onde se obtém ao descompactar o aplicativo, por exemplo;
  
• Porta do Aplicativo - A porta que será executado o aplicativo Node.js através do PM2;
  
• Modo de execução - O modo de execução do aplicativo. Pode ser Desenvolvimento ou Produção. O modo Desenvolvimento exibe erros em caso de falhas da execução;
  

Instalando as dependências

1. Em Ação, ainda na aba Aplicativos, clique no ícone Terminal.

2. No Terminal basta entrar no ambiente virtual para executar o npm. O comando npm é reconhecido assim que entra na pasta de seu aplicativo, ou seja, acesse o diretório onde esta localizado seu aplicativo, como por exemplo:

cd applications/exemplonodecrud  - Local onde esta localizado o aplicativo que foi feito deploy

3. Tambem pode ser acessado o ambiente virtual copiando o caminho que é informado no painel ao lado do nome do aplicativo no sinal de interrogação, como por exemplo:

source ~/nodevenv/exemplonodecrud/bin/activate && cd ~/applications/exemplonodecrud

4. Agora, execute o comando npm install que lerá seu arquivo package.js e recriará o diretório node_modules com as respectivas dependências:

npm install

Iniciando o aplicativo pelo painel

Na aba Aplicativos, você pode iniciar o projeto através do ícone de Start e Stop do aplicativo.

Iniciando o aplicativo via terminal SSH

Dentro do diretório virtual do aplicativo, basta digitar o seguinte comando:

pm2 start app.yaml

Testando o CRUD com Postman

Com o aplicativo registrado e iniciado corretamente com sucesso, temos o acesso testado e 100% funcional, no qual demonstramos em imagens abaixo:

Adicionando um usuário

Atualizando um usuário

Removendo um usuário

PS: Lembrando que estes endereços de acesso foram utilizados para testes e acessa-los no momento não reproduz o uso do aplicativo de teste.

Testes de acesso deve ser realizado com seu domínio e/ou subdomínio de acesso no qual registrou seu aplicativo.

Logs

A aba de Logs apresenta saídas informativas realizadas pelo PM2, assim como erros ou informações que seu aplicativo lançar.