Создавайте повторно используемую бизнес-логику JavaScript с помощью peasy-js

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

С точки зрения потребления, это действительно все, что нужно сделать. Использование нашей бизнес-логики, разработанной с помощью peasy-js, представит узнаваемую тему, независимо от нашей архитектуры и технологий, которые ее потребляют.

Говоря об архитектуре, давайте обратим наше внимание на потенциальную архитектуру, которая становится легко достижимой при разработке нашей бизнес-логики таким образом, в то же время исследуя участников peasy-js немного глубже:

Слева направо мы видим, что клиентское приложение использует такую ​​среду, как Angular, React, Backbone и т. Д. Чтобы достичь максимальной масштабируемости, обратите внимание, что мы можем переместить реализацию бизнес-логики из реализаций участников инфраструктуры пользовательского интерфейса (служб, контроллеров и т. Д.). .) в свою собственную компонентную кодовую базу или промежуточный уровень.

Далее обратите внимание, что промежуточный уровень связывается с веб-сервером. Это стало возможным благодаря наличию прокси данных. Как показано на рисунке A, служба Angular, потребляющая нашу бизнес-логику, создает экземпляр CustomerHttpDataProxy . В результате, когда команда вставки выполняется, она подвергает предоставленную полезную нагрузку любым настроенным бизнес-правилам. В случае успешной проверки будет вызвана соответствующая функция insert нашего прокси-сервера данных, и, соответственно, будет выдан POST-запрос к настроенной конечной точке клиента.

И наоборот, обратите внимание, что та же бизнес-логика, которая используется в нашем интерфейсе, также используется нашим приложением node.js. Как показано на рисунке B, экспресс-контроллер, использующий нашу бизнес-логику, создает экземпляр CustomerMongoDataProxy . Однако на этот раз при выполнении команды insert соответствующая функция insert нашего прокси-сервера данных выполнит INSERT для нашей базы данных, используя API MongoDB или ORD, например Mongoose.

Наконец, поскольку наши реализации прокси-серверов данных придерживаются одного и того же интерфейса, мы можем внедрить их в наши бизнес-сервисы в зависимости от того, как мы хотим развернуть наше приложение. На схеме бизнес-сервисы используют прокси-серверы данных, которые взаимодействуют с HTTP-сервисами на клиенте. Однако, как только запрос обрабатывается веб-API, те же бизнес-сервисы, размещенные в Node.js, внедряются с прокси данных, которые взаимодействуют с базой данных, очередью, кешем, файловой системой и т. Д.

Теперь, когда мы понимаем участников peasy-js с высокого уровня и некоторых преимуществ, которые они предоставляют, давайте рассмотрим примеры их реализации.

CustomerHttpDataProxy

 var CustomerHttpDataProxy = function() { var request = require('request'); return { insert: insert }; function insert(data, done) { request({ method: 'POST', url: 'http://localhost:3000/customers', body: data, json = true }, function (error, response, body) { done(error, body); } ); }; }; 

CustomerMongoDataProxy

 var CustomerMongoDataProxy = function() { var connectionString = 'mongodb://localhost:12345/orderEntry'; var mongodb = require('mongodb').MongoClient; return { insert: insert }; function insert(data, done) { mongodb.connect(connectionString, function(err, db) { if (err) { return done(err); } var collection = db.collection('customers'); collection.insert(data, function(err, data) { db.close(); done(err, data); }); }); }; }; 

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

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

Обслуживание клиентов

 var CustomerService = BusinessService.extend({ functions: { _onInsertCommandInitialization: function(context, done) { var customer = this.data; utils.stripAllFieldsFrom(customer).except(['name', 'address']); utils.stripAllFieldsFrom(customer.address).except(['street', 'zip']); done(); } } }).service; 

В этом примере мы предоставили логику инициализации для открытой вставки CustomerService insertCommand, которая вносит белые списки в поля перед вызовом функции insert нашего прокси-сервера данных. Каждая операция CRUD по умолчанию, предоставляемая через наши реализации бизнес-сервисов, предоставляет обработчики событий, связанные с каждой командой. Эти методы можно посмотреть здесь .

Обратите внимание, что мы используем статическую функцию BusinessService.extend , которая создает функцию конструктора, предоставляемую через член службы возвращаемого объекта. Вы также можете свободно использовать наследование ES6 или прототипирование, если вам удобнее использовать эти подходы. Образцы обоих можно найти здесь .

 var NameRule = Rule.extend({ association: "name", params: ['name'], functions: { _onValidate: function(done) { if (this.name === "Jimi") { this._invalidate("Name cannot be Jimi"); } done(); } } }); 

 var AgeRule = Rule.extend({ association: "age", params: ['birthdate'], functions: { _onValidate: function(done) { if (new Date().getFullYear() - this.birthdate.getFullYear() < 50) { this._invalidate("You are too young"); } done(); } } }); 

 var CustomerService = BusinessService.extend({ functions: { _onInsertCommandInitialization: function(context, done) { var customer = this.data; utils.stripAllFieldsFrom(customer).except(['name', 'address']); utils.stripAllFieldsFrom(customer.address).except(['street', 'zip']); done(); }, _getRulesForInsertCommand: function(context, done) { var customer = this.data; done(null, [ new NameRule("name", customer.name), new AgeRule("age", customer.birthDate) ]); } } }).service; 

 it("fails when the supplied name is Jimi", () => { var rule = new NameRule("Jimi"); rule.validate(() => { expect(rule.valid).toBe(false); expect(rule.association).toEqual("name"); }); }); it("succeeds when the supplied name is not Jimi", () => { var rule = new NameRule("James"); rule.validate(() => { expect(rule.valid).toBe(true); }); });