Убрать render-флаги диаграмм/SmartArt; автозаголовок — «Название диаграммы»
ConvertOptions: renderCharts/renderSmartArt удалены (ядро, REST, SPA, прод-автотесты) — диаграммы/SmartArt конвертируются всегда, отказ только по error-флагам (DrawingFoundException → 422). Дефолт SPA-галок — false. ChartSpec.AUTO_TITLE русифицирован: «Название диаграммы». AGENTS.md приведён в соответствие.
This commit is contained in:
@@ -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");
|
||||
|
||||
Reference in New Issue
Block a user