Паттерны JavaScript модулей в Impress для node.js и браузеров

У меня сложилось впечатление, что в обществе все же есть предубеждение против использования глобальных переменных в служебных целях. В связи с этим, хочу дать некоторые разъяснения с примерами, которые снимут всякие сомнения и будут полезны всем, кто жаждет модульности и гибкости в JavaScript разработке. Я не могу проследить источники всех идей, приведенных ниже, но я не претендую на их авторство, а лишь на творческое обобщение. Так же я отказываюсь от претензий на один универсальных паттерн определения модйлей для всех случаев жизни, надеюсь, всем ясно, что такого не может быть никогда. Все это существенно отличается от подходов RequireJS, CommonJS и того, как модули оформляются в node.js через module.exports, однако, каждый из этих паттернов имеет свое место, если подходить к задаче без фанатизма и предубеждений.

Особенности

• Поддержка приватных и публичных методов и свойств.
• Парретрн применим как для серверного JavaScript, так и для клиентского. Как для клиентского, так и для серверного JS модули могут подгружаться динамически, как в Require.js (AMD).
• Поддерживается склеивание нескольких файлов содержащих код разных модулей в один файл, это позволяет оптимизировать загрузку js для браузеров, минифицировать и склеивать в один файл. Замечу, что Asynchronous module definition (AMD) и CommonJS не поддерживают склеивание файлов.
• Есть возможность разделить код одного модуля на несколько файлов, которые загружаются последовательно и дополняют друг друга. Это полезно, например, для вынесения констант, конфигурации в отдельные файлы.
• Благодаря разделению на несколько файлов, можно делать модули с расширяемой функциональностью, т.е. делать подподули, вынося в них функциональность, нужную только в некоторых случаях и загружать ее по условию.
• Есть возможность сделать интерфейс и реализации, определяя одинаковые методы в нескольких разных подмодулях. Это нужно пояснить подробнее, на примере: нужно хранить структуру деревовидных данных в браузерных хранилищах (localstorage, WebSQL, IndexedDB), а интерфейс у них должен быть одинаковый и часть логики одинаковая. Создаем treeStorage.js, treeStorage.localstorage.js, treeStorage.websql.js, treeStorage.indexeddb.js
• Есть возможность скрывать часть загружаемых методов и свойств в метод-обертку (wrapper) и вызывать его опционально или подгружать сразу несколько реализаций с обернутыми методами и переключать между ними, вызывая враперы с разнуми именами по условию.
• Для Impress важно, чтобы модули попадали в глобальное пространство имен и были доступны из всех обработчиков, без необходимости подключать их в каждом обработчике отдельно.

Код

// File: global.js // Должен быть загружен первым  if (typeof(window) != 'undefined') window.global = window;  Function.prototype.override = function(fn) { 	var superFunction = this; 	return function() { 		this.inherited = superFunction; 		return fn.apply(this, arguments); 	} } 

// File: moduleName.js // первое определение модуля moduleName (например, для реализации абстрактного интерфейса)  (function(moduleName) {  	// Помещайте инициализационный код тут 	console.log('Инициализация moduleName');  	moduleName.publicProperty = 'Значение публичного свойства';  	var privateProperty = 'Значение приватного свойства';  	moduleName.publicMethod = function() { 		console.log('Исходный publicMethod для moduleName'); 	};  	moduleName.toBeOverridden = function() { 		console.log('Исходный публичный метод toBeOverriden для модуля moduleName (будет переопределен)'); 	};  	privateMethod = function() { 		console.log('Приватный метод privateMethod для moduleName'); 	};  } (global.moduleName = global.moduleName || {})); 

// File: moduleName.implementationName.js // повторное определение модуля moduleName может расширять, переопределять и вызывать унаследованную функциональность  (function(moduleName) {  	// Помещайте инициализационный код для повторного оперделения тут 	console.log('Инициализация implementationName');  	// Публичное свойство в повторном определении 	// будет перекрывать публичное свойство первого определения 	// 	moduleName.publicProperty = 'Публичное свойство перекрыто';  	// Приватное свойство в повторном определении 	// не будет перекрывать приватное свойство первого определения 	// 	var privateProperty = 'Приватное свойство не перекрыто';  	moduleName.publicMethod = function() { 		// Публичное свойство в повторном определении 		// будет перекрывать публичное свойство первого определения 		console.log('Публичный метод перекрыт'); 	};  	  	privateMethod = function() { 		console.log('Приватный метод не перекрыт'); 	};  	// Переопределение метода через "Function.override" 	// 	moduleName.toBeOverridden = moduleName.toBeOverridden.override(function() { 		console.log('Переопределенный метод: moduleName.toBeOverridden'); 		this.inherited(); // вызов предыдущей реализации метода 	});  	// Обертка части переопределения, которая будет инициализироваться опционально 	// по какому-либо условию из внешнего кода или из блока инициализации 	//  	moduleName.wrapperName = function() {  		// Помещайте инициализационный код обертки тут 		console.log('Обертка инициализирует скрутый функционал');  		moduleName.publicMethod = moduleName.publicMethod.override(function() { 			console.log('Метод переопределен: moduleName.publicMethod'); 		});  	};  } (global.moduleName = global.moduleName || {})); 

// File: test.js  require('./global.js'); require('./moduleName.js'); require('./moduleName.implementationName.js');  moduleName.wrapperName(); moduleName.publicMethod(); 

Как этот шаблон применяется в Impress

1. Вынесение конфигурации: impress.constants.js вынесена из impress.js
2. Подмодули: db.mongodb.js расширяет db.js
3. Так как все обработчики а Impress в отдельных файлах, то в обработчиках не нужно писать require. А вот сами обработчики определяются при помощи обычного для node.js способа, т.е. через module.exports.
Пример:

module.exports = function(req, res, callback) { 	res.context.data = []; 	db.impress.sessions.find({}).toArray(function(err, nodes) { 		res.context.data = nodes; 		callback(); 	}); } 

Ссылки

Global.js с комменариями на русском и английском на Github: github.com/tshemsedinov/global.js
Impress на Github: https://github.com/tshemsedinov/impress
Impress в npm: https://npmjs.org/package/impress