refactor: ValidationException — исключительная собственность WordPdfValidator
PR checks / web (pull_request) Successful in 37s
PR checks / java (pull_request) Successful in 1m24s
Main: tests, deploy, autotests / web (push) Successful in 32s
Main: tests, deploy, autotests / java (push) Successful in 1m8s
Main: tests, deploy, autotests / images-web (push) Successful in 32s
Main: tests, deploy, autotests / images-app (push) Successful in 49s
Main: tests, deploy, autotests / deploy (push) Successful in 3m58s
Main: tests, deploy, autotests / autotests (push) Successful in 41s
Main: tests, deploy, autotests / rollback (push) Has been skipped

Мост .doc → .docx (internal/doc) и javadoc-контракты переводятся на
ConversionException; WordPdfValidator.checkPageCountDoc оборачивает отказ
моста в ValidationException с сохранением текста (вердикт «вход
некорректен» выносит только валидатор; глубина, ловимая лишь при
конвертации, становится 500 — как у .docx). Проверки ConvertController
переезжают на новый app-класс BadRequestException (400 с теми же
текстами), ApiExceptionHandler получает хендлер. Тесты моста доказывают
ровно тип (assertSame(ConversionException.class, ...)); новый регрессивный
WordPdfValidatorTest#checkPageCountDoc_brokenBridge_wrappedAsValidation.
Документация (AGENTS.md, docs/agent/doc-bridge.md) синхронизирована.
This commit was merged in pull request #93.
This commit is contained in:
Pjandro
2026-11-03 23:10:16 +00:00
parent 1ecaa9e959
commit ba755e8ac0
33 changed files with 331 additions and 159 deletions
@@ -19,9 +19,11 @@ import ru.pjandro.wordpdf.ValidationException;
/**
* Единый перевод исключений в JSON {@code {"error": "..."}} с кодом по смыслу.
*
* <p>{@link ValidationException} ядра доходит сюда напрямую — валидатор
* бросает его сам; в {@link ConversionFailedException} превращается только
* прочий {@code ru.pjandro.wordpdf.ConversionException} рендер-стадии.
* <p>400 приходит из двух источников: {@link ValidationException} валидатора
* ядра (тот бросает его сам) и {@link BadRequestException} контроллера
* (ошибки уровня запроса до ядра). В {@link ConversionFailedException}
* превращается только прочий {@code ru.pjandro.wordpdf.ConversionException}
* рендер-стадии.
* Метод/тип содержимого не по контракту — 405/415 (иначе утонули бы в
* catch-all 500). Случайная утечка прочего исключения попадёт в обработчик
* {@link Exception} (500).</p>
@@ -42,12 +44,18 @@ final class ApiExceptionHandler {
record ApiError(String error) {
}
/** Некорректный вход: пустой, не .docx, не zip, размер/страницы сверх лимитов запроса. */
/** Некорректный вход по вердикту валидатора ядра: размер, контейнер (не zip / не .docx/.doc), страницы сверх лимитов. */
@ExceptionHandler(ValidationException.class)
ResponseEntity<ApiError> validation(ValidationException e) {
return ResponseEntity.badRequest().body(new ApiError(e.getMessage()));
}
/** Ошибка уровня запроса в {@link ConvertController} (файл не передан, расширение, размер, партит не прочитать) — 400 с текстом контроллера. */
@ExceptionHandler(BadRequestException.class)
ResponseEntity<ApiError> badRequest(BadRequestException e) {
return ResponseEntity.badRequest().body(new ApiError(e.getMessage()));
}
/** Документ содержит диаграммы/SmartArt/OLE-объекты при включённом error-флаге — вход корректен, но отвергнут по настройке. */
@ExceptionHandler(DrawingRejectedException.class)
ResponseEntity<ApiError> drawingRejected(DrawingRejectedException e) {
@@ -0,0 +1,24 @@
package ru.pjandro.wordpdf.app;
/**
* Ошибка уровня запроса до ядра: файл не передан, расширение не .docx/.doc,
* размер сверх {@code wordpdf.max-mb}, партиту загрузки не прочитать.
* Бросается {@link ConvertController} до обращения к {@link ConversionService}.
*
* <p>Смыслом близок к {@code ru.pjandro.wordpdf.ValidationException} (оба —
* 400), но разведены слои: {@code ValidationException} — исключительная
* собственность валидатора ядра, этот тип — HTTP-слой приложения.
* Маппится в HTTP 400 ({@link ApiExceptionHandler}).</p>
*
* <p>Регрессия — ConvertControllerTest#unreadableUpload_rejected.</p>
*/
final class BadRequestException extends RuntimeException {
BadRequestException(String message) {
super(message);
}
BadRequestException(String message, Throwable cause) {
super(message, cause);
}
}
@@ -13,7 +13,6 @@ 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;
@@ -76,14 +75,14 @@ final class ConvertController {
@RequestParam(name = "errorOnSmartArt", required = false) Boolean errorOnSmartArt,
@RequestParam(name = "errorOnOle", required = false) Boolean errorOnOle) {
if (file == null || file.isEmpty()) {
throw new ValidationException("Файл не передан (multipart-поле «file» обязательно)");
throw new BadRequestException("Файл не передан (multipart-поле «file» обязательно)");
}
String name = file.getOriginalFilename();
String lower = name == null ? "" : name.toLowerCase(Locale.ROOT);
if (!lower.endsWith(".docx") && !lower.endsWith(".doc")) {
// расширение проверяется здесь: ядро с байтов его не видит;
// .doc (Word 97–2003) переносится в .docx мостом internal.doc
throw new ValidationException("Поддерживаются только .docx и .doc: " + name);
throw new BadRequestException("Поддерживаются только .docx и .doc: " + name);
}
// Размер проверяется до getBytes(): multipart-лимит сервера (100 МБ)
// больше логического лимита входа (wordpdf.max-mb), и без этого гварда
@@ -91,14 +90,14 @@ final class ConvertController {
// Текст — тот же формат, что WordPdfValidator.checkInput.
long maxBytes = maxMb * 1024 * 1024;
if (file.getSize() > maxBytes) {
throw new ValidationException("Файл больше " + maxMb + " МБ: "
throw new BadRequestException("Файл больше " + maxMb + " МБ: "
+ file.getSize() + " байт > " + maxBytes + " байт");
}
byte[] docxBytes;
try {
docxBytes = file.getBytes();
} catch (IOException e) {
throw new ValidationException("Не удалось прочитать загруженный файл", e);
throw new BadRequestException("Не удалось прочитать загруженный файл", e);
}
ConvertOptions options = new ConvertOptions(
errorOnCharts != null ? errorOnCharts : WordPdfSettings.ERROR_ON_CHARTS,
@@ -45,6 +45,15 @@ class ApiExceptionHandlerTest {
assertEquals("Файл больше 100MB — лимит multipart сервера", response.getBody().error());
}
/** Ошибка уровня запроса контроллера — 400 с дословным текстом (та же форма, что 400 валидатора ядра). */
@Test
void badRequest_returns400WithText() {
var response = handler.badRequest(
new BadRequestException("Поддерживаются только .docx и .doc: x.txt"));
assertEquals(HttpStatus.BAD_REQUEST, response.getStatusCode());
assertEquals("Поддерживаются только .docx и .doc: x.txt", response.getBody().error());
}
/** Прочее исключение — 500 с общим текстом; подробность причины — только в лог. */
@Test
void unexpected_returns500WithoutDetails() {
@@ -15,7 +15,6 @@ import org.springframework.http.MediaType;
import org.springframework.mock.web.MockMultipartFile;
import org.springframework.test.web.servlet.MockMvc;
import org.springframework.test.web.servlet.MvcResult;
import ru.pjandro.wordpdf.ValidationException;
import java.io.ByteArrayOutputStream;
import java.io.IOException;
@@ -460,7 +459,7 @@ class ConvertControllerTest {
/**
* Отказ чтения партиты контейнером ({@code IOException} из
* {@code getBytes}) — {@link ValidationException} (400-смысл: вход не
* {@code getBytes}) — {@link BadRequestException} (400-смысл: вход не
* прочитан), а не 500 от catch-all.
*/
@Test
@@ -474,7 +473,7 @@ class ConvertControllerTest {
};
ConvertController controller =
new ConvertController(new ConversionService(Duration.ofSeconds(5)), 5L, 100);
ValidationException e = assertThrows(ValidationException.class,
BadRequestException e = assertThrows(BadRequestException.class,
() -> controller.convert(broken, null, null, null));
assertTrue(e.getMessage().contains("Не удалось прочитать"), e.getMessage());
}