缩写
Capi 的服务层
主维护者 - 变形常春藤
安装
npm install @hapipal/schmervice
使用量
另见 API 参考
Schmervice是打算与 hopi v20+ 和 nodejs v16+ 一起使用的(下级支持请参见 v2) (中文(简体) ).
服务是将相关业务逻辑或交易组织成类的好方法. Schmervice是一个服务层,旨在与hopi很好地融合. 它由两个部分组成,可以一起使用或单独使用:
-
基础
Service通过下列方式将您的服务整合到 hopi 的类:- 允许其接触相关的
server和插件options。 。 。 . - 允许您执行
async initialize()财务报告和审定财务报表async teardown()当服务器初始化和停止时应当运行的方法. - 允许您将某些方法配置为可缓存, 并带有您习惯的所有服务器方法配置 .
- 允许其接触相关的
-
a hopi 插件,允许您注册服务并在最方便的地方访问服务,例如在路由处理器中。 这个注册尊重插件边界,并且是分级的,因此无关的插件可以安全地注册自己的服务而不会互相影响.
const Schmervice = require('@hapipal/schmervice');
const Hapi = require('@hapi/hapi');
(async () => {
const server = Hapi.server();
await server.register(Schmervice);
server.registerService(
class MathService extends Schmervice.Service {
add(x, y) {
this.server.log(['math-service'], 'Adding');
return Number(x) + Number(y);
}
multiply(x, y) {
this.server.log(['math-service'], 'Multiplying');
return Number(x) * Number(y);
}
}
);
server.route({
method: 'get',
path: '/add/{a}/{b}',
handler: (request) => {
const { a, b } = request.params;
const { mathService } = request.services();
return mathService.add(a, b);
}
});
await server.start();
console.log(`Start adding at ${server.info.uri}`);
})();
功能样式
Schmervices允许您在以上显示的面向类方法之外,以功能风格写入服务. server.registerService() 可以通过普通对象或工厂函数。 只要确保您使用 Schmervice.name 符号或 name 属性。 以上例的功能调整如下:
const Schmervice = require('@hapipal/schmervice');
const Hapi = require('@hapi/hapi');
(async () => {
const server = Hapi.server();
await server.register(Schmervice);
server.registerService(
(srv) => ({
[Schmervice.name]: 'mathService',
add: (x, y) => {
srv.log(['math-service'], 'Adding');
return Number(x) + Number(y);
},
multiply: (x, y) => {
srv.log(['math-service'], 'Multiplying');
return Number(x) * Number(y);
}
})
);
server.route({
method: 'get',
path: '/add/{a}/{b}',
handler: (request) => {
const { a, b } = request.params;
const { mathService } = request.services();
return mathService.add(a, b);
}
});
await server.start();
console.log(`Start adding at ${server.info.uri}`);
})();
利用现有图书馆作为服务
也可以在您的应用程序中将已有的图书馆用作服务. 举个例子,我们如何利用 节点 作为发送电子邮件的服务。 此示例特征 Schmervice.withName(),这是一个方便的方式,可以使用 Schmervice.name 符号,类似于上面的例子:
const Schmervice = require('@hapipal/schmervice');
const Nodemailer = require('nodemailer');
const Hapi = require('@hapi/hapi');
(async () => {
const server = Hapi.server();
await server.register(Schmervice);
server.registerService(
Schmervice.withName('emailService', () => {
// Sendmail is a simple transport to configure for testing, but if you're
// not seeing the sent emails then make sure to check your spam folder.
return Nodemailer.createTransport({
sendmail: true
});
})
);
server.route({
method: 'get',
path: '/email/{toAddress}/{message*}',
handler: async (request) => {
const { toAddress, message } = request.params;
const { emailService } = request.services();
await emailService.sendMail({
from: '[email protected]',
to: toAddress,
subject: 'A message for you',
text: message
});
return { success: true };
}
});
await server.start();
console.log(`Start emailing at ${server.info.uri}`);
})();
额外
什么是服务层?
"服务层"是一个非常不准确的术语,因为它被各种开发者和应用程序以各种方式使用. 我们的目标不是规定你如何使用服务。 但一般情况下,人们可能会在"服务"中写出代码,作为将相关的业务逻辑,数据交易(如将记录保存到数据库)分组的方式,或者调用外部API. 有时服务层会表示一个"无头"界面,指您在一个应用程序中可以采取的所有动作,独立于任何传输(如HTTP),并且隐藏应用的数据层(或模型)从它的消费者那里.
就我们的情况而言,服务构成一个通用的“层”或你代码库的一部分——具体来说,它们只是每个服务器一次的类。 你可以用它,不管你觉得合适!
hopi实际上有一个与服务这一概念密切相关的特征: 服务器方法。我们喜欢服务器方法,但也认为它们作为低级API比直接用于中大型项目更有效。 如果你已经熟悉了hopi服务器方法,可以把schmervices看作是一个在工程学上创建和使用服务器方法(加上一些其他的铃声和口哨)的工具.