diff --git a/.gitea/workflows/main.yml b/.gitea/workflows/main.yml index 0fcfb82..087adbf 100644 --- a/.gitea/workflows/main.yml +++ b/.gitea/workflows/main.yml @@ -262,9 +262,9 @@ jobs: # не крушит стек бесконечным crash-loop. Синтаксис on-failure:N podman # переваривает и применяет (проверено: maxtries=N, после исчерпания exited). restart: on-failure:5 - # heap вписан в лимит (-XX:MaxRAMPercentage=70 в ENTRYPOINT образа); - # паритет с repo compose.yml - mem_limit: 2g + # фиксированный heap -Xms2g -Xmx2g в ENTRYPOINT образа, лимит 3g — + # запас под metaspace/потоки/native; паритет с repo compose.yml + mem_limit: 3g # healthcheck дублируется в compose, а не только в Containerfile: podman # выгружает образы в OCI, где HEALTHCHECK теряется, а gateway в depends_on # ждал бы healthy вечно. wget, не curl: alpine-jre образ curl не содержит. diff --git a/AGENTS.md b/AGENTS.md index 6044661..1abe1b7 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -35,7 +35,7 @@ - **Коды**: 400 — `ValidationException`/`BadRequestException`/битые параметры; 401 — `ApiKeyFilter`; 404/405/415 — путь/метод/content-type; 413 — multipart; **422** — `DrawingRejectedException` (core-`DrawingFoundException`, `Kind {CHARTS, SMARTART, OLE}`); 500/503/504 — `ConversionFailedException`/`ConversionRejectedException`/`ConversionTimeoutException`. Полная карта — `docs/agent/repo-map.md`. - **Текст 422** — контракт с фронтом: «Конвертация отменена: в документе найдены диаграммы/найден SmartArt/найдены OLE-объекты». - **Ключ**: `X-API-Key` ↔ `wordpdf.api-key` (пустое = выключено); без ключа открыты только `OPEN_PREFIXES` (`/actuator/`, `/swagger-ui`, `/v3/api-docs`), пути с точечными сегментами — никогда. -- **Очередь и лимиты**: конвертации сериализованы однопоточным `ThreadPoolExecutor` (`QUEUE_CAPACITY = 16`, переполнение → 503) — ядро не потокобезопасно; головой очереди на старте стоит `warmup()`. Лимиты входа — только конфигурация сервера (`wordpdf.max-mb`/`max-pages`, дефолты из `WordPdfSettings`; ≤ 0 → `IllegalStateException`; параметрами запроса не переопределяются). +- **Очередь и лимиты**: конвертации сериализованы однопоточным `ThreadPoolExecutor` (`QUEUE_CAPACITY = 16`, переполнение → 503): ядро дополнительно сериализует конвертации монитором `WordPdfConverter.class` (`convert()` безопасен из нескольких потоков); головой очереди на старте стоит `warmup()`. Лимиты входа — только конфигурация сервера (`wordpdf.max-mb`/`max-pages`, дефолты из `WordPdfSettings`; ≤ 0 → `IllegalStateException`; параметрами запроса не переопределяются). - **SPA**: вся сеть в `wordpdf-web/src/api.ts`; ключ в `localStorage` (`wordpdf.api.key`); `ApiKeyGate` — только если `probeApiKey()` подтвердил требование ключа (признак открытого сервера — **405**); base — `VITE_BASE`; DropZone `.docx,.doc`. ## Chart/SmartArt-движок (`internal/chart`, 18 классов) @@ -51,8 +51,8 @@ Java2D → PNG: `ChartRenderer.DPI = 300`, потолок `MAX_PIXELS = 16_777_2 - Единственный XSL-FO-стилист — вендорный `xslt/docx2fo.xslt` (копия из docx4j-export-fo 17.3.2 + два AUDIT-FIX-патча: `w:rPr/w:position` → `baseline-shift`, Part 1 §17.3.2.24; AUDIT-FIX-2 — `w:moveFrom`/`w:moveTo`/`w:bdo`/`w:dir`, иначе их ловит catch-all `match="*"` и текст теряется). Дрейф-гейт `vendoredXsltTracksJarCopy`: вне AUDIT-FIX-регионов копия побайтно равна стилю из jar'а. `setCustomXsltTemplates` принимает предкомпилированный `Templates`. - `slf4j-simple` обязателен в ядре: без SLF4J-провайдера docx4j пишет «TO HIDE THESE MESSAGES» прямо в PDF (регрессия `noLoggingWarningInPdf`); приложение исключает его — логи ведёт logback. - FOP — форк `org.docx4j:docx4j-fo-renderer*` 2.11-docx4j.6 (транзитив от `docx4j-export-fo`, в pom не пинится; пакеты `org.apache.fop.*`). `FopFallbackFonts` берёт `w:renderer` с mime `application/pdf`, иначе первый со шрифтами. -- `BundledFonts.init()` идемпотентен и `synchronized`, распаковывает TTF в `wordpdf-fonts-*` (`deleteOnExit`); `dropNonBundled()` чистит `PhysicalFonts` от всего, что вне бандла. -- `PhysicalFonts` — глобальный и мутируемый → ядро не потокобезопасно; приложение сериализует конвертации одним воркером; `warmup()` идёт тем же потоком. +- `BundledFonts.init()` идемпотентен и `synchronized`, распаковывает TTF в `wordpdf-fonts-*` (`deleteOnExit`); `dropNonBundled()` чистит `PhysicalFonts` от всего, что вне бандла; `font()`/`regular()`/... синхронизированы с `init()` (реестр `VARIANTS`). Внешние `init()`/`restrictToBundled()` во время идущих конвертаций — только под монитором `WordPdfConverter.class`. +- `PhysicalFonts` — глобальный и мутируемый → конвертации сериализуются монитором `WordPdfConverter.class` внутри ядра (общая `FopFactory` и сброс её image-кешей — под тем же монитором); приложение держит однопоточный воркер ради 503/timeout; `warmup()` идёт тем же потоком. - Страницы в валидаторе = `max(кэш docProps/app.xml, явные разрывы, lastRenderedPageBreak+1)`; правила StAX-подсчёта — `docs/agent/pipeline.md`. - Не чинить: `jc="distribute"`, `suff="tab"`/`lvlJc`, метрика «single», кернинг, `framePr`, `REF`/`SEQ`/`TOC`-кэш, руби-надстрочница, U+2188/U+218A — доказательства в `docs/agent/render-limitations.md`. - Комментарии в `WordPdfConverter`/`DocxOnOffNormalizer` говорят «docx4j 11.x» — устаревшее число, фактически 17.3.2 (описанное поведение верно). diff --git a/Containerfile b/Containerfile index f1ccb39..a670c17 100644 --- a/Containerfile +++ b/Containerfile @@ -37,5 +37,5 @@ USER app EXPOSE 8080 HEALTHCHECK --interval=10s --timeout=3s --start-period=10s --retries=5 \ CMD HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1:8080/actuator/health || exit 1 -ENTRYPOINT ["java", "-Djava.awt.headless=true", "-XX:MaxRAMPercentage=70", "-jar", "/app/app.jar"] +ENTRYPOINT ["java", "-Djava.awt.headless=true", "-Xms2g", "-Xmx2g", "-jar", "/app/app.jar"] diff --git a/compose.dev.yml b/compose.dev.yml index 338253c..2b411f0 100644 --- a/compose.dev.yml +++ b/compose.dev.yml @@ -15,8 +15,9 @@ services: app: build: . restart: unless-stopped - # Паритет с compose.yml: heap вписан в лимит (-XX:MaxRAMPercentage=70). - mem_limit: 2g + # Паритет с compose.yml: фиксированный heap -Xms2g -Xmx2g в ENTRYPOINT, + # лимит 3g — запас под metaspace/потоки/native. + mem_limit: 3g # Дублирует HEALTHCHECK из Containerfile: podman выгружает образы в OCI, # где поля healthcheck нет — без явного healthcheck depends_on # service_healthy ждал бы healthy вечно. Прокси обнуляем на команде. diff --git a/compose.yml b/compose.yml index 27337e3..472fc29 100644 --- a/compose.yml +++ b/compose.yml @@ -7,9 +7,10 @@ services: app: build: . restart: unless-stopped - # Heap вписываем в лимит контейнера (-XX:MaxRAMPercentage=70 в ENTRYPOINT); - # вход 16×5 МБ очередь + FOP-рендер в 2 ГБ помещаются. - mem_limit: 2g + # Фиксированный heap -Xms2g -Xmx2g в ENTRYPOINT образа; лимит 3g — запас + # под metaspace/потоки/native. Вход 16×5 МБ + FOP-рендер в 2 ГБ heap + # помещаются. + mem_limit: 3g # Дублирует HEALTHCHECK из Containerfile: podman выгружает образы в OCI, # где поля healthcheck нет — без явного healthcheck depends_on # service_healthy ждал бы healthy вечно. Прокси обнуляем на команде. diff --git a/docs/agent/repo-map.md b/docs/agent/repo-map.md index 60a21f9..05134f8 100644 --- a/docs/agent/repo-map.md +++ b/docs/agent/repo-map.md @@ -15,7 +15,7 @@ | `wordpdf-core/src/test/resources/geom/` | `presetShapeDefinitions.xml` — копия приложения ECMA-376, синхрон таблицы `PresetGeometry` (только в тестах, в jar не попадает) | | `wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/` | REST API (11 классов): `WordPdfApplication` (единственный public), `ConvertController`, `ConversionService` (очередь), `ApiExceptionHandler`, `ApiKeyFilter`, `OpenApiConfig` (`@SecurityScheme` X-API-Key) + 5 классов исключений (`BadRequest`, `DrawingRejected`, `ConversionFailed`, `ConversionRejected`, `ConversionTimeout`) | | `wordpdf-web/src/` | SPA: `api.ts` (вся сеть), `components/` (App, ApiKeyGate, PdfPreview, StatusMessage, DropZone, Logo) | -| корневые `Containerfile`, `compose.yml`, `compose.dev.yml`, `gateway/nginx.conf` | Образ бэкенда (multi-stage `maven:3.9-eclipse-temurin-17` → `eclipse-temurin:17-jre-alpine`, non-root uid 10001, `-XX:MaxRAMPercentage=70`, HEALTHCHECK — busybox `wget`); compose app+web+gateway (`mem_limit: 2g` app, подсеть `10.113.0.0/24` gw `10.113.0.1`, `x-podman.name_separator_compat`); прод-compose не в репо — его рендерит job `deploy`; в репо-`compose.yml` springdoc выключен env (`SPRINGDOC_API_DOCS_ENABLED=false`, `SPRINGDOC_SWAGGER_UI_ENABLED=false`), в `compose.dev.yml` springdoc-переменных нет вовсе — включён по умолчанию (не отключается). `wordpdf-web/Containerfile` — `node:24-alpine` → `nginx:alpine`, `ARG VITE_BASE=/` (прод-CI печёт `/pdf-converter/`); репозиторный `wordpdf-web/nginx.conf` в образ **не** копируется (SPA одностраничная, без клиентского роутинга — SPA-fallback не нужен) | +| корневые `Containerfile`, `compose.yml`, `compose.dev.yml`, `gateway/nginx.conf` | Образ бэкенда (multi-stage `maven:3.9-eclipse-temurin-17` → `eclipse-temurin:17-jre-alpine`, non-root uid 10001, фиксированный heap `-Xms2g -Xmx2g`, HEALTHCHECK — busybox `wget`); compose app+web+gateway (`mem_limit: 3g` app, подсеть `10.113.0.0/24` gw `10.113.0.1`, `x-podman.name_separator_compat`); прод-compose не в репо — его рендерит job `deploy`; в репо-`compose.yml` springdoc выключен env (`SPRINGDOC_API_DOCS_ENABLED=false`, `SPRINGDOC_SWAGGER_UI_ENABLED=false`), в `compose.dev.yml` springdoc-переменных нет вовсе — включён по умолчанию (не отключается). `wordpdf-web/Containerfile` — `node:24-alpine` → `nginx:alpine`, `ARG VITE_BASE=/` (прод-CI печёт `/pdf-converter/`); репозиторный `wordpdf-web/nginx.conf` в образ **не** копируется (SPA одностраничная, без клиентского роутинга — SPA-fallback не нужен) | | `.env.example` | Шаблон env: `WORDPDF_API_KEY` (`openssl rand -hex 32`), закомментированные `WORDPDF_MAX_MB`/`WORDPDF_MAX_PAGES` (пустое значение ломает binding long/int). Проду `.env` не нужен — ключ и лимиты подаёт job `deploy` из Gitea Secrets/Variables | | `.gitea/workflows/` | Gitea Actions: `pr.yml` (`PR checks`), `main.yml` (тесты + coverage-сводка и комментарий в PR → `images-app`/`images-web` (build+push в Nexus) → deploy (рендер прод-конфигов + pull) → autotests → rollback) | | `GITEA-vars.md` | Инструкция владельца: Secrets/Variables, защита ветки, перезапуск — только имена переменных, без значений | @@ -95,7 +95,7 @@ unzip -p ~/.m2/repository/org/docx4j/docx4j-export-fo/<версия>/docx4j-expo | 504 | `ConversionTimeoutException` | - **Ключ доступа**: `ApiKeyFilter` сверяет заголовок `X-API-Key` (`ApiKeyFilter.HEADER`) со свойством `wordpdf.api-key` (env `WORDPDF_API_KEY`, сравнение `MessageDigest.isEqual`). Пустое свойство = аутентификация выключена (dev `java -jar`, тесты). Без ключа открыты `OPEN_PREFIXES` = `/actuator/`, `/swagger-ui`, `/v3/api-docs` — матч по пути **без** forwarded-contextPath (`getRequestURI()` минус `getContextPath()`; иначе под `X-Forwarded-Prefix` HEALTHCHECK получил бы 401). Пути с точечными сегментами (`..`/`%2e`) открытыми не считаются никогда. -- **Очередь**: конвертации сериализованы однопоточным `ThreadPoolExecutor` (`ConversionService.QUEUE_CAPACITY = 16`, переполнение → 503): ядро мутирует глобальный реестр `PhysicalFonts` и **не потокобезопасно**. Головой очереди конструктор ставит `WordPdfConverter.warmup()` — прогрев ядра минимальным in-code docx + растром (~1,5–2,5 с, Future никто не забирает, warmup не бросает): первый реальный запрос после деплоя — за прогретым ядром (замер 2026-11: 0,13 с против 1,74 с на `main`), запросы периода прогрева ждут в очереди штатно. `future.cancel(true)` при таймауте не останавливает FOP мгновенно — осознанный компромисс. +- **Очередь**: конвертации сериализованы однопоточным `ThreadPoolExecutor` (`ConversionService.QUEUE_CAPACITY = 16`, переполнение → 503): ядро мутирует глобальный реестр `PhysicalFonts` и **сериализует конвертации монитором класса `WordPdfConverter.class`**; однопоточность воркера — ради 503/timeout. Головой очереди конструктор ставит `WordPdfConverter.warmup()` — прогрев ядра минимальным in-code docx + растром (~1,5–2,5 с, Future никто не забирает, warmup не бросает): первый реальный запрос после деплоя — за прогретым ядром (замер 2026-11: 0,13 с против 1,74 с на `main`), запросы периода прогрева ждут в очереди штатно. `future.cancel(true)` при таймауте не останавливает FOP мгновенно — осознанный компромисс. - **Лимиты входа** задаёт только конфигурация сервера: `wordpdf.max-mb`/`wordpdf.max-pages` (env `WORDPDF_MAX_MB`/`WORDPDF_MAX_PAGES`), `@Value` в `ConvertController` с дефолтом-SpEL из `WordPdfSettings` (5 МБ / 100); значение ≤ 0 → `IllegalStateException` на старте; параметрами запроса не переопределяются. Ключи в `application.properties` **не объявлены** — пустое значение затенит SpEL-дефолт. - **SPA**: вся сеть в `wordpdf-web/src/api.ts` (компоненты `fetch` не вызывают); ключ в `localStorage` (`wordpdf.api.key`), при 401 очищается, экран `ApiKeyGate` (`UnauthorizedError` — наследник `ApiError`, проверяется раньше); гейт показывается только когда `probeApiKey()` (GET /api/v1/convert → 401) подтвердил требование ключа. Запросы на `${import.meta.env.BASE_URL}api/...` (vite `base` из `VITE_BASE`, дефолт `/`) — CORS не нужен (dev: vite-proxy → :8080; prod: nginx под префиксом `/pdf-converter/`). Три переключателя error-флагов в форме («Диаграммы», «SmartArt», «OLE-объекты», дефолт — все выключены). DropZone принимает `.docx,.doc` (`accept` + текст зоны). diff --git a/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ConversionService.java b/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ConversionService.java index d49b7d8..3be8a3a 100644 --- a/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ConversionService.java +++ b/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ConversionService.java @@ -23,13 +23,13 @@ import java.util.concurrent.TimeoutException; /** * Конвертация .docx-байтов в PDF-байты поверх {@code wordpdf-core}. * - *

