core: перенос валидации входа из ConversionService в WordPdfValidator.validate

This commit is contained in:
Pjandro
2026-10-19 21:49:34 +00:00
parent 45b78f7fc9
commit 5482bfac60
6 changed files with 109 additions and 46 deletions
@@ -36,9 +36,9 @@ import java.util.concurrent.TimeoutException;
* {@link ConversionFailedException} (500). Граница: сломанный контейнер
* (не zip / битый zip / слишком большой / слишком длинный) — 400; валидный
* zip с мусором внутри (нет {@code word/document.xml}) — 500: до очереди и
* в конвейере ядра страницы проверяются одним и тем же lightweight-путём
* ({@link WordPdfValidator#checkPageCount}), поэтому уже принятый
* запрос внутренняя проверка ядра в ошибку не превратит.</p>
* в конвейере ядра вход проверяется тем же
* {@link WordPdfValidator#validate(byte[], ConvertOptions)}, поэтому уже
* принятый запрос внутренняя проверка ядра в ошибку не превратит.</p>
*/
@Service
final class ConversionService {
@@ -70,7 +70,7 @@ final class ConversionService {
* {@code null} не допускается (контроллер строит всегда).</p>
*/
byte[] convert(byte[] docxBytes, String originalFilename, ConvertOptions options) {
validate(docxBytes, options);
WordPdfValidator.validate(docxBytes, options);
Future<byte[]> future;
try {
future = workers.submit(() -> doConvert(docxBytes, originalFilename, options));
@@ -112,29 +112,6 @@ final class ConversionService {
}
}
/**
* Валидация байтов переиспользует публичные byte-API ядра; ядро бросает
* {@link ValidationException} само — оборачивать нечего. Порядок значим:
* размер (дешёвая) → magic bytes → lightweight-разбор zip. Лимиты
* размера/страниц берутся из {@code options} (контроллер подставляет их
* из конфигурации сервера: свойства {@code wordpdf.max-bytes}/
* {@code wordpdf.max-pages}, дефолт — константы ядра).
*
* <p>Проверка zip-подписи отдельным шагом обязательна:
* {@code ZipInputStream.getNextEntry()} на не-zip-потоке возвращает
* {@code null} молча, и {@link WordPdfValidator#checkPageCount(byte[])}
* такой вход не отверг бы (0 страниц). Регрессия —
* ConvertControllerTest#corruptNotAZip_rejected.</p>
*/
void validate(byte[] docxBytes, ConvertOptions options) {
WordPdfValidator.checkInput(docxBytes, options.maxBytes());
if (docxBytes.length < 4 || docxBytes[0] != 'P' || docxBytes[1] != 'K'
|| (docxBytes[2] & 0xFF) != 0x03 || (docxBytes[3] & 0xFF) != 0x04) {
throw new ValidationException("Содержимое не похоже на .docx (не zip-архив)");
}
WordPdfValidator.checkPageCount(docxBytes, options.maxPages());
}
/**
* Тело задачи воркера. Ядро принимает байты — временные файлы не нужны;
* имя влияет только на заголовок PDF (параметр {@code title}), потому