feat: errorOnCharts/errorOnSmartArt — отказ конвертации при находке диаграмм/SmartArt

This commit is contained in:
Pjandro
2026-10-15 22:03:14 +00:00
parent 98fc900a53
commit 307afc0678
12 changed files with 303 additions and 37 deletions
@@ -34,6 +34,13 @@ final class ApiExceptionHandler {
return ResponseEntity.badRequest().body(new ApiError(e.getMessage())); return ResponseEntity.badRequest().body(new ApiError(e.getMessage()));
} }
/** Документ содержит диаграммы/SmartArt при включённом error-флаге — вход корректен, но отвергнут по настройке. */
@ExceptionHandler(DrawingRejectedException.class)
ResponseEntity<ApiError> drawingRejected(DrawingRejectedException e) {
return ResponseEntity.status(HttpStatus.UNPROCESSABLE_ENTITY)
.body(new ApiError(e.getMessage()));
}
/** Ошибка ядра/рендера при формально корректном входе. */ /** Ошибка ядра/рендера при формально корректном входе. */
@ExceptionHandler(ConversionFailedException.class) @ExceptionHandler(ConversionFailedException.class)
ResponseEntity<ApiError> conversionFailed(ConversionFailedException e) { ResponseEntity<ApiError> conversionFailed(ConversionFailedException e) {
@@ -5,6 +5,7 @@ import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Service; import org.springframework.stereotype.Service;
import ru.pjandro.wordpdf.ConvertOptions; import ru.pjandro.wordpdf.ConvertOptions;
import ru.pjandro.wordpdf.ConversionException; import ru.pjandro.wordpdf.ConversionException;
import ru.pjandro.wordpdf.DrawingFoundException;
import ru.pjandro.wordpdf.WordPdfConverter; import ru.pjandro.wordpdf.WordPdfConverter;
import ru.pjandro.wordpdf.WordPdfValidator; import ru.pjandro.wordpdf.WordPdfValidator;
@@ -94,6 +95,9 @@ final class ConversionService {
if (cause instanceof ConversionFailedException cfe) { if (cause instanceof ConversionFailedException cfe) {
throw cfe; throw cfe;
} }
if (cause instanceof DrawingRejectedException dre) {
throw dre;
}
if (cause instanceof ConversionRejectedException cre) { if (cause instanceof ConversionRejectedException cre) {
throw cre; throw cre;
} }
@@ -145,6 +149,10 @@ final class ConversionService {
try { try {
// заголовок PDF — санитизированный base исходного имени // заголовок PDF — санитизированный base исходного имени
return WordPdfConverter.convert(docxBytes, safeBaseName(originalFilename), options); return WordPdfConverter.convert(docxBytes, safeBaseName(originalFilename), options);
} catch (DrawingFoundException e) {
// отказ по настройке запроса (error-флаг) — не ошибка рендера: 422,
// иначе утонет в общем catch ниже как 500
throw new DrawingRejectedException(e.kind());
} catch (ConversionException e) { } catch (ConversionException e) {
// всё, что упало на валидации/рендер-стадии ядра, — ошибка преобразования, 500 // всё, что упало на валидации/рендер-стадии ядра, — ошибка преобразования, 500
throw new ConversionFailedException("Не удалось конвертировать документ: " throw new ConversionFailedException("Не удалось конвертировать документ: "
@@ -58,8 +58,9 @@ final class ConvertController {
} }
@Operation(summary = "Конвертировать .docx в PDF", @Operation(summary = "Конвертировать .docx в PDF",
description = "renderCharts/renderSmartArt — факультативно, по умолчанию настройки ядра; " description = "renderCharts/renderSmartArt/errorOnCharts/errorOnSmartArt — факультативно, "
+ "лимиты входа (размер/страницы) задаёт только конфигурация сервера " + "по умолчанию настройки ядра; render-флаг приоритетнее error-флага. "
+ "Лимиты входа (размер/страницы) задаёт только конфигурация сервера "
+ "(свойства wordpdf.max-bytes/wordpdf.max-pages), параметрами запроса не переопределяются") + "(свойства wordpdf.max-bytes/wordpdf.max-pages), параметрами запроса не переопределяются")
@SecurityRequirement(name = OpenApiConfig.SCHEME) @SecurityRequirement(name = OpenApiConfig.SCHEME)
@PostMapping( @PostMapping(
@@ -69,7 +70,9 @@ final class ConvertController {
ResponseEntity<byte[]> convert( ResponseEntity<byte[]> convert(
@RequestParam("file") MultipartFile file, @RequestParam("file") MultipartFile file,
@RequestParam(name = "renderCharts", required = false) Boolean renderCharts, @RequestParam(name = "renderCharts", required = false) Boolean renderCharts,
@RequestParam(name = "renderSmartArt", required = false) Boolean renderSmartArt) { @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()) { if (file == null || file.isEmpty()) {
throw new ValidationException("Файл не передан (multipart-поле «file» обязательно)"); throw new ValidationException("Файл не передан (multipart-поле «file» обязательно)");
} }
@@ -87,6 +90,8 @@ final class ConvertController {
ConvertOptions options = new ConvertOptions( ConvertOptions options = new ConvertOptions(
renderCharts != null ? renderCharts : WordPdfSettings.RENDER_CHARTS, renderCharts != null ? renderCharts : WordPdfSettings.RENDER_CHARTS,
renderSmartArt != null ? renderSmartArt : WordPdfSettings.RENDER_SMARTART, renderSmartArt != null ? renderSmartArt : WordPdfSettings.RENDER_SMARTART,
errorOnCharts != null ? errorOnCharts : WordPdfSettings.ERROR_ON_CHARTS,
errorOnSmartArt != null ? errorOnSmartArt : WordPdfSettings.ERROR_ON_SMARTART,
maxBytes, maxPages); maxBytes, maxPages);
byte[] pdf = conversionService.convert(docxBytes, name, options); byte[] pdf = conversionService.convert(docxBytes, name, options);
ContentDisposition disposition = ContentDisposition.attachment() ContentDisposition disposition = ContentDisposition.attachment()
@@ -0,0 +1,20 @@
package ru.pjandro.wordpdf.app;
import ru.pjandro.wordpdf.DrawingFoundException;
/**
* Документ содержит диаграммы/SmartArt при включённом error-флаге и
* выключенном render-флаге ({@link DrawingFoundException} ядра).
*
* <p>Маппится в HTTP 422 ({@link ApiExceptionHandler}); клиенту осмысленно
* повторить с render-флагом или без error-флага. Текст сообщения —
* пользовательский контракт: фронт показывает его дословно.</p>
*/
class DrawingRejectedException extends RuntimeException {
DrawingRejectedException(DrawingFoundException.Kind kind) {
super(kind == DrawingFoundException.Kind.CHARTS
? "Конвертация отменена: в документе найдены диаграммы"
: "Конвертация отменена: в документе найден SmartArt");
}
}
@@ -150,6 +150,61 @@ class ConvertControllerTest {
"дефолты ядра не пробиты сквозь HTTP: найдено растров " + imageCount(on)); "дефолты ядра не пробиты сквозь HTTP: найдено растров " + imageCount(on));
} }
/**
* errorOnCharts при renderCharts=false — HTTP 422 с текстом отказа
* (документ валиден, отвергнут по настройке запроса).
* Регрессия — WordPdfConverterTest#drawingErrors_errorFlagRejectsCharts,
* фикстура samples/charts-smartart.docx.
*/
@Test
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",
org.hamcrest.Matchers.containsString("диаграмм")));
}
/**
* errorOnSmartArt при renderSmartArt=false — 422 с текстом про SmartArt
* (диаграммы в этом вызове рендерятся, поэтому бросается целевой Kind).
* Регрессия — WordPdfConverterTest#drawingErrors_errorFlagRejectsSmartArt,
* фикстура samples/charts-smartart.docx.
*/
@Test
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 @Test
void cyrillicAndPathInFilename_sanitizedResponseName() throws Exception { void cyrillicAndPathInFilename_sanitizedResponseName() throws Exception {
byte[] sample = bytes("/samples/ru-plain.docx"); byte[] sample = bytes("/samples/ru-plain.docx");
@@ -9,16 +9,25 @@ package ru.pjandro.wordpdf;
* @param renderSmartArt рендерить SmartArt (dgm:relIds → PNG); * @param renderSmartArt рендерить SmartArt (dgm:relIds → PNG);
* {@code false} — объект остаётся в docx, docx2fo * {@code false} — объект остаётся в docx, docx2fo
* выбрасывает его молча: в PDF пусто, текст сохраняется * выбрасывает его молча: в PDF пусто, текст сохраняется
* @param errorOnCharts бросать {@link DrawingFoundException} при находке
* диаграмм, **только если** {@code renderCharts}
* выключен (рендер приоритетнее error-флага)
* @param errorOnSmartArt бросать {@link DrawingFoundException} при находке
* SmartArt, **только если** {@code renderSmartArt}
* выключен (рендер приоритетнее error-флага)
* @param maxBytes лимит размера входных байтов на этот вызов; * @param maxBytes лимит размера входных байтов на этот вызов;
* дефолт — {@link WordPdfSettings#MAX_INPUT_BYTES} * дефолт — {@link WordPdfSettings#MAX_INPUT_BYTES}
* @param maxPages лимит числа страниц на этот вызов; * @param maxPages лимит числа страниц на этот вызов;
* дефолт — {@link WordPdfSettings#MAX_PAGES} * дефолт — {@link WordPdfSettings#MAX_PAGES}
*/ */
public record ConvertOptions(boolean renderCharts, boolean renderSmartArt, long maxBytes, int maxPages) { public record ConvertOptions(boolean renderCharts, boolean renderSmartArt,
boolean errorOnCharts, boolean errorOnSmartArt,
long maxBytes, int maxPages) {
/** Дефолты ядра из {@link WordPdfSettings}. */ /** Дефолты ядра из {@link WordPdfSettings}. */
public static ConvertOptions defaults() { public static ConvertOptions defaults() {
return new ConvertOptions(WordPdfSettings.RENDER_CHARTS, WordPdfSettings.RENDER_SMARTART, return new ConvertOptions(WordPdfSettings.RENDER_CHARTS, WordPdfSettings.RENDER_SMARTART,
WordPdfSettings.ERROR_ON_CHARTS, WordPdfSettings.ERROR_ON_SMARTART,
WordPdfSettings.MAX_INPUT_BYTES, WordPdfSettings.MAX_PAGES); WordPdfSettings.MAX_INPUT_BYTES, WordPdfSettings.MAX_PAGES);
} }
} }
@@ -0,0 +1,31 @@
package ru.pjandro.wordpdf;
/**
* Документ содержит объект, обработку которого вызывающий запретил:
* render-флаг выключен, а соответствующий error-флаг включён
* ({@link ConvertOptions#errorOnCharts()}, {@link ConvertOptions#errorOnSmartArt()}).
* render-флаг имеет приоритет: при включённом рендере исключение не бросается.
*
* <p>Наследник {@link ConversionException} — наружу по-прежнему ловится
* только он; {@code kind()} даёт вызывающему тип объекта без разбора текста.
* Регрессия — WordPdfConverterTest#drawingErrors_errorFlagRejectsCharts,
* фикстура samples/charts-smartart.docx.</p>
*/
public class DrawingFoundException extends ConversionException {
/** Тип найденного объекта. */
public enum Kind { CHARTS, SMARTART }
private final Kind kind;
public DrawingFoundException(Kind kind) {
super(kind == Kind.CHARTS
? "В документе найдены диаграммы, а их обработка запрещена (errorOnCharts)"
: "В документе найден SmartArt, а его обработка запрещена (errorOnSmartArt)");
this.kind = kind;
}
public Kind kind() {
return kind;
}
}
@@ -25,6 +25,16 @@ public final class WordPdfSettings {
/** Генерация SmartArt (dgm:relIds → PNG). {@code false} — как с {@link #RENDER_CHARTS}. */ /** Генерация SmartArt (dgm:relIds → PNG). {@code false} — как с {@link #RENDER_CHARTS}. */
public static final boolean RENDER_SMARTART = true; public static final boolean RENDER_SMARTART = true;
/**
* Ошибка при находке диаграмм (c:chart), если {@link #RENDER_CHARTS}
* выключен ({@link DrawingFoundException}). Дефолт {@code false} —
* библиотечное поведение не меняется.
*/
public static final boolean ERROR_ON_CHARTS = false;
/** Ошибка при находке SmartArt (dgm:relIds), если {@link #RENDER_SMARTART} выключен. */
public static final boolean ERROR_ON_SMARTART = false;
private WordPdfSettings() { private WordPdfSettings() {
} }
} }
@@ -34,6 +34,7 @@ import org.docx4j.wml.Drawing;
import org.slf4j.Logger; import org.slf4j.Logger;
import org.slf4j.LoggerFactory; import org.slf4j.LoggerFactory;
import ru.pjandro.wordpdf.ConvertOptions; import ru.pjandro.wordpdf.ConvertOptions;
import ru.pjandro.wordpdf.DrawingFoundException;
import javax.imageio.ImageIO; import javax.imageio.ImageIO;
import java.awt.image.BufferedImage; import java.awt.image.BufferedImage;
@@ -53,6 +54,12 @@ import java.util.Set;
* Порядок вызова важен: {@link #run} должен отработать после загрузки * Порядок вызова важен: {@link #run} должен отработать после загрузки
* пакета и до создания FOSettings, иначе FOP увидит исходные chart/diagram * пакета и до создания FOSettings, иначе FOP увидит исходные chart/diagram
* и молча их выбросит (notImplemented в шаблоне). * и молча их выбросит (notImplemented в шаблоне).
*
* Error-флаги {@link ConvertOptions}: при выключенном render-флаге и
* включённом error-флаге находка объекта — {@link DrawingFoundException}
* (бросок здесь, на шаге 3.5, до XSLT/FOP). Регрессия —
* WordPdfConverterTest#drawingErrors_errorFlagRejectsCharts, фикстура
* samples/charts-smartart.docx.
*/ */
public final class DrawingPreRenderer { public final class DrawingPreRenderer {
@@ -73,7 +80,9 @@ public final class DrawingPreRenderer {
/** /**
* Рендерит диаграммы/SmartArt пакета в PNG и подменяет их картинками. * Рендерит диаграммы/SmartArt пакета в PNG и подменяет их картинками.
* Объекты, выключенные в {@link ConvertOptions}, остаются в docx как есть * Объекты, выключенные в {@link ConvertOptions}, остаются в docx как есть
* (docx2fo выбросит их молча — на их месте в PDF пусто). * (docx2fo выбросит их молча — на их месте в PDF пусто), кроме случая,
* когда для них включён error-флаг: тогда {@link DrawingFoundException}.
* render-флаг приоритетнее: при включённом рендере error-флаг игнорируется.
*/ */
public static void run(WordprocessingMLPackage pkg, ConvertOptions options) { public static void run(WordprocessingMLPackage pkg, ConvertOptions options) {
ThemePart themePart = null; ThemePart themePart = null;
@@ -194,12 +203,18 @@ public final class DrawingPreRenderer {
String name = el.getName() == null ? "" : el.getName().toString(); String name = el.getName() == null ? "" : el.getName().toString();
if (CHART_ELEMENT.equals(name)) { if (CHART_ELEMENT.equals(name)) {
if (!options.renderCharts()) { if (!options.renderCharts()) {
if (options.errorOnCharts()) {
throw new DrawingFoundException(DrawingFoundException.Kind.CHARTS);
}
continue; // настройка выключена — drawing остаётся в docx как есть continue; // настройка выключена — drawing остаётся в docx как есть
} }
img = renderChart(part, (CTRelId) el.getValue(), pkg, colors, cx, cy); img = renderChart(part, (CTRelId) el.getValue(), pkg, colors, cx, cy);
label = "график"; label = "график";
} else if (DIAGRAM_ELEMENT.equals(name)) { } else if (DIAGRAM_ELEMENT.equals(name)) {
if (!options.renderSmartArt()) { if (!options.renderSmartArt()) {
if (options.errorOnSmartArt()) {
throw new DrawingFoundException(DrawingFoundException.Kind.SMARTART);
}
continue; continue;
} }
img = renderDiagram(part, (CTRelIds) el.getValue(), pkg, colors, cx, cy); img = renderDiagram(part, (CTRelIds) el.getValue(), pkg, colors, cx, cy);
@@ -155,7 +155,7 @@ class WordPdfConverterTest {
@Test @Test
void drawingToggles_offRemovesRasters() throws Exception { void drawingToggles_offRemovesRasters() throws Exception {
Path pdf = convertPdf(sampleBytes("charts-smartart.docx"), "charts-smartart", Path pdf = convertPdf(sampleBytes("charts-smartart.docx"), "charts-smartart",
new ConvertOptions(false, false, new ConvertOptions(false, false, false, false,
WordPdfSettings.MAX_INPUT_BYTES, WordPdfSettings.MAX_PAGES)); WordPdfSettings.MAX_INPUT_BYTES, WordPdfSettings.MAX_PAGES));
String text = norm(pdfText(pdf)); String text = norm(pdfText(pdf));
@@ -172,7 +172,7 @@ class WordPdfConverterTest {
@Test @Test
void drawingToggles_chartsOffSmartArtOn() throws Exception { void drawingToggles_chartsOffSmartArtOn() throws Exception {
Path pdf = convertPdf(sampleBytes("charts-smartart.docx"), "charts-smartart", Path pdf = convertPdf(sampleBytes("charts-smartart.docx"), "charts-smartart",
new ConvertOptions(false, true, new ConvertOptions(false, true, false, false,
WordPdfSettings.MAX_INPUT_BYTES, WordPdfSettings.MAX_PAGES)); WordPdfSettings.MAX_INPUT_BYTES, WordPdfSettings.MAX_PAGES));
String text = norm(pdfText(pdf)); String text = norm(pdfText(pdf));
@@ -181,6 +181,58 @@ class WordPdfConverterTest {
"от SmartArt должны остаться только его растры"); "от SmartArt должны остаться только его растры");
} }
/**
* Error-флаг при выключенном render-флаге: находка диаграмм —
* {@link DrawingFoundException} с {@code Kind.CHARTS}; SmartArt в этом
* вызове рендерится (render-флаг включён → error-флаг к нему не применяется),
* поэтому бросается именно целевой Kind независимо от порядка обхода.
*/
@Test
void drawingErrors_errorFlagRejectsCharts() throws Exception {
ConversionException ex = assertThrows(ConversionException.class, () ->
convertPdf(sampleBytes("charts-smartart.docx"), "charts-smartart",
new ConvertOptions(false, true, true, false,
WordPdfSettings.MAX_INPUT_BYTES, WordPdfSettings.MAX_PAGES)));
assertTrue(ex instanceof DrawingFoundException dfe
&& dfe.kind() == DrawingFoundException.Kind.CHARTS,
"ожидался DrawingFoundException(CHARTS), получено: " + ex);
assertTrue(ex.getMessage().contains("диаграмм"),
"сообщение должно упоминать диаграммы: " + ex.getMessage());
}
/**
* Зеркальный случай: error-флаг SmartArt при выключенном его рендере —
* {@code Kind.SMARTART}; диаграммы рендерятся.
*/
@Test
void drawingErrors_errorFlagRejectsSmartArt() throws Exception {
ConversionException ex = assertThrows(ConversionException.class, () ->
convertPdf(sampleBytes("charts-smartart.docx"), "charts-smartart",
new ConvertOptions(true, false, false, true,
WordPdfSettings.MAX_INPUT_BYTES, WordPdfSettings.MAX_PAGES)));
assertTrue(ex instanceof DrawingFoundException dfe
&& dfe.kind() == DrawingFoundException.Kind.SMARTART,
"ожидался DrawingFoundException(SMARTART), получено: " + ex);
assertTrue(ex.getMessage().contains("SmartArt"),
"сообщение должно упоминать SmartArt: " + ex.getMessage());
}
/**
* render-флаг приоритетнее error-флага: оба включены — конвертация
* проходит, все 4 растра фикстуры на месте.
*/
@Test
void drawingErrors_renderFlagWins() throws Exception {
Path pdf = convertPdf(sampleBytes("charts-smartart.docx"), "charts-smartart",
new ConvertOptions(true, true, true, true,
WordPdfSettings.MAX_INPUT_BYTES, WordPdfSettings.MAX_PAGES));
assertTrue(imageCount(pdf) >= 4,
"рендер должен победить error-флаг, найдено растров: " + imageCount(pdf));
}
/** /**
* Маркеры списков из символьных шрифтов (Symbol/Wingdings, коды из * Маркеры списков из символьных шрифтов (Symbol/Wingdings, коды из
* PUA U+F0xx) экспорт в FO не понимает и рисует .notdef — решётку «#». * PUA U+F0xx) экспорт в FO не понимает и рисует .notdef — решётку «#».
@@ -405,7 +457,7 @@ class WordPdfConverterTest {
void limitsOverriddenByOptions() throws Exception { void limitsOverriddenByOptions() throws Exception {
ConversionException ex = assertThrows(ConversionException.class, () -> ConversionException ex = assertThrows(ConversionException.class, () ->
WordPdfConverter.convert(sampleBytes("ru-plain.docx"), "x", WordPdfConverter.convert(sampleBytes("ru-plain.docx"), "x",
new ConvertOptions(true, true, 1000, WordPdfSettings.MAX_PAGES))); new ConvertOptions(true, true, false, false, 1000, WordPdfSettings.MAX_PAGES)));
assertTrue(ex.getMessage().contains("1000 байт"), assertTrue(ex.getMessage().contains("1000 байт"),
"сообщение должно упоминать переданный лимит: " + ex.getMessage()); "сообщение должно упоминать переданный лимит: " + ex.getMessage());
} }
@@ -420,7 +472,7 @@ class WordPdfConverterTest {
ConversionException ex = assertThrows(ConversionException.class, () -> ConversionException ex = assertThrows(ConversionException.class, () ->
WordPdfConverter.convert( WordPdfConverter.convert(
sampleBytes("too-many-pages.docx"), "too-many-pages", sampleBytes("too-many-pages.docx"), "too-many-pages",
new ConvertOptions(true, true, WordPdfSettings.MAX_INPUT_BYTES, 100))); new ConvertOptions(true, true, false, false, WordPdfSettings.MAX_INPUT_BYTES, 100)));
assertTrue(ex.getMessage().contains("100"), assertTrue(ex.getMessage().contains("100"),
"сообщение должно упоминать лимит: " + ex.getMessage()); "сообщение должно упоминать лимит: " + ex.getMessage());
} }
@@ -436,7 +488,7 @@ class WordPdfConverterTest {
void staleCachePageCountRejectedBeforeRender() { void staleCachePageCountRejectedBeforeRender() {
ConversionException ex = assertThrows(ConversionException.class, () -> ConversionException ex = assertThrows(ConversionException.class, () ->
WordPdfConverter.convert(sampleBytes("stale-cache.docx"), "stale-cache", WordPdfConverter.convert(sampleBytes("stale-cache.docx"), "stale-cache",
new ConvertOptions(true, true, WordPdfSettings.MAX_INPUT_BYTES, 100))); new ConvertOptions(true, true, false, false, WordPdfSettings.MAX_INPUT_BYTES, 100)));
assertTrue(ex.getMessage().contains("100"), assertTrue(ex.getMessage().contains("100"),
"сообщение должно упоминать лимит: " + ex.getMessage()); "сообщение должно упоминать лимит: " + ex.getMessage());
} }
+7 -3
View File
@@ -25,13 +25,15 @@ export interface ConvertResult {
export interface ConvertOptions { export interface ConvertOptions {
renderCharts: boolean renderCharts: boolean
renderSmartArt: boolean renderSmartArt: boolean
errorOnCharts: boolean
errorOnSmartArt: boolean
} }
/** /**
* Единственная сетевая точка приложения: POST /api/v1/convert (multipart, * Единственная сетевая точка приложения: POST /api/v1/convert (multipart,
* поля `file`, `renderCharts`, `renderSmartArt`) → PDF-blob + имя файла из * поля `file`, `renderCharts`, `renderSmartArt`, `errorOnCharts`,
* Content-Disposition. Таймаут на фронте не ставим: конвертация долгая — * `errorOnSmartArt`) → PDF-blob + имя файла из Content-Disposition.
* это ожидаемо. * Таймаут на фронте не ставим: конвертация долгая — это ожидаемо.
*/ */
export async function convertDocx( export async function convertDocx(
file: File, file: File,
@@ -42,6 +44,8 @@ export async function convertDocx(
fd.append('file', file, file.name) fd.append('file', file, file.name)
fd.append('renderCharts', String(options.renderCharts)) fd.append('renderCharts', String(options.renderCharts))
fd.append('renderSmartArt', String(options.renderSmartArt)) fd.append('renderSmartArt', String(options.renderSmartArt))
fd.append('errorOnCharts', String(options.errorOnCharts))
fd.append('errorOnSmartArt', String(options.errorOnSmartArt))
const key = getApiKey() const key = getApiKey()
const resp = await fetch(`${import.meta.env.BASE_URL}api/v1/convert`, { const resp = await fetch(`${import.meta.env.BASE_URL}api/v1/convert`, {
method: 'POST', method: 'POST',
+59 -9
View File
@@ -19,12 +19,34 @@ export default function App() {
const [status, setStatus] = useState<Status>('idle') const [status, setStatus] = useState<Status>('idle')
const [result, setResult] = useState<Result | null>(null) const [result, setResult] = useState<Result | null>(null)
const [error, setError] = useState<string | null>(null) const [error, setError] = useState<string | null>(null)
// дефолты = константы ядра (WordPdfSettings.RENDER_CHARTS/RENDER_SMARTART) // дефолты фронта: ошибка при находке включена, рендер выключен
const [renderCharts, setRenderCharts] = useState(true) // (галки одной сущности взаимоисключающие — вместе они несовместимы)
const [renderSmartArt, setRenderSmartArt] = useState(true) const [renderCharts, setRenderCharts] = useState(false)
const [errorOnCharts, setErrorOnCharts] = useState(true)
const [renderSmartArt, setRenderSmartArt] = useState(false)
const [errorOnSmartArt, setErrorOnSmartArt] = useState(true)
const abortRef = useRef<AbortController | null>(null) const abortRef = useRef<AbortController | null>(null)
const urlRef = useRef<string | null>(null) const urlRef = useRef<string | null>(null)
// включение одной галки сущности снимает другую; снятие — ни на что не
// влияет: все сняты → сущность молча выбрасывается (поведение ядра)
const toggleRenderCharts = (on: boolean) => {
setRenderCharts(on)
if (on) setErrorOnCharts(false)
}
const toggleErrorOnCharts = (on: boolean) => {
setErrorOnCharts(on)
if (on) setRenderCharts(false)
}
const toggleRenderSmartArt = (on: boolean) => {
setRenderSmartArt(on)
if (on) setErrorOnSmartArt(false)
}
const toggleErrorOnSmartArt = (on: boolean) => {
setErrorOnSmartArt(on)
if (on) setRenderSmartArt(false)
}
// ключ в localStorage: публичная статика, в бандл зашивать нельзя // ключ в localStorage: публичная статика, в бандл зашивать нельзя
const [apiKey, setApiKeyValue] = useState<string | null>(() => getApiKey()) const [apiKey, setApiKeyValue] = useState<string | null>(() => getApiKey())
const [keyError, setKeyError] = useState<string | null>(null) const [keyError, setKeyError] = useState<string | null>(null)
@@ -54,6 +76,8 @@ export default function App() {
convertDocx(file, ac.signal, { convertDocx(file, ac.signal, {
renderCharts, renderCharts,
renderSmartArt, renderSmartArt,
errorOnCharts,
errorOnSmartArt,
}) })
.then(({ blob, filename }) => { .then(({ blob, filename }) => {
const url = URL.createObjectURL(blob) const url = URL.createObjectURL(blob)
@@ -125,28 +149,54 @@ export default function App() {
<section className="rounded-2xl border border-border bg-surface p-6 shadow-sm"> <section className="rounded-2xl border border-border bg-surface p-6 shadow-sm">
<DropZone file={file} disabled={status === 'converting'} onSelect={selectFile} /> <DropZone file={file} disabled={status === 'converting'} onSelect={selectFile} />
<div className="mt-5 flex gap-6"> <div className="mt-5 flex flex-col gap-3">
<div className="flex flex-wrap items-center gap-x-6 gap-y-2">
<span className="w-24 text-sm font-medium">Диаграммы</span>
<label className="flex items-center gap-2 text-sm"> <label className="flex items-center gap-2 text-sm">
<input <input
type="checkbox" type="checkbox"
className="h-4 w-4 accent-accent" className="h-4 w-4 accent-accent"
checked={renderCharts} checked={renderCharts}
onChange={(e) => setRenderCharts(e.target.checked)}
disabled={status === 'converting'} disabled={status === 'converting'}
onChange={(e) => toggleRenderCharts(e.target.checked)}
/> />
Диаграммы конвертировать
</label> </label>
<label className="flex items-center gap-2 text-sm"> <label className="flex items-center gap-2 text-sm">
<input <input
type="checkbox" type="checkbox"
className="h-4 w-4 accent-accent" className="h-4 w-4 accent-accent"
checked={renderSmartArt} checked={errorOnCharts}
onChange={(e) => setRenderSmartArt(e.target.checked)}
disabled={status === 'converting'} disabled={status === 'converting'}
onChange={(e) => toggleErrorOnCharts(e.target.checked)}
/> />
SmartArt ошибка, если найдены
</label> </label>
</div> </div>
<div className="flex flex-wrap items-center gap-x-6 gap-y-2">
<span className="w-24 text-sm font-medium">SmartArt</span>
<label className="flex items-center gap-2 text-sm">
<input
type="checkbox"
className="h-4 w-4 accent-accent"
checked={renderSmartArt}
disabled={status === 'converting'}
onChange={(e) => toggleRenderSmartArt(e.target.checked)}
/>
конвертировать
</label>
<label className="flex items-center gap-2 text-sm">
<input
type="checkbox"
className="h-4 w-4 accent-accent"
checked={errorOnSmartArt}
disabled={status === 'converting'}
onChange={(e) => toggleErrorOnSmartArt(e.target.checked)}
/>
ошибка, если найден
</label>
</div>
</div>
<div className="mt-5"> <div className="mt-5">
<button <button