Глобальные переменные node js. NodeJS

В узле вы можете установить глобальные переменные через объект «global» или «GLOBAL»:

GLOBAL._ = require("underscore"); // but you "shouldn"t" do this! (see note below)

или более полезно...

GLOBAL.window = GLOBAL; // like in the browser

Из источника узла вы можете видеть, что они псевдонимы друг другу:

Node-v0.6.6/src/node.js: 28: global = this; 128: global.GLOBAL = global;

В приведенном выше коде «это» является глобальным контекстом. С помощью модуля commonJS (какой узел использует), этот «объект» внутри модуля (т. Е. «Ваш код») НЕ является глобальным контекстом. Для доказательства этого, см. Ниже, где я извергаю «этот» объект, а затем гигантский объект «GLOBAL».

Console.log("\nTHIS:"); console.log(this); console.log("\nGLOBAL:"); console.log(global); /* outputs ... THIS: {} GLOBAL: { ArrayBuffer: , Int8Array: { BYTES_PER_ELEMENT: 1 }, Uint8Array: { BYTES_PER_ELEMENT: 1 }, Int16Array: { BYTES_PER_ELEMENT: 2 }, Uint16Array: { BYTES_PER_ELEMENT: 2 }, Int32Array: { BYTES_PER_ELEMENT: 4 }, Uint32Array: { BYTES_PER_ELEMENT: 4 }, Float32Array: { BYTES_PER_ELEMENT: 4 }, Float64Array: { BYTES_PER_ELEMENT: 8 }, DataView: , global: , process: { EventEmitter: , title: "node", assert: , version: "v0.6.5", _tickCallback: , moduleLoadList: [ "Binding evals", "Binding natives", "NativeModule events", "NativeModule buffer", "Binding buffer", "NativeModule assert", "NativeModule util", "NativeModule path", "NativeModule module", "NativeModule fs", "Binding fs", "Binding constants", "NativeModule stream", "NativeModule console", "Binding tty_wrap", "NativeModule tty", "NativeModule net", "NativeModule timers", "Binding timer_wrap", "NativeModule _linklist" ], versions: { node: "0.6.5", v8: "3.6.6.11", ares: "1.7.5-DEV", uv: "0.6", openssl: "0.9.8n" }, nextTick: , stdout: , arch: "x64", stderr: , platform: "darwin", argv: [ "node", "/workspace/zd/zgap/darwin-js/index.js" ], stdin: , env: { TERM_PROGRAM: "iTerm.app", "COM_GOOGLE_CHROME_FRAMEWORK_SERVICE_PROCESS/USERS/DDOPSON/LIBRARY/APPLICATION_SUPPORT/GOOGLE/CHROME_SOCKET": "/tmp/launch-nNl1vo/ServiceProcessSocket", TERM: "xterm", SHELL: "/bin/bash", TMPDIR: "/var/folders/2h/2hQmtmXlFT4yVGtr5DBpdl9LAiQ/-Tmp-/", Apple_PubSub_Socket_Render: "/tmp/launch-9Ga0PT/Render", USER: "ddopson", COMMAND_MODE: "unix2003", SSH_AUTH_SOCK: "/tmp/launch-sD905b/Listeners", __CF_USER_TEXT_ENCODING: "0x12D732E7:0:0", PATH: "/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin:~/bin:/usr/X11/bin", PWD: "/workspace/zd/zgap/darwin-js", LANG: "en_US.UTF-8", ITERM_PROFILE: "Default", SHLVL: "1", COLORFGBG: "7;0", HOME: "/Users/ddopson", ITERM_SESSION_ID: "w0t0p0", LOGNAME: "ddopson", DISPLAY: "/tmp/launch-l9RQXI/org.x:0", OLDPWD: "/workspace/zd/zgap/darwin-js/external", _: "./index.js" }, openStdin: , exit: , pid: 10321, features: { debug: false, uv: true, ipv6: true, tls_npn: false, tls_sni: true, tls: true }, kill: , execPath: "/usr/local/bin/node", addListener: , _needTickCallback: , on: , removeListener: , reallyExit: , chdir: , debug: , error: , cwd: , watchFile: , umask: , getuid: , unwatchFile: , mixin: , setuid: , setgid: , createChildProcess: , getgid: , inherits: , _kill: , _byteLength: , mainModule: { id: ".", exports: {}, parent: null, filename: "/workspace/zd/zgap/darwin-js/index.js", loaded: false, exited: false, children: , paths: }, _debugProcess: , dlopen: , uptime: , memoryUsage: , uvCounters: , binding: }, GLOBAL: , root: , Buffer: { poolSize: 8192, isBuffer: , byteLength: , _charsWritten: 8 }, setTimeout: , setInterval: , clearTimeout: , clearInterval: , console: , window: , navigator: {} } */

