diff --git a/AGENTS.md b/AGENTS.md index 2b0ea24..39f0eb3 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -2,7 +2,7 @@ ## Project Overview -Конвертер `.docx`/`.doc` → `.pdf` на чистом Java (docx4j 17.3.2 + форк Apache FOP, без LibreOffice/Aspose). Бинарный `.doc` (Word 97-2003) — собственный мост MS-DOC/MS-CFB `internal/doc` → in-memory `.docx` → тот же конвейер. Java 17, только Maven. +Конвертер `.docx`/`.doc`/`.xlsx` → `.pdf` на чистом Java (docx4j 17.3.2 + форк Apache FOP, без LibreOffice/Aspose). Бинарный `.doc` (Word 97-2003) — собственный мост MS-DOC/MS-CFB `internal/doc` → in-memory `.docx` → тот же конвейер; `.xlsx` (SpreadsheetML) — собственный мост `internal/xlsx` → in-memory `.docx` → тот же конвейер. Java 17, только Maven. Три независимых модуля: @@ -16,7 +16,7 @@ ### Пайплайн `WordPdfConverter.convert(byte[], String[, ConvertOptions])` -Порядок фиксирован, местами менять нельзя (`WordPdfConverter.convertToStream`). Вход роутируется по сигнатуре до входа в конвейер: `PK\x03\x04` → docx-путь, `D0 CF 11 E0 A1 B1 1A E1` (CFB, MS-CFB §2.2) → мост `DocToDocx.convert` → in-memory `.docx` → этот конвейер (`WordPdfValidator.isBinaryDoc` — единый предикат): +Порядок фиксирован, местами менять нельзя (`WordPdfConverter.convertToStream`). Вход роутируется по сигнатуре до входа в конвейер: `PK\x03\x04` + маркеры книги в `[Content_Types].xml` → мост `XlsxToDocx.convert` → in-memory `.docx` → этот конвейер, `D0 CF 11 E0 A1 B1 1A E1` (CFB, MS-CFB §2.2) → мост `DocToDocx.convert` → in-memory `.docx` → этот конвейер, иначе docx-путь (`WordPdfValidator.isBinaryDoc`/`isSpreadsheet` — единые предикаты): | # | Шаг | Что делает | |---|---|---| @@ -31,11 +31,11 @@ | 5–6 | `getFopFactoryBuilder`/`getFOUserAgent` → `Docx4J.toFO(…, FLAG_EXPORT_PREFER_XSL)` | XSL-FO → PDF; непустой `title` → заголовок PDF | | 7 | `finally` → `deleteEmbeddedFontTempFiles()` | в docx4j 17.x `OpcPackage.close()` нет | -Полные обоснования шагов и правила подсчёта страниц — `docs/agent/pipeline.md`. Вход валидируется **до** `convertToStream`: `WordPdfValidator.validate(bytes, options)` (размер → подпись zip/CFB → контейнер → страницы); для `.doc` — `checkPageCountDoc` по сырым байтам до конвертации. +Полные обоснования шагов и правила подсчёта страниц — `docs/agent/pipeline.md`. Вход валидируется **до** `convertToStream`: `WordPdfValidator.validate(bytes, options)` (размер → подпись zip/CFB → контейнер `ContainerKind.DOCX|XLSX` → страницы); для `.doc` — `checkPageCountDoc` по сырым байтам до конвертации, для `.xlsx` — `checkPageCountXlsx` (двупроходная нижняя оценка: видимые листы + явные `rowBreaks/brk`, `docProps/app.xml` для книг не читается). ### Мост `.doc` → `.docx` (`internal/doc`) -Нормативный источник — [MS-DOC] в `docs/standards/doc/`, общее OLE-окружение ([MS-CFB], [MS-OLEPS], [MS-ODRAW]) в `docs/standards/binary/`, [MS-ODRAWXML] в `docs/standards/ooxml/`, ссылки — с номерами секций. Новых runtime-зависимостей нет (POI/POIFS — test-scope). Публичные точки: `DocToDocx.convert(byte[])` (вызывает `WordPdfConverter`) и `DocToDocx.countPages(byte[])` (вызывает `WordPdfValidator.checkPageCountDoc`); общий разбор — `DocFile` (CFB → потоки WordDocument / 0Table|1Table / Data + FIB + piece table). 16 из 18 классов package-private; наружу — `DocToDocx` и `CfbReader`. +Нормативный источник — [MS-DOC] в `docs/standards/doc/`, общее OLE-окружение ([MS-CFB], [MS-OLEPS], [MS-ODRAW]) в `docs/standards/binary/`, [MS-ODRAWXML] в `docs/standards/ooxml/`, ссылки — с номерами секций. Новых runtime-зависимостей нет (POI/POIFS — test-scope). Публичные точки: `DocToDocx.convert(byte[])` (вызывает `WordPdfConverter`) и `DocToDocx.countPages(byte[])` (вызывает `WordPdfValidator.checkPageCountDoc`); общий разбор — `DocFile` (CFB → потоки WordDocument / 0Table|1Table / Data + FIB + piece table). 15 из 17 классов package-private; наружу — `DocToDocx` и `CfbReader`; писатель зипа вынесен в `internal/DocxPackageWriter` (общий с мостом `.xlsx`: `Part(entry, contentType, relType, content)`, `NAMESPACES` — корневые включая `xmlns:c`, `write(bodyXml, parts, hyperlinkTargets)`, `storyPart`). |Класс|Семантика (полные байтовые раскладки — `docs/agent/doc-bridge.md`)| |---|---| @@ -44,10 +44,25 @@ |`Styles`, `FontTable`, `Lists`|STSH-цепочки base-first, символьные stk=3 → `charChain` (§2.9.271) + ftc→`w:rFonts` (§2.9.147) + PlfLst/PlfLfo → `word/numbering.xml` (§2.9.200/.201)| |`Tables`, `Sections`, `Headers`|TAP → сетка/границы/`w:jc`/vAlign/`w:tcMar` (§2.6.3; битый TDefTable → плоские абзацы) + секции (PlcfSed §2.8.26: continuous/landscape/колонтитуки/колонки/titlePage) + Plcfhdd → `headerN.xml`/`footerN.xml`| |`SummaryInfo`, `OfficeArt`|кэш PageCount [MS-OLEPS] (offset'ы относительны начала PropertySet) + BLIP → PNG/JPEG/DIB, EMF/WMF/PICT → пропуск + warn| -|`DocToDocx`, `DocxWriter`|оркестратор + `DocxBody` (раны/pPr/табличный автомат 0x07/TTP → docx-XML) + мульти-частный zip (document/numbering/hdr/ftr/media)| +|`DocToDocx`|оркестратор + `DocxBody` (раны/pPr/табличный автомат 0x07/TTP → docx-XML); мульти-частный zip (document/numbering/hdr/ftr/media) — через `internal/DocxPackageWriter`| Перечень остатков моста — `docs/agent/doc-bridge.md`. +### Мост `.xlsx` → `.docx` (`internal/xlsx`) + +Нормативный источник — ECMA-376 Part 1 (SpreadsheetML: §18 книга/стили/печать, §21 рисунки/диаграммы, §3 OPC) в `docs/standards/ooxml/`, ссылки — с номерами секций. Новых runtime-зависимостей нет (StAX + `java.util.zip`; POI — test-scope, генератор фикстур). Публичные точки: `XlsxToDocx.convert(byte[], ConvertOptions)` (вызывает `WordPdfConverter`), всё остальное — package-private `internal/xlsx`. 16 классов: + +|Класс|Семантика (полные раскладки и калибровки — `docs/agent/xlsx-bridge.md`)| +|---|---| +|`XlsxPackage`, `WorkbookModel`, `SharedStrings`|zip книги в памяти: части, `_rels` любого part'а с резолвом `../`; листы (`name/state/partPath`, hidden/veryHidden не рендерятся), `date1904`; sst с rich-ранами (`rPr` → `RunStyle`)| +|`ThemeModel`, `StylesModel`, `ColorSpec`, `ColorResolver`|clrScheme/шрифты темы + перенос `theme1.xml` в `word/theme/`; numFmts/fonts/fills/borders/cellXfs с base-цепочкой `cellStyleXfs`; цвет: rgb/theme+tint+shade (лог-модуляция светлоты)/indexed+palette → sRGB| +|`NumberFormats`, `NumberText`|формат-коды: секции, `0 # ?`, тысячныe/процентные масштабы, даты/время (эпоха 1900/1904), научный, литералы; `[…]` (условия/цвета/локали) — вырезание (деградация); битый код → `General`+warn| +|`Metrics`|MDW по бандл-метрике (`GlyphFont`), chars↔px↔twips (ECMA-376 §18.3.1.8), pt/inches→twips, px→EMU| +|`SheetModel`, `PrintLayout`, `SheetToTable`|лист: ячейки (кэш значений формул, inlineStr), cols/hidden, merges, гиперссылки, print area/breaks, `drawing r:id`, `olePresent`; страница печати (paper/landscape/поля, срезы полос по разрывам+высоте/ширине, fitToPage = геометрическое сжатие ширины колонок) + `sectPr(Page)`; срез → фикс-таблица `w:tbl` (сетка, gridSpan/vMerge, trHeight, jc по Excel-горизонтали, раны sst поверх стиля, числа через `NumberFormats`, гиперссылки)| +|`DrawingBridge`, `WarnOnce`, `XlsxToDocx`|якоря xdr (two/one/absoluteCell, EMU-кумулятив через `Metrics`, hidden=0, clamp) → `wp:inline` в from-ячейку; `xdr:pic` → `word/media/xlsx-imageN`; `c:chart` → `word/charts/xlsx-chartN.xml` — дорисовывает штатный шаг 3.5 (ловит `errorOnCharts`); SmartArt/фигуры — пропуск+warn (`errorOnSmartArt` на .xlsx не срабатывает); OLE → warn/422 по флагу; оркестратор: секция docx на каждый срез, финальный body-`sectPr`, части через `DocxPackageWriter`| + +Перечень деградаций — `docs/agent/xlsx-bridge.md`. + ### Нормализаторы (`internal/DocxNormalizer`) Контракт: `byte[] normalize(byte[]) throws IOException`; нечего менять → вернуть **тот же массив** (`assertSame` в тестах). Порядок фиксирован: Strict→OnOff→Symbol→Field→Invisible→GlyphCoverage→TableIndent→NumberingSuffix→Hidden→Ruby; правила 1–10 применяет `DocxRewritePipeline.STEP` одним zip-проходом (механика zip-прохода — `docs/agent/pipeline.md`), `OleObjectNormalizer` подключается лямбдой в `WordPdfConverter.normalizers()`. @@ -68,7 +83,7 @@ ### REST API (`wordpdf-app`, всё package-private кроме `WordPdfApplication`) -Единственный эндпоинт `POST /api/v1/convert`: multipart-поле `file` + факультативные query/form-параметры `errorOnCharts`/`errorOnSmartArt`/`errorOnOle` (дефолты — `WordPdfSettings.ERROR_ON_*`). Ответ — `application/pdf`, `Content-Disposition: attachment; filename*=UTF-8''…`. Имя файла — `ConversionService.safeBaseName`; расширение `.docx`/`.doc` проверяет `ConvertController` (текст ошибки 400 — контракт с фронтом). Error-флаги диаграмм/SmartArt/OLE на `.doc` **не срабатывают** (BLIP-плейсхолдеры → картинки) — описано в `@Operation`. Полный текст — `docs/agent/repo-map.md`. +Единственный эндпоинт `POST /api/v1/convert`: multipart-поле `file` + факультативные query/form-параметры `errorOnCharts`/`errorOnSmartArt`/`errorOnOle` (дефолты — `WordPdfSettings.ERROR_ON_*`). Ответ — `application/pdf`, `Content-Disposition: attachment; filename*=UTF-8''…`. Имя файла — `ConversionService.safeBaseName`; расширение `.docx`/`.doc`/`.xlsx` проверяет `ConvertController` (текст ошибки 400 — контракт с фронтом). Error-флаги диаграмм/SmartArt/OLE на `.doc` **не срабатывают** (BLIP-плейсхолдеры → картинки); на `.xlsx` `errorOnSmartArt` не срабатывает (SmartArt отбрасывается мостом), `errorOnCharts`/`errorOnOle` работают — описано в `@Operation`. Полный текст — `docs/agent/repo-map.md`. | Ситуация | HTTP | Класс | |---|---|---| @@ -85,7 +100,7 @@ - **Ключ доступа**: `X-API-Key` ↔ `wordpdf.api-key` (пустое = выключено); без ключа открыты только `OPEN_PREFIXES`, пути с точечными сегментами — никогда. Механика `ApiKeyFilter` — `docs/agent/repo-map.md`. - **Очередь и лимиты**: конвертации сериализованы однопоточным `ThreadPoolExecutor` (переполнение → 503) — ядро мутирует глобальный `PhysicalFonts` и **не потокобезопасно**; лимиты входа — только конфигурация сервера (`wordpdf.max-mb`/`max-pages`, SpEL-дефолты из `WordPdfSettings`; ≤ 0 → `IllegalStateException` на старте; параметрами запроса не переопределяются, в `application.properties` не объявлены). Подробности — `docs/agent/repo-map.md`. -- **SPA**: вся сеть в `wordpdf-web/src/api.ts` (компоненты `fetch` не вызывают); ключ в `localStorage` (`wordpdf.api.key`), экран `ApiKeyGate` показывается только когда `probeApiKey()` подтвердил требование ключа; base — `VITE_BASE` (дефолт `/`, CORS не нужен); три error-флага (дефолт — выключены), DropZone `.docx,.doc`. Полный текст — `docs/agent/repo-map.md`. +- **SPA**: вся сеть в `wordpdf-web/src/api.ts` (компоненты `fetch` не вызывают); ключ в `localStorage` (`wordpdf.api.key`), экран `ApiKeyGate` показывается только когда `probeApiKey()` подтвердил требование ключа; base — `VITE_BASE` (дефолт `/`, CORS не нужен); три error-флага (дефолт — выключены), DropZone `.docx,.doc,.xlsx`. Полный текст — `docs/agent/repo-map.md`. ### Chart/SmartArt-движок (`internal/chart`) @@ -117,9 +132,9 @@ chart-PNG вставляются media-частями вручную (`DrawingPr | Путь | Назначение | |---|---| -| `wordpdf-core/src/main/java/ru/pjandro/wordpdf/` | публичный API; `fonts/` (бандл+глиф-движок), `internal/` (нормализаторы, пайплайн), `internal/doc/` (мост), `internal/chart/` (диаграммы) | +|`wordpdf-core/src/main/java/ru/pjandro/wordpdf/`|публичный API; `fonts/` (бандл+глиф-движок), `internal/` (нормализаторы, пайплайн), `internal/doc/` (мост .doc), `internal/xlsx/` (мост .xlsx), `internal/chart/` (диаграммы)| | `wordpdf-core/src/main/resources/` | `fonts/` (30 TTF), `xslt/docx2fo.xslt` (вендорный стилист), `slf4j-simple.properties` | -| `wordpdf-core/src/test/resources/` | `samples/` (25 закоммиченных фикстур: 13 `.docx` + 12 `.doc`), `geom/` (`presetShapeDefinitions.xml`, тесты) | +|`wordpdf-core/src/test/resources/`|`samples/` (32 закоммиченных фикстур: 13 `.docx` + 12 `.doc` + 7 `.xlsx`), `geom/` (`presetShapeDefinitions.xml`, тесты)| | `wordpdf-app/` | REST API (10 классов, public только `WordPdfApplication`) | | `wordpdf-web/` | SPA: `src/api.ts` (вся сеть) + компоненты | | корневые `Containerfile`, `compose.yml`, `compose.dev.yml`, `gateway/nginx.conf` | контейнеры; единственный вход — gateway (`:9010`/`:9011`) | @@ -185,9 +200,9 @@ python3 docs/standards/docx/validate-fixtures.py wordpdf-core/src/test/resources ## Testing & QA - Гейты: PMD `maven-pmd-plugin` 3.28.0 (`includeTests=true`) и JaCoCo `0.8.15` (`jacoco:check` на `verify`) — пороги LINE `0.90` (оба модуля), BRANCH `0.85` (core); отчёт `report` раньше `check` (при провале порога отчёт уже на диске). Механика `argLine`/`prepare-agent`/`jacoco.skip` — `docs/agent/repo-map.md`. Плотность покрытия держат тесты, а не заглушки. -- Счётчики: 57 тестовых класса / 886 теста (core 51/843, app 6/43; разбивка — `docs/agent/repo-map.md`). JUnit 6, только `Assertions` (Mockito/AssertJ не использовать; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`); тестовые классы package-private, зеркалят main-пакеты. +- Счётчики: 75 тестовых класса / 1095 тестов (core 69/1051, app 6/44; разбивка — `docs/agent/repo-map.md`). JUnit 6, только `Assertions` (Mockito/AssertJ не использовать; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`); тестовые классы package-private, зеркалят main-пакеты. - **PDF сравнивается текстом, не растеризацией**: PDFBox 3 (`Loader.loadPDF`) — `PDFTextStripper` (пер-странично), `processTextPosition` для шрифта символа, обход ресурсов страниц для встроенных шрифтов (`EAAAAA+Carlito-Bold`), счётчик картинок (`imageCount`/`distinctImageCount` — SMask игнорируется). Негативные маркеры: `assertFalse(text.contains("#"))` (.notdef), `assertFalse(font.startsWith("Helvetica"))`. Текст нормализуется по пробелам (`norm`). - Регрессивная конвенция: фикс = нормализатор/рендерер + юнит + конвертер-тест; в javadoc фикса — ссылка «Регрессия — Test#имя, фикстура samples/…». Пары `XxxNormalizerTest`↔`тест-в-конвейере` воспроизводятся грепом по этим ссылкам; исключения (крафт POIFS, синтетика, app-регрессии) — `docs/agent/testing.md`. -- Фикстуры — только закоммиченные `samples/*.docx` + `samples/*.doc`, в тестах не генерировать; контракт нормализаторов «нечего менять → тот же массив» (`assertSame`) + неприкосновенность частей вне `word/*.xml`. +- Фикстуры — только закоммиченные `samples/*.docx` + `samples/*.doc` + `samples/*.xlsx`, в тестах не генерировать; контракт нормализаторов «нечего менять → тот же массив» (`assertSame`) + неприкосновенность частей вне `word/*.xml`. - App-тесты: `@SpringBootTest` + `@AutoConfigureMockMvc`; четыре набора свойств = четыре кэшированных контекста (отдельные классы, не `@Nested`); `ConversionServiceTest`/`ApiExceptionHandlerTest` — без Spring-контекста. - Справочник: фикстуры и их смысл, юниты моста/нормализаторов/app, пиксели и стенд без fontconfig, регрессивные записи без javadoc-ссылок — `docs/agent/testing.md`. diff --git a/docs/agent/doc-bridge.md b/docs/agent/doc-bridge.md index 61a004e..7f91ccf 100644 --- a/docs/agent/doc-bridge.md +++ b/docs/agent/doc-bridge.md @@ -19,7 +19,7 @@ |`OfficeArt`|[MS-ODRAW] PICF @ fcDggInfo/lcbDggInfo (Table-поток), delay-поток = WordDocument; DggContainer → BStoreContainer(0xF004)/BStoreContainerDelay(0xF007)/инлайн → FBSE → BLIP: 0xF01A EMF / 0xF01B WMF / 0xF01C PICT / 0xF01D JPEG (=0xF02A) / 0xF01E PNG / 0xF01F DIB; PNG/JPEG дословно, DIB → ImageIO → PNG, EMF/WMF/PICT → пропуск + warn (EMF-рендера в Java2D нет)| |`PrcData`|§2.9.210 PrcData в Data-потоке (`[cbGrpprl:2][grpprl]`, капа cb 0x3FA2, поля `next` нет): `resolve(data, grpprl)` разворачивает grpprl абзаца, чьи свойства Word вынес за FKP-страницу PAPX, — одиночный Prl `sprmPHugePapx` (0x6646; в grpprl GrpPrlAndIstd — единственный Prl при istd=0, §2.6.2) и `sprmPTableProps` (0x646B — цепочка продолжается в указанном PrcData). Оба указателя разворачиваются на своей позиции **без обрыва** текущего массива, не-спец-спрмы сохраняются (union): spec §2.6.2 велит хвост за PTableProps игнорировать, но Word пишет в нём легаси-зеркало (в `samples/ru-table-image.doc` — единственный `sprmTDefTable`, Appendix A <9>), а `sprmTInsert` из PrcData конвертер не читает — замещение ломало бы сетку; спец-спрмов нет → **тот же массив** (по ссылке); любой брак (ptr за Data, cb вне [1, 0x3FA2], цикл A→B→A — бюджет 32 PrcData) → останов без исключения, снисходительно (образец `Styles`/`Lists`). Подключается единственной точкой — `DocxBody.buildRange` (покрывает тело, колонтитуки, TTP-ветку и обычные huge-PAPX абзацы). Регрессия — `DocToDocxFormattingTest#hugePapxRowMark_closesRowWithGridFromPrcData` | |`DocToDocx`|Оркестратор + вложенный `DocxBody`: текст → раны (CHPX+стилевой chpx-цепочка +chpx-цепочка символьного стиля по **sprmCIstd** (`Styles.charChain` — между стилевой цепочкой и прямыми, §2.4.6.5) → rPr (в т.ч. `w:highlight`/`w:shd`), прямой PAPX — после `PrcData.resolve` — +стилевая papx-цепочка (отступы через `Grpprl.Indents`, 80-варианты включительно; `sprmPChgTabsPapx`/`sprmPChgTabs` → `w:tabs`, у стилевого варианта радиус удаления из `rgdxaClose`) + sprmPIlfo/sprmPIlvl → pPr + `w:numPr` (между pageBreakBefore и tabs, CT_PPr §17.3.1.26; ilfo=0 перекрывает стилевой, ilvl=0x0C и неразрешённый numId → без numPr), base→derived→direct last-wins; флаги рана: vanish — мост фильтрует вывод рана (`w:vanish` в FO мёртв), caps/smallCaps — `Character.toUpperCase` в мосту (`w:caps`/`w:smallCaps` конвейер не читает, FOP без font-variant), rMarkIns/rMarkDel — ран оборачивается в `w:ins`/`w:del`+`w:delText` (шаблоны docx2fo рисуют правки — вид «Show Markup»), hpsPos → `w:position` (вендорный AUDIT-FIX → baseline-shift)), ¶ → ``; TAB/0x0B → `w:tab`/`w:br`, 0x0E → `w:br type="column"` (конец колонки при sprmSCcolumns), 0x0C в ране → `w:br type="page"`, 0x0C в конце абзаца — **разрыв секции**: `sectPr` соответствующей `Sections.Section` (матчинг по конечному CP) в pPr этого абзаца, внутри таблицы деградирует в `w:br type="page"`; body-level `sectPr` — последняя секция; `w:type continuous` из sprmSBkc; `w:pgSz w:orient="landscape"` со сменой w/h местами, `w:pgNumType` (`w:start` при restart, `w:fmt` только для числовых nfc — общий маппинг `Lists.numFmt`), `w:cols` (evenly → `w:num`+`w:space`, иначе per-column `w:col`; неравные/неполные ширины → деградация в одноколонную), `w:titlePg` из `Section.titlePage` (после w:cols, CT_SectPrBase §17.2.3) — `DocxBody.sectPrXml`/`appendPgNumType`/`appendCols`; pPr: `w:shd` из sprmPShd/…80 перед `w:tabs` (CT_PPr §17.3.1.26), `w:keepNext`/`w:keepLines` перед `w:pageBreakBefore` (CT_PPr §17.3.1.26); 0x1E → U+2011, 0x1F → U+00AD, 0x02/0x03/0x04 (сноски) → пропуск; U+0001/U+0008 со sprmCPicLocation → DrawingML `pic` (общий путь с картинками и OLE-fallback; 0x08 — якорь плавающей картинки §2.9.267, переносится inline-приближением: PlcfSpa не читается, позиция/обтекание теряются); field-символы в основном тексте: инструкция скрыта, кэшированный результат после разделителя видим; **табличный автомат**: абзац с 0x07 без TTP закрывает ячейку, 0x07+sprmPFTtp — конец строки (`Tables.parse` по TAP → `w:tbl`/`w:tr`/`w:tc`, сам маркер не эмитится), sprmPFInTable открывает ячейку; без корректного TDefTable строка деградирует в плоские абзацы (прежнее поведение); сетка первой строки действует на всю таблицу как `tblGrid`, ширины/объединение ячеек каждой строки — из её собственного TDefTable (горизонтальное слияние → `w:gridSpan`)| -|`DocxWriter`|Мульти-частный zip: `[Content_Types].xml` (hdr/ftr/numbering/png/jpg), `_rels/.rels`, `word/document.xml` (посекционные sectPr + headerReference; tblPr таблиц: tblW → jc (из sprmTJc) → tblInd → tblBorders), `word/_rels/document.xml.rels`, `word/numbering.xml`, `word/headerN.xml`/`footerN.xml` (по одной на непустую историю секции), `word/media/imageN.(png|jpg)`; корневые namespaces w/r/wp/a/pic| +|`DocxPackageWriter` (в `internal/`, общий с мостом .xlsx)|Мульти-частный zip: `[Content_Types].xml` (hdr/ftr/numbering/png/jpg), `_rels/.rels`, `word/document.xml` (посекционные sectPr + headerReference; tblPr таблиц: tblW → jc (из sprmTJc) → tblInd → tblBorders), `word/_rels/document.xml.rels`, `word/numbering.xml`, `word/headerN.xml`/`footerN.xml` (по одной на непустую историю секции), `word/media/imageN.(png|jpg)`; корневые namespaces w/r/wp/a/pic/c| ## Остаток моста diff --git a/docs/agent/pipeline.md b/docs/agent/pipeline.md index 7d77c0f..1e7b387 100644 --- a/docs/agent/pipeline.md +++ b/docs/agent/pipeline.md @@ -18,7 +18,7 @@ ### Валидация входа и подсчёт страниц -Вход валидируется **до** `convertToStream`: `WordPdfValidator.validate(bytes, options)` (размер → подпись: zip `PK\x03\x04` или CFB `D0 CF 11 E0` → контейнер → страницы). Для `.doc` страницы считаются **по сырым байтам .doc, до конвертации**: `checkPageCountDoc` = `max(SummaryInfo PageCount, 1 + явные разрывы)`; явные — 0x0C в основном тексте + `sprmPFPageBreakBefore` из PAPX. Тот же метод — вход приложения. Скан выполняется ровно один раз по сырому входу, до аллокаций docx4j: правила 1–10 число учитываемых разрывов не увеличивают (правило 9 способно только убрать разрыв внутри скрытого рана — счёт по сырому входу остаётся верхней оценкой лимита). +Вход валидируется **до** `convertToStream`: `WordPdfValidator.validate(bytes, options)` (размер → подпись: zip `PK\x03\x04` или CFB `D0 CF 11 E0` → контейнер `checkOoxmlContainer` → `ContainerKind.DOCX|XLSX` по подстрокам `[Content_Types].xml` (маркеры — content-type'ы частей `wordprocessingml.document` / union-префикс `spreadsheetml.` (worksheet/sheet/sharedStrings/styles); DOCX проверяется первым — манифест с обоими маркерами трактуется как .docx; ни одного маркера → 400) → страницы). Для `.doc` страницы считаются **по сырым байтам .doc, до конвертации**: `checkPageCountDoc` = `max(SummaryInfo PageCount, 1 + явные разрывы)`; явные — 0x0C в основном тексте + `sprmPFPageBreakBefore` из PAPX. Для `.xlsx` — `checkPageCountXlsx` = двупроходная нижняя оценка `estimateXlsxPages`: проход 1 — `xl/workbook.xml` (видимые листы: r:id, state≠hidden/veryHidden) + `xl/_rels/workbook.xml.rels` (rId → target части, внешний/отсутствующий target — лист не учитывается), проход 2 — счёт `rowBreaks/brk` в целевых частях; страницы = число учитываемых листов + их разрывы; `docProps/app.xml` для книг не читается (Excel `` не кэширует), геометрия `PrintLayout` — дело моста, оценка обязана быть ≤ фактических секций. Тот же метод — вход приложения. Скан выполняется ровно один раз по сырому входу, до аллокаций docx4j: правила 1–10 число учитываемых разрывов не увеличивают (правило 9 способно только убрать разрыв внутри скрытого рана — счёт по сырому входу остаётся верхней оценкой лимита). - Страницы в валидаторе = `max(кэш docProps/app.xml, явные разрывы, lastRenderedPageBreak+1)`; explicit = межсекционные `w:sectPr` в body + `w:br type="page"` + `pageBreakBefore` (включая таблицы и `w:sdt`). Единственный путь — lightweight (StAX по zip, secure-ридер без DTD/external entities; `WordPdfValidator` не зависит от docx4j): атрибуты — по локальному имени (`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 молчит — подпись проверяет вызывающий. `checkPageCount` — один стриминговый проход `ZipInputStream` без буферизации частей (хелпер `noClose` глушит `close()` сканеров): потребление O(одной части) вместо O(суммы XML-частей). diff --git a/docs/agent/repo-map.md b/docs/agent/repo-map.md index 1544bce..5ca59db 100644 --- a/docs/agent/repo-map.md +++ b/docs/agent/repo-map.md @@ -6,12 +6,13 @@ |---|---| | `wordpdf-core/src/main/java/ru/pjandro/wordpdf/` | Публичный API: `WordPdfConverter` (`convert(byte[],String[,ConvertOptions])`), `WordPdfValidator` (`checkInput`/`checkPageCount`/`validate` — без зависимости от docx4j), `ConversionException`, `ValidationException` (наследник — «вход некорректен»), `DrawingFoundException` (`enum Kind {CHARTS, SMARTART, OLE}`), `WordPdfSettings` (`MAX_INPUT_MB=5`, `MAX_PAGES=100`, защитные `MAX_DECOMPRESSED_MB=200`/`MAX_ZIP_ENTRIES=8192`, `ERROR_ON_*=false`), `ConvertOptions` (record) | | `…/wordpdf/fonts/` | `BundledFonts` (реестр/выгрузка TTF), `BundledFontMapper` (алиасы, self-map, `DISPLAY_NAMES`, `bundledFamily`), `GlyphFont` (глиф-движок fontbox) | -| `…/wordpdf/internal/` | 11 нормализаторов + `DocxRewritePipeline` (один zip-проход правил 1–10, raw-копия неизменённых записей) + `LayoutPostRenderer` (кастомный `FORenderer`, post-FO padding-компенсация таблиц, шаг 4.25) + интерфейс `DocxNormalizer` + `FopFallbackFonts` + `DependencyGuard` (проверка commons-compress, шаг 0). Классы `public` (иначе родительский пакет не вызвал бы), публичные члены наружу только `normalize`/`STEP`/`declare`/`DependencyGuard.check`/`LayoutPostRenderer.register`; `OleObjectNormalizer` — многочастный, публичный `normalize(byte[], boolean)`, бросает `DrawingFoundException(OLE)` | -| `…/wordpdf/internal/doc/` | Мост `.doc` → `.docx`: 18 классов (детали — `docs/agent/doc-bridge.md`) — `CfbReader`, `FibHeader`, `PieceTable`, `Grpprl`, `ChpxIndex`, `PapxIndex`, `Styles`, `Tables`, `Lists`, `Sections`, `FontTable`, `SummaryInfo`, `Headers`, `OfficeArt`, `PrcData`, `DocFile`, `DocxWriter`, `DocToDocx` (публичные `convert`/`countPages`; вложенный `DocxBody` — рендер текста и табличного автомата в XML) | +| `…/wordpdf/internal/` | 11 нормализаторов + `DocxRewritePipeline` (один zip-проход правил 1–10, raw-копия неизменённых записей) + `LayoutPostRenderer` (кастомный `FORenderer`, post-FO padding-компенсация таблиц, шаг 4.25) + интерфейс `DocxNormalizer` + `FopFallbackFonts` + `DependencyGuard` (проверка commons-compress, шаг 0) + `DocxPackageWriter` (писатель мульти-частного docx-зипа для обоих мостов: `[Content_Types].xml`/rels по `Part(entry, contentType, relType, content)`, корневые namespaces с `xmlns:c`, `storyPart` для колонтитуков). Классы `public` (иначе родительский пакет не вызвал бы), публичные члены наружу только `normalize`/`STEP`/`declare`/`DependencyGuard.check`/`LayoutPostRenderer.register`; `OleObjectNormalizer` — многочастный, публичный `normalize(byte[], boolean)`, бросает `DrawingFoundException(OLE)` | +| `…/wordpdf/internal/doc/` | Мост `.doc` → `.docx`: 17 классов (детали — `docs/agent/doc-bridge.md`) — `CfbReader`, `FibHeader`, `PieceTable`, `Grpprl`, `ChpxIndex`, `PapxIndex`, `Styles`, `Tables`, `Lists`, `Sections`, `FontTable`, `SummaryInfo`, `Headers`, `OfficeArt`, `PrcData`, `DocFile`, `DocToDocx` (публичные `convert`/`countPages`; вложенный `DocxBody` — рендер текста и табличного автомата в XML); писатель зипа вынесен в `internal/DocxPackageWriter` (общий с мостом .xlsx) | +| `…/wordpdf/internal/xlsx/` | Мост `.xlsx` → `.docx`: 16 классов (детали — `docs/agent/xlsx-bridge.md`) — `XlsxPackage`, `WorkbookModel`, `SharedStrings`, `ThemeModel`, `StylesModel`, `ColorSpec`, `ColorResolver`, `NumberFormats`, `NumberText`, `Metrics`, `SheetModel`, `PrintLayout`, `SheetToTable`, `DrawingBridge`, `WarnOnce`, `XlsxToDocx` (публичный `convert(byte[], ConvertOptions)`) | | `…/wordpdf/internal/chart/` |17 классов Java2D-рендера диаграмм/SmartArt в PNG (public только `DrawingPreRenderer.run`)| | `wordpdf-core/src/main/resources/fonts/` | 30 TTF + 3 лицензии — бинарные фикстуры, часть jar | | `wordpdf-core/src/main/resources/xslt/` | `docx2fo.xslt` — вендорный XSL-FO-стилист (копия docx4j-export-fo + AUDIT-FIX-патчи), часть jar | -| `wordpdf-core/src/test/resources/samples/` | 25 закоммиченных фикстур: 13 `.docx` + 12 `.doc` (11 эталонов заказчика из `develop/doc/` с теми же базовыми именами + `doc-formats.doc`); `.docx` проходят `docs/standards/docx/validate-fixtures.py`, `.doc` — бинарные, XSD к ним неприменим | +| `wordpdf-core/src/test/resources/samples/` | 32 закоммиченных фикстур: 13 `.docx` + 12 `.doc` (11 эталонов заказчика из `develop/doc/` с теми же базовыми именами + `doc-formats.doc`) + 7 `.xlsx` (`xlsx-basic/numfmt/1904/page-limit/wide/fit-to-page/chart-image`, генерирует `SampleXlsxGenerator`, POI); `.docx` проходят `docs/standards/docx/validate-fixtures.py`, `.doc` — бинарные, XSD к ним неприменим | | `wordpdf-core/src/test/resources/geom/` | `presetShapeDefinitions.xml` — копия приложения ECMA-376, синхрон таблицы `PresetGeometry` (только в тестах, в jar не попадает) | | `wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/` | REST API (10 классов): `WordPdfApplication` (единственный public), `ConvertController`, `ConversionService` (очередь), `ApiExceptionHandler`, `ApiKeyFilter`, `OpenApiConfig` (`@SecurityScheme` X-API-Key) + 4 класса исключений | | `wordpdf-web/src/` | SPA: `api.ts` (вся сеть), `components/` (App, ApiKeyGate, PdfPreview, StatusMessage, DropZone, Logo) | @@ -19,7 +20,7 @@ | `.env.example` | Шаблон env: `WORDPDF_API_KEY` (`openssl rand -hex 32`), закомментированные `WORDPDF_MAX_MB`/`WORDPDF_MAX_PAGES` (пустое значение ломает binding long/int). Проду `.env` не нужен — ключ и лимиты подаёт job `deploy` из Gitea Secrets/Variables | | `.gitea/workflows/` | Gitea Actions: `pr.yml` (`PR checks`), `main.yml` (тесты + coverage-сводка и комментарий в PR → `images-app`/`images-web` (build+push в Nexus) → deploy (рендер прод-конфигов + pull) → autotests → rollback) | | `GITEA-vars.md` | Инструкция владельца: Secrets/Variables, защита ветки, перезапуск — только имена переменных, без значений | -| `prod-autotests/` | Прод-автотесты API (pytest + requests, 31 проверка): конфигурация стенда **только env** (`WORDPDF_BASE_URL` обязателен, `WORDPDF_API_KEY`/`WORDPDF_MAX_PAGES`/`WORDPDF_MAX_MB`/`WORDPDF_SAMPLES_DIR` факультативны) — прод-хостов/ключей в коде нет | +| `prod-autotests/` | Прод-автотесты API (pytest + requests, 32 проверки): конфигурация стенда **только env** (`WORDPDF_BASE_URL` обязателен, `WORDPDF_API_KEY`/`WORDPDF_MAX_PAGES`/`WORDPDF_MAX_MB`/`WORDPDF_SAMPLES_DIR` факультативны) — прод-хостов/ключей в коде нет | | `docs/standards/` | Нормативная документация форматов Word/Excel, шесть каталогов + навигатор `README.md`: `ooxml/` — OOXML: PDF+md ECMA-376 Part 1 (5-е изд.), md [MS-OI29500]/[MS-ODRAWXML], полные наборы XSD `ooxml/schema/strict/` (21) + `ooxml/schema/transitional/` (26); `binary/` — общее OLE2-окружение .doc/.xls [MS-CFB]/[MS-OSHARED]/[MS-ODRAW]/[MS-OLEPS]/[MS-OFFCRYPTO]/[MS-OVBA]/[MS-WMF]/[MS-EMF]; `doc/` — [MS-DOC] (`ms-doc.md` + `ms-doc-full.md` — тот же текст с HTML packet diagram'ами и таблицами sprm §2.6.1–2.6.3, где `ms-doc.md` даёт `[TABLE]`); `docx/` — `validate-fixtures.py` (XSD-валидация `samples/*.docx`, lxml, ставится отдельно); `xls/` — [MS-XLS] (`ms-xls.md` + `ms-xls-full.md` — тот же приём `[TABLE]`); `xlsx/` — [MS-XLSX] (`ms-xlsx.md`); регенерация — README в каждом каталоге | | `develop/` (вне git, gitignored) | Рабочие материалы и эталоны сравнения рендера — **не фикстуры**, в тесты/jar не подключать; пиксельные замеры зашиты числами в chart-тестах | | `docs/agent/` | Глубокие справочники: `pipeline` / `doc-bridge` / `chart` / `render-limitations` / `testing` / `ci-cd` (когда читать — по имени файла) | @@ -38,7 +39,7 @@ - `.ci/maven-settings.xml` — Maven-зеркало Nexus с URL из `${env.MAVEN_MIRROR_URL}` (общий файл CI-job'ов `java` и Containerfile; координаты стенда в репо не хранятся — Variable/build-arg). - `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); `proxy_read_timeout`/`proxy_send_timeout 300s` (дефолтные 60s рвут 2-минутные конвертации 504 раньше app-ного 504); `resolver 10.113.0.1` + `proxy_pass` через переменные (статический `proxy_pass` резолвит имя один раз при старте — gateway, поднявшийся раньше app, получал бы 502 до перезапуска). -- `wordpdf-core/src/test/java/ru/pjandro/wordpdf/SampleDocxGenerator.java` — main()-утилита пересоздания фикстур; `ChartTypesDocxGenerator.java` — генератор `chart-types.docx`. +- `wordpdf-core/src/test/java/ru/pjandro/wordpdf/SampleDocxGenerator.java` — main()-утилита пересоздания фикстур; `ChartTypesDocxGenerator.java` — генератор `chart-types.docx`; `SampleXlsxGenerator.java` — main()-утилита пересоздания 7 фикстур `samples/xlsx-*.xlsx` (POI XSSF); `internal/xlsx/XlsxTestZips.java` — конструктор синтетических .zip-книг для юнитов моста (не фикстура). - `wordpdf-web/vite.local.config.ts` — легаси-одноразовщик (прокси `/api` → :8091), в `tsconfig.node.json` не включён; кандидат на удаление, не тиражировать паттерн. Корневые `javac.*.args` — мусор пробной компиляции (gitignored), тоже кандидат на удаление. ## Development Commands (детали) @@ -62,6 +63,13 @@ java -cp wordpdf-core/target/test-classes:$(cat /tmp/cp.txt) \ ru.pjandro.wordpdf.SampleDocxGenerator wordpdf-core/src/test/resources/samples ``` +Пересоздать 7 фикстур `.xlsx` (тот же classpath): + +```bash +java -cp wordpdf-core/target/test-classes:$(cat /tmp/cp.txt) \ + ru.pjandro.wordpdf.SampleXlsxGenerator wordpdf-core/src/test/resources/samples +``` + ### Перевендоривание XSL-FO-стилиста ```bash @@ -98,7 +106,7 @@ PMD: `failurePriority` в плагине не задан — на практик - Классы в `internal` — `public` (иначе родительский пакет не вызвал бы), но публичные члены наружу только `normalize`/`STEP`/`declare`/`DrawingPreRenderer.run`/`DependencyGuard.check` (`rewrite`, карты — package-private); в `wordpdf-app` всё package-private кроме `WordPdfApplication`. - Гейт JaCoCo `0.8.15`: `jacoco:check` (правило BUNDLE, LINE COVEREDRATIO `0.90` — обоих модулей; в `wordpdf-core/pom.xml` execution `check` переопределён и добавляет BRANCH COVEREDRATIO `0.85` — только для core) на `verify`; агент подключается в surefire через `argLine` = `@{argLine} -Djava.awt.headless=true` (свойство `argLine` в корневом pom по умолчанию пусто и перезаписывается `prepare-agent` — `mvn test -Djacoco.skip=true` без агента работоспособно); `report` и `check` оба на `verify`, report раньше — при провале порога отчёт уже на диске; отчёты `target/site/jacoco/` (html+xml, xml нужен CI-сводке). Плотность покрытия держат тесты, а не заглушки: промахи в основном недостижимые IOException/catch-ветки (`GlyphFont`, `BundledFonts`) и защитные ветви сканеров нормализаторов/валидатора. -- 57 тестовых класса / 886 теста (core 51/843 — из них 17 классов / 225 тестов в `internal/doc/`, `WordPdfConverterTest` 75 — включая блок аудита .docx 2026-11: правила 9–10, AUDIT-FIX-2 и пиннинг сносок/полей/titlePg/vMerge/sdt/txbx/OMML/highlight на синтетике через хелпер `docx(...)`; app 6/43: ConvertController 23 + ApiKeyFilter 8 + ConversionService 5 + ApiExceptionHandler 4 + ConvertLimits 2 + ConversionTimeout 1). JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true`; только `Assertions` (Mockito/AssertJ не использовать; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`), тестовые классы package-private, зеркалят main-пакеты; только `@Test` + два `@BeforeAll` (warm-up шрифтов в `GlyphCoverageNormalizerTest` и `BundledFonts.init()` в `BundledFontsTest`) + `@AfterEach drainWorker` в `ConversionTimeoutTest` (дренировать отменённый FOP-рендер до следующего класса — гонка глобального `PhysicalFonts`). +- 75 тестовых класса / 1095 тестов (core 69/1051 — из них 17 классов / 225 тестов в `internal/doc/`, 15 классов / 189 тестов в `internal/xlsx/` + корневой `XlsxPdfConverterTest` 8 (PDF по фикстурам `samples/xlsx-*.xlsx`), `WordPdfConverterTest` 76 — включая блок аудита .docx 2026-11: правила 9–10, AUDIT-FIX-2 и пиннинг сносок/полей/titlePg/vMerge/sdt/txbx/OMML/highlight на синтетике через хелпер `docx(...)`; app 6/44: ConvertController 24 + ApiKeyFilter 8 + ConversionService 5 + ApiExceptionHandler 4 + ConvertLimits 2 + ConversionTimeout 1). JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true`; только `Assertions` (Mockito/AssertJ не использовать; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`), тестовые классы package-private, зеркалят main-пакеты; только `@Test` + два `@BeforeAll` (warm-up шрифтов в `GlyphCoverageNormalizerTest` и `BundledFonts.init()` в `BundledFontsTest`) + `@AfterEach drainWorker` в `ConversionTimeoutTest` (дренировать отменённый FOP-рендер до следующего класса — гонка глобального `PhysicalFonts`). - Фронт: Node `^20.19.0 || >=22.12.0` (engines vite/rolldown/oxlint из `package-lock.json` — в `package.json` секции `engines` нет), npm с закоммиченным `package-lock.json` (`npm ci`); vite `^8.3`, React `^19.2`, TS `~6.0` (**`strict` нигде не включён** — `npm run build` не является strict-гейтом), Tailwind `^4.3`, oxlint `^1.81`; сборка web-образа на `node:24-alpine`. - Контейнеры (podman/buildah): `FROM` только FQDN (`docker.io/library/...` — short-name не резолвится без `unqualified-search-registries`); buildah подмешивает хостовые прокси-переменные в `RUN`/`HEALTHCHECK` — обнулять `HTTP_PROXY= http_proxy= …` **на самой команде** (ENV не перебивает). Chart-движку нужен только модуль `java.desktop` (Graphics2D, он внутри JRE); fontconfig и системные шрифты рантайму не нужны — текст рисуется глифами fontbox (`fonts/GlyphFont`), проверено на musl-стенде без libfontconfig/`/etc/fonts`. diff --git a/docs/agent/testing.md b/docs/agent/testing.md index 336495e..4d795fd 100644 --- a/docs/agent/testing.md +++ b/docs/agent/testing.md @@ -8,7 +8,7 @@ ### Фикстуры -- Фикстуры — закоммиченные `samples/*.docx` + `samples/*.doc` (13 + 12; в тестах не генерировать; `.docx` все ECMA-conformant по `docs/standards/docx/validate-fixtures.py` — фикстура невалидна, правится фикстура, не код; `.doc` — эталоны заказчика, конвертируются мостом): core грузит classpath-ресурсом → `byte[]`, PDF для PDFBox — временный файл; app читает `/samples/…` из **test-jar core** (classifier `tests`) → `mvn -pl wordpdf-app` без `-am` не соберётся. In-memory docx — `ZipOutputStream` из литеральных XML или POI в `byte[]`; in-memory `.doc` — POIFS (`POIFSFileSystem`) вокруг крафтовых WordDocument/1Table/Data (`DocToDocxFormattingTest`). Ключевые: `too-many-pages` (150 явных разрывов → 151; `.doc`-пара — кэш PageCount=150 → 400 «не менее 151»), `stale-cache` (docx: кэш `1` + 110 `lastRenderedPageBreak` → 400; doc: кэш 5 → конвертируется — семантика запинена), `charts-smartart` (4 растра; SmartArt-одиночка = ровно 2 Image XObject; `.doc`-пара — 3 BLIP-fallback → 3 картинки), `ole-embedded` (осиротевший bin с ложным `Default bin→footer+xml` + настоящий `w:object` с честным `Override → oleObject` и VML-плейсхолдером `media/fallback.png` — ручная, генератором не перезаписывать; `.doc`-пара — OLE-fallback BLIP → 1 картинка), `chart-types` (14 графиков: 9 типов + ofPie-pie + lineChart stacked + `c:wireframe` + combo barChart+lineChart на вторичной `c:valAx` pos="r"; пересоздание — `ChartTypesDocxGenerator`; `.doc`-аналога нет), `doc-formats.doc` (2 страницы — лимит страниц на .doc-пути). +- Фикстуры — закоммиченные `samples/*.docx` + `samples/*.doc` + `samples/*.xlsx` (13 + 12 + 7; в тестах не генерировать; `.docx` все ECMA-conformant по `docs/standards/docx/validate-fixtures.py` — фикстура невалидна, правится фикстура, не код; `.doc` — эталоны заказчика, конвертируются мостом; `.xlsx` генерирует `SampleXlsxGenerator` (POI), их содержимое — контракт: тексты ячеек запинены, assertions только по целым словам широких колонок — узкие режутся переносом FOP): core грузит classpath-ресурсом → `byte[]`, PDF для PDFBox — временный файл; app читает `/samples/…` из **test-jar core** (classifier `tests`) → `mvn -pl wordpdf-app` без `-am` не соберётся. In-memory docx — `ZipOutputStream` из литеральных XML или POI в `byte[]`; in-memory `.doc` — POIFS (`POIFSFileSystem`) вокруг крафтовых WordDocument/1Table/Data (`DocToDocxFormattingTest`). Ключевые: `too-many-pages` (150 явных разрывов → 151; `.doc`-пара — кэш PageCount=150 → 400 «не менее 151»), `stale-cache` (docx: кэш `1` + 110 `lastRenderedPageBreak` → 400; doc: кэш 5 → конвертируется — семантика запинена), `charts-smartart` (4 растра; SmartArt-одиночка = ровно 2 Image XObject; `.doc`-пара — 3 BLIP-fallback → 3 картинки), `ole-embedded` (осиротевший bin с ложным `Default bin→footer+xml` + настоящий `w:object` с честным `Override → oleObject` и VML-плейсхолдером `media/fallback.png` — ручная, генератором не перезаписывать; `.doc`-пара — OLE-fallback BLIP → 1 картинка), `chart-types` (14 графиков: 9 типов + ofPie-pie + lineChart stacked + `c:wireframe` + combo barChart+lineChart на вторичной `c:valAx` pos="r"; пересоздание — `ChartTypesDocxGenerator`; `.doc`-аналога нет), `doc-formats.doc` (2 страницы — лимит страниц на .doc-пути). ### Юниты @@ -16,9 +16,11 @@ - Юниты моста (`internal/doc/`): `CfbReaderTest` строит крафтовый CFB-байтстрим (сектор 512/mini 64: FAT/DIFAT/miniFAT/directory руками) и бьёт все guard-ветки (циклы FAT/DIFAT/MiniFAT, ссылки за файл, обрезанные потоки, root без mini stream, мусор в directory); `SummaryInfoTest` — крафтовый PropertySetStream (пинит **относительность offset от начала PropertySet**, реальные фикстуры её не различают); `PieceTableTest`/`ChpxIndexTest`/`PapxIndexTest` (в т.ч. `istdFor`: istd из UpxPapx, пустой grpprl ≠ null, bOffset=0 → дефолтные свойства при сохранённой границе)/`SectionsTest`/`FibHeaderTest` (пара fcStshf)/`GrpprlTest` (в т.ч. спец-длины: двухбайтовый cb у sprmTDefTable при operand >255 Б, у 0xC60D cb=0xFF — обрыв, у 0xC615 cb=0xFF — длина по формуле §2.9.182 (`scan_pChgTabsSentinel_lengthByFormula`))/`FontTableTest`/`HeadersTest`/`OfficeArtTest`/`PrcDataTest` — byte[]-конструкции in memory (`PrcDataTest`: разворачивание huge-PAPX/PTableProps на позиции указателя, union цепочки с легаси-зеркалом, guard'ы — cb-капа 0x3FA2, ptr за Data, цикл A→B→A); `StylesTest` — крафтовый STSH (LPStd/LPUpx): цепочка base→derived, цикл → пустая таблица, чужой stk/битый STSH нисходительны; `TablesTest` — крафтовый TAP: сетка TDefTable (XAS со знаком), границы Brc (cv fAuto) и Brc80 (ico, приоритет 0xD613), выравнивание sprmTJc/sprmTJc90 (u16, приоритет современного, 0 → null), деградация при битом TDefTable; `ListsTest` — крафтовые PlfLst/PlfLfo байтстримом (счёт LVL по fSimpleList 1/9, плейсхолдеры xst → `%{n+1}` и литеральный `%` → `%%`, MSONFC→ST_NumberFormat вкл. экзотика→decimal, ixchFollow→`w:suff`, grpprl уровня → `w:ind`/`w:rFonts`, LFOLVL fStartAt/fFormatting, обрыв LVL-массива, lsid без LSTF, нулевые lcb); `DocToDocxFormattingTest` — полный синтетический .doc через POIFS (крафтовые FIB/Clx/FKP-страницы: полные CHPX/PAPX-свойства, STSH-цепочка с переопределением и победой direct, spacing/tabs, таблица TTP+TDefTable+Brc с деградацией строки без сетки и многострочной ячейкой, колонтитук со стилевым jc, табы колонтитука из стиля sprmPChgTabs (`styleTabsChg_reachesFooterPart`/`styleTabsChgDel_removesStop`: прямой del с rgdxaClose вырезает stop стиля), таблица в odd footer со sprmTJc (`footerTable_jcCenterEmitted`: guard-¶ отдельным абзацем после строки, как в реальных Plcfhdd), знаки, поле в основном тексте, picLocation=0, 0Table, отсутствие табличного потока, списки: `listParagraphs_getNumPrAndNumberingPart` (sprmPIlfo/sprmPIlvl в PAPX → `w:numPr` + `word/numbering.xml` c `w:num`/Override/rels), `listCancelledByDirectZero_noNumPr` (ilfo стиля, перекрытый прямым 0), `ilvlSkipValue_noNumPr` (ilvl=0x0C), `missingListTables_degradeToPlain` (нулевые FIB-пары 73/74 — ни numbering-части, ни numPr)). Doc-регрессии конвертера — общие assert-хелперы docx-пар: `assertCyrillicAndStyles`/`assertPageNumbers`/`assertTableImage`/`assertOleObjectsRemoved`/`assertDrawingsBecomeImages`/`assertTooManyPages`/`assertExoticGlyphs` вызываются с `ru-plain.doc`/`page-numbers.doc`/`ru-table-image.doc`/`ole-embedded.doc`/`charts-smartart.doc`/`too-many-pages.doc`/`exotic-glyphs.doc` (тесты-пары называются по docx-имени, внутри зовут оба формата); `WordPdfValidatorTest#checkPageCountDoc_*` + `ConvertControllerTest` (`.doc` upload, `nonDocxFilename_rejected`). +- Юниты моста `.xlsx` (`internal/xlsx/`): синтетические книги — `XlsxTestZips` (литеральные XML в `ZipOutputStream`: workbook/sheet/rels/sst/styles/theme; лист обязан ссылаться на рисунок элементом `` в XML листа — `SheetModel` резолвит `drawingPath` по элементу, не по релсам); POI в юнитах моста не используется. PDF-слой — корневой `XlsxPdfConverterTest` по фикстурам (текст, `imageCount`/`distinctImageCount`, 422 `Kind.CHARTS`/`Kind.OLE`). + - App-тесты: `@SpringBootTest` + `@AutoConfigureMockMvc` (Boot 4: `org.springframework.boot.webmvc.test.autoconfigure`); четыре контекста — `ConvertControllerTest` (пустой ключ), `ApiKeyFilterTest` (`properties = "wordpdf.api-key=…"`), `ConvertLimitsTest` (`@TestPropertySource` max-mb/max-pages), `ConversionTimeoutTest` (`@TestPropertySource` convert-timeout=1ms) — четыре разных набора свойств = четыре кэшированных контекста (отдельные классы, не `@Nested`: `@Nested` + `@TestPropertySource` не даёт отдельного контекста); `ConversionServiceTest`/`ApiExceptionHandlerTest` — без Spring-контекста (прямые юниты). -- UI-тестов нет; гейт SPA — `npm run build` (tsc -b) + `npm run lint` (oxlint, `.oxlintrc.json`: rules-of-hooks error, only-export-components warn). Прод-автотесты (pytest 9.1.1 + requests 2.34.2, 31 проверка — 27 под маркером `needs_key` (SKIP без ключа; включая `.doc`-фикстуры обоих путей — растры/OLE и границы страниц), 4 открытых: health/SPA-root/swagger/spec; env-конфиг, `mise exec -- python -m pytest -q .` из `prod-autotests/`) гоняются CI после deploy против живого прода. +- UI-тестов нет; гейт SPA — `npm run build` (tsc -b) + `npm run lint` (oxlint, `.oxlintrc.json`: rules-of-hooks error, only-export-components warn). Прод-автотесты (pytest 9.1.1 + requests 2.34.2, 32 проверка — 28 под маркером `needs_key` (SKIP без ключа; включая `.doc`/`.xlsx`-фикстуры обоих путей — растры/OLE и границы страниц), 4 открытых: health/SPA-root/swagger/spec; env-конфиг, `mise exec -- python -m pytest -q .` из `prod-autotests/`) гоняются CI после deploy против живого прода. ### Регрессивные записи, не выводимые из кода @@ -28,4 +30,4 @@ - `vendoredXsltTracksJarCopy` — дрейф-гейт: вне AUDIT-FIX-регионов вендорный `docx2fo.xslt` обязан быть побайтно равен стилисту из jar'а docx4j-export-fo (при апгрейде docx4j — перевендорить и перенести патчи). - Крафт POIFS (закоммиченных фикстур нет, крафт продублирован в `WordPdfConverterTest`): `ListsTest`+`DocToDocxFormattingTest#list*`↔`docLists_numberingAndBulletsRendered` (синтетический .doc со списками → PDF: `1.` `2.` `a)` `b)` `•`, ни одного `#`; фикстур со списками нет — крафт POIFS продублирован в `WordPdfConverterTest`), `PrcDataTest`+`DocToDocxFormattingTest#hugePapxRowMark_closesRowWithGridFromPrcData` (TTP-абзац с grpprl в PrcData Data-потока → `w:tbl`/`w:tr`/сетка из цепочки; фикстуры нет — `docTest.doc` заказчика не коммитим, крафт POIFS продублирован), `SectionsTest`+`HeadersTest`+`DocToDocxFormattingTest#twoSections*/sectionBreakInTable*`↔`docMultiSection_perSectionHeaders` (двухсекционный .doc → PDF: стр. 1 — ШАПКА-1+ПОДВАЛ-1, стр. 2 — ШАПКА-2 + унаследованный ПОДВАЛ-1, ни одной `#`; крафт POIFS продублирован в `WordPdfConverterTest`), `ChpxIndexTest#zeroOffset_defaultPropsBoundaryKept`+`DocToDocxFormattingTest#runFlags_*/keepNextKeepLines_*/sectLandscapePgNumCols_*/sectUnevenCols_*/cellVertAlign_*/drawnObject_*`+`SectionsTest#orientationPgNumColumns_applied/unevenColumns_perIndexWidths/restartWithoutStart_clampsToOne`+`TablesTest#vertAlign_*`↔`WordPdfConverterTest#docClassD_landscapeHiddenDelCaps/#docClassD_pageNumberRestartLowerRoman/#docClassD_twoColumnsBreak/#docClassD_drawnObjectBecomesImage` (закрытие пробелов класса D: vanish-фильтр/правки/caps/position/keep, landscape+pgNumType, колонки+column break, vAlign, 0x08→inline-картинка; фикстур нет — крафт POIFS продублирован в обоих тестовых классах). - Синтетика через общий хелпер `docx(docXmlns, body, sect, rels, overrides, parts)`: AUDIT-FIX-2↔`movedRevision_textPrinted`/`bdoDir_textPrinted` (фикстур нет — синтетический docx через общий хелпер `docx(docXmlns, body, sect, rels, overrides, parts)`); пиннинг аудита .docx↔`footnote_rendersAtPageBottom`, `endnote_rendersAtDocumentEnd`, `docxHyperlink_uriAnnotation`, `pageRefField_liveNotCached` (кэш 9001/7777 заменён живым номером), `dateField_notStaleCache` (кэш 01.02.2003 заменён текущей датой), `titlePg_firstPageHeader`, `vMergeCell_spansRows`, `sdtContent_rendered`, `drawingTextBox_textPrinted`, `ommlMath_drawnAsVectors` (пиксели: +150 тёмных px@150dpi сверх текста), `highlightAndShading_backgroundDrawn` (жёлтые px >0 против baseline 0), аудит [MS-DOC] моста 2026-11: `GrpprlTest#tInsertOperand_skippedBySpra`/`tInsertOperand_truncated_aborts` (sprmTInsert — 4 байта, хвост TAP не рассинхронизирован), `TablesTest#cellPadding_*` + `DocToDocxFormattingTest#cellMargins_becomeTcMar` ↔ `WordPdfConverterTest#tableTcMar_textInsetLikeWord` (CSSA→w:tcMar, пайплайн красит поля ячейки как tblCellMar — текст на margin+padding), `StylesTest#characterStyle_stk3_chainViaCharChain`/`charChain_nonCharacterStk_empty` + `DocToDocxFormattingTest#charStyle_viaIstd_mergesUnderDirect` (sprmCIstd: символьная chpx-цепочка между стилевой и прямыми, direct wins), `DocToDocxFormattingTest#runHighlightAndShading_inRPr`/`runShadingPattern_degradesToBackFill`/`paraShd_inPPrBeforeJc` ↔ `docHighlightAndShading_yellowPixels` (Ico→ST_HighlightColor; w:shd в форме FOP val="clear"+fill; паттерн→cvBack), `SectionsTest#titlePage_flagFromSepx` + `DocToDocxFormattingTest#titlePage_emittedAfterCols` ↔ `docTitlePage_firstHeaderOnlyFirstPage` (sprmSFTitlePage + first-слоты Plcfhdd → headerReference type="first", первая страница — только first-шапка).. -- App-регрессии: `requestLimitParams_areIgnored`, `nonPositiveLimits_failStartup`, `unknownPath_notFound`, `concurrentRequests_bothSucceed`, `corruptNotAZip_rejected`, `plainZipNotDocx_rejected`, `junkInsideValidZip_conversionError` (500 на валидном .docx-контейнере с мусором), `nonDocxFilename_rejected`, `oversizedOverCoreLimit_rejected`, `drawingsAlwaysRendered`, `cyrillicAndPathInFilename_sanitizedResponseName`, `docsOpenWithoutKey`/`forwardedPrefix_healthStaysOpen`/`forwardedPrefix_docsOpenWithoutKey`, `dotSegmentOpenPrefix_rejected`, `errorFlagNotBoolean_rejected`, `methodNotSupportedReturns405`/`badContentTypeReturns415`. +- App-регрессии: `requestLimitParams_areIgnored`, `nonPositiveLimits_failStartup`, `unknownPath_notFound`, `concurrentRequests_bothSucceed`, `corruptNotAZip_rejected`, `plainZipNotDocx_rejected`, `junkInsideValidZip_conversionError` (500 на валидном .docx-контейнере с мусором), `nonDocxFilename_rejected`, `xlsxFile_convertsToPdf`, `oversizedOverCoreLimit_rejected`, `drawingsAlwaysRendered`, `cyrillicAndPathInFilename_sanitizedResponseName`, `docsOpenWithoutKey`/`forwardedPrefix_healthStaysOpen`/`forwardedPrefix_docsOpenWithoutKey`, `dotSegmentOpenPrefix_rejected`, `errorFlagNotBoolean_rejected`, `methodNotSupportedReturns405`/`badContentTypeReturns415`. diff --git a/docs/agent/xlsx-bridge.md b/docs/agent/xlsx-bridge.md new file mode 100644 index 0000000..1a50892 --- /dev/null +++ b/docs/agent/xlsx-bridge.md @@ -0,0 +1,77 @@ +# Мост `.xlsx` → `.docx` (`internal/xlsx`) + +Нормативный источник любых правок — ECMA-376 Part 1 (SpreadsheetML: книга/листы §18.2, +стили §18.8, печать §18.3, рисунки/диаграммы §21), окружение OPC — §3, ссылки — с +номерами секций; локальные копии спецификаций в `docs/standards/`. Runtime-зависимостей +нет (StAX + `java.util.zip`; POI — test-scope, только генератор фикстур). Публичные +точки наружу: `XlsxToDocx.convert` (вызывает `WordPdfConverter`), предикат формата — +`WordPdfValidator.isSpreadsheet`; остальные классы package-private в `internal/xlsx`. + +Вход роутируется в `WordPdfConverter.convertToStream` по сигнатуре+содержимому: +`PK\x03\x04` и в `[Content_Types].xml` объявлен `…/sheet` — это книга → +`XlsxToDocx.convert(bytes, options)` → in-memory `.docx` → общий конвейер docx4j/FOP. +Валидация до конвертации — `WordPdfValidator.validate`: контейнер +(`checkOoxmlContainer` возвращает `ContainerKind.DOCX|XLSX` по маркерам +`[Content_Types].xml`), для `XLSX` — `checkPageCountXlsx`: двупроходная нижняя +оценка `estimateXlsxPages` (проход 1 — `xl/workbook.xml` + `xl/_rels/workbook.xml.rels`: +видимые листы и targets частей; проход 2 — счётчик `rowBreaks/brk` в целевых частях; +страницы = видимые листы ×1 + явные разрывы; `docProps/app.xml` для книг не читается — +Excel `` не кэширует, а нижняя оценка отсекает заведомо гигантские вход +дешевле полной геометрии `PrintLayout`). + +## Классы + +|Класс|Семантика| +|---|---| +|`XlsxPackage`|zip книги в памяти: части по имени, `_rels` любого part'а (`Rel(id,type,target,external)`), `relTargetPath` (target резолвится от каталога part-источника, `../` включительно), `resolvePath`/`parentDir`/`relsPathOf`, `truthy`/`attr`, `newSecureReader()` (StAX без DTD/external-сущностей). Битый zip/rels → `ValidationException`| +|`WorkbookModel`|`xl/workbook.xml`: `Sheet(name,state,partPath)` по `r:id` из rels книги; не-`visible` листы помечаются, в вывод не попадают; `date1904` из `workbookPr` (сдвиг дат на 1462 дня в `NumberFormats`)| +|`SharedStrings`|`xl/sharedStrings.xml` → индекс строк; `` — обычный текст, ``-раны с `rPr` (b/i/u/strike/sz/color/vertAlign/rFonts) → `Run(text,RunStyle)`; `parseRst` переиспользуется для `is`-ячеек inlineStr; `siPh` — пропуск| +|`ThemeModel`|`xl/theme/theme1.xml`: 12 clrScheme-тонов (`dk1/lt1/dk2/lt2/accent1-6/hlink/folHlink`) + шрифты (`majorFont`/`minorFont`, latin+ea+cs); заголовок по `name`/`name val`; `theme1.xml` переносится в `word/theme/` для штатного chart-движка| +|`StylesModel`|`xl/styles.xml`: numFmts (кастомные `formatCode` поверх встроенных), fonts/fills/borders/cellXfs по индексам; `cellStyleXfs` как base-цепочка (`xfId`), `cellStyle`-имена не нужны; `alignment(horizontal/vertical/indent)`; `xfId`-наследование cellXf от cellStyleXf base-first| +|`ColorSpec`|атрибуты `` → спецификация: `rgb` (RRGGBB/AARRGGBB, `auto`), `theme`+`tint`+`shade`, `indexed`, `auto`; парсинг — `fromColorElement(xr)`| +|`ColorResolver`|`ColorSpec` → sRGB int: theme → тон `ThemeModel` (dk1/lt1 меняются местами с bg1/tx1 по ECMA-376 §18.3.1.43), tint/shade — логарифмическая модуляция светлоты HSL (калибровка ECMA-376 §18.3.1.83/.105), indexed: 0–63 фиксированная палитра Office, 64+ — `palette` из styles| +|`NumberFormats`|формат-код → текст числа: секции `pos;neg;zero;text`; заполнители `0 # ?`, разделители тысяч (`,` до `,`-суффикса ×1000, `,,` ×1e6, масштаб `%`/`‰`), проценты, даты/время (`d/m/y/h/s`, `[]`-кумуляции), научный `E`, текст-литералы `"…"`/`\`, `@`, `General` — `NumberText.general`; `[…]`-секции (условия `[>5]`, цвета `[Red]`, `[$-…]`) вырезаются из кода — принятая деградация, печатаем без цвета/условия. Битый код → `General` + warn. Календарная эпоха 1900/1904 из `WorkbookModel`| +|`NumberText`|``-байты → `double`/текст по типу ячейки (`str`/`s`/`inlineStr`/`e`/`b`/`d`); `general(double)` — кратчайшая десятичная репрезентация без `BigDecimal`-хвостов| +|`Metrics`|метрики шрифта листа: MDW (средняя ширина `0` в Calibri 11 через `GlyphFont`/fontbox; fallback 7), ширина колонок chars→twips (`(chars − padding·MDW…)` по ECMA-376 §18.3.1.8: px = `round(((256·chars + round(14/MDW·256))/256)·MDW)`, twips = px·15), высоты строк (pt→twips), конвертеры `pxToTwips`/`pxToEmu`/`ptToTwips`/`inchesToTwips`. Пересчёт на метрику `normal`-шрифта книги| +|`PrintLayout`|страница печати листа: `Page` (paperSize→twips по ECMA-376 §17.6.5, landscape, поля `pageMargins` дюймы→twips, дефолты Word/L Excel: 0.7/0.75/0.3), `Plan` — срезы: горизонтальные полосы строк по `rowBreaks`/высоте, внутри — вертикальные по `colBreaks`+ширинам и print area; `fitToPage` (`fitToWidth`/`fitToHeight` ≤ 0 = auto) — равномерный `widthScale` колонок (масштаб в `%` в `w:sectPr` не используется — FOP не исполняет, режем колонки уже); `sectPr(Page)` — pgSz/pgMar для секции docx| +|`SheetModel`|лист целиком: `sheetData` (строки/ячейки: `r`/`s`/`t`, ``, inlineStr `is`, формулы — значение из кэша ``, отсутствующее `` + `t=str` → пусто), `cols` (диапазоны ширинок/hidden/стиль колонки), hidden-строки/колонки, `mergeCells`, `hyperlinks` (rel part'а → внешний target), `sheetPr.pageSetUpPr.fitToPage`, print area/breaks, `headerFooter` (не рендерится — деградация), `pageSetup`, `drawing r:id` → `drawingPath` (путь резолвится по rels part'а листа), `legacyDrawing`/`oleObjects`/`controls` → `olePresent`. `parseRef`/`parseRange` — A1-нотация| +|`SheetToTable`|срез → XML-блоки: один `w:tbl` на полосу (сетка `w:tblGrid` из видимых колонок с `w:gridSpan` слияний, `w:tcW` фикс., границы из стиля, `w:tblLayout fixed`), пустые строки/колонки outside content — сжимаются в строки-заполнители минимальной высоты; `w:trPr/w:trHeight` из высоты строки; ячейка: `w:p` c `w:pPr/w:spacing` нулевым, `w:ind` из indent, `w:jc` по Excel-горизонтали (§18.8.1, distributed/distribute — деградация к left/center), содержимое: рань-цепочка (sst-раны с rPr поверх стиля ячейки, прямое форматирование побеждает; `w:vertAlign` прокидывается), число через `NumberFormats`, `w:hyperlink w:external`; слияния: `w:gridSpan` + `w:vMerge restart/continue`, невидимые части hidden-колонок в слиянии — clamp; вертикальный origin — первая видимая строка| +|`DrawingBridge`|`xl/drawings/drawingN.xml` → позиции+эмитты: якоря `twoCellAnchor`/`oneCellAnchor`/`absoluteAnchor` (EMU-кумулятив по ширине/высоте колонок-строк через `Metrics`, hidden-единицы = 0; `xdr:ext` != `a:ext` — namespace-различение!), from-ячейка → anchor (hidden clamp к первой видимой); `xdr:pic` → media-часть `word/media/xlsx-imageN.` (байты как есть, тип по расширению blip-target) → `wp:inline`-рань внутри from-ячейки (clamped); `graphicFrame` c `c:chart` → `word/charts/xlsx-chartN.xml` `DocxPackageWriter.Part`'ом с `CHART_REL_TYPE`/`c:chartSpace` content-type (rels части создаёт писатель), в теле остаётся `graphicData` — штатный шаг 3.5 (`DrawingPreRenderer`) дорисовывает PNG 300 dpi и применяет `errorOnCharts`; SmartArt (`dgm:`), фигуры `sp`/`cxnSp`, внешние blip — пропуск + warn (`errorOnSmartArt` на .xlsx не срабатывает — контракт REST); `olePresent`/OLE-blip → warn, при `errorOnOle` — `DrawingFoundException(Kind.OLE)` → 422; `theme1.xml` → `word/theme/` по `theme`-rel книги (палитра chart-движку); потолок `MAX_EXTENT_EMU = 22_000_000` (как `DrawingPreRenderer`) — превысил → объект остаётся как есть| +|`WarnOnce`|дедупликация warning'ов по шаблону (битая книга не тонет в логе)| +|`XlsxToDocx`|оркестратор: `XlsxPackage` → `WorkbookModel` → `ThemeModel`/`StylesModel`/`SharedStrings` → на каждый видимый лист: `PrintLayout.plan` → блоки-срезы; между блоками — секционные разрывы (`w:pPr/w:sectPr` со `sectPr(Page)`), колонтитуки — деградация; финальный body-`sectPr` последнего листа; picture/chart/theme-части через `DocxPackageWriter` (части `word/media/*`, `word/charts/*`, `word/theme/*` + rels манифеста). `options.errorOnOle` бросает `DrawingFoundException` до сборки docx| + +## Ключевые соглашения + +- Единицы: xlsx хранит ширины колонок в символах MDW, высоты строк в пунктах, поля в + дюймах, EMU в рисунках; все конверсии — только через `Metrics` (`pxToTwips` = px·15, + `ptToTwips` = pt·20, EMU/pt = 12700). Ошибка в коэффициенте = расползание сетки. +- Скрытые строки/колонки не рендерятся, но их вклад в геометрию якорей/слияний + обнуляется (hidden = 0 EMU/twips), anchor клампится к первой видимой единице — + иначе рисунок уезжает за страницу. +- Числа форматируются по кэшированному `` (пере-вычисление формул не делается — + формулы Excel не исполняются, значения берутся из файла; пустое `` при `t=str` + — пусто, не «#»). +- `PrintLayout.plan` — источник геометрии секций моста; валидатор страниц + (`estimateXlsxPages`) — независимая дешёвая нижняя оценка (листы + явные + `rowBreaks`), она обязана быть ≤ числа секций моста, но не обязана совпадать — + лимит `MAX_PAGES` отсекает заведомо гигантский вход до полной разметки. +- Фикстуры генерирует `SampleXlsxGenerator` (test-класс, POI 5.5): 7 штук + `samples/xlsx-*.xlsx` — basic/numfmt/1904/page-limit/wide/fit-to-page/chart-image; + содержимое фикстуры — контракт (тесты пинят тексты ячеек, `norm` схлопывает пробелы; + assertions — по целым словам широких колонок, узкие режутся переносом). + +## Деградации (принятые, не чинить) + +- Колонтитуки `headerFooter`, повторяющиеся заголовки `printTitles` (`titlesOnly`/ + row-and-column), `framePr`-фреймы, комментарии, `rPh`-фонетика, флаг `wrapText` + (текст в ячейке переносится FOP по ширине колонки всегда) — пропуск. +- Формат-коды с условиями `[<]`/цветами `[Red]`/локалями `[$-…]`: `[…]`-секции + вырезаются, число печатается остатком кода без цвета и без проверки условия. +- Fit-to-page реализован геометрическим сжатием ширины колонок (FOP игнорирует + масштаб секции docx4j), `fitToHeight` > 0 — та же судьба: страницы по высоте не + спрессовываются дополнительно. +- `errorOnSmartArt` для .xlsx не срабатывает (SmartArt отбрасывается до порога + детекта docx-пайплайна) — зафиксировано в `@Operation`. + +Регрессии: пары юнит↔конвейер — `XlsxPackageTest`…`PrintLayoutTest` ↔ +`XlsxPdfConverterTest` (PDF-текст/imageCount по фикстурам `samples/xlsx-*.xlsx`). diff --git a/docx4j-core-17.3.2-sources.jar b/docx4j-core-17.3.2-sources.jar new file mode 100644 index 0000000..63fac13 Binary files /dev/null and b/docx4j-core-17.3.2-sources.jar differ diff --git a/prod-autotests/test_prod_api.py b/prod-autotests/test_prod_api.py index 42e9a37..ba271a1 100644 --- a/prod-autotests/test_prod_api.py +++ b/prod-autotests/test_prod_api.py @@ -105,6 +105,21 @@ def test_convert_binary_doc(url, samples, key_header): assert "filename*=UTF-8''ru-plain.pdf" in r.headers["content-disposition"] +@needs_key +def test_convert_xlsx(url, samples, key_header): + """.xlsx → PDF: мост internal.xlsx на проде.""" + r = requests.post( + url(CONVERT), + headers=key_header, + files={"file": ("xlsx-basic.xlsx", (samples / "xlsx-basic.xlsx").read_bytes())}, + timeout=TIMEOUT, + ) + assert r.status_code == 200 + assert "application/pdf" in r.headers["content-type"] + assert r.content[:4] == b"%PDF" + assert "filename*=UTF-8''xlsx-basic.pdf" in r.headers["content-disposition"] + + @needs_key def test_convert_cyrillic_filename_rfc5987(url, samples, key_header): """Кириллическое имя части → RFC 5987 filename* (safeBaseName), заголовок не режется наружным nginx. 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 a1a7af5..23263af 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 @@ -146,7 +146,7 @@ final class ConversionService { /** * Санитизация имени (единый источник для имени файла и Content-Disposition): * без каталога, только буквы/цифры/пробел/ {@code . _ -}, без суффикса - * .docx/.doc; пустое после очистки → {@code document}. Кириллица разрешена — + * .docx/.doc/.xlsx; пустое после очистки → {@code document}. Кириллица разрешена — * на Linux это валидное имя файла, и заголовок PDF остаётся читаемым. */ static String safeBaseName(String original) { @@ -157,6 +157,8 @@ final class ConversionService { String lower = base.toLowerCase(Locale.ROOT); if (lower.endsWith(".docx")) { base = base.substring(0, base.length() - ".docx".length()); + } else if (lower.endsWith(".xlsx")) { + base = base.substring(0, base.length() - ".xlsx".length()); } else if (lower.endsWith(".doc")) { base = base.substring(0, base.length() - ".doc".length()); } 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 fd2949b..ce37ac1 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 @@ -21,7 +21,7 @@ import java.util.Locale; /** * Единственный эндпоинт API: {@code POST /api/v1/convert} — multipart-поле - * {@code file} (.docx) → синхронный ответ байтами PDF. + * {@code file} (.docx/.doc/.xlsx) → синхронный ответ байтами PDF. * *

Здесь только HTTP-слой: проверка presence/расширения и формирование * {@code Content-Disposition}; проверка содержимого (zip, размер, страницы) — @@ -58,11 +58,14 @@ final class ConvertController { this.maxPages = maxPages; } - @Operation(summary = "Конвертировать .docx/.doc в PDF", - description = "Принимаются .docx (OOXML) и .doc (Word 97–2003, переносится в .docx " - + "мостом: текст и прямое форматирование). errorOnCharts/errorOnSmartArt/errorOnOle — факультативно, по умолчанию " + @Operation(summary = "Конвертировать .docx/.doc/.xlsx в PDF", + description = "Принимаются .docx (OOXML), .doc (Word 97–2003) и .xlsx (SpreadsheetML); " + + ".doc и .xlsx переносятся в .docx мостами: текст и прямое форматирование. " + + "errorOnCharts/errorOnSmartArt/errorOnOle — факультативно, по умолчанию " + "настройки ядра (ошибка не выбрасывается); диаграммы/SmartArt " + "конвертируются всегда, OLE-объекты при выключенном флаге тихо удаляются. " + + "Для .xlsx errorOnSmartArt не срабатывает (SmartArt отбрасывается), " + + "errorOnCharts и errorOnOle работают. " + "Лимиты входа (размер/страницы) задаёт только конфигурация сервера " + "(свойства wordpdf.max-mb/wordpdf.max-pages), параметрами запроса не переопределяются") @SecurityRequirement(name = OpenApiConfig.SCHEME) @@ -80,10 +83,11 @@ final class ConvertController { } String name = file.getOriginalFilename(); String lower = name == null ? "" : name.toLowerCase(Locale.ROOT); - if (!lower.endsWith(".docx") && !lower.endsWith(".doc")) { + if (!lower.endsWith(".docx") && !lower.endsWith(".doc") && !lower.endsWith(".xlsx")) { // расширение проверяется здесь: ядро с байтов его не видит; - // .doc (Word 97–2003) переносится в .docx мостом internal.doc - throw new ValidationException("Поддерживаются только .docx и .doc: " + name); + // .doc (Word 97–2003) переносится в .docx мостом internal.doc, + // .xlsx — мостом internal.xlsx + throw new ValidationException("Поддерживаются только .docx, .doc и .xlsx: " + name); } // Размер проверяется до getBytes(): multipart-лимит сервера (100 МБ) // больше логического лимита входа (wordpdf.max-mb), и без этого гварда diff --git a/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConversionServiceTest.java b/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConversionServiceTest.java index 3d5c11b..22f3aea 100644 --- a/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConversionServiceTest.java +++ b/wordpdf-app/src/test/java/ru/pjandro/wordpdf/app/ConversionServiceTest.java @@ -132,6 +132,7 @@ class ConversionServiceTest { assertEquals("evil", ConversionService.safeBaseName("C:\\tmp\\evil.docx")); assertEquals("отчёт", ConversionService.safeBaseName("отчёт.DOCX")); assertEquals("отчёт", ConversionService.safeBaseName("отчёт.DOC")); + assertEquals("отчёт", ConversionService.safeBaseName("отчёт.XLSX")); assertEquals("doc", ConversionService.safeBaseName("doc.doc")); assertEquals("файл", ConversionService.safeBaseName("каталог\\файл.doc")); } 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 25fd8a7..4d7de97 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 @@ -277,7 +277,27 @@ class ConvertControllerTest { .file(docx("notes.txt", bytes("/samples/ru-plain.docx")))) .andExpect(status().isBadRequest()) .andExpect(jsonPath("$.error", - org.hamcrest.Matchers.containsString(".docx"))); + org.hamcrest.Matchers.containsString(".docx"))) + .andExpect(jsonPath("$.error", + org.hamcrest.Matchers.containsString(".xlsx"))); + } + + /** .xlsx принимается расширением и конвертируется мостом internal.xlsx. */ + @Test + void xlsxFile_convertsToPdf() throws Exception { + MvcResult result = mockMvc.perform(multipart("/api/v1/convert") + .file(docx("Отчёт.xlsx", bytes("/samples/xlsx-basic.xlsx")))) + .andExpect(status().isOk()) + .andExpect(content().contentType(MediaType.APPLICATION_PDF)) + .andExpect(header().string(HttpHeaders.CONTENT_DISPOSITION, + org.hamcrest.Matchers.containsString( + "filename*=UTF-8''%D0%9E%D1%82%D1%87%D1%91%D1%82.pdf"))) + .andReturn(); + byte[] pdf = result.getResponse().getContentAsByteArray(); + assertTrue("%PDF".equals(new String(pdf, 0, 4, StandardCharsets.US_ASCII)), + "тело не начинается с %PDF"); + // «Товар» — заголовок широкой колонки A: не режется переносом по ширине + assertTrue(norm(pdfText(pdf)).contains("Товар"), "текст .xlsx не доехал"); } /** Бинарный .doc принимается расширением и конвертируется мостом internal.doc. */ 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 7ca1e25..98cc5cf 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java @@ -17,6 +17,7 @@ import ru.pjandro.wordpdf.internal.DependencyGuard; import ru.pjandro.wordpdf.internal.DocxNormalizer; import ru.pjandro.wordpdf.internal.DocxRewritePipeline; import ru.pjandro.wordpdf.internal.doc.DocToDocx; +import ru.pjandro.wordpdf.internal.xlsx.XlsxToDocx; import ru.pjandro.wordpdf.internal.OleObjectNormalizer; import ru.pjandro.wordpdf.internal.FopFallbackFonts; import ru.pjandro.wordpdf.internal.LayoutPostRenderer; @@ -124,14 +125,19 @@ public final class WordPdfConverter { // лимита), затем для .docx — zip/контейнер/страницы, для .doc — // страницы по чистому бинарному документу (до конвертации). WordPdfValidator.validate(docxBytes, opts); - // Бинарный .doc (Word 97–2003): мост internal.doc. Сгенерированный + // Роутинг мостов по классификации входа: бинарный .doc (CFB) — мост + // internal.doc; zip с манифестом spreadsheetml — мост internal.xlsx + // (оценка страниц уже сделана валидатором xlsx-путём). Сгенерированный // .docx — собственный артефакт, его штатной валидацией входа не - // проверяем (вход уже проверен по байтам .doc). Переиспользование слота - // docxBytes: результат моста становится в тот же слот, и сырые байты - // .doc сбрасываются в кадре на этом же месте — детерминированно, до - // рендера (точные liveness-карты HotSpot строит только для - // скомпилированных кадров; отдельное присваивание null не нужно). - docxBytes = WordPdfValidator.isBinaryDoc(docxBytes) ? DocToDocx.convert(docxBytes) : docxBytes; + // проверяем (вход уже проверен по байтам оригинала). Переиспользование + // слота docxBytes: результат моста становится в тот же слот, и сырые + // байты оригинала сбрасываются в кадре на этом же месте — + // детерминированно, до рендера (точные liveness-карты HotSpot строит + // только для скомпилированных кадров; отдельное присваивание null не + // нужно). + docxBytes = WordPdfValidator.isBinaryDoc(docxBytes) ? DocToDocx.convert(docxBytes) + : WordPdfValidator.isSpreadsheet(docxBytes) ? XlsxToDocx.convert(docxBytes, opts) + : docxBytes; ByteArrayOutputStream bos = new ByteArrayOutputStream(Math.max(1 << 16, docxBytes.length)); try { convertToStream(docxBytes, title, opts, bos); 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 1436333..d94fb86 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfValidator.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfValidator.java @@ -11,17 +11,23 @@ import java.io.IOException; import java.io.InputStream; import java.nio.charset.StandardCharsets; import java.util.ArrayDeque; +import java.util.ArrayList; import java.util.Deque; +import java.util.HashMap; import java.util.HashSet; +import java.util.Iterator; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; import java.util.Set; import java.util.zip.ZipEntry; import java.util.zip.ZipInputStream; /** - * Валидатор ограничений на вход: .docx и бинарный .doc (Word 97–2003) — - * размер входа, корректность контейнера (.docx-манифест, защита от - * zip-бомбы; для .doc — CFB/Word-разбор {@code internal.doc}) и число - * страниц для обоих форматов. + * Валидатор ограничений на вход: .docx, бинарный .doc (Word 97–2003) и + * .xlsx (SpreadsheetML) — размер входа, корректность контейнера + * (.docx/.xlsx-манифест, защита от zip-бомбы; для .doc — CFB/Word-разбор + * {@code internal.doc}) и число страниц для всех форматов. * *

Вход валидатора — только {@code byte[]}: файловых проверок нет, * работа с файлами — забота вызывающего (приложения). @@ -44,9 +50,12 @@ import java.util.zip.ZipInputStream; * Последние два — защитные константные пороги ({@link #validate(byte[], ConvertOptions)}), * {@link ConvertOptions} их не переопределяет. * - *

Проверка контейнера: архив обязан декларировать документ - * wordprocessingml в {@code [Content_Types].xml} — иначе это не .docx - * (обычный zip, переименованный .xlsx/.pptx). + *

Проверка контейнера: архив обязан декларировать в + * {@code [Content_Types].xml} документ wordprocessingml (.docx) или + * spreadsheetml (.xlsx) — иначе это не OOXML-документ (обычный zip, + * переименованный .pptx). Классификация входа до любой работы с + * форматом: {@link #isBinaryDoc(byte[])} (CFB), {@link #isSpreadsheet(byte[])} + * (zip-манифест spreadsheetml). * *

Число страниц берётся из самого .docx как максимум трёх нижних * оценок: кэша Word в {@code docProps/app.xml} ({@code }), @@ -73,6 +82,32 @@ public final class WordPdfValidator { /** Тело документа. */ private static final String DOCUMENT_PART = "word/document.xml"; + /** Zip-подпись PK\x03\x04 — начало центрального заголовка локальной записи. */ + private static final int ZIP_SIG_LEN = 4; + + /** Workbook-часть .xlsx. */ + private static final String XLSX_WORKBOOK_PART = "xl/workbook.xml"; + + /** Rels workbook-части (rId worksheet → путь части). */ + private static final String XLSX_WORKBOOK_RELS = "xl/_rels/workbook.xml.rels"; + + /** Namespace атрибута {@code r:id} у {@code sheets/sheet} (ECMA-376 Part 2). */ + private static final String REL_NS = + "http://schemas.openxmlformats.org/officeDocument/2006/relationships"; + + /** Тип связи worksheet (ECMA-376 Part 2). */ + private static final String WORKSHEET_REL_TYPE = + "http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet"; + + /** Текущий и родительский сегменты относительных Targets rels. */ + private static final String SEG_CURRENT = "."; + private static final String SEG_PARENT = ".."; + + /** Класс контейнера OOXML по манифесту {@code [Content_Types].xml}. */ + private enum ContainerKind { + DOCX, XLSX + } + private WordPdfValidator() { } @@ -122,6 +157,45 @@ public final class WordPdfValidator { return true; } + /** + * Zip с манифестом spreadsheetml в {@code [Content_Types].xml} — .xlsx. + * Короткий скан до первой записи {@code [Content_Types].xml} (дубликаты + * враждебного zip: первая выигрывает); не-zip, ошибка разбора и манифест + * без spreadsheetml — {@code false} (отвергает не здесь: классификация, + * а не валидация). Конвертер вызывает только после {@link #validate}, + * где контейнер уже проверен. + */ + public static boolean isSpreadsheet(byte[] bytes) { + if (bytes == null || !isZipSignature(bytes)) { + return false; + } + try (ZipInputStream zip = new ZipInputStream(new ByteArrayInputStream(bytes))) { + ZipEntry entry; + while ((entry = zip.getNextEntry()) != null) { + if (!"[Content_Types].xml".equals(entry.getName())) { + continue; + } + byte[] ct = zip.readAllBytes(); + // Порядок тот же, что в checkOoxmlContainer: docx-маркер + // имеет приоритет (манифест с обоими — wordprocessingml). + if (containsAscii(ct, "wordprocessingml.document")) { + return false; + } + return containsAscii(ct, "spreadsheetml."); + } + return false; + } catch (IOException | RuntimeException e) { + return false; + } + } + + /** Zip-подпись {@code PK\x03\x04} (ECMA-376 Part 3 §10.1) — .docx и .xlsx. */ + private static boolean isZipSignature(byte[] bytes) { + return bytes.length >= ZIP_SIG_LEN + && bytes[0] == 'P' && bytes[1] == 'K' + && (bytes[2] & 0xFF) == 0x03 && (bytes[3] & 0xFF) == 0x04; + } + /** * Проверяет число страниц без загрузки документа в docx4j: .docx * читается как zip напрямую (StAX по {@code word/document.xml}, @@ -239,12 +313,235 @@ public final class WordPdfValidator { } /** - * Полная проверка входа: размер → классификация формата → (.docx: - * zip-подпись → контейнер (.docx + zip-бомба) → число страниц) / - * (.doc: число страниц по чистому бинарному документу). Порядок - * значим: размер — дешёвая, разбор zip без подписи бессмысленен. Лимиты - * берутся из {@link ConvertOptions} (переопределение на вызов, см. - * {@link ConvertOptions#maxMb()}, {@link ConvertOptions#maxPages()}). + * Число страниц .xlsx — нижняя оценка до конвертации мостом + * {@code internal.xlsx}: видимые листы ({@code sheets/sheet} без + * {@code state="hidden"/"veryHidden"}, связь на существующую часть) плюс + * суммарные ручные разрывы строк ({@code rowBreaks/brk}, ECMA-376 + * §18.3.1.74 — каждый разрыв добавляет страницу листу). Автопереносов + * оценка не знает — расхождение только в сторону недооценки длинных + * листов, ровно как у lightweight-пути .docx. + * + * @throws ValidationException при {@code null}, ошибке разбора zip/XML + * или превышении {@link WordPdfSettings#MAX_PAGES} + */ + public static void checkPageCountXlsx(byte[] xlsxBytes) throws ValidationException { + checkPageCountXlsx(xlsxBytes, WordPdfSettings.MAX_PAGES); + } + + /** + * То же, что {@link #checkPageCountXlsx(byte[])}, с явным лимитом + * страниц (переопределение на вызов, см. {@link ConvertOptions#maxPages()}). + * + * @throws ValidationException при {@code null}, ошибке разбора zip/XML + * или превышении {@code maxPages} + */ + public static void checkPageCountXlsx(byte[] xlsxBytes, int maxPages) throws ValidationException { + if (xlsxBytes == null) { + throw new ValidationException("Не указаны байты входного .xlsx"); + } + int pages; + try { + pages = estimateXlsxPages(xlsxBytes); + } catch (IOException | RuntimeException e) { + throw new ValidationException("Не удалось разобрать байты .xlsx", e); + } + if (pages > maxPages) { + throw new ValidationException("Документ длиннее " + maxPages + + " страниц: получено не менее " + pages); + } + } + + /** + * Двупроходная нижняя оценка страниц .xlsx (порядок записей в zip + * произволен — содержимое workbook ищет отдельным проходом): + * проход 1 — {@code xl/workbook.xml} (листы: r:id, state) и + * {@code xl/_rels/workbook.xml.rels} (rId → путь worksheet-части); + * проход 2 — {@code rowBreaks/brk} в целевых частях листов. Лист без + * r:id, с внешним/отсутствующим target не учитывается вовсе. + */ + private static int estimateXlsxPages(byte[] xlsxBytes) throws IOException { + Map ridToTarget = new LinkedHashMap<>(); + List visibleRids = new ArrayList<>(); + try (ZipInputStream zip = new ZipInputStream(new ByteArrayInputStream(xlsxBytes))) { + ZipEntry entry; + while ((entry = zip.getNextEntry()) != null) { + String n = entry.getName(); + if (XLSX_WORKBOOK_PART.equals(n)) { + readWorkbookSheets(noClose(zip), visibleRids); + } else if (XLSX_WORKBOOK_RELS.equals(n)) { + readWorksheetRels(noClose(zip), ridToTarget); + } + } + } + Set targets = new HashSet<>(); + for (String rid : visibleRids) { + String target = ridToTarget.get(rid); + if (target != null && !target.isEmpty()) { + targets.add(target); + } + } + Map breaksByPart = new HashMap<>(); + try (ZipInputStream zip = new ZipInputStream(new ByteArrayInputStream(xlsxBytes))) { + ZipEntry entry; + while ((entry = zip.getNextEntry()) != null) { + String n = entry.getName(); + if (targets.contains(n) && !breaksByPart.containsKey(n)) { + breaksByPart.put(n, countRowBreaks(noClose(zip))); + } + } + } + int pages = 0; + Set countedBreaks = new HashSet<>(); + for (String rid : visibleRids) { + String target = ridToTarget.get(rid); + if (target == null || target.isEmpty()) { + continue; + } + Integer breaks = breaksByPart.get(target); + if (breaks == null) { + // rel на отсутствующую часть — лист не считается + continue; + } + pages++; + if (countedBreaks.add(target)) { + pages += breaks; + } + } + return pages; + } + + /** + * Видимые листы {@code xl/workbook.xml} (§18.2.20): r:id видимых + * {@code sheets/sheet} (state скрыт — hidden/veryHidden; порядок + * сохраняется). Лист без r:id пропускается: часть не найти. + */ + private static void readWorkbookSheets(InputStream in, List visibleRids) + throws IOException { + try { + XMLStreamReader xr = newSecureReader().createXMLStreamReader(in); + while (xr.hasNext()) { + if (xr.next() == XMLStreamReader.START_ELEMENT + && "sheet".equals(xr.getLocalName())) { + String state = attrLocal(xr, "state"); + boolean visible = state == null || "visible".equals(state); + String rid = xr.getAttributeValue(REL_NS, "id"); + if (visible && rid != null) { + visibleRids.add(rid); + } + } + } + } catch (XMLStreamException e) { + throw new IOException("Некорректный XML в xl/workbook.xml", e); + } finally { + in.close(); + } + } + + /** + * rId → путь worksheet-части из {@code xl/_rels/workbook.xml.rels} + * (дубликаты rId: первый выигрывает; {@code TargetMode="External"} — + * не worksheet-часть, пропускается). + */ + private static void readWorksheetRels(InputStream in, Map ridToTarget) + throws IOException { + try { + XMLStreamReader xr = newSecureReader().createXMLStreamReader(in); + while (xr.hasNext()) { + if (xr.next() == XMLStreamReader.START_ELEMENT + && "Relationship".equals(xr.getLocalName())) { + if (!WORKSHEET_REL_TYPE.equals(attrLocal(xr, "Type")) + || "External".equals(attrLocal(xr, "TargetMode"))) { + continue; + } + String id = attrLocal(xr, "Id"); + String target = attrLocal(xr, "Target"); + if (id != null && target != null && !ridToTarget.containsKey(id)) { + ridToTarget.put(id, resolveWorkbookTarget(target)); + } + } + } + } catch (XMLStreamException e) { + throw new IOException("Некорректный XML в xl/_rels/workbook.xml.rels", e); + } finally { + in.close(); + } + } + + /** + * Target rels workbook-части в путь zip-записи: абсолютный ("/xl/…") — + * от корня пакета, относительный — от {@code xl/} (rel лежит в + * {@code xl/_rels/}); «..» поднимают сегмент. + */ + private static String resolveWorkbookTarget(String target) { + String t = target.replace('\\', '/'); + int query = t.indexOf('?'); + if (query >= 0) { + t = t.substring(0, query); + } + if (t.startsWith("/")) { + return t.substring(1); + } + Deque segs = new ArrayDeque<>(); + segs.push("xl"); + for (String seg : t.split("/")) { + if (seg.isEmpty() || SEG_CURRENT.equals(seg)) { + continue; + } + if (SEG_PARENT.equals(seg)) { + if (!segs.isEmpty()) { + segs.pop(); + } + } else { + segs.push(seg); + } + } + if (segs.isEmpty()) { + return ""; + } + StringBuilder path = new StringBuilder(); + for (Iterator it = segs.descendingIterator(); it.hasNext(); ) { + if (path.length() > 0) { + path.append('/'); + } + path.append(it.next()); + } + return path.toString(); + } + + /** Число {@code brk} непосредственно под {@code rowBreaks} (§18.3.1.74). */ + private static int countRowBreaks(InputStream in) throws IOException { + int count = 0; + try { + XMLStreamReader xr = newSecureReader().createXMLStreamReader(in); + Deque path = new ArrayDeque<>(); + while (xr.hasNext()) { + int ev = xr.next(); + if (ev == XMLStreamReader.START_ELEMENT) { + String parent = path.peek(); + if ("brk".equals(xr.getLocalName()) && "rowBreaks".equals(parent)) { + count++; + } + path.push(xr.getLocalName()); + } else if (ev == XMLStreamReader.END_ELEMENT && !path.isEmpty()) { + path.pop(); + } + } + } catch (XMLStreamException e) { + throw new IOException("Некорректный XML в части worksheet", e); + } finally { + in.close(); + } + return count; + } + + /** + * Полная проверка входа: размер → классификация формата → (.docx/.xlsx: + * zip-подпись → контейнер (.docx/.xlsx + zip-бомба) → число страниц + * docx- или xlsx-путём) / (.doc: число страниц по чистому бинарному + * документу). Порядок значим: размер — дешёвая, разбор zip без подписи + * бессмысленен. Лимиты берутся из {@link ConvertOptions} + * (переопределение на вызов, см. {@link ConvertOptions#maxMb()}, + * {@link ConvertOptions#maxPages()}). * *

Проверка zip-подписи отдельным шагом обязательна: * {@code ZipInputStream.getNextEntry()} на не-zip-потоке возвращает @@ -254,17 +551,18 @@ public final class WordPdfValidator { * {@code ConvertControllerTest#corruptNotAZip_rejected}).

* *

Проверка контейнера: в {@code [Content_Types].xml} обязана быть - * декларация документа wordprocessingml (архив без неё — не .docx); - * zip-бомба отсекается потоковым счётчиком распакованных байт + * декларация документа wordprocessingml (.docx) или spreadsheetml + * (.xlsx) — архив без обеих не OOXML-документ; zip-бомба отсекается + * потоковым счётчиком распакованных байт * ({@link WordPdfSettings#MAX_DECOMPRESSED_MB}) и числом записей * ({@link WordPdfSettings#MAX_ZIP_ENTRIES}) — до разбора содержимого * в {@link #checkPageCount(byte[], int)}. Оба лимита — * защитные пороги, {@link ConvertOptions} их не переопределяет. * Регрессии — {@code WordPdfValidatorTest#validate_plainZipRejected}, - * {@code #validate_xlsxRenamedRejected}, {@code #validate_zipBombRejected}, + * {@code #validate_pptxLikeRejected}, {@code #validate_zipBombRejected}, * {@code #validate_tooManyEntriesRejected}.

* @throws ValidationException при {@code null}, превышении {@code options.maxMb()}, - * отсутствии zip-подписи, не-.docx-контейнере, признаках zip-бомбы, + * отсутствии zip-подписи, не-OOXML-контейнере, признаках zip-бомбы, * ошибке разбора zip или превышении {@code options.maxPages()} */ public static void validate(byte[] docxBytes, ConvertOptions options) throws ValidationException { @@ -275,22 +573,28 @@ public final class WordPdfValidator { checkPageCountDoc(docxBytes, options.maxPages()); return; } - if (docxBytes.length < 4 || docxBytes[0] != 'P' || docxBytes[1] != 'K' - || (docxBytes[2] & 0xFF) != 0x03 || (docxBytes[3] & 0xFF) != 0x04) { - throw new ValidationException("Содержимое не похоже на .docx или .doc (не zip-архив)"); + if (!isZipSignature(docxBytes)) { + throw new ValidationException( + "Содержимое не похоже на .docx, .doc или .xlsx (не zip-архив)"); + } + ContainerKind kind = checkOoxmlContainer(docxBytes); + if (kind == ContainerKind.XLSX) { + checkPageCountXlsx(docxBytes, options.maxPages()); + return; } - checkDocxContainer(docxBytes); checkPageCount(docxBytes, options.maxPages()); } /** * Один потоковый проход по zip: суммарный распакованный размер и число * записей (защита от zip-бомбы — отсечение ДО чтения содержимого - * в {@link #checkPageCount(byte[], int)}) и наличие в - * {@code [Content_Types].xml} декларации документа wordprocessingml - * (архив без неё — не .docx: обычный zip, переименованный .xlsx/.pptx). + * в {@link #checkPageCount(byte[], int)}) и классификация контейнера по + * {@code [Content_Types].xml}: декларация документа wordprocessingml → + * {@link ContainerKind#DOCX}, spreadsheetml → {@link ContainerKind#XLSX}, + * ни того ни другого — архив не OOXML-документ (обычный zip, + * переименованный .pptx). */ - private static void checkDocxContainer(byte[] docxBytes) throws ValidationException { + private static ContainerKind checkOoxmlContainer(byte[] docxBytes) throws ValidationException { long maxTotal = WordPdfSettings.MAX_DECOMPRESSED_MB * 1024 * 1024; long total = 0; int entries = 0; @@ -328,16 +632,24 @@ public final class WordPdfValidator { } catch (IOException | RuntimeException e) { throw new ValidationException("Не удалось разобрать байты .docx", e); } - // Маркер — подстрока content-type части документа - // (application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml): - // URI пространства имён wml в [Content_Types].xml не появляется ни у - // одного генератора (Word/POI/docx4j пишут только content-type), а в - // манифестах .xlsx/.pptx стоит spreadsheetml/presentationml — не матчится. - String marker = "wordprocessingml.document"; - if (!containsAscii(ctBuf.toByteArray(), marker)) { - throw new ValidationException("Архив не является .docx: в [Content_Types].xml нет " - + "декларации документа wordprocessingml"); + // Маркеры — подстроки content-type частей документа + // (application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml / + // …spreadsheetml.worksheet+xml): URI пространств имён wml/sml в + // [Content_Types].xml не появляются ни у одного генератора (Word/POI/ + // docx4j пишут только content-type). Spreadsheetml — union-префикс + // (worksheet/sheet/sharedStrings/styles): Override worksheet есть и у + // генераторов, пишущих workbook только как sheet-override; docx- + // манифесту префикс не матчится никогда. docx проверяется первым — + // манифест с обоими маркерами (экзотика) трактуется как .docx. + byte[] ct = ctBuf.toByteArray(); + if (containsAscii(ct, "wordprocessingml.document")) { + return ContainerKind.DOCX; } + if (containsAscii(ct, "spreadsheetml.")) { + return ContainerKind.XLSX; + } + throw new ValidationException("Архив не является .docx или .xlsx: в [Content_Types].xml " + + "нет декларации документа wordprocessingml или spreadsheetml"); } /** Поиск байтов ASCII-строки в массиве (манифест ограничен 8 МБ — наивного поиска достаточно). */ diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/DocxWriter.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/DocxPackageWriter.java similarity index 88% rename from wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/DocxWriter.java rename to wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/DocxPackageWriter.java index afc0b5e..52befa7 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/DocxWriter.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/DocxPackageWriter.java @@ -1,4 +1,4 @@ -package ru.pjandro.wordpdf.internal.doc; +package ru.pjandro.wordpdf.internal; import java.io.ByteArrayOutputStream; import java.io.IOException; @@ -22,19 +22,26 @@ import java.util.zip.ZipOutputStream; * XML-части идут в [Content_Types].xml как Override, медиа — как Default по * расширению (дедупликация по расширению). Байты уходят в штатный пайплайн * docx4j (шаги 1–7 {@code WordPdfConverter}).

+ * + *

Общий сборщик мостов: {@code internal.doc} (бинарный .doc) и + * {@code internal.xlsx} (SpreadsheetML) — отсюда public вне пакета.

*/ -final class DocxWriter { +public final class DocxPackageWriter { /** Часть пакета кроме document.xml: zip-запись, content-type, тип связи, байты. */ - record Part(String entry, String contentType, String relType, byte[] content) { + public record Part(String entry, String contentType, String relType, byte[] content) { } - /** Пространства имён корня document.xml/hdr/ftr: w + r (rels) + DrawingML. */ - static final String NAMESPACES = "xmlns:w=\"http://schemas.openxmlformats.org/wordprocessingml/2006/main\"" + /** + * Пространства имён корня document.xml/hdr/ftr: w + r (rels) + DrawingML + * + c (chart — нужно мосту .xlsx для {@code a:graphicData}/{@code c:chart}). + */ + public static final String NAMESPACES = "xmlns:w=\"http://schemas.openxmlformats.org/wordprocessingml/2006/main\"" + " xmlns:r=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships\"" + " xmlns:wp=\"http://schemas.openxmlformats.org/drawingml/2006/wordprocessingDrawing\"" + " xmlns:a=\"http://schemas.openxmlformats.org/drawingml/2006/main\"" - + " xmlns:pic=\"http://schemas.openxmlformats.org/drawingml/2006/picture\""; + + " xmlns:pic=\"http://schemas.openxmlformats.org/drawingml/2006/picture\"" + + " xmlns:c=\"http://schemas.openxmlformats.org/drawingml/2006/chart\""; private static final String XML_DECL = ""; @@ -48,7 +55,7 @@ final class DocxWriter { + "Type=\"http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument\" " + "Target=\"word/document.xml\"/>"; - private DocxWriter() { + private DocxPackageWriter() { } /** @@ -59,7 +66,7 @@ final class DocxWriter { * уже во время сборки тела, смещение {@code rIdN+1…} было бы * нестабильным). */ - static byte[] write(String bodyXml, List parts, List hyperlinkTargets) { + public static byte[] write(String bodyXml, List parts, List hyperlinkTargets) { ByteArrayOutputStream bos = new ByteArrayOutputStream(1 << 14); try (ZipOutputStream zip = new ZipOutputStream(bos, StandardCharsets.UTF_8)) { put(zip, "[Content_Types].xml", contentTypes(parts)); @@ -76,7 +83,7 @@ final class DocxWriter { zip.closeEntry(); } } catch (IOException e) { - throw new IllegalStateException("Не удалось собрать .docx из .doc", e); + throw new IllegalStateException("Не удалось собрать .docx", e); } return bos.toByteArray(); } @@ -92,7 +99,7 @@ final class DocxWriter { } /** XML-часть колонтитука: {@code }/{@code } с полным набором имён. */ - static byte[] storyPart(String rootElement, String paragraphsXml) { + public static byte[] storyPart(String rootElement, String paragraphsXml) { return (XML_DECL + "<" + rootElement + " " + NAMESPACES + ">" + paragraphsXml + "").getBytes(StandardCharsets.UTF_8); } @@ -148,7 +155,7 @@ final class DocxWriter { return xml.append("").toString(); } - /** Атрибутный экранировщик Target (дубликат образец {@code Lists.escapeAttr}). */ + /** Атрибутный экранировщик Target (дубликат образец {@code internal.doc.Lists.escapeAttr}). */ private static String escapeAttr(String s) { return s.replace("&", "&").replace("<", "<").replace("\"", """); } diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/DocToDocx.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/DocToDocx.java index 4fcd45d..1952197 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/DocToDocx.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/doc/DocToDocx.java @@ -1,6 +1,7 @@ package ru.pjandro.wordpdf.internal.doc; import ru.pjandro.wordpdf.ValidationException; +import ru.pjandro.wordpdf.internal.DocxPackageWriter; import java.nio.charset.StandardCharsets; import java.util.ArrayDeque; @@ -132,11 +133,11 @@ public final class DocToDocx { file.wordDocument()); Headers headers = Headers.read(file.table(), fib.fcPlcfHdd(), fib.lcbPlcfHdd(), fib.ccpText() + fib.ccpFtn()); - List parts = new ArrayList<>(); + List parts = new ArrayList<>(); if (lists.hasNumbering()) { // relId этой части из XML не нужен — docx4j находит numbering по типу // связи; id колонтитулов считаются после своего add, не сдвигаются - parts.add(new DocxWriter.Part("word/numbering.xml", NUMBERING_CONTENT_TYPE, + parts.add(new DocxPackageWriter.Part("word/numbering.xml", NUMBERING_CONTENT_TYPE, NUMBERING_REL_TYPE, lists.numberingXml().getBytes(StandardCharsets.UTF_8))); } @@ -167,9 +168,9 @@ public final class DocToDocx { Headers.Story hdr = headers.oddHeader(i); if (!hdr.empty()) { hdrNo++; - parts.add(new DocxWriter.Part("word/header" + hdrNo + ".xml", + parts.add(new DocxPackageWriter.Part("word/header" + hdrNo + ".xml", HEADER_CONTENT_TYPE, HEADER_REL_TYPE, - DocxWriter.storyPart("w:hdr", hdr.hasContent() + DocxPackageWriter.storyPart("w:hdr", hdr.hasContent() ? body.buildRange(hdr.cpStart(), hdr.contentEnd(), true) : ""))); hdrRel[i] = "rId" + parts.size(); @@ -177,9 +178,9 @@ public final class DocToDocx { Headers.Story ftr = headers.oddFooter(i); if (!ftr.empty()) { ftrNo++; - parts.add(new DocxWriter.Part("word/footer" + ftrNo + ".xml", + parts.add(new DocxPackageWriter.Part("word/footer" + ftrNo + ".xml", FOOTER_CONTENT_TYPE, FOOTER_REL_TYPE, - DocxWriter.storyPart("w:ftr", ftr.hasContent() + DocxPackageWriter.storyPart("w:ftr", ftr.hasContent() ? body.buildRange(ftr.cpStart(), ftr.contentEnd(), true) : ""))); ftrRel[i] = "rId" + parts.size(); @@ -188,9 +189,9 @@ public final class DocToDocx { Headers.Story firstHdr = headers.firstHeader(i); if (!firstHdr.empty()) { hdrNo++; - parts.add(new DocxWriter.Part("word/header" + hdrNo + ".xml", + parts.add(new DocxPackageWriter.Part("word/header" + hdrNo + ".xml", HEADER_CONTENT_TYPE, HEADER_REL_TYPE, - DocxWriter.storyPart("w:hdr", firstHdr.hasContent() + DocxPackageWriter.storyPart("w:hdr", firstHdr.hasContent() ? body.buildRange(firstHdr.cpStart(), firstHdr.contentEnd(), true) : ""))); @@ -199,9 +200,9 @@ public final class DocToDocx { Headers.Story firstFtr = headers.firstFooter(i); if (!firstFtr.empty()) { ftrNo++; - parts.add(new DocxWriter.Part("word/footer" + ftrNo + ".xml", + parts.add(new DocxPackageWriter.Part("word/footer" + ftrNo + ".xml", FOOTER_CONTENT_TYPE, FOOTER_REL_TYPE, - DocxWriter.storyPart("w:ftr", firstFtr.hasContent() + DocxPackageWriter.storyPart("w:ftr", firstFtr.hasContent() ? body.buildRange(firstFtr.cpStart(), firstFtr.contentEnd(), true) : ""))); @@ -211,7 +212,7 @@ public final class DocToDocx { } // hyperlinks наполняются внутри build (body-pass); rels пишутся после String bodyXml = body.build(secs, hdrRel, ftrRel, firstHdrRel, firstFtrRel); - return DocxWriter.write(bodyXml, parts, body.hyperlinks()); + return DocxPackageWriter.write(bodyXml, parts, body.hyperlinks()); } /** @@ -257,7 +258,7 @@ public final class DocToDocx { /** Data-поток (.doc) для BLIP по sprmCPicLocation. */ private final byte[] dataStream; /** Части пакета (колонтитуки + media); id связи = rId{позиция+1}. */ - private final List parts; + private final List parts; private final Deque fieldStack = new ArrayDeque<>(); /** Флаг «поле открыло w:hyperlink», параллельно {@link #fieldStack}. */ private final Deque linkStack = new ArrayDeque<>(); @@ -279,7 +280,7 @@ public final class DocToDocx { DocxBody(PieceTable pieces, ChpxIndex chpx, PapxIndex papx, FontTable fonts, Styles styles, Lists lists, int ccpText, byte[] dataStream, - List parts) { + List parts) { this.pieces = pieces; this.chpx = chpx; this.papx = papx; @@ -864,13 +865,13 @@ public final class DocToDocx { return; } int imageNo = 1; - for (DocxWriter.Part p : parts) { + for (DocxPackageWriter.Part p : parts) { if (p.entry().startsWith("word/media/")) { imageNo++; } } String entry = "word/media/image" + imageNo + "." + pic.extension(); - parts.add(new DocxWriter.Part(entry, pic.contentType(), IMAGE_REL_TYPE, pic.data())); + parts.add(new DocxPackageWriter.Part(entry, pic.contentType(), IMAGE_REL_TYPE, pic.data())); String relId = "rId" + parts.size(); runs.append(markupOpen()).append("").append(rPr).append("") .append("") diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/ColorResolver.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/ColorResolver.java new file mode 100644 index 0000000..74b4f3f --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/ColorResolver.java @@ -0,0 +1,176 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +/** + * Превращение {@link ColorSpec} в {@code RRGGBB} для Word: theme → + * {@link ThemeModel}, indexed → легаси-палитра Excel 97 (0..63), tint/shade — + * коррекция светлоты в HSL (как Excel, MS-OI29500 §2.3.1.6.16: luminance + * модифицируется, hue/saturation сохраняются). Ни одного источника — + * {@code null} (Word рисует auto). + */ +final class ColorResolver { + + /** Легаси-палитра indexed 0..63 (Excel 97; ECMA-376 legacyColorIndex). */ + private static final String[] INDEXED = { + "000000", "FFFFFF", "FF0000", "00FF00", "0000FF", "FFFF00", "FF00FF", "00FFFF", + "000000", "FFFFFF", "FF0000", "00FF00", "0000FF", "FFFF00", "FF00FF", "00FFFF", + "800000", "008000", "000080", "808000", "800080", "008080", "C0C0C0", "808080", + "9999FF", "993366", "FFFFCC", "CCFFFF", "660066", "FF8080", "0066CC", "CCCCFF", + "000080", "FF00FF", "FFFF00", "00FFFF", "800080", "800000", "008080", "0000FF", + "00CCFF", "CCFFFF", "CCFFCC", "FFFF99", "99CCFF", "FF99CC", "CC99FF", "3366FF", + "33CCCC", "99CC00", "FFCC00", "FF9900", "FF6600", "666699", "969696", "999999", + "C0C0C0", "C0C0C0", "C0C0C0", "C0C0C0", "C0C0C0", "C0C0C0", + }; + + /** Легаси-палитра заканчивается 61; 62/63 — системные auto; 64+ — цвета styles. */ + private static final int CUSTOM_PALETTE_BASE = 64; + /** Длина RGB-hex. */ + private static final int RGB_HEX_LEN = 6; + /** Длина ARGB-hex. */ + private static final int ARGB_HEX_LEN = 8; + + private final ThemeModel theme; + /** styles colors/indexedColors: легаси-индексы 64+n (§18.18.26). */ + private final java.util.List styleIndexed; + + ColorResolver(ThemeModel theme, java.util.List styleIndexed) { + this.theme = theme; + this.styleIndexed = styleIndexed; + } + + /** RRGGBB без «#» или null (auto / неразрешимый индекс / битый hex). */ + String resolve(ColorSpec spec) { + if (spec == null || spec.isEmpty()) { + return null; + } + Integer rgb = baseRgb(spec); + if (rgb == null) { + return null; + } + return String.format(java.util.Locale.ROOT, "%06X", applyModulation(rgb, spec)); + } + + /** Базовый RGB до tint/shade; null — не разрешился. */ + private Integer baseRgb(ColorSpec spec) { + if (spec.rgb() != null) { + return parseHex(spec.rgb()); + } + if (spec.theme() != null) { + String element = ThemeModel.elementForIndex(spec.theme()); + String hex = element == null ? null : theme.color(element); + return hex == null ? null : parseHex(hex); + } + if (spec.indexed() != null && spec.indexed() >= 0) { + int idx = spec.indexed(); + if (idx < INDEXED.length) { + return parseHex(INDEXED[idx]); + } + if (idx < CUSTOM_PALETTE_BASE) { + return null; // 62/63 — системные auto, в палитре их нет + } + String hex = idx - CUSTOM_PALETTE_BASE < styleIndexed.size() + ? styleIndexed.get(idx - CUSTOM_PALETTE_BASE) : null; + return hex == null ? null : parseHex(hex); + } + return null; + } + + /** ARGB (8 hex) или RGB (6 hex) → int RGB; битый — null. */ + private static Integer parseHex(String hex) { + String h = hex.length() == ARGB_HEX_LEN ? hex.substring(2) : hex; + if (h.length() != RGB_HEX_LEN) { + return null; + } + try { + return Integer.valueOf(h, 16); + } catch (NumberFormatException e) { + return null; + } + } + + /** + * Tint/shade по каналам в HSL: tint t>0 → L' = L·(1−t)+t (осветление к + * белому), shade t<0 → L' = L·(1+t) (затемнение к чёрному). Оба атрибута + * применяются последовательно (Excel делает так же). + */ + private static int applyModulation(int rgb, ColorSpec spec) { + int r = (rgb >> 16) & 0xFF; + int g = (rgb >> 8) & 0xFF; + int b = rgb & 0xFF; + if (spec.tint() != null) { + double[] hsl = toHsl(r, g, b); + hsl[2] = modulateLuminance(hsl[2], spec.tint()); + int[] back = toRgb(hsl); + r = back[0]; + g = back[1]; + b = back[2]; + } + if (spec.shade() != null) { + double[] hsl = toHsl(r, g, b); + hsl[2] = modulateLuminance(hsl[2], spec.shade()); + int[] back = toRgb(hsl); + r = back[0]; + g = back[1]; + b = back[2]; + } + return (r << 16) | (g << 8) | b; + } + + private static double modulateLuminance(double l, double t) { + double nl = t > 0 ? l * (1 - t) + t : l * (1 + t); + return Math.min(1, Math.max(0, nl)); + } + + private static double[] toHsl(int r, int g, int b) { + double rf = r / 255.0; + double gf = g / 255.0; + double bf = b / 255.0; + double max = Math.max(rf, Math.max(gf, bf)); + double min = Math.min(rf, Math.min(gf, bf)); + double l = (max + min) / 2; + double d = max - min; + double h = 0; + double s = 0; + if (d > 0) { + s = l > 0.5 ? d / (2 - max - min) : d / (max + min); + if (max == rf) { + h = ((gf - bf) / d + (gf < bf ? 6 : 0)) / 6; + } else if (max == gf) { + h = ((bf - rf) / d + 2) / 6; + } else { + h = ((rf - gf) / d + 4) / 6; + } + } + return new double[] {h, s, l}; + } + + private static int[] toRgb(double[] hsl) { + double h = hsl[0]; + double s = hsl[1]; + double l = hsl[2]; + if (s <= 0) { + int v = (int) Math.round(l * 255); + return new int[] {v, v, v}; + } + double q = l < 0.5 ? l * (1 + s) : l + s - l * s; + double p = 2 * l - q; + return new int[] { + (int) Math.round(hueToRgb(p, q, h + 1.0 / 3) * 255), + (int) Math.round(hueToRgb(p, q, h) * 255), + (int) Math.round(hueToRgb(p, q, h - 1.0 / 3) * 255), + }; + } + + private static double hueToRgb(double p, double q, double t) { + double tt = t - Math.floor(t); // нормализация в [0,1) + if (tt < 1.0 / 6) { + return p + (q - p) * 6 * tt; + } + if (tt < 1.0 / 2) { + return q; + } + if (tt < 2.0 / 3) { + return p + (q - p) * (2.0 / 3 - tt) * 6; + } + return p; + } +} diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/ColorSpec.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/ColorSpec.java new file mode 100644 index 0000000..0d8dcae --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/ColorSpec.java @@ -0,0 +1,72 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +/** + * Цвет элемента {@code color} (ECMA-376 §18.8: CT_Color — атрибуты rgb, + * indexed, theme, auto, tint, shade). Разбор атрибутов отделён от + * вычисления: {@link ColorResolver} превращает спецификацию в + * {@code #RRGGBB} (theme → {@link ThemeModel}, indexed → палитра Excel 97, + * tint/shade → коррекция светлоты). Ни один атрибут не задан — auto + * ({@link #resolve} вернёт {@code null}, Word рисует «auto»). + * + * @param rgb ARGB-хеks (alpha отбрасывается при разборе) или null + * @param indexed значение {@code @indexed} или null + * @param theme значение {@code @theme} или null + * @param tint {@code @tint} ([-1..1]) или null + * @param shade {@code @shade} ([-1..1]) или null + */ +record ColorSpec(String rgb, Integer indexed, Integer theme, Double tint, Double shade) { + + /** auto / не задан. */ + static final ColorSpec AUTO = new ColorSpec(null, null, null, null, null); + + /** Только rgb (без tint/shade) — синтетика генератора/тестов. */ + static ColorSpec rgb(String hex) { + return new ColorSpec(hex, null, null, null, null); + } + + /** + * Разбор атрибутов элемента {@code color} (CT_Color) с текущей позиции + * StAX-читателя: rgb/indexed/theme/tint/shade. Числовые значения, + * не парсящиеся как double, — null (битый атрибут не роняет документ). + */ + static ColorSpec fromColorElement(javax.xml.stream.XMLStreamReader xr) { + String rgb = XlsxPackage.attr(xr, "rgb"); + String indexed = XlsxPackage.attr(xr, "indexed"); + String theme = XlsxPackage.attr(xr, "theme"); + Double tint = parseDouble(XlsxPackage.attr(xr, "tint")); + Double shade = parseDouble(XlsxPackage.attr(xr, "shade")); + Integer idx = parseInt(indexed); + Integer th = parseInt(theme); + if (rgb == null && idx == null && th == null && tint == null && shade == null) { + return AUTO; + } + return new ColorSpec(rgb, idx, th, tint, shade); + } + + static Integer parseInt(String s) { + if (s == null) { + return null; + } + try { + return Integer.valueOf(s); + } catch (NumberFormatException e) { + return null; + } + } + + static Double parseDouble(String s) { + if (s == null) { + return null; + } + try { + return Double.valueOf(s); + } catch (NumberFormatException e) { + return null; + } + } + + /** Есть ли хоть один источник цвета. */ + boolean isEmpty() { + return rgb == null && indexed == null && theme == null; + } +} diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/DrawingBridge.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/DrawingBridge.java new file mode 100644 index 0000000..581e89d --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/DrawingBridge.java @@ -0,0 +1,451 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import java.io.ByteArrayInputStream; +import java.util.ArrayList; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Locale; +import java.util.Map; + +import javax.xml.stream.XMLStreamConstants; +import javax.xml.stream.XMLStreamReader; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import ru.pjandro.wordpdf.internal.DocxPackageWriter; + +/** + * Перенос рисунков {@code xl/drawings/drawingN.xml} (dml-схема {@code xdr:}/ + * {@code a:}) в ячейки выходного документа. + * + *

Якоря {@code twoCellAnchor}/{@code oneCellAnchor}/{@code absoluteAnchor}: + * EMU-позиция ячейки — кумулятив по {@link Metrics} (hidden-колонки дают 0); + * extent — {@code to−from} или {@code ext}. Эмит — inline-картинка + * ({@code wp:inline/wp:extent}) раном в from-ячейку; картинка переливается + * через ячейку — принятая деградация. {@code wp:extent} больше + * {@link #MAX_EXTENT_EMU} (та же граница, что {@code DrawingPreRenderer}) — + * пропуск + warn.

+ * + *

{@code xdr:pic} → media-часть as-is; {@code c:chart} — копия chart-части + * в {@code word/charts/} с сохранением {@code a:graphicData} — штатный шаг + * 3.5 пайплайна ({@code DrawingPreRenderer}) дорисует PNG и отреагирует на + * {@code errorOnCharts}. SmartArt/фигуры — пропуск + warn; OLE не эмитится + * никогда (флаг {@code errorOnOle} проверяет {@code XlsxToDocx} по + * structural-признакам листа). Связи перенесённых chart-частей + * (colors/styles/external-data) не копируются — висячие r:id в chart-XML + * безвредны.

+ */ +final class DrawingBridge { + + /** Потолок inline-простирашения, как {@code DrawingPreRenderer.MAX_EXTENT_EMU}. */ + static final long MAX_EXTENT_EMU = 22_000_000L; + + /** Рисунок, размещённый в from-ячейку (1-based строка, 0-based колонка). */ + record Placement(int row1, int col, String runXml) { + } + + private static final Logger LOG = LoggerFactory.getLogger(DrawingBridge.class); + + private static final String XDR_NS = + "http://schemas.openxmlformats.org/drawingml/2006/spreadsheetDrawing"; + private static final String URI_PICTURE = + "http://schemas.openxmlformats.org/drawingml/2006/picture"; + private static final String URI_CHART = + "http://schemas.openxmlformats.org/drawingml/2006/chart"; + private static final String IMAGE_REL_TYPE = + "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image"; + private static final String CHART_REL_TYPE = + "http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart"; + private static final String THEME_REL_TYPE = + "http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme"; + private static final String CHART_CONTENT_TYPE = + "application/vnd.openxmlformats-officedocument.drawingml.chart+xml"; + private static final String THEME_CONTENT_TYPE = + "application/vnd.openxmlformats-officedocument.theme+xml"; + private static final long EMU_PER_PT = 12_700L; + + /** Типы якорей. */ + private static final int MODE_TWO_CELL = 1; + private static final int MODE_ONE_CELL = 2; + private static final int MODE_ABSOLUTE = 3; + /** Элементы-границы якоря. */ + private static final String EL_FROM = "from"; + private static final String EL_TO = "to"; + /** Разновидности содержимого якоря. */ + private static final String KIND_PIC = "pic"; + private static final String KIND_SKIP = "skip"; + + private final List parts; + private final WarnOnce warn; + private int drawingNo; + + DrawingBridge(List parts, WarnOnce warn) { + this.parts = parts; + this.warn = warn; + } + + /** Theme-часть книги (палитра для chart-рендерера); нет части — ничего. */ + static void emitTheme(XlsxPackage pkg, List parts) { + byte[] theme = pkg.entry("xl/theme/theme1.xml"); + if (theme != null) { + parts.add(new DocxPackageWriter.Part("word/theme/theme1.xml", + THEME_CONTENT_TYPE, THEME_REL_TYPE, theme)); + } + } + + /** Рисунки листа в исходных координатах якорей. */ + List read(XlsxPackage pkg, SheetModel sheet, Metrics metrics) { + String drawingPath = sheet.drawingPath(); + byte[] xml = drawingPath == null ? null : pkg.entry(drawingPath); + if (xml == null) { + return List.of(); + } + List out = new ArrayList<>(); + try { + XMLStreamReader xr = XlsxPackage.newSecureReader() + .createXMLStreamReader(new ByteArrayInputStream(xml)); + parse(xr, pkg, sheet, metrics, drawingPath, out); + } catch (Exception e) { + warn.warn(LOG, "drawing листа не разобран ({}), рисунки пропущены", + e.toString()); + } + return out; + } + + /** + * Кладёт рисунки в ячейки: якорь на hidden-строке/колонке клампится к + * первой видимой далее (план). Ключ — {@code (row1 << 32) | col}. + */ + static Map> byCell(List drawings, SheetModel sheet) { + Map> byCell = new LinkedHashMap<>(); + for (Placement p : drawings) { + int row = p.row1(); + SheetModel.RowData rd = sheet.rows().get(row); + if (rd != null && rd.hidden()) { + Integer next = firstVisibleRowAfter(sheet, row); + if (next != null) { + row = next; + } + } + int col = p.col(); + for (SheetModel.ColDef d = sheet.col(col); d != null && d.hidden(); + d = sheet.col(col)) { + col++; + } + byCell.computeIfAbsent((long) row << 32 | col & 0xFFFF_FFFFL, + k -> new ArrayList<>()).add(p.runXml()); + } + return byCell; + } + + private static Integer firstVisibleRowAfter(SheetModel sheet, int fromRow) { + for (var e : sheet.rows().tailMap(fromRow + 1).entrySet()) { + if (!e.getValue().hidden()) { + return e.getKey(); + } + } + return null; + } + + private void parse(XMLStreamReader xr, XlsxPackage pkg, SheetModel sheet, Metrics metrics, + String drawingPath, List out) throws Exception { + int mode = 0; // 1 twoCell, 2 oneCell, 3 absolute + int fromCol = 0; + int fromRow = 0; + long fromColOff = 0; + long fromRowOff = 0; + int toCol = 0; + int toRow = 0; + long toColOff = 0; + long toRowOff = 0; + long extCx = 0; + long extCy = 0; + String kind = null; // pic | chart | skip + String embed = null; + String chartRid = null; + String graphicUri = null; + boolean inFrom = false; + boolean inTo = false; + while (xr.hasNext()) { + int ev = xr.next(); + if (ev == XMLStreamConstants.START_ELEMENT) { + String local = xr.getLocalName(); + if (mode == 0) { + switch (local) { + case "twoCellAnchor" -> mode = MODE_TWO_CELL; + case "oneCellAnchor" -> mode = MODE_ONE_CELL; + case "absoluteAnchor" -> mode = MODE_ABSOLUTE; + default -> { + } + } + if (mode != 0) { + fromCol = 0; + fromRow = 0; + fromColOff = 0; + fromRowOff = 0; + toCol = 0; + toRow = 0; + toColOff = 0; + toRowOff = 0; + extCx = 0; + extCy = 0; + kind = null; + embed = null; + chartRid = null; + graphicUri = null; + continue; + } + } + switch (local) { + case EL_FROM -> inFrom = true; + case EL_TO -> inTo = true; + case "col" -> { + if (inFrom) { + fromCol = (int) parseLong(xr.getElementText()); + } else if (inTo) { + toCol = (int) parseLong(xr.getElementText()); + } + } + case "row" -> { + if (inFrom) { + fromRow = (int) parseLong(xr.getElementText()); + } else if (inTo) { + toRow = (int) parseLong(xr.getElementText()); + } + } + case "colOff" -> { + if (inFrom) { + fromColOff = parseLong(xr.getElementText()); + } else if (inTo) { + toColOff = parseLong(xr.getElementText()); + } + } + case "rowOff" -> { + if (inFrom) { + fromRowOff = parseLong(xr.getElementText()); + } else if (inTo) { + toRowOff = parseLong(xr.getElementText()); + } + } + case "ext" -> { + // xdr:ext якоря, не a:ext из pic/spPr (он там дубликат) + if (mode != 0 && XDR_NS.equals(xr.getNamespaceURI())) { + extCx = parseLong(XlsxPackage.attr(xr, "cx")); + extCy = parseLong(XlsxPackage.attr(xr, "cy")); + } + } + case "blip" -> { + kind = KIND_PIC; + embed = XlsxPackage.attr(xr, "embed"); + } + case "graphicData" -> graphicUri = XlsxPackage.attr(xr, "uri"); + case "chart" -> { + if (URI_CHART.equals(graphicUri)) { + kind = "chart"; + chartRid = XlsxPackage.attr(xr, "id"); + } else { + kind = KIND_SKIP; + } + } + case "sp", "cxnSp" -> { + kind = KIND_SKIP; + warn.warn(LOG, "xdr:фигура ({}) в .xlsx не эмитится", local); + } + default -> { + } + } + } else if (ev == XMLStreamConstants.END_ELEMENT) { + String local = xr.getLocalName(); + if (EL_FROM.equals(local)) { + inFrom = false; + } else if (EL_TO.equals(local)) { + inTo = false; + } else if (mode == MODE_TWO_CELL && "twoCellAnchor".equals(local) + || mode == MODE_ONE_CELL && "oneCellAnchor".equals(local) + || mode == MODE_ABSOLUTE && "absoluteAnchor".equals(local)) { + long cx; + long cy; + if (mode == MODE_TWO_CELL) { + cx = cellX(sheet, metrics, toCol) + toColOff + - (cellX(sheet, metrics, fromCol) + fromColOff); + cy = cellY(sheet, metrics, toRow) + toRowOff + - (cellY(sheet, metrics, fromRow) + fromRowOff); + } else { + cx = extCx; + cy = extCy; + } + Placement p = finish(pkg, drawingPath, mode, fromRow, fromCol, + cx, cy, kind, embed, chartRid, graphicUri); + if (p != null) { + out.add(p); + } + mode = 0; + } + } + } + } + + private Placement finish(XlsxPackage pkg, String drawingPath, int mode, + int fromRow, int fromCol, long cx, long cy, String kind, + String embed, String chartRid, String graphicUri) { + if (kind == null && graphicUri != null && graphicUri.contains("/diagram")) { + warn.warn(LOG, "SmartArt (diagram) в .xlsx отброшен"); + return null; + } + if (kind == null || KIND_SKIP.equals(kind)) { + return null; + } + if (cx <= 0 || cy <= 0) { + warn.warn(LOG, "drawing с нулевым/отрицательным extent отброшен"); + return null; + } + if (cx > MAX_EXTENT_EMU || cy > MAX_EXTENT_EMU) { + warn.warn(LOG, "drawing extent {}×{} EMU за пределами {} — пропущен", + cx, cy, MAX_EXTENT_EMU); + return null; + } + drawingNo++; + String runXml; + if (KIND_PIC.equals(kind)) { + if (!addImage(pkg, drawingPath, embed)) { + drawingNo--; + return null; + } + runXml = inlineOpen(cx, cy) + "" + + "" + + "" + + "" + inlineClose(); + } else { + byte[] chart = chartBytes(pkg, drawingPath, chartRid); + if (chart.length == 0) { + drawingNo--; + return null; + } + parts.add(new DocxPackageWriter.Part("word/charts/xlsx-chart" + drawingNo + ".xml", + CHART_CONTENT_TYPE, CHART_REL_TYPE, chart)); + runXml = inlineOpen(cx, cy) + "" + inlineClose(); + } + int anchorRow = mode == MODE_ABSOLUTE ? 1 : fromRow + 1; + int anchorCol = mode == MODE_ABSOLUTE ? 0 : fromCol; + return new Placement(anchorRow, anchorCol, runXml); + } + + private String inlineOpen(long cx, long cy) { + return "" + + "" + + ""; + } + + private String inlineClose() { + return ""; + } + + private String lastPartRId() { + return "rId" + parts.size(); + } + + /** Media-байты as-is частью пакета; тип по расширению target'а. */ + private boolean addImage(XlsxPackage pkg, String drawingPath, String embed) { + XlsxPackage.Rel rel = findRel(pkg, drawingPath, embed); + if (rel == null || rel.external()) { + warn.warn(LOG, "blip без внутренней связи (r:embed={}) — картинка пропущена", embed); + return false; + } + String target = XlsxPackage.resolvePath(XlsxPackage.parentDir(drawingPath), + rel.target()); + byte[] bytes = pkg.entry(target); + if (bytes == null) { + warn.warn(LOG, "media-часть {} отсутствует — картинка пропущена", target); + return false; + } + int dot = target.lastIndexOf('.'); + String ext = dot < 0 ? "" : target.substring(dot + 1).toLowerCase(Locale.ROOT); + String contentType = switch (ext) { + case "png" -> "image/png"; + case "jpg", "jpeg" -> "image/jpeg"; + case "gif" -> "image/gif"; + case "bmp" -> "image/bmp"; + case "tif", "tiff" -> "image/tiff"; + default -> null; + }; + if (contentType == null) { + warn.warn(LOG, "формат media .{} не переносится (векторный/неизвестный)", ext); + return false; + } + parts.add(new DocxPackageWriter.Part("word/media/xlsx-image" + drawingNo + "." + ext, + contentType, IMAGE_REL_TYPE, bytes)); + return true; + } + + /** Байты chart-части по r:id связи drawing-части; пустой массив — нет части. */ + private byte[] chartBytes(XlsxPackage pkg, String drawingPath, String chartRid) { + XlsxPackage.Rel rel = findRel(pkg, drawingPath, chartRid); + if (rel == null || rel.external()) { + warn.warn(LOG, "c:chart без внутренней связи (r:id={}) — диаграмма пропущена", + chartRid); + return new byte[0]; + } + byte[] bytes = pkg.entry(XlsxPackage.resolvePath( + XlsxPackage.parentDir(drawingPath), rel.target())); + if (bytes == null) { + warn.warn(LOG, "chart-часть по связи {} отсутствует — диаграмма пропущена", + chartRid); + return new byte[0]; + } + return bytes; + } + + private static XlsxPackage.Rel findRel(XlsxPackage pkg, String partPath, String id) { + if (id == null) { + return null; + } + for (XlsxPackage.Rel rel : pkg.rels(partPath)) { + if (rel.id().equals(id)) { + return rel; + } + } + return null; + } + + /** Кумулятив EMU до левого края колонки (hidden — 0 вклада). */ + static long cellX(SheetModel sheet, Metrics metrics, int col) { + long px = 0; + for (int c = 0; c < col; c++) { + SheetModel.ColDef def = sheet.col(c); + px += metrics.colWidthPx(def == null ? null : def.width(), sheet.baseColWidth(), + def != null && def.hidden()); + } + return Metrics.pxToEmu((int) Math.min(px, Integer.MAX_VALUE)); + } + + /** Кумулятив EMU до верхнего края строки (hidden — 0; ht null — дефолт). */ + static long cellY(SheetModel sheet, Metrics metrics, int row0) { + long emu = 0; + for (int r = 1; r <= row0; r++) { + SheetModel.RowData row = sheet.rows().get(r); + if (row != null && row.hidden()) { + continue; + } + double pt = row == null || row.ht() == null + ? sheet.defaultRowHeight() : row.ht(); + emu += Math.round(pt * EMU_PER_PT); + } + return emu; + } + + private static long parseLong(String s) { + try { + return s == null ? 0 : Long.parseLong(s.trim()); + } catch (NumberFormatException e) { + return 0; + } + } +} diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/Metrics.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/Metrics.java new file mode 100644 index 0000000..993287c --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/Metrics.java @@ -0,0 +1,109 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import ru.pjandro.wordpdf.fonts.BundledFonts; +import ru.pjandro.wordpdf.fonts.GlyphFont; + +/** + * Метрики ширины столбцов .xlsx в пиксели/ twips. MDW (max digit width, + * ECMA-376 §18.3.1.13 note) — максимальная ширина цифры Normal-семейства + * (шрифт стиля Normal после алиасов бандла; дефолт Calibri→Carlito, 11 pt, + * 96 dpi, fontbox-движок {@link GlyphFont}; сбой чтения — 7 px, ровно + * Calibri 11). + * + *

Формула px (прямая инверсия {@code width}, MS-OI29500 §2.1.598-f и + * «Column Width» Office): + * {@code px = Truncate((256·w + Truncate(128/MDW)) / 256 · MDW) + 5} — + * +5 = 2×2 px полей + 1 px гридлайнов; при w=8.43, MDW=7 даёт канонические + * 64 px. Столбец без {@code @width} = {@code baseColWidth} + паддинг-часть + * (0.43 знака при MDW=7 — та же формула, решённая для ширины по умолчанию), + * {@code @hidden} — 0 px (скрытый столбец не печатается).

+ */ +final class Metrics { + + /** Fallback MDW (px) при недоступности fontbox/шрифта. */ + static final int FALLBACK_MDW = 7; + /** Epsilon ширины по умолчанию: паддинг 5 px в знаках при MDW=7. */ + private static final double DEFAULT_WIDTH_PAD = 0.43; + + private final int mdw; + + private Metrics(int mdw) { + this.mdw = mdw; + } + + /** + * MDW по семейству стиля Normal: имя → алиасы бандла (маленький регистр), + * отсутствующее семейство — Carlito (алиас Calibri). + */ + static Metrics forNormalFamily(String familyName) { + int px; + try { + BundledFonts.init(); + GlyphFont f = bundled(familyName); + double max = 0; + for (int d = '0'; d <= '9'; d++) { + max = Math.max(max, f.advance(String.valueOf((char) d), 11.0)); + } + px = (int) Math.max(1, Math.round(max * 96.0 / 72.0)); + } catch (RuntimeException e) { + px = FALLBACK_MDW; + } + return new Metrics(px); + } + + /** Шрифт бандла по имени (lowercase) с фолбэком Carlito; null невозможен. */ + private static GlyphFont bundled(String familyName) { + GlyphFont f = familyName == null ? null + : GlyphFont.of(familyName.toLowerCase(java.util.Locale.ROOT), + BundledFonts.V_REGULAR); + if (f == null) { + f = GlyphFont.of("carlito", BundledFonts.V_REGULAR); + } + if (f == null) { + throw new IllegalStateException("Бандл без Carlito"); + } + return f; + } + + /** MDW в px. */ + int mdw() { + return mdw; + } + + /** + * Ширина столбца в px: hidden — 0; {@code widthChars == null} — + * дефолт {@code baseColWidth + pad}. + */ + int colWidthPx(Double widthChars, double baseColWidth, boolean hidden) { + if (hidden) { + return 0; + } + double w = widthChars == null ? baseColWidth + DEFAULT_WIDTH_PAD : widthChars; + return (int) Math.floor((256.0 * w + Math.floor(128.0 / mdw)) / 256.0 * mdw) + 5; + } + + /** Дефолтная ширина столбца (px) — та же формула без {@code @width}. */ + int defaultWidthPx(double baseColWidth) { + return colWidthPx(null, baseColWidth, false); + } + + /** Пиксели в twips (96 dpi → 1/20 pt: 1 px = 15 twips). */ + static int pxToTwips(int px) { + return px * 15; + } + + /** Пиксели в EMU (1 px = 9525 EMU, ECMA-376 Part 1 §20.1.1.77-ish). */ + static long pxToEmu(int px) { + return px * 9525L; + } + + /** Пункты в twips. */ + static int ptToTwips(double pt) { + return (int) Math.round(pt * 20.0); + } + + /** Дюймы в twips. */ + static int inchesToTwips(double inches) { + return (int) Math.round(inches * 1440.0); + } +} diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/NumberFormats.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/NumberFormats.java new file mode 100644 index 0000000..dcfa583 --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/NumberFormats.java @@ -0,0 +1,736 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import java.math.BigDecimal; +import java.math.RoundingMode; +import java.time.LocalDate; +import java.time.LocalDateTime; +import java.time.Month; +import java.time.format.TextStyle; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Locale; +import java.util.Map; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +/** + * Движок форматных кодов SpreadsheetML (§18.8.31; таблица встроенных id — + * §18.8.31, семантика разрядов — как Excel): секции по «;» + * (положительный/отрицательный/ноль/текст), маски {@code 0 # ?}, запятая + * группировки, хвостовые {@code ,} масштаб, {@code %}, научный {@code E+}, + * даты/время ({@code d dd ddd dddd}, {@code m mmm mmmm}, {@code yy yyyy}, + * {@code h hh H}, elapsed {@code [h] [mm] [ss]}, AM/PM, A/P), экранирования + * {@code "..."}, {@code \x}, {@code _x}, {@code *x} (вырезаются), валютные + * {@code [$...]}, цвета {@code [Red]} и условия {@code [>5]} — принятая + * деградация v1: печатаем без цвета/условия. + * + *

Дробные {@code # ?/?} (id 12/13) — General + warn один раз на код.

+ */ +final class NumberFormats { + + private static final Logger LOG = LoggerFactory.getLogger(NumberFormats.class); + + /** Встроенные numFmtId → код (§18.8.31). */ + private static final Map BUILTIN = builtin(); + + // Синтаксис форматного кода (§18.8.31): именованные символы вместо + // литералов в условиях. + private static final char CH_ZERO = '0'; + private static final char CH_HASH = '#'; + private static final char CH_QUESTION = '?'; + private static final char CH_COMMA = ','; + private static final char CH_DOT = '.'; + private static final char CH_SLASH = '/'; + private static final char CH_QUOTE = '"'; + private static final char CH_BRACKET_OPEN = '['; + private static final char CH_PERCENT = '%'; + private static final char CH_AT = '@'; + private static final char KIND_DAY = 'd'; + private static final char KIND_MONTH = 'm'; + private static final char KIND_YEAR = 'y'; + private static final char KIND_HOUR = 'h'; + private static final char KIND_SECOND = 's'; + private static final char KIND_AMPM = 'p'; + private static final char KIND_NUMBER = 'n'; + private static final char KIND_EXP = 'e'; + + /** Секунд в сутках (elapsed и доли дня). */ + private static final long SECONDS_PER_DAY = 86_400L; + + private final Map custom; + private final boolean date1904; + private final Map> compiled = new HashMap<>(); + + NumberFormats(Map custom, boolean date1904) { + this.custom = custom; + this.date1904 = date1904; + } + + /** + * Форматирование числа (сырое {@code v}). Текстовые/boolean типы сюда не + * доходят. Битое число — сырая строка; unsupported-формат — General. + */ + String format(int numFmtId, String raw, WarnOnce warn) { + double value; + try { + value = Double.parseDouble(raw.trim()); + } catch (RuntimeException e) { + return raw; + } + String code = codeFor(numFmtId); + if (code == null) { + return NumberText.general(raw); + } + List
sections = compiled.computeIfAbsent(code, NumberFormats::compile); + return render(sections, value, warn, code); + } + + /** Код формата: кастом (id ≥ 164) → встроенный → null (General). */ + private String codeFor(int numFmtId) { + if (numFmtId == 0) { + return null; + } + String code = custom.get(numFmtId); + return code != null ? code : BUILTIN.get(numFmtId); + } + + // ================== модель ================== + + /** Позиционный токен секции. */ + private static final class FmtTok { + String lit; + char kind; // d m y h s p n e (дата/AMPM/число/E) + int count; // длина серии; для 'n' — не используется + boolean upper; + boolean elapsed; // [h] [mm] [ss] + boolean shortAmpm; // A/P + boolean decimal; // 'n': дробная часть + boolean minuteOfHour; // 'm': разрешён контекстом в минуты + String mask; // 'n': строка маски (0/#/?) + + static FmtTok lit(String s) { + FmtTok t = new FmtTok(); + t.lit = s; + t.kind = ' '; + return t; + } + + static FmtTok date(char kind, int count, boolean upper, boolean elapsed) { + FmtTok t = new FmtTok(); + t.kind = kind; + t.count = count; + t.upper = upper; + t.elapsed = elapsed; + return t; + } + + static FmtTok ampm(boolean upper, boolean shortForm) { + FmtTok t = new FmtTok(); + t.kind = KIND_AMPM; + t.upper = upper; + t.shortAmpm = shortForm; + return t; + } + + static FmtTok exp(int digits) { + FmtTok t = new FmtTok(); + t.kind = KIND_EXP; + t.count = digits; + return t; + } + + static FmtTok number(String mask, boolean decimal) { + FmtTok t = new FmtTok(); + t.kind = KIND_NUMBER; + t.mask = mask; + t.decimal = decimal; + return t; + } + } + + /** Секция форматного кода. */ + private static final class Section { + final List toks = new ArrayList<>(); + boolean date; + boolean percent; + boolean grouping; + boolean fraction; + boolean scientific; + int scaleThousands; + String integerMask; + String decimalMask; + + boolean hasNumber() { + return integerMask != null || decimalMask != null; + } + } + + // ================== компиляция ================== + + private static List
compile(String code) { + List
sections = new ArrayList<>(); + int i = 0; + StringBuilder part = new StringBuilder(); + boolean quote = false; + boolean bracket = false; + while (i < code.length()) { + char ch = code.charAt(i); + if (ch == '\\' && i + 1 < code.length()) { + part.append(code, i, i + 2); + i += 2; + continue; + } + if (!bracket && ch == '"') { + quote = !quote; + } else if (!quote && ch == '[') { + bracket = true; + } else if (!quote && ch == ']') { + bracket = false; + } + if (ch == ';' && !quote && !bracket) { + sections.add(compileSection(part.toString())); + part.setLength(0); + i++; + continue; + } + part.append(ch); + i++; + } + sections.add(compileSection(part.toString())); + for (Section s : sections) { + resolveMinutes(s); + } + return List.copyOf(sections); + } + + /** + * Нижняя {@code m} — минуты, только если рядом (через литералы) есть + * h/s/AMPM/elapsed; иначе месяц (ASCII {@code m} == {@code M}). + */ + private static void resolveMinutes(Section sec) { + for (int i = 0; i < sec.toks.size(); i++) { + FmtTok t = sec.toks.get(i); + if (t.kind == KIND_MONTH && !t.upper && !t.elapsed) { + t.minuteOfHour = neighborIsTimeUnit(sec, i, -1) + || neighborIsTimeUnit(sec, i, 1); + } + } + } + + /** Цифровой плейсхолдер 0/#/?. */ + private static boolean isPlaceholder(char ch) { + return ch == CH_ZERO || ch == CH_HASH || ch == CH_QUESTION; + } + + /** Ближайший нетокен-литералу сосед в сторону dir — часовая/секундная единица? */ + private static boolean neighborIsTimeUnit(Section sec, int from, int dir) { + for (int i = from + dir; i >= 0 && i < sec.toks.size(); i += dir) { + FmtTok n = sec.toks.get(i); + if (n.lit != null) { + continue; + } + if (n.kind == KIND_NUMBER || n.kind == KIND_EXP) { + continue; + } + return n.kind == KIND_HOUR || n.kind == KIND_SECOND || n.kind == KIND_AMPM + || n.elapsed; + } + return false; + } + + private static Section compileSection(String raw) { + Section sec = new Section(); + StringBuilder lit = new StringBuilder(); + int i = 0; + int digitStart = -1; + while (i < raw.length()) { + char ch = raw.charAt(i); + if (ch == CH_ZERO || ch == CH_HASH || ch == CH_QUESTION) { + if (digitStart < 0) { + flush(sec, lit); + digitStart = i; + } + i++; + continue; + } + if (digitStart >= 0) { + int closed = closeZone(raw, sec, digitStart, i); + if (closed > i) { // зона продлена/закрыта точкой + digitStart = -1; + i = closed; + continue; + } + if (ch == CH_COMMA) { + int k = i; + while (k < raw.length() && raw.charAt(k) == CH_COMMA) { + k++; + } + if (k < raw.length() && (raw.charAt(k) == CH_ZERO || raw.charAt(k) == CH_HASH + || raw.charAt(k) == CH_QUESTION)) { + sec.grouping = true; + i++; + continue; // зона остаётся открытой + } + sec.scaleThousands += k - i; + digitStart = -1; + i = k; + continue; + } + if (ch == CH_SLASH) { + sec.fraction = true; + lit.append('/'); + digitStart = -1; + i++; + continue; + } + digitStart = -1; + // fallthrough: обычный символ закрывает зону + } + if (ch == CH_QUOTE) { + flush(sec, lit); + StringBuilder q = new StringBuilder(); + int j = i + 1; + while (j < raw.length()) { + char c = raw.charAt(j); + if (c == '\\' && j + 1 < raw.length()) { + q.append(raw.charAt(j + 1)); // в кавычках backslash экранирует + j += 2; + continue; + } + if (c == CH_QUOTE) { + break; + } + q.append(c); + j++; + } + sec.toks.add(FmtTok.lit(q.toString())); + i = j + 1; + continue; + } + if (ch == '\\' && i + 1 < raw.length()) { + lit.append(raw.charAt(i + 1)); + i += 2; + continue; + } + if (ch == '_' && i + 1 < raw.length()) { + i += 2; // выравнивающий пробел _x — вырезается + continue; + } + if (ch == '*' && i + 1 < raw.length()) { + i += 2; // заполнение колонки *x — вырезается + continue; + } + if (ch == CH_BRACKET_OPEN) { + flush(sec, lit); + int close = raw.indexOf(']', i); + String body = raw.substring(i + 1, close < 0 ? raw.length() : close); + if (body.startsWith("$")) { + sec.toks.add(FmtTok.lit(currencyLiteral(body))); + } else if (isElapsedKind(body)) { + sec.toks.add(elapsedTok(body)); + sec.date = true; + } + // цвет/условие/прочее — деградация (печатаем без них) + i = close < 0 ? raw.length() : close + 1; + continue; + } + if ((ch == 'A' || ch == 'a') && raw.regionMatches(true, i, "AM/PM", 0, 5)) { + flush(sec, lit); + sec.toks.add(FmtTok.ampm(Character.isUpperCase(ch), false)); + sec.date = true; + i += 5; + continue; + } + if ((ch == 'A' || ch == 'a') && raw.regionMatches(true, i, "A/P", 0, 3)) { + flush(sec, lit); + sec.toks.add(FmtTok.ampm(Character.isUpperCase(ch), true)); + sec.date = true; + i += 3; + continue; + } + if (ch == 'E' && i + 1 < raw.length() + && (raw.charAt(i + 1) == '+' || raw.charAt(i + 1) == '-')) { + flush(sec, lit); + int zeros = 0; + int k = i + 2; + while (k < raw.length() && raw.charAt(k) == '0') { + zeros++; + k++; + } + sec.scientific = true; + sec.toks.add(FmtTok.exp(Math.max(1, zeros))); + i = k; + continue; + } + if (digitStart < 0 && ch == CH_DOT && i + 1 < raw.length() + && isPlaceholder(raw.charAt(i + 1))) { + // ведущая точка: «.##» — дробная маска без целой + flush(sec, lit); + int k = i + 1; + while (k < raw.length() && isPlaceholder(raw.charAt(k))) { + k++; + } + addNumberZone(sec, raw.substring(i + 1, k), true); + i = k; + continue; + } + if (ch == CH_PERCENT) { + sec.percent = true; + lit.append('%'); // знак печатается на своей позиции + i++; + continue; + } + if (ch == CH_AT) { + i++; // текстовая подстановка: секция печатает текст как есть + continue; + } + if (isDateChar(ch)) { + flush(sec, lit); + int run = 1; + while (i + run < raw.length() && raw.charAt(i + run) == ch) { + run++; + } + char lower = Character.toLowerCase(ch); + sec.toks.add(FmtTok.date(lower, run, Character.isUpperCase(ch), false)); + sec.date = true; // и «m» тоже: «m» без времени — месяц + i += run; + continue; + } + lit.append(ch); + i++; + } + if (digitStart >= 0) { + closeZone(raw, sec, digitStart, raw.length()); + } + flush(sec, lit); + if (sec.integerMask == null && sec.decimalMask != null) { + sec.integerMask = ""; + } + return sec; + } + + /** + * Закрытие цифровой зоны [from..i). Возвращает i+1, если зона закрыта + * точкой с последующей дробной маской (тогда добавлены оба токена), + * иначе i (зона закрыта как целая, символ обрабатывается дальше). + */ + private static int closeZone(String raw, Section sec, int from, int i) { + String mask = raw.substring(from, i); + if (i < raw.length() && raw.charAt(i) == CH_DOT) { + int k = i + 1; + while (k < raw.length() && (raw.charAt(k) == CH_ZERO || raw.charAt(k) == CH_HASH + || raw.charAt(k) == CH_QUESTION)) { + k++; + } + if (k > i + 1) { + addNumberZone(sec, mask, false); + addNumberZone(sec, raw.substring(i + 1, k), true); + return k; + } + } + addNumberZone(sec, mask, false); + return i; + } + + private static void addNumberZone(Section sec, String mask, boolean decimal) { + sec.toks.add(FmtTok.number(mask, decimal)); + if (decimal) { + sec.decimalMask = sec.decimalMask == null ? mask : sec.decimalMask + mask; + } else { + sec.integerMask = sec.integerMask == null ? mask : sec.integerMask + mask; + } + } + + private static void flush(Section sec, StringBuilder lit) { + if (lit.length() > 0) { + sec.toks.add(FmtTok.lit(lit.toString())); + lit.setLength(0); + } + } + + private static boolean isDateChar(char ch) { + switch (Character.toLowerCase(ch)) { + case KIND_DAY: + case KIND_YEAR: + case KIND_HOUR: + case KIND_SECOND: + case KIND_MONTH: + return true; + default: + return false; + } + } + + + private static boolean isElapsedKind(String body) { + String u = body.toLowerCase(Locale.ROOT); + return !u.isEmpty() && (u.charAt(0) == 'h' || u.charAt(0) == 'm' || u.charAt(0) == 's'); + } + + private static String currencyLiteral(String body) { + int dash = body.indexOf('-'); + String cur = body.substring(1, dash < 0 ? body.length() : dash); + return cur.startsWith("$") ? cur.substring(1) : cur; + } + + /** [h]/[mm]/[ss] — elapsed-токены даты/времени. */ + private static FmtTok elapsedTok(String body) { + String u = body.toLowerCase(Locale.ROOT); + return FmtTok.date(u.charAt(0), Math.max(2, u.length()), false, true); + } + + + // ================== рендер ================== + + private String render(List
sections, double value, WarnOnce warn, String code) { + int idx = pickIndex(sections, value); + Section sec = sections.get(idx); + if (sec.fraction) { + warn.warn(LOG, "Дробный формат «{}» не поддерживается — General", code); + return NumberText.general(Double.toString(value)); + } + if (sec.date) { + return renderDate(sec, value); + } + if (!sec.hasNumber()) { + return NumberText.general(Double.toString(value)); + } + boolean forceMinus = value < 0 && sections.size() == 1; + return renderNumber(sec, Math.abs(applyScale(value, sec)), forceMinus); + } + + private static double applyScale(double value, Section sec) { + double v = sec.percent ? value * 100 : value; + if (sec.scaleThousands > 0) { + v /= Math.pow(1000, sec.scaleThousands); + } + return v; + } + + private static int pickIndex(List
sections, double value) { + if (value > 0 || sections.size() == 1) { + return 0; + } + if (value < 0) { + return sections.size() >= 2 ? 1 : 0; + } + return sections.size() >= 3 ? 2 : 0; + } + + private static String renderNumber(Section sec, double absValue, boolean forceMinus) { + int dp = sec.decimalMask == null ? 0 : sec.decimalMask.length(); + BigDecimal num = BigDecimal.valueOf(absValue).setScale(dp, RoundingMode.HALF_UP); + String plain = num.toPlainString(); + int dot = plain.indexOf('.'); + String intPart = dot < 0 ? plain : plain.substring(0, dot); + String fracPart = dot < 0 ? "" : plain.substring(dot + 1); + int minInt = sec.integerMask == null ? 0 : (int) sec.integerMask.chars() + .filter(c -> c == CH_ZERO).count(); + StringBuilder out = new StringBuilder(); + boolean numberEmitted = false; + for (FmtTok t : sec.toks) { + if (t.lit != null) { + out.append(t.lit); + } else if (t.kind == KIND_NUMBER) { + if (numberEmitted || sec.scientific) { + continue; + } + numberEmitted = true; + out.append(integerOf(intPart, sec, minInt)); + if (dp > 0) { + out.append('.').append(trimDecimal(fracPart, sec.decimalMask)); + } + } else if (t.kind == KIND_EXP) { + out.append(renderExp(absValue, t.count, dp)); + } + } + if (forceMinus) { + out.insert(0, '-'); + } + return out.toString(); + } + + private static String integerOf(String intPart, Section sec, int minInt) { + String digits; + boolean optionalOnly = sec.integerMask != null && sec.integerMask.chars() + .allMatch(c -> c == CH_HASH || c == CH_QUESTION); + if (optionalOnly && "0".equals(intPart)) { + digits = ""; // "#.##" для 0.5 → ".5" + } else { + StringBuilder sb = new StringBuilder(intPart); + while (sb.length() < minInt) { + sb.insert(0, CH_ZERO); + } + digits = sb.toString(); + } + return sec.grouping ? group(digits) : digits; + } + + private static String group(String digits) { + StringBuilder out = new StringBuilder(); + int rem = digits.length() % 3; + for (int i = 0; i < digits.length(); i++) { + if (i > 0 && (i - rem) % 3 == 0) { + out.append(','); + } + out.append(digits.charAt(i)); + } + return out.toString(); + } + + /** + * Дробная: frac уже length == mask.length (после setScale); хвостовые + * позиции «#» с нулевым символом обрезаются, «0» остаются. + */ + private static String trimDecimal(String frac, String mask) { + int last = mask.length(); + while (last > 0 && mask.charAt(last - 1) == CH_HASH && frac.charAt(last - 1) == CH_ZERO) { + last--; + } + return frac.substring(0, last); + } + + /** Научный: «%.E» + знак/ширина экспоненты из кода. */ + private static String renderExp(double value, int expDigits, int dp) { + String sci = String.format(Locale.ROOT, "%." + Math.max(1, dp) + "E", value); + int e = sci.indexOf('E'); + int exponent = Integer.parseInt(sci.substring(e + 1)); + return sci.substring(0, e) + "E" + (exponent < 0 ? "-" : "+") + + String.format(Locale.ROOT, "%0" + expDigits + "d", Math.abs(exponent)); + } + + private String renderDate(Section sec, double value) { + LocalDateTime dt = toLocalDateTime(value); + if (dt == null) { + return NumberText.general(Double.toString(value)); + } + StringBuilder out = new StringBuilder(); + boolean hour12 = sec.toks.stream().anyMatch(t -> t.kind == KIND_AMPM); + long totalSeconds = Math.round(Math.abs(value) * SECONDS_PER_DAY); + for (FmtTok t : sec.toks) { + if (t.lit != null) { + out.append(t.lit); + } else if (t.kind == KIND_AMPM) { + out.append(renderAmpm(t, dt.getHour())); + } else { + out.append(renderDateTok(t, dt, hour12, totalSeconds)); + } + } + return out.toString(); + } + + private static String renderAmpm(FmtTok t, int hour) { + String full = hour < 12 ? "AM" : "PM"; + String unit = t.shortAmpm ? full.substring(0, 1) : full; + return t.upper ? unit : unit.toLowerCase(Locale.ROOT); + } + + private static String renderDateTok(FmtTok t, LocalDateTime dt, boolean hour12, + long totalSeconds) { + switch (t.kind) { + case KIND_DAY: + return switch (t.count) { + case 1 -> Integer.toString(dt.getDayOfMonth()); + case 2 -> String.format("%02d", dt.getDayOfMonth()); + case 3 -> dt.getDayOfWeek().getDisplayName(TextStyle.SHORT, Locale.ENGLISH); + default -> dt.getDayOfWeek().getDisplayName(TextStyle.FULL, Locale.ENGLISH); + }; + case KIND_MONTH: + if (t.elapsed) { + return Long.toString(totalSeconds / 60); + } + if (t.minuteOfHour) { + return t.count >= 2 ? String.format("%02d", dt.getMinute()) + : Integer.toString(dt.getMinute()); + } + return monthName(dt.getMonthValue(), t.count); + case KIND_YEAR: + int year = dt.getYear(); + return t.count >= 4 ? Integer.toString(year) + : String.format("%02d", year % 100); + case KIND_HOUR: { + if (t.elapsed) { + return Long.toString(totalSeconds / 3600); + } + int h = dt.getHour(); + if (hour12) { + h = h % 12 == 0 ? 12 : h % 12; + } + return t.count >= 2 ? String.format("%02d", h) : Integer.toString(h); + } + case KIND_SECOND: + if (t.elapsed) { + return Long.toString(totalSeconds); + } + return t.count >= 2 ? String.format("%02d", dt.getSecond()) + : Integer.toString(dt.getSecond()); + default: + return ""; + } + } + + private static String monthName(int month, int count) { + Month m = Month.of(month); + switch (count) { + case 1: + return Integer.toString(month); + case 2: + return String.format("%02d", month); + case 3: + return m.getDisplayName(TextStyle.SHORT, Locale.ENGLISH); + case 4: + return m.getDisplayName(TextStyle.FULL, Locale.ENGLISH); + default: + return m.getDisplayName(TextStyle.SHORT, Locale.ENGLISH).substring(0, 1); + } + } + + /** Excel-serial → LocalDateTime (1904 — база 1904-01-01; мнимый 29.02.1900 → 28.02). */ + LocalDateTime toLocalDateTime(double serial) { + if (serial < 0 && !date1904) { + return null; + } + LocalDate base = date1904 ? LocalDate.of(1904, 1, 1) : LocalDate.of(1899, 12, 30); + long whole = (long) Math.floor(serial); + double frac = serial - whole; + if (!date1904 && whole >= 1 && whole < 60) { + whole += 1; // сериальник до фейкового 29.02.1900; сам 60 (его нет + } // в календаре) остаётся 28.02.1900 — деградация + long nano = Math.round(frac * SECONDS_PER_DAY) * 1_000_000_000L; + return base.plusDays(whole).atStartOfDay().plusNanos(nano); + } + + private static Map builtin() { + Map m = new HashMap<>(); + m.put(1, "0"); + m.put(2, "0.00"); + m.put(3, "#,##0"); + m.put(4, "#,##0.00"); + m.put(9, "0%"); + m.put(10, "0.00%"); + m.put(11, "0.00E+00"); + m.put(12, "# ?/?"); + m.put(13, "# ??/??"); + m.put(14, "MM-dd-yy"); + m.put(15, "d-mmm-yy"); + m.put(16, "d-mmm"); + m.put(17, "mmm-yy"); + m.put(18, "h:mm AM/PM"); + m.put(19, "h:mm:ss AM/PM"); + m.put(20, "h:mm"); + m.put(21, "h:mm:ss"); + m.put(22, "M/d/yy h:mm"); + m.put(37, "#,##0 ;(#,##0)"); + m.put(38, "#,##0 ;[Red](#,##0)"); + m.put(39, "#,##0.00;(#,##0.00)"); + m.put(40, "#,##0.00;[Red](#,##0.00)"); + m.put(45, "mm:ss"); + m.put(46, "[h]:mm:ss"); + m.put(47, "mmss.0"); + m.put(48, "##0.0E+0"); + m.put(49, "@"); + return Map.copyOf(m); + } +} diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/NumberText.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/NumberText.java new file mode 100644 index 0000000..c3593f8 --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/NumberText.java @@ -0,0 +1,82 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +/** + * General-вывод значения ячейки (§18.8.30 примечания) и текстовые типы: + * число — кратчайкая round-trip запись без хвостовых нулей; |x| ≥ 1e10 или + * ≠0 и < 1e-9 — научный с 10 знаками (как Excel General). Полный + * движок форматных кодов — {@link NumberFormats}; здесь — то, что едет + * при {@code numFmt="General"} и в fallback'ах. + */ +final class NumberText { + + private NumberText() { + } + + /** + * Текст ячейки по типу {@code @t}: {@code b} — TRUE/FALSE, {@code e} — + * сырая ошибка, {@code str} — строка кэша формулы, число (null/"n") — + * General. {@code s}/{@code inlineStr} сюда не доходят (раны), + * {@code d} — ISO-строка как есть (парсинг дат — {@link NumberFormats}). + */ + static String of(String raw, String type) { + if (raw == null) { + return ""; + } + return switch (type == null ? "" : type) { + case "b" -> "1".equals(raw.trim()) ? "TRUE" : "FALSE"; + case "e", "str", "d" -> raw; + default -> general(raw); + }; + } + + /** General по сырой строке {@code v}: парсится в double — форматим, нет — как есть. */ + static String general(String raw) { + double value; + try { + value = Double.parseDouble(raw.trim()); + } catch (NumberFormatException e) { + return raw; + } + if (value == Math.rint(value) && !Double.isInfinite(value) + && Math.abs(value) < 1e10) { + return Long.toString((long) value); + } + return decimalOrScientific(value); + } + + /** + * Дробное: shortest round-trip без хвостовых нулей; диапазон — научный + * {@code 0.##########E+xx} (10 значащих знаков, экспонента с знаком и + * минимум двумя цифрами — Excel General). + */ + static String decimalOrScientific(double value) { + double abs = Math.abs(value); + if (abs == 0 || abs < 1e10 && abs >= 1e-9) { + return shortestRepr(value); + } + String sci = String.format(java.util.Locale.ROOT, "%.9E", value); + int e = sci.indexOf('E'); + double mantissa = Double.parseDouble(sci.substring(0, e)); + int exponent = Integer.parseInt(sci.substring(e + 1)); + String mant = shortestRepr(mantissa).replace("-", "-"); + return mant + "E" + (exponent < 0 ? "-" : "+") + + String.format(java.util.Locale.ROOT, "%02d", Math.abs(exponent)); + } + + /** + * Кратчайая десятичная запись double без хвостового «.0»; + * {@code Double.toString} уходит в E-нотацию с 1e7/1e-4 — внутри + * десятичного диапазона General разворачиваем обратно (9.9999999995E9 → + * 9999999999.5), лишние нули хвоста снимаются. + */ + private static String shortestRepr(double value) { + String s = Double.toString(value); + if (s.indexOf('E') >= 0 || s.indexOf('e') >= 0) { + return new java.math.BigDecimal(s).stripTrailingZeros().toPlainString(); + } + if (s.endsWith(".0")) { + return s.substring(0, s.length() - 2); + } + return s; + } +} diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/PrintLayout.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/PrintLayout.java new file mode 100644 index 0000000..654cfa4 --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/PrintLayout.java @@ -0,0 +1,217 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import java.util.ArrayList; +import java.util.List; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import ru.pjandro.wordpdf.internal.xlsx.SheetModel.Margins; +import ru.pjandro.wordpdf.internal.xlsx.SheetModel.PageSetup; + +/** + * Печатная раскладка листа: страница из {@code pageSetup}/{@code pageMargins} + * (§18.3.1.63/.67), нарезка видимых колонок на печатные срезы по ширине + * и деление строк на вертикальные блоки ручными {@code rowBreaks}. + * + *

Размеры страниц — фиксированная карта CT_PaperSize в твипах книжной + * ориентации (дюйм×1440, мм×56.6929); {@code @orientation="landscape"} меняет + * стороны местами. Вне карты и при отсутствующем {@code @paperSize} (в + * {@link SheetModel} дефолт — 9 = A4) — A4 c warn раз на конвертацию.

+ * + *

{@code fitToPage && fitToWidth=1} — один срез, ширины колонок + * масштабируются до полезной ширины (шрифты не масштабируются — принятая + * деградация вместо Excel-reshrink); {@code @scale} без {@code fitToPage} — + * игнорируется c warn (масштаб текста FOP-пайплайн не воспроизводит).

+ */ +final class PrintLayout { + + /** Блок печати: колонки среза (0-based) × строки [{@code rowFrom}..{@code rowTo}] (1-based, включительно). */ + record Block(List cols, int rowFrom, int rowTo) { + } + + /** Страница в твипах уже ПОСЛЕ разворота ориентации + поля. */ + record Page(int width, int height, int left, int right, int top, int bottom, + int header, int footer, boolean landscape) { + + int usableWidth() { + return Math.max(1, width - left - right); + } + } + + /** План листа: единый масштаб ширины колонок + блоки (срез × вертикальный фрагмент). */ + record Plan(double widthScale, List blocks) { + } + + private static final Logger LOG = LoggerFactory.getLogger(PrintLayout.class); + + /** Дефолт {@code pageMargins} из {@link SheetModel} (0.7/0.75/0.3 дюйма). */ + private static final Margins DEF_MARGINS = new Margins(0.7, 0.7, 0.75, 0.75, 0.3, 0.3); + + private PrintLayout() { + } + + /** Лист без данных/настроек — A4 с дефолтными полями (финальная секция пустого документа). */ + static Page defaultPage() { + return page(9, false, DEF_MARGINS, new WarnOnce()); + } + + static Page page(SheetModel sheet, WarnOnce warn) { + PageSetup ps = sheet.pageSetup(); + return page(ps.paperSize(), ps.landscape(), sheet.margins(), warn); + } + + private static Page page(int paperSize, boolean landscape, Margins margins, WarnOnce warn) { + int[] wh = paperTwips(paperSize); + if (wh == null) { + warn.warn(LOG, "pageSetup/@paperSize={} не поддержан — берём A4", paperSize); + wh = paperTwips(9); + } + int w = wh[0]; + int h = wh[1]; + if (landscape) { + int t = w; + w = h; + h = t; + } + return new Page(w, h, + Metrics.inchesToTwips(margins.left()), Metrics.inchesToTwips(margins.right()), + Metrics.inchesToTwips(margins.top()), Metrics.inchesToTwips(margins.bottom()), + Metrics.inchesToTwips(margins.header()), Metrics.inchesToTwips(margins.footer()), + landscape); + } + + /** + * CT_PaperSize (§18.3.1.63) → {w,h} твипов книжной ориентации. Вне карты — + * {@code null} (вызывающий деградирует на A4). + */ + private static int[] paperTwips(int paperSize) { + return switch (paperSize) { + case 1 -> new int[] {12240, 15840}; // Letter 8.5×11″ + case 3 -> new int[] {15840, 24480}; // Tabloid 11×17″ + case 4 -> new int[] {24480, 15840}; // Ledger 17×11″ + case 5 -> new int[] {12240, 20160}; // Legal 8.5×14″ + case 6 -> new int[] {7920, 12240}; // Statement 5.5×8.5″ + case 7 -> new int[] {10440, 15120}; // Executive 7.25×10.5″ + case 8 -> new int[] {16839, 23811}; // A3 + case 9 -> new int[] {11906, 16839}; // A4 + case 11 -> new int[] {8391, 11906}; // A5 + case 12 -> new int[] {14173, 20013}; // B4 250×353 мм + case 13 -> new int[] {9978, 14173}; // B5 176×250 мм + case 14 -> new int[] {12240, 18720}; // Folio 8.5×13″ + case 15 -> new int[] {12189, 15591}; // Quarto 215×275 мм + case 16 -> new int[] {11520, 14400}; // Paper10 8×10″ + case 17 -> new int[] {13680, 15840}; // Paper11 9.5×11″ + case 18 -> new int[] {14400, 15840}; // Paper12 10×11″ + default -> null; + }; + } + + /** План печати листа (блоки непусты всегда: ≥1, пустой лист — блок с пустым диапазоном строк). */ + static Plan plan(SheetModel sheet, Metrics metrics, Page page, WarnOnce warn) { + PageSetup ps = sheet.pageSetup(); + if (!ps.fitToPage() && ps.scale() != 100) { + warn.warn(LOG, "pageSetup/@scale={} без fitToPage игнорируется", ps.scale()); + } + List cols = visibleColumns(sheet); + double totalTwips = 0; + for (int c : cols) { + totalTwips += colTwips(sheet, metrics, c); + } + double widthScale = 1; + boolean oneSlice = false; + if (ps.fitToPage() && ps.fitToWidth() == 1) { + oneSlice = true; + if (totalTwips > page.usableWidth()) { + widthScale = page.usableWidth() / totalTwips; + } + } + List> slices = new ArrayList<>(); + if (oneSlice || cols.isEmpty()) { + slices.add(cols); + } else { + List current = new ArrayList<>(); + double used = 0; + for (int c : cols) { + double cw = colTwips(sheet, metrics, c) * widthScale; + if (!current.isEmpty() && used + cw > page.usableWidth()) { + slices.add(current); + current = new ArrayList<>(); + used = 0; + } + current.add(c); + used += cw; + } + slices.add(current); + } + List fragments = verticalFragments(sheet); + List blocks = new ArrayList<>(); + for (List slice : slices) { + for (int[] f : fragments) { + blocks.add(new Block(slice, f[0], f[1])); + } + } + return new Plan(widthScale, blocks); + } + + /** + * Вертикальные фрагменты по {@code rowBreaks/@id} (id — 1-based номер + * строки ПОСЛЕ которой обрыв; фикстура xlsx-wide). Разрывы за последней + * строкой данных и дубликаты отбрасываются (пустой последней страницы + * Excel не печатает). Пустой лист — единственный пустой фрагмент [1..0]. + */ + private static List verticalFragments(SheetModel sheet) { + int maxRow = sheet.rows().isEmpty() ? 0 : sheet.rows().lastKey(); + List frags = new ArrayList<>(); + int from = 1; + for (int brk : sheet.rowBreaks().stream().distinct().sorted().toList()) { + if (brk < from || brk >= maxRow) { + continue; + } + frags.add(new int[] {from, brk}); + from = brk + 1; + } + frags.add(new int[] {from, maxRow}); + return frags; + } + + /** Видимые колонки от 0 до максимальной колонки данных/merge'ей. */ + static List visibleColumns(SheetModel sheet) { + int total = sheet.usedCols(); + for (SheetModel.Merge m : sheet.merges()) { + total = Math.max(total, m.col2() + 1); + } + List visible = new ArrayList<>(); + for (int c = 0; c < total; c++) { + SheetModel.ColDef def = sheet.col(c); + if (def == null || !def.hidden()) { + visible.add(c); + } + } + return visible; + } + + /** Ширина колонки в твипах (скрытая — 0). */ + static int colTwips(SheetModel sheet, Metrics metrics, int col) { + SheetModel.ColDef def = sheet.col(col); + return Metrics.pxToTwips(metrics.colWidthPx(def == null ? null : def.width(), + sheet.baseColWidth(), def != null && def.hidden())); + } + + /** Содержимое {@code w:sectPr}: pgSz (с ориентацией) + pgMar. */ + static String sectPr(Page p) { + StringBuilder s = new StringBuilder(""); + return s.toString(); + } +} diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/SharedStrings.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/SharedStrings.java new file mode 100644 index 0000000..3373de1 --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/SharedStrings.java @@ -0,0 +1,200 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import javax.xml.stream.XMLStreamConstants; +import javax.xml.stream.XMLStreamException; +import javax.xml.stream.XMLStreamReader; +import java.io.ByteArrayInputStream; +import java.io.IOException; +import java.util.ArrayList; +import java.util.List; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +/** + * {@code xl/sharedStrings.xml} (ECMA-376 §18.5): таблица строк {@code sst}, + * элемент {@code si} — plain-{@code t} или rich-раны {@code r} (§18.4.1: + * {@code r/t} + {@code rPr}). Ран сохраняется списком {@link Run} (стили + * не схлопываются — Word рисует rich-строку несколькими {@code w:r}). + * Фонетика {@code rPh} вырезается (как руби в правиле 10 — надстрочница + * в PDF не печатается). + * + *

Тот же разбор {@code CT_Rst} используется для inlineStr-ячеек + * ( worksheet §18.3.1.53 {@code is} — та же структура), см. + * {@link #parseRst(XMLStreamReader, WarnOnce)}.

+ */ +final class SharedStrings { + + /** Фрагмент rich-строки; {@code style == null} — стиль ячейки. */ + record Run(String text, RunStyle style) { + } + + /** Переопределение rPr rich-рана (ECMA-376 §18.4.8 CT_RPrElt). */ + record RunStyle(Boolean bold, Boolean italic, String underline, Boolean strikeout, + Double sizePt, ColorSpec color, String fontName, String vertAlign) { + + boolean isEmpty() { + return bold == null && italic == null && underline == null && strikeout == null + && sizePt == null && (color == null || color.isEmpty()) + && fontName == null && vertAlign == null; + } + } + + private static final Logger LOG = LoggerFactory.getLogger(SharedStrings.class); + private static final String SST_PART = "xl/sharedStrings.xml"; + static final List NO_RUNS = List.of(); + + private final List> items; + + private SharedStrings(List> items) { + this.items = items; + } + + static SharedStrings read(XlsxPackage pkg, WarnOnce warn) throws IOException { + byte[] data = pkg.entry(SST_PART); + List> items = new ArrayList<>(); + if (data == null) { + return new SharedStrings(items); + } + try { + XMLStreamReader xr = XlsxPackage.newSecureReader() + .createXMLStreamReader(new ByteArrayInputStream(data)); + while (xr.hasNext()) { + if (xr.next() == XMLStreamReader.START_ELEMENT + && "si".equals(xr.getLocalName())) { + items.add(parseRst(xr, warn)); + } + } + xr.close(); + } catch (XMLStreamException e) { + throw new IOException("Не удалось разобрать xl/sharedStrings.xml", e); + } + return new SharedStrings(items); + } + + /** Строка по индексу SST; индекс за таблицей — пусто + warn (§18.5). */ + List at(int index, WarnOnce warn) { + if (index < 0 || index >= items.size()) { + warn.warn(LOG, "Индекс shared string {} вне таблицы ({} записей) — пустая строка", + index, items.size()); + return NO_RUNS; + } + return items.get(index); + } + + /** + * Разбор {@code CT_Rst} с текущей позиции (читатель стоит на START + * {@code si}/{@code is}): plain-{@code t}, ран {@code r} (текст + rPr), + * {@code rPh} — вырезается. Вызов потребляет элемент целиком. + */ + static List parseRst(XMLStreamReader xr, WarnOnce warn) throws XMLStreamException { + List runs = new ArrayList<>(); + StringBuilder plain = new StringBuilder(); + while (xr.hasNext()) { + int ev = xr.next(); + if (ev == XMLStreamConstants.END_ELEMENT) { + break; + } + if (ev != XMLStreamConstants.START_ELEMENT) { + continue; + } + switch (xr.getLocalName()) { + case "t" -> plain.append(xr.getElementText()); + case "r" -> runs.add(parseRun(xr)); + case "rPh" -> skipElement(xr); + default -> skipElement(xr); + } + } + if (plain.length() > 0) { + runs.add(0, new Run(plain.toString(), null)); + } + return runs; + } + + /** Ран {@code r}: текст из {@code t}, переопределения из {@code rPr}. */ + private static Run parseRun(XMLStreamReader xr) throws XMLStreamException { + StringBuilder text = new StringBuilder(); + RunStyle style = null; + while (xr.hasNext()) { + int ev = xr.next(); + if (ev == XMLStreamConstants.END_ELEMENT) { + break; + } + if (ev != XMLStreamConstants.START_ELEMENT) { + continue; + } + String name = xr.getLocalName(); + switch (name) { + case "t" -> text.append(xr.getElementText()); + case "rPr" -> style = parseRPr(xr); + default -> skipElement(xr); + } + } + return new Run(text.toString(), style != null && !style.isEmpty() ? style : null); + } + + /** {@code CT_RPrElt}: b, i, u, strike, sz, color, vertAlign, rFont. */ + private static RunStyle parseRPr(XMLStreamReader xr) throws XMLStreamException { + Boolean bold = null; + Boolean italic = null; + String underline = null; + Boolean strikeout = null; + Double size = null; + ColorSpec color = null; + String font = null; + String vertAlign = null; + while (xr.hasNext()) { + int ev = xr.next(); + if (ev == XMLStreamConstants.END_ELEMENT) { + break; + } + if (ev != XMLStreamConstants.START_ELEMENT) { + continue; + } + switch (xr.getLocalName()) { + case "b" -> bold = boolVal(xr); + case "i" -> italic = boolVal(xr); + case "strike" -> strikeout = boolVal(xr); + case "u" -> { + String v = XlsxPackage.attr(xr, "val"); + underline = v == null || "none".equals(v) ? null : v; + } + case "sz" -> size = ColorSpec.parseDouble(XlsxPackage.attr(xr, "val")); + case "color" -> color = ColorSpec.fromColorElement(xr); + case "vertAlign" -> { + String v = XlsxPackage.attr(xr, "val"); + vertAlign = v == null || "baseline".equals(v) ? null : v; + } + case "rFont" -> font = XlsxPackage.attr(xr, "val"); + default -> { + } + } + // дочерний листок (b/sz/color/…) обязан быть потреблён целиком, + // иначе его END досрочно прервёт разбор rPr + skipElement(xr); + } + return new RunStyle(bold, italic, underline, strikeout, size, color, font, vertAlign); + } + + /** Три-state булева атрибута {@code @val}: absent — true, none/0/false — false. */ + static Boolean boolVal(XMLStreamReader xr) { + String v = XlsxPackage.attr(xr, "val"); + if (v == null) { + return Boolean.TRUE; + } + return !("0".equals(v) || "false".equalsIgnoreCase(v) || "none".equalsIgnoreCase(v)); + } + + /** Потребить элемент с текущей позиции (START) до его END. */ + static void skipElement(XMLStreamReader xr) throws XMLStreamException { + int depth = 1; + while (xr.hasNext() && depth > 0) { + int ev = xr.next(); + if (ev == XMLStreamConstants.START_ELEMENT) { + depth++; + } else if (ev == XMLStreamConstants.END_ELEMENT) { + depth--; + } + } + } +} diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/SheetModel.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/SheetModel.java new file mode 100644 index 0000000..e3a7c50 --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/SheetModel.java @@ -0,0 +1,503 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import javax.xml.stream.XMLStreamConstants; +import javax.xml.stream.XMLStreamException; +import javax.xml.stream.XMLStreamReader; +import java.io.ByteArrayInputStream; +import java.io.IOException; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; +import java.util.TreeMap; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +/** + * One worksheet part (§18.3.1): структура листа целиком — колонки/строки/ + * ячейки, merge'ы, внешние гиперссылки, ручные разрывы строк, page setup и + * ссылки на drawing/OLE. Разбор StAX; любые не разобранные части — + * «пустой лист»/игнор по деградационному контракту моста. + * + *

Ячейка хранится СЫРОЙ строкой {@code v}/{@code is} + типом {@code @t}: + * форматирование чисел/дат — {@link NumberFormats} на этапе эмитта (формула + * без кэша {@code } — пустая ячейка + warn).

+ */ +final class SheetModel { + + /** Колонка {@code cols/col} (range развёрнут по индексам). */ + record ColDef(Double width, boolean hidden, Integer style) { + } + + /** Ячейка {@code c} (§18.3.1.4): сырое значение, rich-раны, тип, индекс xf. */ + record CellData(String raw, List runs, String type, Integer styleIdx) { + } + + /** Строка {@code row} (§18.3.1.73): индекс 1-based {@code @r} → данные. */ + record RowData(Double ht, boolean customHeight, boolean hidden, Integer styleIdx, + boolean customFormat, Map cells) { + + /** Стиль строки, применяемый к ячейкам без своего (только при {@code @customFormat}). */ + Integer effectiveStyle() { + return customFormat ? styleIdx : null; + } + } + + /** Прямоугольник merge'а (§18.3.1.54), индексы 0-based включительно. */ + record Merge(int row1, int row2, int col1, int col2) { + } + + /** {@code pageSetup} (§18.3.1.63) + {@code pageSetUpPr/@fitToPage}. */ + record PageSetup(int paperSize, boolean landscape, int scale, int fitToWidth, + int fitToHeight, boolean fitToPage) { + } + + /** {@code pageMargins} в дюймах (§18.3.1.67). */ + record Margins(double left, double right, double top, double bottom, + double header, double footer) { + } + + private static final Logger LOG = LoggerFactory.getLogger(SheetModel.class); + private static final String REL_NS = + "http://schemas.openxmlformats.org/officeDocument/2006/relationships"; + private static final String HYPERLINK_REL_TYPE = + "http://schemas.openxmlformats.org/officeDocument/2006/relationships/hyperlink"; + /** Дефициты pageMargins по §18.3.1.67. */ + private static final double DEF_MARGIN_LR = 0.7; + private static final double DEF_MARGIN_TB = 0.75; + private static final double DEF_MARGIN_HF = 0.3; + /** Дефолт sheetFormatPr/@defaultRowHeight (pt) и @baseColWidth (знаков). */ + private static final double DEF_ROW_HEIGHT = 15.0; + private static final double DEF_BASE_COL_WIDTH = 8.0; + + private final TreeMap rows = new TreeMap<>(); + private final Map cols = new HashMap<>(); + private final List merges = new ArrayList<>(); + private final Map externalLinks = new HashMap<>(); + private final List rowBreaks = new ArrayList<>(); + private double defaultRowHeight = DEF_ROW_HEIGHT; + private double baseColWidth = DEF_BASE_COL_WIDTH; + private PageSetup pageSetup = new PageSetup(9, false, 100, 1, 1, false); + private Margins margins = new Margins(DEF_MARGIN_LR, DEF_MARGIN_LR, + DEF_MARGIN_TB, DEF_MARGIN_TB, DEF_MARGIN_HF, DEF_MARGIN_HF); + private String drawingPath; + private boolean olePresent; + /** Максимальный использованный индекс колонки+1 (0 — ячеек нет). */ + private int usedCols; + + private SheetModel() { + } + + TreeMap rows() { + return rows; + } + + Map cols() { + return cols; + } + + List merges() { + return merges; + } + + Map externalLinks() { + return externalLinks; + } + + List rowBreaks() { + return rowBreaks; + } + + double defaultRowHeight() { + return defaultRowHeight; + } + + double baseColWidth() { + return baseColWidth; + } + + PageSetup pageSetup() { + return pageSetup; + } + + Margins margins() { + return margins; + } + + String drawingPath() { + return drawingPath; + } + + boolean olePresent() { + return olePresent; + } + + int usedCols() { + return usedCols; + } + + ColDef col(int index) { + return cols.get(index); + } + + /** Стиль колонки (индекс xf) или null. */ + Integer colStyle(int index) { + ColDef c = cols.get(index); + return c == null ? null : c.style(); + } + + static SheetModel read(XlsxPackage pkg, WorkbookModel.Sheet sheet, WarnOnce warn) + throws IOException { + byte[] data = pkg.entry(sheet.partPath()); + SheetModel model = new SheetModel(); + if (data == null) { + warn.warn(LOG, "Часть листа {} отсутствует — пустой лист", sheet.partPath()); + return model; + } + Map sheetLinks = hyperlinkTargets(pkg, sheet.partPath()); + try { + XMLStreamReader xr = XlsxPackage.newSecureReader() + .createXMLStreamReader(new ByteArrayInputStream(data)); + model.parse(xr, sheetLinks, warn, pkg, sheet.partPath()); + xr.close(); + } catch (XMLStreamException e) { + throw new IOException("Не удалось разобрать часть листа " + sheet.partPath(), e); + } + return model; + } + + /** ref ячейки → внешний target гиперссылки (rel part-листа). */ + private static Map hyperlinkTargets(XlsxPackage pkg, String sheetPart) { + Map byId = new HashMap<>(); + for (XlsxPackage.Rel rel : pkg.rels(sheetPart)) { + if (HYPERLINK_REL_TYPE.equals(rel.type()) && rel.external()) { + byId.putIfAbsent(rel.id(), rel.target()); + } + } + return byId; + } + + private void parse(XMLStreamReader xr, Map sheetLinks, WarnOnce warn, + XlsxPackage pkg, String sheetPart) throws XMLStreamException { + boolean rootOpen = false; + while (!rootOpen && xr.hasNext()) { + // до START корня worksheet + rootOpen = xr.next() == XMLStreamConstants.START_ELEMENT; + } + // корень уже открыт — диспатчим только его детей (иначе default-skip + // проглотит весь документ) + while (xr.hasNext()) { + if (xr.next() != XMLStreamConstants.START_ELEMENT) { + continue; + } + switch (xr.getLocalName()) { + case "sheetPr" -> parseSheetPr(xr); + case "sheetFormatPr" -> parseSheetFormatPr(xr); + case "cols" -> parseCols(xr, warn); + case "sheetData" -> parseSheetData(xr, warn); + case "mergeCells" -> parseMergeCells(xr); + case "hyperlinks" -> parseHyperlinks(xr, sheetLinks); + case "drawing" -> { + String rid = XlsxPackage.attrNs(xr, REL_NS, "id"); + drawingPath = rid == null ? null : pkg.relTargetPath(sheetPart, rid); + } + case "rowBreaks" -> parseRowBreaks(xr); + case "pageMargins" -> parsePageMargins(xr); + case "pageSetup" -> parsePageSetup(xr); + case "printOptions" -> parsePrintOptions(xr, warn); + case "legacyDrawing", "legacyDrawingHF", "oleObjects", "controls" -> + olePresent = true; + default -> SharedStrings.skipElement(xr); + } + } + } + + private void parseSheetPr(XMLStreamReader xr) throws XMLStreamException { + while (xr.hasNext()) { + int ev = xr.next(); + if (ev == XMLStreamConstants.END_ELEMENT) { + break; + } + if (ev == XMLStreamConstants.START_ELEMENT && "pageSetUpPr".equals(xr.getLocalName())) { + boolean fit = XlsxPackage.truthy(XlsxPackage.attr(xr, "fitToPage")); + pageSetup = new PageSetup(pageSetup.paperSize(), pageSetup.landscape(), + pageSetup.scale(), pageSetup.fitToWidth(), pageSetup.fitToHeight(), fit); + SharedStrings.skipElement(xr); + } else if (ev == XMLStreamConstants.START_ELEMENT) { + SharedStrings.skipElement(xr); + } + } + } + + private void parseSheetFormatPr(XMLStreamReader xr) { + Double h = ColorSpec.parseDouble(XlsxPackage.attr(xr, "defaultRowHeight")); + if (h != null && h > 0) { + defaultRowHeight = h; + } + Double b = ColorSpec.parseDouble(XlsxPackage.attr(xr, "baseColWidth")); + if (b != null && b > 0) { + baseColWidth = b; + } + } + + private void parseCols(XMLStreamReader xr, WarnOnce warn) throws XMLStreamException { + while (xr.hasNext()) { + int ev = xr.next(); + if (ev == XMLStreamConstants.END_ELEMENT) { + break; + } + if (ev != XMLStreamConstants.START_ELEMENT || !"col".equals(xr.getLocalName())) { + continue; + } + Integer min = ColorSpec.parseInt(XlsxPackage.attr(xr, "min")); + Integer max = ColorSpec.parseInt(XlsxPackage.attr(xr, "max")); + Double width = ColorSpec.parseDouble(XlsxPackage.attr(xr, "width")); + boolean hidden = XlsxPackage.truthy(XlsxPackage.attr(xr, "hidden")); + Integer style = ColorSpec.parseInt(XlsxPackage.attr(xr, "style")); + SharedStrings.skipElement(xr); // листок col доедает свой END + if (min == null || min < 1) { + continue; + } + int hi = max == null || max < min ? min : max; + ColDef def = new ColDef(width, hidden, style); + for (int i = min - 1; i < hi; i++) { + // пересечение записей col — первая выигрывает (Excel пишет + // непересекающиеся; пересечение — брак генератора) + if (cols.putIfAbsent(i, def) == null) { + continue; + } + warn.warn(LOG, "Перекрывающаяся запись col для индекса {} — первая выигрывает", i); + } + } + } + + private void parseSheetData(XMLStreamReader xr, WarnOnce warn) throws XMLStreamException { + while (xr.hasNext()) { + int ev = xr.next(); + if (ev == XMLStreamConstants.END_ELEMENT) { + break; + } + if (ev != XMLStreamConstants.START_ELEMENT || !"row".equals(xr.getLocalName())) { + continue; + } + Integer r = ColorSpec.parseInt(XlsxPackage.attr(xr, "r")); + if (r == null || r < 1) { + // строку обязан доедать skipElement: иначе её END оборвёт + // разбор всего sheetData по break ниже + SharedStrings.skipElement(xr); + continue; + } + Double ht = ColorSpec.parseDouble(XlsxPackage.attr(xr, "ht")); + boolean customHeight = XlsxPackage.truthy(XlsxPackage.attr(xr, "customHeight")); + boolean hidden = XlsxPackage.truthy(XlsxPackage.attr(xr, "hidden")); + Integer rowStyle = ColorSpec.parseInt(XlsxPackage.attr(xr, "s")); + boolean customFormat = XlsxPackage.truthy(XlsxPackage.attr(xr, "customFormat")); + Map cells = new HashMap<>(); + parseCells(xr, cells, warn); + rows.put(r, new RowData(ht, customHeight, hidden, rowStyle, customFormat, cells)); + } + } + + /** Дочерние {@code c} текущей {@code row}; вызов на START row, выход на END row. */ + private void parseCells(XMLStreamReader xr, Map cells, WarnOnce warn) + throws XMLStreamException { + while (xr.hasNext()) { + int ev = xr.next(); + if (ev == XMLStreamConstants.END_ELEMENT) { + break; + } + if (ev != XMLStreamConstants.START_ELEMENT || !"c".equals(xr.getLocalName())) { + continue; + } + String ref = XlsxPackage.attr(xr, "r"); + Integer style = ColorSpec.parseInt(XlsxPackage.attr(xr, "s")); + String type = XlsxPackage.attr(xr, "t"); + int[] rc = parseRef(ref); + int col = rc.length == 0 ? cells.size() : rc[1]; + CellData cell = readCell(xr, type, style, warn); + cells.put(col, cell); + usedCols = Math.max(usedCols, col + 1); + } + } + + /** Дети ячейки: v/is/f — вызов на START c. */ + private CellData readCell(XMLStreamReader xr, String type, Integer style, WarnOnce warn) + throws XMLStreamException { + String v = null; + List runs = null; + boolean hasFormula = false; + while (xr.hasNext()) { + int ev = xr.next(); + if (ev == XMLStreamConstants.END_ELEMENT) { + break; + } + if (ev != XMLStreamConstants.START_ELEMENT) { + continue; + } + switch (xr.getLocalName()) { + case "v" -> v = xr.getElementText(); + case "is" -> runs = SharedStrings.parseRst(xr, warn); + case "f" -> { + hasFormula = true; + SharedStrings.skipElement(xr); + } + default -> SharedStrings.skipElement(xr); // r (formula2) — игнор + } + } + if (v == null && runs == null && hasFormula) { + warn.warn(LOG, "Формула без кэшированного значения — пустая ячейка"); + } + return new CellData(v, runs, type, style); + } + + private void parseMergeCells(XMLStreamReader xr) throws XMLStreamException { + while (xr.hasNext()) { + int ev = xr.next(); + if (ev == XMLStreamConstants.END_ELEMENT) { + break; + } + if (ev == XMLStreamConstants.START_ELEMENT + && "mergeCell".equals(xr.getLocalName())) { + String ref = XlsxPackage.attr(xr, "ref"); + SharedStrings.skipElement(xr); + int[] range = parseRange(ref); + if (range.length > 0) { + merges.add(new Merge(range[0], range[2], range[1], range[3])); + } + } + } + } + + private void parseHyperlinks(XMLStreamReader xr, Map sheetLinks) + throws XMLStreamException { + while (xr.hasNext()) { + int ev = xr.next(); + if (ev == XMLStreamConstants.END_ELEMENT) { + break; + } + if (ev != XMLStreamConstants.START_ELEMENT + || !"hyperlink".equals(xr.getLocalName())) { + continue; + } + String ref = XlsxPackage.attr(xr, "ref"); + String rid = XlsxPackage.attrNs(xr, REL_NS, "id"); + SharedStrings.skipElement(xr); + // @location (внутренний переход) — бросается без warn: PDF-ссылок + // внутри документа мост не эмитит (деградация v1) + if (ref != null && rid != null) { + String target = sheetLinks.get(rid); + if (target != null) { + externalLinks.put(ref, target); + } + } + } + } + + /** id ручных разрывов строк (1-based, семантика — см. SheetToTable). */ + private void parseRowBreaks(XMLStreamReader xr) throws XMLStreamException { + while (xr.hasNext()) { + int ev = xr.next(); + if (ev == XMLStreamConstants.END_ELEMENT) { + break; + } + if (ev == XMLStreamConstants.START_ELEMENT && "brk".equals(xr.getLocalName())) { + String man = XlsxPackage.attr(xr, "man"); + Integer id = ColorSpec.parseInt(XlsxPackage.attr(xr, "id")); + SharedStrings.skipElement(xr); + // man absent/truthy — ручной; id — 1-based номер строки, после + // которой разрыв (POI setRowBreak(11) → id=12, фикстура xlsx-wide) + if (id != null && id >= 1 + && !"0".equals(man) && !"false".equalsIgnoreCase(man)) { + rowBreaks.add(id); + } + } + } + } + + private void parsePageMargins(XMLStreamReader xr) { + Double left = ColorSpec.parseDouble(XlsxPackage.attr(xr, "left")); + Double right = ColorSpec.parseDouble(XlsxPackage.attr(xr, "right")); + Double top = ColorSpec.parseDouble(XlsxPackage.attr(xr, "top")); + Double bottom = ColorSpec.parseDouble(XlsxPackage.attr(xr, "bottom")); + Double header = ColorSpec.parseDouble(XlsxPackage.attr(xr, "header")); + Double footer = ColorSpec.parseDouble(XlsxPackage.attr(xr, "footer")); + margins = new Margins( + left == null ? DEF_MARGIN_LR : left, + right == null ? DEF_MARGIN_LR : right, + top == null ? DEF_MARGIN_TB : top, + bottom == null ? DEF_MARGIN_TB : bottom, + header == null ? DEF_MARGIN_HF : header, + footer == null ? DEF_MARGIN_HF : footer); + } + + private void parsePageSetup(XMLStreamReader xr) { + Integer paper = ColorSpec.parseInt(XlsxPackage.attr(xr, "paperSize")); + boolean landscape = "landscape".equals(XlsxPackage.attr(xr, "orientation")); + Integer scale = ColorSpec.parseInt(XlsxPackage.attr(xr, "scale")); + Integer fitW = ColorSpec.parseInt(XlsxPackage.attr(xr, "fitToWidth")); + Integer fitH = ColorSpec.parseInt(XlsxPackage.attr(xr, "fitToHeight")); + pageSetup = new PageSetup(paper == null ? 9 : paper, landscape, + scale == null ? 100 : scale, + fitW == null ? 1 : fitW, fitH == null ? 1 : fitH, pageSetup.fitToPage()); + } + + private void parsePrintOptions(XMLStreamReader xr, WarnOnce warn) { + if (XlsxPackage.truthy(XlsxPackage.attr(xr, "horizontalCentered")) + && !"0".equals(XlsxPackage.attr(xr, "horizontalCentered"))) { + warn.warn(LOG, "horizontalCentered игнорируется (центрирование страниц в v1 не эмитится)"); + } + if (XlsxPackage.truthy(XlsxPackage.attr(xr, "verticalCentered")) + && !"0".equals(XlsxPackage.attr(xr, "verticalCentered"))) { + warn.warn(LOG, "verticalCentered игнорируется"); + } + if (XlsxPackage.truthy(XlsxPackage.attr(xr, "gridLines")) + && !"0".equals(XlsxPackage.attr(xr, "gridLines"))) { + warn.warn(LOG, "gridLines при печати игнорируется (сетка ячеек не рисуется)"); + } + } + + /** + * ref ячейки/якоря {@code "AB12"} → {row, col} (0-based); битый ref — + * пустой массив (PMD: null-массивов нет). + */ + static int[] parseRef(String ref) { + if (ref == null || ref.isEmpty()) { + return new int[0]; + } + int letters = 0; + while (letters < ref.length() && Character.isLetter(ref.charAt(letters))) { + letters++; + } + if (letters == 0 || letters == ref.length()) { + return new int[0]; + } + int col = 0; + for (int i = 0; i < letters; i++) { + col = col * 26 + Character.toUpperCase(ref.charAt(i)) - 'A' + 1; + } + Integer row = ColorSpec.parseInt(ref.substring(letters)); + if (row == null || row < 1) { + return new int[0]; + } + return new int[] {row - 1, col - 1}; + } + + /** Диапазон {@code "B2:D2"} → {r1,c1,r2,c2} (0-based); битый — пустой массив. */ + static int[] parseRange(String range) { + if (range == null || range.isEmpty()) { + return new int[0]; + } + String[] parts = range.split(":"); + int[] a = parseRef(parts[0].trim()); + if (a.length == 0) { + return new int[0]; + } + int[] b = parts.length > 1 ? parseRef(parts[1].trim()) : a; + if (b.length == 0) { + b = a; + } + return new int[] {Math.min(a[0], b[0]), Math.min(a[1], b[1]), + Math.max(a[0], b[0]), Math.max(a[1], b[1])}; + } +} diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/SheetToTable.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/SheetToTable.java new file mode 100644 index 0000000..beba11d --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/SheetToTable.java @@ -0,0 +1,566 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import java.util.ArrayList; +import java.util.LinkedHashSet; +import java.util.List; +import java.util.Map; + +import ru.pjandro.wordpdf.internal.DocxPackageWriter; + +/** + * Эмитт листа в Word-таблицу фиксированной сетки: одна {@code w:tbl} на лист + * (каркас v1 — шаг 4: значения, шрифт, jc, merge, скрытые строки/столбцы, + * внешние гиперссылки; границы/заливки/цвета/numFmt/vAlign/indent — шаг 5, + * нарезка на срезы и секции — шаг 6). + * + *

Разрывы строк {@code rowBreaks/@id}: семантика Excel — id это 1-based + * номер строки, ПОСЛЕ которой печатная страница обрывается (POI + * {@code setRowBreak(11)} пишет {@code id="12"}; фикстура xlsx-wide, + * регрессия — XlsxPdfConverterTest#rowBreak_pages). Резку выполняет + * планировщик блоков шага 6.

+ */ +final class SheetToTable { + + /** Роль ячейки в merge-прямоугольнике. */ + private enum MergeRole { NONE, ORIGIN, H_CONT, V_CONT } + + /** Дефолт CT_Font/@sz при отсутствии таблицы шрифтов. */ + private static final double DEFAULT_SIZE_PT = 11.0; + + /** gridSpan одиночной ячейки не эмитится (§17.4.76: по умолчанию 1). */ + private static final int SINGLE_CELL_SPAN = 1; + + private SheetToTable() { + } + + /** + * Блоки {@code } для листа: по одному {@code w:tbl} на печатный + * блок (срез колонок × вертикальный фрагмент {@code rowBreaks}'ов, план — + * {@link PrintLayout#plan}); пустой блок — пустая строка (его секция даст + * свою страницу). Рисунки — шаг 7. + * + * @param page страница листа (размер/поля уже после ориентации) + * @param drawings рисунки по ячейкам ({@code (row1 << 32) | col}); + * употреблённые изымаются — вызывающий доемает остаток + * @param hyperlinks дедуплицированный порядок targets внешних ссылок + * (id {@code hl0…} = позиция множества) + */ + static List emit(SheetModel sheet, StylesModel styles, SharedStrings sst, + WorkbookModel wb, Metrics metrics, NumberFormats numfmt, ColorResolver colors, + PrintLayout.Page page, Map> drawings, + List parts, + LinkedHashSet hyperlinks, WarnOnce warn) { + PrintLayout.Plan plan = PrintLayout.plan(sheet, metrics, page, warn); + List blocks = new ArrayList<>(); + for (PrintLayout.Block block : plan.blocks()) { + blocks.add(emitBlock(sheet, styles, sst, metrics, numfmt, colors, + plan.widthScale(), block, drawings, hyperlinks, warn)); + } + return blocks; + } + + private static String emitBlock(SheetModel sheet, StylesModel styles, SharedStrings sst, + Metrics metrics, NumberFormats numfmt, ColorResolver colors, + double widthScale, PrintLayout.Block block, Map> drawings, + LinkedHashSet hyperlinks, WarnOnce warn) { + List visibleCols = block.cols(); + StringBuilder xml = new StringBuilder(); + xml.append("") + .append(""); + for (int c : visibleCols) { + xml.append(""); + } + xml.append(""); + int emittedRows = 0; + for (var e : sheet.rows().entrySet()) { + if (e.getKey() < block.rowFrom() || e.getKey() > block.rowTo()) { + continue; + } + SheetModel.RowData row = e.getValue(); + if (row.hidden()) { + continue; + } + if (!isSignificant(sheet, row, e.getKey())) { + continue; + } + emitRow(xml, e.getKey(), row, sheet, styles, sst, metrics, numfmt, colors, + widthScale, drawings, visibleCols, hyperlinks, warn); + emittedRows++; + } + if (emittedRows == 0) { + return ""; + } + xml.append(""); + return xml.toString(); + } + + private static int colTwips(SheetModel sheet, Metrics metrics, int col, double widthScale) { + return (int) Math.round(PrintLayout.colTwips(sheet, metrics, col) * widthScale); + } + + /** Строку эмитим, когда в ней есть значение, стиль (s≠0) или merge. */ + private static boolean isSignificant(SheetModel sheet, SheetModel.RowData row, int rowNum1) { + if (row.styleIdx() != null && row.styleIdx() > 0) { + return true; + } + for (var c : row.cells().values()) { + if (c.raw() != null || c.runs() != null + || (c.styleIdx() != null && c.styleIdx() > 0)) { + return true; + } + } + int r = rowNum1 - 1; + for (SheetModel.Merge m : sheet.merges()) { + if (r >= m.row1() && r <= m.row2()) { + return true; + } + } + return false; + } + + private static void emitRow(StringBuilder xml, int rowNum1, SheetModel.RowData row, + SheetModel sheet, StylesModel styles, SharedStrings sst, Metrics metrics, + NumberFormats numfmt, ColorResolver colors, double widthScale, + Map> drawings, + List visibleCols, LinkedHashSet hyperlinks, WarnOnce warn) { + int r = rowNum1 - 1; + xml.append(""); + for (int c : visibleCols) { + MergeRole role = mergeRole(sheet, r, c); + switch (role) { + case V_CONT -> xml.append(""); + case H_CONT -> xml.append(""); + default -> emitCell(xml, r, c, row, role, sheet, styles, sst, metrics, + numfmt, colors, widthScale, drawings, visibleCols, hyperlinks, warn); + } + } + xml.append(""); + } + + /** Высота строки exact (Excel печатает фиксированную сетку). */ + private static int trHeightTwips(SheetModel.RowData row, SheetModel sheet) { + double pt = row.ht() == null ? sheet.defaultRowHeight() : row.ht(); + return Metrics.ptToTwips(pt); + } + + /** + * ORIGIN — первая видимая колонка диапазона; при скрытой origin-строке/ + * колонке контент доезжает до первой видимой ячейки диапазона (план). + * H_CONT — продолжение по горизонтали (пустая {@code w:tc}), + * V_CONT — продолжение по вертикали ({@code w:vMerge}). + */ + private static MergeRole mergeRole(SheetModel sheet, int r, int c) { + for (SheetModel.Merge m : sheet.merges()) { + if (r < m.row1() || r > m.row2() || c < m.col1() || c > m.col2()) { + continue; + } + boolean firstVisibleCol = firstVisibleColOf(sheet, m) == c; + boolean originRow = verticalOriginRow(sheet, m) == r; + if (firstVisibleCol && originRow) { + return MergeRole.ORIGIN; + } + return originRow ? MergeRole.H_CONT : MergeRole.V_CONT; + } + return MergeRole.NONE; + } + + private static int firstVisibleColOf(SheetModel sheet, SheetModel.Merge m) { + for (int c = m.col1(); c <= m.col2(); c++) { + SheetModel.ColDef def = sheet.col(c); + if (def == null || !def.hidden()) { + return c; + } + } + return m.col1(); + } + + /** Первая видимая строка диапазона (все скрытые — формально первая). */ + private static int verticalOriginRow(SheetModel sheet, SheetModel.Merge m) { + for (int r = m.row1(); r <= m.row2(); r++) { + SheetModel.RowData row = sheet.rows().get(r + 1); + if (row == null || !row.hidden()) { + return r; + } + } + return m.row1(); + } + + private static void emitCell(StringBuilder xml, int r, int c, SheetModel.RowData row, + MergeRole role, SheetModel sheet, StylesModel styles, SharedStrings sst, + Metrics metrics, NumberFormats numfmt, ColorResolver colors, double widthScale, + Map> drawings, + List visibleCols, LinkedHashSet hyperlinks, + WarnOnce warn) { + xml.append(""); + SheetModel.Merge merge = role == MergeRole.ORIGIN ? sheetMergeAt(sheet, r, c) : null; + if (merge != null) { + int span = gridSpan(merge, visibleCols); + if (span != SINGLE_CELL_SPAN) { + xml.append(""); + } + if (merge.row2() > merge.row1()) { + xml.append(""); + } + } + // стиль — физической ячейки позиции (редирект контента стиль не переносит) + int styleIdx = resolveStyle(row.cells().get(c), row, sheet, c); + StylesModel.CellXf xf = styles.xf(styleIdx); + appendTcBorders(xml, styles, xf, colors); + appendShd(xml, styles, xf, colors); + appendVAlign(xml, xf); + xml.append(""); + SheetModel.CellData cell = contentCell(sheet, row, r, c, merge); + String linkId = hyperlinkId(sheet, r, c, hyperlinks); + emitParagraph(xml, cell, xf, linkId, styles, sst, metrics, numfmt, colors, warn); + List runs = drawings.remove((long) (r + 1) << 32 | c & 0xFFFF_FFFFL); + if (runs != null) { + xml.append("").append(String.join("", runs)).append(""); + } + xml.append(""); + } + + /** + * Содержимое ячейки: при редиректе origin'а (скрытая строка/колонка) — + * значение из фактической origin-клетки диапазона. + */ + private static SheetModel.CellData contentCell(SheetModel sheet, SheetModel.RowData row, + int r, int c, SheetModel.Merge merge) { + SheetModel.CellData own = row.cells().get(c); + if (merge == null || (r == merge.row1() && c == merge.col1()) + || (own != null && hasContent(own))) { + return own; + } + // видимая клетка диапазона пуста ИЛИ отсутствует вовсе (в .xlsx + // неписаная клетка — норма) — тянем контент из фактического origin + SheetModel.RowData originRow = sheet.rows().get(merge.row1() + 1); + if (originRow == null) { + return own; + } + SheetModel.CellData origin = originRow.cells().get(merge.col1()); + return origin != null && hasContent(origin) ? origin : own; + } + + private static boolean hasContent(SheetModel.CellData cell) { + return cell.raw() != null || cell.runs() != null; + } + + private static SheetModel.Merge sheetMergeAt(SheetModel sheet, int r, int c) { + for (SheetModel.Merge m : sheet.merges()) { + if (r >= m.row1() && r <= m.row2() && c >= m.col1() && c <= m.col2()) { + return m; + } + } + return null; + } + + /** Число видимых колонок диапазона. */ + private static int gridSpan(SheetModel.Merge m, List visibleCols) { + int span = 0; + for (int c : visibleCols) { + if (c >= m.col1() && c <= m.col2()) { + span++; + } + } + return Math.max(1, span); + } + + /** cell s → row s (@customFormat) → col s → 0. */ + private static int resolveStyle(SheetModel.CellData cell, SheetModel.RowData row, + SheetModel sheet, int c) { + if (cell != null && cell.styleIdx() != null) { + return cell.styleIdx(); + } + Integer rowStyle = row.effectiveStyle(); + if (rowStyle != null) { + return rowStyle; + } + Integer colStyle = sheet.colStyle(c); + return colStyle == null ? 0 : colStyle; + } + + /** {@code hlN} для ячейки внутри диапазона внешней ссылки (dedup по target). */ + private static String hyperlinkId(SheetModel sheet, int r, int c, + LinkedHashSet hyperlinks) { + for (var e : sheet.externalLinks().entrySet()) { + int[] range = SheetModel.parseRange(e.getKey()); + if (range.length < 4 || r < range[0] || r > range[2] || c < range[1] || c > range[3]) { + continue; + } + hyperlinks.add(e.getValue()); + return "hl" + indexOf(hyperlinks, e.getValue()); + } + return null; + } + + private static int indexOf(LinkedHashSet set, String value) { + int i = 0; + for (String v : set) { + if (v.equals(value)) { + return i; + } + i++; + } + return -1; + } + + /** Абзац ячейки: pPr (spacing/ind/jc) + раны (rich или один по стилю ячейки). */ + private static void emitParagraph(StringBuilder xml, SheetModel.CellData cell, + StylesModel.CellXf xf, String linkId, StylesModel styles, SharedStrings sst, + Metrics metrics, NumberFormats numfmt, ColorResolver colors, WarnOnce warn) { + xml.append("") + .append(""); + appendIndent(xml, xf, metrics); + appendJc(xml, xf.horizontal()); + xml.append(""); + if (linkId != null) { + xml.append(""); + } + List runs = cellRuns(cell, sst, warn); + if (runs.isEmpty()) { + String text = plainText(cell, xf.numFmtId(), numfmt, warn); + if (!text.isEmpty() || linkId != null) { + emitRun(xml, text, null, xf, styles, colors); + } + } else { + for (SharedStrings.Run run : runs) { + emitRun(xml, run.text(), run.style(), xf, styles, colors); + } + } + if (linkId != null) { + xml.append(""); + } + xml.append(""); + } + + /** + * Excel-отступ: 1 единица ≈ три пробела дефолтного шрифта (≈ 3 MDW), + * в twips. + */ + private static void appendIndent(StringBuilder xml, StylesModel.CellXf xf, Metrics metrics) { + if (xf.indent() <= 0) { + return; + } + int twips = Metrics.pxToTwips(3 * xf.indent() * metrics.mdw()); + if (twips > 0) { + xml.append(""); + } + } + + /** {@code w:tcBorders}: только four-side (диагонали Word-ячейке чужие). */ + private static void appendTcBorders(StringBuilder xml, StylesModel styles, + StylesModel.CellXf xf, ColorResolver colors) { + StylesModel.BorderDef b = styles.border(xf.borderId()); + if (b == null) { + return; + } + StringBuilder inner = new StringBuilder(); + appendBorderSide(inner, "top", b.top(), colors); + appendBorderSide(inner, "left", b.left(), colors); + appendBorderSide(inner, "bottom", b.bottom(), colors); + appendBorderSide(inner, "right", b.right(), colors); + if (inner.length() > 0) { + xml.append("").append(inner).append(""); + } + } + + /** + * Excel-стиль границы → Word: thin — минимальная линия (single = 0.5pt, + * Excel thin ≈ 1px), hair — 0.25pt, остальные по имени; sz в восьмых + * долях пункта (§17.3.1.7). + */ + private static void appendBorderSide(StringBuilder xml, String side, + StylesModel.BorderSide bs, ColorResolver colors) { + if (bs == null || bs.style() == null || "none".equals(bs.style())) { + return; + } + String[] valSz = switch (bs.style()) { + case "hair" -> new String[] {"single", "2"}; + case "thin" -> new String[] {"single", "4"}; + case "double" -> new String[] {"double", "6"}; + case "medium" -> new String[] {"medium", "12"}; + case "thick" -> new String[] {"thick", "18"}; + case "dotted" -> new String[] {"dotted", "4"}; + case "dashed" -> new String[] {"dashed", "4"}; + case "dashDot" -> new String[] {"dashDot", "4"}; + case "dashDotDot" -> new String[] {"dashDotDot", "4"}; + case "mediumDashed" -> new String[] {"mediumDashed", "12"}; + case "mediumDashDot" -> new String[] {"mediumDashDot", "12"}; + case "mediumDashDotDot" -> new String[] {"mediumDashDotDot", "12"}; + case "slantDashDot" -> new String[] {"dashDot", "4"}; + default -> null; + }; + if (valSz == null) { + return; + } + String rgb = colors.resolve(bs.color()); + xml.append(""); + } + + /** + * Заливка: Word знает только solid-эффект, поэтому любой Excel-паттерн + * (кроме none/gray125 — визуального шума) рисуется его fgColor как + * сплошной; серый 12.5% без цвета — деградация «без заливы». + */ + private static void appendShd(StringBuilder xml, StylesModel styles, + StylesModel.CellXf xf, ColorResolver colors) { + StylesModel.FillDef fill = styles.fill(xf.fillId()); + if (fill == null || fill.patternType() == null + || "none".equals(fill.patternType()) || "gray125".equals(fill.patternType())) { + return; + } + String rgb = colors.resolve(fill.fgColor()); + if (rgb != null) { + xml.append(""); + } + } + + /** vertical Excel-дефолт — bottom (§18.8.45), Word-дефолт — top. */ + private static void appendVAlign(StringBuilder xml, StylesModel.CellXf xf) { + String v = switch (xf.vertical() == null ? "bottom" : xf.vertical()) { + case "top" -> "top"; + case "center" -> "center"; + case "justify", "distributed" -> "both"; + default -> "bottom"; + }; + xml.append(""); + } + + /** Excel-горизонталь → Word jc (§18.8.1 + деградации distributed/distribute). */ + private static void appendJc(StringBuilder xml, String horizontal) { + String jc = switch (horizontal == null ? "" : horizontal) { + case "center", "centerContinuous" -> "center"; + case "right" -> "right"; + case "fill", "justify" -> "both"; + case "distributed" -> "distribute"; + default -> null; + }; + if (jc != null) { + xml.append(""); + } + } + + private static List cellRuns(SheetModel.CellData cell, + SharedStrings sst, WarnOnce warn) { + if (cell == null) { + return List.of(); + } + String type = cell.type(); + switch (type == null ? "" : type) { + case "inlineStr": + return cell.runs() == null ? List.of() : cell.runs(); + case "s": { + Integer idx = cell.raw() == null ? null : ColorSpec.parseInt(cell.raw().trim()); + return idx == null ? List.of() : sst.at(idx, warn); + } + default: + return List.of(); + } + } + + /** + * Текст не-rich ячейки: число с форматным кодом — через + * {@link NumberFormats}; boolean/ошибка/кэш-формулы/General — + * {@link NumberText}. + */ + private static String plainText(SheetModel.CellData cell, int numFmtId, + NumberFormats numfmt, WarnOnce warn) { + if (cell == null || cell.raw() == null) { + return ""; + } + String type = cell.type(); + boolean numeric = type == null || "n".equals(type); + if (numeric && numFmtId != 0) { + return numfmt.format(numFmtId, cell.raw(), warn); + } + return NumberText.of(cell.raw(), type); + } + + /** + * Один {@code w:r}: rFonts/sz/цвет из шрифта ячейки (переопределения + * rich-рана приоритетны, включая посимвольный цвет rPr из sst). + */ + private static void emitRun(StringBuilder xml, String text, SharedStrings.RunStyle style, + StylesModel.CellXf xf, StylesModel styles, ColorResolver colors) { + StylesModel.FontDef base = styles.font(xf.fontId()); + String family = style != null && style.fontName() != null ? style.fontName() + : base == null || base.name() == null ? "Calibri" : base.name(); + boolean bold = (base != null && Boolean.TRUE.equals(base.bold())) + || style != null && Boolean.TRUE.equals(style.bold()); + boolean italic = (base != null && Boolean.TRUE.equals(base.italic())) + || style != null && Boolean.TRUE.equals(style.italic()); + boolean strikeout = (base != null && Boolean.TRUE.equals(base.strikeout())) + || style != null && Boolean.TRUE.equals(style.strikeout()); + boolean underline = style != null && style.underline() != null + || base != null && base.underline() != null; + double size = style != null && style.sizePt() != null ? style.sizePt() + : base == null || base.sizePt() == null ? DEFAULT_SIZE_PT : base.sizePt(); + xml.append(""); + appendRFonts(xml, family); + int half = (int) Math.ceil(size * 2); + xml.append("") + .append(""); + if (bold) { + xml.append(""); + } + if (italic) { + xml.append(""); + } + if (underline) { + xml.append(""); + } + if (strikeout) { + xml.append(""); + } + ColorSpec color = style != null && style.color() != null ? style.color() + : base == null ? null : base.color(); + String rgb = colors.resolve(color); + if (rgb != null) { + xml.append(""); + } + String vert = style == null ? null : style.vertAlign(); + if ("superscript".equals(vert) || "subscript".equals(vert)) { + xml.append(""); + } + xml.append("").append(escapeXml(text)).append(""); + } + + /** rFonts ascii/hAnsi/cs (Word определяет латиницу/кириллицу по hAnsi). */ + private static void appendRFonts(StringBuilder xml, String family) { + String esc = escapeXml(family); + xml.append(""); + } + + private static String escapeXml(String s) { + StringBuilder out = new StringBuilder(s.length() + 8); + for (int i = 0; i < s.length(); i++) { + char ch = s.charAt(i); + switch (ch) { + case '&' -> out.append("&"); + case '<' -> out.append("<"); + case '>' -> out.append(">"); + case '"' -> out.append("""); + default -> { + // управляющие XML 1.0 не допускает — вырезаем + if (ch >= 0x20 || ch == '\t' || ch == '\n' || ch == '\r') { + out.append(ch); + } + } + } + } + return out.toString(); + } +} diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/StylesModel.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/StylesModel.java new file mode 100644 index 0000000..4f40d83 --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/StylesModel.java @@ -0,0 +1,539 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import javax.xml.stream.XMLStreamConstants; +import javax.xml.stream.XMLStreamException; +import javax.xml.stream.XMLStreamReader; +import java.io.ByteArrayInputStream; +import java.io.IOException; +import java.util.ArrayList; +import java.util.List; +import java.util.Map; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +/** + * {@code xl/styles.xml} (ECMA-376 §18.8): таблицы {@code numFmts}, + * {@code fonts}, {@code fills}, {@code borders}, {@code cellStyleXfs} + + * {@code cellXfs}. Для каждого индекса {@code c/@s} заранее вычисляется + * эффективный формат {@link CellXf}: старт от базы {@code cellStyleXfs[xfId]} + * (base-first), поля cellXfs перекрывают базу по правилам apply*-флагов + * Excel: {@code applyX="1"} — берём значение cellXfs (даже отсутствующий + * атрибут = дефолт 0), {@code applyX="0"} — всегда база, флага нет — + * значение cellXfs, если атрибут задан явно, иначе база. + * + *

{@code dxfs} (§18.8.15) не парсятся: conditional formatting вне v1.

+ */ +final class StylesModel { + + /** Шрифт {@code fonts/font} (§18.8.23 CT_Font). */ + record FontDef(String name, String scheme, Double sizePt, Boolean bold, Boolean italic, + String underline, Boolean strikeout, ColorSpec color) { + } + + /** Заливка {@code fills/fill} (§18.8.32 CT_PatternFill). */ + record FillDef(String patternType, ColorSpec fgColor) { + } + + /** Одна сторона границы (§18.8.5 CT_Border). */ + record BorderSide(String style, ColorSpec color) { + } + + /** Граница {@code borders/border}; диагонали не эмитятся (Word-ячейка). */ + record BorderDef(BorderSide left, BorderSide right, BorderSide top, BorderSide bottom) { + } + + /** Эффективный формат ячейки (cellXfs[с], разрешённый через базу). */ + record CellXf(int numFmtId, int fontId, int fillId, int borderId, + String horizontal, String vertical, boolean wrapText, int indent) { + } + + private static final Logger LOG = LoggerFactory.getLogger(StylesModel.class); + private static final String STYLES_PART = "xl/styles.xml"; + /** Дефолт CT_Font/@sz. */ + private static final double DEFAULT_SIZE_PT = 11.0; + + private final List fonts; + private final List fills; + private final List borders; + private final List xfs; + /** {@code colors/indexedColors/rgbColor}: индекс 64+n. */ + private final List indexedColors; + /** {@code numFmts/numFmt}: numFmtId → formatCode (§18.8.31). */ + private final Map numFmts; + + private StylesModel(List fonts, List fills, List borders, + List xfs, List indexedColors, Map numFmts) { + this.numFmts = numFmts; + this.fonts = fonts; + this.fills = fills; + this.borders = borders; + this.xfs = xfs; + this.indexedColors = indexedColors; + } + + FontDef font(int index) { + return index >= 0 && index < fonts.size() ? fonts.get(index) : null; + } + + FillDef fill(int index) { + return index >= 0 && index < fills.size() ? fills.get(index) : null; + } + + BorderDef border(int index) { + return index >= 0 && index < borders.size() ? borders.get(index) : null; + } + + CellXf xf(int index) { + return index >= 0 && index < xfs.size() ? xfs.get(index) : xfs.get(0); + } + + int xfCount() { + return xfs.size(); + } + + /** Палитра {@code indexedColors} (может быть короче/пустой). */ + List indexedColors() { + return indexedColors; + } + + /** Кастомные форматные коды (§18.8.31); id ≥ 164. */ + Map customFormats() { + return numFmts; + } + + /** + * Семейство шрифта Normal-стиля (индекс 0 cellStyles) — для MDW в + * {@link Metrics}; имя (или scheme=minor при отсутствии имени). + */ + String normalFontName(ThemeModel theme) { + CellXf base = xfs.isEmpty() ? new CellXf(0, 0, 0, 0, null, null, false, 0) : xfs.get(0); + FontDef f = font(base.fontId()); + if (f != null && f.name() != null) { + return f.name(); + } + if (theme != null && theme.minorFont() != null) { + return theme.minorFont(); + } + return "Calibri"; + } + + static StylesModel read(XlsxPackage pkg, WarnOnce warn) throws IOException { + byte[] data = pkg.entry(STYLES_PART); + if (data == null) { + warn.warn(LOG, "В .xlsx нет xl/styles.xml — все ячейки дефолтным форматом"); + return new StylesModel(List.of(defaultFont()), List.of(noFill(), gray125()), + List.of(noBorder()), List.of(new CellXf(0, 0, 0, 0, null, null, false, 0)), + List.of(), Map.of()); + } + Parser p = new Parser(); + try { + XMLStreamReader xr = XlsxPackage.newSecureReader() + .createXMLStreamReader(new ByteArrayInputStream(data)); + p.parse(xr); + xr.close(); + } catch (XMLStreamException e) { + throw new IOException("Не удалось разобрать xl/styles.xml", e); + } + return p.build(); + } + + // ================== разбор ================== + + /** Промежуточное xf-сырьё (до разрешения базы). */ + private record RawXf(Integer numFmtId, Integer fontId, Integer fillId, Integer borderId, + Integer xfId, Boolean applyNumFmt, Boolean applyFont, Boolean applyFill, + Boolean applyBorder, Boolean applyAlignment, + String horizontal, String vertical, Boolean wrap, Integer indent) { + + /** Эффективный xf по правилу apply*-флагов (base-first). */ + CellXf resolve(RawXf base) { + int nf = pickNum(numFmtId, applyNumFmt, base == null ? null : base.numFmtId); + int fn = pickNum(fontId, applyFont, base == null ? null : base.fontId); + int fl = pickNum(fillId, applyFill, base == null ? null : base.fillId); + int bd = pickNum(borderId, applyBorder, base == null ? null : base.borderId); + String hz; + String vt; + boolean wr; + int ind; + if (Boolean.FALSE.equals(applyAlignment) && base != null) { + hz = base.horizontal; + vt = base.vertical; + wr = Boolean.TRUE.equals(base.wrap); + ind = base.indent == null ? 0 : base.indent; + } else { + hz = horizontal != null || base == null || Boolean.TRUE.equals(applyAlignment) + ? horizontal : base.horizontal; + vt = vertical != null || base == null || Boolean.TRUE.equals(applyAlignment) + ? vertical : base.vertical; + wr = wrap != null || base == null || Boolean.TRUE.equals(applyAlignment) + ? Boolean.TRUE.equals(wrap) : Boolean.TRUE.equals(base.wrap); + ind = indent != null || base == null || Boolean.TRUE.equals(applyAlignment) + ? (indent == null ? 0 : indent) : base.indent == null ? 0 : base.indent; + } + return new CellXf(nf, fn, fl, bd, hz, vt, wr, ind); + } + + private static int pickNum(Integer own, Boolean apply, Integer base) { + if (Boolean.TRUE.equals(apply)) { + return own == null ? 0 : own; + } + if (Boolean.FALSE.equals(apply)) { + return base == null ? 0 : base; + } + if (own != null) { + return own; + } + return base == null ? 0 : base; + } + } + + /** Контейнер разбора одной части styles.xml. */ + private static final class Parser { + private final List fonts = new ArrayList<>(); + private final List fills = new ArrayList<>(); + private final List borders = new ArrayList<>(); + private final List styleXfs = new ArrayList<>(); + private final List cellXfs = new ArrayList<>(); + private final List indexedColors = new ArrayList<>(); + private final java.util.LinkedHashMap numFmts = + new java.util.LinkedHashMap<>(); + /** Текущая таблица для дочерних элементов. */ + private String table; + + void parse(XMLStreamReader xr) throws XMLStreamException { + boolean rootOpen = false; + while (!rootOpen && xr.hasNext()) { + // до START корня styleSheet — дальше диспатчим только детей + // (иначе default-skip проглотит весь документ) + rootOpen = xr.next() == XMLStreamConstants.START_ELEMENT; + } + while (xr.hasNext()) { + if (xr.next() != XMLStreamConstants.START_ELEMENT) { + continue; + } + table = xr.getLocalName(); + switch (table) { + case "numFmts" -> parseNumFmts(xr); + case "fonts" -> parseFonts(xr); + case "fills" -> parseFills(xr); + case "borders" -> parseBorders(xr); + case "cellStyleXfs" -> styleXfs.addAll(parseXfs(xr)); + case "cellXfs" -> cellXfs.addAll(parseXfs(xr)); + case "colors" -> parseColors(xr); + default -> SharedStrings.skipElement(xr); + } + } + } + + StylesModel build() { + if (fonts.isEmpty()) { + fonts.add(defaultFont()); + } + // ECMA §18.8.21: fills[0] — none, fills[1] — легаси gray125 + // (генераторы иногда пишут только первую). + while (fills.size() < 2) { + fills.add(fills.isEmpty() ? noFill() : gray125()); + } + if (borders.isEmpty()) { + borders.add(noBorder()); + } + List xfs = new ArrayList<>(cellXfs.size()); + for (RawXf xf : cellXfs) { + RawXf base = xf.xfId() == null || xf.xfId() < 0 || xf.xfId() >= styleXfs.size() + ? null : styleXfs.get(xf.xfId()); + xfs.add(xf.resolve(base)); + } + if (xfs.isEmpty()) { + xfs.add(new CellXf(0, 0, 0, 0, null, null, false, 0)); + } + return new StylesModel(List.copyOf(fonts), List.copyOf(fills), + List.copyOf(borders), List.copyOf(xfs), List.copyOf(indexedColors), + Map.copyOf(numFmts)); + } + + private void parseNumFmts(XMLStreamReader xr) throws XMLStreamException { + while (nextTableItem(xr, "numFmt")) { + Integer id = ColorSpec.parseInt(XlsxPackage.attr(xr, "numFmtId")); + String code = XlsxPackage.attr(xr, "formatCode"); + SharedStrings.skipElement(xr); + if (id != null && code != null) { + numFmts.putIfAbsent(id, code); + } + } + } + + private void parseFonts(XMLStreamReader xr) throws XMLStreamException { + while (nextTableItem(xr, "font")) { + fonts.add(readFont(xr)); + } + } + + private FontDef readFont(XMLStreamReader xr) throws XMLStreamException { + String name = null; + String scheme = null; + Double size = null; + Boolean bold = null; + Boolean italic = null; + String underline = null; + Boolean strikeout = null; + ColorSpec color = null; + while (xr.hasNext()) { + int ev = xr.next(); + if (ev == XMLStreamConstants.END_ELEMENT) { + break; + } + if (ev != XMLStreamConstants.START_ELEMENT) { + continue; + } + switch (xr.getLocalName()) { + case "name" -> name = XlsxPackage.attr(xr, "val"); + case "scheme" -> scheme = XlsxPackage.attr(xr, "val"); + case "sz" -> size = ColorSpec.parseDouble(XlsxPackage.attr(xr, "val")); + case "b" -> bold = SharedStrings.boolVal(xr); + case "i" -> italic = SharedStrings.boolVal(xr); + case "strike" -> strikeout = SharedStrings.boolVal(xr); + case "u" -> { + String v = XlsxPackage.attr(xr, "val"); + underline = v == null || "none".equals(v) ? null : v; + } + case "color" -> color = ColorSpec.fromColorElement(xr); + default -> { + } + } + // листок font (name/sz/b/…) доедает свой END, иначе он + // досрочно прервёт разбор шрифта + SharedStrings.skipElement(xr); + } + return new FontDef(name, scheme, size, bold, italic, underline, strikeout, color); + } + + private void parseFills(XMLStreamReader xr) throws XMLStreamException { + while (nextTableItem(xr, "fill")) { + fills.add(readFill(xr)); + } + } + + private FillDef readFill(XMLStreamReader xr) throws XMLStreamException { + String pattern = "none"; + ColorSpec fg = null; + while (xr.hasNext()) { + int ev = xr.next(); + if (ev == XMLStreamConstants.END_ELEMENT) { + break; + } + if (ev == XMLStreamConstants.START_ELEMENT + && "patternFill".equals(xr.getLocalName())) { + String pt = XlsxPackage.attr(xr, "patternType"); + pattern = pt == null ? "none" : pt; + fg = readPatternColors(xr); + } else if (ev == XMLStreamConstants.START_ELEMENT) { + SharedStrings.skipElement(xr); + } + } + return new FillDef(pattern, fg); + } + + /** fgColor patternFill (solid — это ОН же цвет заливки); bgColor пропускается. */ + private ColorSpec readPatternColors(XMLStreamReader xr) throws XMLStreamException { + ColorSpec fg = null; + while (xr.hasNext()) { + int ev = xr.next(); + if (ev == XMLStreamConstants.END_ELEMENT) { + break; + } + if (ev != XMLStreamConstants.START_ELEMENT) { + continue; + } + switch (xr.getLocalName()) { + case "fgColor" -> { + fg = ColorSpec.fromColorElement(xr); + SharedStrings.skipElement(xr); + } + default -> SharedStrings.skipElement(xr); + } + } + return fg; + } + + private void parseBorders(XMLStreamReader xr) throws XMLStreamException { + while (nextTableItem(xr, "border")) { + borders.add(readBorder(xr)); + } + } + + private BorderDef readBorder(XMLStreamReader xr) throws XMLStreamException { + BorderSide left = null; + BorderSide right = null; + BorderSide top = null; + BorderSide bottom = null; + while (xr.hasNext()) { + int ev = xr.next(); + if (ev == XMLStreamConstants.END_ELEMENT) { + break; + } + if (ev != XMLStreamConstants.START_ELEMENT) { + continue; + } + String side = xr.getLocalName(); + if ("left".equals(side) || "right".equals(side) + || "top".equals(side) || "bottom".equals(side)) { + String style = XlsxPackage.attr(xr, "style"); + ColorSpec color = readSideColor(xr); + BorderSide s = new BorderSide(style, color); + switch (side) { + case "left" -> left = s; + case "right" -> right = s; + case "top" -> top = s; + default -> bottom = s; + } + } else { + SharedStrings.skipElement(xr); + } + } + return new BorderDef(left, right, top, bottom); + } + + /** + * Дочерний color стороны; сторона потребляется ЦЕЛИКОМ до своего END + * (досрочный return на color бросал бы END стороны на внешний цикл + * readBorder и обрывал границу на первой цветной стороне). + */ + private ColorSpec readSideColor(XMLStreamReader xr) throws XMLStreamException { + ColorSpec found = null; + int depth = 1; // стороны доедаются до её собственного END по глубине + while (xr.hasNext() && depth > 0) { + int ev = xr.next(); + if (ev == XMLStreamConstants.START_ELEMENT) { + depth++; + if (found == null && "color".equals(xr.getLocalName())) { + found = ColorSpec.fromColorElement(xr); + } + } else if (ev == XMLStreamConstants.END_ELEMENT) { + depth--; + } + } + return found; + } + + private List parseXfs(XMLStreamReader xr) throws XMLStreamException { + List xfs = new ArrayList<>(); + while (nextTableItem(xr, "xf")) { + xfs.add(readXf(xr)); + } + return xfs; + } + + private RawXf readXf(XMLStreamReader xr) throws XMLStreamException { + Integer numFmtId = ColorSpec.parseInt(XlsxPackage.attr(xr, "numFmtId")); + Integer fontId = ColorSpec.parseInt(XlsxPackage.attr(xr, "fontId")); + Integer fillId = ColorSpec.parseInt(XlsxPackage.attr(xr, "fillId")); + Integer borderId = ColorSpec.parseInt(XlsxPackage.attr(xr, "borderId")); + Integer xfId = ColorSpec.parseInt(XlsxPackage.attr(xr, "xfId")); + Boolean applyNumFmt = flag(XlsxPackage.attr(xr, "applyNumFmt")); + Boolean applyFont = flag(XlsxPackage.attr(xr, "applyFont")); + Boolean applyFill = flag(XlsxPackage.attr(xr, "applyFill")); + Boolean applyBorder = flag(XlsxPackage.attr(xr, "applyBorder")); + Boolean applyAlignment = flag(XlsxPackage.attr(xr, "applyAlignment")); + String hz = null; + String vt = null; + Boolean wrap = null; + Integer indent = null; + while (xr.hasNext()) { + int ev = xr.next(); + if (ev == XMLStreamConstants.END_ELEMENT) { + break; + } + if (ev != XMLStreamConstants.START_ELEMENT) { + continue; + } + switch (xr.getLocalName()) { + case "alignment" -> { + hz = XlsxPackage.attr(xr, "horizontal"); + vt = XlsxPackage.attr(xr, "vertical"); + String w = XlsxPackage.attr(xr, "wrapText"); + wrap = w == null ? null : XlsxPackage.truthy(w); + indent = ColorSpec.parseInt(XlsxPackage.attr(xr, "indent")); + SharedStrings.skipElement(xr); + } + default -> SharedStrings.skipElement(xr); // protection/неизвестное + } + } + return new RawXf(numFmtId, fontId, fillId, borderId, xfId, applyNumFmt, + applyFont, applyFill, applyBorder, applyAlignment, hz, vt, wrap, indent); + } + + private void parseColors(XMLStreamReader xr) throws XMLStreamException { + while (xr.hasNext()) { + int ev = xr.next(); + if (ev == XMLStreamConstants.END_ELEMENT) { + break; + } + if (ev != XMLStreamConstants.START_ELEMENT) { + continue; + } + switch (xr.getLocalName()) { + case "indexedColors": + while (xr.hasNext()) { + int e2 = xr.next(); + if (e2 == XMLStreamConstants.END_ELEMENT) { + break; + } + if (e2 != XMLStreamConstants.START_ELEMENT) { + continue; + } + switch (xr.getLocalName()) { + case "rgbColor" -> { + String rgb = XlsxPackage.attr(xr, "rgb"); + indexedColors.add(rgb == null ? "000000" : rgb); + } + default -> { + } + } + SharedStrings.skipElement(xr); + } + break; + default: + SharedStrings.skipElement(xr); + } + } + } + + /** Следующий START дочернего элемента {@code item} таблицы; END таблицы — false. */ + private boolean nextTableItem(XMLStreamReader xr, String item) throws XMLStreamException { + while (xr.hasNext()) { + int ev = xr.next(); + if (ev == XMLStreamConstants.END_ELEMENT) { + return false; + } + if (ev == XMLStreamConstants.START_ELEMENT && item.equals(xr.getLocalName())) { + return true; + } + } + return false; + } + + private static Boolean flag(String v) { + if (v == null) { + return null; + } + return XlsxPackage.truthy(v); + } + } + + private static FontDef defaultFont() { + return new FontDef("Calibri", "minor", DEFAULT_SIZE_PT, null, null, null, null, null); + } + + private static FillDef noFill() { + return new FillDef("none", null); + } + + private static FillDef gray125() { + return new FillDef("gray125", null); + } + + private static BorderDef noBorder() { + return new BorderDef(null, null, null, null); + } +} diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/ThemeModel.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/ThemeModel.java new file mode 100644 index 0000000..b6ae970 --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/ThemeModel.java @@ -0,0 +1,176 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import javax.xml.stream.XMLStreamConstants; +import javax.xml.stream.XMLStreamException; +import javax.xml.stream.XMLStreamReader; +import java.io.ByteArrayInputStream; +import java.util.LinkedHashMap; +import java.util.Map; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +/** + * Цветовая и шрифтовая схема документа из {@code xl/theme/theme1.xml} + * (ECMA-376 Part 1 §14.2.9 DrawingML theme). Часть опциональна: нет части — + * встроенная дефолтная палитра Office (§18.18.62 отсылает к ней, когда + * генератор пишет {@code theme="4"}, не кладя theme). + * + *

Индексы {@code @theme} (CT_Color, §18.18.62) в имена элементов + * clrScheme: 0→lt1, 1→dk1, 2→lt2, 3→dk2, 4..9→accent1..6, 10→hlink, + * 11→folHlink. Порядок lt/dk переставлен намеренно (историческая инверсия + * Excel — не опечатка).

+ */ +final class ThemeModel { + + private static final Logger LOG = LoggerFactory.getLogger(ThemeModel.class); + + /** Часть темы (первая; theme2+ в SpreadsheetML не используются). */ + static final String THEME_PART = "xl/theme/theme1.xml"; + + /** Дефолтная палитра Office (та, что кладёт в файл сам Excel). */ + private static final Map DEFAULT_SCHEME = defaultScheme(); + + /** {@code @theme} → имя элемента clrScheme (§18.18.62). */ + static String elementForIndex(int theme) { + return switch (theme) { + case 0 -> "lt1"; + case 1 -> "dk1"; + case 2 -> "lt2"; + case 3 -> "dk2"; + case 4 -> "accent1"; + case 5 -> "accent2"; + case 6 -> "accent3"; + case 7 -> "accent4"; + case 8 -> "accent5"; + case 9 -> "accent6"; + case 10 -> "hlink"; + case 11 -> "folHlink"; + default -> null; + }; + } + + private final Map scheme; + private final String minorFont; + + private ThemeModel(Map scheme, String minorFont) { + this.scheme = scheme; + this.minorFont = minorFont; + } + + /** + * Чтение темы; отсутствие/брак части — дефолтная палитра + warn (это + * легитимный .xlsx, падать нельзя). + */ + static ThemeModel read(XlsxPackage pkg, WarnOnce warn) { + byte[] data = pkg.entry(THEME_PART); + if (data == null) { + warn.warn(LOG, "В .xlsx нет xl/theme/theme1.xml — дефолтная палитра Office"); + return new ThemeModel(DEFAULT_SCHEME, null); + } + Map scheme = new LinkedHashMap<>(); + String[] minor = new String[1]; + try { + parse(data, scheme, minor); + } catch (XMLStreamException e) { + warn.warn(LOG, "Не разобран xl/theme/theme1.xml ({}) — дефолтная палитра Office", + e.getMessage()); + return new ThemeModel(DEFAULT_SCHEME, null); + } + scheme.keySet().removeIf(k -> scheme.get(k) == null); + return new ThemeModel(scheme.isEmpty() ? DEFAULT_SCHEME : scheme, minor[0]); + } + + /** RRGGBG элемента схемы или null (нет элемента — автоцвет). */ + String color(String element) { + return scheme.get(element); + } + + /** Гарнитура minorFont/latin (для {@code } шрифтов без {@code name}); null — нет темы. */ + String minorFont() { + return minorFont; + } + + private static void parse(byte[] data, Map scheme, String[] minor) + throws XMLStreamException { + XMLStreamReader xr = XlsxPackage.newSecureReader() + .createXMLStreamReader(new ByteArrayInputStream(data)); + boolean rootSeen = false; + while (!rootSeen && xr.hasNext()) { + rootSeen = xr.next() == XMLStreamConstants.START_ELEMENT; + } + String clrElement = null; // имя элемента clrScheme, внутри которого мы + boolean inMinor = false; + int minorDepth = 0; + while (xr.hasNext()) { + int ev = xr.next(); + if (ev == XMLStreamConstants.START_ELEMENT) { + String name = xr.getLocalName(); + switch (name) { + case "srgbClr", "sysClr" -> { + if (clrElement != null) { + String hex = "srgbClr".equals(name) + ? XlsxPackage.attr(xr, "val") + : XlsxPackage.attr(xr, "lastClr"); + scheme.putIfAbsent(clrElement, hex == null ? null : normalize(hex)); + } + } + case "minorFont" -> { + inMinor = true; + minorDepth = 1; + } + default -> { + if (clrElement == null && CLR_ELEMENTS.contains(name)) { + clrElement = name; // дети читаются следующими итерациями + } else if (inMinor) { + switch (name) { + case "latin" -> { + if (minor[0] == null) { + minor[0] = XlsxPackage.attr(xr, "typeface"); + } + } + default -> { } + } + minorDepth++; + } + } + } + } else if (ev == XMLStreamConstants.END_ELEMENT) { + String name = xr.getLocalName(); + if (clrElement != null && name.equals(clrElement)) { + clrElement = null; + } else if (inMinor && --minorDepth == 0) { + inMinor = false; + } + } + } + } + + /** Имена элементов clrScheme (§14.2.9). */ + private static final java.util.Set CLR_ELEMENTS = java.util.Set.of( + "dk1", "lt1", "dk2", "lt2", "accent1", "accent2", "accent3", "accent4", + "accent5", "accent6", "hlink", "folHlink"); + + /** 8-ричный ARGB → 6-ричный RGB; короткий/битый — как есть (resolver отфильтрует). */ + private static String normalize(String hex) { + String h = hex.length() == 8 ? hex.substring(2) : hex; + return h.toUpperCase(java.util.Locale.ROOT); + } + + private static Map defaultScheme() { + Map m = new LinkedHashMap<>(); + m.put("dk1", "000000"); + m.put("lt1", "FFFFFF"); + m.put("dk2", "44546A"); + m.put("lt2", "E7E6E6"); + m.put("accent1", "4472C4"); + m.put("accent2", "ED7D31"); + m.put("accent3", "A5A5A5"); + m.put("accent4", "FFC000"); + m.put("accent5", "5B9BD5"); + m.put("accent6", "70AD47"); + m.put("hlink", "0563C1"); + m.put("folHlink", "954F72"); + return Map.copyOf(m); + } +} diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/WarnOnce.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/WarnOnce.java new file mode 100644 index 0000000..26747c2 --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/WarnOnce.java @@ -0,0 +1,28 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import java.util.HashSet; +import java.util.Set; + +import org.slf4j.Logger; + +/** + * Одноразовые warn'и на конвертацию: ключ — текст с плейсхолдерами и + * аргументы, повтор того же ключа молчит (деградации «warn раз на + * конвертацию» из плана; тот же приём, что {@code DrawingPreRenderer}). + * Мост вызывается из сериализованного воркера, но набор создаётся на + * {@code XlsxToDocx.convert} — общая stateless-гонка исключена. + */ +final class WarnOnce { + + private final Set seen = new HashSet<>(); + + void warn(Logger log, String key, Object... args) { + String dedup = key; + for (Object arg : args) { + dedup = dedup + '\0' + arg; + } + if (seen.add(dedup)) { + log.warn(key, args); + } + } +} diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/WorkbookModel.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/WorkbookModel.java new file mode 100644 index 0000000..a99762d --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/WorkbookModel.java @@ -0,0 +1,118 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import javax.xml.stream.XMLStreamConstants; +import javax.xml.stream.XMLStreamReader; +import java.io.ByteArrayInputStream; +import java.io.IOException; +import java.util.ArrayList; +import java.util.HashMap; +import java.util.List; +import java.util.Map; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +/** + * {@code xl/workbook.xml} (ECMA-376 §18.2.20): листы в tab-порядке + * {@code sheets/sheet} с путями частей через {@code xl/_rels/workbook.xml.rels} + * и флаг {@code workbookPr/@date1904} (§18.2.28 — эпoca дат 1904-01-01). + * Лист без связи на worksheet-часть (внешняя связь, chartsheet, rel на + * отсутствующую часть) в модель не попадает — {@link XlsxToDocx} печатает + * warn и пропускает лист. + */ +final class WorkbookModel { + + /** Один лист: имя, {@code @state} ("visible" если нет) и путь части (null — не резолвится). */ + record Sheet(String name, String state, String partPath) { + + boolean visible() { + return state == null || "visible".equals(state); + } + } + + /** Namespace атрибута r:id (ECMA-376 Part 2 §17.7.5.4). */ + private static final String REL_NS = + "http://schemas.openxmlformats.org/officeDocument/2006/relationships"; + + /** Тип связи worksheet (ECMA-376 Part 2). */ + private static final String WORKSHEET_REL_TYPE = + "http://schemas.openxmlformats.org/officeDocument/2006/relationships/worksheet"; + + private static final String WORKBOOK_PART = "xl/workbook.xml"; + private static final String WORKBOOK_RELS_PART = "xl/_rels/workbook.xml.rels"; + + private static final Logger LOG = LoggerFactory.getLogger(WorkbookModel.class); + + private final List sheets; + private final boolean date1904; + + private WorkbookModel(List sheets, boolean date1904) { + this.sheets = sheets; + this.date1904 = date1904; + } + + /** Листы в порядке {@code sheets}. */ + List sheets() { + return sheets; + } + + /** {@code workbookPr/@date1904} — система дат 1904. */ + boolean date1904() { + return date1904; + } + + static WorkbookModel read(XlsxPackage pkg) throws IOException { + byte[] data = pkg.entry(WORKBOOK_PART); + if (data == null) { + throw new IOException("В .xlsx нет части xl/workbook.xml"); + } + // pass 1: rId → worksheet-часть (rels уже отрезолвлены от xl/) + Map partByRid = new HashMap<>(); + for (XlsxPackage.Rel rel : pkg.rels(WORKBOOK_PART)) { + if (WORKSHEET_REL_TYPE.equals(rel.type()) && !rel.external()) { + partByRid.putIfAbsent(rel.id(), + XlsxPackage.resolvePath("xl/", rel.target())); + } + } + // pass 2: sheets/sheet в порядке документа + List sheets = new ArrayList<>(); + boolean date1904 = false; + try { + XMLStreamReader xr = XlsxPackage.newSecureReader() + .createXMLStreamReader(new ByteArrayInputStream(data)); + while (xr.hasNext()) { + if (xr.next() != XMLStreamConstants.START_ELEMENT) { + continue; + } + String name = xr.getLocalName(); + switch (name) { + case "sheet" -> { + String sheetName = XlsxPackage.attr(xr, "name"); + String state = XlsxPackage.attr(xr, "state"); + String rid = XlsxPackage.attrNs(xr, REL_NS, "id"); + String partPath = rid == null ? null : partByRid.get(rid); + if (partPath == null || !pkg.has(partPath)) { + LOG.warn("Лист '{}' (.xlsx) не имеет worksheet-части — пропущен", + sheetName); + continue; + } + sheets.add(new Sheet(sheetName == null ? "" : sheetName, state, partPath)); + } + case "workbookPr" -> + date1904 = XlsxPackage.truthy(XlsxPackage.attr(xr, "date1904")); + default -> { + } + } + } + xr.close(); + } catch (javax.xml.stream.XMLStreamException e) { + throw new IOException("Не удалось разобрать xl/workbook.xml", e); + } + // rels workbook обязаны существовать, но лист-то уже найден через map; + // отдельная проверка части rels не нужна (пустой rels ⇒ нет листов ⇒ warn выше). + if (pkg.entry(WORKBOOK_RELS_PART) == null && !sheets.isEmpty()) { + LOG.warn("В .xlsx нет xl/_rels/workbook.xml.rels — связи листов не найдены"); + } + return new WorkbookModel(sheets, date1904); + } +} diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/XlsxPackage.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/XlsxPackage.java new file mode 100644 index 0000000..c416905 --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/XlsxPackage.java @@ -0,0 +1,220 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import javax.xml.stream.XMLInputFactory; +import javax.xml.stream.XMLStreamException; +import javax.xml.stream.XMLStreamReader; +import java.io.ByteArrayInputStream; +import java.io.IOException; +import java.util.ArrayList; +import java.util.ArrayDeque; +import java.util.Deque; +import java.util.HashMap; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.zip.ZipEntry; +import java.util.zip.ZipInputStream; + +/** + * .xlsx как zip: байты записей (дубликаты враждебного архива — первая + * выигрывает) и разбор OPC-связей {@code /_rels/.rels} (StAX, + * ECMA-376 Part 2 §15). Целый архив в памяти держится сознательно: вход + * уже проскан валидатором (zip-бомба отсекается ДО моста, + * {@code WordPdfSettings#MAX_DECOMPRESSED_MB}), а per-part ленивое чтение + * потребовало бы либо держать байты xlsx, либо раскрывать zip вторично — + * при multi-sheet обходе это дороже. + */ +final class XlsxPackage { + + /** Одна связь {@code Relationship} из .rels-части. */ + record Rel(String id, String type, String target, boolean external) { + } + + private final Map entries = new LinkedHashMap<>(); + private final Map> relsByPart = new HashMap<>(); + + private XlsxPackage() { + } + + /** Распаковка архива (первая запись из дубликатов). */ + static XlsxPackage read(byte[] xlsxBytes) throws IOException { + XlsxPackage pkg = new XlsxPackage(); + try (ZipInputStream zip = new ZipInputStream(new ByteArrayInputStream(xlsxBytes))) { + ZipEntry entry; + while ((entry = zip.getNextEntry()) != null) { + if (entry.isDirectory() || pkg.entries.containsKey(entry.getName())) { + continue; + } + pkg.entries.put(entry.getName(), zip.readAllBytes()); + } + } + return pkg; + } + + /** Байты части или {@code null} (части нет). */ + byte[] entry(String path) { + return entries.get(path); + } + + /** Есть ли часть. */ + boolean has(String path) { + return entries.containsKey(path); + } + + /** + * Связи части: {@code dir/_rels/.rels} рядом с {@code partPath} + * (пустой список, если rels-части нет). Парсинг ленивый, повторный вызов + * отдаёт кэш. + */ + List rels(String partPath) { + List cached = relsByPart.get(partPath); + if (cached != null) { + return cached; + } + String relsPath = relsPathOf(partPath); + List rels = new ArrayList<>(); + byte[] data = relsPath == null ? null : entries.get(relsPath); + if (data != null) { + try { + rels = parseRels(data); + } catch (XMLStreamException | IOException e) { + // Битые rels — «связей нет»: лист без rels пустой (+warn у + // вызывающего), падать из-за них на весь документ незачем. + rels = List.of(); + } + } + relsByPart.put(partPath, rels); + return rels; + } + + /** First rel заданного типа с id (внешние тоже) или null. */ + Rel relByTargetId(String partPath, String relId) { + for (Rel rel : rels(partPath)) { + if (rel.id().equals(relId)) { + return rel; + } + } + return null; + } + + /** Часть-цель связи (resolved от каталога part-источника) или null. */ + String relTargetPath(String partPath, String relId) { + Rel rel = relByTargetId(partPath, relId); + if (rel == null || rel.external()) { + return null; + } + return resolvePath(parentDir(partPath), rel.target()); + } + + /** {@code word/document.xml} → {@code word/_rels/document.xml.rels}. */ + static String relsPathOf(String partPath) { + int slash = partPath.lastIndexOf('/'); + String dir = slash < 0 ? "" : partPath.substring(0, slash + 1); + String file = slash < 0 ? partPath : partPath.substring(slash + 1); + return dir + "_rels/" + file + ".rels"; + } + + /** Каталог части с завершающим слэшем ("" для корневых). */ + static String parentDir(String partPath) { + int slash = partPath.lastIndexOf('/'); + return slash < 0 ? "" : partPath.substring(0, slash + 1); + } + + /** + * Target связи в путь zip-записи: абсолютный ("/xl/…") — от корня + * пакета; относительный разрешается от каталога {@code fromDir} + * («.», «..», обратный слэш). + */ + static String resolvePath(String fromDir, String target) { + String t = target.replace('\\', '/'); + int query = t.indexOf('?'); + if (query >= 0) { + t = t.substring(0, query); + } + if (t.startsWith("/")) { + return t.substring(1); + } + Deque segs = new ArrayDeque<>(); + for (String dir : fromDir.split("/")) { + if (!dir.isEmpty()) { + segs.push(dir); + } + } + for (String seg : t.split("/")) { + if (seg.isEmpty() || CUR.equals(seg)) { + continue; + } + if (UP.equals(seg)) { + if (!segs.isEmpty()) { + segs.pop(); + } + } else { + segs.push(seg); + } + } + StringBuilder path = new StringBuilder(); + for (var it = segs.descendingIterator(); it.hasNext(); ) { + if (path.length() > 0) { + path.append('/'); + } + path.append(it.next()); + } + return path.toString(); + } + + /** Сегменты относительных путей. */ + private static final String CUR = "."; + private static final String UP = ".."; + + private static List parseRels(byte[] data) throws IOException, XMLStreamException { + List rels = new ArrayList<>(); + Map seenIds = new HashMap<>(); + XMLStreamReader xr = newSecureReader().createXMLStreamReader(new ByteArrayInputStream(data)); + while (xr.hasNext()) { + if (xr.next() == XMLStreamReader.START_ELEMENT + && "Relationship".equals(xr.getLocalName())) { + String id = attr(xr, "Id"); + String type = attr(xr, "Type"); + String target = attr(xr, "Target"); + boolean external = "External".equals(attr(xr, "TargetMode")); + if (id != null && type != null && target != null && seenIds.put(id, true) == null) { + rels.add(new Rel(id, type, target, external)); + } + } + } + xr.close(); + return rels; + } + + /** Значение атрибута по локальному имени (без привязки к namespace). */ + static String attr(XMLStreamReader xr, String name) { + for (int i = 0; i < xr.getAttributeCount(); i++) { + if (xr.getAttributeName(i).getLocalPart().equals(name)) { + return xr.getAttributeValue(i); + } + } + return null; + } + + /** Значение namespace-атрибута (например r:id). */ + static String attrNs(XMLStreamReader xr, String ns, String name) { + return xr.getAttributeValue(ns, name); + } + + /** + * XML-boolean атрибут ECMA-376 (§18.18.62): отсутствует или {@code 0}/ + * {@code false}/{@code off} — ложь; {@code 1}/{@code true}/{@code on}/ + * пустое значение (атрибут выставлен) — истина. + */ + static boolean truthy(String value) { + return value != null && !"0".equals(value) && !"false".equalsIgnoreCase(value) + && !"off".equalsIgnoreCase(value); + } + + static XMLInputFactory newSecureReader() { + XMLInputFactory f = XMLInputFactory.newInstance(); + f.setProperty(XMLInputFactory.SUPPORT_DTD, false); + f.setProperty(XMLInputFactory.IS_SUPPORTING_EXTERNAL_ENTITIES, false); + return f; + } +} diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/XlsxToDocx.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/XlsxToDocx.java new file mode 100644 index 0000000..a92c6e9 --- /dev/null +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/xlsx/XlsxToDocx.java @@ -0,0 +1,122 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import org.slf4j.Logger; +import org.slf4j.LoggerFactory; + +import ru.pjandro.wordpdf.ConvertOptions; +import ru.pjandro.wordpdf.ConversionException; +import ru.pjandro.wordpdf.DrawingFoundException; +import ru.pjandro.wordpdf.ValidationException; +import ru.pjandro.wordpdf.internal.DocxPackageWriter; + +import java.util.ArrayList; +import java.util.LinkedHashSet; +import java.util.List; +import java.util.Map; + +/** + * Мост .xlsx → in-memory .docx: лист Excel превращается в Word-таблицу + * фиксированной сетки, дальше — штатный пайплайн {@code WordPdfConverter} + * (шаги 1–7: шрифты, {@code DrawingPreRenderer}, вендорный XSLT, FOP). + * Нормативная база — ECMA-376 Part 1 §18 SpreadsheetML (ссылки § — в + * javadoc'ах классов пакета); печатная семантика (срезы/разрывы/fitToPage) + * — как печать Excel. + * + *

Тот же архитектурный приём, что мост {@code internal.doc}: разбор → + * модель → генерация docx-байтов; наружу из пакета — только {@link #convert}. + * Сгенерированный docx — собственный артефакт, штатной валидацией входа не + * проверяется (вход проверен {@code WordPdfValidator} по байтам .xlsx).

+ */ +public final class XlsxToDocx { + + private static final Logger LOG = LoggerFactory.getLogger(XlsxToDocx.class); + + + private XlsxToDocx() { + } + + /** + * Байты .xlsx → байты .docx того же документа (все видимые листы по + * tab-порядку; между листами — разрыв секции, шаг 6). + * + * @param options error-флаги рисунков (chart/OLE) и лимиты на этот вызов + * @throws DrawingFoundException {@code options.errorOnCharts()}/{@code errorOnOle()} + * и объект найден — уходит вызывающему как есть (REST мапит в 422) + * @throws ValidationException любой внешний отказ разбора — контрактный + * текст «Не удалось разобрать байты .xlsx» + */ + public static byte[] convert(byte[] xlsxBytes, ConvertOptions options) + throws ConversionException { + try { + return convertInternal(xlsxBytes, options); + } catch (ConversionException e) { + // DrawingFoundException (и иной Contract-исключение моста) — как есть + throw e; + } catch (Exception e) { + throw new ValidationException("Не удалось разобрать байты .xlsx", e); + } + } + + private static byte[] convertInternal(byte[] xlsxBytes, ConvertOptions options) + throws Exception { + WarnOnce warn = new WarnOnce(); + XlsxPackage pkg = XlsxPackage.read(xlsxBytes); + WorkbookModel wb = WorkbookModel.read(pkg); + ThemeModel theme = ThemeModel.read(pkg, warn); + StylesModel styles = StylesModel.read(pkg, warn); + SharedStrings sst = SharedStrings.read(pkg, warn); + Metrics metrics = Metrics.forNormalFamily(styles.normalFontName(theme)); + NumberFormats numfmt = new NumberFormats(styles.customFormats(), wb.date1904()); + ColorResolver colors = new ColorResolver(theme, styles.indexedColors()); + + StringBuilder body = new StringBuilder(); + List parts = new ArrayList<>(); + DrawingBridge.emitTheme(pkg, parts); + DrawingBridge bridge = new DrawingBridge(parts, warn); + LinkedHashSet hyperlinks = new LinkedHashSet<>(); + // Каждый блок печати заканчивается paragraph-level sectPr (конец + // секции = новая страница); секция последнего блока уходит финальным + // body-level sectPr (Word-контент после последнего разрыва). + String pendingSect = null; + for (WorkbookModel.Sheet sheet : wb.sheets()) { + if (!sheet.visible()) { + continue; + } + SheetModel model = SheetModel.read(pkg, sheet, warn); + if (model.olePresent()) { + if (options.errorOnOle()) { + // OLE в xlsx: объект не эмитится никогда; флаг — отказ + // по structural-признакам листа (rels oleObject/objectLink, + // legacyDrawing) + throw new DrawingFoundException(DrawingFoundException.Kind.OLE); + } + warn.warn(LOG, "OLE-объекты в листе «{}» не переносятся", sheet.name()); + } + PrintLayout.Page page = PrintLayout.page(model, warn); + String sect = PrintLayout.sectPr(page); + Map> drawings = DrawingBridge.byCell( + bridge.read(pkg, model, metrics), model); + for (String blockXml : SheetToTable.emit(model, styles, sst, wb, metrics, numfmt, + colors, page, drawings, parts, hyperlinks, warn)) { + if (pendingSect != null) { + body.append("").append(pendingSect) + .append(""); + } + body.append(blockXml); + pendingSect = sect; + } + // рисунки, чьи from-ячейки не были отрисованы (несущественная + // строка, вне диапазона) — в конец листа отдельными абзацами + for (List runs : drawings.values()) { + body.append("").append(String.join("", runs)).append(""); + } + } + // финальный абзац body (Word-контент-блок после последней таблицы) + body.append(""); + body.append("") + .append(pendingSect != null ? pendingSect + : PrintLayout.sectPr(PrintLayout.defaultPage())) + .append(""); + return DocxPackageWriter.write(body.toString(), parts, new ArrayList<>(hyperlinks)); + } +} diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/SampleXlsxGenerator.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/SampleXlsxGenerator.java new file mode 100644 index 0000000..d21d58a --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/SampleXlsxGenerator.java @@ -0,0 +1,559 @@ +package ru.pjandro.wordpdf; + +import org.apache.poi.common.usermodel.HyperlinkType; +import org.apache.poi.ss.usermodel.BorderStyle; +import org.apache.poi.ss.usermodel.Cell; +import org.apache.poi.ss.usermodel.CellStyle; +import org.apache.poi.ss.usermodel.CellType; +import org.apache.poi.ss.usermodel.FillPatternType; +import org.apache.poi.ss.usermodel.Font; +import org.apache.poi.ss.usermodel.HorizontalAlignment; +import org.apache.poi.ss.usermodel.Hyperlink; +import org.apache.poi.ss.usermodel.PrintSetup; +import org.apache.poi.ss.usermodel.Row; +import org.apache.poi.ss.usermodel.Sheet; +import org.apache.poi.ss.usermodel.VerticalAlignment; +import org.apache.poi.ss.usermodel.Workbook; +import org.apache.poi.ss.util.CellRangeAddress; +import org.apache.poi.xddf.usermodel.chart.AxisCrosses; +import org.apache.poi.xddf.usermodel.chart.AxisPosition; +import org.apache.poi.xddf.usermodel.chart.ChartTypes; +import org.apache.poi.xddf.usermodel.chart.XDDFCategoryAxis; +import org.apache.poi.xddf.usermodel.chart.XDDFCategoryDataSource; +import org.apache.poi.xddf.usermodel.chart.XDDFChartData; +import org.apache.poi.xddf.usermodel.chart.XDDFDataSourcesFactory; +import org.apache.poi.xddf.usermodel.chart.XDDFNumericalDataSource; +import org.apache.poi.xddf.usermodel.chart.XDDFValueAxis; +import org.apache.poi.xssf.usermodel.XSSFCell; +import org.apache.poi.xssf.usermodel.XSSFChart; +import org.apache.poi.xssf.usermodel.XSSFClientAnchor; +import org.apache.poi.xssf.usermodel.XSSFColor; +import org.apache.poi.xssf.usermodel.XSSFDrawing; +import org.apache.poi.xssf.usermodel.XSSFFont; +import org.apache.poi.xssf.usermodel.XSSFRichTextString; +import org.apache.poi.xssf.usermodel.XSSFSheet; +import org.apache.poi.xssf.usermodel.XSSFWorkbook; +import org.openxmlformats.schemas.spreadsheetml.x2006.main.CTCell; +import org.openxmlformats.schemas.spreadsheetml.x2006.main.CTColor; +import org.openxmlformats.schemas.spreadsheetml.x2006.main.CTWorkbook; +import org.openxmlformats.schemas.spreadsheetml.x2006.main.STCellType; + +import javax.imageio.ImageIO; +import java.awt.Color; +import java.awt.Graphics2D; +import java.awt.image.BufferedImage; +import java.io.ByteArrayOutputStream; +import java.io.File; +import java.io.FileOutputStream; +import java.nio.file.Path; +import java.nio.file.Paths; + +/** + * ОДНОРАЗОВАЯ утилита: генерация готовых .xlsx для тестов (Apache POI). + * + * Готовые файлы лежат в {@code wordpdf-core/src/test/resources/samples/} + * и коммитятся в репозиторий: сами тесты работают с ними как с + * обычными входными файлами и .xlsx не генерируют. + * + * Фикстуры покрывают контракт моста {@code internal.xlsx} (значения, + * стили, numFmt, merge, multi-sheet, page setup, разрывы строк, рисунки + * и диаграммы) — см. план поддержки .xlsx и {@code docs/agent/}. + * + * Пересоздать (если нужно): + *
+ *   mvn -pl wordpdf-core test-compile \
+ *       -Dmdep.outputFile=/tmp/cp.txt dependency:build-classpath -q
+ *   java -cp wordpdf-core/target/test-classes:$(cat /tmp/cp.txt) \
+ *       ru.pjandro.wordpdf.SampleXlsxGenerator \
+ *       wordpdf-core/src/test/resources/samples
+ * 
+ */ +public final class SampleXlsxGenerator { + + /** Индекс theme-цвета accent1 в color@theme (ECMA-376 §18.18.72 таблица). */ + private static final long THEME_ACCENT1 = 4; + /** Tint 60% высветления (Excel-канonical запись 0.599993896216032). */ + private static final double TINT_60 = 0.599993896216032; + /** Ширина столбца в единицах POI (1/256 знака): ~12 знаков. */ + private static final int COL_WIDTH_12 = 12 * 256; + /** Число столбцов широкого листа. */ + private static final int WIDE_COLS = 40; + /** Число строк широкого листа. */ + private static final int WIDE_ROWS = 60; + /** Номер строки (0-based), перед которой ставится ручной разрыв. */ + private static final int WIDE_ROW_BREAK = 11; + /** Число ручных разрывов в фикстуре лимита страниц (> MAX_PAGES=100). */ + private static final int PAGE_LIMIT_BREAKS = 130; + + private SampleXlsxGenerator() { + } + + public static void main(String[] args) throws Exception { + Path dir = Paths.get(args.length > 0 ? args[0] : "samples"); + dir.toFile().mkdirs(); + + basic(dir.resolve("xlsx-basic.xlsx")); + numFmt(dir.resolve("xlsx-numfmt.xlsx")); + dates1904(dir.resolve("xlsx-1904.xlsx")); + wide(dir.resolve("xlsx-wide.xlsx")); + fitToPage(dir.resolve("xlsx-fit-to-page.xlsx")); + chartImage(dir.resolve("xlsx-chart-image.xlsx")); + pageLimit(dir.resolve("xlsx-page-limit.xlsx")); + + System.out.println("Готово: " + dir.toAbsolutePath()); + } + + // ================== Фикстуры ================== + + /** + * Базовая: два видимых листа, кириллица+латиница, стили (b/i/u/s, цвета + * rgb и theme-accent1, заливки solid rgb и theme+tint, границы + * thin/medium/double/dashed, jc, vAlign, wrapText, Arial/Calibri), + * merge B2:D2 / C5:C6 / F3:G4, числа General, shared и inlineStr, + * булево, rich-text, гиперссылка, скрытые строка и столбец. + */ + private static void basic(Path out) throws Exception { + try (XSSFWorkbook wb = new XSSFWorkbook()) { + XSSFSheet s = wb.createSheet("Отчёт"); + CellStyle plain = wb.createCellStyle(); + + Cell a1 = cell(s, 0, 0, "Отчёт", plain); + Hyperlink link = wb.getCreationHelper().createHyperlink(HyperlinkType.URL); + link.setAddress("https://example.com/report"); + a1.setHyperlink(link); + + // Заголовок B2:D2: жирный 14 Arial, центр, жёлтая заливка rgb. + CellStyle header = wb.createCellStyle(); + Font f = wb.createFont(); + f.setBold(true); + f.setFontHeightInPoints((short) 14); + f.setFontName("Arial"); + header.setFont(f); + header.setAlignment(HorizontalAlignment.CENTER); + header.setFillForegroundColor(new XSSFColor(new byte[] { + (byte) 0xFF, (byte) 0xFF, 0x00}, null)); + header.setFillPattern(FillPatternType.SOLID_FOREGROUND); + mergeText(s, 1, 1, 1, 3, "Квартальные итоги", header); + + // Шапка таблицы 4-й строки: подчёркивание, цвет rgb, зачёркивание, + // курсив theme-accent1, правый jc. + Font u = wb.createFont(); + u.setBold(true); + u.setUnderline(Font.U_SINGLE); + CellStyle stUnderline = wb.createCellStyle(); + stUnderline.setFont(u); + Font red = wb.createFont(); + ((XSSFFont) red).setColor(new XSSFColor(new byte[] {(byte) 0xFF, 0, 0}, null)); + CellStyle stRed = wb.createCellStyle(); + stRed.setFont(red); + stRed.setBorderLeft(BorderStyle.THIN); + stRed.setBorderBottom(BorderStyle.THIN); + Font strike = wb.createFont(); + strike.setStrikeout(true); + CellStyle stStrike = wb.createCellStyle(); + stStrike.setFont(strike); + stStrike.setBorderRight(BorderStyle.DOUBLE); + // XSSFFont.setColor(XSSFColor) теряет theme-атрибут (пишет rgb="") + // — цвет пишется напрямую в CTFont/color (ECMA-376 §18.8.23 CT_Color). + Font accent = wb.createFont(); + accent.setItalic(true); + CTColor accentCt = ((XSSFFont) accent).getCTFont().addNewColor(); + accentCt.setTheme(THEME_ACCENT1); + CellStyle stAccent = wb.createCellStyle(); + stAccent.setFont(accent); + CellStyle stRight = wb.createCellStyle(); + stRight.setAlignment(HorizontalAlignment.RIGHT); + + cell(s, 3, 0, "Товар", stUnderline); + cell(s, 3, 1, "Q1", stRed); + cell(s, 3, 2, "Q2", plain); + cell(s, 3, 3, "Δ", stStrike); + cell(s, 3, 4, "Заметка", stAccent); + + // 5-я строка: число General, вертикальный merge C5:C6 с переносом, + // булево, заливка theme-accent1+tint, inlineStr, vAlign top. + CellStyle stTop = wb.createCellStyle(); + stTop.setVerticalAlignment(VerticalAlignment.TOP); + cell(s, 4, 0, "Молоко", stTop); + cell(s, 4, 1, 1234.5, plain); + CellStyle stWrap = wb.createCellStyle(); + stWrap.setWrapText(true); + stWrap.setVerticalAlignment(VerticalAlignment.CENTER); + stWrap.setBorderTop(BorderStyle.MEDIUM); + stWrap.setBorderLeft(BorderStyle.MEDIUM); + stWrap.setBorderRight(BorderStyle.MEDIUM); + stWrap.setBorderBottom(BorderStyle.MEDIUM); + mergeText(s, 4, 5, 2, 2, + "Очень длинный текст объединённой ячейки с переносом строк", stWrap); + Cell b5 = s.getRow(4).createCell(3); + b5.setCellValue(true); + b5.setCellStyle(plain); + CellStyle stTintFill = wb.createCellStyle(); + XSSFColor tintClr = new XSSFColor(); + CTColor tintCt = tintClr.getCTColor(); + tintCt.setTheme(THEME_ACCENT1); + tintCt.setTint(TINT_60); + stTintFill.setFillForegroundColor(tintClr); + stTintFill.setFillPattern(FillPatternType.SOLID_FOREGROUND); + stTintFill.setBorderBottom(BorderStyle.DASHED); + cell(s, 4, 4, "tint-заливка", stTintFill); + inlineStr(s, 4, 5, "инлайн-строка"); + cell(s, 5, 4, "справа", stRight); + + // 2×2 merge F3:G4 с vAlign center и Calibri. + CellStyle stBlock = wb.createCellStyle(); + Font calibri = wb.createFont(); + calibri.setFontName("Calibri"); + stBlock.setFont(calibri); + stBlock.setVerticalAlignment(VerticalAlignment.CENTER); + stBlock.setBorderBottom(BorderStyle.DASHED); + mergeText(s, 2, 3, 5, 6, "Крупный блок", stBlock); + + // Rich text: половина строки жирным (shared string с runs). + Font boldHalf = wb.createFont(); + boldHalf.setBold(true); + XSSFRichTextString rich = new XSSFRichTextString("обычный и ЖИРНЫЙ текст"); + rich.applyFont(10, 16, boldHalf); + Cell richCell = rowOf(s, 6).createCell(0); + richCell.setCellValue(rich); + + // Скрытые строка 8 и столбец H (индекс 7). + cell(s, 7, 0, "скрытая строка", plain); + cell(s, 0, 7, "скрытый столбец", plain); + rowOf(s, 7).setZeroHeight(true); + s.setColumnHidden(7, true); + + XSSFSheet notes = wb.createSheet("Заметки"); + CellStyle stItalic = wb.createCellStyle(); + Font italic = wb.createFont(); + italic.setItalic(true); + italic.setFontName("Calibri"); + stItalic.setFont(italic); + cell(notes, 0, 0, "Заметка", stItalic); + cell(notes, 1, 0, -42.0, plain); + + save(wb, out); + } + } + + /** NumFmt: форматные кода v1 — целые/дроби, проценты, научный, деньги, даты, время, scale, General. */ + private static void numFmt(Path out) throws Exception { + try (XSSFWorkbook wb = new XSSFWorkbook()) { + XSSFSheet s = wb.createSheet("Formats"); + // Legal (paperSize=5) — регрессия XlsxPdfConverterTest#sectionPerSheet: + // размер страницы секции обязан доезжать до MediaBox PDF + s.getPrintSetup().setPaperSize(PrintSetup.LEGAL_PAPERSIZE); + DataFormats f = new DataFormats(wb); + + CellStyle label = wb.createCellStyle(); + Font bold = wb.createFont(); + bold.setBold(true); + label.setFont(bold); + cell(s, 0, 0, "numFmt", label); + + fmt(s, 1, "general", "123456.789", f.general(), null); + fmt(s, 2, "two-decimals", 3.14159, f.custom("0.00"), null); + fmt(s, 3, "thousands", 1234.5, f.custom("#,##0"), null); + fmt(s, 4, "money-pos", 1234.0, f.custom("$#,##0.00_);($#,##0.00)"), null); + fmt(s, 5, "money-neg", -1234.5, f.custom("$#,##0.00_);($#,##0.00)"), null); + fmt(s, 6, "percent", 0.425, f.custom("0.0%"), null); + fmt(s, 7, "scientific", 12234567.0, f.custom("0.00E+00"), null); + fmt(s, 8, "scale-millions", 12345678.0, f.custom("#,##0,,"), null); + fmt(s, 9, "date-custom", 45629.0, f.custom("dd.mm.yyyy"), null); + fmt(s, 10, "date-builtin14", 45629.0, (short) 14, null); + fmt(s, 11, "weekday", 45629.0, f.custom("ddd"), null); + fmt(s, 12, "long-datetime", 45629.7708333333, f.custom("dd mmmm yyyy hh:mm"), null); + fmt(s, 13, "time-builtin20", 0.75, (short) 20, null); + fmt(s, 14, "elapsed", 1.5, f.custom("[h]:mm"), null); + fmt(s, 15, "red-section", -1.5, f.custom("[Red]0.00"), null); + fmt(s, 16, "text-section", "привет", f.custom("0.00;-0.00;0.00;@"), + "инлайн"); + fmt(s, 17, "builtin10", 3.14159, (short) 10, null); + fmt(s, 18, "accounting", 1234.56, + f.custom("_(* #,##0_);_(* (#,##0);_(* \"-\"??);_(@)"), null); + fmt(s, 19, "str-numeric", "12.5", f.custom("0.00"), "инлайн"); + fmt(s, 20, "neg-zero", -0.0, f.custom("0.00"), null); + fmt(s, 21, "serial-60", 60.0, f.custom("dd.mm.yyyy"), null); + + save(wb, out); + } + } + + /** Лист-1904: workbookPr date1904="1", serial 0/61 + пара дат. */ + private static void dates1904(Path out) throws Exception { + try (XSSFWorkbook wb = new XSSFWorkbook()) { + CTWorkbook ct = wb.getCTWorkbook(); + if (!ct.isSetWorkbookPr()) { + ct.addNewWorkbookPr(); + } + ct.getWorkbookPr().setDate1904(true); + + XSSFSheet s = wb.createSheet("Dates1904"); + CellStyle st = wb.createCellStyle(); + st.setDataFormat(wb.createDataFormat().getFormat("dd.mm.yyyy hh:mm")); + cell(s, 0, 0, "epoch", st); + Cell c0 = s.getRow(0).createCell(1); + c0.setCellValue(0); + c0.setCellStyle(st); + cell(s, 1, 0, "serial 61", st); + Cell c61 = s.getRow(1).createCell(1); + c61.setCellValue(61); + c61.setCellStyle(st); + cell(s, 2, 0, "date", st); + Cell c = s.getRow(2).createCell(1); + c.setCellValue(java.time.LocalDate.of(2024, 12, 3)); + c.setCellStyle(st); + save(wb, out); + } + } + + /** Широкий лист: 40 столбцов × 60 строк, ручной разрыв строки, merge через границу среза. */ + private static void wide(Path out) throws Exception { + try (XSSFWorkbook wb = new XSSFWorkbook()) { + XSSFSheet s = wb.createSheet("Wide"); + CellStyle plain = wb.createCellStyle(); + for (int c = 0; c < WIDE_COLS; c++) { + s.setColumnWidth(c, COL_WIDTH_12); + cell(s, 0, c, "Столбец " + (c + 1), plain); + } + for (int r = 1; r < WIDE_ROWS; r++) { + for (int c = 0; c < WIDE_COLS; c++) { + cell(s, r, c, "R" + (r + 1) + "C" + (c + 1), plain); + } + } + // Merge через ожидаемую границу первого среза (11-й столбец). + mergeText(s, 19, 19, 10, 12, "через границу среза", plain); + s.setRowBreak(WIDE_ROW_BREAK); + save(wb, out); + } + } + + /** FitToPage: 20 столбцов, fitToPage+fitToWidth, landscape, A4, поля 0.5″. */ + private static void fitToPage(Path out) throws Exception { + try (XSSFWorkbook wb = new XSSFWorkbook()) { + XSSFSheet s = wb.createSheet("Fit"); + CellStyle plain = wb.createCellStyle(); + for (int c = 0; c < 20; c++) { + s.setColumnWidth(c, COL_WIDTH_12); + cell(s, 0, c, "К" + (c + 1), plain); + } + for (int r = 1; r < 10; r++) { + for (int c = 0; c < 20; c++) { + cell(s, r, c, "F" + (r + 1) + "-" + (c + 1), plain); + } + } + s.setFitToPage(true); + PrintSetup ps = s.getPrintSetup(); + ps.setFitWidth((short) 1); + ps.setFitHeight((short) 0); + ps.setLandscape(true); + ps.setPaperSize(PrintSetup.A4_PAPERSIZE); + s.setMargin(Sheet.LeftMargin, 0.5); + s.setMargin(Sheet.RightMargin, 0.5); + s.setMargin(Sheet.TopMargin, 0.5); + s.setMargin(Sheet.BottomMargin, 0.5); + save(wb, out); + } + } + + /** Рисунки: bar- и line-диаграммы (кириллица) + PNG 100×60, все twoCellAnchor. */ + private static void chartImage(Path out) throws Exception { + try (XSSFWorkbook wb = new XSSFWorkbook()) { + XSSFSheet s = wb.createSheet("Графики"); + CellStyle plain = wb.createCellStyle(); + String[] cats = {"I кв.", "II кв.", "III кв.", "IV кв."}; + double[] sales = {120, 200, 150, 250}; + double[] services = {80, 120, 170, 140}; + int first = 29; + for (int i = 0; i < cats.length; i++) { + cell(s, first + i, 0, cats[i], plain); + cell(s, first + i, 1, sales[i], plain); + cell(s, first + i, 2, services[i], plain); + } + XSSFDrawing drawing = s.createDrawingPatriarch(); + + XSSFChart bar = drawing.createChart( + new XSSFClientAnchor(0, 0, 0, 0, 5, 1, 11, 14)); + bar.setTitleText("Продажи по кварталам"); + XDDFCategoryAxis barCat = bar.createCategoryAxis(AxisPosition.BOTTOM); + XDDFValueAxis barVal = bar.createValueAxis(AxisPosition.LEFT); + barVal.setCrosses(AxisCrosses.AUTO_ZERO); + XDDFChartData barData = bar.createData(ChartTypes.BAR, barCat, barVal); + addSeries(barData, s, first, sales.length); + bar.plot(barData); + + XSSFChart line = drawing.createChart( + new XSSFClientAnchor(0, 0, 0, 0, 5, 16, 11, 28)); + line.setTitleText("Динамика"); + XDDFCategoryAxis lineCat = line.createCategoryAxis(AxisPosition.BOTTOM); + XDDFValueAxis lineVal = line.createValueAxis(AxisPosition.LEFT); + lineVal.setCrosses(AxisCrosses.AUTO_ZERO); + XDDFChartData lineData = line.createData(ChartTypes.LINE, lineCat, lineVal); + addSeries(lineData, s, first, sales.length); + line.plot(lineData); + + byte[] png = makePng(); + int picIdx = wb.addPicture(png, Workbook.PICTURE_TYPE_PNG); + drawing.createPicture( + new XSSFClientAnchor(0, 0, 0, 0, 0, 17, 2, 20), picIdx); + + save(wb, out); + } + } + + /** Лимит страниц: 1 столбец, 130 ручных разрывов (оценка > MAX_PAGES). */ + private static void pageLimit(Path out) throws Exception { + try (XSSFWorkbook wb = new XSSFWorkbook()) { + XSSFSheet s = wb.createSheet("Long"); + CellStyle plain = wb.createCellStyle(); + for (int r = 0; r <= PAGE_LIMIT_BREAKS; r++) { + cell(s, r, 0, "Строка " + (r + 1), plain); + if (r < PAGE_LIMIT_BREAKS) { + s.setRowBreak(r); + } + } + save(wb, out); + } + } + + // ================== Вспомогательные ================== + + /** Категории A(first..) и две числовые серии B/C того же диапазона. */ + private static void addSeries(XDDFChartData data, XSSFSheet s, int first, int count) { + XDDFCategoryDataSource categories = XDDFDataSourcesFactory.fromStringCellRange( + s, new CellRangeAddress(first, first + count - 1, 0, 0)); + XDDFNumericalDataSource sales = XDDFDataSourcesFactory.fromNumericCellRange( + s, new CellRangeAddress(first, first + count - 1, 1, 1)); + XDDFNumericalDataSource services = XDDFDataSourcesFactory.fromNumericCellRange( + s, new CellRangeAddress(first, first + count - 1, 2, 2)); + XDDFChartData.Series s1 = data.addSeries(categories, sales); + s1.setTitle("Продукты"); + XDDFChartData.Series s2 = data.addSeries(categories, services); + s2.setTitle("Услуги"); + } + + /** PNG 100×60: красный круг на белом — отличие от сплошных заливок. */ + private static byte[] makePng() throws Exception { + BufferedImage img = new BufferedImage(100, 60, BufferedImage.TYPE_INT_RGB); + Graphics2D g = img.createGraphics(); + g.setColor(Color.WHITE); + g.fillRect(0, 0, 100, 60); + g.setColor(new Color(220, 30, 30)); + g.fillOval(20, 5, 50, 50); + g.setColor(new Color(20, 80, 200)); + g.fillRect(70, 40, 25, 15); + g.dispose(); + ByteArrayOutputStream bos = new ByteArrayOutputStream(); + ImageIO.write(img, "png", bos); + return bos.toByteArray(); + } + + /** Ячейка с числом/строкой и стилем; строку создаёт при необходимости. */ + private static Cell cell(Sheet s, int row, int col, String text, CellStyle st) { + Cell c = rowOf(s, row).createCell(col); + c.setCellValue(text); + c.setCellStyle(st); + return c; + } + + /** Ячейка с числом и стилем. */ + private static Cell cell(Sheet s, int row, int col, double value, CellStyle st) { + Cell c = rowOf(s, row).createCell(col); + c.setCellValue(value); + c.setCellStyle(st); + return c; + } + + /** inlineStr: {@code c/@t="inlineStr"} + {@code is/t} (ECMA-376 §18.3.1.53). */ + private static void inlineStr(Sheet s, int row, int col, String text) { + XSSFCell c = (XSSFCell) rowOf(s, row).createCell(col); + CTCell ct = c.getCTCell(); + ct.setT(STCellType.INLINE_STR); + ct.addNewIs().setT(text); + } + + /** merged region с текстом и стилем в origin-ячейке. */ + private static void mergeText(Sheet s, int row1, int row2, int col1, int col2, + String text, CellStyle st) { + cell(s, row1, col1, text, st); + for (int r = row1; r <= row2; r++) { + for (int c = col1 + (r == row1 ? 1 : 0); c <= col2; c++) { + Cell empty = rowOf(s, r).createCell(c); + empty.setCellStyle(st); + } + } + s.addMergedRegion(new CellRangeAddress(row1, row2, col1, col2)); + } + + /** + * Ячейка форматной строки: A — метка, B — значение (inlineStr — когда + * {@code inline} непустое), C — подтверждение типа значения. + */ + private static void fmt(Sheet s, int row, String name, Object value, + short fmtId, String inline) { + CellStyle st = s.getWorkbook().createCellStyle(); + st.setDataFormat(fmtId); + cell(s, row, 0, name, st); + Cell c = rowOf(s, row).createCell(1); + if (value instanceof Double) { + c.setCellValue((Double) value); + } else if (inline == null) { + c.setCellValue(String.valueOf(value)); + } + if (inline != null) { + CTCell ct = ((XSSFCell) c).getCTCell(); + ct.setT(STCellType.INLINE_STR); + ct.addNewIs().setT(String.valueOf(value)); + } + c.setCellStyle(st); + } + + private static Row rowOf(Sheet s, int row) { + Row r = s.getRow(row); + if (r == null) { + r = s.createRow(row); + } + return r; + } + + /** Таблица форматов с кэшем custom-id (один DataFormat на лист). */ + private static final class DataFormats { + private final Workbook wb; + + DataFormats(Workbook wb) { + this.wb = wb; + } + + /** General — id 0 (встроенный). */ + short general() { + return 0; + } + + /** Custom-код: ≥164, дубликаты кода — один id. */ + short custom(String code) { + return wb.createDataFormat().getFormat(code); + } + } + + /** Проверка, что POI записал ожидаемый тип (защита генератора от тихих изменений). */ + private static void assertType(Cell c, CellType expected) { + if (c.getCellType() != expected) { + throw new IllegalStateException("Ожидался тип " + expected + + ", записан " + c.getCellType()); + } + } + + private static void save(XSSFWorkbook wb, Path out) throws Exception { + // Контроль типа булевой ячейки базовой фикстуры до записи (после + // записи POI-объект уже сброшен в save). + Sheet base = wb.getSheet("Отчёт"); + if (base != null) { + assertType(base.getRow(4).getCell(3), CellType.BOOLEAN); + } + try (FileOutputStream fos = new FileOutputStream(out.toFile())) { + wb.write(fos); + } + System.out.println(" создан: " + out.getFileName() + + " (" + new File(out.toString()).length() + " байт)"); + } +} diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java index f3810ee..6eb628e 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java @@ -637,7 +637,7 @@ class WordPdfConverterTest { /** * Вход без подписи какого-либо поддерживаемого контейнера (ни zip, * ни CFB) — отказ как некорректный вход (ValidationException), - * а не ошибка рендера: сообщение перечисляет оба формата. + * а не ошибка рендера: сообщение перечисляет все форматы. * Регрессия — WordPdfValidatorTest#validate_notAZip. */ @Test @@ -645,7 +645,7 @@ class WordPdfConverterTest { byte[] junk = {1, 2, 3, 4, 5, 6, 7, 8}; ValidationException ex = assertThrows(ValidationException.class, () -> WordPdfConverter.convert(junk, "junk")); - assertTrue(ex.getMessage().contains("не похоже на .docx или .doc"), + assertTrue(ex.getMessage().contains("не похоже на .docx, .doc или .xlsx"), "сообщение должно перечислять форматы: " + ex.getMessage()); } @@ -1411,7 +1411,7 @@ class WordPdfConverterTest { * содержат — крафт POIFS, дубль хелперов DocToDocxFormattingTest): * инструкция → внешняя rels-связь документа, результат → содержимое * w:hyperlink, FOP кладёт поверх кликабельную аннотацию с /URI. - * Регрессия — internal.doc.DocxBody#hyperlinkUrl + DocxWriter#write. + * Регрессия — internal.doc.DocxBody#hyperlinkUrl + DocxPackageWriter#write. */ @Test void docHyperlink_linkAnnotationClickable() throws Exception { 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 867cb6d..89baa17 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfValidatorTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfValidatorTest.java @@ -1,15 +1,16 @@ package ru.pjandro.wordpdf; -import org.apache.poi.xssf.usermodel.XSSFWorkbook; import org.apache.poi.xwpf.usermodel.BreakType; import org.apache.poi.xwpf.usermodel.XWPFDocument; import org.apache.poi.xwpf.usermodel.XWPFParagraph; import org.apache.poi.xwpf.usermodel.XWPFTable; import org.junit.jupiter.api.Test; +import java.io.ByteArrayInputStream; import java.io.ByteArrayOutputStream; import java.nio.charset.StandardCharsets; import java.util.zip.ZipEntry; +import java.util.zip.ZipInputStream; import java.util.zip.ZipOutputStream; import static org.junit.jupiter.api.Assertions.*; @@ -168,8 +169,7 @@ class WordPdfValidatorTest { throws Exception { byte[] base = docxWithPageBreaks(0); ByteArrayOutputStream out = new ByteArrayOutputStream(); - try (java.util.zip.ZipInputStream zin = new java.util.zip.ZipInputStream( - new java.io.ByteArrayInputStream(base)); + try (ZipInputStream zin = new ZipInputStream(new ByteArrayInputStream(base)); ZipOutputStream zout = new ZipOutputStream(out)) { ZipEntry e; while ((e = zin.getNextEntry()) != null) { @@ -312,22 +312,112 @@ class WordPdfValidatorTest { } /** - * .xlsx под .docx-суффиксом: манифест xlsx декларирует spreadsheetml, - * не wordprocessingml — отказ как не-.docx, а не 500 на загрузке docx4j. - * Регрессия — WordPdfValidator#checkDocxContainer. + * Zip с манифестом без маркеров wordprocessingml и spreadsheetml + * (например, presentationml — переименованный .pptx) — отказ как + * не-OOXML-документ с обоими маркерами в тексте (контракт 400). + * Регрессия — WordPdfValidator#checkOoxmlContainer. */ @Test - void validate_xlsxRenamedRejected() throws Exception { + void validate_pptxLikeRejected() throws Exception { ByteArrayOutputStream out = new ByteArrayOutputStream(); - try (XSSFWorkbook wb = new XSSFWorkbook()) { - wb.createSheet("S1"); - wb.write(out); + try (ZipOutputStream zos = new ZipOutputStream(out)) { + zos.putNextEntry(new ZipEntry("[Content_Types].xml")); + zos.write(("" + + "").getBytes(StandardCharsets.UTF_8)); + zos.closeEntry(); } - byte[] xlsx = out.toByteArray(); ValidationException ex = assertThrows(ValidationException.class, - () -> WordPdfValidator.validate(xlsx, ConvertOptions.defaults())); - assertTrue(ex.getMessage().contains("не является .docx"), - "манифест xlsx — spreadsheetml: " + ex.getMessage()); + () -> WordPdfValidator.validate(out.toByteArray(), ConvertOptions.defaults())); + assertEquals("Архив не является .docx или .xlsx: в [Content_Types].xml нет " + + "декларации документа wordprocessingml или spreadsheetml", ex.getMessage()); + } + + /** .xlsx валиден как OOXML-контейнер: validate не бросает. */ + @Test + void validate_xlsxAccepted() throws Exception { + assertDoesNotThrow(() -> WordPdfValidator.validate( + sample("xlsx-basic.xlsx"), ConvertOptions.defaults())); + } + + // ===== xlsx: isSpreadsheet / checkPageCountXlsx ===== + + @Test + void isSpreadsheet_xlsx_true() throws Exception { + assertTrue(WordPdfValidator.isSpreadsheet(sample("xlsx-basic.xlsx"))); + } + + @Test + void isSpreadsheet_docxAndJunk_false() throws Exception { + assertFalse(WordPdfValidator.isSpreadsheet(sample("ru-plain.docx"))); + assertFalse(WordPdfValidator.isSpreadsheet(new byte[] {1, 2, 3, 4, 5})); + assertFalse(WordPdfValidator.isSpreadsheet(null)); + } + + /** + * Переименованный .docx (zip, манифест wordprocessingml) — не xlsx, + * даже под .xlsx-суффиксом: классификация по манифесту, не по имени. + */ + @Test + void isSpreadsheet_disguisedDocxZip_false() throws Exception { + assertFalse(WordPdfValidator.isSpreadsheet(sample("ru-plain.docx"))); + } + + /** + * Нижняя оценка страниц .xlsx: листы + ручные разрывы. xlsx-basic — + * 2 видимых листа, xlsx-wide — 1 лист + 1 разрыв (строка после 12-й); + * xlsx-page-limit — 1 + 130 = 131 > 100 (точное число в тексте). + */ + @Test + void checkPageCountXlsx_estimates() throws Exception { + assertDoesNotThrow(() -> WordPdfValidator.checkPageCountXlsx( + sample("xlsx-basic.xlsx"), 2)); + assertDoesNotThrow(() -> WordPdfValidator.checkPageCountXlsx( + sample("xlsx-wide.xlsx"), 2)); + ValidationException ex = assertThrows(ValidationException.class, + () -> WordPdfValidator.checkPageCountXlsx( + sample("xlsx-page-limit.xlsx"), PAGE_LIMIT)); + assertTrue(ex.getMessage().contains("не менее 131"), + "1 лист + 130 ручных разрывов: " + ex.getMessage()); + } + + /** + * Скрытые листы в оценку не входят: basic без «Заметки» — 1 страница, + * с лимитом 1 проходит только после сокрытия (синтетика — правка + * workbook.xml в памяти фикстуры допустима: это юнит оценки). + */ + @Test + void checkPageCountXlsx_hiddenSheetsNotCounted() throws Exception { + byte[] patched = replaceInZip(sample("xlsx-basic.xlsx"), "xl/workbook.xml", + " WordPdfValidator.checkPageCountXlsx(patched, 1)); + } + + @Test + void checkPageCountXlsx_bytesNull() { + assertThrows(ValidationException.class, + () -> WordPdfValidator.checkPageCountXlsx((byte[]) null)); + } + + /** Подстрока в XML-записи zip → новые байты архива (для синтетики листов). */ + private static byte[] replaceInZip(byte[] zipBytes, String entryName, + String before, String after) throws Exception { + ByteArrayOutputStream out = new ByteArrayOutputStream(); + try (ZipInputStream zin = new ZipInputStream(new ByteArrayInputStream(zipBytes)); + ZipOutputStream zout = new ZipOutputStream(out)) { + ZipEntry e; + while ((e = zin.getNextEntry()) != null) { + byte[] data = zin.readAllBytes(); + if (entryName.equals(e.getName())) { + data = new String(data, StandardCharsets.UTF_8) + .replace(before, after).getBytes(StandardCharsets.UTF_8); + } + zout.putNextEntry(new ZipEntry(e.getName())); + zout.write(data); + zout.closeEntry(); + } + } + return out.toByteArray(); } /** diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/XlsxPdfConverterTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/XlsxPdfConverterTest.java new file mode 100644 index 0000000..b683398 --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/XlsxPdfConverterTest.java @@ -0,0 +1,219 @@ +package ru.pjandro.wordpdf; + +import org.apache.pdfbox.Loader; +import org.apache.pdfbox.pdmodel.PDDocument; +import org.apache.pdfbox.pdmodel.common.PDRectangle; +import org.apache.pdfbox.text.PDFTextStripper; +import org.junit.jupiter.api.Test; + +import java.io.IOException; +import java.io.InputStream; +import java.nio.file.Files; +import java.util.ArrayList; +import java.util.HashSet; +import java.util.List; +import java.util.Set; +import java.nio.file.Path; + +import org.apache.pdfbox.cos.COSBase; +import org.apache.pdfbox.cos.COSName; +import org.apache.pdfbox.pdmodel.PDPage; +import org.apache.pdfbox.pdmodel.PDResources; +import org.apache.pdfbox.pdmodel.graphics.image.PDImageXObject; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * Сквозная конвертация .xlsx (роутинг моста {@code internal.xlsx} внутри + * {@link WordPdfConverter}) до PDF: текст доезжает, глифов «#» нет, шрифт + * не Helvetica. Остальные аспекты (срезы, numFmt, рисунки) — тесты шагов 5–7. + */ +class XlsxPdfConverterTest { + + private static byte[] sample(String name) throws IOException { + try (InputStream in = XlsxPdfConverterTest.class.getClassLoader() + .getResourceAsStream("samples/" + name)) { + assertNotNull(in, "Нет фикстуры: samples/" + name); + return in.readAllBytes(); + } + } + + private static Path convertPdf(byte[] xlsx) throws IOException { + Path out = Files.createTempFile("xlsx-", ".pdf"); + Files.write(out, WordPdfConverter.convert(xlsx, "xlsx")); + return out; + } + + private static String norm(String s) { + return s.replaceAll("\\s+", " "); + } + + @Test + void basic_ruTextReachesPdf_noHashNoHelvetica() throws IOException { + Path pdf = convertPdf(sample("xlsx-basic.xlsx")); + String text; + try (PDDocument doc = Loader.loadPDF(pdf.toFile())) { + assertTrue(doc.getNumberOfPages() >= 1); + text = norm(new PDFTextStripper().getText(doc)); + } + assertFalse(text.contains("#"), "в PDF есть «#» (не покрыт глиф): " + text); + assertFalse(text.contains("Helvetica"), "FOP ушёл в Helvetica"); + assertTrue(text.contains("Отчёт"), "нет заголовка листа"); + // узкие колонки v1 рвут слова переносом — сравнение без пробелов + String flat = text.replaceAll("\\s+", ""); + assertTrue(flat.contains("Молоко"), "нет данных"); + assertTrue(text.contains("1234.5"), "нет числа"); + assertTrue(flat.contains("ЖИРНЫЙ"), "rich-строка потеряна"); + assertTrue(flat.contains("объединённойячейки"), "merge-текст потерян"); + } + + @Test + void numFmt_formattedNumbersReachPdf() throws IOException { + Path pdf = convertPdf(sample("xlsx-numfmt.xlsx")); + String flat; + try (PDDocument doc = Loader.loadPDF(pdf.toFile())) { + flat = norm(new PDFTextStripper().getText(doc)).replaceAll("\\s+", ""); + } + assertFalse(flat.contains("#"), "в PDF есть «#» (не покрыт глиф)"); + assertTrue(flat.contains("$1,234.00"), "деньги потеряны"); + assertTrue(flat.contains("42.5%"), "проценты потеряны"); + assertTrue(flat.contains("1.22E+07"), "научный потерян"); + assertTrue(flat.contains("03.12.2024"), "дата потеряна"); + assertTrue(flat.contains("36:00"), "elapsed потерян"); + } + + /** Текст каждой страницы отдельной flattened-строкой (без пробелов). */ + private static List pagesFlat(byte[] xlsx) throws IOException { + Path pdf = convertPdf(xlsx); + List pages = new ArrayList<>(); + try (PDDocument doc = Loader.loadPDF(pdf.toFile())) { + PDFTextStripper stripper = new PDFTextStripper(); + for (int p = 1; p <= doc.getNumberOfPages(); p++) { + stripper.setStartPage(p); + stripper.setEndPage(p); + pages.add(stripper.getText(doc).replaceAll("\\s+", "")); + } + } + return pages; + } + + private static int firstPageWith(List pages, String needle) { + for (int i = 0; i < pages.size(); i++) { + if (pages.get(i).contains(needle)) { + return i; + } + } + return -1; + } + + @Test + void wide_columnSlicing_rightSliceOwnPage() throws IOException { + List pages = pagesFlat(sample("xlsx-wide.xlsx")); + assertTrue(pages.size() >= 4, + "40 столбцов × 60 строк не влезают в " + pages.size() + " страниц(ы)"); + int left = firstPageWith(pages, "R60C1R60C2"); + int right = firstPageWith(pages, "R60C39R60C40"); + assertTrue(left >= 0, "нет левого среза на строке 60"); + assertTrue(right >= 0, "нет правого среза на строке 60"); + assertTrue(left != right, "последние столбцы на одной странице с первыми"); + } + + @Test + void wide_rowBreak_splitAfterRow12() throws IOException { + List pages = pagesFlat(sample("xlsx-wide.xlsx")); + int before = firstPageWith(pages, "R12C1R12C2"); + int after = firstPageWith(pages, "R13C1R13C2"); + assertTrue(before >= 0 && after >= 0, "строки 12/13 не найдены"); + assertTrue(after > before, "ручного разрыва после 12-й строки нет: " + + before + " → " + after); + assertTrue(pages.stream().anyMatch(p -> p.contains("R13C39R13C40")), + "второй вертикальный фрагмент дошёл только левым срезом"); + } + + @Test + void fitToPage_singleLandscapeWidthFit() throws IOException { + Path pdf = convertPdf(sample("xlsx-fit-to-page.xlsx")); + try (PDDocument doc = Loader.loadPDF(pdf.toFile())) { + assertEquals(1, doc.getNumberOfPages(), + "fitToWidth=1 — 20 столбцов обязаны влезть на одну страницу"); + PDRectangle box = doc.getPage(0).getMediaBox(); + assertTrue(box.getWidth() > box.getHeight(), "landscape A4 ожидается: " + box); + String flat = new PDFTextStripper().getText(doc).replaceAll("\\s+", ""); + assertTrue(flat.contains("F10-20"), "последний столбец не доехал"); + } + } + + @Test + void sectionPerSheet_pageSizeFollowsSection() throws IOException { + // xlsx-numfmt — Legal (612×1008 pt), xlsx-basic — A4 (≈595.3×841.9) + try (PDDocument legal = Loader.loadPDF(convertPdf(sample("xlsx-numfmt.xlsx")).toFile())) { + PDRectangle box = legal.getPage(0).getMediaBox(); + assertEquals(612, box.getWidth(), 1); + assertEquals(1008, box.getHeight(), 1); + } + try (PDDocument a4 = Loader.loadPDF(convertPdf(sample("xlsx-basic.xlsx")).toFile())) { + PDRectangle box = a4.getPage(0).getMediaBox(); + assertEquals(595.3, box.getWidth(), 1); + assertEquals(841.9, box.getHeight(), 1); + } + } + + /** Количество Image XObject на всех страницах PDF. */ + private static int imageCount(Path pdf) throws IOException { + int count = 0; + try (PDDocument doc = Loader.loadPDF(pdf.toFile())) { + for (PDPage page : doc.getPages()) { + PDResources res = page.getResources(); + for (COSName name : res.getXObjectNames()) { + if (res.isImageXObject(name)) { + count++; + } + } + } + } + return count; + } + + /** Различные image-потоки без SMask (как в WordPdfConverterTest). */ + private static int distinctImageCount(Path pdf) throws IOException { + Set streams = new HashSet<>(); + try (PDDocument doc = Loader.loadPDF(pdf.toFile())) { + for (PDPage page : doc.getPages()) { + PDResources res = page.getResources(); + for (COSName name : res.getXObjectNames()) { + if (res.isImageXObject(name)) { + PDImageXObject img = + (PDImageXObject) + res.getXObject(name); + if (img.getSoftMask() == null) { + streams.add(img.getCOSObject()); + } + } + } + } + } + return streams.size(); + } + + @Test + void chartImage_imageCountAndNoCrash() throws IOException { + Path pdf = convertPdf(sample("xlsx-chart-image.xlsx")); + // PNG-картинка + 2 диаграммы (step 3.5 дорисовывает c:chart в PNG) + assertTrue(imageCount(pdf) >= 3, "растров мало: " + imageCount(pdf)); + assertTrue(distinctImageCount(pdf) >= 2, + "растры не различаются: " + distinctImageCount(pdf)); + } + + @Test + void errorOnCharts_xlsxRejectsWithChartKind() throws IOException { + DrawingFoundException e = assertThrows(DrawingFoundException.class, + () -> WordPdfConverter.convert(sample("xlsx-chart-image.xlsx"), "xlsx", + new ConvertOptions(true, false, false, + WordPdfSettings.MAX_INPUT_MB, WordPdfSettings.MAX_PAGES))); + assertEquals(DrawingFoundException.Kind.CHARTS, e.kind()); + } +} diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/DocToDocxFormattingTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/DocToDocxFormattingTest.java index adbe10e..42f4829 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/DocToDocxFormattingTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/doc/DocToDocxFormattingTest.java @@ -1564,7 +1564,7 @@ class DocToDocxFormattingTest { * Поле HYPERLINK: инструкция → w:hyperlink r:id="hl0" + внешняя связь * TargetMode="External" (экранирование & в Target), результат поля — * содержимое ссылки; текст инструкции и URL в вывод не попадают. - * Регрессия — DocxBody#hyperlinkUrl + DocxWriter#documentRels. + * Регрессия — DocxBody#hyperlinkUrl + DocxPackageWriter#documentRels. */ @Test void hyperlink_quotedUrl_becomesExternalLink() throws IOException { diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/ColorResolverTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/ColorResolverTest.java new file mode 100644 index 0000000..555ff70 --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/ColorResolverTest.java @@ -0,0 +1,89 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNull; + +import java.util.List; +import java.util.zip.ZipOutputStream; +import org.junit.jupiter.api.Test; + +/** + * Разрешение ColorSpec → RRGGBB: rgb/ARGB, тема (дефолтный Office-схема + * clrScheme), легаси-палитра indexed + переопределение 64+n из styles + * colors, tint/shade (HSL-модуляция, MS-OI29500 §2.3.1.6.16). + */ +class ColorResolverTest { + + private static final WarnOnce WARN = new WarnOnce(); + + private static ColorResolver resolver() throws Exception { + byte[] emptyZip; + try (java.io.ByteArrayOutputStream bos = new java.io.ByteArrayOutputStream()) { + try (ZipOutputStream z = new ZipOutputStream(bos)) { + z.finish(); + } + emptyZip = bos.toByteArray(); + } + // ThemeModel без theme1.xml — дефолтный Office-схема (accent1 = 4472C4) + return new ColorResolver(ThemeModel.read(XlsxPackage.read(emptyZip), WARN), List.of()); + } + + @Test + void rgbLiteral() throws Exception { + assertEquals("FF0000", resolver().resolve( + new ColorSpec("FF0000", null, null, null, null))); + } + + @Test + void argbLosesAlpha() throws Exception { + assertEquals("00FF00", resolver().resolve( + new ColorSpec("FF00FF00", null, null, null, null))); + } + + @Test + void themeAccent1() throws Exception { + assertEquals("4472C4", resolver().resolve( + new ColorSpec(null, null, 4, null, null))); + } + + @Test + void themeTint() throws Exception { + // HLS-модуляция светлоты (MS-OI29500 §2.3.1.6.16): accent1 4472C4, + // tint 0.6 → L 0.5176→0.8070 + assertEquals("B4C7E7", resolver().resolve( + new ColorSpec(null, null, 4, 0.6, null))); + } + + @Test + void indexedLegacyPalette() throws Exception { + // Excel 97: 8=чёрный, 10=красный + assertEquals("000000", resolver().resolve( + new ColorSpec(null, 8, null, null, null))); + assertEquals("FF0000", resolver().resolve( + new ColorSpec(null, 10, null, null, null))); + } + + @Test + void indexedOverrideFromStyles() throws Exception { + ColorResolver r = new ColorResolver( + ThemeModel.read(XlsxPackage.read(new byte[0]), WARN), List.of("112233")); + assertEquals("112233", r.resolve(new ColorSpec(null, 64, null, null, null))); + assertNull(r.resolve(new ColorSpec(null, 66, null, null, null))); + } + + @Test + void unresolvableIsEmpty() throws Exception { + ColorResolver r = resolver(); + assertNull(r.resolve(null)); + assertNull(r.resolve(new ColorSpec(null, null, null, null, null))); + assertNull(r.resolve(new ColorSpec("zzzzzz", null, null, null, null))); + assertNull(r.resolve(new ColorSpec(null, null, 99, null, null))); + } + + @Test + void shadeDarkens() throws Exception { + // FFFF00 shade −0.5: L 0.5→0.25, тон/насыщенность сохраняются + assertEquals("7F8000", resolver().resolve( + new ColorSpec("FFFF00", null, null, null, -0.5))); + } +} diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/ColorSpecTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/ColorSpecTest.java new file mode 100644 index 0000000..0ee2673 --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/ColorSpecTest.java @@ -0,0 +1,66 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertTrue; + +import java.io.StringReader; + +import javax.xml.stream.XMLStreamReader; + +import org.junit.jupiter.api.Test; + +/** Разбор CT_Color (§18.18.15) и числовые фолбэки атрибутов. */ +class ColorSpecTest { + + private static ColorSpec parse(String elementXml) throws Exception { + XMLStreamReader xr = XlsxPackage.newSecureReader() + .createXMLStreamReader(new StringReader(elementXml)); + xr.next(); + ColorSpec spec = ColorSpec.fromColorElement(xr); + xr.close(); + return spec; + } + + @Test + void emptyElement_isAuto() throws Exception { + ColorSpec auto = parse(""); + assertTrue(auto.isEmpty()); + assertNull(auto.rgb()); + assertEquals(ColorSpec.AUTO, auto); + } + + @Test + void allAttributes_parsed() throws Exception { + ColorSpec spec = parse(""); + assertEquals("FFFF0000", spec.rgb()); + assertEquals(4, spec.theme()); + assertEquals(0.4, spec.tint()); + assertEquals(-0.2, spec.shade()); + } + + @Test + void brokenTintOnly_degradesToAuto() throws Exception { + ColorSpec spec = parse(""); + assertNull(spec.tint(), "не-числовой tint — null"); + assertEquals(ColorSpec.AUTO, spec, "единственный атрибут битый — auto"); + } + + @Test + void parseInt_parseDouble_garbageNull() { + assertNull(ColorSpec.parseInt(null)); + assertNull(ColorSpec.parseInt("1.5")); + assertEquals(-3, ColorSpec.parseInt("-3")); + assertNull(ColorSpec.parseDouble(null)); + assertNull(ColorSpec.parseDouble("abc")); + assertEquals(-1.5e-3, ColorSpec.parseDouble("-1.5e-3")); + } + + @Test + void rgbHelper() { + ColorSpec spec = ColorSpec.rgb("AABBCC"); + assertEquals("AABBCC", spec.rgb()); + assertTrue(spec.tint() == null && spec.theme() == null); + } +} diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/DrawingBridgeTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/DrawingBridgeTest.java new file mode 100644 index 0000000..1f3c4ab --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/DrawingBridgeTest.java @@ -0,0 +1,275 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import java.io.IOException; +import java.util.ArrayList; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; + +import org.junit.jupiter.api.Test; + +import ru.pjandro.wordpdf.internal.DocxPackageWriter; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * Мост рисунков .xlsx: EMU-extent по якорям, media/chart-части, clamp + * скрытых якорей, отбрасывание фигур/SmartArt/внешних связей/гигантских + * extent. Пакеты — крафт {@link XlsxTestZips}. + */ +class DrawingBridgeTest { + + private static final String XDR = "xmlns:xdr=\"http://schemas.openxmlformats.org" + + "/drawingml/2006/spreadsheetDrawing\" xmlns:a=\"http://schemas.openxmlformats" + + ".org/drawingml/2006/main\" xmlns:r=\"http://schemas.openxmlformats.org" + + "/officeDocument/2006/relationships\""; + + /** Лист + drawing-часть в одном пакете. */ + private record Ctx(SheetModel sheet, XlsxPackage pkg) { + } + + private static Ctx build(String sheetBody, String anchors, Map extra) + throws IOException { + Map parts = new LinkedHashMap<>(); + // лист обязан ссылаться на рисунок элементом — путь + // resolving идёт по нему (как в реальных .xlsx), а не по релсам + parts.put("xl/worksheets/sheet1.xml", + XlsxTestZips.sheet(sheetBody + "")); + parts.put("xl/worksheets/_rels/sheet1.xml.rels", rels( + new String[] {"d1", XlsxTestZips.REL_DRAWING, "../drawings/drawing1.xml"})); + parts.put("xl/drawings/drawing1.xml", + "" + anchors + ""); + parts.putAll(extra); + XlsxPackage pkg = XlsxTestZips.workbook("Лист1|", parts); + SheetModel sheet = SheetModel.read(pkg, WorkbookModel.read(pkg).sheets().get(0), + new WarnOnce()); + return new Ctx(sheet, pkg); + } + + private static String rels(String[]... triples) { + StringBuilder sb = new StringBuilder( + ""); + for (String[] t : triples) { + sb.append(""); + } + return sb.append("").toString(); + } + + private static String imageRels(String id, String target) { + return rels(new String[] {id, + "http://schemas.openxmlformats.org/officeDocument/2006/relationships/image", + target}); + } + + private static Metrics metrics() { + return Metrics.forNormalFamily("Carlito"); + } + + private static List read(Ctx ctx, + List parts) { + return new DrawingBridge(parts, new WarnOnce()).read(ctx.pkg(), ctx.sheet(), metrics()); + } + + @Test + void picTwoCellAnchor_extentFromCellGeometry() throws IOException { + Ctx ctx = build(""" + + 1""", + """ + + 00 + 00 + 20 + 20 + + + + + """, + Map.of("xl/drawings/_rels/drawing1.xml.rels", imageRels("e1", "../media/i.png"), + "xl/media/i.png", "PNGDATA")); + List parts = new ArrayList<>(); + List out = read(ctx, parts); + assertEquals(1, out.size()); + DrawingBridge.Placement pl = out.get(0); + assertEquals(1, pl.row1()); + assertEquals(0, pl.col()); + long cx = DrawingBridge.cellX(ctx.sheet(), metrics(), 2); + long cy = DrawingBridge.cellY(ctx.sheet(), metrics(), 2); + assertTrue(pl.runXml().contains(""), + pl.runXml()); + assertEquals("word/media/xlsx-image1.png", parts.get(0).entry()); + assertEquals("image/png", parts.get(0).contentType()); + assertTrue(pl.runXml().contains("r:embed=\"rId1\"")); + assertTrue(pl.runXml().contains("", + """ + + 1100 + 3200 + + + + + + """, + Map.of("xl/drawings/_rels/drawing1.xml.rels", imageRels("e1", "../media/i.png"), + "xl/media/i.png", "X")); + List out = read(ctx, new ArrayList<>()); + assertEquals(1, out.size()); + assertTrue(out.get(0).runXml().contains(""), + "a:ext внутри pic не должен затирать xdr:ext: " + out.get(0).runXml()); + assertEquals(4, out.get(0).row1()); + assertEquals(1, out.get(0).col()); + } + + @Test + void chartAnchor_copiesPartKeepsGraphicData() throws IOException { + Ctx ctx = build("", + """ + + 00 + 00 + 10 + 10 + + + + + + """, + Map.of("xl/drawings/_rels/drawing1.xml.rels", rels(new String[] {"ch1", + "http://schemas.openxmlformats.org/officeDocument/2006/relationships" + + "/chart", + "../charts/chart1.xml"}), + "xl/charts/chart1.xml", "данные")); + List parts = new ArrayList<>(); + List out = read(ctx, parts); + assertEquals(1, out.size()); + assertEquals("word/charts/xlsx-chart1.xml", parts.get(0).entry()); + assertTrue(out.get(0).runXml().contains(""), out.get(0).runXml()); + assertTrue(out.get(0).runXml().contains("")); + } + + @Test + void giantExtentShapeDiagram_skipped() throws IOException { + Ctx ctx = build("", + """ + + 00 + 00 + + + + + + 00 + 00 + 10 + 10 + + + + """, + Map.of("xl/drawings/_rels/drawing1.xml.rels", imageRels("e1", "../media/i.png"), + "xl/media/i.png", "X")); + assertTrue(read(ctx, new ArrayList<>()).isEmpty(), + "гигантский extent/фигура/SmartArt не эмитятся"); + } + + @Test + void missingMediaOrExternal_skipped() throws IOException { + Ctx ctx = build("", + """ + + 00 + 00 + + + + + 00 + 10 + + + """, + Map.of("xl/drawings/_rels/drawing1.xml.rels", + "" + + "")); + List parts = new ArrayList<>(); + assertTrue(read(ctx, parts).isEmpty()); + assertTrue(parts.isEmpty()); + } + + @Test + void byCell_clampsHiddenAnchorRowAndCol() throws IOException { + Ctx ctx = build(""" + + + + + + """, "", Map.of()); + Map> map = DrawingBridge.byCell(List.of( + new DrawingBridge.Placement(1, 1, "1"), + new DrawingBridge.Placement(1, 0, "2")), ctx.sheet()); + // строка 1 скрыта → 2; колонка 2 скрыта → 3 (за описанием — видимая) + assertEquals(List.of("1"), map.get(2L << 32 | 2), map.keySet().toString()); + assertEquals(List.of("2"), map.get(2L << 32 | 0), map.keySet().toString()); + } + + @Test + void cellCumulative_hiddenContributeZero() throws IOException { + Ctx ctx = build(""" + + + + + + + + """, "", Map.of()); + Metrics m = metrics(); + long colW = Metrics.pxToEmu(75); // 10 знаков Carlito (MDW 7): 70+5 px + assertEquals(colW, DrawingBridge.cellX(ctx.sheet(), m, 1)); + assertEquals(colW, DrawingBridge.cellX(ctx.sheet(), m, 2), + "hidden-колонка не даёт вклада"); + assertEquals(2 * colW, DrawingBridge.cellX(ctx.sheet(), m, 3)); + assertEquals(20 * 12700, DrawingBridge.cellY(ctx.sheet(), m, 1)); + assertEquals(20 * 12700, DrawingBridge.cellY(ctx.sheet(), m, 2), + "hidden-строка не даёт вклада"); + assertEquals(20 * 12700 + 15 * 12700, DrawingBridge.cellY(ctx.sheet(), m, 3), + "после скрытых — дефолтная высота 15pt"); + } + + @Test + void themePart_emittedWhenPresent() throws IOException { + Map parts = new LinkedHashMap<>(); + parts.put("xl/theme/theme1.xml", "палитра"); + XlsxPackage pkg = XlsxTestZips.workbook("Лист1|", parts); + List out = new ArrayList<>(); + DrawingBridge.emitTheme(pkg, out); + assertEquals(1, out.size()); + assertEquals("word/theme/theme1.xml", out.get(0).entry()); + assertTrue(out.get(0).relType().endsWith("/theme")); + } +} diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/MetricsTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/MetricsTest.java new file mode 100644 index 0000000..778c406 --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/MetricsTest.java @@ -0,0 +1,43 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertTrue; + +import org.junit.jupiter.api.Test; + +/** MDW Normal-семейства и формула ширины столбца §18.3.1.13/MS-OI29500. */ +class MetricsTest { + + @Test + void mdw_carlitoIsCanonical7() { + Metrics metrics = Metrics.forNormalFamily("Calibri"); + assertEquals(7, metrics.mdw(), "Calibri→Carlito 11pt MDW = 7 px"); + assertEquals(metrics.mdw(), Metrics.forNormalFamily(null).mdw(), + "нет имени — Carlito"); + assertEquals(metrics.mdw(), Metrics.forNormalFamily("НетТакого").mdw(), + "вне бандла — Carlito"); + assertTrue(Metrics.forNormalFamily("DEJAVU SANS").mdw() >= 1, + "регистр имени не важен, MDW > 0"); + } + + @Test + void colWidthPx_canonical64() { + Metrics metrics = Metrics.forNormalFamily("Calibri"); + assertEquals(64, metrics.colWidthPx(8.43, 8.0, false), + "w=8.43, MDW=7 → канонические 64 px"); + assertEquals(0, metrics.colWidthPx(8.43, 8.0, true), "hidden — 0"); + assertEquals(0, metrics.colWidthPx(null, 8.0, true), "hidden без width — тоже 0"); + assertEquals(metrics.defaultWidthPx(8.0), metrics.colWidthPx(null, 8.0, false)); + assertTrue(metrics.defaultWidthPx(8.0) > 60); + assertTrue(metrics.colWidthPx(20.0, 8.0, false) > metrics.colWidthPx(10.0, 8.0, false)); + } + + @Test + void unitConversions() { + assertEquals(150, Metrics.pxToTwips(10)); + assertEquals(95250L, Metrics.pxToEmu(10)); + assertEquals(400, Metrics.ptToTwips(20)); + assertEquals(1440, Metrics.inchesToTwips(1)); + assertEquals(144, Metrics.ptToTwips(7.2)); + } +} diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/NumberFormatsTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/NumberFormatsTest.java new file mode 100644 index 0000000..8bb7aea --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/NumberFormatsTest.java @@ -0,0 +1,363 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import static org.junit.jupiter.api.Assertions.assertEquals; + +import java.util.Map; +import org.junit.jupiter.api.Test; + +/** + * Движок форматных кодов SpreadsheetML (§18.8.31): встроенные id, кастомы + * из фикстуры samples/xlsx-numfmt.xlsx и эталонные пары Excel. Деградации + * (мнимый 29.02.1900 → 28.02, дробный формат → General) закреплены здесь же. + */ +class NumberFormatsTest { + + private static NumberFormats custom(String code) { + return new NumberFormats(Map.of(164, code), false); + } + + private static String fmt(String code, String raw) { + return custom(code).format(164, raw, new WarnOnce()); + } + + private static String builtin(int id, String raw) { + return new NumberFormats(Map.of(), false).format(id, raw, new WarnOnce()); + } + + // ================== встроенные id ================== + + @Test + void builtinTwoDecimals() { + assertEquals("3.14", builtin(2, "3.14159")); + } + + @Test + void builtinThousands() { + assertEquals("1,235", builtin(3, "1234.5")); + assertEquals("1,234.50", builtin(4, "1234.5")); + } + + @Test + void builtinPercent() { + assertEquals("43%", builtin(9, "0.425")); + } + + @Test + void builtinDate() { + // id 14 — код «mm-dd-yy», вывод locale-independent (месяц первым) + assertEquals("12-03-24", builtin(14, "45629")); + assertEquals("3-Dec", builtin(16, "45629")); + assertEquals("(1,234.50)", builtin(39, "-1234.5")); + } + + @Test + void builtinTime() { + assertEquals("18:00", builtin(20, "0.75")); + } + + @Test + void builtinDateTime() { + assertEquals("12/3/24 18:30", builtin(22, "45629.7708333333")); + } + + @Test + void builtinElapsed() { + assertEquals("36:00:00", builtin(46, "1.5")); + } + + // ================== кастомные коды фикстуры ================== + + @Test + void twoDecimals() { + assertEquals("3.14", fmt("0.00", "3.14159")); + } + + @Test + void thousands() { + assertEquals("1,235", fmt("#,##0", "1234.5")); + } + + @Test + void moneySections() { + assertEquals("$1,234.00", fmt("$#,##0.00_);($#,##0.00)", "1234.0")); + assertEquals("($1,234.50)", fmt("$#,##0.00_);($#,##0.00)", "-1234.5")); + } + + @Test + void percent() { + assertEquals("42.5%", fmt("0.0%", "0.425")); + } + + @Test + void scientific() { + assertEquals("1.22E+07", fmt("0.00E+00", "12234567")); + } + + @Test + void scaleMillions() { + assertEquals("12", fmt("#,##0,,", "12345678")); + } + + @Test + void dateCustom() { + assertEquals("03.12.2024", fmt("dd.mm.yyyy", "45629")); + } + + @Test + void weekdayShort() { + assertEquals("Tue", fmt("ddd", "45629")); + } + + @Test + void longDateTimeMonthVsMinutes() { + // «mmmm» после yyyy — месяц; «mm» после hh — минуты (контекст соседа) + assertEquals("03 December 2024 18:30", fmt("dd mmmm yyyy hh:mm", "45629.7708333333")); + } + + @Test + void elapsedHours() { + assertEquals("36:00", fmt("[h]:mm", "1.5")); + } + + @Test + void colorSectionStripped() { + assertEquals("-1.50", fmt("[Red]0.00", "-1.5")); + } + + @Test + void accountingSections() { + String code = "_(* #,##0_);_(* (#,##0);_(* \"-\"??);_(@)"; + assertEquals("1,235", fmt(code, "1234.56")); + assertEquals("(1,235)", fmt(code, "-1234.56")); + // accounting: минус выравнивается в колонке знаков, «)» печатается всегда + assertEquals("-)", fmt(code, "0")); + } + + @Test + void signSections() { + assertEquals("2.50", fmt("0.00;-0.00;0.00;@", "2.5")); + assertEquals("-2.50", fmt("0.00;-0.00;0.00;@", "-2.5")); + assertEquals("0.00", fmt("0.00;-0.00;0.00;@", "0")); + } + + @Test + void negativeZeroIsZero() { + assertEquals("0.00", fmt("0.00", "-0.0")); + } + + @Test + void fakeFeb29_1900degradesTo28() { + assertEquals("28.02.1900", fmt("dd.mm.yyyy", "60")); + assertEquals("01.03.1900", fmt("dd.mm.yyyy", "61")); + assertEquals("01.01.1900", fmt("dd.mm.yyyy", "1")); + } + + @Test + void ampm() { + assertEquals("6:00 PM", fmt("h:mm AM/PM", "0.75")); + assertEquals("6:00 P", fmt("h:mm A/P", "0.75")); + } + + @Test + void optionalHashDecimalTrimmed() { + // «0» после точки обязателен, хвост «#» с нулями обрезается + assertEquals("1.5", fmt("0.0##", "1.5")); + assertEquals("1.0", fmt("0.0##", "1")); + assertEquals("1.234", fmt("0.0##", "1.234")); + assertEquals("1.23", fmt("0.0#", "1.234")); + } + + @Test + void optionalIntegerZero() { + assertEquals(".5", fmt("#.##", "0.5")); + assertEquals("12.5", fmt("#.##", "12.5")); + } + + @Test + void textCodeFallsBackToGeneral() { + assertEquals("5", fmt("@", "5")); + } + + @Test + void fractionDegradesToGeneral() { + assertEquals("1.4", fmt("5/8", "1.4")); + } + + @Test + void brokenNumberPassesThrough() { + assertEquals("abc", fmt("0.00", "abc")); + } + + @Test + void unknownIdGeneral() { + assertEquals("123456.789", new NumberFormats(Map.of(), false) + .format(9999, "123456.789", new WarnOnce())); + } + + // ================== эпоха 1904 ================== + + @Test + void epoch1904() { + NumberFormats nf = new NumberFormats(Map.of(164, "dd.mm.yyyy hh:mm"), true); + assertEquals("01.01.1904 00:00", nf.format(164, "0", new WarnOnce())); + assertEquals("02.03.1904 00:00", nf.format(164, "61", new WarnOnce())); + } + + @Test + void negativeIn1904StillDates() { + // в эпохе 1904 отрицательные сериальники календарны (Excel так же) + assertEquals("30.12.1903", new NumberFormats(Map.of(164, "dd.mm.yyyy"), true) + .format(164, "-1.5", new WarnOnce())); + } + + // ================== синтаксис кода ================== + + @Test + void escapedSemicolonDoesNotSplitSections() { + assertEquals(";5.00", fmt("\\;0.00", "5")); + } + + @Test + void semicolonInBracketsDoesNotSplit() { + assertEquals("7", fmt("[a;b]0", "7")); + } + + @Test + void quotedAndBackslashLiterals() { + assertEquals("ab5", fmt("\"ab\"#", "5")); + assertEquals("$5", fmt("\\$0", "5")); + assertEquals("a\"b5", fmt("\"a\\\"b\"0", "5")); + } + + @Test + void unterminatedQuoteDegradesToGeneral() { + assertEquals("5", fmt("\"abc0", "5")); + } + + @Test + void underscoreAndStarPaddingStripped() { + assertEquals("1,235", fmt("_(* #,##0", "1234.5")); + } + + @Test + void trailingSpecialsBecomeLiterals() { + assertEquals("5_", fmt("0_", "5")); + assertEquals("5*", fmt("0*", "5")); + assertEquals("5\\", fmt("0\\", "5")); + } + + @Test + void currencyBracketLiteral() { + assertEquals("US5", fmt("[$US]0", "5")); + assertEquals("5", fmt("[$$-419]0", "5")); + } + + @Test + void emptyBracketSkipped() { + assertEquals("5", fmt("[]0", "5")); + } + + @Test + void percentBeforeNumberKeepsPosition() { + assertEquals("%42.5", fmt("%0.0", "0.425")); + } + + @Test + void generalCodeIsGeneral() { + assertEquals("5", fmt("General", "5")); + assertEquals("5", new NumberFormats(Map.of(), false) + .format(0, "5", new WarnOnce())); + } + + @Test + void questionMarkDigits() { + assertEquals("5.50", fmt("??0.00", "5.5")); + assertEquals("1235", fmt("#?#?0", "1234.5")); + } + + @Test + void decimalWithoutInteger() { + assertEquals(".5", fmt(".##", "0.5")); + } + + @Test + void twoDecimalZonesConcatenate() { + // вторая точка-зона дописывается в ту же дробную маску + assertEquals("01.40x", fmt("0.0x0.0", "1.4")); + } + + @Test + void zeroPaddingToMask() { + assertEquals("00007", fmt("00000", "7")); + } + + @Test + void forcedZeroDecimalsKept() { + assertEquals("1.5", fmt("0.0#", "1.5")); + } + + @Test + void twoSectionsZeroUsesFirst() { + assertEquals("0.00", fmt("0.00;-0.00", "0")); + assertEquals("-1.00", fmt("0.00;-0.00", "-1")); + } + + // ================== дата/время: детали ================== + + @Test + void monthContextFromNeighbor() { + assertEquals("12", fmt("m", "45629")); + assertEquals("3 12", fmt("d m", "45629")); + assertEquals("18 0", fmt("h m", "0.75")); + assertEquals("0 0", fmt("m s", "0.75")); + } + + @Test + void dayAndMonthWidths() { + assertEquals("3", fmt("d", "45629")); + assertEquals("Tuesday", fmt("dddd", "45629")); + assertEquals("12", fmt("m", "45629")); + assertEquals("Dec", fmt("mmm", "45629")); + assertEquals("D", fmt("mmmmm", "45629")); + } + + @Test + void elapsedAllUnits() { + assertEquals("2160", fmt("[m]", "1.5")); + assertEquals("129600", fmt("[s]", "1.5")); + assertEquals("2160:00", fmt("[mm]:ss", "1.5")); + } + + @Test + void hour12MidnightAndNoon() { + assertEquals("12:00 AM", fmt("h:mm AM/PM", "0")); + assertEquals("12:00 PM", fmt("h:mm AM/PM", "0.5")); + } + + @Test + void narrowTimeFields() { + assertEquals("18:0", fmt("h:m", "0.75")); + assertEquals("0", fmt("s", "0.5")); + } + + @Test + void lowercaseAmPm() { + assertEquals("6:00 am", fmt("h:mm am/pm", "0.25")); + assertEquals("6:00 p", fmt("h:mm a/p", "0.75")); + } + + @Test + void dateMinusNumberTokIgnored() { + assertEquals("18:00", fmt("h:mm.0", "0.75")); + } + + @Test + void negativeDate1900IsGeneral() { + assertEquals("-5", fmt("dd.mm.yyyy", "-5")); + } + + @Test + void scientificNegativeExponent() { + assertEquals("1.23E-04", fmt("0.00E+00", "0.00012345")); + } +} diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/NumberTextTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/NumberTextTest.java new file mode 100644 index 0000000..0ff69be --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/NumberTextTest.java @@ -0,0 +1,65 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import static org.junit.jupiter.api.Assertions.assertEquals; + +import org.junit.jupiter.api.Test; + +/** General-вывод §18.8.30 и типы {@code @t} (boolean/ошибка/кэш-формула). */ +class NumberTextTest { + + @Test + void of_types() { + assertEquals("", NumberText.of(null, "s")); + assertEquals("TRUE", NumberText.of("1", "b")); + assertEquals("FALSE", NumberText.of("0", "b")); + assertEquals("FALSE", NumberText.of("2", "b")); + assertEquals("#DIV/0!", NumberText.of("#DIV/0!", "e")); + assertEquals("кэш", NumberText.of("кэш", "str")); + assertEquals("2024-01-02", NumberText.of("2024-01-02", "d")); + assertEquals("1.5", NumberText.of("1.5", "n")); + assertEquals("1.5", NumberText.of("1.5", null), "тип без @t — число"); + assertEquals("чужойТип", NumberText.of("чужойТип", "zz"), + "неизвестный тип — general-обход"); + } + + @Test + void general_integersAndPassthrough() { + assertEquals("42", NumberText.general("42")); + assertEquals("42", NumberText.general("42.0")); + assertEquals("-7", NumberText.general("-7")); + assertEquals("0", NumberText.general("-0.0")); + assertEquals("9999999999", NumberText.general("9999999999"), + "10 знаков — ещё десятичная запись"); + assertEquals("не число", NumberText.general("не число")); + assertEquals("1.5", NumberText.general(" 1.5 ")); + } + + @Test + void general_scientificBoundaries() { + assertEquals("1E+10", NumberText.general("10000000000"), + "11-й знак — научный, как Excel General"); + assertEquals("1E+15", NumberText.general("1000000000000000")); + assertEquals("1E-10", NumberText.general("0.0000000001")); + assertEquals("5E-10", NumberText.general("0.0000000005")); + assertEquals("-2500000000", NumberText.general("-2500000000.0")); + assertEquals("1.23456789E+20", NumberText.general("123456789012000000000"), + "10 значащих знаков"); + } + + @Test + void decimal_shortestRoundTrip() { + assertEquals("0.5", NumberText.general("0.5")); + assertEquals("0.30000000000000004", NumberText.general("0.30000000000000004"), + "shortest round-trip без обрезания"); + assertEquals("0.000000001", NumberText.general("0.000000001"), + "abs == 1e-9 — нижняя граница десятичного диапазона"); + assertEquals("9999999999.5", NumberText.general("9999999999.5")); + } + + @Test + void scientific_twoDigitExponent() { + assertEquals("1.5E+20", NumberText.general("1.5e20")); + assertEquals("1E+105", NumberText.general("1e105")); + assertEquals("-1.5E-20", NumberText.general("-1.5e-20")); + } +} diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/PrintLayoutTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/PrintLayoutTest.java new file mode 100644 index 0000000..41c10a8 --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/PrintLayoutTest.java @@ -0,0 +1,227 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import java.io.IOException; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; + +import org.junit.jupiter.api.Test; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * Печатная раскладка: карта бумаги + ориентация/margins, greedy-нарезка + * колонок, fitToWidth-масштаб, вертикальные фрагменты {@code rowBreaks}, + * XML секции {@code w:sectPr}. + */ +class PrintLayoutTest { + + private static SheetModel readSheet(String body) throws IOException { + Map parts = new LinkedHashMap<>(); + parts.put("xl/worksheets/sheet1.xml", XlsxTestZips.sheet(body)); + XlsxPackage pkg = XlsxTestZips.workbook("Лист1|", parts); + return SheetModel.read(pkg, WorkbookModel.read(pkg).sheets().get(0), new WarnOnce()); + } + + /** Строка 1 с числами в колонках 0..n-1 (растягивает used-range до n). */ + private static String dataRow(int cols) { + StringBuilder sb = new StringBuilder(""); + for (int c = 0; c < cols; c++) { + sb.append("1"); + } + return sb.append("").toString(); + } + + private static PrintLayout.Plan planOf(SheetModel model) { + WarnOnce warn = new WarnOnce(); + PrintLayout.Page page = PrintLayout.page(model, warn); + return PrintLayout.plan(model, Metrics.forNormalFamily("Carlito"), page, warn); + } + + @Test + void page_paperMapAndLandscapeSwap() throws IOException { + // Legal (5) книжная: 12240×20160; landscape — стороны меняются + PrintLayout.Page legal = PrintLayout.page(readSheet(""" + """), new WarnOnce()); + assertEquals(12240, legal.width()); + assertEquals(20160, legal.height()); + PrintLayout.Page legalLand = PrintLayout.page(readSheet(""" + """), + new WarnOnce()); + assertEquals(20160, legalLand.width()); + assertEquals(12240, legalLand.height()); + assertTrue(legalLand.landscape()); + } + + @Test + void page_unknownPaperAndMissing_fallToA4() throws IOException { + PrintLayout.Page unknown = PrintLayout.page(readSheet(""" + """), new WarnOnce()); + assertEquals(11906, unknown.width()); + assertEquals(16839, unknown.height()); + PrintLayout.Page missing = PrintLayout.page( + readSheet(""), new WarnOnce()); + assertEquals(11906, missing.width(), "без pageSetup — A4 по дефолту SheetModel"); + } + + @Test + void page_marginsInchesToTwips() throws IOException { + PrintLayout.Page p = PrintLayout.page(readSheet(""" + + """), + new WarnOnce()); + assertEquals(720, p.left()); + assertEquals(720, p.right()); + assertEquals(1440, p.top()); + assertEquals(1800, p.bottom()); + assertEquals(360, p.header()); + assertEquals(288, p.footer()); + assertEquals(16839 - 1440, p.usableWidth()); + } + + @Test + void plan_wideColumns_greedySlices() throws IOException { + // 4 колонки по 40 знаков на A4 (usable 9890): две влезает, три нет + SheetModel model = readSheet(""" + + + + """ + dataRow(4)); + PrintLayout.Plan plan = planOf(model); + assertEquals(1.0, plan.widthScale()); + assertEquals(2, plan.blocks().size()); + assertEquals(List.of(0, 1), plan.blocks().get(0).cols()); + assertEquals(List.of(2, 3), plan.blocks().get(1).cols()); + PrintLayout.Page page = PrintLayout.page(model, new WarnOnce()); + for (PrintLayout.Block b : plan.blocks()) { + int sum = 0; + for (int c : b.cols()) { + sum += PrintLayout.colTwips(model, Metrics.forNormalFamily("Carlito"), c); + } + assertTrue(sum <= page.usableWidth(), "срез шире полезной ширины"); + } + } + + @Test + void plan_oversizedSingleColumn_getsOwnSlice() throws IOException { + SheetModel model = readSheet(""" + + """ + dataRow(2)); + PrintLayout.Plan plan = planOf(model); + assertEquals(2, plan.blocks().size(), "каждая гигантская колонка — свой срез"); + } + + @Test + void plan_fitToWidth_singleSliceScaledDown() throws IOException { + SheetModel model = readSheet(""" + + + + + """ + dataRow(20)); + PrintLayout.Plan plan = planOf(model); + assertEquals(1, plan.blocks().size(), "fitToWidth=1 — один срез"); + assertEquals(20, plan.blocks().get(0).cols().size()); + assertTrue(plan.widthScale() < 1.0 && plan.widthScale() > 0.0, + "ширины масштабируются вниз: " + plan.widthScale()); + } + + @Test + void plan_fitToWidthNarrowContent_noScaleUp() throws IOException { + SheetModel model = readSheet(""" + + + """ + dataRow(1)); + assertEquals(1.0, planOf(model).widthScale(), "узкий лист не растягивается"); + } + + @Test + void plan_scaleWithoutFitToPage_ignored() throws IOException { + SheetModel model = readSheet(""" + + + """ + dataRow(4)); + PrintLayout.Plan plan = planOf(model); + assertEquals(1.0, plan.widthScale()); + assertEquals(2, plan.blocks().size(), "@scale без fitToPage не режет и не сжимает"); + } + + @Test + void plan_rowBreaks_sliceTimesFragment() throws IOException { + SheetModel model = readSheet(""" + + + 11 + 1 + 1 + 1 + + """); + PrintLayout.Plan plan = planOf(model); + assertEquals(4, plan.blocks().size(), "2 среза × 2 фрагмента"); + assertEquals(List.of(0), plan.blocks().get(0).cols()); + assertEquals(1, plan.blocks().get(0).rowFrom()); + assertEquals(12, plan.blocks().get(0).rowTo()); + assertEquals(13, plan.blocks().get(1).rowFrom()); + assertEquals(30, plan.blocks().get(1).rowTo()); + assertEquals(List.of(1), plan.blocks().get(2).cols()); + assertEquals(1, plan.blocks().get(2).rowFrom()); + } + + @Test + void plan_breakBeyondLastRow_dropped() throws IOException { + SheetModel model = readSheet(""" + """ + dataRow(1) + """ + """); + PrintLayout.Plan plan = planOf(model); + assertEquals(1, plan.blocks().size(), "обрыв за последним содержимым — пустой страницы нет"); + assertEquals(1, plan.blocks().get(0).rowTo()); + } + + @Test + void plan_emptySheet_singleEmptyBlock() throws IOException { + PrintLayout.Plan plan = planOf(readSheet("")); + assertEquals(1, plan.blocks().size()); + assertTrue(plan.blocks().get(0).cols().isEmpty()); + assertEquals(1, plan.blocks().get(0).rowFrom()); + assertEquals(0, plan.blocks().get(0).rowTo()); + } + + @Test + void plan_hiddenColumnsExcludedFromSlices() throws IOException { + SheetModel model = readSheet(""" + + + + + + """ + dataRow(3)); + PrintLayout.Plan plan = planOf(model); + assertEquals(1, plan.blocks().size()); + assertEquals(List.of(0, 2), plan.blocks().get(0).cols()); + } + + @Test + void sectPr_emitsPageAndMargins() { + String xml = PrintLayout.sectPr(new PrintLayout.Page(20160, 12240, 720, 720, 1080, + 1080, 432, 432, true)); + assertTrue(xml.contains(""), xml); + assertTrue(xml.contains(""), xml); + String portrait = PrintLayout.sectPr(new PrintLayout.Page(11906, 16839, 1008, 1008, + 1080, 1080, 432, 432, false)); + assertFalse(portrait.contains("orient"), "книжная ориентация не помечается"); + } + + @Test + void defaultPage_a4DefaultMargins() { + PrintLayout.Page p = PrintLayout.defaultPage(); + assertEquals(11906, p.width()); + assertEquals(1008, p.left()); + assertEquals(1080, p.top()); + assertEquals(432, p.header()); + } +} diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/SharedStringsTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/SharedStringsTest.java new file mode 100644 index 0000000..a6a6218 --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/SharedStringsTest.java @@ -0,0 +1,111 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +import java.io.IOException; +import java.util.List; +import java.util.Map; + +import org.junit.jupiter.api.Test; + +/** SST §18.8: plain/rich-раны, rPr-переопределения, rPh-вырезание, индексы. */ +class SharedStringsTest { + + private static SharedStrings read(String sstXml) throws IOException { + return SharedStrings.read( + XlsxTestZips.pkg(Map.of("xl/sharedStrings.xml", sstXml)), new WarnOnce()); + } + + @Test + void missingSst_emptyTable() throws IOException { + SharedStrings sst = SharedStrings.read(XlsxTestZips.pkg(Map.of()), new WarnOnce()); + WarnOnce warn = new WarnOnce(); + assertTrue(sst.at(0, warn).isEmpty()); + } + + @Test + void brokenSst_ioException() { + assertThrows(IOException.class, () -> read(" + просто + + база + курсив + фоне + ажным + + пробелы + + """); + assertEquals("просто", sst.at(0, new WarnOnce()).get(0).text()); + assertNull(sst.at(0, new WarnOnce()).get(0).style()); + List rich = sst.at(1, new WarnOnce()); + assertEquals(3, rich.size(), "plain-префикс первым, rPh вырезан"); + assertEquals("база ", rich.get(0).text()); + assertEquals("курсив", rich.get(1).text()); + assertNull(rich.get(1).style(), "r без rPr — стиль ячейки"); + assertEquals("ажным", rich.get(2).text()); + assertEquals(Boolean.TRUE, rich.get(2).style().italic()); + assertEquals(" пробелы ", sst.at(2, new WarnOnce()).get(0).text()); + assertTrue(sst.at(3, new WarnOnce()).isEmpty(), "только phoneticRun — пусто"); + } + + @Test + void runStyle_allOverrides() throws IOException { + SharedStrings sst = read(""" + + + + + + + текст + """); + SharedStrings.RunStyle st = sst.at(0, new WarnOnce()).get(0).style(); + assertEquals(Boolean.TRUE, st.bold()); + assertEquals(Boolean.FALSE, st.italic(), "val=0 — ложь"); + assertEquals(Boolean.TRUE, st.strikeout()); + assertEquals("double", st.underline()); + assertEquals(9.5, st.sizePt()); + assertEquals("FF00B050", st.color().rgb()); + assertEquals("superscript", st.vertAlign()); + assertEquals("Calibri", st.fontName()); + } + + @Test + void runStyle_neutralValuesCollapseToNull() throws IOException { + SharedStrings sst = read(""" + + + т + """); + assertNull(sst.at(0, new WarnOnce()).get(0).style(), + "u=none + vertAlign=baseline + битый sz — пустой стиль"); + } + + @Test + void at_outOfBoundsWarnsEmpty() throws IOException { + SharedStrings sst = read("раз"); + assertTrue(sst.at(1, new WarnOnce()).isEmpty()); + assertTrue(sst.at(-1, new WarnOnce()).isEmpty()); + } + + @Test + void nestedSkip_doesNotBreakParentParse() throws IOException { + // неизвестный элемент с вложенными детьми не должен обрывать + SharedStrings sst = read(""" + + + после skip + """); + assertEquals("после skip", sst.at(0, new WarnOnce()).get(0).text()); + } +} diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/SheetModelTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/SheetModelTest.java new file mode 100644 index 0000000..2f7b108 --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/SheetModelTest.java @@ -0,0 +1,292 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +import java.io.IOException; +import java.util.Map; + +import org.junit.jupiter.api.Test; + +/** + * Разбор части листа: cols/rows/cells/merge/hyperlinks/rowBreaks/pageSetup + * (§18.3.1), битые ref и атрибуты — деградация, а не падение. + */ +class SheetModelTest { + + private static final WorkbookModel.Sheet SHEET = + new WorkbookModel.Sheet("Лист1", null, "xl/worksheets/sheet1.xml"); + + private static SheetModel read(String sheetXml) throws IOException { + return SheetModel.read(XlsxTestZips.pkg( + Map.of("xl/worksheets/sheet1.xml", sheetXml)), SHEET, new WarnOnce()); + } + + @Test + void missingPart_emptyModel() throws IOException { + SheetModel model = SheetModel.read(XlsxTestZips.pkg(Map.of()), SHEET, new WarnOnce()); + assertTrue(model.rows().isEmpty()); + assertEquals(0, model.usedCols()); + } + + @Test + void brokenXml_ioException() { + assertThrows(IOException.class, () -> read("")); + assertTrue(fit.pageSetup().fitToPage()); + SheetModel off = read(XlsxTestZips.sheet("")); + assertFalse(off.pageSetup().fitToPage()); + } + + @Test + void sheetFormatPr_defaultsAndGuards() throws IOException { + SheetModel model = read(XlsxTestZips.sheet( + "")); + assertEquals(20.0, model.defaultRowHeight()); + assertEquals(7.0, model.baseColWidth()); + SheetModel zero = read(XlsxTestZips.sheet( + "")); + assertEquals(15.0, zero.defaultRowHeight(), "0/отрицательное — дефолт"); + assertEquals(8.0, zero.baseColWidth()); + } + + @Test + void cols_spansHiddenStyleAndOverlap() throws IOException { + SheetModel model = read(XlsxTestZips.sheet(""" + + + + + + + + """)); + assertEquals(12.5, model.cols().get(0).width()); + assertEquals(4, model.cols().get(2).style()); + assertEquals(12.5, model.cols().get(1).width(), "первая запись выигрывает"); + assertTrue(model.cols().get(4).hidden()); + assertNull(model.cols().get(6).width(), "min без max — одна колонка"); + assertFalse(model.cols().get(6).hidden()); + assertFalse(model.cols().containsKey(5), "min=0 — мимо"); + assertFalse(model.cols().containsKey(-1)); + } + + @Test + void rows_cellsTypesAndRowStyle() throws IOException { + SheetModel model = read(XlsxTestZips.sheet(""" + + + + + 1 + #DIV/0! + 1.5A1+1 + инлайн + B2*2 + + + """)); + SheetModel.RowData row1 = model.rows().get(1); + assertEquals(30.0, row1.ht()); + assertTrue(row1.customHeight()); + assertTrue(row1.hidden()); + assertEquals(3, row1.effectiveStyle(), "customFormat — стиль строки"); + assertEquals("2", row1.cells().get(0).raw()); + assertEquals(7, row1.cells().get(0).styleIdx()); + assertEquals("s", row1.cells().get(0).type()); + assertEquals("5", row1.cells().get(1).raw(), "ячейка без @r — по счёту"); + assertEquals("кэш", row1.cells().get(2).raw()); + assertNull(model.rows().get(0), "r=0 — строка мимо"); + assertNull(model.rows().get(2).effectiveStyle(), "без customFormat — не применяется"); + assertEquals("1", model.rows().get(2).cells().get(0).raw()); + assertEquals(1.5, Double.parseDouble(model.rows().get(2).cells().get(2).raw())); + assertEquals("инлайн", model.rows().get(2).cells().get(3).runs().get(0).text()); + assertNull(model.rows().get(2).cells().get(4).raw(), "формула без кэша — пусто"); + assertNull(model.rows().get(2).cells().get(5).raw()); + assertEquals(6, model.usedCols()); + } + + @Test + void mergeCells_rangesAndGarbage() throws IOException { + SheetModel model = read(XlsxTestZips.sheet(""" + + + + + """)); + assertEquals(2, model.merges().size()); + SheetModel.Merge m = model.merges().get(0); + assertEquals(1, m.row1()); + assertEquals(3, m.row2()); + assertEquals(1, m.col1()); + assertEquals(3, m.col2()); + SheetModel.Merge single = model.merges().get(1); + assertEquals(0, single.row1()); + assertEquals(0, single.col2(), "одна ячейка — вырожденный прямоугольник"); + } + + @Test + void hyperlinks_externalRelResolved_internalIgnored() throws IOException { + String rels = XlsxTestZips.sheetRels( + XlsxTestZips.rel("rId1", XlsxTestZips.REL_HYPERLINK, + "https://example.com/", "External"), + XlsxTestZips.rel("rId2", XlsxTestZips.REL_HYPERLINK, + "other.xlsx", "External")); + String xml = XlsxTestZips.sheet(""" + + + + + + + """); + XlsxPackage pkg = XlsxTestZips.pkg(Map.of( + "xl/worksheets/sheet1.xml", xml, + "xl/worksheets/_rels/sheet1.xml.rels", rels)); + SheetModel model = SheetModel.read(pkg, SHEET, new WarnOnce()); + assertEquals("https://example.com/", model.externalLinks().get("A1")); + assertEquals("other.xlsx", model.externalLinks().get("A3")); + assertEquals(2, model.externalLinks().size(), "внутренние/битые — мимо"); + } + + @Test + void rowBreaks_manualOnly() throws IOException { + SheetModel model = read(XlsxTestZips.sheet(""" + + + + + + + + """)); + assertEquals(java.util.List.of(12, 20), model.rowBreaks()); + } + + @Test + void pageMargins_partialFallsBackToDefaults() throws IOException { + SheetModel model = read(XlsxTestZips.sheet( + "")); + assertEquals(0.25, model.margins().left()); + assertEquals(0.5, model.margins().top()); + assertEquals(0.7, model.margins().right(), "битый/нет — дефолт 0.7"); + assertEquals(0.75, model.margins().bottom()); + assertEquals(0.3, model.margins().header()); + assertEquals(0.3, model.margins().footer()); + } + + @Test + void pageSetup_attributesKeepFitToPageFromSheetPr() throws IOException { + SheetModel model = read(XlsxTestZips.sheet(""" + + """)); + SheetModel.PageSetup ps = model.pageSetup(); + assertEquals(1, ps.paperSize()); + assertTrue(ps.landscape()); + assertEquals(55, ps.scale()); + assertEquals(0, ps.fitToWidth()); + assertEquals(2, ps.fitToHeight()); + assertTrue(ps.fitToPage(), "pageSetup не затирает fitToPage из sheetPr"); + SheetModel bare = read(XlsxTestZips.sheet("")); + assertEquals(9, bare.pageSetup().paperSize()); + assertEquals(100, bare.pageSetup().scale()); + assertEquals(1, bare.pageSetup().fitToWidth()); + assertFalse(bare.pageSetup().landscape()); + } + + @Test + void drawingAndOleFlags() throws IOException { + String rels = XlsxTestZips.sheetRels(XlsxTestZips.rel("rId9", + XlsxTestZips.REL_DRAWING, "../drawings/drawing1.xml")); + XlsxPackage withDrawing = XlsxTestZips.pkg(Map.of( + "xl/worksheets/sheet1.xml", + XlsxTestZips.sheet(""), + "xl/worksheets/_rels/sheet1.xml.rels", rels)); + SheetModel model = SheetModel.read(withDrawing, SHEET, new WarnOnce()); + assertEquals("xl/drawings/drawing1.xml", model.drawingPath()); + assertTrue(model.olePresent(), "legacyDrawing — OLE-мусворд рядом"); + + XlsxPackage noRid = XlsxTestZips.pkg(Map.of("xl/worksheets/sheet1.xml", + XlsxTestZips.sheet(""))); + SheetModel m2 = SheetModel.read(noRid, SHEET, new WarnOnce()); + assertNull(m2.drawingPath(), "drawing без r:id — нет цели"); + assertTrue(m2.olePresent()); + + XlsxPackage brokenRid = XlsxTestZips.pkg(Map.of("xl/worksheets/sheet1.xml", + XlsxTestZips.sheet(""))); + assertNull(SheetModel.read(brokenRid, SHEET, new WarnOnce()).drawingPath()); + } + + @Test + void unknownElements_skippedDocumentSurvives() throws IOException { + SheetModel model = read(XlsxTestZips.sheet(""" + + + + + &Cшапка + """)); + assertEquals(1.0, model.margins().left(), "элементы после default-скипа читаются"); + assertTrue(model.rows().isEmpty()); + } + + @Test + void printOptions_warningsDoNotThrow() throws IOException { + SheetModel model = read(XlsxTestZips.sheet( + "")); + assertEquals(0.7, model.margins().left()); + } + + @Test + void worksheetWithoutRNamespace_parsesFine() throws IOException { + SheetModel model = read(XlsxTestZips.sheet( + "7", false)); + assertEquals("7", model.rows().get(1).cells().get(0).raw()); + } + + @Test + void parseRef_variants() { + assertRef(new int[] {0, 0}, "A1"); + assertRef(new int[] {11, 27}, "AB12"); + assertRef(new int[] {9, 701}, "ZZ10"); + assertRef(new int[0], null); + assertRef(new int[0], ""); + assertRef(new int[0], "12"); + assertRef(new int[0], "AB"); + assertRef(new int[0], "A0"); + assertRef(new int[0], "A-1"); + assertRef(new int[] {4, 2}, "C5"); + } + + private static void assertRef(int[] expected, String ref) { + assertEquals(java.util.Arrays.toString(expected), + java.util.Arrays.toString(SheetModel.parseRef(ref)), "ref=" + ref); + } + + @Test + void parseRange_variants() { + assertEquals("[0, 1, 1, 3]", java.util.Arrays.toString(SheetModel.parseRange("B1:D2"))); + assertEquals("[0, 0, 0, 0]", java.util.Arrays.toString(SheetModel.parseRange("A1"))); + assertEquals("[0, 0, 0, 0]", java.util.Arrays.toString( + SheetModel.parseRange("A1:битый")), "битый второй — вырожденный"); + assertEquals("[0, 0, 1, 1]", java.util.Arrays.toString( + SheetModel.parseRange(" B2 : A1 ")), "нормализация min/max + пробелы"); + assertEquals("[]", java.util.Arrays.toString(SheetModel.parseRange(null))); + assertEquals("[]", java.util.Arrays.toString(SheetModel.parseRange(""))); + assertEquals("[]", java.util.Arrays.toString(SheetModel.parseRange(":A1"))); + } +} diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/SheetToTableTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/SheetToTableTest.java new file mode 100644 index 0000000..291a138 --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/SheetToTableTest.java @@ -0,0 +1,337 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertTrue; + +import java.io.IOException; +import java.util.ArrayList; +import java.util.LinkedHashMap; +import java.util.LinkedHashSet; +import java.util.List; +import java.util.Map; + +import org.junit.jupiter.api.Test; + +import ru.pjandro.wordpdf.internal.DocxPackageWriter; + +/** + * Эмит .xlsx-листа в таблицу docx: сетка без скрытых колонок, merge'ы с + * редиректом контента, стили/границы/заливки, раны SST, гиперссылки. + */ +class SheetToTableTest { + + private static final String STYLES = """ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + """; + + private static final String SST = """ + + + + верх + низ + + обычная + """; + + /** Полный пакет: лист {@code sheetBody} + {@link #STYLES} + {@link #SST}. */ + private record Emitted(String xml, List parts, + List hyperlinks) { + } + + private static Emitted emit(String sheetBody, String relsXml) throws IOException { + Map parts = new LinkedHashMap<>(); + parts.put("xl/styles.xml", STYLES); + parts.put("xl/sharedStrings.xml", SST); + parts.put("xl/worksheets/sheet1.xml", sheetBody); + if (relsXml != null) { + parts.put("xl/worksheets/_rels/sheet1.xml.rels", relsXml); + } + XlsxPackage pkg = XlsxTestZips.workbook("Лист1|", parts); + WarnOnce warn = new WarnOnce(); + WorkbookModel wb = WorkbookModel.read(pkg); + SheetModel model = SheetModel.read(pkg, wb.sheets().get(0), warn); + StylesModel styles = StylesModel.read(pkg, warn); + SharedStrings sst = SharedStrings.read(pkg, warn); + ColorResolver colors = new ColorResolver(ThemeModel.read(pkg, warn), + styles.indexedColors()); + Metrics metrics = Metrics.forNormalFamily(styles.normalFontName( + ThemeModel.read(pkg, warn))); + List outParts = new ArrayList<>(); + LinkedHashSet links = new LinkedHashSet<>(); + String xml = String.join("", SheetToTable.emit(model, styles, sst, wb, metrics, + new NumberFormats(styles.customFormats(), wb.date1904()), colors, + PrintLayout.page(model, warn), new LinkedHashMap<>(), outParts, links, warn)); + return new Emitted(xml, outParts, new ArrayList<>(links)); + } + + @Test + void emptyAndInsignificant_emitNothing() throws IOException { + assertEquals("", emit(XlsxTestZips.sheet(""), null).xml()); + assertEquals("", emit(XlsxTestZips.sheet(""" + + + + """), null).xml(), + "пустые ячейки — незначимый лист"); + } + + @Test + void grid_skipsHiddenColumnAndRow() throws IOException { + Emitted out = emit(XlsxTestZips.sheet(""" + + + 14 + + """), null); + assertEquals(3, count(out.xml(), ""), "скрытая строка не эмитится"); + assertTrue(out.xml().contains(" + + 1 + #N/A + кэш + 2.5 + 42.25 + 1 + + """), null); + assertTrue(out.xml().contains(">TRUE<")); + assertTrue(out.xml().contains(">#N/A<")); + assertTrue(out.xml().contains(">кэш<")); + assertTrue(out.xml().contains(">2.5<")); + assertTrue(out.xml().contains(">42.25<"), "numFmt 164 #,##0.00"); + assertTrue(out.xml().contains(">обычная<"), "rich-строка по индексу SST"); + } + + @Test + void sstIndexOutOfRange_fallsBackToRawText() throws IOException { + Emitted out = emit(XlsxTestZips.sheet( + "99"), + null); + assertTrue(out.xml().contains(">99<"), "индекс вне SST — сырое значение текстом"); + } + + @Test + void richRuns_stylesAndSpacePreserve() throws IOException { + Emitted out = emit(XlsxTestZips.sheet( + "0"), + null); + assertTrue(out.xml().contains("")); + assertTrue(out.xml().contains("w:color w:val=\"00B050\"")); + assertTrue(out.xml().contains("")); + assertTrue(out.xml().contains(" xml:space=\"preserve\"> низ ")); + } + + @Test + void styles_bordersShdVAlignJcIndentFont() throws IOException { + Emitted out = emit(XlsxTestZips.sheet( + "7"), + null); + String xml = out.xml(); + assertTrue(xml.contains("")); + assertFalse(xml.contains(""), "hair без color — auto"); + assertTrue(xml.contains("w:fill=\"ED7D31\""), "solid fgColor theme=5"); + assertTrue(xml.contains("")); + assertTrue(xml.contains(""), "vertical=justify → both"); + int expect = Metrics.pxToTwips(3 * 2 * Metrics.forNormalFamily("Calibri").mdw()); + assertTrue(xml.contains(""), "отступ 3·MDW за единицу"); + assertTrue(xml.contains("")); + assertTrue(xml.contains("")); + assertTrue(xml.contains(""), "12 pt → 24 half-pt"); + assertTrue(xml.contains("w:color w:val=\"FF0000\""), "цвет шрифта FF0000"); + } + + @Test + void styles_borderOobAndFillWithoutFg() throws IOException { + Emitted out = emit(XlsxTestZips.sheet( + "7" + + "8"), null); + assertTrue(out.xml().contains("")); + assertTrue(out.xml().contains("")); + } + + @Test + void rowStyleAndColStylePrecedence() throws IOException { + Emitted rowStyled = emit(XlsxTestZips.sheet(""" + + 7 + 8 + """), null); + // A без своего s → стиль строки 5 (границы borderId=2); B — явно s=0 + String[] tcs = rowStyled.xml().split(""); + assertTrue(tcs[1].contains("mediumDashDotDot"), "стиль строки на ячейке без своего s"); + assertFalse(tcs[2].contains(""), "justify → both"); + } + + @Test + void colStyle_appliedToStylelessCell() throws IOException { + Emitted out = emit(XlsxTestZips.sheet(""" + + 7"""), null); + assertTrue(out.xml().contains("mediumDashDotDot"), "стиль колонки без cell/row s"); + } + + @Test + void merges_singleRow_gridSpanNoVMerge() throws IOException { + Emitted out = emit(XlsxTestZips.sheet(""" + + широкомимо + + """), null); + assertTrue(out.xml().contains("")); + assertFalse(out.xml().contains("vMerge"), "однострочный merge — без vMerge"); + assertTrue(out.xml().contains(">широко<")); + } + + @Test + void merges_hiddenColumnOrigin_contentRedirectsToFirstVisible() throws IOException { + Emitted out = emit(XlsxTestZips.sheet(""" + + + редирект + + """), null); + assertTrue(out.xml().contains(">редирект<"), "контент из скрытой origin-колонки"); + assertEquals(1, count(out.xml(), " + + + + + """), null); + String xml = out.xml(); + assertTrue(xml.contains(">редирект<"), "контент из скрытой origin-ячейки"); + assertTrue(xml.contains("")); + assertTrue(xml.contains(""), "видимы B,C"); + assertEquals(1, count(xml, ""), "строка 1 скрыта"); + } + + @Test + void hyperlinks_dedupByTarget() throws IOException { + String rels = XlsxTestZips.sheetRels( + XlsxTestZips.rel("rId1", XlsxTestZips.REL_HYPERLINK, + "https://a.example/", "External"), + XlsxTestZips.rel("rId2", XlsxTestZips.REL_HYPERLINK, + "https://a.example/", "External"), + XlsxTestZips.rel("rId3", XlsxTestZips.REL_HYPERLINK, + "https://b.example/", "External")); + Emitted out = emit(XlsxTestZips.sheet(""" + + aa2 + b + + + + + + """), rels); + assertTrue(out.xml().contains("")); + assertTrue(out.xml().contains("")); + assertEquals(List.of("https://a.example/", "https://b.example/"), + out.hyperlinks()); + } + + @Test + void hyperlinkOnEmptyCell_stillEmitted() throws IOException { + String rels = XlsxTestZips.sheetRels(XlsxTestZips.rel("rId1", + XlsxTestZips.REL_HYPERLINK, "https://a/", "External")); + Emitted out = emit(XlsxTestZips.sheet(""" + + """), rels); + assertTrue(out.xml().contains("")); + } + + @Test + void escaping_controlCharsAndEntities() throws IOException { + String body = XlsxTestZips.sheet("" + + "т&<>"x" + + ""); + Emitted out = emit(body, null); + assertTrue(out.xml().contains("т&<>"x"), + "сущности разбираются и переэкранируются"); + } + + @Test + void defaultRowHeight_appliedAsExactTwips() throws IOException { + Emitted custom = emit(XlsxTestZips.sheet(""" + + 7 + 8"""), null); + assertTrue(custom.xml().contains(""), + "20pt = 400 twips"); + Emitted rowHt = emit(XlsxTestZips.sheet( + "7"), + null); + assertTrue(rowHt.xml().contains("")); + } + + private static int count(String haystack, String needle) { + int n = 0; + for (int i = haystack.indexOf(needle); i >= 0; i = haystack.indexOf(needle, i + 1)) { + n++; + } + return n; + } +} diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/StylesModelTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/StylesModelTest.java new file mode 100644 index 0000000..3d4bde3 --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/StylesModelTest.java @@ -0,0 +1,250 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +import java.io.IOException; +import java.util.Map; + +import org.junit.jupiter.api.Test; + +/** + * {@code xl/styles.xml} §18.8: таблицы и разрешение cellXfs через + * cellStyleXfs по apply*-флагам (base-first),padding дефолтов. + */ +class StylesModelTest { + + private static StylesModel read(String stylesXml) throws IOException { + return StylesModel.read(XlsxTestZips.pkg(Map.of("xl/styles.xml", stylesXml)), + new WarnOnce()); + } + + @Test + void missingStyles_allDefaults() throws IOException { + StylesModel styles = StylesModel.read(XlsxTestZips.pkg(Map.of()), new WarnOnce()); + assertEquals("Calibri", styles.font(0).name()); + assertEquals(11.0, styles.font(0).sizePt()); + assertEquals(0, styles.customFormats().size()); + assertEquals("none", styles.fill(0).patternType()); + assertEquals("gray125", styles.fill(1).patternType()); + assertNull(styles.border(0).left()); + assertEquals(0, styles.xf(0).numFmtId()); + assertNull(styles.font(9)); + assertNull(styles.fill(9)); + assertNull(styles.border(9)); + assertSame0(styles); + } + + private static void assertSame0(StylesModel styles) { + assertEquals(styles.xf(0).fontId(), styles.xf(999).fontId(), "индекс вне — xf[0]"); + } + + @Test + void brokenStyles_ioException() { + assertThrows(IOException.class, () -> read(" + + + + + + + + + """); + StylesModel.FontDef f = styles.font(0); + assertEquals("Times New Roman", f.name()); + assertEquals("minor", f.scheme()); + assertEquals(14.0, f.sizePt()); + assertEquals(Boolean.TRUE, f.bold()); + assertEquals(Boolean.FALSE, f.italic()); + assertEquals(Boolean.TRUE, f.strikeout()); + assertEquals("double", f.underline()); + assertEquals(4, f.color().theme()); + assertEquals(-0.25, f.color().tint()); + StylesModel.FontDef empty = styles.font(1); + assertNull(empty.name()); + assertEquals("Times New Roman", styles.normalFontName(null), + "Normal = шрифт cellXfs[0]"); + } + + @Test + void normalFontName_themeFallbackChain() throws IOException { + StylesModel noName = read(""" + """); + ThemeModel theme = ThemeModel.read(XlsxTestZips.pkg(Map.of(ThemeModel.THEME_PART, """ + + + """)), new WarnOnce()); + assertEquals("Noto Sans", noName.normalFontName(theme)); + assertEquals("Calibri", noName.normalFontName(null), "нет имени и темы — Calibri"); + assertEquals("Calibri", noName.normalFontName( + ThemeModel.read(XlsxTestZips.pkg(Map.of()), new WarnOnce())), + "тема без minorFont — Calibri"); + } + + @Test + void fills_patternTypesAndColors() throws IOException { + StylesModel styles = read(""" + + + + + + + + + """); + assertEquals("none", styles.fill(0).patternType()); + assertEquals("solid", styles.fill(1).patternType()); + assertEquals("FFFFC000", styles.fill(1).fgColor().rgb()); + assertEquals("none", styles.fill(2).patternType(), "patternType без атрибута — none"); + assertNull(styles.fill(2).fgColor()); + assertEquals("none", styles.fill(3).patternType(), "gradientFill — не паттерн"); + assertNull(styles.fill(3).fgColor()); + } + + @Test + void borders_sidesWithColorsDiagonalsIgnored() throws IOException { + StylesModel styles = read(""" + + + + + + + + + + + + """); + StylesModel.BorderDef b = styles.border(0); + assertEquals("thin", b.left().style()); + assertEquals("FF0000FF", b.left().color().rgb()); + assertEquals("mediumDashed", b.right().style()); + assertNull(b.right().color(), "сторона без color-ребёнка"); + assertEquals("dotted", b.top().style()); + assertEquals(13, b.top().color().indexed(), + "color стороны после color-ребёнка предыдущей стороны не теряется"); + assertEquals("thick", b.bottom().style()); + assertNull(b.bottom().color(), "ребёнок — не color-элемент"); + assertNull(styles.border(1).left()); + } + + @Test + void numFmts_customCodes() throws IOException { + StylesModel styles = read(""" + + + + + + + + """); + assertEquals(1, styles.customFormats().size(), "дубль/битый id/нет code — мимо"); + assertEquals("#,##0.00", styles.customFormats().get(164)); + } + + @Test + void colors_indexedPalette() throws IOException { + StylesModel styles = read(""" + + + + + + + + + + """); + assertEquals(2, styles.indexedColors().size()); + assertEquals("FF000000", styles.indexedColors().get(0)); + assertEquals("000000", styles.indexedColors().get(1), "rgb без атрибута — чёрный"); + } + + @Test + void cellXfs_applyFlagsResolveViaBase() throws IOException { + StylesModel styles = read(""" + + + + + + + + + + + + """); + // cellXfs[0] — тоже формат (Normal), база у него такая же + StylesModel.CellXf x0 = styles.xf(0); + assertEquals(7, x0.fontId(), "applyFont=1 — своё"); + assertEquals(2, x0.fillId(), "applyFill=0 — база"); + assertEquals(5, x0.borderId(), "без флага applyBorder — своё значение есть → своё"); + assertEquals(10, x0.numFmtId()); + StylesModel.CellXf x1 = styles.xf(1); + assertEquals("center", x1.horizontal(), "applyAlignment=0 — база"); + assertEquals("top", x1.vertical()); + assertTrue(x1.wrapText()); + assertEquals(2, x1.indent(), "индент базы, своё 9 отброшено"); + StylesModel.CellXf x2 = styles.xf(2); + assertEquals("right", x2.horizontal(), "applyAlignment=1 — своё"); + assertNull(x2.vertical(), "своё отсутствует — null, не база"); + assertEquals(0, x2.indent()); + StylesModel.CellXf x3 = styles.xf(3); + assertEquals(164, x3.numFmtId(), "xfId вне таблицы — без базы"); + assertEquals(0, x3.fontId()); + assertNull(x3.horizontal()); + } + + @Test + void cellXfs_ownValuesWithoutFlagsWhenAttrPresent() throws IOException { + StylesModel styles = read(""" + + + + + + + """); + assertEquals(0, styles.xf(0).numFmtId(), "свой numFmtId задан без флага — берётся свой"); + assertEquals(1, styles.xf(0).fontId()); + } + + @Test + void padding_whenTablesEmpty() throws IOException { + StylesModel styles = read("" + + "" + + ""); + assertEquals("Calibri", styles.font(0).name()); + assertEquals("gray125", styles.fill(1).patternType()); + assertNull(styles.border(0).left()); + assertEquals(1, styles.xfCount()); + assertEquals(0, styles.xf(0).borderId()); + } + + @Test + void alignment_wrapTextFalseExplicit() throws IOException { + StylesModel styles = read("" + + "" + + ""); + assertEquals("general", styles.xf(0).horizontal()); + assertFalse(styles.xf(0).wrapText()); + assertEquals(0, styles.xf(0).indent(), "битый indent — 0"); + } +} diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/ThemeModelTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/ThemeModelTest.java new file mode 100644 index 0000000..d4691b0 --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/ThemeModelTest.java @@ -0,0 +1,127 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNull; + +import java.io.IOException; +import java.util.Map; + +import org.junit.jupiter.api.Test; + +/** + * Тема {@code xl/theme/theme1.xml}: схема цветов, minorFont, дефолты при + * отсутствии/браке части (§14.2.9, §18.18.62). + */ +class ThemeModelTest { + + private static ThemeModel read(Map parts) throws IOException { + return ThemeModel.read(XlsxTestZips.pkg(parts), new WarnOnce()); + } + + @Test + void fullScheme_parsesColorsAndMinorFont() throws IOException { + String theme = """ + + + + + + + + + + + + + + + + + + + """; + ThemeModel theme1 = read(Map.of(ThemeModel.THEME_PART, theme)); + assertEquals("000000", theme1.color("dk1")); + assertEquals("FFFFFF", theme1.color("lt1")); + assertEquals("4472C4", theme1.color("accent1"), "ARGB 8 hex -> RGB"); + assertEquals("ED7D31", theme1.color("accent2"), "нижний регистр -> верхний"); + assertEquals("0563C1", theme1.color("hlink")); + assertEquals("954F72", theme1.color("folHlink")); + assertEquals("Aptos Narrow", theme1.minorFont()); + } + + @Test + void missingTheme_defaultOfficePalette() throws IOException { + ThemeModel theme = read(Map.of()); + assertEquals("4472C4", theme.color("accent1")); + assertEquals("000000", theme.color("dk1")); + assertEquals("0563C1", theme.color("hlink")); + assertNull(theme.minorFont()); + } + + @Test + void brokenTheme_defaultPalette() throws IOException { + ThemeModel theme = read(Map.of(ThemeModel.THEME_PART, " + + + """; + ThemeModel empty = read(Map.of(ThemeModel.THEME_PART, theme)); + assertEquals("4472C4", empty.color("accent1"), "пустая схема -> дефолт"); + } + + @Test + void partialScheme_missingElementIsNull() throws IOException { + String theme = """ + + + + + + + """; + ThemeModel theme1 = read(Map.of(ThemeModel.THEME_PART, theme)); + assertEquals("ABC", theme1.color("accent6"), "короткий hex остаётся как есть"); + assertNull(theme1.color("accent1"), "srgbClr без val не пишется в схему"); + assertNull(theme1.color("dk1"), "нет элемента — автоцвет"); + } + + @Test + void colorElementInsideScheme_notConfusedWithClrElement() throws IOException { + // srgbClr ВНЕ clrScheme-элемента игнорируется; val у sysClr без + // lastClr — тоже + String theme = """ + + + + + + + + """; + ThemeModel theme1 = read(Map.of(ThemeModel.THEME_PART, theme)); + assertNull(theme1.color("dk1")); + assertEquals("222222", theme1.color("accent1")); + assertNull(theme1.color("hlink"), "вне схемы цвет не ловится"); + } + + @Test + void elementForIndex_excelIndexMapping() { + assertEquals("lt1", ThemeModel.elementForIndex(0)); + assertEquals("dk1", ThemeModel.elementForIndex(1)); + assertEquals("lt2", ThemeModel.elementForIndex(2)); + assertEquals("dk2", ThemeModel.elementForIndex(3)); + assertEquals("accent1", ThemeModel.elementForIndex(4)); + assertEquals("accent6", ThemeModel.elementForIndex(9)); + assertEquals("hlink", ThemeModel.elementForIndex(10)); + assertEquals("folHlink", ThemeModel.elementForIndex(11)); + assertNull(ThemeModel.elementForIndex(12)); + assertNull(ThemeModel.elementForIndex(-1)); + } +} diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/WorkbookModelTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/WorkbookModelTest.java new file mode 100644 index 0000000..d690701 --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/WorkbookModelTest.java @@ -0,0 +1,100 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +import java.io.IOException; +import java.util.List; +import java.util.Map; + +import org.junit.jupiter.api.Test; + +/** {@code xl/workbook.xml}: порядок листов, state, date1904, битые связи. */ +class WorkbookModelTest { + + @Test + void missingWorkbook_ioException() { + assertThrows(IOException.class, + () -> WorkbookModel.read(XlsxTestZips.pkg(Map.of("xl/a.xml", "")))); + } + + @Test + void sheets_orderStateAndPartPaths() throws IOException { + XlsxPackage pkg = XlsxTestZips.workbook( + "Первый|;Второй|hidden|rId2;Третий|veryHidden|rId3", + Map.of( + "xl/worksheets/sheet1.xml", "", + "xl/worksheets/sheet2.xml", "", + "xl/worksheets/sheet3.xml", "")); + List sheets = WorkbookModel.read(pkg).sheets(); + assertEquals(3, sheets.size()); + assertEquals("Первый", sheets.get(0).name()); + assertTrue(sheets.get(0).visible()); + assertEquals("xl/worksheets/sheet2.xml", sheets.get(1).partPath()); + assertFalse(sheets.get(1).visible()); + assertFalse(sheets.get(2).visible()); + } + + @Test + void defaultStateAttribute_visible() throws IOException { + XlsxPackage pkg = XlsxTestZips.workbook("Л|visible|rId1", + Map.of("xl/worksheets/sheet1.xml", "")); + assertTrue(WorkbookModel.read(pkg).sheets().get(0).visible()); + } + + @Test + void brokenSheetLinks_skipped() throws IOException { + // rid нет в rels; rel внешнего типа; rel на несуществующую часть; sheet без r:id + XlsxPackage pkg = XlsxTestZips.pkg(Map.of( + "xl/workbook.xml", """ + + + + + + + + """, + "xl/_rels/workbook.xml.rels", XlsxTestZips.sheetRels( + XlsxTestZips.rel("rIdE", XlsxTestZips.REL_WORKSHEET, + "https://evil/", "External"), + XlsxTestZips.rel("rIdM", XlsxTestZips.REL_WORKSHEET, + "worksheets/gone.xml"), + XlsxTestZips.rel("rIdOk", XlsxTestZips.REL_WORKSHEET, + "worksheets/sheet1.xml")), + "xl/worksheets/sheet1.xml", "")); + List sheets = WorkbookModel.read(pkg).sheets(); + assertEquals(1, sheets.size()); + assertEquals("Ок", sheets.get(0).name()); + } + + @Test + void emptySheetName_becomesEmptyString() throws IOException { + XlsxPackage pkg = XlsxTestZips.pkg(Map.of( + "xl/workbook.xml", """ + + """, + "xl/_rels/workbook.xml.rels", XlsxTestZips.sheetRels(XlsxTestZips.rel( + "rId1", XlsxTestZips.REL_WORKSHEET, "worksheets/sheet1.xml")), + "xl/worksheets/sheet1.xml", "")); + assertEquals("", WorkbookModel.read(pkg).sheets().get(0).name()); + } + + @Test + void date1904_flag() throws IOException { + XlsxPackage pkg = XlsxTestZips.pkg(Map.of( + "xl/workbook.xml", """ + + """)); + assertTrue(WorkbookModel.read(pkg).date1904()); + XlsxPackage off = XlsxTestZips.pkg(Map.of( + "xl/workbook.xml", + "" + + "")); + assertFalse(WorkbookModel.read(off).date1904()); + } +} diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/XlsxPackageTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/XlsxPackageTest.java new file mode 100644 index 0000000..5a9590c --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/XlsxPackageTest.java @@ -0,0 +1,150 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertSame; +import static org.junit.jupiter.api.Assertions.assertTrue; + +import java.io.ByteArrayInputStream; +import java.io.IOException; +import java.io.StringReader; +import java.util.Map; + +import javax.xml.stream.XMLStreamReader; + +import org.junit.jupiter.api.Test; + +/** Пути rels, разрешение целей связей, XML-boolean и атрибутные хелперы. */ +class XlsxPackageTest { + + @Test + void relsPathOf_and_parentDir() { + assertEquals("xl/worksheets/_rels/sheet1.xml.rels", + XlsxPackage.relsPathOf("xl/worksheets/sheet1.xml")); + assertEquals("xl/_rels/workbook.xml.rels", XlsxPackage.relsPathOf("xl/workbook.xml")); + assertEquals("_rels/root.xml.rels", XlsxPackage.relsPathOf("root.xml")); + assertEquals("xl/worksheets/", XlsxPackage.parentDir("xl/worksheets/sheet1.xml")); + assertEquals("", XlsxPackage.parentDir("root.xml")); + } + + @Test + void resolvePath_absoluteRelativeDotDot() { + assertEquals("xl/media/x.png", XlsxPackage.resolvePath("xl/drawings/", "/xl/media/x.png")); + assertEquals("xl/theme/theme1.xml", + XlsxPackage.resolvePath("xl/drawings/", "../theme/theme1.xml")); + assertEquals("xl/drawings/x.xml", XlsxPackage.resolvePath("xl/drawings/", "./x.xml")); + assertEquals("xl/drawings/theme/x.xml", + XlsxPackage.resolvePath("xl/drawings/", "theme\\x.xml".replace('/', '\\'))); + assertEquals("xl/x.xml", XlsxPackage.resolvePath("xl/", "x.xml?param=1")); + assertEquals("", XlsxPackage.resolvePath("", "../..")); + } + + @Test + void truthy_ooXmlBooleanSemantics() { + assertFalse(XlsxPackage.truthy(null)); + assertFalse(XlsxPackage.truthy("0")); + assertFalse(XlsxPackage.truthy("false")); + assertFalse(XlsxPackage.truthy("FALSE")); + assertFalse(XlsxPackage.truthy("off")); + assertTrue(XlsxPackage.truthy(""), "атрибут выставлен без значения — истина"); + assertTrue(XlsxPackage.truthy("1")); + assertTrue(XlsxPackage.truthy("true")); + assertTrue(XlsxPackage.truthy("on")); + } + + @Test + void entryMissing_andDirectoryEntrySkipped() throws IOException { + XlsxPackage pkg = XlsxTestZips.pkg(Map.of( + "xl/", "", + "xl/workbook.xml", "")); + assertTrue(pkg.has("xl/workbook.xml")); + assertFalse(pkg.has("xl/"), "каталоговая запись — не часть"); + assertNull(pkg.entry("xl/")); + assertNull(pkg.entry("xl/nope.xml")); + assertEquals("", + new String(pkg.entry("xl/workbook.xml"), java.nio.charset.StandardCharsets.UTF_8)); + } + + @Test + void rels_missingFileYieldsEmpty() throws IOException { + XlsxPackage pkg = XlsxTestZips.pkg(Map.of("xl/workbook.xml", "")); + assertTrue(pkg.rels("xl/workbook.xml").isEmpty()); + assertNull(pkg.relByTargetId("xl/workbook.xml", "rId1")); + assertNull(pkg.relTargetPath("xl/workbook.xml", "rId1")); + } + + @Test + void rels_brokenXmlYieldsEmpty() throws IOException { + XlsxPackage pkg = XlsxTestZips.pkg(Map.of( + "xl/_rels/workbook.xml.rels", " + + + + + """)); + var rels = pkg.rels("xl/wb.xml"); + assertEquals(2, rels.size(), "первый дубль Id + rel с пустым Id (Id != null)"); + XlsxPackage.Rel first = pkg.relByTargetId("xl/wb.xml", "rId1"); + assertSame(pkg.relByTargetId("xl/wb.xml", "rId1"), first, "rels кэшируются"); + assertEquals("a.xml", first.target()); + assertFalse(first.external()); + } + + @Test + void relTargetPath_externalAndResolution() throws IOException { + XlsxPackage pkg = XlsxTestZips.pkg(Map.of("xl/_rels/workbook.xml.rels", """ + + + + + """)); + assertTrue(pkg.relByTargetId("xl/workbook.xml", "rExt").external()); + assertNull(pkg.relTargetPath("xl/workbook.xml", "rExt")); + assertEquals("xl/worksheets/sheet1.xml", + pkg.relTargetPath("xl/workbook.xml", "rInt")); + assertEquals("customXml/item1.xml", + pkg.relTargetPath("xl/workbook.xml", "rUp"), "«..» выходит из xl/ в корень"); + } + + @Test + void attr_and_attrNs() throws Exception { + XMLStreamReader xr = XlsxPackage.newSecureReader().createXMLStreamReader( + new StringReader("")); + xr.next(); + assertEquals("A1", XlsxPackage.attr(xr, "r")); + assertEquals("s", XlsxPackage.attr(xr, "t")); + assertNull(XlsxPackage.attr(xr, "s")); + assertEquals("rId5", XlsxPackage.attr(xr, "id"), "атрибут по локальному имени"); + assertEquals("rId5", XlsxPackage.attrNs(xr, "http://r", "id")); + assertNull(XlsxPackage.attrNs(xr, "http://other", "id")); + xr.close(); + } + + @Test + void secureReader_rejectsExternalEntities() { + // SUPPORT_DTD=false: DOCTYPE в rels — ошибка разбора, а не сущность + String xml = "]>&e;"; + boolean failed = false; + try { + var xr = XlsxPackage.newSecureReader() + .createXMLStreamReader(new ByteArrayInputStream(xml.getBytes( + java.nio.charset.StandardCharsets.UTF_8))); + while (xr.hasNext()) { + xr.next(); + } + } catch (Exception e) { + failed = true; + } + assertTrue(failed, "DTD запрещён"); + } +} diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/XlsxTestZips.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/XlsxTestZips.java new file mode 100644 index 0000000..7675912 --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/XlsxTestZips.java @@ -0,0 +1,126 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import java.io.ByteArrayOutputStream; +import java.io.IOException; +import java.nio.charset.StandardCharsets; +import java.util.LinkedHashMap; +import java.util.Map; +import java.util.zip.ZipEntry; +import java.util.zip.ZipOutputStream; + +/** Сборка .xlsx-пакета из текстовых частей для юнитов моста. */ +final class XlsxTestZips { + + static final String NS_MAIN = + "http://schemas.openxmlformats.org/spreadsheetml/2006/main"; + static final String NS_R = + "http://schemas.openxmlformats.org/officeDocument/2006/relationships"; + static final String REL_WORKSHEET = NS_R + "/worksheet"; + static final String REL_HYPERLINK = NS_R + "/hyperlink"; + static final String REL_DRAWING = NS_R + "/drawing"; + + private XlsxTestZips() { + } + + static XlsxPackage pkg(Map parts) throws IOException { + return XlsxPackage.read(zipBytes(parts)); + } + + static byte[] zipBytes(Map parts) throws IOException { + ByteArrayOutputStream bos = new ByteArrayOutputStream(); + try (ZipOutputStream zip = new ZipOutputStream(bos)) { + for (var e : parts.entrySet()) { + zip.putNextEntry(new ZipEntry(e.getKey())); + zip.write(e.getValue().getBytes(StandardCharsets.UTF_8)); + zip.closeEntry(); + } + } + return bos.toByteArray(); + } + + /** Пакет: workbook с листами {@code @spec} ("Имя|state|rid") + части. */ + static XlsxPackage workbook(String sheetSpecs, Map extraParts, + String... extraRels) throws IOException { + return pkg(workbookParts(sheetSpecs, extraParts, extraRels)); + } + + /** Тот же {@link #workbook}, но байты .xlsx (для XlsxToDocx.convert). */ + static byte[] workbookBytes(String sheetSpecs, Map extraParts, + String... extraRels) throws IOException { + return zipBytes(workbookParts(sheetSpecs, extraParts, extraRels)); + } + + private static Map workbookParts(String sheetSpecs, + Map extraParts, String... extraRels) { + Map parts = new LinkedHashMap<>(); + StringBuilder sheets = new StringBuilder(); + StringBuilder rels = new StringBuilder(); + String[][] rows = parseSpecs(sheetSpecs); + for (String[] row : rows) { + String name = row[0]; + String state = row[1].isEmpty() ? "" : " state=\"" + row[1] + "\""; + String rid = row[2]; + sheets.append(""); + rels.append(""); + } + parts.put("xl/workbook.xml", "" + sheets + ""); + parts.put("xl/_rels/workbook.xml.rels", + "" + rels + ""); + parts.putAll(extraParts); + for (String relsPart : extraRels) { + parts.putIfAbsent(relsPart, + ""); + } + return parts; + } + + /** "Имя|state|rid|target;Имя2|..." → массивы строк. */ + private static String[][] parseSpecs(String sheetSpecs) { + if (sheetSpecs.isEmpty()) { + return new String[0][]; + } + String[] rows = sheetSpecs.split(";"); + String[][] out = new String[rows.length][4]; + for (int i = 0; i < rows.length; i++) { + String[] f = rows[i].split("\\|", -1); + out[i][0] = f[0]; + out[i][1] = f.length > 1 ? f[1] : ""; + out[i][2] = f.length > 2 ? f[2] : "rId" + (i + 1); + out[i][3] = f.length > 3 ? f[3] : "worksheets/sheet" + (i + 1) + ".xml"; + } + return out; + } + + /** Обёртка листа worksheet c произвольным содержимым {@code body}. */ + static String sheet(String body) { + return sheet(body, true); + } + + static String sheet(String body, boolean withRNamespace) { + String rns = withRNamespace ? " xmlns:r=\"" + NS_R + "\"" : ""; + return "" + body + ""; + } + + /** rels листа с произвольными Relationship-записями. */ + static String sheetRels(String... relationships) { + return "" + String.join("", relationships) + + ""; + } + + static String rel(String id, String type, String target) { + return rel(id, type, target, null); + } + + static String rel(String id, String type, String target, String mode) { + return ""; + } +} diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/XlsxToDocxTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/XlsxToDocxTest.java new file mode 100644 index 0000000..b259ade --- /dev/null +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/xlsx/XlsxToDocxTest.java @@ -0,0 +1,289 @@ +package ru.pjandro.wordpdf.internal.xlsx; + +import org.junit.jupiter.api.Test; + +import java.io.ByteArrayInputStream; +import java.io.IOException; +import java.io.InputStream; +import java.nio.charset.StandardCharsets; +import java.util.LinkedHashMap; +import java.util.Map; +import java.util.regex.Matcher; +import java.util.regex.Pattern; +import java.util.zip.ZipEntry; +import java.util.zip.ZipInputStream; + +import ru.pjandro.wordpdf.ConvertOptions; +import ru.pjandro.wordpdf.DrawingFoundException; +import ru.pjandro.wordpdf.ValidationException; +import ru.pjandro.wordpdf.WordPdfSettings; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * Структура docx-конвертата моста .xlsx (samples/xlsx-basic.xlsx): сетка без + * скрытых колонок/строк, merge'ы, внешняя гиперссылка, rich-раны SST, + * заливки/рамки/цвета/шрифты/vAlign, форматные числа (numFmt, эпоха 1904). + * PDF-уровень — XlsxPdfConverterTest. + */ +class XlsxToDocxTest { + + private static final String DOCUMENT_ENTRY = "word/document.xml"; + + private static byte[] sample(String name) throws IOException { + try (InputStream in = XlsxToDocxTest.class.getClassLoader() + .getResourceAsStream("samples/" + name)) { + assertNotNull(in, "Нет фикстуры: samples/" + name); + return in.readAllBytes(); + } + } + + private static String documentXml(String fixture) throws IOException { + byte[] docx = XlsxToDocx.convert(sample(fixture), ConvertOptions.defaults()); + try (ZipInputStream zip = new ZipInputStream(new ByteArrayInputStream(docx))) { + ZipEntry entry; + while ((entry = zip.getNextEntry()) != null) { + if (DOCUMENT_ENTRY.equals(entry.getName())) { + return new String(zip.readAllBytes(), StandardCharsets.UTF_8); + } + } + } + throw new AssertionError("в конвертате нет word/document.xml"); + } + + @Test + void basic_gridDropsHiddenColumnAndRow() throws IOException { + String xml = documentXml("xlsx-basic.xlsx"); + // фикстура: колонка H и строка 8 скрыты — сетка 7 колонок, 7 строк + Matcher grid = Pattern.compile("(.*?)").matcher(xml); + assertTrue(grid.find(), "нет tblGrid"); + assertTrue(grid.group(1).split("Отчёт"), "нет заголовка"); + assertTrue(!xml.contains("скрытая"), "скрытая строка 8 эмитирована"); + } + + @Test + void merges_gridSpanAndVMerge() throws IOException { + String xml = documentXml("xlsx-basic.xlsx"); + // B2:D2 — горизонтальный; F3:G4 — блок; C5:C6 — вертикальный + assertTrue(xml.contains(""), "нет gridSpan=3 (B2:D2)"); + assertTrue(xml.contains(""), "нет gridSpan=2 (F3:G4)"); + assertTrue(xml.contains(""), "нет vMerge restart"); + assertTrue(Pattern.compile("").matcher(xml).find(), "нет vMerge continue"); + assertTrue(xml.contains("объединённой ячейки"), "текст merge-ячейки потерян"); + } + + @Test + void externalHyperlink_emittedWithRelId() throws IOException { + String xml = documentXml("xlsx-basic.xlsx"); + assertTrue(xml.contains(""), "нет w:hyperlink r:id=hl0: " + + xml.substring(0, Math.min(xml.length(), 600))); + } + + @Test + void richSharedString_boldRunPreserved() throws IOException { + String xml = documentXml("xlsx-basic.xlsx"); + int at = xml.indexOf("ЖИРНЫЙ"); + assertTrue(at > 0, "rich-строка потеряна"); + String run = xml.substring(xml.lastIndexOf("", at), at); + assertTrue(run.contains(""), "полужирный run потерян: " + run); + } + + @Test + void booleanAndInlineStrings_values() throws IOException { + String xml = documentXml("xlsx-basic.xlsx"); + assertTrue(xml.contains("TRUE"), "boolean TRUE потерян"); + assertTrue(xml.contains("инлайн-строка"), "inlineStr потерян"); + assertTrue(xml.contains("1234.5"), "дробное число потеряно"); + } + + @Test + void secondSheet_appendedAfterSeparator() throws IOException { + String xml = documentXml("xlsx-basic.xlsx"); + assertTrue(xml.indexOf("Заметка") > 0, "лист 2 потерян"); + int tables = xml.split("", -1).length - 1; + assertTrue(tables == 2, "число таблиц: " + tables); + } + + @Test + void cellStyles_fillBorderFontColorVAlign() throws IOException { + String xml = documentXml("xlsx-basic.xlsx"); + assertTrue(xml.contains("w:fill=\"FFFF00\""), "жёлтая заливка заголовка потеряна"); + assertTrue(xml.contains("w:color w:val=\"FF0000\""), "красный шрифт Q1 потерян"); + assertTrue(xml.contains("w:color w:val=\"4472C4\""), "theme-accent1 шрифт потерян"); + assertTrue(xml.contains("w:fill=\"B4C7E7\""), "accent1+tint заливка потеряна"); + assertTrue(xml.contains("w:val=\"medium\""), "medium-рамка потеряна"); + assertTrue(xml.contains("w:val=\"dashed\""), "dashed-рамка потеряна"); + assertTrue(xml.contains("w:val=\"double\""), "double-рамка потеряна"); + assertTrue(xml.contains(""), "подчёркивание потеряно"); + assertTrue(xml.contains(""), "зачёркивание потеряно"); + assertTrue(xml.contains(""), + "Excel-дефолт vAlign bottom потерян"); + assertTrue(xml.contains(""), "явный top потерян"); + assertTrue(xml.contains(""), "center в merge потерян"); + } + + @Test + void numFmt_formattedNumbers() throws IOException { + String xml = documentXml("xlsx-numfmt.xlsx"); + assertTrue(xml.contains(">123456.789<"), "General потерян"); + assertTrue(xml.contains(">3.14<"), "0.00 потерян"); + assertTrue(xml.contains(">1,235<"), "#,##0 потерян"); + assertTrue(xml.contains(">$1,234.00<"), "деньги+ потеряны"); + assertTrue(xml.contains(">($1,234.50)<"), "деньги− потеряны"); + assertTrue(xml.contains(">42.5%<"), "процент потерян"); + assertTrue(xml.contains(">1.22E+07<"), "научный потерян"); + assertTrue(xml.contains(">12<"), "scale-миллионы потерян"); + assertTrue(xml.contains(">03.12.2024<"), "дата кастомная потеряна"); + assertTrue(xml.contains(">12-03-24<"), "builtin14 потерян"); + assertTrue(xml.contains(">Tue<"), "ddd потерян"); + assertTrue(xml.contains(">03 December 2024 18:30<"), "dd mmmm yyyy hh:mm потерян"); + assertTrue(xml.contains(">18:00<"), "builtin20 потерян"); + assertTrue(xml.contains(">36:00<"), "elapsed потерян"); + assertTrue(xml.contains(">-1.50<"), "[Red]-секция потеряна"); + assertTrue(xml.contains(">привет<"), "текст в 4-секционном коде потерян"); + assertTrue(xml.contains(">314.16%<"), "builtin10 потерян"); + assertTrue(xml.contains(">12.5<"), "строка в числовом формате изменена"); + assertTrue(xml.contains(">0.00<"), "минус-ноль искажён"); + assertTrue(xml.contains(">28.02.1900<"), "мнимый 29.02.1900 не деградирован"); + } + + @Test + void epoch1904_datesFormatted() throws IOException { + String xml = documentXml("xlsx-1904.xlsx"); + assertTrue(xml.contains(">01.01.1904 00:00<"), "serial 0 эпохи 1904 потерян"); + assertTrue(xml.contains(">02.03.1904 00:00<"), "serial 61 эпохи 1904 потерян"); + } + + // ================== крафтовые пакеты (уровень workbook) ================== + + private static String documentXmlBytes(byte[] xlsx) throws IOException { + return documentXmlBytes(xlsx, ConvertOptions.defaults()); + } + + private static String documentXmlBytes(byte[] xlsx, ConvertOptions options) + throws IOException { + byte[] docx = XlsxToDocx.convert(xlsx, options); + try (ZipInputStream zip = new ZipInputStream(new ByteArrayInputStream(docx))) { + ZipEntry entry; + while ((entry = zip.getNextEntry()) != null) { + if (DOCUMENT_ENTRY.equals(entry.getName())) { + return new String(zip.readAllBytes(), StandardCharsets.UTF_8); + } + } + } + throw new AssertionError("в конвертате нет word/document.xml"); + } + + private static String dataSheet(String extraChildren) { + return XlsxTestZips.sheet("данные" + + "" + extraChildren); + } + + @Test + void hiddenSheets_skippedFromDocx() throws IOException { + byte[] xlsx = XlsxTestZips.workbookBytes("Вид|;Тайный|hidden|rId2", Map.of( + "xl/worksheets/sheet1.xml", dataSheet(""), + "xl/worksheets/sheet2.xml", XlsxTestZips.sheet( + "секрет" + + ""))); + String xml = documentXmlBytes(xlsx); + assertTrue(xml.contains(">данные<")); + assertFalse(xml.contains("секрет"), "hidden-лист не эмитится"); + } + + @Test + void olePresent_errorOnOleRejects_otherwiseIgnored() throws IOException { + byte[] xlsx = XlsxTestZips.workbookBytes("Лист|", Map.of( + "xl/worksheets/sheet1.xml", dataSheet(""))); + assertThrows(DrawingFoundException.class, + () -> XlsxToDocx.convert(xlsx, new ConvertOptions(false, false, true, + WordPdfSettings.MAX_INPUT_MB, WordPdfSettings.MAX_PAGES))); + // флаг выключен — лист проходит, OLE-окружение просто не эмитится + assertTrue(documentXmlBytes(xlsx).contains(">данные<")); + } + + @Test + void emptySheets_onlyBodyParagraphRemains() throws IOException { + byte[] xlsx = XlsxTestZips.workbookBytes("Лист|", Map.of( + "xl/worksheets/sheet1.xml", XlsxTestZips.sheet(""))); + String xml = documentXmlBytes(xlsx); + assertFalse(xml.contains(""), "пустой лист — без таблицы"); + assertTrue(xml.contains(""), "документ обязан содержать контент-блок"); + } + + @Test + void drawings_imageRunInCellAndThemePartCarried() throws IOException { + String xdr = "xmlns:xdr=\"http://schemas.openxmlformats.org/drawingml/2006/" + + "spreadsheetDrawing\" xmlns:a=\"http://schemas.openxmlformats.org/drawingml" + + "/2006/main\" xmlns:r=\"http://schemas.openxmlformats.org/officeDocument" + + "/2006/relationships\""; + String pic = "00" + + "00" + + "" + + "" + + ""; + byte[] xlsx = XlsxTestZips.workbookBytes("Лист|", Map.of( + "xl/worksheets/sheet1.xml", XlsxTestZips.sheet( + "1" + + ""), + "xl/worksheets/_rels/sheet1.xml.rels", + "", + "xl/drawings/drawing1.xml", + "" + pic + "", + "xl/drawings/_rels/drawing1.xml.rels", + "", + "xl/media/i.png", "PNGDATA", + "xl/theme/theme1.xml", "")); + byte[] docx = XlsxToDocx.convert(xlsx, ConvertOptions.defaults()); + Map entries = new LinkedHashMap<>(); + try (ZipInputStream zip = new ZipInputStream(new ByteArrayInputStream(docx))) { + ZipEntry entry; + while ((entry = zip.getNextEntry()) != null) { + entries.put(entry.getName(), + new String(zip.readAllBytes(), StandardCharsets.UTF_8)); + } + } + String body = entries.get("word/document.xml"); + assertTrue(body.contains(""), + "рисунок обязан стоять внутри from-ячейки"); + assertTrue(entries.containsKey("word/media/xlsx-image1.png")); + assertTrue(entries.containsKey("word/theme/theme1.xml"), "theme-часть не перенесена"); + assertTrue(entries.get("word/_rels/document.xml.rels").contains("/theme")); + } + + @Test + void sections_breakAfterBlockAndFinalBodySectPr() throws IOException { + byte[] xlsx = XlsxTestZips.workbookBytes("Л1|;Л2|", Map.of( + "xl/worksheets/sheet1.xml", dataSheet(""), + "xl/worksheets/sheet2.xml", dataSheet(""))); + String xml = documentXmlBytes(xlsx); + assertTrue(xml.contains(""), + "нет paragraph-level sectPr после блока листа 1"); + assertTrue(xml.contains(" XlsxToDocx.convert("это не zip".getBytes(StandardCharsets.UTF_8), + ConvertOptions.defaults())); + } +} diff --git a/wordpdf-core/src/test/resources/samples/xlsx-1904.xlsx b/wordpdf-core/src/test/resources/samples/xlsx-1904.xlsx new file mode 100644 index 0000000..38ef0aa Binary files /dev/null and b/wordpdf-core/src/test/resources/samples/xlsx-1904.xlsx differ diff --git a/wordpdf-core/src/test/resources/samples/xlsx-basic.xlsx b/wordpdf-core/src/test/resources/samples/xlsx-basic.xlsx new file mode 100644 index 0000000..c2e4f1e Binary files /dev/null and b/wordpdf-core/src/test/resources/samples/xlsx-basic.xlsx differ diff --git a/wordpdf-core/src/test/resources/samples/xlsx-chart-image.xlsx b/wordpdf-core/src/test/resources/samples/xlsx-chart-image.xlsx new file mode 100644 index 0000000..1067ad8 Binary files /dev/null and b/wordpdf-core/src/test/resources/samples/xlsx-chart-image.xlsx differ diff --git a/wordpdf-core/src/test/resources/samples/xlsx-fit-to-page.xlsx b/wordpdf-core/src/test/resources/samples/xlsx-fit-to-page.xlsx new file mode 100644 index 0000000..f038233 Binary files /dev/null and b/wordpdf-core/src/test/resources/samples/xlsx-fit-to-page.xlsx differ diff --git a/wordpdf-core/src/test/resources/samples/xlsx-numfmt.xlsx b/wordpdf-core/src/test/resources/samples/xlsx-numfmt.xlsx new file mode 100644 index 0000000..dad2270 Binary files /dev/null and b/wordpdf-core/src/test/resources/samples/xlsx-numfmt.xlsx differ diff --git a/wordpdf-core/src/test/resources/samples/xlsx-page-limit.xlsx b/wordpdf-core/src/test/resources/samples/xlsx-page-limit.xlsx new file mode 100644 index 0000000..95fa182 Binary files /dev/null and b/wordpdf-core/src/test/resources/samples/xlsx-page-limit.xlsx differ diff --git a/wordpdf-core/src/test/resources/samples/xlsx-wide.xlsx b/wordpdf-core/src/test/resources/samples/xlsx-wide.xlsx new file mode 100644 index 0000000..b0a3176 Binary files /dev/null and b/wordpdf-core/src/test/resources/samples/xlsx-wide.xlsx differ diff --git a/wordpdf-web/src/api.ts b/wordpdf-web/src/api.ts index a6fc33b..cf7c9cb 100644 --- a/wordpdf-web/src/api.ts +++ b/wordpdf-web/src/api.ts @@ -64,7 +64,9 @@ export async function convertDocx( // флаг i обязателен; фолбэк — имя исходника с заменой расширения const cd = resp.headers.get('Content-Disposition') ?? '' const m = /filename\*=utf-8''([^;]+)/i.exec(cd) - const filename = m ? decodeURIComponent(m[1]) : file.name.replace(/\.docx?$/i, '') + '.pdf' + const filename = m + ? decodeURIComponent(m[1]) + : file.name.replace(/\.(docx?|xlsx)$/i, '') + '.pdf' const blob = await resp.blob() return { blob, filename } } diff --git a/wordpdf-web/src/components/App.tsx b/wordpdf-web/src/components/App.tsx index e1c299b..1724fef 100644 --- a/wordpdf-web/src/components/App.tsx +++ b/wordpdf-web/src/components/App.tsx @@ -130,7 +130,7 @@ export default function App() {

Word → PDF

- docx/doc → PDF на docx4j + Apache FOP. Лимиты задаёт сервер; + docx/doc/xlsx → PDF на docx4j + Apache FOP. Лимиты задаёт сервер; переопределение из формы убрано.

diff --git a/wordpdf-web/src/components/DropZone.tsx b/wordpdf-web/src/components/DropZone.tsx index 8bef2a2..d65739f 100644 --- a/wordpdf-web/src/components/DropZone.tsx +++ b/wordpdf-web/src/components/DropZone.tsx @@ -8,7 +8,7 @@ interface Props { } /** - * Зона drag&drop + клик для выбора .docx/.doc. Скрытый input[type=file] — + * Зона drag&drop + клик для выбора .docx/.doc/.xlsx. Скрытый input[type=file] — * единственный источник выбора; drop берёт первый файл. */ export default function DropZone({ file, disabled, onSelect }: Props) { @@ -53,7 +53,7 @@ export default function DropZone({ file, disabled, onSelect }: Props) { - Перетащите .docx или .doc сюда или нажмите для выбора + Перетащите .docx, .doc или .xlsx сюда или нажмите для выбора {file && ( {file.name} · {(file.size / 1024).toFixed(0)} КБ @@ -62,7 +62,7 @@ export default function DropZone({ file, disabled, onSelect }: Props) { {