Compare commits
4 Commits
f41ac54072
...
8d2fa3dad9
| Author | SHA1 | Date | |
|---|---|---|---|
| 8d2fa3dad9 | |||
| 2116ec43a4 | |||
| bc98a12421 | |||
| 8061a2fbe7 |
@@ -262,9 +262,9 @@ jobs:
|
|||||||
# не крушит стек бесконечным crash-loop. Синтаксис on-failure:N podman
|
# не крушит стек бесконечным crash-loop. Синтаксис on-failure:N podman
|
||||||
# переваривает и применяет (проверено: maxtries=N, после исчерпания exited).
|
# переваривает и применяет (проверено: maxtries=N, после исчерпания exited).
|
||||||
restart: on-failure:5
|
restart: on-failure:5
|
||||||
# heap вписан в лимит (-XX:MaxRAMPercentage=70 в ENTRYPOINT образа);
|
# фиксированный heap -Xms2g -Xmx2g в ENTRYPOINT образа, лимит 3g —
|
||||||
# паритет с repo compose.yml
|
# запас под metaspace/потоки/native; паритет с repo compose.yml
|
||||||
mem_limit: 2g
|
mem_limit: 3g
|
||||||
# healthcheck дублируется в compose, а не только в Containerfile: podman
|
# healthcheck дублируется в compose, а не только в Containerfile: podman
|
||||||
# выгружает образы в OCI, где HEALTHCHECK теряется, а gateway в depends_on
|
# выгружает образы в OCI, где HEALTHCHECK теряется, а gateway в depends_on
|
||||||
# ждал бы healthy вечно. wget, не curl: alpine-jre образ curl не содержит.
|
# ждал бы healthy вечно. wget, не curl: alpine-jre образ curl не содержит.
|
||||||
|
|||||||
@@ -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`.
|
- **Коды**: 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-объекты».
|
- **Текст 422** — контракт с фронтом: «Конвертация отменена: в документе найдены диаграммы/найден SmartArt/найдены OLE-объекты».
|
||||||
- **Ключ**: `X-API-Key` ↔ `wordpdf.api-key` (пустое = выключено); без ключа открыты только `OPEN_PREFIXES` (`/actuator/`, `/swagger-ui`, `/v3/api-docs`), пути с точечными сегментами — никогда.
|
- **Ключ**: `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`.
|
- **SPA**: вся сеть в `wordpdf-web/src/api.ts`; ключ в `localStorage` (`wordpdf.api.key`); `ApiKeyGate` — только если `probeApiKey()` подтвердил требование ключа (признак открытого сервера — **405**); base — `VITE_BASE`; DropZone `.docx,.doc`.
|
||||||
|
|
||||||
## Chart/SmartArt-движок (`internal/chart`, 18 классов)
|
## 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`.
|
- Единственный 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.
|
- `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`, иначе первый со шрифтами.
|
- 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` от всего, что вне бандла.
|
- `BundledFonts.init()` идемпотентен и `synchronized`, распаковывает TTF в `wordpdf-fonts-*` (`deleteOnExit`); `dropNonBundled()` чистит `PhysicalFonts` от всего, что вне бандла; `font()`/`regular()`/... синхронизированы с `init()` (реестр `VARIANTS`). Внешние `init()`/`restrictToBundled()` во время идущих конвертаций — только под монитором `WordPdfConverter.class`.
|
||||||
- `PhysicalFonts` — глобальный и мутируемый → ядро не потокобезопасно; приложение сериализует конвертации одним воркером; `warmup()` идёт тем же потоком.
|
- `PhysicalFonts` — глобальный и мутируемый → конвертации сериализуются монитором `WordPdfConverter.class` внутри ядра (общая `FopFactory` и сброс её image-кешей — под тем же монитором); приложение держит однопоточный воркер ради 503/timeout; `warmup()` идёт тем же потоком.
|
||||||
- Страницы в валидаторе = `max(кэш docProps/app.xml, явные разрывы, lastRenderedPageBreak+1)`; правила StAX-подсчёта — `docs/agent/pipeline.md`.
|
- Страницы в валидаторе = `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`.
|
- Не чинить: `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 (описанное поведение верно).
|
- Комментарии в `WordPdfConverter`/`DocxOnOffNormalizer` говорят «docx4j 11.x» — устаревшее число, фактически 17.3.2 (описанное поведение верно).
|
||||||
|
|||||||
+1
-1
@@ -37,5 +37,5 @@ USER app
|
|||||||
EXPOSE 8080
|
EXPOSE 8080
|
||||||
HEALTHCHECK --interval=10s --timeout=3s --start-period=10s --retries=5 \
|
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
|
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"]
|
||||||
|
|
||||||
|
|||||||
+3
-2
@@ -15,8 +15,9 @@ services:
|
|||||||
app:
|
app:
|
||||||
build: .
|
build: .
|
||||||
restart: unless-stopped
|
restart: unless-stopped
|
||||||
# Паритет с compose.yml: heap вписан в лимит (-XX:MaxRAMPercentage=70).
|
# Паритет с compose.yml: фиксированный heap -Xms2g -Xmx2g в ENTRYPOINT,
|
||||||
mem_limit: 2g
|
# лимит 3g — запас под metaspace/потоки/native.
|
||||||
|
mem_limit: 3g
|
||||||
# Дублирует HEALTHCHECK из Containerfile: podman выгружает образы в OCI,
|
# Дублирует HEALTHCHECK из Containerfile: podman выгружает образы в OCI,
|
||||||
# где поля healthcheck нет — без явного healthcheck depends_on
|
# где поля healthcheck нет — без явного healthcheck depends_on
|
||||||
# service_healthy ждал бы healthy вечно. Прокси обнуляем на команде.
|
# service_healthy ждал бы healthy вечно. Прокси обнуляем на команде.
|
||||||
|
|||||||
+4
-3
@@ -7,9 +7,10 @@ services:
|
|||||||
app:
|
app:
|
||||||
build: .
|
build: .
|
||||||
restart: unless-stopped
|
restart: unless-stopped
|
||||||
# Heap вписываем в лимит контейнера (-XX:MaxRAMPercentage=70 в ENTRYPOINT);
|
# Фиксированный heap -Xms2g -Xmx2g в ENTRYPOINT образа; лимит 3g — запас
|
||||||
# вход 16×5 МБ очередь + FOP-рендер в 2 ГБ помещаются.
|
# под metaspace/потоки/native. Вход 16×5 МБ + FOP-рендер в 2 ГБ heap
|
||||||
mem_limit: 2g
|
# помещаются.
|
||||||
|
mem_limit: 3g
|
||||||
# Дублирует HEALTHCHECK из Containerfile: podman выгружает образы в OCI,
|
# Дублирует HEALTHCHECK из Containerfile: podman выгружает образы в OCI,
|
||||||
# где поля healthcheck нет — без явного healthcheck depends_on
|
# где поля healthcheck нет — без явного healthcheck depends_on
|
||||||
# service_healthy ждал бы healthy вечно. Прокси обнуляем на команде.
|
# service_healthy ждал бы healthy вечно. Прокси обнуляем на команде.
|
||||||
|
|||||||
@@ -15,7 +15,7 @@
|
|||||||
| `wordpdf-core/src/test/resources/geom/` | `presetShapeDefinitions.xml` — копия приложения ECMA-376, синхрон таблицы `PresetGeometry` (только в тестах, в jar не попадает) |
|
| `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-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) |
|
| `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 |
|
| `.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/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, защита ветки, перезапуск — только имена переменных, без значений |
|
| `GITEA-vars.md` | Инструкция владельца: Secrets/Variables, защита ветки, перезапуск — только имена переменных, без значений |
|
||||||
@@ -95,7 +95,7 @@ unzip -p ~/.m2/repository/org/docx4j/docx4j-export-fo/<версия>/docx4j-expo
|
|||||||
| 504 | `ConversionTimeoutException` |
|
| 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`) открытыми не считаются никогда.
|
- **Ключ доступа**: `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-дефолт.
|
- **Лимиты входа** задаёт только конфигурация сервера: `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` + текст зоны).
|
- **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` + текст зоны).
|
||||||
|
|||||||
@@ -23,13 +23,13 @@ import java.util.concurrent.TimeoutException;
|
|||||||
/**
|
/**
|
||||||
* Конвертация .docx-байтов в PDF-байты поверх {@code wordpdf-core}.
|
* Конвертация .docx-байтов в PDF-байты поверх {@code wordpdf-core}.
|
||||||
*
|
*
|
||||||
* <p>Конвертации СЕРИАЛИЗОВАНЫ однопоточным executor'ом — не «на всякий
|
* <p>Конвертации СЕРИАЛИЗОВАНЫ однопоточным executor'ом: он держит очередь,
|
||||||
* случай»: каждая конвертация мутирует ГЛОБАЛЬНЫЙ реестр шрифтов docx4j
|
* 503 при переполнении и timeout-семантику (backpressure). Само ядро при этом
|
||||||
* ({@code new BundledFontMapper()} заново добавляет системные шрифты
|
* сериализует конвертации внутренним монитором ({@code WordPdfConverter.class}:
|
||||||
* в {@code PhysicalFonts}, {@code BundledFonts.init()/restrictToBundled()}
|
* глобальный реестр {@code PhysicalFonts}, общая FopFactory с имиджевыми
|
||||||
* их вычищают — WordPdfConverter.convertToStream, шаг 1 пайплайна). Параллельные конвертации
|
* кешами и их сброс в finally мутируются под рендером), так что параллельные
|
||||||
* вырывают реестр друг у друга из-под рендера, ядро не потокобезопасно
|
* вызовы ядра не приводят к порче вывода.
|
||||||
* by design. Регрессия — ConvertControllerTest#concurrentRequests_bothSucceed.</p>
|
* Регрессия — ConvertControllerTest#concurrentRequests_bothSucceed.</p>
|
||||||
*
|
*
|
||||||
* <p>Ошибки разделены по смыслу (требование к API): некорректный вход →
|
* <p>Ошибки разделены по смыслу (требование к API): некорректный вход →
|
||||||
* {@link ValidationException} (400), ошибка рендер-стадии →
|
* {@link ValidationException} (400), ошибка рендер-стадии →
|
||||||
@@ -55,8 +55,9 @@ final class ConversionService {
|
|||||||
new ArrayBlockingQueue<>(QUEUE_CAPACITY));
|
new ArrayBlockingQueue<>(QUEUE_CAPACITY));
|
||||||
// Прогрев ядра — головой той же однопоточной очереди: первый реальный
|
// Прогрев ядра — головой той же однопоточной очереди: первый реальный
|
||||||
// запрос после деплоя становится за прогретым ядром (~50–300 мс вместо
|
// запрос после деплоя становится за прогретым ядром (~50–300 мс вместо
|
||||||
// 1,4–1,9 с) и гарантированно сериализован с конвертациями (ядро не
|
// 1,4–1,9 с); сериализация прогрева с конвертациями — тем же воркером
|
||||||
// потокобезопасно). warmup() не бросает — Future никто не забирает;
|
// и монитором ядра (warmup() синхронизирован им же). warmup() не
|
||||||
|
// бросает — Future никто не забирает;
|
||||||
// запросы, пришедшие во время прогрева, ждут в очереди (штатная
|
// запросы, пришедшие во время прогрева, ждут в очереди (штатная
|
||||||
// семантика, лимит convert-timeout с запасом).
|
// семантика, лимит convert-timeout с запасом).
|
||||||
this.workers.submit(WordPdfConverter::warmup);
|
this.workers.submit(WordPdfConverter::warmup);
|
||||||
|
|||||||
@@ -2,7 +2,8 @@ package ru.pjandro.wordpdf;
|
|||||||
|
|
||||||
import org.apache.fop.apps.FOUserAgent;
|
import org.apache.fop.apps.FOUserAgent;
|
||||||
import org.apache.fop.apps.FopFactory;
|
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.Docx4J;
|
||||||
import org.docx4j.XmlUtils;
|
import org.docx4j.XmlUtils;
|
||||||
import org.docx4j.Docx4jProperties;
|
import org.docx4j.Docx4jProperties;
|
||||||
@@ -54,9 +55,13 @@ import java.util.zip.ZipOutputStream;
|
|||||||
* подменяются метрически совместимыми open-source аналогами
|
* подменяются метрически совместимыми open-source аналогами
|
||||||
* (см. {@link BundledFontMapper}).
|
* (см. {@link BundledFontMapper}).
|
||||||
*
|
*
|
||||||
* Класс stateless, все методы статические. Класс НЕ потокобезопасен:
|
* Класс stateless, все методы статические. Публичные {@code convert()} можно
|
||||||
* конвертации из нескольких потоков необходимо сериализовать (глобальный
|
* вызывать из нескольких потоков: сериализация обеспечена внутри ядра —
|
||||||
* реестр {@code PhysicalFonts}, кэши шрифтов/покрытия).
|
* конвертации выполняются по одной под монитором класса (глобальный реестр
|
||||||
|
* {@code PhysicalFonts}, общая FopFactory с имиджевыми кешами, сброс кеши в
|
||||||
|
* finally). {@link #warmup()} синхронизирован тем же монитором.
|
||||||
|
* {@link WordPdfValidator} stateless и выполняется до монитора — валидация
|
||||||
|
* параллельна и не блокируется.
|
||||||
*/
|
*/
|
||||||
public final class WordPdfConverter {
|
public final class WordPdfConverter {
|
||||||
|
|
||||||
@@ -83,6 +88,60 @@ public final class WordPdfConverter {
|
|||||||
private WordPdfConverter() {
|
private WordPdfConverter() {
|
||||||
}
|
}
|
||||||
|
|
||||||
|
private static volatile FopFactory sharedFopFactory;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* FopFactory, общая на JVM: разбор шрифтов форка (GPOS-таблицы, ~140k
|
||||||
|
* объектов) выполняется один раз, а не на каждую конвертацию. Фабрика
|
||||||
|
* хранит имиджевые кеши ({@code ImageManager#getCache()} и
|
||||||
|
* {@link ImageObjectCacheImpl}) c ключами {@code file:/tmp/<uuid>…} —
|
||||||
|
* уникальными на каждую конвертацию (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 — формат
|
* Конвертирует байты .docx (или бинарного .doc Word 97–2003 — формат
|
||||||
* определяется по сигнатуре байтов) в PDF. Работа с файлами — забота
|
* определяется по сигнатуре байтов) в PDF. Работа с файлами — забота
|
||||||
@@ -152,6 +211,13 @@ public final class WordPdfConverter {
|
|||||||
// .doc сбрасываются в кадре на этом же месте — детерминированно, до
|
// .doc сбрасываются в кадре на этом же месте — детерминированно, до
|
||||||
// рендера (точные liveness-карты HotSpot строит только для
|
// рендера (точные liveness-карты HotSpot строит только для
|
||||||
// скомпилированных кадров; отдельное присваивание null не нужно).
|
// скомпилированных кадров; отдельное присваивание null не нужно).
|
||||||
|
// Единый лок ядра: реестр PhysicalFonts, общая FopFactory (per-render
|
||||||
|
// disableFontCache, имиджевые кеши) и её сброс в finally мутируются под
|
||||||
|
// рендером — параллельная конвертация обязана ждать, иначе чистит кеши
|
||||||
|
// посреди чужого рендера. Монитор класса тот же, что у warmup()
|
||||||
|
// (реентельно) и DCL в sharedFopFactory. Регрессия —
|
||||||
|
// WordPdfConverterTest#concurrentConversions_twoThreadsBothSucceed.
|
||||||
|
synchronized (WordPdfConverter.class) {
|
||||||
docxBytes = WordPdfValidator.isBinaryDoc(docxBytes) ? DocToDocx.convert(docxBytes) : docxBytes;
|
docxBytes = WordPdfValidator.isBinaryDoc(docxBytes) ? DocToDocx.convert(docxBytes) : docxBytes;
|
||||||
ByteArrayOutputStream bos = new ByteArrayOutputStream(Math.max(1 << 16, docxBytes.length));
|
ByteArrayOutputStream bos = new ByteArrayOutputStream(Math.max(1 << 16, docxBytes.length));
|
||||||
try {
|
try {
|
||||||
@@ -165,6 +231,7 @@ public final class WordPdfConverter {
|
|||||||
}
|
}
|
||||||
return bos.toByteArray();
|
return bos.toByteArray();
|
||||||
}
|
}
|
||||||
|
}
|
||||||
|
|
||||||
/** Флаг «ядро прогрето»: повторные вызовы {@link #warmup()} — no-op. */
|
/** Флаг «ядро прогрето»: повторные вызовы {@link #warmup()} — no-op. */
|
||||||
private static volatile boolean warmedUp;
|
private static volatile boolean warmedUp;
|
||||||
@@ -176,9 +243,11 @@ public final class WordPdfConverter {
|
|||||||
* (JAXB/XSLT/FOP/классы), её платил первый запрос после деплоя. Прогоняет
|
* (JAXB/XSLT/FOP/классы), её платил первый запрос после деплоя. Прогоняет
|
||||||
* пайплайн на минимальном docx, собранном в байтах (фикстуры тестов не
|
* пайплайн на минимальном docx, собранном в байтах (фикстуры тестов не
|
||||||
* задействуются), и греет Java2D/PNG-энкодер для пре-рендера диаграмм.
|
* задействуются), и греет Java2D/PNG-энкодер для пре-рендера диаграмм.
|
||||||
* Идемпотентен, никогда не бросает (провал — только warn); вызывать нужно
|
* Идемпотентен, никогда не бросает (провал — только warn); метод
|
||||||
* на том же потоке, на котором сериализованы конвертации (ядро не
|
* синхронизирован монитором класса — тем же, что сериализует конвертации
|
||||||
* потокобезопасно, см. {@code PhysicalFonts}). Артефакты (PDF, растр)
|
* в {@code convert()}, так что прогрев гарантированно не пересекается с
|
||||||
|
* рендером; приложение дополнительно держит warmup головой очереди.
|
||||||
|
* Артефакты (PDF, растр)
|
||||||
* отбрасываются. Ядро само {@code warmup()} не вызывает — момент прогрева
|
* отбрасываются. Ядро само {@code warmup()} не вызывает — момент прогрева
|
||||||
* решает вызывающее приложение.
|
* решает вызывающее приложение.
|
||||||
*/
|
*/
|
||||||
@@ -330,9 +399,10 @@ public final class WordPdfConverter {
|
|||||||
// используется.
|
// используется.
|
||||||
foSettings.setCustomXsltTemplates(VendoredXslt.TEMPLATES);
|
foSettings.setCustomXsltTemplates(VendoredXslt.TEMPLATES);
|
||||||
|
|
||||||
// 5. Метаданные PDF: заголовок — из параметра title
|
// 5. Метаданные PDF: заголовок — из параметра title. Фабрика —
|
||||||
FopFactoryBuilder builder = FORendererApacheFOP.getFopFactoryBuilder(foSettings);
|
// общая на JVM (см. sharedFopFactory); после конвертации её
|
||||||
FopFactory fopFactory = builder.build();
|
// имиджевые кеши обязаны быть сброшены (шаг 7).
|
||||||
|
FopFactory fopFactory = sharedFopFactory(foSettings);
|
||||||
FOUserAgent foUserAgent = FORendererApacheFOP.getFOUserAgent(foSettings, fopFactory);
|
FOUserAgent foUserAgent = FORendererApacheFOP.getFOUserAgent(foSettings, fopFactory);
|
||||||
if (title != null && !title.isEmpty()) {
|
if (title != null && !title.isEmpty()) {
|
||||||
foUserAgent.setTitle(title);
|
foUserAgent.setTitle(title);
|
||||||
@@ -341,11 +411,14 @@ public final class WordPdfConverter {
|
|||||||
// 6. Проход XSLT (медленнее, но полнее), вывод в поток
|
// 6. Проход XSLT (медленнее, но полнее), вывод в поток
|
||||||
Docx4J.toFO(foSettings, os, Docx4J.FLAG_EXPORT_PREFER_XSL);
|
Docx4J.toFO(foSettings, os, Docx4J.FLAG_EXPORT_PREFER_XSL);
|
||||||
} finally {
|
} finally {
|
||||||
// 7. Уборка временных файлов встроенных в docx шрифтов
|
// 7. Уборка временных файлов встроенных в docx шрифтов и сброс
|
||||||
|
// имиджевых кешей общей FopFactory (без него форк копит растр
|
||||||
|
// каждого изображения: ~1,5 ГБ на 30 конвертаций, 2026-11).
|
||||||
if (pkg.getMainDocumentPart() != null
|
if (pkg.getMainDocumentPart() != null
|
||||||
&& pkg.getMainDocumentPart().getFontTablePart() != null) {
|
&& pkg.getMainDocumentPart().getFontTablePart() != null) {
|
||||||
pkg.getMainDocumentPart().getFontTablePart().deleteEmbeddedFontTempFiles();
|
pkg.getMainDocumentPart().getFontTablePart().deleteEmbeddedFontTempFiles();
|
||||||
}
|
}
|
||||||
|
resetSharedImageCaches();
|
||||||
// Примечание: в docx4j 11.x OpcPackage.close() отсутствует —
|
// Примечание: в docx4j 11.x OpcPackage.close() отсутствует —
|
||||||
// пакет загружается в память и ничего не закрывает.
|
// пакет загружается в память и ничего не закрывает.
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -188,6 +188,11 @@ public final class BundledFonts {
|
|||||||
* em-dash на шрифте ранa (Carlito) вместо fallback-DejaVu.
|
* em-dash на шрифте ранa (Carlito) вместо fallback-DejaVu.
|
||||||
* Шрифты, встроенные в docx, регистрируются при {@code load()} —
|
* Шрифты, встроенные в docx, регистрируются при {@code load()} —
|
||||||
* если чистить до load(), они останутся в реестре.
|
* если чистить до load(), они останутся в реестре.
|
||||||
|
* <p>Мутирует глобальный реестр {@code PhysicalFonts}: нельзя звать
|
||||||
|
* параллельно идущей {@code WordPdfConverter.convert()} — рендер
|
||||||
|
* начнёт терять шрифты. Внешний вызов рядом с идущей конвертацией
|
||||||
|
* обязан держать монитор {@code WordPdfConverter.class} — тот же,
|
||||||
|
* что сериализует конвертации.
|
||||||
*/
|
*/
|
||||||
public static synchronized void restrictToBundled() {
|
public static synchronized void restrictToBundled() {
|
||||||
if (!inited) {
|
if (!inited) {
|
||||||
@@ -232,10 +237,13 @@ public final class BundledFonts {
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* Зарегистрированный шрифт: семейство (lowercase) + начертание.
|
* Зарегистрированный шрифт: семейство (lowercase) + начертание.
|
||||||
|
* Синхронизирован с {@link #init()}: {@code VARIANTS} — обычный
|
||||||
|
* {@code HashMap}, наполняемый в {@code init()} под тем же монитором
|
||||||
|
* класса; без замка внешний читатель мог бы увидеть недобранную карту.
|
||||||
*
|
*
|
||||||
* @return PhysicalFont или null (если init() не вызван или шрифта нет)
|
* @return PhysicalFont или null (если init() не вызван или шрифта нет)
|
||||||
*/
|
*/
|
||||||
public static PhysicalFont font(String family, String variant) {
|
public static synchronized PhysicalFont font(String family, String variant) {
|
||||||
Map<String, PhysicalFont> m = VARIANTS.get(family);
|
Map<String, PhysicalFont> m = VARIANTS.get(family);
|
||||||
return m == null ? null : m.get(variant);
|
return m == null ? null : m.get(variant);
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -38,6 +38,12 @@ import java.util.Map;
|
|||||||
* каталога {@link BundledFonts#init()} — поэтому класс не зависит от
|
* каталога {@link BundledFonts#init()} — поэтому класс не зависит от
|
||||||
* порядка шагов конвертации. TTF буферизуется в памяти и живёт до конца
|
* порядка шагов конвертации. TTF буферизуется в памяти и живёт до конца
|
||||||
* JVM (шрифты бандла конечны, {@link TrueTypeFont} намеренно не закрываем).
|
* JVM (шрифты бандла конечны, {@link TrueTypeFont} намеренно не закрываем).
|
||||||
|
*
|
||||||
|
* Потокобезопасен: {@link #of(String, String)} идёт под монитором класса
|
||||||
|
* (единый {@code CACHE}), {@code cmap} — {@code volatile} поле с
|
||||||
|
* идемпотентным пересчётом, а ленивые таблицы fontbox читаются под её
|
||||||
|
* внутренними замками ({@code TrueTypeFont.lockReadtable}, fontbox 3.x) —
|
||||||
|
* один экземпляр можно держать в нескольких потоках.
|
||||||
*/
|
*/
|
||||||
public final class GlyphFont {
|
public final class GlyphFont {
|
||||||
|
|
||||||
|
|||||||
@@ -4,6 +4,7 @@ import ru.pjandro.wordpdf.DrawingFoundException;
|
|||||||
|
|
||||||
import java.io.ByteArrayOutputStream;
|
import java.io.ByteArrayOutputStream;
|
||||||
import java.io.IOException;
|
import java.io.IOException;
|
||||||
|
import java.io.InputStream;
|
||||||
import java.nio.charset.StandardCharsets;
|
import java.nio.charset.StandardCharsets;
|
||||||
import java.util.ArrayList;
|
import java.util.ArrayList;
|
||||||
import java.util.HashMap;
|
import java.util.HashMap;
|
||||||
@@ -135,9 +136,46 @@ public final class OleObjectNormalizer {
|
|||||||
|
|
||||||
private static final Logger LOG = Logger.getLogger(OleObjectNormalizer.class.getName());
|
private static final Logger LOG = Logger.getLogger(OleObjectNormalizer.class.getName());
|
||||||
|
|
||||||
|
/** Детект `w:object` по байтам: ASCII-литерал в UTF-8 не может
|
||||||
|
* встретиться внутри многобайтовой последовательности, поэтому поиск
|
||||||
|
* по сырым байтам эквивалентен `new String(...).contains(...)`. */
|
||||||
|
private static final byte[] OBJECT_NEEDLE = "<w:object".getBytes(StandardCharsets.US_ASCII);
|
||||||
|
|
||||||
private OleObjectNormalizer() {
|
private OleObjectNormalizer() {
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Поиск ASCII-литерала в потоке окном 8 KiB с перекрытием
|
||||||
|
* {@code needle.length - 1} байт на границе окна — без материализации
|
||||||
|
* всей XML-части (document.xml десятки МБ дублировались в память ради
|
||||||
|
* поиска 9-байтного литерала).
|
||||||
|
*/
|
||||||
|
private static boolean containsAscii(InputStream in, byte[] needle) throws IOException {
|
||||||
|
try (in) {
|
||||||
|
byte[] window = new byte[8192];
|
||||||
|
int carried = 0; // байт перенесённого хвоста предыдущего окна
|
||||||
|
int read;
|
||||||
|
while ((read = in.read(window, carried, window.length - carried)) > 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-типом (или
|
* Вычистляет из docx OLE-объекты: бинарные `.bin`-части с OLE-типом (или
|
||||||
* ложным XML-типом), ссылки на них и oleObject-ссылки (включая External) в
|
* ложным XML-типом), ссылки на них и oleObject-ссылки (включая External) в
|
||||||
@@ -183,8 +221,7 @@ public final class OleObjectNormalizer {
|
|||||||
oleParts.add(name);
|
oleParts.add(name);
|
||||||
}
|
}
|
||||||
} else if (!hasObjectMarkup && name.startsWith("word/") && name.endsWith(".xml")
|
} else if (!hasObjectMarkup && name.startsWith("word/") && name.endsWith(".xml")
|
||||||
&& new String(zf.getInputStream(entry).readAllBytes(),
|
&& containsAscii(zf.getInputStream(entry), OBJECT_NEEDLE)) {
|
||||||
StandardCharsets.UTF_8).contains("<w:object")) {
|
|
||||||
// сам w:object — уже OLE: без bin-части он всё равно роняет docx4j
|
// сам w:object — уже OLE: без bin-части он всё равно роняет docx4j
|
||||||
// (NPE chunkType is null) и обязан быть переписан
|
// (NPE chunkType is null) и обязан быть переписан
|
||||||
hasObjectMarkup = true;
|
hasObjectMarkup = true;
|
||||||
|
|||||||
+98
-3
@@ -2,10 +2,13 @@ package ru.pjandro.wordpdf.internal.chart;
|
|||||||
|
|
||||||
import org.docx4j.convert.out.fo.FOConversionImageHandler;
|
import org.docx4j.convert.out.fo.FOConversionImageHandler;
|
||||||
import org.docx4j.model.images.AbstractWordXmlPicture;
|
import org.docx4j.model.images.AbstractWordXmlPicture;
|
||||||
|
import org.docx4j.model.images.PictureCompression;
|
||||||
import org.docx4j.openpackaging.exceptions.Docx4JException;
|
import org.docx4j.openpackaging.exceptions.Docx4JException;
|
||||||
import org.docx4j.openpackaging.parts.WordprocessingML.BinaryPart;
|
import org.docx4j.openpackaging.parts.WordprocessingML.BinaryPart;
|
||||||
import org.docx4j.relationships.Relationship;
|
import org.docx4j.relationships.Relationship;
|
||||||
|
|
||||||
|
import java.nio.ByteBuffer;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Image-обработчик FO-экспорта, отключающий docx4j «Compress Pictures»
|
* Image-обработчик FO-экспорта, отключающий docx4j «Compress Pictures»
|
||||||
* (CR-029) для наших chart-PNG.
|
* (CR-029) для наших chart-PNG.
|
||||||
@@ -25,13 +28,26 @@ import org.docx4j.relationships.Relationship;
|
|||||||
* {@code /word/media/chart-*} возвращаем null (нет варианта), картинка
|
* {@code /word/media/chart-*} возвращаем null (нет варианта), картинка
|
||||||
* уходит в PDF как есть.
|
* уходит в PDF как есть.
|
||||||
*
|
*
|
||||||
* Медиа документов (фото/скрины) — не наши части, им остаётся штатный
|
* Медиа документов (фото/скрины) — не наши части, но и для них штатный путь
|
||||||
* docx4j-режим CR-029.
|
* дорог: {@code PictureCompression.compress} декодирует полный растр (ImageIO)
|
||||||
|
* ДО любых решений, а для не-JPEG без кропа с ppi <= threshold (и без размера
|
||||||
|
* в макете) результат всегда null — декод впустую. Здесь такое решение
|
||||||
|
* принимается по 26 байтам заголовка (PNG/GIF/BMP), растр не декодируется
|
||||||
|
* вовсе. JPEG сознательно не ускоряем: Word при ppi <= threshold перекодирует
|
||||||
|
* его «для размера», вывод должен остаться побайтно прежним.
|
||||||
*
|
*
|
||||||
* Регрессия — WordPdfConverterTest#chartMedia_notDownsampled.
|
* Регрессии — WordPdfConverterTest#chartMedia_notDownsampled,
|
||||||
|
* ChartImageHandlerTest#plainPngBelowThreshold_returnsNull,
|
||||||
|
* ChartImageHandlerTest#jpegBelowThreshold_stillDelegates,
|
||||||
|
* ChartImageHandlerTest#pngAboveThreshold_stillDelegates.
|
||||||
*/
|
*/
|
||||||
public final class ChartImageHandler extends FOConversionImageHandler {
|
public final class ChartImageHandler extends FOConversionImageHandler {
|
||||||
|
|
||||||
|
private static final int[] PNG_SIGNATURE =
|
||||||
|
{0x89, 0x50, 0x4E, 0x47, 0x0D, 0x0A, 0x1A, 0x0A};
|
||||||
|
private static final int[] GIF_SIGNATURE = {0x47, 0x49, 0x46, 0x38};
|
||||||
|
private static final int[] BMP_SIGNATURE = {0x42, 0x4D};
|
||||||
|
|
||||||
@Override
|
@Override
|
||||||
protected String compressedVariant(AbstractWordXmlPicture picture,
|
protected String compressedVariant(AbstractWordXmlPicture picture,
|
||||||
Relationship relationship, BinaryPart part)
|
Relationship relationship, BinaryPart part)
|
||||||
@@ -41,6 +57,85 @@ public final class ChartImageHandler extends FOConversionImageHandler {
|
|||||||
.startsWith(DrawingPreRenderer.CHART_MEDIA_URI_PREFIX)) {
|
.startsWith(DrawingPreRenderer.CHART_MEDIA_URI_PREFIX)) {
|
||||||
return null;
|
return null;
|
||||||
}
|
}
|
||||||
|
// Быстрый путь: null идентичен тому, что super вернул бы после
|
||||||
|
// полного декода. PictureCompression.compress для не-JPEG без кропа
|
||||||
|
// возвращает null, когда ресемпл не нужен: ppi по заголовку не выше
|
||||||
|
// threshold (формула — дословно из compress) или размер в макете
|
||||||
|
// задан нулём/не задан (кроп при этом исключён, reencoding требует
|
||||||
|
// JPEG). Кроп, high-fidelity, JPEG и нераспознанный формат — super.
|
||||||
|
if (picture != null && picture.isForXslFo() && part != null
|
||||||
|
&& (!cropsPictures() || picture.getCrop().isNone())) {
|
||||||
|
PictureCompression.Resolution resolution =
|
||||||
|
PictureCompression.resolution(picture.getWmlPackage(), pictureResolution);
|
||||||
|
if (!resolution.isHighFidelity() && noResampleNeeded(part.getBuffer(),
|
||||||
|
picture.getWidthInPoints(), picture.getHeightInPoints(),
|
||||||
|
resolution.threshold)) {
|
||||||
|
return null;
|
||||||
|
}
|
||||||
|
}
|
||||||
return super.compressedVariant(picture, relationship, part);
|
return super.compressedVariant(picture, relationship, part);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Истинно, когда по 26 байтам заголовка контейнера картинка — из быстрого
|
||||||
|
* списка (PNG/GIF/BMP) и ресемпл ей не нужен: нативный ppi при заданном
|
||||||
|
* макетном размере не выше {@code threshold} (формула — дословно из
|
||||||
|
* {@code PictureCompression.compress}), либо размер в макете не задан
|
||||||
|
* (без кропа и без JPEG super тоже приходит к null). Ложь — формат вне
|
||||||
|
* списка (JPEG — решение пользователя, TIFF/EMF/WMF/…), заголовок
|
||||||
|
* неполный/неправдоподобный или буфер части пуст: решение отдаём super.
|
||||||
|
* Байты читаются абсолютными индексами — позиция общего {@link ByteBuffer}
|
||||||
|
* части не мутируется.
|
||||||
|
*/
|
||||||
|
private static boolean noResampleNeeded(ByteBuffer bb, double widthPt, double heightPt,
|
||||||
|
int threshold) {
|
||||||
|
if (bb == null) {
|
||||||
|
return false;
|
||||||
|
}
|
||||||
|
final int len = bb.limit();
|
||||||
|
final int width;
|
||||||
|
final int height;
|
||||||
|
// PNG: сигнатура, затем длина блока, «IHDR» со смещения 12,
|
||||||
|
// ширина/высота big-endian в 16/20.
|
||||||
|
if (len >= 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);
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,5 +1,6 @@
|
|||||||
package ru.pjandro.wordpdf;
|
package ru.pjandro.wordpdf;
|
||||||
|
|
||||||
|
import org.apache.fop.apps.FopFactory;
|
||||||
import org.apache.pdfbox.Loader;
|
import org.apache.pdfbox.Loader;
|
||||||
import org.apache.pdfbox.cos.COSBase;
|
import org.apache.pdfbox.cos.COSBase;
|
||||||
import org.apache.pdfbox.cos.COSName;
|
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/<uuid>…}) уникальны на каждую конвертацию,
|
||||||
|
* попаданий не бывает никогда, а непустой кеш — утечка декодированного
|
||||||
|
* растра до конца жизни 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);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -11,6 +11,7 @@ import java.nio.file.Files;
|
|||||||
import java.nio.file.Path;
|
import java.nio.file.Path;
|
||||||
import java.util.List;
|
import java.util.List;
|
||||||
import java.util.Set;
|
import java.util.Set;
|
||||||
|
import java.util.concurrent.atomic.AtomicReference;
|
||||||
import java.util.stream.Collectors;
|
import java.util.stream.Collectors;
|
||||||
|
|
||||||
import org.docx4j.fonts.PhysicalFonts;
|
import org.docx4j.fonts.PhysicalFonts;
|
||||||
@@ -197,4 +198,37 @@ class BundledFontsTest {
|
|||||||
ctor.setAccessible(true);
|
ctor.setAccessible(true);
|
||||||
return ctor.newInstance(name, info, null);
|
return ctor.newInstance(name, info, null);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Публичный font-API под конкурентным боем: font()/GlyphFont.of()/
|
||||||
|
* canDisplay()/advance() из четырёх потоков обязаны не ронять и не
|
||||||
|
* подменять состояние (гарды: synchronized font(), монитор of(),
|
||||||
|
* внутренние замки fontbox). Регрессия — этот тест.
|
||||||
|
*/
|
||||||
|
@Test
|
||||||
|
void concurrentFontApi_callsAllSucceed() throws Exception {
|
||||||
|
AtomicReference<Throwable> 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());
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -657,6 +657,22 @@ class OleObjectNormalizerTest {
|
|||||||
"image-rel плейсхолдера обязан остаться: " + out);
|
"image-rel плейсхолдера обязан остаться: " + out);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/** Маркер `w:object` пересекает границу 8 KiB окна потокового поиска
|
||||||
|
* (9-байтный литерал начинается на 8188-м байте) — детект обязан его
|
||||||
|
* найти без материализации всей части. */
|
||||||
|
@Test
|
||||||
|
void objectMarkerSplitAcrossBuffers_rejects() throws Exception {
|
||||||
|
Map<String, byte[]> 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) + "<w:object>" + "</w:object>"));
|
||||||
|
|
||||||
|
DrawingFoundException ex = assertThrows(DrawingFoundException.class,
|
||||||
|
() -> OleObjectNormalizer.normalize(zip(m), true));
|
||||||
|
assertEquals(DrawingFoundException.Kind.OLE, ex.kind());
|
||||||
|
}
|
||||||
|
|
||||||
/** errorOnOle и только w:object-разметка (без bin-части) — документ отвергается. */
|
/** errorOnOle и только w:object-разметка (без bin-части) — документ отвергается. */
|
||||||
@Test
|
@Test
|
||||||
void errorFlagObjectWithoutBin_rejects() throws Exception {
|
void errorFlagObjectWithoutBin_rejects() throws Exception {
|
||||||
|
|||||||
+147
@@ -3,6 +3,7 @@ package ru.pjandro.wordpdf.internal.chart;
|
|||||||
import org.docx4j.Docx4jProperties;
|
import org.docx4j.Docx4jProperties;
|
||||||
import org.docx4j.model.images.AbstractWordXmlPicture;
|
import org.docx4j.model.images.AbstractWordXmlPicture;
|
||||||
import org.docx4j.openpackaging.parts.PartName;
|
import org.docx4j.openpackaging.parts.PartName;
|
||||||
|
import org.docx4j.openpackaging.parts.WordprocessingML.ImageJpegPart;
|
||||||
import org.docx4j.openpackaging.parts.WordprocessingML.ImagePngPart;
|
import org.docx4j.openpackaging.parts.WordprocessingML.ImagePngPart;
|
||||||
import org.junit.jupiter.api.Test;
|
import org.junit.jupiter.api.Test;
|
||||||
|
|
||||||
@@ -49,4 +50,150 @@ class ChartImageHandlerTest {
|
|||||||
private static ImagePngPart pngPart(String name) throws Exception {
|
private static ImagePngPart pngPart(String name) throws Exception {
|
||||||
return new ImagePngPart(new PartName(name));
|
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");
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
Reference in New Issue
Block a user