Как создать простой веб-сервер с Node.js

Модуль готов к тому, чтобы быть востребованным (импортированным) другим файлом JavaScript. Вы можете проверить это, создав еще один файл с именем printMessages.js , цель которого состоит в том, чтобы циклически проходить через сообщения и регистрировать их на консоли с помощью кода, приведенного в листинге 1. Сначала требуется локальный модуль, используя объект require и имя файла модуля ( с расширением .js или без него). Затем обратитесь к массиву модуля с помощью переменной, настроенной в printMessages.js .

Листинг 1. printMessages.js сообщений для консоли в printMessages.js

 const messageModule = require('./messages'); 1 messageModule.messages.forEach( (m) => { 2 console.log(m); }); 

1. Требуется локальный модуль messages.js .
2. Обратитесь к массиву модуля через messageModule.messages .

require — это еще один глобальный объект Node.js, используемый для локального представления методов и объектов из других модулей. Node.js интерпретирует require('./messages'); искать модуль с именем messages.js в каталоге вашего проекта и разрешать коду в printMessages.js использовать любые свойства, добавленные в объект экспорта.

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

Запуск команд npm

С вашей установкой Node.js вы также получили менеджер пакетов Node (npm). Как следует из названия, npm отвечает за управление внешними пакетами (модули, которые другие создали и сделали доступными онлайн) в вашем приложении. Во время разработки приложений npm будет использоваться для установки, удаления и изменения этих пакетов. Ввод npm -l в вашем терминале вызывает список команд npm с краткими пояснениями.

Листинг 2 содержит несколько команд npm, о которых вы захотите узнать.

Листинг 2. Команды Npm, которые нужно знать

• npm init . Инициализирует приложение Node.js и создает файл package.json
• npm install <package> . Устанавливает пакет Node.js.
• npm publish . Сохраняет и загружает созданный вами пакет в сообщество пакетов npm.
• npm start . Запускает приложение Node.js (при условии, что файл package.json настроен для использования этой команды). npm stop выйдет из запущенного приложения.

При использовании npm install <package> добавление --save к вашей команде устанавливает пакет как зависимость для вашего приложения. --global устанавливает пакет на ваш компьютер для использования в любом месте терминала. Эти расширения команд, называемые флагами, имеют сокращенные формы -S и -g соответственно. npmuninstall <package> отменяет действие установки. Если проект требует этого, npm install express -S можно использовать для установки инфраструктуры Express.js, а npm install express-generator -g для установки генератора Express.js для использования в качестве инструмента командной строки.

Модули и пакеты

На протяжении всей вашей разработки с Node.js вы много слышали о модуле терминов и пакете. Вот что вам нужно знать:

• Модули — это отдельные файлы JavaScript, содержащие код, относящийся к одной концепции, функциональности или библиотеке.
• Пакеты могут содержать несколько модулей или один модуль. Пакеты используются для группировки файлов, предлагающих соответствующие инструменты.

ПРИМЕЧАНИЕ. «Зависимости» — это модули Node.js, используемые приложением или другим модулем. Если пакет считается зависимостью приложения, он должен быть установлен (в версии, указанной приложением), прежде чем приложение сможет успешно работать.

Если вы хотите включить какую-либо функциональность в свое приложение, скорее всего, есть пакет, который вы можете найти на сайте npmjs.com для выполнения этой задачи. Давайте продолжим и добавим возможность определять местонахождение ваших пользователей на основе их почтового индекса.

Для этого нам нужно установить пакет city , созданный для преобразования текстовых адресов в координаты местоположения. Тем не менее, мы до сих пор упускаем одну вещь из этого проекта, прежде чем пакет может быть успешно установлен. Нам нужно правильно инициализировать проект Node.js и создать файл package.json используемый npm для установки cities , что мы и сделаем в следующем разделе.

Упражнение по быстрой проверке : какой флаг вы используете, если хотите установить пакет на ваш компьютер?

Инициализация приложения Node.js

Каждое приложение или модуль Node.js будет содержать файл package.json для определения свойств этого конкретного проекта. Этот файл живет на корневом уровне вашего проекта. Как правило, в этом файле указывается версия вашего текущего выпуска, название приложения и основной файл приложения. Этот файл важен для npm, чтобы сохранять любые пакеты в сообществе узлов в сети.

Для начала создайте папку с именем zip_connection , перейдите в каталог вашего проекта в терминале и используйте команду npm init для инициализации вашего приложения. Вам будет предложено указать название вашего проекта, версию приложения, краткое описание, имя файла, из которого вы запустите приложение (точка входа), тестовые файлы, репозитории git, ваше имя (автор). ) и лицензионный код. Пока что просто введите свое имя и нажмите Enter, чтобы принять все параметры по умолчанию. Как только вы подтвердите все эти изменения, вы должны увидеть новый файл package.json в каталоге вашего проекта, напоминающий содержимое листинга 3.

Листинг 3. Результат вашего файла package.json в вашем проекте zip_connection

 { "name": "zip_connection", "version": "1.0.0", "description": "An app to promote locally sourced food.", "main": "printMessages.js", "scripts": { "test": "echo \"Error: no test specified\" && exit 1" }, "author": "Jon Wexler", "license": "ISC" } 

В этом примере package.json содержит имя, версию, описание, начальный файл, пользовательские сценарии, автора и лицензию.

Теперь у вашего приложения есть отправная точка для сохранения и управления конфигурациями и пакетами приложений. Вы сможете установить cities , перейдя в папку вашего проекта и запустив в терминале следующее:

 npm install cities --save 

Также с этой установкой ваша папка проекта только что получила новую папку с именем node_modules . Содержимое кода только что установленного пакета city находится в этой папке.

СОВЕТ: Флаг --save сохранит пакет --save как зависимость для этого проекта. Проверьте ваш файл package.json сейчас, чтобы увидеть, как пакет перечислен под зависимостями. Поскольку ваша папка node_modules будет увеличиваться в размере, не рекомендуется включать ее, когда вы node_modules код проекта в Интернете. Однако любой, кто загружает проект, может ввести npm install для автоматической установки всех зависимостей проекта, перечисленных в этом файле.

Протестируйте этот новый пакет, добавив строки из листинга 4 в main.js Начнем с того, что нам потребуется пакет локально установленных cities , и сделаем его доступным в этом файле. Затем мы будем использовать метод zip_lookup из пакета city, чтобы найти город по его почтовому индексу. Результат сохраняется в переменной myCity .

Листинг 4. Реализация пакета main.js в main.js

 const cities = require('cities'); var myCity = cities.zip_lookup(10016); console.log(myCity); 

Код выше делает следующее:

1. Требовать пакет cities .
2. Сохраните полученный город, используя метод zip_lookup .
3. Зарегистрируйте результаты в своей консоли.

Полученные данные из этого почтового индекса выводятся на консоль, как показано в листинге 5.

Листинг 5. Пример результата запуска main.js в терминале

 { zipcode: '10016', state_abbr: 'NY', latitude: '40.746180', longitude: '-73.97759', city: 'New York', state: 'New York' } 

Метод zip_lookup возвращает объект JavaScript с координатами.

 const cities = require('cities'); const url = require('url'); const http = require('http'); const app = http.createServer((request, response) => { var city, query; query = url.parse(request.url, true).query; if (query.zipCode) city = cities.zip_lookup(query.zipCode).city; else city = "not found" response.writeHead(200, {"Content-Type": "text/html"}); response.write(`<h1>The city you are in is ${city}.</h1>`); response.end(); }); app.listen(3000);