// Общедоступным API этого модуля является функция-конструктор Set.
// Нам необходимо экспортировать эту функцию за пределы частного
// пространства имен, чтобы ее можно было использовать за ее пределами.
// В данном случае конструктор экспортируется за счет передачи его
// в виде возвращаемого значения. Он становится присваиваемым значением
// в выражении в первой строке выше, return Set;
}); // Вызвать функцию сразу после ее объявления.
Обратите внимание, что такой прием вызова функции сразу после ее определения является характерным для языка JavaScript. Программный код, выполняемый в частном пространстве имен, предваряется текстом
«(function {
» и завершается «
});
». Открывающая круглая скобка в начале сообщает интерпретатору, что это выражение определения функции, а не инструкция, поэтому в префикс можно добавить любое имя функции, поясняющее ее назначение. В примере 9.24 было использовано имя «
invocation
», чтобы подчеркнуть, что функция вызывается сразу же после ее объявления. Точно так же можно было бы использовать имя «
namespace
», чтобы подчеркнуть, что функция играет роль пространства имен.
После того как модуль окажется заперт внутри функции, ему необходим некоторый способ экспортировать общедоступный API для использования за пределами функции модуля. В примере 9.24 функция модуля возвращает конструктор, который тут же присваивается глобальной переменной. Сам факт возврата значения из функции ясно говорит о том, что оно экспортируется за пределы области видимости функции. Модули, определяющие более одного элемента API, могут возвращать объект пространства имен. Для нашего модуля с классами множеств можно было бы написать такой программный код:
// Создает единственную глобальную переменную, хранящую все модули,
// имеющие отношение к коллекциям
var collections;
if (!collections) collections = {};
// Теперь определить модуль sets
collections.sets = (function namespace {
// Здесь находятся определения различных классов множеств,
// использующих локальные переменные и функции
// ... Большая часть программного кода опущена...
// Экспортировать API в виде возвращаемого объекта пространства имен
return {
// Экспортируемое имя свойства : имя локальной переменной
AbstractSet: AbstractSet,
NotSet: NotSet,
AbstractEnumerableSet: AbstractEnumerableSet,
SingletonSet: SingletonSet,
AbstractWritableSet: AbstractWritableSet,
ArraySet: ArraySet
};
});
Можно предложить похожий прием, определив функцию модуля как конструктор, который будет вызываться с ключевым словом
new
и экспортировать значения за счет их присваивания:
var collections;
if (!collections) collections = {};
collections.sets = (new function namespace {
// ... Большая часть программного кода опущена ...
// Экспортировать API в объекте this
this.AbstractSet = AbstractSet;
this.NotSet = NotSet; // И так далее...
// Обратите внимание на отсутствие возвращаемого значения.
});
Если объект глобального пространства имен уже определен, функция модуля может просто присваивать значения свойствам этого объекта и вообще ничего не возвращать:
var collections;
if (!collections) collections = {};
collections.sets = {};
(function namespace {
// ... Большая часть программного кода опущена ...
// Экспортировать общедоступный API в объект пространства имен, созданный выше
collections.sets.AbstractSet = AbstractSet;
collections.sets.NotSet = NotSet; // И так далее...
// Инструкция return не требуется, потому что экспортирование выполняется выше.
});
Фреймворки, реализующие инструменты загрузки модулей, могут предусматривать собственные методы экспортирования API модулей. Внутри модуля может определяться функция
provides,
которая выполняет регистрацию его API, или объект
exports
, в котором модуль должен сохранять свой API. Пока в языке JavaScript отсутствуют инструменты управления модулями, вам придется использовать средства создания и экспортирования модулей, которые лучше подходят для используемой вами библиотеки инструментов.