** Примечание: в отношении установки «GLOBAL._», в общем, вы должны просто выполнить var _ = require("underscore"); , Да, вы делаете это в каждом файле, который использует символ подчеркивания, точно так же, как в Java вы import com.foo.bar; , Это упрощает определение того, что делает ваш код, потому что ссылки между файлами являются «явными». Мягко раздражает, но хорошо. Это проповедь.

Существует исключение для каждого правила. У меня был точно точно один экземпляр, где мне нужно было установить «GLOBAL._». Я создавал систему для определения файлов «config», которые были в основном JSON, но были «написаны в JS», чтобы немного повысить гибкость. В таких конфигурационных файлах не было инструкций «require», но я хотел, чтобы они имели доступ к подчеркиванию (система ENTIRE была основана на шаблонах подчеркивания и подчеркивания), поэтому перед оценкой «config» я бы установил «GLOBAL._». Так что да, для каждого правила есть где-то исключение. Но у вас есть хорошая причина, а не просто «я устал от ввода», поэтому я хочу нарушить соглашение ».

Hey guys, in today"s article I want to talk about global variables in Node. This article is aimed at developers who are at a beginner to intermediate skill level working with Node. If you have never heard of global variables or worked with them, no need to worry. This article will get you up and running in no time with everything you need to know about global variables.

What are Global Variables?

Global variables are very similar, if not identical, to regular variables. Global variables can be initialized with a value, that value can be changed, and they can even be cleared out like a regular variable. The difference between a regular variable and a global variable comes down to their scope. When you create a variable in a JavaScript file, that variables only exists in the scope that it was declared in. Now what do I mean by this? In the code below, you can see an example of two different variables with different scopes.

// Scope.js let fileScope = "Can be accessed anywhere in the file"; function doSomething() { let localScope = "Can only be accessed inside this function"; fileScope = "Can be accessed in the function too!"; } // This will result in an error because the variable does not exist // outside the function. localScope = "Try and change me here";

In the code snippet above, we can see that there are two variables, fileScope and localScope . The variable fileScope can be changed or called from anywhere within this file, whereas the localScope variable only exists inside the function doSomething() . I"m sure at this point you are wondering what this has to do with global variables. When we talk about global variables, they exist for all of the files in a program meaning they have global scope for the program.

The reason this is possible is because JavaScript programs share a global namespace between all of the files in the program. To put it another way, imagine that your program is a giant file or container that has "imported" all the other JavaScript files. You then declare a variable in this large container file, that variable now has scope throughout the whole program. If you are not sure what a namespace is or you want to find out more about them, check out this article to learn more.

How to Declare and Use a Global Variable

Now that we have a better understanding of what a global variable in Node is, let"s talk about how we actually set up and use a global variable. To set up a global variable, we need to create it on the global object. The global object is what gives us the scope of the entire project, rather than just the file (module) the variable was created in. In the code block below, we create a global variable called globalString and we give it a value. Next, we change the value of globalString , and then finally we set it to undefined.

// Global.js global.globalString = "This can be accessed anywhere!"; console.log(globalString); // Output: "This can be accessed anywhere!" globalString = "Check me out now"; console.log(globalString); // Output: "Check me out now" globalString = undefined; console.log(globalString); // Output: undefined // Example.js // We can use the global we created in Global.js in this file // as well. console.log(globalString); // Output: undefined globalString = “We can change it too!"; console.log(globalString); // Output: "We can change it too!"

What I have not talked about yet is another way that you can make a variable global. The reason I have excluded this is because it is not a proper way of setting up a variable. If you declare a variable in a file without using the keyword var and then assign a value to it, the global object will set a property for this variable. This process essentially turns it into a globally accessible variable. I strongly advise against using this method though as it is not the proper way to go about creating globals. It is also important to note that if you set the "use strict" directive, Node will disable implicit globals and you will likely end up with an error at runtime rather than a working script.

Practical Use Cases for Global Variables

Now, you might be thinking to yourself that you want to go off and create global variables now that you know more about them. I am going to strongly caution against creating global variables for a few very important reasons.

The first reason is that when you create a global variable, it exists throughout the lifetime of the application. When a variable persists through the lifetime of the app it means that it is there, in memory, occupying resources while the app is running.