Конвертации СЕРИАЛИЗОВАНЫ однопоточным executor'ом — не «на всякий - * случай»: каждая конвертация мутирует ГЛОБАЛЬНЫЙ реестр шрифтов docx4j - * ({@code new BundledFontMapper()} заново добавляет системные шрифты - * в {@code PhysicalFonts}, {@code BundledFonts.init()/restrictToBundled()} - * их вычищают — WordPdfConverter.convertToStream, шаг 1 пайплайна). Параллельные конвертации - * вырывают реестр друг у друга из-под рендера, ядро не потокобезопасно - * by design. Регрессия — ConvertControllerTest#concurrentRequests_bothSucceed.

+ *

Конвертации СЕРИАЛИЗОВАНЫ однопоточным executor'ом: он держит очередь, + * 503 при переполнении и timeout-семантику (backpressure). Само ядро при этом + * сериализует конвертации внутренним монитором ({@code WordPdfConverter.class}: + * глобальный реестр {@code PhysicalFonts}, общая FopFactory с имиджевыми + * кешами и их сброс в finally мутируются под рендером), так что параллельные + * вызовы ядра не приводят к порче вывода. + * Регрессия — ConvertControllerTest#concurrentRequests_bothSucceed.

* *

Ошибки разделены по смыслу (требование к API): некорректный вход → * {@link ValidationException} (400), ошибка рендер-стадии → @@ -55,8 +55,9 @@ final class ConversionService { new ArrayBlockingQueue<>(QUEUE_CAPACITY)); // Прогрев ядра — головой той же однопоточной очереди: первый реальный // запрос после деплоя становится за прогретым ядром (~50–300 мс вместо - // 1,4–1,9 с) и гарантированно сериализован с конвертациями (ядро не - // потокобезопасно). warmup() не бросает — Future никто не забирает; + // 1,4–1,9 с); сериализация прогрева с конвертациями — тем же воркером + // и монитором ядра (warmup() синхронизирован им же). warmup() не + // бросает — Future никто не забирает; // запросы, пришедшие во время прогрева, ждут в очереди (штатная // семантика, лимит convert-timeout с запасом). this.workers.submit(WordPdfConverter::warmup); diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java index 5dc60b3..0f4bf33 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java @@ -2,7 +2,8 @@ package ru.pjandro.wordpdf; import org.apache.fop.apps.FOUserAgent; import org.apache.fop.apps.FopFactory; -import org.apache.fop.apps.FopFactoryBuilder; +import org.apache.fop.util.ImageObjectCache; +import org.apache.fop.util.ImageObjectCacheImpl; import org.docx4j.Docx4J; import org.docx4j.XmlUtils; import org.docx4j.Docx4jProperties; @@ -54,9 +55,13 @@ import java.util.zip.ZipOutputStream; * подменяются метрически совместимыми open-source аналогами * (см. {@link BundledFontMapper}). * - * Класс stateless, все методы статические. Класс НЕ потокобезопасен: - * конвертации из нескольких потоков необходимо сериализовать (глобальный - * реестр {@code PhysicalFonts}, кэши шрифтов/покрытия). + * Класс stateless, все методы статические. Публичные {@code convert()} можно + * вызывать из нескольких потоков: сериализация обеспечена внутри ядра — + * конвертации выполняются по одной под монитором класса (глобальный реестр + * {@code PhysicalFonts}, общая FopFactory с имиджевыми кешами, сброс кеши в + * finally). {@link #warmup()} синхронизирован тем же монитором. + * {@link WordPdfValidator} stateless и выполняется до монитора — валидация + * параллельна и не блокируется. */ public final class WordPdfConverter { @@ -83,6 +88,60 @@ public final class WordPdfConverter { private WordPdfConverter() { } + private static volatile FopFactory sharedFopFactory; + + /** + * FopFactory, общая на JVM: разбор шрифтов форка (GPOS-таблицы, ~140k + * объектов) выполняется один раз, а не на каждую конвертацию. Фабрика + * хранит имиджевые кеши ({@code ImageManager#getCache()} и + * {@link ImageObjectCacheImpl}) c ключами {@code file:/tmp/…} — + * уникальными на каждую конвертацию (docx4j выкладывает медиа во временные + * файлы), поэтому кеш никогда не попадает и растёт на декодированный растр + * каждого изображения (замер 2026-11: ~1,5 ГБ живых byte[] после 30 + * конвертаций с картинками). Поэтому каждая конвертация обязана вызвать + * {@link #resetSharedImageCaches()} в finally. Вызывается только под локом + * конвертации (см. {@code convert}), сброс mid-render невозможен. + * Регрессия — WordPdfConverterTest#sharedImageCaches_clearedAfterConversion. + */ + static FopFactory sharedFopFactory(final FOSettings foSettings) { + FopFactory factory = sharedFopFactory; + if (factory == null) { + synchronized (WordPdfConverter.class) { + if (sharedFopFactory == null) { + try { + sharedFopFactory = FORendererApacheFOP.getFopFactoryBuilder(foSettings).build(); + } catch (org.apache.fop.apps.FOPException e) { + throw new ConversionException("Не удалось собрать FOP-фабрику", e); + } + } + factory = sharedFopFactory; + } + } + return factory; + } + + /** + * Сброс имиджевых кешей общей фабрики после конвертации. Без него форк + * удерживает растр каждого изображения документа до конца жизни JVM: + * записи лежат в soft-ссылках, которые сборщик не трогает, пока свободная + * куча велика (куча стенда фиксирована 2 ГБ). Сбросы публичные: + * {@code ImageCache.clearCache()} и {@code ImageObjectCacheImpl.clearCache()}. + * Вызывается исключительно из finally конвертации под локом (см. + * {@code convert}) — параллельный рендер под сброс не попадает. + * Регрессия — WordPdfConverterTest#sharedImageCaches_clearedAfterConversion. + */ + static void resetSharedImageCaches() { + FopFactory factory = sharedFopFactory; + if (factory == null) { + return; + } + factory.getImageManager().getCache().clearCache(); + ImageObjectCache imageObjects = factory.getImageObjectCache(); + if (imageObjects instanceof ImageObjectCacheImpl impl) { + impl.clearCache(); + } + } + /** * Конвертирует байты .docx (или бинарного .doc Word 97–2003 — формат * определяется по сигнатуре байтов) в PDF. Работа с файлами — забота @@ -152,18 +211,26 @@ public final class WordPdfConverter { // .doc сбрасываются в кадре на этом же месте — детерминированно, до // рендера (точные liveness-карты HotSpot строит только для // скомпилированных кадров; отдельное присваивание null не нужно). - docxBytes = WordPdfValidator.isBinaryDoc(docxBytes) ? DocToDocx.convert(docxBytes) : docxBytes; - ByteArrayOutputStream bos = new ByteArrayOutputStream(Math.max(1 << 16, docxBytes.length)); - try { - convertToStream(docxBytes, title, opts, bos); - } catch (ConversionException e) { - // ValidationException (отказ валидации входа) — подтип, уходит - // вызывающему без обёртки - throw e; - } catch (Exception e) { - throw new ConversionException("Не удалось конвертировать документ", e); + // Единый лок ядра: реестр PhysicalFonts, общая FopFactory (per-render + // disableFontCache, имиджевые кеши) и её сброс в finally мутируются под + // рендером — параллельная конвертация обязана ждать, иначе чистит кеши + // посреди чужого рендера. Монитор класса тот же, что у warmup() + // (реентельно) и DCL в sharedFopFactory. Регрессия — + // WordPdfConverterTest#concurrentConversions_twoThreadsBothSucceed. + synchronized (WordPdfConverter.class) { + docxBytes = WordPdfValidator.isBinaryDoc(docxBytes) ? DocToDocx.convert(docxBytes) : docxBytes; + ByteArrayOutputStream bos = new ByteArrayOutputStream(Math.max(1 << 16, docxBytes.length)); + try { + convertToStream(docxBytes, title, opts, bos); + } catch (ConversionException e) { + // ValidationException (отказ валидации входа) — подтип, уходит + // вызывающему без обёртки + throw e; + } catch (Exception e) { + throw new ConversionException("Не удалось конвертировать документ", e); + } + return bos.toByteArray(); } - return bos.toByteArray(); } /** Флаг «ядро прогрето»: повторные вызовы {@link #warmup()} — no-op. */ @@ -176,9 +243,11 @@ public final class WordPdfConverter { * (JAXB/XSLT/FOP/классы), её платил первый запрос после деплоя. Прогоняет * пайплайн на минимальном docx, собранном в байтах (фикстуры тестов не * задействуются), и греет Java2D/PNG-энкодер для пре-рендера диаграмм. - * Идемпотентен, никогда не бросает (провал — только warn); вызывать нужно - * на том же потоке, на котором сериализованы конвертации (ядро не - * потокобезопасно, см. {@code PhysicalFonts}). Артефакты (PDF, растр) + * Идемпотентен, никогда не бросает (провал — только warn); метод + * синхронизирован монитором класса — тем же, что сериализует конвертации + * в {@code convert()}, так что прогрев гарантированно не пересекается с + * рендером; приложение дополнительно держит warmup головой очереди. + * Артефакты (PDF, растр) * отбрасываются. Ядро само {@code warmup()} не вызывает — момент прогрева * решает вызывающее приложение. */ @@ -330,9 +399,10 @@ public final class WordPdfConverter { // используется. foSettings.setCustomXsltTemplates(VendoredXslt.TEMPLATES); - // 5. Метаданные PDF: заголовок — из параметра title - FopFactoryBuilder builder = FORendererApacheFOP.getFopFactoryBuilder(foSettings); - FopFactory fopFactory = builder.build(); + // 5. Метаданные PDF: заголовок — из параметра title. Фабрика — + // общая на JVM (см. sharedFopFactory); после конвертации её + // имиджевые кеши обязаны быть сброшены (шаг 7). + FopFactory fopFactory = sharedFopFactory(foSettings); FOUserAgent foUserAgent = FORendererApacheFOP.getFOUserAgent(foSettings, fopFactory); if (title != null && !title.isEmpty()) { foUserAgent.setTitle(title); @@ -341,11 +411,14 @@ public final class WordPdfConverter { // 6. Проход XSLT (медленнее, но полнее), вывод в поток Docx4J.toFO(foSettings, os, Docx4J.FLAG_EXPORT_PREFER_XSL); } finally { - // 7. Уборка временных файлов встроенных в docx шрифтов + // 7. Уборка временных файлов встроенных в docx шрифтов и сброс + // имиджевых кешей общей FopFactory (без него форк копит растр + // каждого изображения: ~1,5 ГБ на 30 конвертаций, 2026-11). if (pkg.getMainDocumentPart() != null && pkg.getMainDocumentPart().getFontTablePart() != null) { pkg.getMainDocumentPart().getFontTablePart().deleteEmbeddedFontTempFiles(); } + resetSharedImageCaches(); // Примечание: в docx4j 11.x OpcPackage.close() отсутствует — // пакет загружается в память и ничего не закрывает. } diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java index c8176be..d78e3df 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java @@ -188,6 +188,11 @@ public final class BundledFonts { * em-dash на шрифте ранa (Carlito) вместо fallback-DejaVu. * Шрифты, встроенные в docx, регистрируются при {@code load()} — * если чистить до load(), они останутся в реестре. + *

