FileRepository.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.fileloader2.repository
import java.time.LocalDateTime
import java.util.UUID
import org.archtool.fileloader2.repository.mapper.FileRecordRowMapper
import org.springframework.jdbc.core.namedparam.MapSqlParameterSource
import org.springframework.jdbc.core.namedparam.NamedParameterJdbcTemplate
import org.springframework.jdbc.core.simple.JdbcClient
import org.springframework.stereotype.Repository
/**
* Доступ к таблице files.
* Транзакциями управляет вызывающий код, репозиторий их не открывает
*/
@Repository
class FileRepository(
private val jdbcClient: JdbcClient,
private val namedParameterJdbcTemplate: NamedParameterJdbcTemplate,
) {
/**
* Вставляет записи одним пакетом. Атомарность пакета обеспечивает транзакция вызывающего кода.
*
* @param records записи для вставки
*/
fun insertAll(records: List<FileRecord>) {
val params = records.map { record ->
MapSqlParameterSource()
.addValue("id", record.id)
.addValue("status", record.status.name)
.addValue("original_name", record.originalName)
.addValue("content_type", record.contentType)
.addValue("size_bytes", record.sizeBytes)
.addValue("encryption_salt", record.encryptionSalt)
.addValue("encryption_iv", record.encryptionIv)
.addValue("uploaded_by", record.uploadedBy)
.addValue("created_at_utc", record.createdAtUtc)
}.toTypedArray()
namedParameterJdbcTemplate.batchUpdate(
"""
INSERT INTO files (id, status, original_name, content_type, size_bytes, encryption_salt, encryption_iv, uploaded_by, created_at_utc)
VALUES (:id, :status, :original_name, :content_type, :size_bytes, :encryption_salt, :encryption_iv, :uploaded_by, :created_at_utc)
""".trimIndent(),
params
)
}
/**
* @param id идентификатор файла
* @return запись в любом статусе или null, если записи нет
*/
fun findById(id: UUID): FileRecord? {
return jdbcClient.sql("SELECT * FROM files WHERE id = :id")
.param("id", id)
.query(FileRecordRowMapper)
.optional()
.orElse(null)
}
/**
* Меняет статус одной инструкцией UPDATE только у файлов, которые сейчас в статусе [from].
* Условие на текущий статус защищает от смены статуса, изменённого параллельно другим запросом.
*
* @param ids идентификаторы файлов
* @param from ожидаемый текущий статус
* @param to новый статус
* @return число обновлённых строк
*/
fun updateStatus(ids: Collection<UUID>, from: FileRecord.FileStatus, to: FileRecord.FileStatus): Int {
return jdbcClient.sql("UPDATE files SET status = :to WHERE id IN (:ids) AND status = :from")
.param("to", to.name)
.param("ids", ids)
.param("from", from.name)
.update()
}
/**
* Ищет брошенных кандидатов: записи в статусе CANDIDATE, зарегистрированные раньше заданного времени.
*
* @param createdBeforeUtc граница времени регистрации в UTC
* @return идентификаторы найденных кандидатов
*/
fun findCandidateIdsCreatedBefore(createdBeforeUtc: LocalDateTime): List<UUID> {
return jdbcClient.sql("SELECT id FROM files WHERE status = :status AND created_at_utc < :created_before")
.param("status", FileRecord.FileStatus.CANDIDATE.name)
.param("created_before", createdBeforeUtc)
.query { rs, _ -> rs.getObject("id", UUID::class.java) }
.list()
}
/**
* Удаляет запись в любом статусе. Используется очисткой после удаления содержимого: запись без содержимого не нужна,
* даже если после выборки кандидат успел стать STORED_S3.
*
* @param id идентификатор файла
* @return число удалённых строк: 0 - записи уже нет
*/
fun delete(id: UUID): Int {
return jdbcClient.sql("DELETE FROM files WHERE id = :id")
.param("id", id)
.update()
}
}