Second, traditionally using global variables can cause concurrency issues. If multiple threads can access the same variable and there are no access modifiers or failsafes in place, it can lead to some serious issues of two threads attempting to access and use the same variable. However , while this is the case in other languages, it is not necessarily the case for Node.js as it is strictly a single-threaded environment. While it is possible to cluster Node processes, there is no native way to communicate between them.

The last reason I am going to talk about is that using globals can cause implicit coupling between files or variables. Coupling is not a good thing when it comes to writing great code. When writing code, we want to make sure that it is as modular and reusable as possible, while also making sure it is easy to use and understand. Coupling pieces of your code together can lead to some major headaches down the road when you are trying to debug why something isn"t working.

If you want to know more about why globals are not recommended, you can check out this great article called Global Variables Are Bad .

If you feel confused as to the purpose of global variables, fear not. We are going to take a look at a few of the global variables that are built into Node and try to get a better understanding of why they are global and how they are used. In fact, you have probably used a few of them already without even realizing that they are global objects!

// Node Globals console.log("Hello World!"); process.env.PORT = 3000; setInterval({ console.log("2 seconds passed."); }, 2000);

If you take a look at the above code block you will probably see at least one instance you have used before, console.log() . According the the Node documentation, the console object is a global that has a few methods allowing developers to do things such as printing a log or an error. Digging deeper into the docs we can see that console is really a global instance that is configured to write to process.stdout and process.stderr .

This brings us to the next statement that you see in the code block above, the process object. If you have put up a production build of a Node application, then you have likely had to set the port for the environment variable. The environment variable env is a part of the process object which is another global. You can access variables on the process object in any file in your project because it is global. If this object was not global, the console object would not be accessible from any file either, remember it is really an object that refers back to the process object.

setInterval is another function that you may have seen before if you ever had reason to delay an operation before executing it. setTimeout and setImmediate are similar in nature to setInterval and are both global functions as well. These three functions are a part of the timer module which exposes a global API allowing you to call these functions without requiring timer in your files explicitly.

All of the above mentioned use cases are built in to Node and are global for a reason. The process object is global because it provides information about the current running Node process and therefore should be available from any file without having to require it. The same can be said of the timer module which contains a number of functions that are important and should be accessible anywhere without having to require it. If you would like to learn more about the existing global objects built into Node, I encourage you to visit the official documentation on Globals .

Learn More

Want to learn more about the fundamentals of Node.js? Personally, I"d recommend an online course, like Wes Bos" Learn Node.js since the videos are much easier to follow and you"ll actually get to build a real-world application.

Conclusion

I know that was quite a bit of information, so thank you for sticking it out. All of the above information was found in the documentation on Node"s website . Please feel free to ask questions and give comments in the comment section below. Until next time guys!

Всем привет! В этой статье мы продолжим разбираться с платформой NodeJS и поговорим про глобальный объект .

Вы уже должны быть знакомы с этим понятием. Когда мы пишем javascript код в браузере, то мы используем глобальный объект window . В NodeJS тоже есть глобальный объект и называется он просто Global .

Также как и window , Global позволяет нам использовать какие-то встроенные свойства и методы из любого места в коде. Давайте рассмотрим примеры.

Наверное, один из самых известных методов, который, кстати, также есть и в браузерном глобальном объекте window – это console.log() . Вы можете написать так:

И код выведет вам в консоль написанный в скобках текст.

Другой известный метод, который позволяет выполнять какое-то действие через заданное время:

// Выполнит код через 7 секунд(7000 миллисекунд)
setTimeout(function() {
console.log("Hello, world!");
}, 7000);

Думаю, не трудно догадаться, что если есть setTimeout() , то должен быть и setInterval() .

// Будет выводить надпись "Hello, world" каждую секунду
setInterval(function() {
console.log("Hello, world!");
}, 1000);

NodeJS позволяет получать некоторую полезную информацию от системы. Например, вы можете узнать полный путь до папки, в которой вы сейчас находитесь, используя свойство глобального объекта __dirname .

Console.log(__dirname);

Если вы также хотите получить имя файла, в котором исполняется код, вы можете написать следующее.

NODE.JS – программное средство для выполнения js.

Nodejs = V8 + I/O + библиотеки

V8: быстро, современно, экономно

Преимущества

Javascript
Общий код на клиенте и на сервере
Основные задачи по web
Много соединений и задач одновременно
Легко создать рабочий прототип
Удобный менеджер пакетов npm
Сообщество

Установка

при установке nodejs прописывает себя в переменную PATH (+ npm), [администрирование – переменные среды]; можно проверить в командной строке:
set PATH

