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

  In any derivative products, you must retain the information of
  owner of the original code and provide clear attribution to the project

  https://dochub.info

  The use of this product or its derivatives for any purpose cannot be a secret.


  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.

  Maintainers:
      Sergeev Viktor <sergeevviktor017@gmail.com>, Sber - 2026

  Contributors:
      Sergeev Viktor <sergeevviktor017@gmail.com>, Sber - 2026
*/

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()
    }
}