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
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:
@@ -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());
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user