Как правило под nodejs запускают файлы: напишем простой скрипт и запустим его посредством командной строки:

Скрипт будет выполнен и результат отобразится в командной строке.

Документация по nodejs

Модули nodejs

Чтобы разобраться как работают встроенные модули nodejs необходимо скачать архив с исходниками с сайта nodejs (source code). И зайти в директорию lib . (команда dir - получаем список файлов через командную строку; Если вам необходимо перечислить файлы во всех вложенных папках, то вместо " dir " используйте " dir /s "). Если вы поставили nodejs из пакета, то в папке lib файлов не обнаружите.

В nodejs есть модули с разной степенью стабильности . (например, 0 – не стоит использовать; 1 , 2 – использовать можно но API модуля может измениться).

Функции растут (проект развивается) и со временем нам потребуется вынести функцию-конструктор USER в отдельный файл. Вот тут-то в дело вступают модули.

Модули этого своего рода способ, который предлагает nodejs для организации проекта.

Проекты как правило разрастаются, что приводит к желанию разбить проект на несколько файлов – вот тут-то в дело вступают модули.

require

Для html-страниц для подключения скриптов используют тег script . В nodejs существует специальная команда require .

Var user = require("./user");

В нашем примере мы обращаемся к файлу (user.js) в той же директории (расширение (.js) писать необязательно).

//require("./user"); // .js указывать необязательно // в этом случае файл будет выполнен, но переменной USER // не будет // в этом главное отличие от тегов script от nodejs // В node.js функции и переменные каждого модуля являются глобальными // для данного файла (самого модуля) и они не становятся автоматически // доступными при подключении (require("./user")) // Но как же получить доступ? // В каждом модуле есть специальная переменная exports - это объект и то // что я туда положу вернется как результат require var user = require("./user.js"); // результат: user = { User: function }

Первое отличие модульной системы nodejs от браузерных скриптов: если в браузере есть два тега script , то функция, которая определена на глобальном уровне одном из них доступна и в другом, а в nodejs нет. В nodejs функции и переменные являются глобальными для данного файла (они не становятся доступными при подключении посредством require). Таким образом nodejs позволяет писать действительно независимые модули. Но чтобы модуль был доступен используется система экспортов . В каждом модуле есть специальная переменная exports .

Модуль-директория DIR/index

Подключаем непосредственно папку var user = require("./user"); , в которой лежит соответствующий index.js .

Например

Function User(name){ this.name = name; } User.prototype.hello = function(who){ console.log(phrases.Hello + ", " + who.name); }; exports.User = User;

Подключаем и используем конструктор User в файле./server.js

//server.js var user = require("./user"); var vasya = new user.User("Вася");

« ./ » - относительно текущей папки

exports – это объект и то, что туда положено, вернется как результат require (exports.jpg). Таким образом модуль может объявить свои приватные переменные/функции и экспортировать лишь то, что необходимо.

Для глобальных переменных и т.д. существует объект global

Global.User = User;

Итог

Подключение require
Переменные: var (приватные у модулей), exports , global (используется редко)
Виды модулей: js , node (с расширением.node), json (с расширением.json) . Модули json используются в том случае, когда требуется хранить какую-либо простую информацию на файле.
Модуль-директория DIR/index

Объект module

Объект module
Модуль-функция module.exports = function
Кеширование модулей (заново модуль никогда не читается)
Расположение модулей: порядок поиска
Передаем параметры: модуль-фабрика

Объект module (основополагающий объект для модулей) является переменной, которая существует в каждом модуле (файле, можно вывести console.log(module);). . Содержимое: свойство id – как правило путь к файлу,
parent – ссылка на родительский модуль (module.parent - ссылка на родительский модуль, который require данный),
children (module.children - те модули, которые подключены посредством require),
свойство exports и другие.

Модуль или приложение? module.parent

Модуль может быть запущен напрямую, а если нет, если функционал подключен к другому модулю, то пусть он этот функционал экспортирует. Разделить эти два случая можно при помощи проверки:

If(module.parent) { exports.run = run; } else { run(); }

пс: как говорится на stackoverflow.com Родетелем является модуль, который вызвал скрипт для интерпретации

// $ node foo.js console.log(module.parent); // null // require("./foo") console.log(module.parent); // { ... }

Правильное использование module.exports

В контексте модуля:

module.exports = exports = this (данные конструкции равнозначны)

Если вы хотите передать функцию не в объекте, а напрямую, то используйте следующий синтаксис:

Module.exports = User;

Кеширование модулей

