core: ValidationException вместо ConversionException; удаление pkg-API и переименование checkPageCountLightweight в checkPageCount
This commit is contained in:
@@ -10,14 +10,16 @@ import org.springframework.web.bind.annotation.RestControllerAdvice;
|
||||
import org.springframework.web.multipart.MaxUploadSizeExceededException;
|
||||
import org.springframework.web.multipart.support.MissingServletRequestPartException;
|
||||
import org.springframework.web.servlet.resource.NoResourceFoundException;
|
||||
import ru.pjandro.wordpdf.ValidationException;
|
||||
|
||||
/**
|
||||
* Единый перевод исключений в JSON {@code {"error": "..."}} с кодом по смыслу.
|
||||
*
|
||||
* <p>Голый {@code ru.pjandro.wordpdf.ConversionException} ядра сюда не доходит:
|
||||
* контроллер и {@link ConversionService} превращают его на границе в
|
||||
* {@link ValidationException}/{@link ConversionFailedException}; случайная
|
||||
* утечка попадёт в обработчик {@link Exception} (500).</p>
|
||||
* <p>{@link ValidationException} ядра доходит сюда напрямую — валидатор
|
||||
* бросает его сам; в {@link ConversionFailedException} превращается только
|
||||
* прочий {@code ru.pjandro.wordpdf.ConversionException} рендер-стадии.
|
||||
* Случайная утечка прочего исключения попадёт в обработчик {@link Exception}
|
||||
* (500).</p>
|
||||
*/
|
||||
@RestControllerAdvice
|
||||
final class ApiExceptionHandler {
|
||||
|
||||
@@ -4,8 +4,9 @@ package ru.pjandro.wordpdf.app;
|
||||
* Ошибка преобразования: контейнер .docx принят валидацией, но упал сам
|
||||
* рендер (ядро, FOP, повреждённое содержимое внутри валидного zip).
|
||||
*
|
||||
* <p>Смысл отличается от {@link ValidationException}: вход формально корректен,
|
||||
* отказал движок конвертации. Маппится в HTTP 500 ({@link ApiExceptionHandler}).</p>
|
||||
* <p>Смысл отличается от {@code ru.pjandro.wordpdf.ValidationException}:
|
||||
* вход формально корректен, отказал движок конвертации.
|
||||
* Маппится в HTTP 500 ({@link ApiExceptionHandler}).</p>
|
||||
*
|
||||
* <p>Регрессия — ConvertControllerTest#junkInsideValidZip_conversionError.</p>
|
||||
*/
|
||||
|
||||
@@ -8,6 +8,7 @@ import ru.pjandro.wordpdf.ConversionException;
|
||||
import ru.pjandro.wordpdf.DrawingFoundException;
|
||||
import ru.pjandro.wordpdf.WordPdfConverter;
|
||||
import ru.pjandro.wordpdf.WordPdfValidator;
|
||||
import ru.pjandro.wordpdf.ValidationException;
|
||||
|
||||
import java.time.Duration;
|
||||
import java.util.Locale;
|
||||
@@ -34,9 +35,10 @@ import java.util.concurrent.TimeoutException;
|
||||
* {@link ValidationException} (400), ошибка рендер-стадии →
|
||||
* {@link ConversionFailedException} (500). Граница: сломанный контейнер
|
||||
* (не zip / битый zip / слишком большой / слишком длинный) — 400; валидный
|
||||
* zip с мусором внутри (нет {@code word/document.xml}) — 500: lightweight-
|
||||
* подсчёт страниц согласован с JAXB-путём ядра (может только завышать),
|
||||
* поэтому уже принятый запрос внутренняя проверка ядра в ошибку не превратит.</p>
|
||||
* zip с мусором внутри (нет {@code word/document.xml}) — 500: до очереди и
|
||||
* в конвейере ядра страницы проверяются одним и тем же lightweight-путём
|
||||
* ({@link WordPdfValidator#checkPageCount}), поэтому уже принятый
|
||||
* запрос внутренняя проверка ядра в ошибку не превратит.</p>
|
||||
*/
|
||||
@Service
|
||||
final class ConversionService {
|
||||
@@ -111,7 +113,8 @@ final class ConversionService {
|
||||
}
|
||||
|
||||
/**
|
||||
* Валидация байтов переиспользует публичные byte-API ядра. Порядок значим:
|
||||
* Валидация байтов переиспользует публичные byte-API ядра; ядро бросает
|
||||
* {@link ValidationException} само — оборачивать нечего. Порядок значим:
|
||||
* размер (дешёвая) → magic bytes → lightweight-разбор zip. Лимиты
|
||||
* размера/страниц берутся из {@code options} (контроллер подставляет их
|
||||
* из конфигурации сервера: свойства {@code wordpdf.max-bytes}/
|
||||
@@ -119,25 +122,17 @@ final class ConversionService {
|
||||
*
|
||||
* <p>Проверка zip-подписи отдельным шагом обязательна:
|
||||
* {@code ZipInputStream.getNextEntry()} на не-zip-потоке возвращает
|
||||
* {@code null} молча, и {@link WordPdfValidator#checkPageCountLightweight(byte[])}
|
||||
* {@code null} молча, и {@link WordPdfValidator#checkPageCount(byte[])}
|
||||
* такой вход не отверг бы (0 страниц). Регрессия —
|
||||
* ConvertControllerTest#corruptNotAZip_rejected.</p>
|
||||
*/
|
||||
void validate(byte[] docxBytes, ConvertOptions options) {
|
||||
try {
|
||||
WordPdfValidator.checkInput(docxBytes, options.maxBytes());
|
||||
} catch (ConversionException e) {
|
||||
throw new ValidationException(e.getMessage(), e);
|
||||
}
|
||||
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-архив)");
|
||||
}
|
||||
try {
|
||||
WordPdfValidator.checkPageCountLightweight(docxBytes, options.maxPages());
|
||||
} catch (ConversionException e) {
|
||||
throw new ValidationException(e.getMessage(), e);
|
||||
}
|
||||
WordPdfValidator.checkPageCount(docxBytes, options.maxPages());
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -149,6 +144,10 @@ final class ConversionService {
|
||||
try {
|
||||
// заголовок PDF — санитизированный base исходного имени
|
||||
return WordPdfConverter.convert(docxBytes, safeBaseName(originalFilename), options);
|
||||
} catch (ValidationException e) {
|
||||
// отказ проверки страниц внутри конвейера ядра — некорректный
|
||||
// вход (400), а не ошибка рендера: без этого утонул бы в 500
|
||||
throw e;
|
||||
} catch (DrawingFoundException e) {
|
||||
// отказ по настройке запроса (error-флаг) — не ошибка рендера: 422,
|
||||
// иначе утонет в общем catch ниже как 500
|
||||
|
||||
@@ -13,6 +13,7 @@ import org.springframework.beans.factory.annotation.Value;
|
||||
import org.springframework.web.multipart.MultipartFile;
|
||||
import ru.pjandro.wordpdf.ConvertOptions;
|
||||
import ru.pjandro.wordpdf.WordPdfSettings;
|
||||
import ru.pjandro.wordpdf.ValidationException;
|
||||
|
||||
import java.io.IOException;
|
||||
import java.nio.charset.StandardCharsets;
|
||||
|
||||
@@ -1,23 +0,0 @@
|
||||
package ru.pjandro.wordpdf.app;
|
||||
|
||||
/**
|
||||
* Некорректный вход: пустой файл, не .docx, не zip-архив, размер или число
|
||||
* страниц сверх переданных в запросе (или дефолтных) лимитов.
|
||||
*
|
||||
* <p>Отличается от {@link ConversionFailedException} смыслом: запрос
|
||||
* некорректен сам по себе, повтор его же ничего не изменит. Маппится в HTTP 400
|
||||
* ({@link ApiExceptionHandler}).</p>
|
||||
*
|
||||
* <p>Регрессия — ConvertControllerTest#nonDocxFilename_rejected,
|
||||
* #oversizedOverCoreLimit_rejected, #corruptNotAZip_rejected.</p>
|
||||
*/
|
||||
class ValidationException extends RuntimeException {
|
||||
|
||||
ValidationException(String message) {
|
||||
super(message);
|
||||
}
|
||||
|
||||
ValidationException(String message, Throwable cause) {
|
||||
super(message, cause);
|
||||
}
|
||||
}
|
||||
@@ -252,14 +252,14 @@ class ConvertControllerTest {
|
||||
|
||||
@Test
|
||||
void oversizedOverCoreLimit_rejected() throws Exception {
|
||||
// 20 MiB + 1 байт: проходит контейнерный multipart-лимит (100 МБ)
|
||||
// 5 MiB + 1 байт: проходит контейнерный multipart-лимит (100 МБ)
|
||||
// и отсекается валидацией ядра до очереди (дефолт ядра цел —
|
||||
// лимит задаёт только конфигурация сервера)
|
||||
byte[] big = new byte[20 * 1024 * 1024 + 1];
|
||||
byte[] big = new byte[5 * 1024 * 1024 + 1];
|
||||
mockMvc.perform(multipart("/api/v1/convert").file(docx("big.docx", big)))
|
||||
.andExpect(status().isBadRequest())
|
||||
.andExpect(jsonPath("$.error",
|
||||
org.hamcrest.Matchers.containsString("больше 20 МБ")));
|
||||
org.hamcrest.Matchers.containsString("больше 5 МБ")));
|
||||
}
|
||||
|
||||
/**
|
||||
|
||||
Reference in New Issue
Block a user