TaskRelaunchService.kt
/*
Copyright (C) 2026 Sber
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
package org.archtool.service
import com.github.kagkarlsson.scheduler.SchedulerClient
import com.github.kagkarlsson.scheduler.task.CompletionHandler
import org.archtool.repository.TaskRelaunchRequestRepository
import org.archtool.service.relaunch.OnCompleteRelaunch
import org.archtool.service.relaunch.RelaunchableTask
import org.slf4j.LoggerFactory
import org.springframework.beans.factory.annotation.Qualifier
import org.springframework.stereotype.Component
import org.springframework.transaction.annotation.Propagation
import org.springframework.transaction.annotation.Transactional
import tools.jackson.databind.json.JsonMapper
import java.time.Instant
/**
* Очередь запусков задачи, пришедших во время её выполнения.
*
* Запрос не теряется, если совпадёт с завершением прогона: отправитель сначала пишет в очередь, затем
* пробует запустить задачу, а задача сначала удаляет свою строку планировщика, затем читает очередь.
* Хотя бы одна из сторон увидит запись другой, а [SchedulerClient.scheduleIfNotExists] запустит ровно один
* прогон. Для этого каждая запись должна быть закоммичена до следующего чтения, поэтому методы этого класса
* нельзя выполнять в транзакции: вызов внутри транзакции завершится ошибкой (Propagation.NEVER), а каждый метод
* репозитория коммитит свою запись сам.
*/
@Component
@Transactional(propagation = Propagation.NEVER)
class TaskRelaunchService(
private val repository: TaskRelaunchRequestRepository,
@param:Qualifier("jacksonJsonMapper") private val jsonMapper: JsonMapper
) {
private val log = LoggerFactory.getLogger(javaClass)
/**
* Запускает задачу, а если её экземпляр уже есть, ставит запрос в очередь.
*
* @return true, если запущен новый прогон, false, если запрос ждёт окончания текущего
*/
fun <T, R : Any> submit(schedulerClient: SchedulerClient, task: RelaunchableTask<T, R>, request: R): Boolean {
if (schedulerClient.scheduleIfNotExists(task.instance(listOf(request)), Instant.now())) {
return true
}
repository.enqueue(task.taskName, task.instanceId, jsonMapper.writeValueAsString(request))
return launchQueued(schedulerClient, task)
}
/** Завершение прогона: сюда приводят все исходы, кроме ошибок JVM. */
fun <T, R : Any> onComplete(schedulerClient: SchedulerClient, task: RelaunchableTask<T, R>): CompletionHandler<T> =
OnCompleteRelaunch {
try {
launchQueued(schedulerClient, task)
} catch (e: Exception) {
// Не удалось прочитать очередь или запустить прогон. Записи очереди удаляются только после запуска
// прогона, поэтому запросы остались в ней, но этот прогон уже завершён и сам их не заберёт: они
// выполнятся после следующего прогона экземпляра (ручной запрос или расписание).
log.error("Не удалось запустить запросы из очереди для '{}': {}", task.instanceId, e.message, e)
}
}
private fun <T, R : Any> launchQueued(schedulerClient: SchedulerClient, task: RelaunchableTask<T, R>): Boolean {
val queued = repository.findByTaskNameAndTaskInstanceOrderByIdAsc(task.taskName, task.instanceId)
if (queued.isEmpty()) {
return false
}
val requests = queued.map { jsonMapper.treeToValue(it.request, task.requestType) }
val isScheduled = schedulerClient.scheduleIfNotExists(task.instance(requests), Instant.now())
if (isScheduled) {
// Удаляем только прочитанные выше записи: их запросы ушли в запущенный прогон. Запросы, записанные в
// очередь после чтения, остаются в ней и выполнятся после этого прогона.
repository.deleteAllById(queued.map { it.id })
log.info("Запущен прогон '{}' для запросов из очереди: {}", task.instanceId, queued.size)
}
return isScheduled
}
}