O Express é um framework mínimo para aplicações web do Node.js que fornece um conjunto de recursos para aplicativos web e móvel.
Instalação
Assumindo que já tenha instalado o Node.js, crie um diretório para conter o seu aplicativo, e torne-o seu diretório ativo.
mkdir myapp
cd myapp
Use o comando npm init para criar um arquivo package.json para o seu aplicativo. Para obter mais informações sobre como o package.json funciona, consulte Detalhes do tratamento de package.json do npm.
npm init
Este comando solicita por várias coisas, como o nome e versão do seu aplicativo. Por enquanto, é possível simplesmente pressionar Enter para aceitar os padrões para a maioria deles, com as seguintes exceções:
entry point: (index.js)
Insira app.js, ou qualquer nome que deseje para o arquivo principal. Se desejar que seja index.js, pressione Enter para aceitar o nome de arquivo padrão sugerido.
Agora instale o Express no diretório app e salve-o na lista de dependências. Por exemplo:
npm install express --save
Para instalar o Express temporariamente não o inclua na lista de dependências, omita a opção --save
:
npm install express
Um exemplo Hello world/Olá mundo
No diretório myapp, crie um arquivo chamado app.js
e inclua o seguinte código:
var express = require('express');
var app = express();
app.get('/', function (req, res) {
res.send('Olá mundo!');
});
app.listen(3000, function () {
console.log('App escutando a porta 3000!');
});
Execute o aplicativo com o seguinte comando:
node app.js
O aplicativo inicia um servidor e escuta a porta 3000 por conexões. O aplicativo responde com Olá mundo!
à solicitações para a URL raiz (/
) ou rota. Para todos os outros caminhos, ele irá responder com um 404 Not Found.
Então abra em seu navegador o endereço http://localhost:3000
para testar.
O
req
(requisição) eres
(resposta) emapp.get('/', function (req, res) {
, são os mesmos objetos que oNode
fornece, para que seja possível chamar oreq.pipe()
,req.on('data', callback)
e qualquer outra coisa que desejaria fazer sem o envolvimento doExpress
.
Mais detalhes em:
Gerador de aplicativos do Express
Use a ferramenta geradora de aplicativos, express-generator, para rapidamente criar uma estrutura básica de aplicativo.
Instale o express-generator com o comando a seguir:
npm install express-generator -g
Exiba as opções de comando com a opção -h
:
express -h
Usage: express [options][dir]
Options:
-h, --help output usage information
--version output the version number
-e, --ejs add ejs engine support
--hbs add handlebars engine support
--pug add pug engine support
-H, --hogan add hogan.js engine support
-v, --view <engine> add view <engine> support (ejs|hbs|hjs|jade|pug|twig|vash) (defaults to jade)
-c, --css <engine> add stylesheet <engine> support (less|stylus|compass|sass) (defaults to plain css)
--git add .gitignore
-f, --force force on non-empty directory
Por exemplo, o seguinte cria um aplicativo do Express chamado myapp
no diretório atualmente em funcionamento:
express --view=pug myapp
create : myapp
create : myapp/package.json
create : myapp/app.js
create : myapp/public
create : myapp/public/javascripts
create : myapp/public/images
create : myapp/routes
create : myapp/routes/index.js
create : myapp/routes/users.js
create : myapp/public/stylesheets
create : myapp/public/stylesheets/style.css
create : myapp/views
create : myapp/views/index.pug
create : myapp/views/layout.pug
create : myapp/views/error.pug
create : myapp/bin
create : myapp/bin/www
Em seguida instale as dependências:
cd myapp
npm install
No MacOS ou Linux, execute o aplicativo com este comando:
DEBUG=myapp:* npm start
No Windows, use este comando:
set DEBUG=myapp:* & npm start
Em seguida navegue para o endereço http://localhost:3000/
no seu navegador para acessar o aplicativo.
O aplicativo gerado possui a seguinte estrutura de diretórios:
.
├── app.js
├── bin
│ └── www
├── package.json
├── public
│ ├── images
│ ├── javascripts
│ └── stylesheets
│ └── style.css
├── routes
│ ├── index.js
│ └── users.js
└── views
├── error.pug
├── index.pug
└── layout.pug
7 directories, 9 files