Há alguns anos, em um de nossos projetos, nos deparamos com a necessidade de postergar a execução de uma ação por um determinado período. Por exemplo, descubra o status do pagamento em três horas ou reenvie a notificação após 45 minutos. No entanto, naquela época não encontramos bibliotecas adequadas que pudessem "adiar" e não exigissem tempo adicional para configuração e operação. Analisamos as opções possíveis e escrevemos nossa própria pequena biblioteca de filas atrasadas em Java usando o Redis como repositório. Neste artigo, falarei sobre os recursos da biblioteca, suas alternativas e os "ancinhos" que encontramos no processo.
Funcionalidade
Então, o que a fila atrasada faz? Um evento adicionado à fila pendente é entregue ao manipulador após o período de tempo especificado. Se o processamento falhar, o evento será entregue novamente mais tarde. Além disso, o número máximo de tentativas é limitado. O Redis não garante segurança e você precisa estar preparado para a perda de eventos . No entanto, na versão em cluster, o Redis mostra uma confiabilidade bastante alta, e nunca encontramos isso em um ano e meio de operação.
API
Adicionar um evento à fila
eventService.enqueueWithDelayNonBlocking(new DummyEvent("1"), Duration.ofHours(1)).subscribe();
Observe que o método retorna Mono, portanto, para executá-lo, você precisa seguir um destes procedimentos:
subscribe(...)block()
Explicações mais detalhadas são fornecidas na documentação para Project Reactor. O contexto é adicionado ao evento da seguinte forma:
eventService.enqueueWithDelayNonBlocking(new DummyEvent("1"), Duration.ofHours(1), Map.of("key", "value")).subscribe();
Registrar manipulador de eventos
eventService.addHandler(DummyEvent.class, e -> Mono.just(true), 1);
, :
eventService.addHandler(
DummyEvent.class,
e -> Mono
.subscriberContext()
.doOnNext(ctx -> {
Map<String, String> eventContext = ctx.get("eventContext");
log.info("context key {}", eventContext.get("key"));
})
.thenReturn(true),
1
);
eventService.removeHandler(DummyEvent.class);
"-":
import static com.github.fred84.queue.DelayedEventService.delayedEventService;
var eventService = delayedEventService().client(redisClient).build();
:
import static com.github.fred84.queue.DelayedEventService.delayedEventService;
var eventService = delayedEventService()
.client(redisClient)
.mapper(objectMapper)
.handlerScheduler(Schedulers.fromExecutorService(executor))
.schedulingInterval(Duration.ofSeconds(1))
.schedulingBatchSize(SCHEDULING_BATCH_SIZE)
.enableScheduling(false)
.pollingTimeout(POLLING_TIMEOUT)
.eventContextHandler(new DefaultEventContextHandler())
.dataSetPrefix("")
.retryAttempts(10)
.metrics(new NoopMetrics())
.refreshSubscriptionsInterval(Duration.ofMinutes(5))
.build();
( Redis) eventService.close() , @javax.annotation.PreDestroy.
- , . :
- , Redis;
- , ( "delayed.queue.ready.for.handling.count" )
, delayed queue. 2018
Amazon Web Services.
, . : " , Amazon-, ".
:
- , JMS . SQS , 15 .
" " . , Redis :
- sorted sets,
- "sorted_set" "list" ( )
, Netflix dyno-queues
. , , .
, " " sorted set list, ( ):
var events = redis.zrangebyscore("delayed_events", Range.create(-1, System.currentTimeMillis()), 100);
events.forEach(key -> {
var payload = extractPayload(key);
var listName = extractType(key);
redis.lpush(listName, payload);
redis.zrem("delayed_events", key);
});
redis.brpop(listName)
.
"list" (, ), list . Redis , 2 .
events.forEach(key -> {
...
redis.multi();
redis.zrem("delayed_events", key);
redis.lpush(listName, payload);
redis.exec();
});
list-a . , . "sorted_set" .
events.forEach(key -> {
...
redis.multi();
redis.zadd("delayed_events", nextAttempt(key))
redis.zrem("delayed_events", key);
redis.lpush(listName, payload);
redis.exec();
});
, , " " "delayed queue" . "sorted set"
metadata;payload, payload , metadata - . . , metadata payload Redis hset "sorted set" .
var envelope = metadata + SEPARATOR + payload;
redis.zadd(envelope, scheduledAt);
var envelope = metadata + SEPARATOR + payload;
var key = eventType + SEPARATOR + eventId;
redis.multi();
redis.zadd(key, scheduledAt);
redis.hset("metadata", key, envelope)
redis.exec();
, . , list . TTL :
redis.set(lockKey, "value", ex(lockTimeout.toMillis() * 1000).nx());
Spring, . " " :
Lettuce , . Project Reactor , " ".
, Subscriber
redis
.reactive()
.brpop(timeout, queue)
.map(e -> deserialize(e))
.subscribe(new InnerSubscriber<>(handler, ... params ..))
class InnerSubscriber<T extends Event> extends BaseSubscriber<EventEnvelope<T>> {
@Override
protected void hookOnNext(@NotNull EventEnvelope<T> envelope) {
Mono<Boolean> promise = handler.apply(envelope.getPayload());
promise.subscribe(r -> request(1));
}
}
, ( Netflix dyno queue, poll- ).
?
- Kotlin DSL. Kotlin
suspend funAPIProject Reactor