Убрать render-флаги диаграмм/SmartArt; автозаголовок — «Название диаграммы»
PR checks / java (pull_request) Successful in 45s
PR checks / web (pull_request) Successful in 1m20s

ConvertOptions: renderCharts/renderSmartArt удалены (ядро, REST, SPA,
прод-автотесты) — диаграммы/SmartArt конвертируются всегда, отказ только
по error-флагам (DrawingFoundException → 422). Дефолт SPA-галок — false.
ChartSpec.AUTO_TITLE русифицирован: «Название диаграммы».
AGENTS.md приведён в соответствие.
This commit is contained in:
Pjandro
2026-10-22 17:50:17 +00:00
parent dff143d92e
commit 6b2715f1c2
16 changed files with 78 additions and 251 deletions
@@ -59,8 +59,9 @@ final class ConvertController {
}
@Operation(summary = "Конвертировать .docx в PDF",
description = "renderCharts/renderSmartArt/errorOnCharts/errorOnSmartArt — факультативно, "
+ "по умолчанию настройки ядра; render-флаг приоритетнее error-флага. "
description = "errorOnCharts/errorOnSmartArt — факультативно, по умолчанию "
+ "настройки ядра (ошибка не выбрасывается); диаграммы/SmartArt "
+ "конвертируются всегда. "
+ "Лимиты входа (размер/страницы) задаёт только конфигурация сервера "
+ "(свойства wordpdf.max-mb/wordpdf.max-pages), параметрами запроса не переопределяются")
@SecurityRequirement(name = OpenApiConfig.SCHEME)
@@ -70,8 +71,6 @@ final class ConvertController {
produces = MediaType.APPLICATION_PDF_VALUE)
ResponseEntity<byte[]> convert(
@RequestParam("file") MultipartFile file,
@RequestParam(name = "renderCharts", required = false) Boolean renderCharts,
@RequestParam(name = "renderSmartArt", required = false) Boolean renderSmartArt,
@RequestParam(name = "errorOnCharts", required = false) Boolean errorOnCharts,
@RequestParam(name = "errorOnSmartArt", required = false) Boolean errorOnSmartArt) {
if (file == null || file.isEmpty()) {
@@ -89,8 +88,6 @@ final class ConvertController {
throw new ValidationException("Не удалось прочитать загруженный файл", e);
}
ConvertOptions options = new ConvertOptions(
renderCharts != null ? renderCharts : WordPdfSettings.RENDER_CHARTS,
renderSmartArt != null ? renderSmartArt : WordPdfSettings.RENDER_SMARTART,
errorOnCharts != null ? errorOnCharts : WordPdfSettings.ERROR_ON_CHARTS,
errorOnSmartArt != null ? errorOnSmartArt : WordPdfSettings.ERROR_ON_SMARTART,
maxMb, maxPages);
@@ -3,11 +3,11 @@ package ru.pjandro.wordpdf.app;
import ru.pjandro.wordpdf.DrawingFoundException;
/**
* Документ содержит диаграммы/SmartArt при включённом error-флаге и
* выключенном render-флаге ({@link DrawingFoundException} ядра).
* Документ содержит диаграммы/SmartArt при включённом error-флаге
* ({@link DrawingFoundException} ядра).
*
* <p>Маппится в HTTP 422 ({@link ApiExceptionHandler}); клиенту осмысленно
* повторить с render-флагом или без error-флага. Текст сообщения —
* повторить без error-флага. Текст сообщения —
* пользовательский контракт: фронт показывает его дословно.</p>
*/
class DrawingRejectedException extends RuntimeException {
@@ -29,7 +29,6 @@ import java.util.zip.ZipEntry;
import java.util.zip.ZipOutputStream;
import static org.junit.jupiter.api.Assertions.assertThrows;
import static org.junit.jupiter.api.Assertions.assertEquals;
import static org.junit.jupiter.api.Assertions.assertNotNull;
import static org.junit.jupiter.api.Assertions.assertTrue;
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get;
@@ -154,34 +153,24 @@ class ConvertControllerTest {
}
/**
* Выключенные renderCharts/renderSmartArt: 200, PDF без единого растра,
* текст вокруг рисунков сохраняется. Тот же запрос без параметров —
* дефолты ядра пробиваются сквозь HTTP: картинки на месте.
* Диаграммы/SmartArt конвертируются всегда без каких-либо параметров
* запроса: 200, PDF с 4 растрами фикстуры.
*/
@Test
void renderFlagsOff_convertsWithoutDrawings() throws Exception {
byte[] sample = bytes("/samples/charts-smartart.docx");
byte[] off = mockMvc.perform(multipart("/api/v1/convert")
.file(docx("charts-smartart.docx", sample))
.param("renderCharts", "false")
.param("renderSmartArt", "false"))
void drawingsAlwaysRendered() throws Exception {
byte[] pdf = mockMvc.perform(multipart("/api/v1/convert")
.file(docx("charts-smartart.docx", bytes("/samples/charts-smartart.docx"))))
.andExpect(status().isOk())
.andExpect(content().contentType(MediaType.APPLICATION_PDF))
.andReturn().getResponse().getContentAsByteArray();
String offText = norm(pdfText(off));
assertTrue(offText.contains("Диаграммы"), "пропал текст вокруг диаграмм: " + offText);
assertEquals(0, imageCount(off), "выключенные drawing'и дали растры");
byte[] on = mockMvc.perform(multipart("/api/v1/convert")
.file(docx("charts-smartart.docx", sample)))
.andExpect(status().isOk())
.andReturn().getResponse().getContentAsByteArray();
assertTrue(imageCount(on) >= 4,
"дефолты ядра не пробиты сквозь HTTP: найдено растров " + imageCount(on));
String text = norm(pdfText(pdf));
assertTrue(text.contains("Диаграммы"), "пропал текст вокруг диаграмм: " + text);
assertTrue(imageCount(pdf) >= 4,
"объекты должны конвертироваться всегда, найдено растров " + imageCount(pdf));
}
/**
* errorOnCharts при renderCharts=false — HTTP 422 с текстом отказа
* errorOnCharts=true — HTTP 422 с текстом отказа
* (документ валиден, отвергнут по настройке запроса).
* Регрессия — WordPdfConverterTest#drawingErrors_errorFlagRejectsCharts,
* фикстура samples/charts-smartart.docx.
@@ -190,7 +179,6 @@ class ConvertControllerTest {
void errorFlagCharts_rejected() throws Exception {
mockMvc.perform(multipart("/api/v1/convert")
.file(docx("charts-smartart.docx", bytes("/samples/charts-smartart.docx")))
.param("renderCharts", "false")
.param("errorOnCharts", "true"))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.error",
@@ -198,8 +186,8 @@ class ConvertControllerTest {
}
/**
* errorOnSmartArt при renderSmartArt=false — 422 с текстом про SmartArt
* (диаграммы в этом вызове рендерятся, поэтому бросается целевой Kind).
* errorOnSmartArt=true — HTTP 422 с текстом про SmartArt (диаграммы
* конвертируются, их error-флаг выключен, поэтому бросается целевой Kind).
* Регрессия — WordPdfConverterTest#drawingErrors_errorFlagRejectsSmartArt,
* фикстура samples/charts-smartart.docx.
*/
@@ -207,34 +195,12 @@ class ConvertControllerTest {
void errorFlagSmartArt_rejected() throws Exception {
mockMvc.perform(multipart("/api/v1/convert")
.file(docx("charts-smartart.docx", bytes("/samples/charts-smartart.docx")))
.param("renderSmartArt", "false")
.param("errorOnSmartArt", "true"))
.andExpect(status().isUnprocessableEntity())
.andExpect(jsonPath("$.error",
org.hamcrest.Matchers.containsString("SmartArt")));
}
/**
* render-флаги приоритетнее error-флагов: все четыре включены — 200 и
* полный PDF с растрами.
* Регрессия — WordPdfConverterTest#drawingErrors_renderFlagWins,
* фикстура samples/charts-smartart.docx.
*/
@Test
void errorFlags_renderWins() throws Exception {
byte[] pdf = mockMvc.perform(multipart("/api/v1/convert")
.file(docx("charts-smartart.docx", bytes("/samples/charts-smartart.docx")))
.param("renderCharts", "true")
.param("renderSmartArt", "true")
.param("errorOnCharts", "true")
.param("errorOnSmartArt", "true"))
.andExpect(status().isOk())
.andReturn().getResponse().getContentAsByteArray();
assertTrue(imageCount(pdf) >= 4,
"рендер должен победить error-флаги, найдено растров " + imageCount(pdf));
}
@Test
void cyrillicAndPathInFilename_sanitizedResponseName() throws Exception {
byte[] sample = bytes("/samples/ru-plain.docx");