Introdução ao Node.js e Setup de Projeto MVC com Express

1. O que é Node.js?

Node.js é um ambiente de execução de JavaScript fora do navegador, construído sobre o motor V8 do Google Chrome O V8 é o motor que executa JavaScript. Em termos simples, ele lê o código JavaScript, prepara esse código para execução e o roda de forma eficiente. O Chrome usa o V8 no navegador, e o Node.js também usa esse mesmo motor para executar JavaScript fora do browser. e focado em aplicações de rede rápidas e escaláveis.

Em vez de usar JavaScript apenas para interagir com o DOM no browser, com Node.js podemos criar servidores HTTP, lidar com arquivos, acessar bancos de dados e construir APIs completas usando a mesma linguagem do front-end.

2. Modelo assíncrono e Event Loop

2.1. Execução single-thread e I/O não bloqueante

O Node.js executa JavaScript em uma única thread, mas consegue lidar com muitas conexões simultâneas porque delega operações de I/O (leitura de arquivos, acesso a rede) ao sistema operacional e usa um modelo assíncrono baseado em eventos.

2.2. O que é o Event Loop?

O event loop é o mecanismo interno que controla a ordem em que o Node.js executa o código, processa callbacks assíncronos e lida com timers e I/O.

2.3. Exemplo prático: setTimeout vs. código síncrono

Observe este pequeno script em Node:

// arquivo: exemplo-event-loop.js

console.log("Início");

setTimeout(() => {
  console.log("Timeout executado");
}, 0);

console.log("Fim");
        

3. Módulos, NPM e package.json

3.1. Módulos em Node.js

Em Node.js organizamos o código em módulos, que são arquivos separados que exportam funções, objetos ou classes para serem reutilizados em outras partes da aplicação.

// arquivo: matematica.js
function soma(a, b) {
  return a + b;
}

module.exports = soma;

// arquivo: app.js
const soma = require("./matematica");

console.log(soma(2, 3)); // 5
        

Além de módulos próprios, o Node fornece módulos internos (como fs para arquivos, http para servidores) e permite instalar módulos de terceiros via NPM.

3.2. O que é o NPM?

O NPM (Node Package Manager) é o gerenciador de pacotes padrão do Node.js, usado para instalar bibliotecas, gerenciar versões e dependências de um projeto.

3.3. Arquivo package.json

O package.json descreve o projeto Node: nome, versão, ponto de entrada, scripts de execução e lista de dependências.

{
  "name": "meu-projeto-node",
  "version": "1.0.0",
  "main": "server.js",
  "scripts": {
    "start": "node server.js",
    "dev": "nodemon server.js"
  },
  "dependencies": {
    "express": "^4.19.0"
  },
  "devDependencies": {
    "nodemon": "^3.1.0"
  }
}
        

"scripts": {
          "start": "node server.js",
          "dev": "nodemon server.js"
        }

4. Organização básica de um projeto Node

Em projetos pequenos é comum começar com poucos arquivos, mas conforme a aplicação cresce, é importante separar responsabilidades em pastas como routes, controllers, models e views (padrão MVC).

meu-projeto/
├── package.json
├── server.js
├── src/
│   ├── routes/
│   ├── controllers/
│   ├── models/
│   └── views/
└── node_modules/
        

5. Prática: Setup do projeto do semestre (Node + Express + MVC)

Agora vamos montar, passo a passo, o esqueleto do projeto do semestre usando Node.js, Express e uma estrutura básica em MVC.

cd projeto-semestral-mvc

# cria o package.json com valores padrão
npm init -y
          

# dependência de produção
npm install express

# dependência de desenvolvimento (reinicia servidor automaticamente)
npm install --save-dev nodemon
          

"scripts": {
  "start": "node server.js",
  "dev": "nodemon server.js"
}
          

// server.js
const express = require("express");
const path = require("path");

const app = express();
const port = 3000;

// middleware para servir arquivos estáticos (CSS, imagens, etc.)
app.use(express.static(path.join(__dirname, "public")));

// rota básica de teste
app.get("/", (req, res) => {
  res.send("Servidor Express funcionando!");
});

// inicia o servidor
app.listen(port, () => {
  console.log(`Servidor rodando em http://localhost:${port}`);
});
          

projeto-semestral-mvc/
├── package.json
├── server.js
├── src/
│   ├── routes/
│   ├── controllers/
│   ├── models/
│   └── views/
└── public/
    └── css/
        └── style.css
          

<!DOCTYPE html>
<html lang="pt-BR">
<head>
  <meta charset="UTF-8" />
  <title>Projeto do Semestre</title>
  <link rel="stylesheet" href="/css/style.css" />
</head>
<body>
  <h1>Bem-vindo(a) ao projeto do semestre</h1>
  <p>Esta é a página inicial renderizada pelo servidor Express.</p>
</body>
</html>
              

// src/controllers/homeController.js
const path = require("path");

function getHome(req, res) {
  const filePath = path.join(__dirname, "..", "views", "home.html");
  res.sendFile(filePath);
}

module.exports = {
  getHome,
};
              

// src/routes/homeRoutes.js
const express = require("express");
const router = express.Router();
const homeController = require("../controllers/homeController");

router.get("/", homeController.getHome);

module.exports = router;
              

// server.js
const express = require("express");
const path = require("path");
const homeRoutes = require("./src/routes/homeRoutes");

const app = express();
const port = 3000;

app.use(express.static(path.join(__dirname, "public")));

// usa o conjunto de rotas da home
app.use("/", homeRoutes);

app.listen(port, () => {
  console.log(`Servidor rodando em http://localhost:${port}`);
});