FileControllerImpl.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.controller
import org.archtool.fileloader2.controller.api.FileController
import org.archtool.fileloader2.controller.api.dto.CheckAuthResponse
import org.archtool.fileloader2.controller.api.dto.UploadResponse
import jakarta.servlet.http.HttpServletResponse
import java.nio.charset.StandardCharsets
import java.util.concurrent.Semaphore
import org.archtool.fileloader2.configuration.properties.DownloadProperties
import org.archtool.fileloader2.exception.UserDataException
import org.archtool.fileloader2.service.download.DownloadService
import org.archtool.fileloader2.service.upload.UploadService
import org.slf4j.LoggerFactory
import org.springframework.http.ContentDisposition
import org.springframework.http.HttpHeaders
import org.springframework.http.InvalidMediaTypeException
import org.springframework.http.MediaType
import org.springframework.http.ResponseEntity
import org.springframework.security.oauth2.jwt.Jwt
import org.springframework.web.bind.annotation.RestController
import org.springframework.web.multipart.MultipartFile
@RestController
class FileControllerImpl(
private val uploadService: UploadService,
private val downloadService: DownloadService,
private val downloadProperties: DownloadProperties,
) : FileController {
private val log = LoggerFactory.getLogger(javaClass)
/** Разрешения на одновременные скачивания: файл при скачивании целиком в памяти, без предела можно исчерпать heap */
private val downloadPermits = Semaphore(downloadProperties.maxConcurrent)
/**
* Сохраняет файлы запроса. Из токена используется только sub как «кто загрузил». Он обязателен: без sub загрузка
* отклоняется с 500 как ошибка провайдера токенов (проверка в UploadService.upload).
*
* @param jwt токен пользователя
* @param files части multipart с именем files, null - частей нет
* @return идентификаторы сохранённых файлов в порядке частей запроса
* @throws org.archtool.fileloader2.exception.UserDataException запрос не прошёл проверку
*/
override fun upload(jwt: Jwt, files: List<MultipartFile>?): UploadResponse {
val uploaded = uploadService.upload(files = files.orEmpty(), uploadedBy = jwt.subject)
return UploadResponse(files = uploaded.map { UploadResponse.File(id = it.id, name = it.name) })
}
/**
* Отдаёт файл с исходным именем. Content-Type задаёт клиент при загрузке, поэтому файл может оказаться HTML
* со скриптом: attachment заставляет браузер сохранить файл, а не открыть как страницу, nosniff запрещает
* угадывать тип по содержимому.
*
* Разрешение на скачивание держится до конца записи содержимого в ответ, поэтому предел действует и на расшифровку,
* и на передачу файла медленному клиенту. Свободного разрешения не ждём: ожидание занимало бы поток Tomcat.
* Ошибка сервиса возникает до записи в ответ, поэтому GlobalExceptionHandler ещё может отдать её клиенту.
*
* @param rawFileId идентификатор файла из адреса
* @param response ответ: содержимое файла с заголовками Content-Disposition, Content-Type, Content-Length
* @throws UserDataException достигнут предел одновременных скачиваний, идентификатор некорректен или файла нет
* @throws org.archtool.fileloader2.exception.ContentLostException содержимое утрачено
*/
override fun download(rawFileId: String, response: HttpServletResponse) {
if (!downloadPermits.tryAcquire()) {
// ошибку клиента GlobalExceptionHandler пишет в DEBUG, а перегрузку должно быть видно в журнале
log.warn("Достигнут предел одновременных скачиваний ({}), запрос отклонён", downloadProperties.maxConcurrent)
throw UserDataException(TOO_MANY_DOWNLOADS_MESSAGE)
}
try {
val file = downloadService.download(rawFileId)
val contentDisposition = ContentDisposition.attachment()
.filename(file.name, StandardCharsets.UTF_8)
.build()
response.setHeader(HttpHeaders.CONTENT_DISPOSITION, contentDisposition.toString())
response.setHeader(X_CONTENT_TYPE_OPTIONS, NOSNIFF)
response.contentType = parseContentType(file.contentType).toString()
response.setContentLengthLong(file.sizeBytes)
response.outputStream.write(file.content)
} finally {
downloadPermits.release()
}
}
/**
* Подтверждает аутентификацию: если запрос дошёл до контроллера, токен действителен.
*
* @return ответ 200 с сообщением об успешной аутентификации
*/
override fun checkAuth(): ResponseEntity<CheckAuthResponse> {
return ResponseEntity.ok().body(CheckAuthResponse.SUCCESS)
}
/**
* Разбирает тип содержимого, сохранённый из запроса на загрузку как есть.
*
* @param contentType сохранённый тип
* @return разобранный тип или application/octet-stream, если тип некорректен
*/
private fun parseContentType(contentType: String): MediaType {
return try {
MediaType.parseMediaType(contentType)
} catch (e: InvalidMediaTypeException) {
log.warn("Некорректный сохранённый тип содержимого '{}', отдаём {}", contentType, MediaType.APPLICATION_OCTET_STREAM_VALUE, e)
MediaType.APPLICATION_OCTET_STREAM
}
}
companion object {
private const val X_CONTENT_TYPE_OPTIONS = "X-Content-Type-Options"
private const val NOSNIFF = "nosniff"
const val TOO_MANY_DOWNLOADS_MESSAGE = "Сервис занят другими скачиваниями. Попробуйте позже."
}
}