From d72bf295ee1be6f17db60632bd8923afa234f2f4 Mon Sep 17 00:00:00 2001
From: Pjandro
Date: Fri, 16 Oct 2026 21:44:24 +0000
Subject: [PATCH] =?UTF-8?q?feat:=20=D0=BA=D0=BE=D0=BD=D0=B2=D0=B5=D1=80?=
=?UTF-8?q?=D1=82=D0=B0=D1=86=D0=B8=D1=8F=20=D0=B1=D0=B8=D0=BD=D0=B0=D1=80?=
=?UTF-8?q?=D0=BD=D0=BE=D0=B3=D0=BE=20.doc=20(Word=2097-2003)=20=D0=B2=20P?=
=?UTF-8?q?DF=20(POI=20HWPF=20+=20FOP)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
AGENTS.md | 34 +-
pom.xml | 6 +
.../wordpdf/app/ConversionService.java | 37 +-
.../wordpdf/app/ConvertController.java | 26 +-
.../wordpdf/app/ConvertControllerTest.java | 33 +-
wordpdf-core/pom.xml | 7 +
.../ru/pjandro/wordpdf/WordPdfConverter.java | 25 +-
.../ru/pjandro/wordpdf/WordPdfValidator.java | 41 +
.../wordpdf/internal/DocToPdfRenderer.java | 759 ++++++++++++++++++
.../java/ru/pjandro/wordpdf/DocToPdfTest.java | 234 ++++++
.../pjandro/wordpdf/WordPdfValidatorTest.java | 45 ++
.../src/test/resources/samples/legacy-doc.doc | Bin 0 -> 429568 bytes
wordpdf-web/src/api.ts | 2 +-
wordpdf-web/src/components/App.tsx | 2 +-
wordpdf-web/src/components/DropZone.tsx | 6 +-
15 files changed, 1217 insertions(+), 40 deletions(-)
create mode 100644 wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/DocToPdfRenderer.java
create mode 100644 wordpdf-core/src/test/java/ru/pjandro/wordpdf/DocToPdfTest.java
create mode 100644 wordpdf-core/src/test/resources/samples/legacy-doc.doc
diff --git a/AGENTS.md b/AGENTS.md
index 4e52d21..0d9e74c 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -2,7 +2,7 @@
## Project Overview
-Конвертер `.docx` → `.pdf` на чистом Java (docx4j 17.3.2 + форк Apache FOP, без LibreOffice/Aspose). Java 21, только Maven. Модули: `wordpdf-core` (библиотека), `wordpdf-app` (Spring Boot 4.1.1 REST API); `wordpdf-web` — React SPA в nginx-контейнере (отдельный деп, вне Maven). Единственный гейт перед `git push` — `mvn clean verify` (CI нет; SPA гейтуется `npm run build` + `npm run lint`). Вход стека — контейнер `gateway` (nginx), НЕ 8080. README устарел шире Docker-секции: лимиты (пишет 5 МБ/100 стр./6 МБ multipart — фактически 20 MiB/1000/100 MB), порты («всё на :8080» — фактически gateway :9010/:9011), API-ключ вообще не упомянут; плюс «фикстуры генерируются POI» (они закоммичены, POI только в генераторе) и Swagger UI без оговорки, что в проде она открыта без ключа, — авторитет этот файл.
+Конвертер `.docx`/`.doc` → `.pdf` на чистом Java (docx4j 17.3.2 + форк Apache FOP; бинарный `.doc` Word 97-2003 — через POI HWPF, без LibreOffice/Aspose). Java 21, только Maven. Модули: `wordpdf-core` (библиотека), `wordpdf-app` (Spring Boot 4.1.1 REST API); `wordpdf-web` — React SPA в nginx-контейнере (отдельный деп, вне Maven). Единственный гейт перед `git push` — `mvn clean verify` (CI нет; SPA гейтуется `npm run build` + `npm run lint`). Вход стека — контейнер `gateway` (nginx), НЕ 8080. README устарел шире Docker-секции: лимиты (пишет 5 МБ/100 стр./6 МБ multipart — фактически 20 MiB/1000/100 MB), порты («всё на :8080» — фактически gateway :9010/:9011), API-ключ вообще не упомянут; плюс «фикстуры генерируются POI» (они закоммичены, POI только в генераторе) и Swagger UI без оговорки, что в проде она открыта без ключа, — авторитет этот файл.
## Architecture & Data Flow
@@ -10,6 +10,8 @@
Наружу `checkInput(bytes, maxBytes)` вызывается **до** приватного `convertToStream`; внутри `convertToStream`:
+**Шаг 0**: вход с OLE2-магиком `D0 CF 11 E0 A1 B1 1A E1` (бинарный `.doc`) уходит в `internal.DocToPdfRenderer.render` **до** создания `BundledFontMapper` — docx4j-машинерия и все нормализаторы (zip-путь) для него бессмысленны; см. «Ветка .doc» ниже.
+
1. `new BundledFontMapper()` → `BundledFonts.init()` → `BundledFonts.restrictToBundled()`. Конструктор маппера каждый раз добавляет системные шрифты в реестр `PhysicalFonts`; ключ реестра — имя из name-таблицы TTF, `addPhysicalFont(URI)` не перезаписывает занятый → `init()` вызывает `dropNonBundled()` **до** регистрации и `load()` (иначе системный Calibri ломает em-dash-fallback).
2. Нормализация байтов docx до JAXB-загрузки (цепочка `byte[] → byte[]`, порядок значим): `StrictOoxmlNormalizer` (strict-OOXML → transitional-байт: `a:`-проценты и `w14:fillToRect` → тысячные ×1000, текст `wp14:pctWidth`/`pctHeight`, элементы и атрибуты `w:start`/`w:end` → `w:left`/`w:right` (кроме `w:lvl/w:start` в numbering.xml), значения `start`/`end` у `w:jc`/`w:tab`; в `mc-preprocessor.xslt` docx4j ветка `%` закомментирована, start/end не маппятся; namespaces и `pt`-значения правит сам mc-preprocessor — собственный рерайт URI ломает его pt-конверсию) → `DocxOnOffNormalizer` (`w:val="off"/"on"` → `false`/`true`) → `SymbolFontNormalizer` (PUA U+F0xx Symbol/Wingdings/Webdings → Unicode + DejaVu Sans, переписывает и элементы ``; 5 карт по 256 слотов, таблица `SymbolMapper` сгенерирована из docx4j 17.x) → `FieldNormalizer` (`fldChar` PAGE/NUMPAGES/SECTIONPAGES → `w:fldSimple`, вложенные/битые поля пропускает) → `GlyphCoverageNormalizer` (режет ран по покрытию глифов, пишет семейство в `w:rFonts`, иначе FOP рисует «#»; покрытие — `java.awt.Font.canDisplay` + BitSet-кэш, НЕ docx4j `GlyphCheck` — тот плодит INFO-лог; для serif-ран fallback ищется сначала в `SERIF_FAMILIES` (DejaVu Serif/Tinos/Caladea), затем в sans) → `WordprocessingMLPackage.load`.
3. `WordPdfValidator.checkPageCount(pkg, maxPages)` — **до** рендера.
@@ -17,11 +19,15 @@
5. `new FOSettings(pkg)` + `FopFallbackFonts.declare` (декларирует **все** бандл-семейства — FOP встраивает только задекларированные) → `FORendererApacheFOP`/`FOUserAgent` (непустой `title` → заголовок PDF) → `Docx4J.toFO(..., FLAG_EXPORT_PREFER_XSL)`.
6. `finally`: `deleteEmbeddedFontTempFiles()` (в 17.x `OpcPackage.close()` нет).
+### Ветка `.doc` (`internal/DocToPdfRenderer`, public только `render`)
+
+POI `WordToFoConverter` (HWPF→XSL-FO) → тот же FOP-форк. Порядок: `BundledFonts.init()` (без `restrictToBundled` — FOP-конфиг строится строкой с `auto-detect="false"`, системные шрифты в рендер не попадают) → `POIFSFileSystem`/`HWPFDocument` → `FontReplacer` (имя = name-таблица TTF через `BundledFontMapper.bundledFamily`) → `PicturesManager` во временный каталог (без него POI **молча пропускает** картинки; пустые картинки — `null`, иначе FOP падает EOFException) → `processDocument` → пост-обработка FO-DOM: `applyDefaultFont` (инлайны POI без `font-family` — иначе базовый Helvetica) и `injectHeadersAndFooters` (POI колонтитулы не пишет): `HeaderStories` odd/even/first × header/footer, чанки по `\u000c`; в мастер — `region-before`/`region-after` (`extent` = top/bottom margin из `margin`-шортхэнда `region-body`, **margin'ы `region-body` сохраняются** — форк FOP не вычитает extent'ы регионов из body-области, единственная защита от наезда текста на колонтитулы — собственные margin'ы body; порядок детей body→before→after — требование валидации форка; зазор — маргинами блоков, padding регионов FOP валит), в `page-sequence` — `fo:static-content` перед `fo:flow`; first/even — эвристика «непустая история ⇒ вариант» (флаги titlePg/evenAndOdd POI не отдаёт) через `fo:page-sequence-master` + `conditional-page-master-reference` first/even/rest. Поля в текстах историй — управляющие символы `\u0013/\u0014/\u0015`: `PAGE` → `fo:page-number`, `NUMPAGES`/`SECTIONPAGES` → `fo:page-number-citation-last` по последнему мастеру; `fo:page-number` без `font-family` блока рисуется Helvetica — блок получает семейство первого рана. Свойство `tabs` FOP-форк не знает — табы = пробелы до дефолтной остановки 1,25 см. Принятая деградация против Word: дрейф вёрстки (18 стр. против 12 на фикстуре), экзотические глифы остаются `.notdef` (аналога `GlyphCoverageNormalizer` нет), first/even-варианты эвристикой. Флаги `renderCharts`/`renderSmartArt`/`errorOn*` — no-op.
+
### REST API (`wordpdf-app`, всё package-private кроме `WordPdfApplication`)
-- Единственный эндпоинт `POST /api/v1/convert` (multipart-поле `file`, факультативные `renderCharts`/`renderSmartArt` — query или form) → `application/pdf`, `Content-Disposition: attachment; filename*=UTF-8''…`. Проверка `.docx`-расширения — в `ConvertController`; `safeBaseName` в `ConversionService` — единый источник имени для файла, заголовка ответа и PDF-title (разрешены `[\p{L}\p{N} ._-]`, пустое → `document`).
+- Единственный эндпоинт `POST /api/v1/convert` (multipart-поле `file`, факультативные `renderCharts`/`renderSmartArt` — query или form) → `application/pdf`, `Content-Disposition: attachment; filename*=UTF-8''…`. Проверка расширений `.docx`/`.doc` — в `ConvertController`; `safeBaseName` в `ConversionService` — единый источник имени для файла, заголовка ответа и PDF-title (разрешены `[\p{L}\p{N} ._-]`, пустое → `document`). Для `.doc` ответ несёт `X-Wordpdf-Degraded: headers-footers-exotic-glyphs` (деградация вёрстки/колонтитулов/экзотических глифов).
- Конвертации **сериализованы** однопоточным `ThreadPoolExecutor` (`ConversionService.QUEUE_CAPACITY = 16`, переполнение → 503): ядро мутирует глобальный реестр `PhysicalFonts`. `future.cancel(true)` при таймауте не останавливает FOP мгновенно — осознанный компромисс.
-- Ошибки (`ApiExceptionHandler`, тело `{"error": …}`): `ValidationException` → 400; `ConversionFailedException` → 500; `ConversionRejectedException` → 503; `ConversionTimeoutException` (`wordpdf.convert-timeout`, 2m) → 504; `MaxUploadSizeExceededException` → 413; `MissingServletRequestPartException`/`MissingServletRequestParameterException` → 400; `NoResourceFoundException` (неизвестный путь) → 404; catch-all → 500 (подробности только в лог). Четыре app-исключения (`ValidationException`, `ConversionFailedException`, `ConversionRejectedException`, `ConversionTimeoutException`) — package-private, несут семантику 400/500/503/504. Граница: сломанный контейнер (не zip / размер / страницы) → 400, валидный zip с мусором внутри → 500. Валидация до очереди: `checkInput` → zip-магик `PK\x03\x04` → `checkPageCountLightweight` (порядок значим).
+- Ошибки (`ApiExceptionHandler`, тело `{"error": …}`): `ValidationException` → 400; `ConversionFailedException` → 500; `ConversionRejectedException` → 503; `ConversionTimeoutException` (`wordpdf.convert-timeout`, 2m) → 504; `MaxUploadSizeExceededException` → 413; `MissingServletRequestPartException`/`MissingServletRequestParameterException` → 400; `NoResourceFoundException` (неизвестный путь) → 404; catch-all → 500 (подробности только в лог). Четыре app-исключения (`ValidationException`, `ConversionFailedException`, `ConversionRejectedException`, `ConversionTimeoutException`) — package-private, несут семантику 400/500/503/504. Граница: сломанный контейнер (не zip / не OLE2 / размер / страницы) → 400, валидный контейнер с мусором внутри → 500. Валидация до очереди — развилка по магiku: `checkInput` → zip `PK\x03\x04` → `checkPageCountLightweight` **или** OLE2 `D0 CF 11 E0` → `checkDocPageCountLightweight` (порядок значим).
- **Ключ доступа**: `ApiKeyFilter` сверяет заголовок `X-API-Key` (`ApiKeyFilter.HEADER`) со свойством `wordpdf.api-key` (env `WORDPDF_API_KEY`, сравнение `MessageDigest.isEqual`). Пустое свойство = аутентификация выключена (dev `java -jar`, тесты). Без ключа открыты `/actuator/**` (HEALTHCHECK) и документация springdoc (`/swagger-ui*`, `/v3/api-docs*`) — матч по пути **без forwarded-contextPath** (`getRequestURI()` минус `getContextPath()`; иначе под `X-Forwarded-Prefix` HEALTHCHECK получил бы 401). 401 пишет сам фильтр (`ApiExceptionHandler` ошибок фильтров не видит). Springdoc в проде **включён**, документация открыта без ключа под `https://pjandro.ru/pdf-converter/swagger-ui.html` (server-URL/swagger-config собираются из `X-Forwarded-*`, `server.forward-headers-strategy=framework` — `native`-клапан Tomcat `X-Forwarded-Prefix` не понимает). Регрессии — `ApiKeyFilterTest#forwardedPrefix_healthStaysOpen`, `ApiKeyFilterTest#docsOpenWithoutKey`.
- Лимиты входа задаёт **только конфигурация сервера**: `wordpdf.max-bytes`/`wordpdf.max-pages` (env `WORDPDF_MAX_BYTES`/`WORDPDF_MAX_PAGES`), `@Value` в `ConvertController` с дефолтом-SpEL из `WordPdfSettings` (20 MiB / 1000); значение ≤ 0 → `IllegalStateException` на старте; параметрами запроса не переопределяются. Ключи в `application.properties` **не объявлены** — пустое значение затенит SpEL-дефолт.
- SPA: вся сеть в `src/api.ts` (компоненты `fetch` не вызывают); ключ в `localStorage` (`wordpdf.api.key`), при 401 очищается, экран `ApiKeyGate` (`UnauthorizedError` — наследник `ApiError`, проверяется раньше); запросы на `${import.meta.env.BASE_URL}api/...` (vite `base` из `VITE_BASE`, дефолт `/`) — CORS не нужен (dev: vite-proxy → :8080; prod: nginx с префиксом `/pdf-converter/`).
@@ -34,8 +40,10 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр
- `docx4j.convert.out.fo.gsubFeatures=false` — static-блок `WordPdfConverter`. Иначе FO невалиден → `WordLayoutFixups` молча отказывает всем фиксам (без них нет колонок) → FOP падает на `docx4j-baseline`.
- `slf4j-simple` обязателен в ядре: без SLF4J-провайдера docx4j пишет «TO HIDE THESE MESSAGES» прямо в PDF (регрессия `noLoggingWarningInPdf`). Приложение исключает его из зависимости ядра — логи ведёт logback.
-- FOP — форк `org.docx4j:docx4j-fo-renderer*` 2.11-docx4j.2 (пакеты `org.apache.fop.*`); `Fop.Renderers.getRenderer()` возвращает **список** (рендер выбирается по mime `application/pdf`). `docx2fo.xslt` в репозитории нет — он в jar `docx4j-export-fo`.
+- FOP — форк `org.docx4j:docx4j-fo-renderer*` 2.11-docx4j.6 (пакеты `org.apache.fop.*`); `Fop.Renderers.getRenderer()` возвращает **список** (рендер выбирается по mime `application/pdf`). `docx2fo.xslt` в репозитории нет — он в jar `docx4j-export-fo`.
+- Форк FOP вырезал `PageMaster.setupRegions` (в jar нет `layoutmgr/PageMaster*`/`RegionXY`): `area.Page` строит viewport `region-body` как page-area минус **собственные** margin'ы body, `extent` у `region-before`/`region-after` body-регион не уменьшает — в `.doc`-ветке разводка body и колонтитулов только margin'ами `region-body` (регрессия `DocToPdfTest#legacyDoc_bodyClearsHeaderFooterRegions`). Docx-ветку не касается: docx4j сам закладывает высоты колонтитулов в margin'ы мастера.
- Страницы в валидаторе = `max(кэш docProps/app.xml, явные разрывы, lastRenderedPageBreak+1)`; explicit = межсекционные `sectPr` в body + `w:br type="page"` + `pageBreakBefore` (рекурсивно, включая таблицы и `w:sdt`). Lightweight-путь (StAX по zip, secure-ридер без DTD/external entities): атрибуты — по локальному имени (`attrLocal`, не по transitional-URI: иначе в strict-документе `w:br type="page"` не засчитываются); `sectPr` внутри `pPr` не считает, последнюю body-direct секцию не считает, `continuous`-секции не считает, в колонтитулах — только `w:br type="page"`, `pageBreakBefore` — только внутри `pPr` вне `sectPr` (truthy-значения `val`: `null|true|1|on`); на не-zip молчит — подпись проверяет вызывающий. Расхождение lightweight↔JAXB допустимо только в завышение. `pageCountOf` package-private намеренно (тесты); при провале JAXB-разбора (`getJaxbElement()` → null) бросает `ConversionException`, а не NPE.
+- `.doc`: `checkDocPageCountLightweight` = кэш `SummaryInformation.getPacket().getPageCount()` (Word 97-2003 писал число страниц в OLE2-метаданные; явных разрывов из FIB не извлечь) — тот же stale-cache риск, что и `docProps/app.xml`; `0`/отсутствие пакета → молча. FOP-конфиг `.doc`-ветки — строка с `auto-detect="false"` + `resource://fonts/...` (классы `FOPFontProvider`/`FopConfParser` package-private, JAXB-обход `rendererFonts` к ним не применим).
- Известный остаток эталона: U+2188/U+218A — глифов нет в OFL-шрифтах бандла, остаются `.notdef` (GNU FreeSerif GPL — не добавляем намеренно).
- Внимательно: комментарии в `WordPdfConverter`/`DocxOnOffNormalizer` говорят «docx4j 11.x» — устаревшее число, фактически 17.3.2 (описанное поведение верно).
@@ -47,12 +55,12 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр
|Путь|Назначение|
|---|---|
-|`wordpdf-core/src/main/java/ru/pjandro/wordpdf/`|публичный API: `WordPdfConverter`, `WordPdfValidator` (перегрузки `checkInput`/`checkPageCountLightweight`/`checkPageCount` — `byte[]` или pkg, с лимитом/без), `ConversionException`, `WordPdfSettings` (константы-дефолты), `ConvertOptions` (record: renderCharts, renderSmartArt, maxBytes, maxPages)|
+|`wordpdf-core/src/main/java/ru/pjandro/wordpdf/`|публичный API: `WordPdfConverter`, `WordPdfValidator` (перегрузки `checkInput`/`checkPageCountLightweight`/`checkPageCount` — `byte[]` или pkg, с лимитом/без; `checkDocPageCountLightweight` — только `byte[]` + лимит, для OLE2-`.doc`), `ConversionException`, `WordPdfSettings` (константы-дефолты), `ConvertOptions` (record: renderCharts, renderSmartArt, maxBytes, maxPages)|
|`…/wordpdf/fonts/`|`BundledFonts` (реестр/выгрузка TTF, `families()`, `FALLBACK_FAMILY`), `BundledFontMapper` (алиасы MS→open-source, self-map, DISPLAY_NAMES, public-хук `bundledFamily`)|
-|`…/wordpdf/internal/`|5 байтовых нормализатора + `FopFallbackFonts` (классы `public` — вызываются из родительского пакета; публичные члены только `normalize`/`declare`)|
+|`…/wordpdf/internal/`|5 байтовых нормализатора + `FopFallbackFonts` + `DocToPdfRenderer` (ветка `.doc`; классы `public` — вызываются из родительского пакета; публичные члены только `normalize`/`declare`/`render`)|
|`…/wordpdf/internal/chart/`|11 классов Java2D-рендера диаграмм/SmartArt в PNG (public только `DrawingPreRenderer`)|
|`wordpdf-core/src/main/resources/fonts/`|30 TTF + 3 лицензии — бинарные фикстуры, часть jar|
-|`wordpdf-core/src/test/resources/samples/`|11 закоммиченных `.docx`-фикстур (единственные фикстуры)|
+|`wordpdf-core/src/test/resources/samples/`|12 закоммиченных фикстур: 11 `.docx` + `legacy-doc.doc` (OLE2, ветка `.doc`)|
|`wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/`|REST API (10 классов): `WordPdfApplication` (единственный public), `ConvertController`, `ConversionService` (очередь), `ApiExceptionHandler`, `ApiKeyFilter`, `OpenApiConfig` (`@SecurityScheme` X-API-Key для springdoc) + 4 класса исключений|
|`wordpdf-web/src/`|SPA (React 19 + TS + Vite + Tailwind): `api.ts` (вся сеть), `components/` (App, ApiKeyGate, PdfPreview, StatusMessage, DropZone, Logo)|
|корневые `Dockerfile`, `docker-compose.yml`, `docker-compose.dev.yml`, `gateway/nginx.conf`|образ бэкенда (multi-stage maven:3.9-temurin-21 → temurin-21-jre, non-root, HEALTHCHECK actuator); compose app+web+gateway: web-образ со своим HEALTHCHECK (`wget /`), в обоих compose `depends_on web: condition: service_healthy` (без health web gateway не стартует); прод-compose интерполирует `WORDPDF_MAX_BYTES:-20971520`/`WORDPDF_MAX_PAGES:-1000`|
@@ -73,7 +81,7 @@ npm run build # (wordpdf-web/) tsc -b && vite build
docker compose -f docker-compose.dev.yml up -d --build # dev-стенд: http://127.0.0.1:9011, без ключа, springdoc вкл
```
-Пересоздать 10 фикстур (POI, test scope; `charts-smartart.docx` НЕ генерируется — создана вручную, не перезаписывать):
+Пересоздать 10 фикстур (POI, test scope; `charts-smartart.docx` и `legacy-doc.doc` НЕ генерируются — созданы вручную, не перезаписывать):
```bash
mvn -pl wordpdf-core test-compile -Dmdep.outputFile=/tmp/cp.txt dependency:build-classpath -q
@@ -100,7 +108,7 @@ java -cp wordpdf-core/target/test-classes:$(cat /tmp/cp.txt) \
- `wordpdf-app/src/main/resources/application.properties` — multipart 100MB (`max-file-size`/`max-request-size` + `file-size-threshold=100MB`, держит файл в памяти; в тон gateway `client_max_body_size 100m`), `wordpdf.convert-timeout=2m`, пустой `wordpdf.api-key`, `server.forward-headers-strategy=framework` (префикс прод-прокси для springdoc) + `springdoc.swagger-ui.persist-authorization=true`; `wordpdf.max-bytes`/`max-pages` здесь намеренно нет.
- `wordpdf-app/pom.xml` — `spring-boot-maven-plugin` с **явной** execution `repackage` (в 4.1.1 сам не связывается, jar останется тонким); `slf4j-simple` исключён; `spring-boot-starter-webmvc` (Boot 4: переименован из starter-web) + `spring-boot-starter-actuator` (нужен Docker HEALTHCHECK `/actuator/health`); тест-зависимости: `spring-boot-webmvc-test` (в Boot 4 автоконфиг MockMvc вынесен из starter-test), test-jar core.
- `wordpdf-core/pom.xml` — `maven-jar-plugin` execution `test-jar` (публикует фикстуры для app).
-- Корневой `pom.xml` — все версии зависимостей (в модулях версии не объявлять): docx4j `17.3.2`, slf4j `2.0.20`, JUnit `6.1.3`, PDFBox `3.0.8` (test), POI `5.5.1` (test, только генератор фикстур), Spring Boot `4.1.1` (BOM-import), springdoc `3.1.1`; pluginManagement: compiler `3.16.0`, surefire `3.6.0` с `-Djava.awt.headless=true`, jar `3.5.1`.
+- Корневой `pom.xml` — все версии зависимостей (в модулях версии не объявлять): docx4j `17.3.2`, slf4j `2.0.20`, JUnit `6.1.3`, PDFBox `3.0.8` (test), POI `5.5.1` (compile в core — `poi-scratchpad`, ветка `.doc`; test — `poi-ooxml`, генератор фикстур), Spring Boot `4.1.1` (BOM-import), springdoc `3.1.1`; pluginManagement: compiler `3.16.0`, surefire `3.6.0` с `-Djava.awt.headless=true`, jar `3.5.1`.
- `wordpdf-core/src/main/resources/slf4j-simple.properties` — без него предупреждение лезет в PDF.
- `gateway/nginx.conf` — единственный вход: `/api/`, `/swagger-ui`, `/v3/api-docs`, `/actuator` → `app:8080`, остальное → `web:80`; `client_max_body_size 100m` (без директивы upload режется HTML-413 шлюза вместо JSON-ошибки API). `wordpdf-web/nginx.conf` — чистая статика с SPA-fallback, `/api` НЕ проксирует.
- `wordpdf-core/src/test/java/ru/pjandro/wordpdf/SampleDocxGenerator.java` — main()-утилита пересоздания фикстур.
@@ -117,11 +125,11 @@ java -cp wordpdf-core/target/test-classes:$(cat /tmp/cp.txt) \
## Testing & QA
-- 14 тестовых классов / 126 `@Test` (core 11/104, app 3/22). JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true` в argLine; только `Assertions` (Mockito/AssertJ не использовать, несмотря на test-classpath Boot; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`); тестовые классы package-private, зеркалят main-пакеты; только `@Test` (+ единственный `@BeforeAll` — warm-up шрифтов в `GlyphCoverageNormalizerTest`).
-- **PDF сравнивается текстом, не растеризацией**: PDFBox 3 (`Loader.loadPDF`) — `PDFTextStripper` для текста (пер-странично `setStartPage/setEndPage`), override `processTextPosition` для шрифта конкретного символа (`fontNameOf`), обход ресурсов страниц для встроенных шрифтов (`EAAAAA+Carlito-Bold`) и счётчика картинок (`imageCount`). Негативные маркеры — регрессии: `assertFalse(text.contains("#"))` (.notdef), `assertFalse(font.startsWith("Helvetica"))`. Текст нормализуется по пробелам (`norm`); в `tableImage_tableAndImage` — полное удаление пробелов (docx4j переносит слова в auto-fit таблицах).
+- 15 тестовых классов / 140 `@Test` (core 12/114, app 3/26). JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true` в argLine; только `Assertions` (Mockito/AssertJ не использовать, несмотря на test-classpath Boot; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`); тестовые классы package-private, зеркалят main-пакеты; только `@Test` (+ единственный `@BeforeAll` — warm-up шрифтов в `GlyphCoverageNormalizerTest`).
+- **PDF сравнивается текстом, не растеризацией**: PDFBox 3 (`Loader.loadPDF`) — `PDFTextStripper` для текста (пер-странично `setStartPage/setEndPage`), override `processTextPosition` для шрифта конкретного символа (`fontNameOf`), обход ресурсов страниц для встроенных шрифтов (`EAAAAA+Carlito-Bold`) и счётчика картинок (`imageCount`). Негативные маркеры — регрессии: `assertFalse(text.contains("#"))` (.notdef), `assertFalse(font.startsWith("Helvetica"))`. Текст нормализуется по пробелам (`norm`); в `tableImage_tableAndImage` — полное удаление пробелов (docx4j переносит слова в auto-fit таблицах). В `DocToPdfTest` маркер `#` НЕ проверяется: в `.doc`-ветке нет `GlyphCoverageNormalizer`, экзотические глифы легально остаются `.notdef`, а PDFBox «ремонтирует» подмножества установленных в системе шрифтов и извлекает `#` — текст/assertions только по Tinos/Carlito-ранам.
- Пиксели (BufferedImage) — только в unit-тестах chart-пейнтеров, допуски 6–10% против эталона Word (`PiePainterTest` аспект h/w=0.585, `assertRatio` отклонение <0.06; `Surface3dPainterTest` `assertRange` ±6 pt для центров силуэта + `assertRatio` допуск 0.10 для геометрических отношений; shading — не допуск, а перцентильные коридоры яркости p5∈[0.74,0.90], median∈[0.90,1.10], p95∈[1.02,1.20]).
-- Фикстуры — закоммиченные `samples/*.docx` (11; в тестах не генерировать): core грузит classpath-ресурсом → `byte[]`, PDF для PDFBox — временный файл; app читает `/samples/…` из **test-jar core** (classifier `tests`) → `mvn -pl wordpdf-app` без `-am` не соберётся. In-memory docx — `ZipOutputStream` из литеральных XML или POI в `byte[]`. Ключевые: `too-many-pages` (150 явных разрывов → 151), `stale-cache` (кэш `1` + 110 `lastRenderedPageBreak`), `charts-smartart` (4 растра; SmartArt-одиночка = ровно 2 Image XObject).
+- Фикстуры — закоммиченные `samples/*` (12; в тестах не генерировать): core грузит classpath-ресурсом → `byte[]`, PDF для PDFBox — временный файл; app читает `/samples/…` из **test-jar core** (classifier `tests`) → `mvn -pl wordpdf-app` без `-am` не соберётся. In-memory docx — `ZipOutputStream` из литеральных XML или POI в `byte[]`. Ключевые: `too-many-pages` (150 явных разрывов → 151), `stale-cache` (кэш `1` + 110 `lastRenderedPageBreak`), `charts-smartart` (4 растра; SmartArt-одиночка = ровно 2 Image XObject), `legacy-doc.doc` (реальный Word 97-2003: 43 картинки, колонтитулы с PAGE-полем, кэш `Pages=12`).
- Юниты нормализаторов работают строками (`rewrite`) + zip'ами из `ZipOutputStream`; обязательные контракты: «нечего менять → тот же массив» (`assertSame` покрыт тестами только у zip-нормализаторов `DocxOnOff`/`SymbolFont`/`StrictOoxml`; у `Field`/`GlyphCoverage` — `rewrite`→`null`) и неприкосновенность частей вне `word/*.xml` (`[Content_Types].xml`). Тесты бьют и в package-private API (`GlyphCoverageNormalizer.split(text, family)`, `pageCountOf`, `ChartSpec.readTitle`).
- App-тесты: `@SpringBootTest` + `@AutoConfigureMockMvc` (Boot 4: `org.springframework.boot.webmvc.test.autoconfigure`); три контекста — `ConvertControllerTest` (пустой ключ), `ApiKeyFilterTest` (`properties = "wordpdf.api-key=…"`), `ConvertLimitsTest` (`@TestPropertySource` с лимитами — отдельный класс, не `@Nested`).
-- Регрессивные пары (фикс = нормализатор/pre-renderer + юнит + конвертер-тест с фикстурой): `StrictOoxmlNormalizerTest`↔`strictOoxml_convertsNotRejected` (+`pageCount_strictBreaksCountedLightweight` — lightweight против strict), `DocxOnOffNormalizerTest`↔`ruPlain_regularRunsUseRegularFont`, `SymbolFontNormalizerTest`↔`symbolFonts_bulletsAreNotHash`, `FieldNormalizerTest`↔`pageNumbers_recomputedNotCached`, `GlyphCoverageNormalizerTest`↔`exoticGlyphs_drawnNotHash`, `WordPdfValidatorTest`↔`staleCachePageCountRejectedBeforeRender` (+`checkPageCountLightweight_agreesWithJaxbPath` 99/100/101, `pageCount_breaksInsideTablesAreCounted`, `pageCount_continuousSectionsNotCountedLightweight`), `BundledFontsTest`↔`ruPlain_emDashEmbeddedNotHelvetica`, `ChartSpecTest`↔автозаголовки, chart-пейнтеры↔`chartsSmartArt_drawingsBecomeImages` (+`drawingToggles_offRemovesRasters`/`drawingToggles_chartsOffSmartArtOn`); `noLoggingWarningInPdf` — регрессия `slf4j-simple`, `pdfTitle_comesFromParameter` — регрессия PDF-title (юнит-партнёра нет). App-регрессии: `requestLimitParams_areIgnored`, `nonPositiveLimits_failStartup`, `unknownPath_notFound`, `concurrentRequests_bothSucceed` (гонка реестра `PhysicalFonts`), `corruptNotAZip_rejected`, `junkInsideValidZip_conversionError`, `nonDocxFilename_rejected`, `oversizedOverCoreLimit_rejected`, `renderFlagsOff_convertsWithoutDrawings`, `cyrillicAndPathInFilename_sanitizedResponseName` (RFC 5987 + path-traversal), `docsOpenWithoutKey`/`forwardedPrefix_healthStaysOpen`/`forwardedPrefix_docsOpenWithoutKey` (открытая документация + матч фильтра без forwarded-contextPath).
+- Регрессивные пары (фикс = нормализатор/pre-renderer + юнит + конвертер-тест с фикстурой): `StrictOoxmlNormalizerTest`↔`strictOoxml_convertsNotRejected` (+`pageCount_strictBreaksCountedLightweight` — lightweight против strict), `DocxOnOffNormalizerTest`↔`ruPlain_regularRunsUseRegularFont`, `SymbolFontNormalizerTest`↔`symbolFonts_bulletsAreNotHash`, `FieldNormalizerTest`↔`pageNumbers_recomputedNotCached`, `GlyphCoverageNormalizerTest`↔`exoticGlyphs_drawnNotHash`, `WordPdfValidatorTest`↔`staleCachePageCountRejectedBeforeRender` (+`checkPageCountLightweight_agreesWithJaxbPath` 99/100/101, `pageCount_breaksInsideTablesAreCounted`, `pageCount_continuousSectionsNotCountedLightweight`), `BundledFontsTest`↔`ruPlain_emDashEmbeddedNotHelvetica`, `ChartSpecTest`↔автозаголовки, chart-пейнтеры↔`chartsSmartArt_drawingsBecomeImages` (+`drawingToggles_offRemovesRasters`/`drawingToggles_chartsOffSmartArtOn`), `DocToPdfTest`↔`DocToPdfRenderer` (`legacyDoc_convertsToPdf` — Tinos/Carlito без Helvetica + 43 картинки; `legacyDoc_footersCarryPageNumbers` — инъекция колонтитулов + PAGE; `ole2Junk_rejected`); `noLoggingWarningInPdf` — регрессия `slf4j-simple`, `pdfTitle_comesFromParameter` — регрессия PDF-title (юнит-партнёра нет). App-регрессии: `requestLimitParams_areIgnored`, `nonPositiveLimits_failStartup`, `unknownPath_notFound`, `concurrentRequests_bothSucceed` (гонка реестра `PhysicalFonts`), `corruptNotAZip_rejected`, `junkInsideValidZip_conversionError`, `nonDocxFilename_rejected`, `oversizedOverCoreLimit_rejected`, `renderFlagsOff_convertsWithoutDrawings`, `cyrillicAndPathInFilename_sanitizedResponseName` (RFC 5987 + path-traversal), `docsOpenWithoutKey`/`forwardedPrefix_healthStaysOpen`/`forwardedPrefix_docsOpenWithoutKey` (открытая документация + матч фильтра без forwarded-contextPath), `legacyDoc_convertsToPdf` (OLE2-развилка `ConversionService.validate` + заголовок `X-Wordpdf-Degraded`).
- UI-тестов нет; гейт SPA — `npm run build` (tsc -b) + `npm run lint` (oxlint, `.oxlintrc.json`: rules-of-hooks error, only-export-components warn).
diff --git a/pom.xml b/pom.xml
index 5f90257..dc13f0f 100644
--- a/pom.xml
+++ b/pom.xml
@@ -85,6 +85,12 @@
pdfbox
${pdfbox.version}
+
+
+ org.apache.poi
+ poi-scratchpad
+ ${poi.version}
+
org.apache.poi
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 34e1cd2..dea3796 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
@@ -117,11 +117,13 @@ final class ConversionService {
* из конфигурации сервера: свойства {@code wordpdf.max-bytes}/
* {@code wordpdf.max-pages}, дефолт — константы ядра).
*
- * Проверка zip-подписи отдельным шагом обязательна:
+ *
Проверка подписи контейнера отдельным шагом обязательна:
* {@code ZipInputStream.getNextEntry()} на не-zip-потоке возвращает
* {@code null} молча, и {@link WordPdfValidator#checkPageCountLightweight(byte[])}
* такой вход не отверг бы (0 страниц). Регрессия —
- * ConvertControllerTest#corruptNotAZip_rejected.
+ * ConvertControllerTest#corruptNotAZip_rejected. Бинарный .doc — не zip,
+ * а OLE2 (CFB): для него свой магик и свой счётчик страниц
+ * ({@link WordPdfValidator#checkDocPageCountLightweight(byte[], int)}).
*/
void validate(byte[] docxBytes, ConvertOptions options) {
try {
@@ -129,17 +131,31 @@ final class ConversionService {
} catch (ConversionException e) {
throw new ValidationException(e.getMessage(), e);
}
- if (docxBytes.length < 4 || docxBytes[0] != 'P' || docxBytes[1] != 'K'
- || (docxBytes[2] & 0xFF) != 0x03 || (docxBytes[3] & 0xFF) != 0x04) {
- throw new ValidationException("Содержимое не похоже на .docx (не zip-архив)");
+ boolean zip = docxBytes.length >= 4 && docxBytes[0] == 'P' && docxBytes[1] == 'K'
+ && (docxBytes[2] & 0xFF) == 0x03 && (docxBytes[3] & 0xFF) == 0x04;
+ if (!zip && !isOle2(docxBytes)) {
+ throw new ValidationException("Содержимое не похоже на .docx или .doc");
}
try {
- WordPdfValidator.checkPageCountLightweight(docxBytes, options.maxPages());
+ if (zip) {
+ WordPdfValidator.checkPageCountLightweight(docxBytes, options.maxPages());
+ } else {
+ WordPdfValidator.checkDocPageCountLightweight(docxBytes, options.maxPages());
+ }
} catch (ConversionException e) {
throw new ValidationException(e.getMessage(), e);
}
}
+ /** Магик OLE2 (CFB): {@code D0 CF 11 E0 A1 B1 1A E1} — контейнер .doc. */
+ private static boolean isOle2(byte[] bytes) {
+ return bytes.length >= 8
+ && (bytes[0] & 0xFF) == 0xD0 && (bytes[1] & 0xFF) == 0xCF
+ && (bytes[2] & 0xFF) == 0x11 && (bytes[3] & 0xFF) == 0xE0
+ && (bytes[4] & 0xFF) == 0xA1 && (bytes[5] & 0xFF) == 0xB1
+ && (bytes[6] & 0xFF) == 0x1A && (bytes[7] & 0xFF) == 0xE1;
+ }
+
/**
* Тело задачи воркера. Ядро принимает байты — временные файлы не нужны;
* имя влияет только на заголовок PDF (параметр {@code title}), потому
@@ -163,7 +179,7 @@ final class ConversionService {
/**
* Санитизация имени (единый источник для имени файла и Content-Disposition):
* без каталога, только буквы/цифры/пробел/ {@code . _ -}, без суффикса
- * .docx; пустое после очистки → {@code document}. Кириллица разрешена —
+ * .docx/.doc; пустое после очистки → {@code document}. Кириллица разрешена —
* на Linux это валидное имя файла, и заголовок PDF остаётся читаемым.
*/
static String safeBaseName(String original) {
@@ -171,8 +187,11 @@ final class ConversionService {
: original.substring(Math.max(original.lastIndexOf('/'),
original.lastIndexOf('\\')) + 1);
base = base.replaceAll("[^\\p{L}\\p{N} ._-]", "");
- if (base.toLowerCase(Locale.ROOT).endsWith(".docx")) {
- base = base.substring(0, base.length() - ".docx".length());
+ String lower = base.toLowerCase(Locale.ROOT);
+ String suffix = lower.endsWith(".docx") ? ".docx"
+ : lower.endsWith(".doc") ? ".doc" : null;
+ if (suffix != null) {
+ base = base.substring(0, base.length() - suffix.length());
}
if (base.isBlank()) {
base = "document";
diff --git a/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ConvertController.java b/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ConvertController.java
index 63b5dba..2b643d9 100644
--- a/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ConvertController.java
+++ b/wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/ConvertController.java
@@ -20,7 +20,7 @@ import java.util.Locale;
/**
* Единственный эндпоинт API: {@code POST /api/v1/convert} — multipart-поле
- * {@code file} (.docx) → синхронный ответ байтами PDF.
+ * {@code file} (.docx или бинарный .doc) → синхронный ответ байтами PDF.
*
* Здесь только HTTP-слой: проверка presence/расширения и формирование
* {@code Content-Disposition}; проверка содержимого (zip, размер, страницы) —
@@ -57,11 +57,14 @@ final class ConvertController {
this.maxPages = maxPages;
}
- @Operation(summary = "Конвертировать .docx в PDF",
+ @Operation(summary = "Конвертировать .docx или .doc в PDF",
description = "renderCharts/renderSmartArt/errorOnCharts/errorOnSmartArt — факультативно, "
+ "по умолчанию настройки ядра; render-флаг приоритетнее error-флага. "
+ "Лимиты входа (размер/страницы) задаёт только конфигурация сервера "
- + "(свойства wordpdf.max-bytes/wordpdf.max-pages), параметрами запроса не переопределяются")
+ + "(свойства wordpdf.max-bytes/wordpdf.max-pages), параметрами запроса не переопределяются. "
+ + ".doc (Word 97-2003) конвертируется с деградацией вёрстки: шрифты — аналоги из бандла, "
+ + "колонтитулы переносятся, диаграммы — как встроенные превью-изображения; "
+ + "renderCharts/renderSmartArt/errorOn* на .doc не влияют")
@SecurityRequirement(name = OpenApiConfig.SCHEME)
@PostMapping(
path = "/api/v1/convert",
@@ -77,9 +80,10 @@ final class ConvertController {
throw new ValidationException("Файл не передан (multipart-поле «file» обязательно)");
}
String name = file.getOriginalFilename();
- if (name == null || !name.toLowerCase(Locale.ROOT).endsWith(".docx")) {
+ if (name == null || !(name.toLowerCase(Locale.ROOT).endsWith(".docx")
+ || name.toLowerCase(Locale.ROOT).endsWith(".doc"))) {
// расширение проверяется здесь: ядро с байтов его не видит
- throw new ValidationException("Поддерживается только .docx (без .doc): " + name);
+ throw new ValidationException("Поддерживаются только .docx и .doc: " + name);
}
byte[] docxBytes;
try {
@@ -97,9 +101,15 @@ final class ConvertController {
ContentDisposition disposition = ContentDisposition.attachment()
.filename(ConversionService.safeBaseName(name) + ".pdf", StandardCharsets.UTF_8)
.build();
- return ResponseEntity.ok()
+ ResponseEntity.BodyBuilder response = ResponseEntity.ok()
.contentType(MediaType.APPLICATION_PDF)
- .header(HttpHeaders.CONTENT_DISPOSITION, disposition.toString())
- .body(pdf);
+ .header(HttpHeaders.CONTENT_DISPOSITION, disposition.toString());
+ if (name.toLowerCase(Locale.ROOT).endsWith(".doc")) {
+ // .doc (не .docx): POI HWPF даёт дрейф вёрстки, колонтитулы —
+ // инъекция в FO-DOM, экзотические глифы остаются .notdef —
+ // клиент обязан знать о деградации (см. internal.DocToPdfRenderer).
+ response = response.header("X-Wordpdf-Degraded", "headers-footers-exotic-glyphs");
+ }
+ return response.body(pdf);
}
}
diff --git a/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConvertControllerTest.java b/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConvertControllerTest.java
index 664ac0a..2f79a1d 100644
--- a/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConvertControllerTest.java
+++ b/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConvertControllerTest.java
@@ -113,6 +113,7 @@ class ConvertControllerTest {
.andExpect(content().contentType(MediaType.APPLICATION_PDF))
.andExpect(header().string(HttpHeaders.CONTENT_DISPOSITION,
org.hamcrest.Matchers.containsString("filename*=UTF-8''ru-plain.pdf")))
+ .andExpect(header().doesNotExist("X-Wordpdf-Degraded"))
.andReturn();
byte[] pdf = result.getResponse().getContentAsByteArray();
assertTrue(new String(pdf, 0, 4, StandardCharsets.US_ASCII).equals("%PDF"),
@@ -326,14 +327,40 @@ class ConvertControllerTest {
@Test
void corruptNotAZip_rejected() throws Exception {
- // без zip-подписи ZipInputStream молча даёт 0 записей — отсекает
- // отдельная проверка magic bytes
+ // без подписи контейнера (zip для .docx, OLE2 для .doc) лёгкий
+ // счётчик страниц молчит — отсекает отдельная проверка magic bytes
mockMvc.perform(multipart("/api/v1/convert")
.file(docx("broken.docx", "это просто текст, не архив"
.getBytes(StandardCharsets.UTF_8))))
.andExpect(status().isBadRequest())
.andExpect(jsonPath("$.error",
- org.hamcrest.Matchers.containsString("не zip-архив")));
+ org.hamcrest.Matchers.containsString("не похоже на .docx или .doc")));
+ }
+
+ /**
+ * Бинарный .doc проходит тот же эндпоинт: расширение принято, ядро
+ * выбирает POI-ветку по OLE2-магику, ответ несёт заголовок деградации
+ * X-Wordpdf-Degraded (контракт AGENTS.md); у .docx его нет.
+ * Регрессия — ConvertController (расширения + заголовок) +
+ * ConversionService#validate (магик), фикстура /samples/legacy-doc.doc
+ * (test-jar core).
+ */
+ @Test
+ void legacyDoc_convertsToPdf() throws Exception {
+ MvcResult result = mockMvc.perform(multipart("/api/v1/convert")
+ .file(docx("testDoc.doc", bytes("/samples/legacy-doc.doc"))))
+ .andExpect(status().isOk())
+ .andExpect(content().contentType(MediaType.APPLICATION_PDF))
+ .andExpect(header().string(HttpHeaders.CONTENT_DISPOSITION,
+ org.hamcrest.Matchers.containsString("filename*=UTF-8''testDoc.pdf")))
+ .andExpect(header().string("X-Wordpdf-Degraded",
+ "headers-footers-exotic-glyphs"))
+ .andReturn();
+ byte[] pdf = result.getResponse().getContentAsByteArray();
+ assertTrue(new String(pdf, 0, 4, StandardCharsets.US_ASCII).equals("%PDF"),
+ "тело не начинается с %PDF");
+ String text = norm(pdfText(pdf));
+ assertTrue(text.contains("Нижний колонтитул"), "нет колонтитула: " + text);
}
@Test
diff --git a/wordpdf-core/pom.xml b/wordpdf-core/pom.xml
index c6df595..0f1c23b 100644
--- a/wordpdf-core/pom.xml
+++ b/wordpdf-core/pom.xml
@@ -37,6 +37,13 @@
slf4j-simple
+
+
+ org.apache.poi
+ poi-scratchpad
+
+
org.junit.jupiter
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 e811631..faff1b4 100644
--- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java
+++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java
@@ -16,6 +16,7 @@ import ru.pjandro.wordpdf.internal.FieldNormalizer;
import ru.pjandro.wordpdf.internal.GlyphCoverageNormalizer;
import ru.pjandro.wordpdf.internal.FopFallbackFonts;
import ru.pjandro.wordpdf.internal.StrictOoxmlNormalizer;
+import ru.pjandro.wordpdf.internal.DocToPdfRenderer;
import ru.pjandro.wordpdf.internal.SymbolFontNormalizer;
import java.io.ByteArrayInputStream;
@@ -54,8 +55,9 @@ public final class WordPdfConverter {
}
/**
- * Конвертирует байты .docx в PDF. Работа с файлами — забота вызывающего
- * (файловое API было здесь раньше; ядро пути не принимает).
+ * Конвертирует байты .docx (или бинарного .doc Word 97-2003 — ветка
+ * выбирается по магическому байту контейнера) в PDF. Работа с файлами — забота
+ * вызывающего (файловое API было здесь раньше; ядро пути не принимает).
*
* Вход проверяется валидатором до рендера: {@link WordPdfValidator#checkInput(byte[])}
* (null / больше {@link WordPdfSettings#MAX_INPUT_BYTES}), затем число страниц
@@ -108,6 +110,16 @@ public final class WordPdfConverter {
*/
private static void convertToStream(byte[] rawDocxBytes, String title, ConvertOptions options,
OutputStream os) throws Exception {
+ // 0. Бинарный .doc (Word 97-2003, OLE2-контейнер) — отдельная
+ // ветка: docx4j его не читает, нормализаторы (все — по zip-частям
+ // docx) тут бессмысленны. Флаги renderCharts/renderSmartArt/
+ // errorOn* для .doc — no-op: диаграмм как c:chart в .doc нет,
+ // превью встраиваемых объектов приходят картинками через
+ // PicturesManager (см. internal/DocToPdfRenderer).
+ if (isOle2(rawDocxBytes)) {
+ DocToPdfRenderer.render(rawDocxBytes, title, options, os);
+ return;
+ }
// 1. Маппер шрифтов. Порядок важен: конструктор запускает
// обнаружение системных шрифтов, затем бандл-шрифты из jar
// регистрируются поверх них (имеют приоритет).
@@ -181,4 +193,13 @@ public final class WordPdfConverter {
// пакет загружается в память и ничего не закрывает.
}
}
+
+ /** Магик OLE2 (CFB): {@code D0 CF 11 E0 A1 B1 1A E1} — контейнер .doc. */
+ private static boolean isOle2(byte[] bytes) {
+ return bytes != null && bytes.length >= 8
+ && (bytes[0] & 0xFF) == 0xD0 && (bytes[1] & 0xFF) == 0xCF
+ && (bytes[2] & 0xFF) == 0x11 && (bytes[3] & 0xFF) == 0xE0
+ && (bytes[4] & 0xFF) == 0xA1 && (bytes[5] & 0xFF) == 0xB1
+ && (bytes[6] & 0xFF) == 0x1A && (bytes[7] & 0xFF) == 0xE1;
+ }
}
diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfValidator.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfValidator.java
index 4225492..1f6895f 100644
--- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfValidator.java
+++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfValidator.java
@@ -1,6 +1,9 @@
package ru.pjandro.wordpdf;
import org.docx4j.openpackaging.packages.WordprocessingMLPackage;
+import org.apache.poi.hwpf.HWPFDocument;
+import org.apache.poi.poifs.filesystem.POIFSFileSystem;
+import org.apache.poi.ddf.EscherRecordTypes;
import org.docx4j.wml.Br;
import org.docx4j.wml.ContentAccessor;
import org.docx4j.wml.P;
@@ -153,6 +156,44 @@ public final class WordPdfValidator {
}
}
+ /**
+ * Проверяет число страниц бинарного .doc (Word 97-2003) по кэшу
+ * {@code SummaryInformation.PageCount} — аналогу {@code docProps/app.xml}
+ * в docx-пути: Word переписывает его при сохранении, пост-рендерной
+ * проверки нет осознанно (как в docx-ветке — доверяем кэшу до рендера).
+ * Кэш пуст или ноль — проверка пропускается (посчитать дёшево нельзя,
+ * отвергать валидный документ по отсутствию кэша неправильно).
+ *
+ * @throws ConversionException при {@code null}, ошибке разбора OLE2 или превышении {@link WordPdfSettings#MAX_PAGES}
+ */
+ public static void checkDocPageCountLightweight(byte[] docBytes) throws ConversionException {
+ checkDocPageCountLightweight(docBytes, WordPdfSettings.MAX_PAGES);
+ }
+
+ /**
+ * То же, что {@link #checkDocPageCountLightweight(byte[])}, с явным
+ * лимитом страниц (переопределение на вызов, см. {@link ConvertOptions#maxPages()}).
+ *
+ * @throws ConversionException при {@code null}, ошибке разбора OLE2 или превышении {@code maxPages}
+ */
+ public static void checkDocPageCountLightweight(byte[] docBytes, int maxPages) throws ConversionException {
+ if (docBytes == null) {
+ throw new ConversionException("Не указаны байты входного .doc");
+ }
+ int pages;
+ try (POIFSFileSystem fs = new POIFSFileSystem(new ByteArrayInputStream(docBytes));
+ HWPFDocument hwpf = new HWPFDocument(fs)) {
+ org.apache.poi.hpsf.SummaryInformation si = hwpf.getSummaryInformation();
+ pages = si == null ? 0 : si.getPageCount();
+ } catch (IOException | RuntimeException e) {
+ throw new ConversionException("Не удалось разобрать байты .doc", e);
+ }
+ if (pages > maxPages) {
+ throw new ConversionException("Документ длиннее " + maxPages
+ + " страниц: получено не менее " + pages);
+ }
+ }
+
/**
* Считает страницы .docx в байтах и проверяет лимит.
*
diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/DocToPdfRenderer.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/DocToPdfRenderer.java
new file mode 100644
index 0000000..b797a8b
--- /dev/null
+++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/DocToPdfRenderer.java
@@ -0,0 +1,759 @@
+package ru.pjandro.wordpdf.internal;
+
+import org.apache.fop.apps.FOUserAgent;
+import org.apache.fop.apps.Fop;
+import org.apache.fop.apps.FopFactory;
+import org.apache.fop.apps.MimeConstants;
+import org.apache.poi.hwpf.HWPFDocument;
+import org.apache.poi.hwpf.converter.FontReplacer;
+import org.apache.poi.hwpf.converter.PicturesManager;
+import org.apache.poi.hwpf.converter.WordToFoConverter;
+import org.apache.poi.hwpf.usermodel.CharacterRun;
+import org.apache.poi.hwpf.usermodel.HeaderStories;
+import org.apache.poi.hwpf.usermodel.Paragraph;
+import org.apache.poi.hwpf.usermodel.PictureType;
+import org.apache.poi.hwpf.usermodel.Range;
+import org.apache.poi.poifs.filesystem.POIFSFileSystem;
+import org.w3c.dom.Document;
+import org.w3c.dom.Element;
+import org.w3c.dom.Node;
+import org.w3c.dom.NodeList;
+import ru.pjandro.wordpdf.ConversionException;
+import ru.pjandro.wordpdf.ConvertOptions;
+import ru.pjandro.wordpdf.fonts.BundledFontMapper;
+import ru.pjandro.wordpdf.fonts.BundledFonts;
+
+import javax.xml.parsers.DocumentBuilderFactory;
+import javax.xml.transform.dom.DOMSource;
+import javax.xml.transform.sax.SAXResult;
+
+import java.io.ByteArrayInputStream;
+import java.io.IOException;
+import java.io.OutputStream;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.ArrayList;
+import java.util.Comparator;
+import java.util.List;
+import java.util.Locale;
+import java.util.stream.Stream;
+
+/**
+ * Рендер бинарного .doc (Word 97-2003, OLE2) в PDF: POI HWPF -> XSL-FO ->
+ * Apache FOP (тот же форк, что в docx-ветке).
+ *
+ *
docx4j бинарный формат не читает, HWPF->XWPF конвертера в POI нет —
+ * поэтому для .doc отдельная ветка: {@link WordToFoConverter} строит FO
+ * из HWPF-модели напрямую, а колонтитулы (которые POI в FO не пишет)
+ * дописываются в FO-DOM по {@link HeaderStories}.
+ *
+ *
Известная деградация против Word (принята): дрейф вёрстки (FO POI
+ * беднее docx4j-экспорта), шрифты — бандл-аналоги, колонтитулы — по
+ * одной (odd) истории на секцию, first/even-варианты — эвристикой
+ * «непустая история => вариант» (флаги titlePg/evenAndOdd POI не отдаёт).
+ * Флаги {@code renderCharts}/{@code renderSmartArt} для .doc — no-op:
+ * диаграмм как {@code c:chart} в .doc нет, превью встраиваемых объектов
+ * приходят картинками через {@link PicturesManager}.
+ */
+public final class DocToPdfRenderer {
+
+ private DocToPdfRenderer() {
+ }
+
+ private static final String FO_NS = "http://www.w3.org/1999/XSL/Format";
+
+ /** Маркеры полей Word в тексте HWPF-ранов. */
+ private static final char FIELD_BEGIN = '\u0013';
+ private static final char FIELD_SEPARATOR = '\u0014';
+ private static final char FIELD_END = '\u0015';
+ /** Маркер конца секции в историях колонтитулов. */
+ private static final char SECTION_END = '\u000c';
+ /** Конец абзаца / конец ячейки таблицы в тексте HWPF. */
+ private static final char PARA_END = '\r';
+ private static final char CELL_END = '\u0007';
+
+ /** Зазор между текстом колонтитула и областью контента. */
+ private static final double REGION_GAP_IN = 0.15;
+
+
+ /**
+ * Полный путь .doc -> PDF в поток. Все ошибки — {@link ConversionException}.
+ *
+ * @param docBytes байты OLE2 (.doc)
+ * @param title заголовок PDF (метаданные); {@code null}/пустая — не задаётся
+ * @param options настройки вызова (для .doc флаги рисования — no-op)
+ * @param out приёмник байтов PDF
+ */
+ public static void render(byte[] docBytes, String title, ConvertOptions options,
+ OutputStream out) throws ConversionException {
+ Path workDir = null;
+ try {
+ // init() идемпотентен; restrictToBundled() не нужен — FOP-конфиг
+ // строится явно (auto-detect="false"), системные шрифты в него не попадают.
+ BundledFonts.init();
+ workDir = Files.createTempDirectory("wordpdf-doc-");
+ Path picsDir = Files.createDirectory(workDir.resolve("pics"));
+
+ Document foDoc;
+ try (POIFSFileSystem fs = new POIFSFileSystem(new ByteArrayInputStream(docBytes));
+ HWPFDocument hwpf = new HWPFDocument(fs)) {
+
+ DocumentBuilderFactory dbf = DocumentBuilderFactory.newInstance();
+ dbf.setNamespaceAware(true);
+ Document dom = dbf.newDocumentBuilder().newDocument();
+ WordToFoConverter converter = new WordToFoConverter(dom);
+ converter.setFontReplacer(DocToPdfRenderer::replaceFont);
+ converter.setPicturesManager(new TempPictures(picsDir));
+ converter.processDocument(hwpf);
+ foDoc = converter.getDocument();
+ applyDefaultFont(foDoc);
+
+ injectHeadersAndFooters(foDoc, hwpf);
+ }
+
+ renderFo(foDoc, title, workDir, out);
+ } catch (ConversionException e) {
+ throw e;
+ } catch (Exception e) {
+ throw new ConversionException("Не удалось конвертировать документ .doc", e);
+ } finally {
+ if (workDir != null) {
+ deleteRecursively(workDir);
+ }
+ }
+ }
+
+ // ==================== Шрифты ====================
+
+ /**
+ * Замена шрифта ранa на бандл-аналог: имя из name-таблицы TTF
+ * regular-варианта (тот же механизм triplet-имён, что в
+ * {@link FopFallbackFonts}) — FO запрашивает именно его.
+ */
+ private static FontReplacer.Triplet replaceFont(FontReplacer.Triplet t) {
+ String family = BundledFontMapper.bundledFamily(
+ t.fontName == null ? "" : t.fontName);
+ var regular = BundledFonts.regular(family);
+ if (regular != null) {
+ t.fontName = regular.getName();
+ }
+ return t;
+ }
+
+ /** Картинки во временный каталог; FO ссылается на них file:-URI. */
+ private static final class TempPictures implements PicturesManager {
+ private final Path dir;
+
+ TempPictures(Path dir) {
+ this.dir = dir;
+ }
+
+ @Override
+ public String savePicture(byte[] content, PictureType pictureType,
+ String suggestedName, float widthInches, float heightInches) {
+ try {
+ if (content == null || content.length == 0) {
+ // пустой объект (напр. превью удалённого рисунка) — FOP
+ // падает на нём с EOFException, ссылка не нужна
+ return null;
+ }
+ String name = suggestedName == null ? "" :
+ suggestedName.replaceAll("[^A-Za-z0-9._-]", "_");
+ if (name.isEmpty()) {
+ String ext = pictureType == null
+ ? PictureType.UNKNOWN.getExtension()
+ : pictureType.getExtension();
+ name = "pic-" + java.util.Arrays.hashCode(content) + "." + ext;
+ }
+ Path file = dir.resolve(name);
+ Files.write(file, content);
+ return file.toUri().toString();
+ } catch (IOException e) {
+ // деградация вместо падения: картинка без ссылки просто исчезнет
+ return null;
+ }
+ }
+ }
+
+ // ==================== Колонтитулы ====================
+
+ /**
+ * POI не пишет колонтитулы в FO. Достаём их из {@link HeaderStories},
+ * разбиваем на чанки по секциям (маркер конца секции {@code \u000c}) и
+ * вставляем в FO-DOM: {@code fo:region-before}/{@code fo:region-after}
+ * в мастер + {@code fo:static-content} в page-sequence.
+ */
+ private static void injectHeadersAndFooters(Document foDoc, HWPFDocument hwpf) {
+ NodeList sequences = foDoc.getElementsByTagNameNS(FO_NS, "page-sequence");
+ if (sequences.getLength() == 0) {
+ return;
+ }
+ HeaderStories hs = new HeaderStories(hwpf);
+ // Императивный список: javac 21 не выводит T для List.of/Arrays.asList
+ // из вложенных дженерик-аргументов (varargs inference).
+ List>> stories = new ArrayList<>();
+ stories.add(chunkBySection(hs.getOddHeaderSubrange(), sequences.getLength()));
+ stories.add(chunkBySection(hs.getEvenHeaderSubrange(), sequences.getLength()));
+ stories.add(chunkBySection(hs.getFirstHeaderSubrange(), sequences.getLength()));
+ stories.add(chunkBySection(hs.getOddFooterSubrange(), sequences.getLength()));
+ stories.add(chunkBySection(hs.getEvenFooterSubrange(), sequences.getLength()));
+ stories.add(chunkBySection(hs.getFirstFooterSubrange(), sequences.getLength()));
+
+ // NUMPAGES/SECTIONPAGES -> citation-last по ПОСЛЕДНЕМУ мастеру
+ // документа: нумерация FOP между page-sequence непрерывна.
+ String lastMaster = ((Element) sequences.item(sequences.getLength() - 1))
+ .getAttribute("master-reference");
+ for (int i = 0; i < sequences.getLength(); i++) {
+ Element seq = (Element) sequences.item(i);
+ String masterName = seq.getAttribute("master-reference");
+ Element master = findMaster(foDoc, masterName);
+ if (master == null) {
+ continue;
+ }
+ String[] margins = parseMarginShorthand(master);
+ if (margins == null) {
+ continue;
+ }
+
+ // Форк FOP (docx4j-fo-renderer) вырезал PageMaster.setupRegions:
+ // viewport region-body = page-area минус СОБСТВЕННЫЕ margin'ы
+ // body, extent'ы region-before/after body не вычитаются. Поэтому
+ // margin'ы region-body (шортхэнд POI = Word-поля) сохраняются —
+ // единственная защита от наезда текста на колонтитулы; extent'ы
+ // регионов только размещают сами колонтитулы.
+ // Порядок детей simple-page-master: body -> before -> after
+ // (требование валидации форка).
+ if (hasText(stories.get(0).get(i))) {
+ appendRegion(master, "region-before", margins[0], "after");
+ insertStaticContent(seq, "xsl-region-before",
+ blocks(foDoc, stories.get(0).get(i), lastMaster), "margin-bottom");
+ }
+ if (hasText(stories.get(3).get(i))) {
+ appendRegion(master, "region-after", margins[2], "before");
+ insertStaticContent(seq, "xsl-region-after",
+ blocks(foDoc, stories.get(3).get(i), lastMaster), "margin-top");
+ }
+
+ // first/even — эвристика: непустая история => вариант существует.
+ boolean hasFirst = hasText(stories.get(2).get(i)) || hasText(stories.get(5).get(i));
+ boolean hasEven = hasText(stories.get(1).get(i)) || hasText(stories.get(4).get(i));
+ if (!hasFirst && !hasEven) {
+ continue;
+ }
+ List variants = new ArrayList<>();
+ if (hasFirst) {
+ Element clone = (Element) master.cloneNode(true);
+ String name = masterName + "-first";
+ clone.setAttribute("master-name", name);
+ renameRegionFlows(clone, "-first");
+ foDoc.getDocumentElement().insertBefore(clone, master.getNextSibling());
+ if (hasText(stories.get(2).get(i))) {
+ insertStaticContent(seq, "xsl-region-before-first",
+ blocks(foDoc, stories.get(2).get(i), lastMaster), "margin-bottom");
+ }
+ if (hasText(stories.get(5).get(i))) {
+ insertStaticContent(seq, "xsl-region-after-first",
+ blocks(foDoc, stories.get(5).get(i), lastMaster), "margin-top");
+ }
+ variants.add(clone);
+ }
+ if (hasEven) {
+ Element clone = (Element) master.cloneNode(true);
+ String name = masterName + "-even";
+ clone.setAttribute("master-name", name);
+ renameRegionFlows(clone, "-even");
+ foDoc.getDocumentElement().insertBefore(clone, master.getNextSibling());
+ if (hasText(stories.get(1).get(i))) {
+ insertStaticContent(seq, "xsl-region-before-even",
+ blocks(foDoc, stories.get(1).get(i), lastMaster), "margin-bottom");
+ }
+ if (hasText(stories.get(4).get(i))) {
+ insertStaticContent(seq, "xsl-region-after-even",
+ blocks(foDoc, stories.get(4).get(i), lastMaster), "margin-top");
+ }
+ variants.add(clone);
+ }
+ wrapInPageSequenceMaster(foDoc, master, variants);
+ }
+ }
+
+ /**
+ * История колонтитулов — конкатенация одноимённых историй всех секций;
+ * конец секции помечен {@code \u000c} в последнем параграфе. Чанков не
+ * столько, сколько секций — деградация: один чанк раздаётся всем.
+ */
+ private static List> chunkBySection(Range story, int sectionCount) {
+ List> chunks = new ArrayList<>();
+ if (story != null && story.numParagraphs() > 0) {
+ List current = new ArrayList<>();
+ for (int i = 0; i < story.numParagraphs(); i++) {
+ Paragraph p;
+ String text;
+ try {
+ p = story.getParagraph(i);
+ text = p.text();
+ } catch (RuntimeException e) {
+ continue;
+ }
+ current.add(p);
+ if (text != null && text.indexOf(SECTION_END) >= 0) {
+ chunks.add(current);
+ current = new ArrayList<>();
+ }
+ }
+ if (!current.isEmpty()) {
+ chunks.add(current);
+ }
+ }
+ if (chunks.isEmpty()) {
+ for (int i = 0; i < sectionCount; i++) {
+ chunks.add(null);
+ }
+ } else if (chunks.size() != sectionCount) {
+ List first = chunks.get(0);
+ chunks = new ArrayList<>();
+ for (int i = 0; i < sectionCount; i++) {
+ chunks.add(first);
+ }
+ }
+ return chunks;
+ }
+
+ private static Element findMaster(Document foDoc, String masterName) {
+ NodeList masters = foDoc.getElementsByTagNameNS(FO_NS, "simple-page-master");
+ for (int i = 0; i < masters.getLength(); i++) {
+ Element m = (Element) masters.item(i);
+ if (masterName.equals(m.getAttribute("master-name"))) {
+ return m;
+ }
+ }
+ return null;
+ }
+
+ /** {@code margin="T R B L"} region-body мастера (шортхэнд POI). */
+ private static String[] parseMarginShorthand(Element master) {
+ Element body = child(master, "region-body");
+ if (body == null) {
+ return null;
+ }
+ String margin = body.getAttribute("margin");
+ if (margin == null) {
+ return null;
+ }
+ String[] parts = margin.trim().split("\\s+");
+ return parts.length == 4 ? parts : null;
+ }
+
+ /**
+ * Регион колонтитула: extent = поле страницы, текст прижат к body
+ * (низ заголовка / верх футера); зазор — маргинами блоков.
+ */
+ private static Element appendRegion(Element master, String kind, String extent,
+ String displayAlign) {
+ Element region = master.getOwnerDocument().createElementNS(FO_NS, "fo:" + kind);
+ region.setAttribute("extent", extent);
+ region.setAttribute("display-align", displayAlign);
+ master.appendChild(region);
+ return region;
+ }
+
+ /** В master-клоне варианта колонтитулы берутся из своего потока. */
+ private static void renameRegionFlows(Element clone, String suffix) {
+ for (String kind : new String[]{"region-before", "region-after"}) {
+ Element region = child(clone, kind);
+ if (region != null) {
+ region.setAttribute("flow-name", "xsl-" + kind + suffix);
+ }
+ }
+ }
+
+ /**
+ * Мастер с first/even-вариантами оборачивается в
+ * {@code fo:page-sequence-master} (на месте); {@code master-reference}
+ * page-sequence не меняется — он указывает на имя обёртки.
+ */
+ private static void wrapInPageSequenceMaster(Document foDoc, Element master,
+ List variants) {
+ String masterName = master.getAttribute("master-name");
+ Element psm = foDoc.createElementNS(FO_NS, "fo:page-sequence-master");
+ psm.setAttribute("master-name", masterName);
+ Element alternatives = foDoc.createElementNS(FO_NS,
+ "fo:repeatable-page-master-alternatives");
+ psm.appendChild(alternatives);
+ for (Element variant : variants) {
+ String position = variant.getAttribute("master-name").endsWith("-first")
+ ? "first" : "even";
+ alternatives.appendChild(conditionalRef(foDoc, position,
+ variant.getAttribute("master-name")));
+ }
+ alternatives.appendChild(conditionalRef(foDoc, "rest", masterName));
+ master.getParentNode().replaceChild(psm, master);
+ }
+
+ private static Element conditionalRef(Document foDoc, String position, String masterRef) {
+ Element ref = foDoc.createElementNS(FO_NS, "fo:conditional-page-master-reference");
+ ref.setAttribute("master-reference", masterRef);
+ ref.setAttribute("page-position", position);
+ return ref;
+ }
+
+ /**
+ * static-content вставляется в page-sequence перед fo:flow; каждый блок
+ * получает зазор {@code gapAttribute} к области контента (в самих
+ * регионах padding запрещён XSL 1.1 — FOP валидирует).
+ */
+ private static void insertStaticContent(Element sequence, String flowName,
+ List content, String gapAttribute) {
+ if (content.isEmpty()) {
+ return;
+ }
+ Document doc = sequence.getOwnerDocument();
+ Element staticContent = doc.createElementNS(FO_NS, "fo:static-content");
+ staticContent.setAttribute("flow-name", flowName);
+ for (Element block : content) {
+ block.setAttribute(gapAttribute, REGION_GAP_IN + "in");
+ staticContent.appendChild(block);
+ }
+ Element flow = child(sequence, "flow");
+ if (flow == null) {
+ sequence.appendChild(staticContent);
+ } else {
+ sequence.insertBefore(staticContent, flow);
+ }
+ }
+
+ // ==================== История -> блоки FO ====================
+
+ /** Параграфы чанка истории как {@code fo:block}-и; пустой чанк — пустой список. */
+ private static List blocks(Document foDoc, List chunk,
+ String lastMasterName) {
+ List result = new ArrayList<>();
+ if (chunk == null) {
+ return result;
+ }
+ for (Paragraph p : chunk) {
+ Element block = paragraphBlock(foDoc, p, lastMasterName);
+ if (block != null && blockHasVisibleContent(block)) {
+ result.add(block);
+ }
+ }
+ return result;
+ }
+
+ /**
+ * Параграф истории как {@code fo:block}: выравнивание, табуляции, раны с
+ * форматированием и поля (PAGE/NUMPAGES/SECTIONPAGES) из управляющих
+ * символов текста ранов ({@code \u0013}\u2026{@code \u0014}\u2026{@code \u0015}).
+ */
+ private static Element paragraphBlock(Document doc, Paragraph p,
+ String lastMasterName) {
+ Element block = doc.createElementNS(FO_NS, "fo:block");
+ block.setAttribute("text-align", switch (p.getJustification()) {
+ case 1 -> "center";
+ case 2 -> "end";
+ case 3 -> "justify";
+ default -> "start";
+ });
+ // Наследуемый шрифт блока: fo:page-number — пустой элемент, без
+ // font-family блока FOP рисует его базовым Helvetica.
+ var blockFont = firstRunFont(p);
+ block.setAttribute("font-family", blockFont != null
+ ? blockFont.getName()
+ : BundledFonts.regular(BundledFonts.FALLBACK_FAMILY).getName());
+ // state-machine полей: 0 — обычный текст, 1 — инструкция, 2 — кэш-результат
+ StringBuilder instr = new StringBuilder();
+ StringBuilder cached = new StringBuilder();
+ StringBuilder plain = new StringBuilder();
+ int column = 0;
+ int mode = 0;
+ for (int j = 0; j < p.numCharacterRuns(); j++) {
+ CharacterRun cr;
+ String text;
+ try {
+ cr = p.getCharacterRun(j);
+ text = cr.text();
+ } catch (RuntimeException e) {
+ continue;
+ }
+ if (text == null) {
+ continue;
+ }
+ for (int k = 0; k < text.length(); k++) {
+ char c = text.charAt(k);
+ if (c == FIELD_BEGIN) {
+ mode = 1;
+ instr.setLength(0);
+ cached.setLength(0);
+ } else if (c == FIELD_SEPARATOR && mode == 1) {
+ mode = 2;
+ } else if (c == FIELD_END && (mode == 1 || mode == 2)) {
+ emitField(doc, block, instr.toString(), cached.toString(), lastMasterName);
+ mode = 0;
+ } else if (mode == 1) {
+ instr.append(c);
+ } else if (mode == 2) {
+ cached.append(c);
+ } else if (c == '\t') {
+ column = appendTab(doc, block, plain, column, cr);
+ } else {
+ plain.append(c);
+ }
+ }
+ }
+ if (mode != 0) {
+ // незакрытое поле: выводим накопленное как обычный текст
+ plain.append(instr).append(cached);
+ }
+ flushText(doc, block, plain.toString(), null);
+ return block;
+ }
+
+ /** Распознанные поля — живые FO-элементы; прочие — кэш-текст как есть. */
+ private static void emitField(Document doc, Element block, String instruction,
+ String cachedResult, String lastMasterName) {
+ String code = instruction.trim().toUpperCase(Locale.ROOT);
+ if (code.startsWith("PAGE")) {
+ Element pn = doc.createElementNS(FO_NS, "fo:page-number");
+ block.appendChild(pn);
+ } else if ((code.startsWith("NUMPAGES") || code.startsWith("SECTIONPAGES"))
+ && lastMasterName != null) {
+ // нумерация FOP между page-sequence непрерывна — citation-last
+ // по последнему мастеру = общее число страниц
+ Element pn = doc.createElementNS(FO_NS, "fo:page-number-citation-last");
+ pn.setAttribute("ref-name", lastMasterName);
+ block.appendChild(pn);
+ } else {
+ flushText(doc, block, cachedResult, null);
+ }
+ }
+
+ /**
+ * {@code \t}: FOP-форк не поддерживает свойство {@code tabs}, поэтому
+ * таб — пробелы до следующей дефолтной Word-остановки (1,25 см).
+ * Возвращает новую «колонку» (символы до курсора).
+ */
+ private static int appendTab(Document doc, Element block, StringBuilder plain,
+ int column, CharacterRun cr) {
+ flushText(doc, block, plain.toString(), null);
+ plain.setLength(0);
+ double charIn = charWidthIn(cr);
+ double step = 1.25 / 2.54;
+ double x = (column + 1) * charIn;
+ double target = (Math.floor(x / step) + 1) * step;
+ int spaces = (int) Math.max(1, Math.ceil((target - x) / charIn));
+ flushText(doc, block, " ".repeat(spaces), cr);
+ return column + 1 + spaces;
+ }
+
+ /** Приблизительная ширина символа (полширины кегля) в дюймах. */
+ private static double charWidthIn(CharacterRun cr) {
+ double pt = 10.0;
+ try {
+ if (cr != null && cr.getFontSize() > 0) {
+ pt = cr.getFontSize() / 2.0;
+ }
+ } catch (RuntimeException e) {
+ // наследование из стиля — остаётся дефолт
+ }
+ return Math.max(0.03, pt * 0.5 / 72.0);
+ }
+
+ private static void flushText(Document doc, Element block, String text,
+ CharacterRun cr) {
+ String cleaned = cleanText(text);
+ if (cleaned.isEmpty()) {
+ return;
+ }
+ if (cr == null) {
+ block.appendChild(doc.createTextNode(cleaned));
+ return;
+ }
+ Element inline = doc.createElementNS(FO_NS, "fo:inline");
+ var font = runFont(cr);
+ if (font != null) {
+ inline.setAttribute("font-family", font.getName());
+ }
+ int halfPoints = cr.getFontSize();
+ inline.setAttribute("font-size", (halfPoints > 0 ? halfPoints / 2.0 : 10.0) + "pt");
+ if (cr.isBold()) {
+ inline.setAttribute("font-weight", "bold");
+ }
+ if (cr.isItalic()) {
+ inline.setAttribute("font-style", "italic");
+ }
+ if (cr.getUnderlineCode() != 0) {
+ inline.setAttribute("text-decoration", "underline");
+ }
+ inline.appendChild(doc.createTextNode(cleaned));
+ block.appendChild(inline);
+ }
+
+ /** Шрифт рана -> бандл-аналог (тот же маппинг, что у основного текста). */
+ private static org.docx4j.fonts.PhysicalFont runFont(CharacterRun cr) {
+ String name;
+ try {
+ name = cr.getFontName();
+ } catch (RuntimeException e) {
+ return null;
+ }
+ String family = BundledFontMapper.bundledFamily(name == null ? "" : name);
+ return BundledFonts.regular(family);
+ }
+
+ /** Шрифт первого читаемого рана параграфа (для наследуемого font-family блока). */
+ private static org.docx4j.fonts.PhysicalFont firstRunFont(Paragraph p) {
+ try {
+ for (int j = 0; j < p.numCharacterRuns(); j++) {
+ var font = runFont(p.getCharacterRun(j));
+ if (font != null) {
+ return font;
+ }
+ }
+ } catch (RuntimeException e) {
+ // повреждённый параграф — на fallback вызывающего
+ }
+ return null;
+ }
+
+ /**
+ * POI пишет маркеры списков {@code fo:inline} без font-family — FOP
+ * рисует их базовым Helvetica. Проставляем фолбэк-семейство всем
+ * инлайнам без семейства.
+ */
+ private static void applyDefaultFont(Document foDoc) {
+ String fallback = BundledFonts.regular(BundledFonts.FALLBACK_FAMILY).getName();
+ NodeList inlines = foDoc.getElementsByTagNameNS(FO_NS, "inline");
+ for (int i = 0; i < inlines.getLength(); i++) {
+ Element inline = (Element) inlines.item(i);
+ if (inline.getAttribute("font-family").isEmpty()) {
+ inline.setAttribute("font-family", fallback);
+ }
+ }
+ }
+
+
+ // ==================== FOP ====================
+
+ private static void renderFo(Document foDoc, String title, Path baseDir,
+ OutputStream out) throws Exception {
+ byte[] config = fopConfig().getBytes(StandardCharsets.UTF_8);
+ FopFactory fopFactory = FopFactory.newInstance(baseDir.toUri(),
+ new ByteArrayInputStream(config));
+ FOUserAgent ua = fopFactory.newFOUserAgent();
+ if (title != null && !title.isBlank()) {
+ ua.setTitle(title);
+ }
+ Fop fop = fopFactory.newFop(MimeConstants.MIME_PDF, ua, out);
+ javax.xml.transform.Transformer transformer =
+ javax.xml.transform.TransformerFactory.newInstance().newTransformer();
+ transformer.transform(new DOMSource(foDoc), new SAXResult(fop.getDefaultHandler()));
+ }
+
+ /**
+ * FOP-конфиг: только шрифты бандла (auto-detect="false" — системные в
+ * рендер не попадают). Triplet-имена — из name-таблиц regular-вариантов,
+ * как в {@link FopFallbackFonts}; {@code simulate-style="false"} — стили
+ * настоящие TTF, а не синтез FOP.
+ */
+ private static String fopConfig() {
+ StringBuilder sb = new StringBuilder(
+ ""
+ + "");
+ for (String family : BundledFonts.families()) {
+ var regular = BundledFonts.regular(family);
+ if (regular == null) {
+ continue;
+ }
+ String tripletName = regular.getName();
+ appendFont(sb, regular, "regular", tripletName, "normal", "normal");
+ appendFont(sb, BundledFonts.bold(family), "bold", tripletName, "normal", "bold");
+ appendFont(sb, BundledFonts.italic(family), "italic", tripletName, "italic", "normal");
+ appendFont(sb, BundledFonts.boldItalic(family), "boldItalic",
+ tripletName, "italic", "bold");
+ }
+ sb.append("");
+ return sb.toString();
+ }
+
+ private static void appendFont(StringBuilder sb, org.docx4j.fonts.PhysicalFont pf,
+ String embedMode, String tripletName,
+ String style, String weight) {
+ if (pf == null) {
+ return;
+ }
+ sb.append("");
+ }
+
+ // ==================== Утилиты DOM ====================
+
+ private static Element child(Element parent, String localName) {
+ NodeList children = parent.getChildNodes();
+ for (int i = 0; i < children.getLength(); i++) {
+ Node n = children.item(i);
+ if (n instanceof Element e && FO_NS.equals(e.getNamespaceURI())
+ && localName.equals(e.getLocalName())) {
+ return e;
+ }
+ }
+ return null;
+ }
+
+ private static boolean blockHasVisibleContent(Element block) {
+ if (block.getTextContent() != null && !block.getTextContent().isBlank()) {
+ return true;
+ }
+ return block.getElementsByTagNameNS(FO_NS, "page-number").getLength() > 0
+ || block.getElementsByTagNameNS(FO_NS, "page-number-citation-last").getLength() > 0
+ || block.getElementsByTagNameNS(FO_NS, "leader").getLength() > 0;
+ }
+
+ /** Есть ли в чанке хоть один параграф с видимым содержимым. */
+ private static boolean hasText(List chunk) {
+ if (chunk == null) {
+ return false;
+ }
+ for (Paragraph p : chunk) {
+ try {
+ for (int j = 0; j < p.numCharacterRuns(); j++) {
+ String t = p.getCharacterRun(j).text();
+ if (t != null && !cleanText(t).isEmpty()) {
+ return true;
+ }
+ }
+ } catch (RuntimeException e) {
+ // повреждённый ран — не содержимое
+ }
+ }
+ return false;
+ }
+
+ private static String cleanText(String t) {
+ StringBuilder sb = new StringBuilder(t.length());
+ for (int i = 0; i < t.length(); i++) {
+ char c = t.charAt(i);
+ if (c != PARA_END && c != CELL_END && c != SECTION_END) {
+ sb.append(c);
+ }
+ }
+ return sb.toString();
+ }
+
+ private static void deleteRecursively(Path dir) {
+ try (Stream walk = Files.walk(dir)) {
+ walk.sorted(Comparator.reverseOrder()).forEach(p -> {
+ try {
+ Files.deleteIfExists(p);
+ } catch (IOException ignored) {
+ // temp-файлы: нечего делать при отказе удаления
+ }
+ });
+ } catch (IOException ignored) {
+ }
+ }
+}
diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/DocToPdfTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/DocToPdfTest.java
new file mode 100644
index 0000000..0fb6407
--- /dev/null
+++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/DocToPdfTest.java
@@ -0,0 +1,234 @@
+package ru.pjandro.wordpdf;
+
+import org.apache.pdfbox.Loader;
+import org.apache.pdfbox.cos.COSName;
+import org.apache.pdfbox.pdmodel.PDDocument;
+import org.apache.pdfbox.pdmodel.PDPage;
+import org.apache.pdfbox.pdmodel.PDResources;
+import org.apache.pdfbox.pdmodel.font.PDFont;
+import org.apache.pdfbox.pdmodel.graphics.PDXObject;
+import org.apache.pdfbox.pdmodel.graphics.image.PDImageXObject;
+import org.apache.pdfbox.text.PDFTextStripper;
+import org.apache.pdfbox.text.TextPosition;
+import org.junit.jupiter.api.Test;
+
+import java.io.IOException;
+import java.io.InputStream;
+import java.nio.file.Files;
+import java.nio.file.Path;
+import java.util.ArrayList;
+import java.util.IdentityHashMap;
+import java.util.List;
+import java.util.Set;
+import java.util.TreeSet;
+
+import static org.junit.jupiter.api.Assertions.*;
+
+/**
+ * Конвертация бинарного .doc (Word 97-2003, OLE2) через ветку
+ * {@code internal.DocToPdfRenderer} (POI HWPF -> XSL-FO -> FOP).
+ * Фикстура — закоммиченный samples/legacy-doc.doc (создан Word'ом,
+ * POI .doc не пишет — не перезагенерировать).
+ *
+ * Ассерты только на фактическое содержимое фикстуры и на раны,
+ * ушедшие в Tinos (аналог Times New Roman): текст ран, ушедших в
+ * DejaVu-fallback, PDFBox на машинах с установленным DejaVu «чинит»
+ * по системному шрифту и извлекает «#» — такие строки не ассертятся
+ * (экзотические глифы фикстуры — принятая деградация .doc-ветки:
+ * аналога GlyphCoverageNormalizer здесь нет).
+ */
+class DocToPdfTest {
+
+ private static byte[] sampleBytes(String name) throws IOException {
+ try (InputStream in = DocToPdfTest.class.getClassLoader()
+ .getResourceAsStream("samples/" + name)) {
+ assertNotNull(in, "Нет тестового документа: samples/" + name);
+ return in.readAllBytes();
+ }
+ }
+
+ private static Path convertPdf(byte[] docBytes, String title) throws IOException {
+ Path out = Files.createTempFile("converted-doc-", ".pdf");
+ Files.write(out, WordPdfConverter.convert(docBytes, title));
+ return out;
+ }
+
+ private static String norm(String s) {
+ return s.replaceAll("\\s+", "");
+ }
+
+ private static String pdfPageText(Path pdf, int page) throws IOException {
+ try (PDDocument doc = Loader.loadPDF(pdf.toFile())) {
+ PDFTextStripper stripper = new PDFTextStripper();
+ stripper.setStartPage(page);
+ stripper.setEndPage(page);
+ return stripper.getText(doc);
+ }
+ }
+
+ /** Строка страницы: базовая линия y (от верха страницы, PDFBox YDirAdj) и текст. */
+ private record Line(float y, String text) {
+ }
+
+ /** Непустые строки страницы с базовыми линиями (порядок по позиции). */
+ private static List pageLines(Path pdf, int page) throws IOException {
+ List lines = new ArrayList<>();
+ try (PDDocument doc = Loader.loadPDF(pdf.toFile())) {
+ PDFTextStripper stripper = new PDFTextStripper() {
+ @Override
+ protected void writeString(String text, List textPositions)
+ throws IOException {
+ super.writeString(text, textPositions);
+ if (!textPositions.isEmpty() && !norm(text).isEmpty()) {
+ lines.add(new Line(textPositions.get(0).getYDirAdj(), text));
+ }
+ }
+ };
+ stripper.setStartPage(page);
+ stripper.setEndPage(page);
+ stripper.setSortByPosition(true);
+ stripper.getText(doc);
+ }
+ return lines;
+ }
+
+ /** y базовой линии первой строки, содержащей needle (после norm); null если нет. */
+ private static Float lineY(Path pdf, int page, String needle) throws IOException {
+ String n = norm(needle);
+ for (Line l : pageLines(pdf, page)) {
+ if (norm(l.text()).contains(n)) {
+ return l.y();
+ }
+ }
+ return null;
+ }
+
+ /** Максимум y по всем непустым строкам страницы (самая нижняя базовая линия). */
+ private static float maxLineY(Path pdf, int page) throws IOException {
+ float max = Float.MIN_VALUE;
+ for (Line l : pageLines(pdf, page)) {
+ max = Math.max(max, l.y());
+ }
+ return max;
+ }
+
+ /** BaseFont-имена вшитых шрифтов PDF (например "EAAAAA+Tinos-Bold"). */
+ private static Set embeddedFontNames(Path pdf) throws IOException {
+ Set names = new TreeSet<>();
+ try (PDDocument doc = Loader.loadPDF(pdf.toFile())) {
+ for (PDPage page : doc.getPages()) {
+ PDResources res = page.getResources();
+ for (COSName name : res.getFontNames()) {
+ PDFont font = res.getFont(name);
+ if (font != null) {
+ names.add(font.getName());
+ }
+ }
+ }
+ }
+ return names;
+ }
+
+ /** Число уникальных Image XObject в PDF (наследованные ресурсы — один объект). */
+ private static int imageCount(Path pdf) throws IOException {
+ Set seen = java.util.Collections.newSetFromMap(new IdentityHashMap<>());
+ try (PDDocument doc = Loader.loadPDF(pdf.toFile())) {
+ for (PDPage page : doc.getPages()) {
+ PDResources res = page.getResources();
+ for (COSName name : res.getXObjectNames()) {
+ PDXObject xo = res.getXObject(name);
+ if (xo instanceof PDImageXObject) {
+ seen.add(xo);
+ }
+ }
+ }
+ }
+ return seen.size();
+ }
+
+ /**
+ * .doc конвертируется в PDF: текст кириллический, таблицы и картинки
+ * на месте, шрифт — встроенный Tinos (аналог Times New Roman),
+ * базовый Helvetica не используется.
+ * Регрессия — WordPdfConverter#isOle2 + internal.DocToPdfRenderer,
+ * фикстура samples/legacy-doc.doc.
+ */
+ @Test
+ void legacyDoc_convertsToPdf() throws Exception {
+ Path pdf = convertPdf(sampleBytes("legacy-doc.doc"), "testDoc");
+ String text;
+ int pages;
+ try (PDDocument doc = Loader.loadPDF(pdf.toFile())) {
+ pages = doc.getNumberOfPages();
+ text = norm(new PDFTextStripper().getText(doc));
+ }
+ assertTrue(pages >= 10, "страниц меньше ожидаемого: " + pages);
+ assertTrue(text.contains("Предметдоговора"), "нет заголовка раздела");
+ assertTrue(text.contains("Договорарендыпомещения"), "нет заголовка");
+ for (String font : embeddedFontNames(pdf)) {
+ assertFalse(font.contains("Helvetica"), "базовый шрифт в PDF: " + font);
+ }
+ assertTrue(embeddedFontNames(pdf).stream().anyMatch(n -> n.contains("Tinos")),
+ "нет Tinos (аналога Times New Roman): " + embeddedFontNames(pdf));
+ assertTrue(imageCount(pdf) >= 1, "картинок нет");
+ }
+
+ /**
+ * Колонтитулы, которых POI в FO не пишет, дописываются в FO-DOM:
+ * текст odd-footer («Нижний колонтитул») и номер страницы из PAGE-поля
+ * на каждой странице.
+ * Регрессия — DocToPdfRenderer#injectHeadersAndFooters,
+ * фикстура samples/legacy-doc.doc.
+ */
+ @Test
+ void legacyDoc_footersCarryPageNumbers() throws Exception {
+ Path pdf = convertPdf(sampleBytes("legacy-doc.doc"), "testDoc");
+ String page1 = norm(pdfPageText(pdf, 1));
+ String page5 = norm(pdfPageText(pdf, 5));
+ assertTrue(page5.contains("Нижнийколонтитул"), "нет текста футера на стр. 5");
+ assertTrue(page1.startsWith("1"), "нет номера страницы на стр. 1: "
+ + page1.substring(0, Math.min(20, page1.length())));
+ assertTrue(page5.contains("5"), "нет номера страницы на стр. 5");
+ }
+
+ /**
+ * Текст body не наезжает на области колонтитулов: заголовок первой
+ * строки лежит ниже header-региона (extent = верхнее поле 0.7875in =
+ * 56.7pt), под строкой футера ничего нет. Форк FOP не вычитает
+ * extent'ы регионов из body-области (area.Page = page-area минус
+ * собственные margin'ы region-body), поэтому разводка body и
+ * колонтитулов — только margin'ами region-body; их обнуление
+ * растягивает body на всю страницу, и текст лезет в колонтитулы.
+ * Регрессия — DocToPdfRenderer#injectHeadersAndFooters,
+ * фикстура samples/legacy-doc.doc.
+ */
+ @Test
+ void legacyDoc_bodyClearsHeaderFooterRegions() throws Exception {
+ Path pdf = convertPdf(sampleBytes("legacy-doc.doc"), "testDoc");
+ Float titleY = lineY(pdf, 1, "Договор аренды");
+ assertNotNull(titleY, "нет заголовка на стр. 1");
+ assertTrue(titleY > 50f, "заголовок внутри header-региона: y=" + titleY);
+ Float footerY = lineY(pdf, 1, "Нижний колонтитул");
+ assertNotNull(footerY, "нет футера на стр. 1");
+ float lowest = maxLineY(pdf, 1);
+ assertTrue(lowest <= footerY + 1f,
+ "строка ниже футера: y=" + lowest + " > y футера " + footerY);
+ }
+
+ /**
+ * OLE2-магик + мусор: и валидатор, и конвертер обязаны отвергнуть
+ * документ (не молча отдать пустой PDF).
+ * Регрессия — DocToPdfRenderer#render, WordPdfValidator#checkDocPageCountLightweight.
+ */
+ @Test
+ void ole2Junk_rejected() {
+ byte[] junk = new byte[1024];
+ byte[] magic = {(byte) 0xD0, (byte) 0xCF, 0x11, (byte) 0xE0,
+ (byte) 0xA1, (byte) 0xB1, 0x1A, (byte) 0xE1};
+ System.arraycopy(magic, 0, junk, 0, magic.length);
+ assertThrows(ConversionException.class,
+ () -> WordPdfValidator.checkDocPageCountLightweight(junk));
+ assertThrows(ConversionException.class,
+ () -> WordPdfConverter.convert(junk, "junk"));
+ }
+}
diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfValidatorTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfValidatorTest.java
index a009bbb..9e2a31f 100644
--- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfValidatorTest.java
+++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfValidatorTest.java
@@ -359,4 +359,49 @@ class WordPdfValidatorTest {
() -> WordPdfValidator.checkPageCountLightweight(docx, 3));
assertTrue(ex.getMessage().contains("не менее 4"), ex.getMessage());
}
+
+ /** Фикстура бинарного .doc (закоммичена, создана Word'ом — POI .doc не пишет). */
+ private static byte[] legacyDocBytes() throws Exception {
+ try (var in = WordPdfValidatorTest.class.getClassLoader()
+ .getResourceAsStream("samples/legacy-doc.doc")) {
+ assertNotNull(in, "Нет тестового документа: samples/legacy-doc.doc");
+ return in.readAllBytes();
+ }
+ }
+
+ /**
+ * Число страниц .doc — кэш SummaryInformation (для фикстуры 11):
+ * лимит 10 должен отвергать, 20 — пропускать.
+ * Регрессия — WordPdfValidator#checkDocPageCountLightweight,
+ * фикстура samples/legacy-doc.doc.
+ */
+ @Test
+ void checkDocPageCountLightweight_overLimitRejected() throws Exception {
+ ConversionException ex = assertThrows(ConversionException.class,
+ () -> WordPdfValidator.checkDocPageCountLightweight(legacyDocBytes(), 10));
+ assertTrue(ex.getMessage().contains("не менее 11"), ex.getMessage());
+ }
+
+ @Test
+ void checkDocPageCountLightweight_underLimitPasses() throws Exception {
+ byte[] doc = legacyDocBytes();
+ assertDoesNotThrow(() -> WordPdfValidator.checkDocPageCountLightweight(doc, 20));
+ assertDoesNotThrow(() -> WordPdfValidator.checkDocPageCountLightweight(doc));
+ }
+
+ @Test
+ void checkDocPageCountLightweight_junkRejected() {
+ byte[] junk = new byte[1024];
+ byte[] magic = {(byte) 0xD0, (byte) 0xCF, 0x11, (byte) 0xE0,
+ (byte) 0xA1, (byte) 0xB1, 0x1A, (byte) 0xE1};
+ System.arraycopy(magic, 0, junk, 0, magic.length);
+ assertThrows(ConversionException.class,
+ () -> WordPdfValidator.checkDocPageCountLightweight(junk));
+ }
+
+ @Test
+ void checkDocPageCountLightweight_bytesNull() {
+ assertThrows(ConversionException.class,
+ () -> WordPdfValidator.checkDocPageCountLightweight((byte[]) null));
+ }
}
diff --git a/wordpdf-core/src/test/resources/samples/legacy-doc.doc b/wordpdf-core/src/test/resources/samples/legacy-doc.doc
new file mode 100644
index 0000000000000000000000000000000000000000..7da885576492b9135e6973784fc76adc6da63232
GIT binary patch
literal 429568
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
TOR3
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