JavaScript. Подробное руководство, 6-е издание, стр. 137

Иногда авторы модулей используют глубоко вложенные пространства имен. Если модуль с определениями классов множеств является частью обширной коллекции модулей, для него может использоваться пространство имен

collections

sets

, а сам модуль может начинаться со следующих определений:

<b>var collections; // Объявить (или повторно объявить) глобальную переменную</b>

if (!collections) // Если объект еще не существует

<b>  collections = {}; // Создать объект пространства имен верхнего уровня</b>

collections.sets = {} //И внутри него создать пространство имен sets.

// Теперь определить классы множеств внутри 

collections.sets

collections.sets.AbstractSet = function() { ... }

Иногда пространство имен верхнего уровня используется для идентификации разработчика или организации - автора модуля и для предотвращения конфликтов между пространствами имен. Например, библиотека Google Closure определяет свой класс

Set

в пространстве имен

goog.structs

. Для определения глобально уникальных префиксов, которые едва ли будут использоваться другими авторами модулей, индивидуальные разработчики могут использовать компоненты доменного имени. Поскольку мой вебсайт имеет имя

davidflanagan.com

, я мог бы поместить свой модуль с классами множеств в пространство имен

com.davidflanagan.collections.sets

При таких длинных именах для любого пользователя вашего модуля операция импортирования становится особенно важной. Однако, вместо того чтобы импортировать имена отдельных классов, программист мог бы импортировать в глобальное пространство имен весь модуль целиком:

var sets = com.davidflanagan.collections.sets;

В соответствии с соглашениями имя файла модуля должно совпадать с его пространством имен. Модуль

sets

должен храниться в файле с именем

sets.js

. Если модуль использует пространство имен

collections.sets

, то этот файл должен храниться в каталоге collections/ (этот каталог мог бы также включать файл maps.js). А модуль, использующий пространство имен

com.davidflanagan.collections.sets

, должен храниться в файле com/davidflanagan/collections/sets.js.

9.9.2. Область видимости функции как частное пространство имен

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

Set._v2s()

из примера 9.6 - для нас было бы нежелательно, чтобы пользователи класса

Set

вызывали эту функцию, поэтому было бы неплохо сделать ее недоступной извне.

Этого можно добиться, определив модуль (в данном случае класс

Set

) внутри функции. Как описывалось в разделе 8.5, переменные и функции, объявленные внутри другой функции, являются локальными по отношению к этой функции и недоступны извне. Таким образом, область видимости функции (называемой иногда «функцией модуля») можно использовать как частное пространство имен модуля. Пример 9.24 демонстрирует, как это может выглядеть применительно к нашему классу

Set

Пример 9.24. Класс Set внутри функции модуля

<b>// Объявляет глобальную переменную Set и присваивает ей значение, возвращаемое</b>

<b>// функцией. Круглые скобки, окружающие объявление функции, свидетельствуют о том,</b>

<b>// что функция будет вызвана сразу после ее объявления и что присваивается значение,</b>

<b>// возвращаемое функцией, а не сама функция. Обратите внимание, что это выражение</b>

<b>// определения функции, а не инструкция, поэтому наличие имени &quot;invocation&quot;</b>

// не вызывает создание глобальной переменной,

var Set = (function invocation() {

 function Set() { // Эта функция-конструктор - локальная переменная,

 this.values = {}; // Свойство для хранения множества

 this.n = 0; // Количество значений в множестве

 this.add.apply(this, arguments); // Все аргументы являются значениями,

 } // добавляемыми в множество

 // Далее следуют определения методов в Set.prototype.

 // Для экономии места программный код опущен

 Set.prototype.contains = function(value) {

 // Обратите внимание, что v2s() вызывается без префикса Set._v2s()

 return this.values.hasOwnProperty(v2s(value));

 };

 Set.prototype.size = function() { return this.n; };

 Set.prototype.add = function() { /* ... */ };

 Set.prototype.remove = function() { /* ... */ };

 Set.prototype.foreach = function(f, context) {/*...*/>;

<b>  // Далее следуют вспомогательные функции и переменные, используемые</b>

<b>  // методами выше. Они не являются частью общедоступного API модуля и скрыты</b>

<b>  // в области видимости функции, благодаря чему не требуется объявлять их как</b>