Когда Nodejs загружает модуль он полностью создает соответствующий объект module (с учетом parent , exports и других аналогичных свойств) и запоминает его у себя (module.id (полный путь к файлу) служит идентификатором для внутреннего кэша) и в следующий раз, когда мы повторно обращаемся (подключаем) к какому-либо модулю (файлу), nodejs берет все тот же объект из кэша. То есть, например, инициализировать модуль достаточно 1 раз в каком-либо файле, в дальнейшем его можно просто использовать.

В нашем случае для var db = require("../db");
и для var db = require("./db"); берется один и тот же объект. Поэтому принцип следующий: в первый раз, когда используется модуль, он инициализируется и в дальнейшем мы его только подключаем и пользуемся им (то есть в нашем случае нам не нужно использовать db.connect() дважды, то есть в разных файлах).

Расположение модулей: порядок поиска модулей в nodejs

Как сделать так, чтобы db подключалась всегда без указания специфичного пути:

Var db = require("../db"); //или var db = require("./db");

а вот так:

Var db = require("db");

в независимости от того в каком файле подключается db .

Для этого нужно понимать порядок поиска модулей в nodejs (то что происходит, когда вызывается require). В nodejs существует множество встроенных модулей, например, require("fs"); , который будет подключен без проблем. Если же в require указать конкретный путь, например, require("../db"); , то поиск будет вестись исходя из заданного пути и файл будет найден, либо nodejs попытается получить этот файл как директорию (и будет искать index.js внутри категории).

Если же указать require("db"); и при этом модуль не является встроенным, то будет произведен поиск директории node_modules относительно текущего положения (если найдет, то попытается взять модуль из нее). Если директория node_modules отсутствует, то директория node_modules будет искаться выше и т.д.

Помимо указания конкретного пути для модуля, nodejs может искать модули следующим образом:

Введение в npm – менеджер пакетов для Node.JS

создать файл с описанием пакета (package.json), который содержит информацию о модуле (имя, версия и т.д.). Либо вручную, либо через команду
npm init
(запросит нужную информацию)
Чтобы опубликовать модуль необходимо:
1. Добавить юзера посредством команды npm adduser (необходимо ввесть Username и Password). Теперь вся работа с npm будет от имени этого пользователя. Юзер может залогинится на https://www.npmjs.com/~name_user и наблюдать за своими модулями.
2. Публикация: npm publish
Далее кто-либо может использовать Ваш, добавленный в базу, модуль, а сам пользователь вносить изменения.
Получаем все команды npm при помощи команды npm help
Поиск нужно модуля в базе данных: npm s ключевые_слова или npm search ключевые_слова (например, npm s super module)
Устанавливаем модуль: npm install name_module или npm i name_module
При установке модулей nodejs сначала ищет папку node_modules в текущей директории (потом выше и выше и т.д), либо (если node_modules отсутствует) ищет package.json (также поднимаясь вверх; package.json , как правило, обозначает корень проекта) и, соответственно, если находит package.json, то делает в соответствующей директории папку node_modules ; если же оба варианта не проходят, то nodejs делает папку node_modules в текущей директории. Если вы хотите поставить модуль в определенную директорию, то в этой директории необходимо создать папку node_modules .
npm up обновить модуль (проверит модули на обновление, которые есть в папке node_modules)
npm remove имя_модуля (удалить модуль)

Вывод по npm:

npm init
nmp adduser
npm publish
npm search ключевые слова
npm install модуль
npm update модуль
npm remove модуль
npm help команда

Структура пакета NPM

Установка нужной версии, например: npm i [email protected]

Последнюю версию модуля можно получить в том случае, если модуль разрабатывается, используя систему версинирования git, например, на github. Достаточно получить Git Read-Only (url): https://github.com/strongloop/express.git и в консоли:

npm i https://github.com/strongloop/express.git

dependencies в package.json

dependencies указывает на те модули, от которых зависит данный.

devDependencies

Модули прописанные в devDependencies не ставятся, если модуль подтягивается как зависимость. Они ставятся лишь для разработки и их можно установить, если, например, зайти в модуль в папке node_modules и прописать npm i (или при установке флага npm config).

поле main задает точку входа в пакет

Глобальные модули

Любой модуль можно поставить глобально, если поставить флаг -g: npm -g модуль

Глобально означает в системную директорию.

Директория глобальных модулей под windows:

C:\users\User_Name\AppData\Roaming\npm

Глобальные модули ставятся в стандартную системную директорию. Те бинарники, которые есть в package.json будут поставлены по системному пути (это и есть основное применение глобальных модулей), то есть в дальнейшем их можно будет вызвать через консоль.

