Проявлять себя

Express — это веб-фреймворк для Node, основанный на фреймворке Sinatra для Ruby . Он имеет множество функций, высокую производительность и поставляется с удобным исполняемым файлом для быстрого создания приложений. В этой статье мы рассмотрим, как вы можете приступить к работе с Express, что вы получаете, когда создаете новый веб-сайт Express, а также добавьте маршрут и представление для отображения результатов поиска из Twitter.

Установка Экспресс

Express можно легко установить через npm (менеджер пакетов узлов) :

$> npm install express -g 

-g на конце делает экспресс доступным во всем мире. Это означает, что мы можем запустить экспресс-файл из любого места, чтобы быстро создать новое приложение. Исполняемый файл Express, как ни странно, называется express:

 $> type express express is hashed (/usr/local/bin/express) 

Если вы введете команду самостоятельно, Express создаст новое приложение в текущем каталоге. Если текущий каталог не пустой, вас спросят, хотите ли вы продолжить:

 $> express destination is not empty, continue? 

Введите «y», если хотите продолжить, или «n», чтобы прервать. Вы не ограничены созданием новых приложений в текущем каталоге, вам просто нужно указать путь, по которому вы хотите создать новое приложение. Вы можете передать и другие варианты:

• -s чтобы включить сеансы
• -t или --template <engine> чтобы указать ваш шаблонизатор (в экспрессе по умолчанию используется jade)
• -c или --css для добавления поддержки CSS стилуса (по умолчанию обычный CSS)
• -v или --version для вывода текущей установленной вами версии express
• -h или --help для вывода этой справки и выхода

Список поддерживаемых шаблонизаторов приведен в экспресс-руководстве , а также в экспресс-вики . В этой статье мы будем использовать EJS . Давайте создадим новый сайт под названием myapp :

 $> express -t ejs myapp create : myapp create : myapp/package.json create : myapp/app.js create : myapp/public create : myapp/routes create : myapp/routes/index.js create : myapp/views create : myapp/views/layout.ejs create : myapp/views/index.ejs create : myapp/public/javascripts create : myapp/public/images create : myapp/public/stylesheets create : myapp/public/stylesheets/style.css dont forget to install dependencies: $> cd myapp && npm install 

Экспресс создает новый сайт в папке myapp для нас. Мы получаем: файл package.json файл app.js для кода приложения, каталог маршрутов для маршрутов, каталог представлений для наших шаблонов представлений и общедоступный каталог для наших CSS, изображений и JavaScript на стороне клиента. Express также напоминает нам об установке зависимостей и дает нам команду сделать это. Мы могли бы также напечатать это сейчас, прежде чем мы забудем:

 $> cd myapp && npm install npm http GET https://registry.npmjs.org/express/2.5.5 npm http GET https://registry.npmjs.org/ejs npm http 304 https://registry.npmjs.org/ejs npm http 304 https://registry.npmjs.org/express/2.5.5 npm http GET https://registry.npmjs.org/mime npm http GET https://registry.npmjs.org/qs npm http GET https://registry.npmjs.org/mkdirp/0.0.7 npm http GET https://registry.npmjs.org/connect npm http 304 https://registry.npmjs.org/mime npm http 304 https://registry.npmjs.org/qs npm http 304 https://registry.npmjs.org/mkdirp/0.0.7 npm http 304 https://registry.npmjs.org/connect npm http GET https://registry.npmjs.org/formidable npm http 304 https://registry.npmjs.org/formidable [email protected] ./node_modules/ejs [email protected] ./node_modules/express ├── [email protected] ├── [email protected] ├── [email protected] └── [email protected] 

Вы должны увидеть нечто похожее, хотя точный вывод может отличаться в зависимости от того, какие версии зависимостей доступны через npm, а какие уже установлены. Если вы сейчас node app.js в node app.js и node app.js по адресу http: // localhost: 3000, вы должны увидеть страницу Welcome to Express . Давайте посмотрим на код, сгенерированный Express, и на то, как он используется страницей приветствия.

app.js

app.js вы настраиваете свой сайт и определяете маршруты. Переменная app — это наш сервер Express, и мы вызываем ее функцию configure чтобы сообщить Express, какой механизм представления использовать, где искать статические ресурсы и как обрабатывать ошибки. Посмотрите на код app.js по умолчанию, вы увидите, что app.configure вызывается три раза:

• первый раз, когда он вызывается без аргумента имени — настройки будут применены к каждой среде
• во второй раз он errorHandler с development в качестве первого аргумента — эти настройки errorHandler будут применяться только в среде разработки
• в третий раз он errorHandler с production в качестве первого аргумента — errorHandler в производственной среде отключит дампы исключений и трассировки стека

Теперь посмотрите на последние две строки в app.js :

 app.listen(3000); console.log("Express server listening on port %d in %s mode", app.address().port, app.settings.env); 

Он сообщает Express, на каком порту прослушивать соединения, затем записывает сообщение на консоль, подтверждающее порт, который он прослушивает, а также текущую среду.

 $ node app.js Express server listening on port 3000 in development mode 

По умолчанию app.settings.env настроен на development . Чтобы изменить это в другую среду, например, рабочую, вставьте следующую строку над вызовом console.log :

 app.settings.env = 'production'; 

Перезапустите приложение ctrl+c , затем снова введите node app.js ), и режим должен был измениться на node app.js :

 $ node app.js Express server listening on port 3000 in production mode 

Маршрутизация

Express предоставляет 6 HTTP-глаголов в качестве API для определения маршрутов и позволяет захватывать параметры с помощью именованных параметров, подстановочных знаков, регулярных выражений и комбинаций всех трех. req.params значения будут доступны через req.params :

 // using a named parameter app.get('/foo/:id', function(req, res) { var fooId = req.params.id; ... }); // using regular expressions app.get(/^/foo/(d+)/, function(req, res) { var fooId = req.params[1]; ... }); // using a combination of the two app.get('/foo/:id([0-9]+)', function(req, res) { var fooId = req.params.id; ... }) 

 exports.index = function(req, res){ res.render('index', { title: 'Express' }) }; 

 <!DOCTYPE html> <html> <head> <title><%= title %></title> <link rel="stylesheet" href="/stylesheets/style.css" /> </head> <body> <%- body %> </body> </html> 

 <h1><%= title %></h1> <p>Welcome to <%= title %></p>