New release is coming soon! If you want to try out the latest features, simply run npm i -s moleculer@next. The docs for the latest version are available here.

Context

Quando você chama uma ação ou emite um evento, o broker cria uma instância de context que contém todas as informações da requisição e a passa para o handler da ação/evento como um único argumento.

Propriedades de Context

Nome Tipo Descrição
ctx.id String ID do contexto
ctx.broker ServiceBroker Instância do broker.
ctx.nodeID String O ID do nó do requisitante ou do destino.
ctx.action Object Instância da definição de ação.
ctx.event Object Instância da definição do evento.
ctx.eventName Object Nome do evento emitido.
ctx.eventType String Tipo de evento (“emit” ou “broadcast”).
ctx.eventGroups Array<String> Grupos de eventos.
ctx.caller String Nome completo do serviço do requisitante. Ex.: v3.myService
ctx.requestID String ID da Requisição. Se você fizer chamadas aninhadas, será o mesmo ID.
ctx.parentID String ID do contexto pai (em chamadas aninhadas).
ctx.params Any Parâmetros da requisição. Segundo argumento do broker.call.
ctx.meta Any Metadados da requisição. Será transferido para chamadas aninhadas
ctx.locals Any Dados locais.
ctx.level Number Nível da requisição (em chamadas aninhadas). O primeiro nível é 1.
ctx.span Span Span atual ativo.

Métodos de context

Nome Retorno Descrição
ctx.call() Promise Fazer chamadas aninhadas. Mesmos argumentos como em broker.call
ctx.emit() void Emitir um evento, o mesmo que broker.emit
ctx.broadcast() void Emitir um evento, o mesmo que broker.broadcast
ctx.startSpan(name, opts) Span Criar um novo span filho.
ctx.finishSpan(span) void Finalizar um span.
ctx.toJSON() Object Converter Context para um JSON formatado.
ctx.copy() this Criar uma cópia da instância de Context.

Rastreamento de context

Se você quer desligamentos elegantes dos serviços, ative o recurso Context tracking nas opções do broker. Se você habilitá-lo, todos os serviços esperarão por todos os context em execução antes de desligar. Um valor de timeout pode ser definido com a opção shutdownTimeout no broker. O valor padrão é 5 segundos.

Ativar context tracking & alterar o valor do timeout

const broker = new ServiceBroker({
nodeID: "node-1",
tracking: {
enabled: true,
shutdownTimeout: 10 * 1000
}
});

O timeout de desligamento pode ser substituído pela propriedade $shutdownTimeout nas configurações de serviço.

Desativar tracking nas opções de chamada

await broker.call("posts.find", {}, { tracking: false });