По материалам курсов И. Кантора

4 из 5

В этой статье я расскажу об основных принципах Node.js, его плюсах и минусах и покажу как начать разработку. Но перед тем как начать работать с Node.js, желательно понять разницу между Node.js и традиционными серверными языками (PHP, Python, Ruby).

Асинхронное программирование

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

Ты сделаешь все!

Node.js — всего лишь среда, поэтому всю работу придется делать вручную. В Node.js по умолчанию нет даже HTTP сервера! И это печалит, однако Node.js подкупает высокой производительностью веб-приложений. Всего лишь один скрипт обрабатывает все соединения с клиентом. Такое решение значительно снижает количество используемых ресурсов в приложении. Для примера, вот код простого Node.js приложения.

Var i, a, b, c, max;

max = 1000000000;

var d = Date.now();

for (i = 0; i < max; i++) {
a = 1234 + 5678 + i;
b = 1234 * 5678 + i;
c = 1234 / 2 + i;
}

console.log(Date.now() - d);

А вот его эквивалент на PHP:

$a = null;
$b = null;
$c = null;
$i = null;
$max = 1000000000;
$start = microtime(true);
for ($i = 0; $i < $max; $i++) {
$a = 1234 + 5678 + $i;
$b = 1234 * 5678 + $i;
$c = 1234 / 2 + $i;
}
var_dump(microtime(true) - $start);

В следующей таблице сравнивается время выполнения обоих примеров.

Оба примера выполнялись в командной строке, поэтому задержки на запуск веб-сервера здесь нет. Я запускал каждый тест по 10 раз и взял средний результат. PHP оказался быстрее на малом количестве итераций, но это преимущество быстро исчезает, когда количество итераций увеличивается. Когда я завершил все тесты, то PHP оказался на 93% медленнее Node.js.

Node.js быстр, но существует несколько вещей, которые необходимо знать, чтобы использовать его правильно.

Модули

Node.js построен на модульной архитектуре: это сделано для упрощения создания сложных приложений. Модули похожи на библиотеки в C или units в Pascal. Каждый модуль содержит набор функций, которые относятся к «теме» этого модуля. Например, модуль http содержит функции специфичные для HTTP. Node.js также содержит несколько модулей из коробки: для работы с файловой системой, создания HTTP и TCP/UPD серверов и др.

Модуль подключается с помощью функции require() :

Var http = require("http");

Эта функция возвращает указанный модуль. В примере выше ссылка на модуль http хранится в переменной http.

Функция принимает на вход имя модуля. После этого Node.js проверяет папку node_modules в каталоге приложения и ищет в ней папку с названием http. Если Node.js не нашел каталог node_modules или модуль http внутри этого каталога, тогда он обратиться к глобальному кэшированному модулю. Вместо имени в функцию require() можно передавать относительный или абсолютный путь к модулю:

Var myModule = require("./myModule.js");

Модули инкапсулируют части кода. Код внутри модуля в основном приватный. Это означает, что функции и переменные объявленные в модуле, доступны только внутри модуля. Но Node.js позволяет создавать общедоступные функции или/и переменные. За это отвечает объект exports . Пример:

Var PI = Math.PI;
exports.area = function (r) {
return PI * r * r;
};
exports.circumference = function (r) {
return 2 * PI * r;
};

В этом примере создается переменная PI, которую можно использовать только внутри модуля. Следующие 2 функции создают объект exports . Эти функции доступны вне модуля, потому что определены через объект exports . В результате переменная PI полностью защищена от внешнего вмешательства. Таким образом функции area и cercumference будут вести себя так как и должны(в зависимости от значения параметра r).

Глобальная область видимости

Node.js — JavaScript среда, разработанная на движке JavaScript V8 от Google. Поэтому необходимо использовать лучшие практики программирования на клиентской стороне. Например, нужно избегать объявлений в глобальной области видимости. Однако это не всегда возможно. В Node.js легко создать глобальную переменную или функцию, опуская ключевое слово var , например:

GlobalVariable = 1;
globalFunction = function () { ... };

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

Установка

Конечно, прежде чем писать и запускать приложения на Node.js, необходимо его установить. На сайте nodejs.org можно скачать инсталлятор для Windows или OS X. Для Linux можно использовать любой пакетный менеджер. Для установки Node.js нужно открыть командную строку и ввести:

Sudo apt-get update
sudo apt-get install node

Sudo aptitude update
sudo aptitude install node

Node.js есть в sid репозиториях; можете добавить их в список исходных кодов:

