feat: errorOnCharts/errorOnSmartArt — отказ конвертации при находке диаграмм/SmartArt
This commit is contained in:
@@ -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() {
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
+16
-1
@@ -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());
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -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',
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
Reference in New Issue
Block a user