Quartz
Ir para notas que citam estaQuartz é uma biblioteca Java de agendamento de jobs, que define quando e com que frequência uma rotina roda, usada para acionar periodicamente a leitura de novos blocos da blockchain.
Um serviço que acompanha a blockchain precisa voltar a ela sem parar, porque qualquer bloco novo pode trazer transações. Em vez de escrever esse laço à mão, o Transaction Consumer entrega ao Quartz a decisão de quando rodar e fica responsável apenas por buscar e gravar as transações.
Job, gatilho e serviço em classes separadas
A configuração do job e do gatilho (trigger) fica numa classe de configuração própria. A classe que representa o job não contém a lógica de negócio: ela aponta para uma classe de serviço, onde a busca e a gravação das transações de fato acontecem. Propriedades como o nome que o job usa internamente são passadas por uma estrutura de dados do próprio job, e a classe do job estende uma classe abstrata genérica que concentra funções comuns, como o logging e o disparo do processo.
O Quartz também guarda seu estado no banco da aplicação. Das sete tabelas do banco do Transaction Consumer, a maioria pertence à biblioteca; só uma é a tabela principal de transações.
Intervalo em função do tempo de bloco
O gatilho dispara 10 segundos depois que a execução anterior termina, e não em horários fixos. O resultado é um ciclo contínuo: processa os blocos pendentes, espera, roda de novo, até o serviço ser desligado. Como a rede gera um Bloco a cada cerca de 5 segundos, cada rodada encontra poucos blocos novos, e a espera curta mantém o banco próximo da cadeia.
Agendar a próxima rodada a partir do término da anterior impede que duas execuções se sobreponham quando uma varredura demora mais que o intervalo, como na primeira carga, que percorre a cadeia desde o bloco zero.
O job roda dentro de um serviço feito com o framework Quarkus, escolhido por ser mais leve e performático que alternativas como o Spring para um processo que fica de pé 24 horas por dia.