Sudo echo deb http://ftp.us.debian.org/debian/ sid main > /etc/apt/sources.list.d/sid.list

Установка sid пакетов на старые системы может повредить вашу систему. Поэтому после установки желательно удалить /etc/apt/sources.list.d/sid.list

Установка новых модулей

В Node.js есть менеджер пакетов, который называется Node Package Manager (NPM). NPM устанавливается автоматически с Node.js, и его можно использовать для установки новых модулей. Чтобы установить новый модуль, нужно открыть командную строку, перейти в нужную папку и выполнить следующую команду:

Npm install module_name

Синтаксис этой команды не зависит от операционной системы. Команда установит модуль, который указан вместо module_name.

Hello World

Первое приложение, которое я напишу на Node.js будет «Hello World!». Для этого, я создам файл, который назову hello.js и добавлю следующий код:

Console.log("Hello World!");

Чтобы выполнить скрипт нужно открыть командную строку и перейти в папку с файлом hello.js и выполнить следующую команду:

Node hello.js

В консоль выведется надпись «Hello World!».

HTTP сервер

Теперь я сделаю приложение посложнее, но не такое сложное как вы могли бы подумать). В коде приведены комментарии.

// подключаем http модуль.
var http = require("http");

// Создаем сервер. Функция передается как параметр при каждом запросе.
// переменная request содержит все параметры запроса.
// переменная response позволяет указать, что нужно делать при отправке ответа клиенту

// Это событие происходит, когда клиент отправил данные и ждет ответ
// Пишем заголовки в ответ.
// 200 это код состояния HTTP (200 означает "хорошо")
// Второй параметр - это объект, который содержит поля заголовка
// Я посылаю обычный текст, с помощью Content-Type со значением text/plain
response.writeHead(200, {
"Content-Type": "text/plain"
});
// Отправляем данные
response.end("Hello HTTP!");
});
// Слушаем 8080 порт.
}).listen(8080);

Это очень простой пример. На самом деле, клиенту можно отправить гораздо большее количество данных с помощью метода response.write(), но вызывать его нужно перед методом response.end(). Я сохранил этот код в файл http.js и ввел в консоль:

Node http.js

Затем открыл браузер и перешел на http://localhost:8080. На странице отобразилось «Hello HTTP!».

Обработка url параметров

Как я уже упоминал ранее, мы все должны делать сами в Node.js, в том числе разбор аргументов запроса. Однако это не так уж и сложно. И в следующем примере я это продемонстрирую:

// Подключаем http модуль,
var http = require("http"),
// и url модуль, который поможет при разборе параметров запроса
url = require("url");

// Создаем сервер.
http.createServer(function (request, response) {
// Добавляем обработчик события.
request.on("end", function () {
// Разбираем запрос на аргументы и сохраняем их в переменную _get.
// Эта функция анализирует url и возвращает объект.
var _get = url.parse(request.url, true).query;
// Пишем заголовки в ответ.
response.writeHead(200, {
"Content-Type": "text/plain"
});
// Отправляем данные и завершаем ответ.
response.end("Here is your data: " + _get["data"]);
});
// Listen on the 8080 port.
}).listen(8080);

Этот код использует метод parse() модуля url, который является основным модулем в Node.js для преобразования url в объект. У возвращаемого объекта есть свойство query , которое извлекает url параметры. Я сохранил этот код в файл get.js и выполнил следующую команду:

Node get.js

Затем в браузере открыл страницу http://localhost:8080/?data=put_some_text_here.

Чтение и запись файлов

Для работы с файлами в Node.js существует модуль fs. У этого модуля есть методы fs.readFile() и fs.writeFile() для чтения и записи файлов. Я расскажу о них подробнее после знакомства с примером:

// Подключаем http модуль,
var http = require("http"),
// и модуль fs
fs = require("fs");

// Создаем http сервер.
http.createServer(function (request, response) {
// Добавляем обработчик события.
request.on("end", function () {
// Читаем файл
// Пишем заголовки.
response.writeHead(200, {
"Content-Type": "text/plain"
});
// Увеличиваем число полученное из файла.
data = parseInt(data) + 1;
// Пишем новое число в файл.

);
});
// Слушаем 8080 порт
}).listen(8080);

Я сохранил этот код в файл files.js. Перез запуском этого скрипта, нужно создать файл с именем test.txt в директории с files.js.

Этот код демонстирует работу методов fs.readFile() и fs.writeFile(). Каждый раз, когда сервер получает запрос, скрипт считывает число из файла, увеличивает его и записывает новое число в этот же файл.Метод fs.readFile() принимает 3 аргумента: имя файла для чтения, ожидаемую кодировку и вызываемую функцию.