Мутирует глобальный реестр {@code PhysicalFonts}: нельзя звать + * параллельно идущей {@code WordPdfConverter.convert()} — рендер + * начнёт терять шрифты. Внешний вызов рядом с идущей конвертацией + * обязан держать монитор {@code WordPdfConverter.class} — тот же, + * что сериализует конвертации. */ public static synchronized void restrictToBundled() { if (!inited) { @@ -232,10 +237,13 @@ public final class BundledFonts { /** * Зарегистрированный шрифт: семейство (lowercase) + начертание. + * Синхронизирован с {@link #init()}: {@code VARIANTS} — обычный + * {@code HashMap}, наполняемый в {@code init()} под тем же монитором + * класса; без замка внешний читатель мог бы увидеть недобранную карту. * * @return PhysicalFont или null (если init() не вызван или шрифта нет) */ - public static PhysicalFont font(String family, String variant) { + public static synchronized PhysicalFont font(String family, String variant) { Map m = VARIANTS.get(family); return m == null ? null : m.get(variant); } diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/GlyphFont.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/GlyphFont.java index 30a2b07..91215b0 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/GlyphFont.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/GlyphFont.java @@ -38,6 +38,12 @@ import java.util.Map; * каталога {@link BundledFonts#init()} — поэтому класс не зависит от * порядка шагов конвертации. TTF буферизуется в памяти и живёт до конца * JVM (шрифты бандла конечны, {@link TrueTypeFont} намеренно не закрываем). + * + * Потокобезопасен: {@link #of(String, String)} идёт под монитором класса + * (единый {@code CACHE}), {@code cmap} — {@code volatile} поле с + * идемпотентным пересчётом, а ленивые таблицы fontbox читаются под её + * внутренними замками ({@code TrueTypeFont.lockReadtable}, fontbox 3.x) — + * один экземпляр можно держать в нескольких потоках. */ public final class GlyphFont { diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/OleObjectNormalizer.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/OleObjectNormalizer.java index c21dd76..c680301 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/OleObjectNormalizer.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/OleObjectNormalizer.java @@ -4,6 +4,7 @@ import ru.pjandro.wordpdf.DrawingFoundException; import java.io.ByteArrayOutputStream; import java.io.IOException; +import java.io.InputStream; import java.nio.charset.StandardCharsets; import java.util.ArrayList; import java.util.HashMap; @@ -135,9 +136,46 @@ public final class OleObjectNormalizer { private static final Logger LOG = Logger.getLogger(OleObjectNormalizer.class.getName()); + /** Детект `w:object` по байтам: ASCII-литерал в UTF-8 не может + * встретиться внутри многобайтовой последовательности, поэтому поиск + * по сырым байтам эквивалентен `new String(...).contains(...)`. */ + private static final byte[] OBJECT_NEEDLE = " 0) { + int limit = carried + read; + for (int i = 0; i + needle.length <= limit; i++) { + boolean hit = true; + for (int j = 0; j < needle.length; j++) { + if (window[i + j] != needle[j]) { + hit = false; + break; + } + } + if (hit) { + return true; + } + } + carried = Math.min(needle.length - 1, limit); + System.arraycopy(window, limit - carried, window, 0, carried); + } + return false; + } + } + /** * Вычистляет из docx OLE-объекты: бинарные `.bin`-части с OLE-типом (или * ложным XML-типом), ссылки на них и oleObject-ссылки (включая External) в @@ -183,8 +221,7 @@ public final class OleObjectNormalizer { oleParts.add(name); } } else if (!hasObjectMarkup && name.startsWith("word/") && name.endsWith(".xml") - && new String(zf.getInputStream(entry).readAllBytes(), - StandardCharsets.UTF_8).contains("= 24 && magic(bb, 0, PNG_SIGNATURE) && be32(bb, 12) == 0x49484452) { + width = be32(bb, 16); + height = be32(bb, 20); + // GIF: «GIF8», ширина/высота little-endian в 6/8 (le32-чтение + // с 8 идёт до байта 11 включительно). + } else if (len >= 12 && magic(bb, 0, GIF_SIGNATURE)) { + width = le32(bb, 6) & 0xFFFF; + height = le32(bb, 8) & 0xFFFF; + // BMP: «BM», ширина/высота BITMAPINFOHEADER little-endian в 18/22 + // (высота отрицательная для top-down — берём модуль). + } else if (len >= 26 && magic(bb, 0, BMP_SIGNATURE)) { + width = le32(bb, 18); + height = Math.abs(le32(bb, 22)); + } else { + return false; + } + if (width <= 0 || height <= 0) { + return false; + } + return widthPt <= 0 || heightPt <= 0 + || Math.max(width / (widthPt / 72d), height / (heightPt / 72d)) <= threshold; + } + + private static boolean magic(ByteBuffer bb, int at, int[] bytes) { + for (int i = 0; i < bytes.length; i++) { + if ((bb.get(at + i) & 0xFF) != bytes[i]) { + return false; + } + } + return true; + } + + private static int be32(ByteBuffer bb, int at) { + return ((bb.get(at) & 0xFF) << 24) | ((bb.get(at + 1) & 0xFF) << 16) + | ((bb.get(at + 2) & 0xFF) << 8) | (bb.get(at + 3) & 0xFF); + } + + private static int le32(ByteBuffer bb, int at) { + return (bb.get(at) & 0xFF) | ((bb.get(at + 1) & 0xFF) << 8) + | ((bb.get(at + 2) & 0xFF) << 16) | ((bb.get(at + 3) & 0xFF) << 24); + } } diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java index 01f58b0..5d3f927 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java @@ -1,5 +1,6 @@ package ru.pjandro.wordpdf; +import org.apache.fop.apps.FopFactory; import org.apache.pdfbox.Loader; import org.apache.pdfbox.cos.COSBase; import org.apache.pdfbox.cos.COSName; @@ -2746,4 +2747,87 @@ class WordPdfConverterTest { } } + /** + * Повторная конвертация обязана переиспользовать ту же FopFactory: разбор + * шрифтов форка дорог (GPOS-таблицы, ~140k объектов) и на общей фабрике + * выполняется один раз на JVM. + */ + @Test + void fopFactorySharedAcrossConversions() throws Exception { + WordPdfConverter.convert(sampleBytes("ru-plain.docx"), "ru-plain"); + FopFactory first = WordPdfConverter.sharedFopFactory(null); + WordPdfConverter.convert(sampleBytes("en-plain.docx"), "en-plain"); + assertSame(first, WordPdfConverter.sharedFopFactory(null), + "повторная конвертация обязана переиспользовать ту же FopFactory"); + } + + /** + * После конвертации фабричные image-кеши FOP обязаны быть пусты: ключи + * записей ({@code file:/tmp/…}) уникальны на каждую конвертацию, + * попаданий не бывает никогда, а непустой кеш — утечка декодированного + * растра до конца жизни JVM (замер 2026-11: ~1,5 ГБ живых byte[] после + * 30 конвертаций). Регрессия — этот тест, фикстура samples/chart-types.docx. + */ + @Test + void sharedImageCaches_clearedAfterConversion() throws Exception { + WordPdfConverter.convert(sampleBytes("chart-types.docx"), "chart-types"); + + FopFactory factory = WordPdfConverter.sharedFopFactory(null); + Object imageCache = factory.getImageManager().getCache(); + assertEquals(0, softMapSize(imageCache, "imageInfos"), + "ImageCache.imageInfos обязан быть пуст после конвертации"); + assertEquals(0, softMapSize(imageCache, "images"), + "ImageCache.images обязан быть пуст после конвертации"); + assertEquals(0, softMapSize(factory.getImageObjectCache(), "cache"), + "ImageObjectCacheImpl обязан быть пуст после конвертации"); + } + + /** Размер внутренней {@code map} SoftMapCache (package-private поле). */ + private static int softMapSize(Object cacheHolder, String field) throws Exception { + java.lang.reflect.Field f = cacheHolder.getClass().getDeclaredField(field); + f.setAccessible(true); + Object softCache = f.get(cacheHolder); + java.lang.reflect.Field m = softCache.getClass().getDeclaredField("map"); + m.setAccessible(true); + return ((Map) m.get(softCache)).size(); + } + + /** + * Две конвертации из разных потоков обязаны обе отработать корректно: + * ядро сериализует их монитором класса (PhysicalFonts, общая FopFactory, + * сброс image-кешей в finally). Регрессия — этот тест, + * фикстуры samples/ru-plain.docx и samples/chart-types.docx. + */ + @Test + void concurrentConversions_twoThreadsBothSucceed() throws Exception { + byte[] plain = sampleBytes("ru-plain.docx"); + byte[] chart = sampleBytes("chart-types.docx"); + byte[][] out = new byte[2][]; + Runnable[] jobs = { + () -> out[0] = WordPdfConverter.convert(plain, "ru-plain"), + () -> out[1] = WordPdfConverter.convert(chart, "chart-types"), + }; + Thread[] ts = new Thread[2]; + for (int i = 0; i < 2; i++) { + ts[i] = new Thread(jobs[i]); + ts[i].start(); + } + for (Thread t : ts) { + t.join(); + } + assertTrue(out[0] != null && "%PDF".equals(new String(out[0], 0, 4, StandardCharsets.US_ASCII)), + "поток 1 не вернул PDF"); + assertTrue(out[1] != null && "%PDF".equals(new String(out[1], 0, 4, StandardCharsets.US_ASCII)), + "поток 2 не вернул PDF"); + assertTrue(norm(pdfTextBytes(out[0])).contains("Привет, мир!"), "поток 1: текст потерян"); + assertTrue(norm(pdfTextBytes(out[1])).contains("Типы диаграмм"), "поток 2: текст потерян"); + } + + /** Текст PDF из байтов (PDFBox) — для результатов прямого convert(). */ + private static String pdfTextBytes(byte[] pdf) throws IOException { + try (PDDocument doc = Loader.loadPDF(pdf)) { + return new PDFTextStripper().getText(doc); + } + } + } diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/fonts/BundledFontsTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/fonts/BundledFontsTest.java index 39a2217..c7765ba 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/fonts/BundledFontsTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/fonts/BundledFontsTest.java @@ -11,6 +11,7 @@ import java.nio.file.Files; import java.nio.file.Path; import java.util.List; import java.util.Set; +import java.util.concurrent.atomic.AtomicReference; import java.util.stream.Collectors; import org.docx4j.fonts.PhysicalFonts; @@ -197,4 +198,37 @@ class BundledFontsTest { ctor.setAccessible(true); return ctor.newInstance(name, info, null); } + + /** + * Публичный font-API под конкурентным боем: font()/GlyphFont.of()/ + * canDisplay()/advance() из четырёх потоков обязаны не ронять и не + * подменять состояние (гарды: synchronized font(), монитор of(), + * внутренние замки fontbox). Регрессия — этот тест. + */ + @Test + void concurrentFontApi_callsAllSucceed() throws Exception { + AtomicReference boom = new AtomicReference<>(); + Thread[] ts = new Thread[4]; + for (int i = 0; i < 4; i++) { + ts[i] = new Thread(() -> { + try { + for (int k = 0; k < 50; k++) { + assertNotNull(BundledFonts.regular("carlito"), "regular null"); + GlyphFont f = GlyphFont.of("carlito", BundledFonts.V_REGULAR); + assertNotNull(f, "GlyphFont null"); + assertTrue(f.canDisplay('А'), "carlito обязан покрывать «А»"); + assertTrue(f.advance("Тест", 11.0) > 0, "нулевая ширина"); + assertEquals(9, BundledFonts.families().size(), "семейств бандла"); + } + } catch (Throwable t) { + boom.compareAndSet(null, t); + } + }); + ts[i].start(); + } + for (Thread t : ts) { + t.join(); + } + assertNull(boom.get(), "конкурентный font-API бросил: " + boom.get()); + } } diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/OleObjectNormalizerTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/OleObjectNormalizerTest.java index aac10b4..8ee0759 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/OleObjectNormalizerTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/OleObjectNormalizerTest.java @@ -657,6 +657,22 @@ class OleObjectNormalizerTest { "image-rel плейсхолдера обязан остаться: " + out); } + /** Маркер `w:object` пересекает границу 8 KiB окна потокового поиска + * (9-байтный литерал начинается на 8188-м байте) — детект обязан его + * найти без материализации всей части. */ + @Test + void objectMarkerSplitAcrossBuffers_rejects() throws Exception { + Map m = new LinkedHashMap<>(); + m.put("[Content_Types].xml", utf8(CT_PLAIN_PNG)); + m.put("_rels/.rels", utf8(ROOT_RELS)); + m.put("word/document.xml", + utf8("x".repeat(8188) + "" + "")); + + DrawingFoundException ex = assertThrows(DrawingFoundException.class, + () -> OleObjectNormalizer.normalize(zip(m), true)); + assertEquals(DrawingFoundException.Kind.OLE, ex.kind()); + } + /** errorOnOle и только w:object-разметка (без bin-части) — документ отвергается. */ @Test void errorFlagObjectWithoutBin_rejects() throws Exception { diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartImageHandlerTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartImageHandlerTest.java index 01e086e..7bf228f 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartImageHandlerTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/ChartImageHandlerTest.java @@ -3,6 +3,7 @@ package ru.pjandro.wordpdf.internal.chart; import org.docx4j.Docx4jProperties; import org.docx4j.model.images.AbstractWordXmlPicture; import org.docx4j.openpackaging.parts.PartName; +import org.docx4j.openpackaging.parts.WordprocessingML.ImageJpegPart; import org.docx4j.openpackaging.parts.WordprocessingML.ImagePngPart; import org.junit.jupiter.api.Test; @@ -49,4 +50,150 @@ class ChartImageHandlerTest { private static ImagePngPart pngPart(String name) throws Exception { return new ImagePngPart(new PartName(name)); } + + /** PNG-часть с заголовком контейнера, объявляющим растёр width×height. */ + private static ImagePngPart pngPart(String name, byte[] head) throws Exception { + ImagePngPart part = new ImagePngPart(new PartName(name)); + part.setBinaryData(head); + return part; + } + + /** JPEG-часть с первыми байтами контейнера (FF D8 FF …). */ + private static ImageJpegPart jpegPart(String name, byte[] head) throws Exception { + ImageJpegPart part = new ImageJpegPart(new PartName(name)); + part.setBinaryData(head); + return part; + } + + /** Картинка FO-вывода с известным макетным размером (в пунктах). */ + private static AbstractWordXmlPicture sizedPicture(double widthPt, double heightPt) { + return new AbstractWordXmlPicture() { + { + forXslFo = true; + } + + @Override + public double getWidthInPoints() { + return widthPt; + } + + @Override + public double getHeightInPoints() { + return heightPt; + } + }; + } + + /** 24-байтный заголовок PNG: сигнатура, длина блока IHDR (13), «IHDR», w/h. */ + private static byte[] pngHeader(int width, int height) { + byte[] b = new byte[24]; + int[] sig = {0x89, 0x50, 0x4E, 0x47, 0x0D, 0x0A, 0x1A, 0x0A}; + for (int i = 0; i < 8; i++) { + b[i] = (byte) sig[i]; + } + b[11] = 13; + b[12] = 'I'; + b[13] = 'H'; + b[14] = 'D'; + b[15] = 'R'; + b[16] = (byte) (width >>> 24); + b[17] = (byte) (width >>> 16); + b[18] = (byte) (width >>> 8); + b[19] = (byte) width; + b[20] = (byte) (height >>> 24); + b[21] = (byte) (height >>> 16); + b[22] = (byte) (height >>> 8); + b[23] = (byte) height; + return b; + } + + /** + * Быстрый путь: PNG 1000×1000 при макете 300×300 pt — 240 ppi <= threshold + * режима «word» (300): super вернул бы ровно тот же null, но только после + * полного декода растра ImageIO. + */ + @Test + void plainPngBelowThreshold_returnsNull() throws Exception { + try { + Docx4jProperties.setProperty("docx4j.convert.out.fo.images.resolution", "word"); + ChartImageHandler handler = new ChartImageHandler(); + assertNull(handler.compressedVariant(sizedPicture(300, 300), null, + pngPart("/word/media/image1.png", pngHeader(1000, 1000))), + "ресемпл не нужен — вариант обязан быть null без декода растра"); + } finally { + Docx4jProperties.setProperty("docx4j.convert.out.fo.images.resolution", "word"); + } + } + + /** JPEG при 240 ppi: Word перекодирует его «для размера» и ниже порога — + * быстрый путь JPEG не трогает, штатный вариант CR-029 жив. */ + @Test + void jpegBelowThreshold_stillDelegates() throws Exception { + try { + Docx4jProperties.setProperty("docx4j.convert.out.fo.images.resolution", "word"); + ChartImageHandler handler = new ChartImageHandler(); + assertNotNull(handler.compressedVariant(sizedPicture(300, 300), null, + jpegPart("/word/media/image2.jpg", new byte[] { + (byte) 0xFF, (byte) 0xD8, (byte) 0xFF, (byte) 0xE0})), + "JPEG обязан оставаться на штатном пути CR-029"); + } finally { + Docx4jProperties.setProperty("docx4j.convert.out.fo.images.resolution", "word"); + } + } + + /** GIF 200×150 при макете 300×300 pt (48 ppi <= 300) — вариант null + * без декода: super дал бы тот же результат только после ImageIO. */ + @Test + void gifBelowThreshold_returnsNull() throws Exception { + try { + Docx4jProperties.setProperty("docx4j.convert.out.fo.images.resolution", "word"); + ChartImageHandler handler = new ChartImageHandler(); + // «GIF89a» + LogicalScreenDescriptor: w, h, packed, bg, aspect + byte[] head = {'G', 'I', 'F', '8', '9', 'a', (byte) 200, 0, (byte) 150, 0, 0, 0, 0}; + assertNull(handler.compressedVariant(sizedPicture(300, 300), null, + pngPart("/word/media/image4.gif", head)), + "GIF ниже порога — вариант обязан быть null без декода растра"); + } finally { + Docx4jProperties.setProperty("docx4j.convert.out.fo.images.resolution", "word"); + } + } + + /** BMP 640×480 top-down (высота отрицательная в заголовке) при макете + * 200×150 pt (230.4 ppi <= 300) — модуль высоты учтён, вариант null. */ + @Test + void bmpTopDownBelowThreshold_returnsNull() throws Exception { + try { + Docx4jProperties.setProperty("docx4j.convert.out.fo.images.resolution", "word"); + ChartImageHandler handler = new ChartImageHandler(); + byte[] head = new byte[26]; + head[0] = 'B'; + head[1] = 'M'; + head[18] = 64; // ширина 640, little-endian + // высота −480 (top-down) = 0xFFFFFE20, little-endian: + head[22] = (byte) 0x20; + head[23] = (byte) 0xFE; + head[24] = (byte) 0xFF; + head[25] = (byte) 0xFF; + assertNull(handler.compressedVariant(sizedPicture(200, 150), null, + pngPart("/word/media/image5.bmp", head)), + "BMP top-down ниже порога — вариант обязан быть null без декода"); + } finally { + Docx4jProperties.setProperty("docx4j.convert.out.fo.images.resolution", "word"); + } + } + + /** PNG 1000×1000 при макете 72×72 pt — 1000 ppi > 300: ресемпл нужен, + * быстрый путь уступает штатному. */ + @Test + void pngAboveThreshold_stillDelegates() throws Exception { + try { + Docx4jProperties.setProperty("docx4j.convert.out.fo.images.resolution", "word"); + ChartImageHandler handler = new ChartImageHandler(); + assertNotNull(handler.compressedVariant(sizedPicture(72, 72), null, + pngPart("/word/media/image3.png", pngHeader(1000, 1000))), + "выше порога — вариант обязан выдаваться штатно"); + } finally { + Docx4jProperties.setProperty("docx4j.convert.out.fo.images.resolution", "word"); + } + } }