OLE-объекты: переключатель errorOnOle + тихое удаление из docx
docx4j падает на внедрённых OLE-объектах двумя путями: JAXB-парсинг бинарника под ложным XML-типом в [Content_Types] («Content is not allowed in prolog» → NPE) и NPE chunkType is null в VML-сериализации w:object. Новый OleObjectNormalizer (шестой в цепочке, после GlyphCoverageNormalizer) удаляет OLE-bin-части, rels-ссылки, элементы w:object и Override удалённых частей; при errorOnOle=true вместо удаления — DrawingFoundException(OLE) → 422 «Конвертация отменена: в документе найдены OLE-объекты». - ядро: Kind.OLE, ConvertOptions.errorOnOle, WordPdfSettings.ERROR_ON_OLE, фикстура samples/ole-embedded.docx (ручная, оба механизма) - app: параметр errorOnOle, 422-контракт, тесты errorFlagOle_rejected / oleObjects_removedByDefault - SPA: третий переключатель «OLE-объекты» - прод-автотесты: +2 проверки (21) - регрессии: OleObjectNormalizerTest ↔ oleObjects_removedAndConverted / drawingErrors_errorFlagRejectsOle; E2E: notConverted.docx 500 → 200
This commit is contained in:
@@ -36,7 +36,7 @@ final class ApiExceptionHandler {
|
||||
return ResponseEntity.badRequest().body(new ApiError(e.getMessage()));
|
||||
}
|
||||
|
||||
/** Документ содержит диаграммы/SmartArt при включённом error-флаге — вход корректен, но отвергнут по настройке. */
|
||||
/** Документ содержит диаграммы/SmartArt/OLE-объекты при включённом error-флаге — вход корректен, но отвергнут по настройке. */
|
||||
@ExceptionHandler(DrawingRejectedException.class)
|
||||
ResponseEntity<ApiError> drawingRejected(DrawingRejectedException e) {
|
||||
return ResponseEntity.status(HttpStatus.UNPROCESSABLE_ENTITY)
|
||||
|
||||
@@ -59,9 +59,9 @@ final class ConvertController {
|
||||
}
|
||||
|
||||
@Operation(summary = "Конвертировать .docx в PDF",
|
||||
description = "errorOnCharts/errorOnSmartArt — факультативно, по умолчанию "
|
||||
description = "errorOnCharts/errorOnSmartArt/errorOnOle — факультативно, по умолчанию "
|
||||
+ "настройки ядра (ошибка не выбрасывается); диаграммы/SmartArt "
|
||||
+ "конвертируются всегда. "
|
||||
+ "конвертируются всегда, OLE-объекты при выключенном флаге тихо удаляются. "
|
||||
+ "Лимиты входа (размер/страницы) задаёт только конфигурация сервера "
|
||||
+ "(свойства wordpdf.max-mb/wordpdf.max-pages), параметрами запроса не переопределяются")
|
||||
@SecurityRequirement(name = OpenApiConfig.SCHEME)
|
||||
@@ -72,7 +72,8 @@ final class ConvertController {
|
||||
ResponseEntity<byte[]> convert(
|
||||
@RequestParam("file") MultipartFile file,
|
||||
@RequestParam(name = "errorOnCharts", required = false) Boolean errorOnCharts,
|
||||
@RequestParam(name = "errorOnSmartArt", required = false) Boolean errorOnSmartArt) {
|
||||
@RequestParam(name = "errorOnSmartArt", required = false) Boolean errorOnSmartArt,
|
||||
@RequestParam(name = "errorOnOle", required = false) Boolean errorOnOle) {
|
||||
if (file == null || file.isEmpty()) {
|
||||
throw new ValidationException("Файл не передан (multipart-поле «file» обязательно)");
|
||||
}
|
||||
@@ -90,6 +91,7 @@ final class ConvertController {
|
||||
ConvertOptions options = new ConvertOptions(
|
||||
errorOnCharts != null ? errorOnCharts : WordPdfSettings.ERROR_ON_CHARTS,
|
||||
errorOnSmartArt != null ? errorOnSmartArt : WordPdfSettings.ERROR_ON_SMARTART,
|
||||
errorOnOle != null ? errorOnOle : WordPdfSettings.ERROR_ON_OLE,
|
||||
maxMb, maxPages);
|
||||
byte[] pdf = conversionService.convert(docxBytes, name, options);
|
||||
ContentDisposition disposition = ContentDisposition.attachment()
|
||||
|
||||
@@ -3,7 +3,7 @@ package ru.pjandro.wordpdf.app;
|
||||
import ru.pjandro.wordpdf.DrawingFoundException;
|
||||
|
||||
/**
|
||||
* Документ содержит диаграммы/SmartArt при включённом error-флаге
|
||||
* Документ содержит диаграммы/SmartArt/OLE-объекты при включённом error-флаге
|
||||
* ({@link DrawingFoundException} ядра).
|
||||
*
|
||||
* <p>Маппится в HTTP 422 ({@link ApiExceptionHandler}); клиенту осмысленно
|
||||
@@ -13,8 +13,10 @@ import ru.pjandro.wordpdf.DrawingFoundException;
|
||||
class DrawingRejectedException extends RuntimeException {
|
||||
|
||||
DrawingRejectedException(DrawingFoundException.Kind kind) {
|
||||
super(kind == DrawingFoundException.Kind.CHARTS
|
||||
? "Конвертация отменена: в документе найдены диаграммы"
|
||||
: "Конвертация отменена: в документе найден SmartArt");
|
||||
super(switch (kind) {
|
||||
case CHARTS -> "Конвертация отменена: в документе найдены диаграммы";
|
||||
case SMARTART -> "Конвертация отменена: в документе найден SmartArt";
|
||||
case OLE -> "Конвертация отменена: в документе найдены OLE-объекты";
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
@@ -201,6 +201,38 @@ class ConvertControllerTest {
|
||||
org.hamcrest.Matchers.containsString("SmartArt")));
|
||||
}
|
||||
|
||||
/**
|
||||
* errorOnOle=true — HTTP 422 с текстом про OLE-объекты (документ валиден,
|
||||
* отвергнут по настройке запроса).
|
||||
* Регрессия — WordPdfConverterTest#drawingErrors_errorFlagRejectsOle,
|
||||
* фикстура samples/ole-embedded.docx.
|
||||
*/
|
||||
@Test
|
||||
void errorFlagOle_rejected() throws Exception {
|
||||
mockMvc.perform(multipart("/api/v1/convert")
|
||||
.file(docx("ole-embedded.docx", bytes("/samples/ole-embedded.docx")))
|
||||
.param("errorOnOle", "true"))
|
||||
.andExpect(status().isUnprocessableEntity())
|
||||
.andExpect(jsonPath("$.error",
|
||||
org.hamcrest.Matchers.containsString("OLE-объект")));
|
||||
}
|
||||
|
||||
/**
|
||||
* Без параметров OLE-объекты тихо удаляются: 200, PDF.
|
||||
* Регрессия — WordPdfConverterTest#oleObjects_removedAndConverted,
|
||||
* фикстура samples/ole-embedded.docx.
|
||||
*/
|
||||
@Test
|
||||
void oleObjects_removedByDefault() throws Exception {
|
||||
byte[] pdf = mockMvc.perform(multipart("/api/v1/convert")
|
||||
.file(docx("ole-embedded.docx", bytes("/samples/ole-embedded.docx"))))
|
||||
.andExpect(status().isOk())
|
||||
.andExpect(content().contentType(MediaType.APPLICATION_PDF))
|
||||
.andReturn().getResponse().getContentAsByteArray();
|
||||
assertTrue("%PDF".equals(new String(pdf, 0, 4, StandardCharsets.US_ASCII)),
|
||||
"тело не начинается с %PDF");
|
||||
}
|
||||
|
||||
@Test
|
||||
void cyrillicAndPathInFilename_sanitizedResponseName() throws Exception {
|
||||
byte[] sample = bytes("/samples/ru-plain.docx");
|
||||
|
||||
Reference in New Issue
Block a user