Запись в файл гораздо проще. Не нужно ожидать каких-то результатов, хотя в реальном приложении нужно проверять на наличие ошибок. Метод fs.writeFile() принимает в качестве аргументов имя файла и данные для записи. Этот метод также может принимать 3-й и 4-й необязательные аргументы, для указания кодировки и функции обратного вызова.

Я запустил скрипт командой:

Node files.js

Затем открыл в браузере http://localhost:8080 и перезапустил несколько раз. Может показаться, что в коде была ошибка, т.к. число увеличилось на 2. Это не ошибка, потому что в действительности было послано 2 запроса. Первый запрос автоматически сделал браузер, когда запросил favicon.ico и вторым запросом был http://localhost:8080.

Хотя технически это не ошибка, такое поведение скрипта не очевидно. Поэтому я добавил исправление, которое проверяет url. Вот исправленный код:

// Подключаем http модуль,
var http = require("http"),
// и модуль fs
fs = require("fs");

// Создаем http сервер.
http.createServer(function (request, response) {
// Добавляем обработчик события.
request.on("end", function () {
// Проверяем запрос /
if (request.url == "/") {
// Читаем файл.
fs.readFile("test.txt", "utf-8", function (error, data) {
// Пишем заголовки.
response.writeHead(200, {
"Content-Type": "text/plain"
});
// Увеличивем число полученное из файла.
data = parseInt(data) + 1;
// Пишем увеличенное число в файл.
fs.writeFile("test.txt", data);
// Пишем симпатичное сообщение в ответ.
response.end("This page was refreshed " + data + " times!");
});
} else {
// Файл не найден
response.writeHead(404);
// и завершаем запрос без отправки каких-либо данных.
response.end();
}
});
// Слушаем 8080 порт.
}).listen(8080);

Теперь скрипт работает так, как ожидается.

Доступ к Mysql

Традиционные серверные технологии имеют встроенные средства подключения и отправки запросов к базе данных. Для Node.js нужно установить специальную библиотеку. Я выбрал наиболее стабильную и простую в использовании node-mysql. Полностью модуль назыается [email protected](после @ идет версия). Чтобы установить данный модуль, я открыл консоль, перешел в директорию, где хранятся скрипты и выполнил следующую команду:

Npm install [email protected]

Эта команда скачает и установит модуль, а также создаст папку node_modules в текущей директории. Далее я написал пример использования этого модуля:

// Подключаем http модуль,
var http = require("http"),
// и mysql модуль.
mysql = require("mysql");

// Создаем соединение.
// Настройки по умолчанию должны быть изменены в соответсвии с настройками mysql.
var connection = mysql.createConnection({
user: "root",
password: "",
database: "db_name"
});

// Создаем http сервер.
http.createServer(function (request, response) {
// Добавляем обработчик события.
request.on("end", function () {
// Запрос к базе данных.
connection.query("SELECT * FROM your_table;", function (error, rows, fields) {
response.writeHead(200, {
"Content-Type": "x-application/json"
});
// Отправляем данные в json формате.
// Строки переменной содержат результат запроса.
response.end(JSON.stringify(rows));
});
});
// Слушаем 8080 порт.
}).listen(8080);

Запрос к базе данных делается просто, нужно в методе query написать сам запрос и функцию обратного вызова. В реальном приложении, сначала нужно проверить были ли ошибки (параметр error будет undefined если были ошибки) и ответ зависит от того, выполнился ли запрос или нет. Также обратите внимание, что я установил Content-Type в x-application/json, оно указывает что MIME тип действительно является json. Параметр rows содержит результат запроса, который я легко конвертировал в JSON структуру ипользуя метод JSON.stringify().

Я сохранил этот код в файл mysql.js и выполнил команду:

Node mysql.js

Затем перешел в браузере на http://localhost:8080 и браузер предложил загрузить файл в JSON формате.

Заключение

Хоть в Node.js многое приходится делать вручную, все это окупается скоростью и надежностью приложений. Если вы не хотите разрабатывать приложения на низком уровне, то вы всегда можете использовать какой-нибудь фрэймворк для облегчения задачи. Например Express .

Node.js — это перспективная технология и отличный выбор для высоконагруженных приложений. Это было доказано такими корпорациями, как Microsoft, eBay и Yahoo. Если вы не уверены в выборе хостинга для вашего вебсайта или приложения, вы всегда можете использовать дешевое VPS решение или различные облачные сервисы, например Microsoft, Azure и Amazon EC2.