Ревью-фиксы: DoS chart-XML, корректность вывода, auth-обход, стандарты OOXML в docs/ #36

Merged
pjandro merged 7 commits from ooxml-review-hardening into main 2026-10-25 00:53:34 +03:00
33 changed files with 600035 additions and 52 deletions
+1 -1
View File
@@ -265,7 +265,7 @@ jobs:
image: $REGISTRY/wordpdf-web:prod image: $REGISTRY/wordpdf-web:prod
restart: on-failure:5 restart: on-failure:5
healthcheck: healthcheck:
test: ["CMD-SHELL", "http_proxy= https_proxy= wget -qO /dev/null http://127.0.0.1/ || exit 1"] test: ["CMD-SHELL", "HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1/ || exit 1"]
interval: 10s interval: 10s
timeout: 3s timeout: 3s
start_period: 10s start_period: 10s
+3
View File
@@ -2,6 +2,9 @@
target/ target/
dependency-reduced-pom.xml dependency-reduced-pom.xml
# Аргумент-файлы javac (мусор компиляции в корне)
javac.*.args
# Node (wordpdf-web) # Node (wordpdf-web)
node_modules/ node_modules/
wordpdf-web/dist/ wordpdf-web/dist/
+6 -3
View File
@@ -28,7 +28,9 @@
### Chart-движок (`internal/chart`, package-private кроме `DrawingPreRenderer.run`) ### Chart-движок (`internal/chart`, package-private кроме `DrawingPreRenderer.run`)
Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр × `DPI/72`, размеры — в пунктах, EMU→pt `cx/12700.0`). `ChartSpec.parse` (`enum Type`: PIE/PIE3D/DOUGHNUT/BAR/BAR_HORIZONTAL/LINE/AREA/SURFACE3D/UNSUPPORTED; пустой `c:title` + `autoTitleDeleted="0"` → у **круговых** имя первого ряда, у прочих — `AUTO_TITLE = "Название диаграммы"` (русская замена англ. плейсхолдеру Word); палитра `accent1..6` темы, легенда по умолчанию снизу, позиция `t` поддержана, `overlay` → место не резервируется) → `ChartRenderer` (осевые «круглые» шаги `niceUnit` 1/2/5·10ⁿ как Word) → пейнтеры `CartesianPainter`/`PiePainter` (`PIE_DEPTH=0.22`, `PIE_FIT=0.865`)/`Surface3dPainter` (калибровка по эталону Word 300 dpi, камера — регрессия `cameraMatchesWordReference`: `DEPTH_RATIO=0.705`, `HEIGHT_RATIO=0.664`, `GUTTER_LEFT/RIGHT=0.1485`, `GUTTER_TOP=0.116`, `GUTTER_BOTTOM=0.146`, свет `LIGHT_X/Y/Z=0.83/0.48/0.28`); `SmartArtRenderer` рисует кэш разложенной схемы (relationship `…/office/2007/relationships/diagramDrawing`, фактически `word/diagrams/drawing1.xml`; fit-scale ×0.80), формы строит `PresetGeometry` — ECMA-пресет-геометрия `a:prstGeom`: avLst/gdLst/pathLst семи пресетов (rect, roundRect, ellipse, gear6, gear9, circularArrow, leftCircularArrow) дословно из `presetShapeDefinitions.xml`, вычислитель префиксных формул; оператор `?:` = «if x > 0 then y else z» (ISO/IEC 29500-1, НЕ x != 0), углы в Arc2D передавать со знаком минус (математическая конвенция y вверх), неизвестный пресет → прямоугольник ячейки (синхрон таблицы со стандартом пинит `PresetGeometryTest#tableMatchesEcmaXml`); палитра темы — `DrawMlColor` (instance; без ThemePart — дефолтная Office-палитра `accent1=4472C4`…); текст — `DrawMlText`; утилиты `RgbHsl`. Калибровочные константы менять только вместе с `Surface3dPainterTest`/`PiePainterTest`. Обход `pkg.getParts()` — только по **снимку** списка (`createImagePart` мутирует реестр → CME); rels частей — `part.getRelationshipsPart()`, НЕ `getOwningRelationshipPart()` (это rels ссылающегося); обход XML обязан раскрывать `JAXBElement`. Нормативный источник любых правок/решений по диаграммам и SmartArt — ECMA-376 (`docs/standards/`: графики §21.2, diagram-разметка §21.4, пресет-геометрия Annex D + `schema/*.xsd`; поведение Word — `ms-oi29500.md`, `ms-odrawxml.md`), а не догадки по исходникам LibreOffice/Word-эмпирике; эмпирические калибровки (камера, `PIE_DEPTH`) менять только вместе с пиксельными тестами. Формулировки из стандарта при ссылке — с номером секции (§21.2.2.132 и т.п.).
Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр × `DPI/72`, размеры — в пунктах, EMU→pt `cx/12700.0`). `ChartSpec.parse` (`enum Type`: PIE/PIE3D/DOUGHNUT/BAR/BAR_HORIZONTAL/LINE/AREA/SURFACE3D/UNSUPPORTED; пустой `c:title` + `autoTitleDeleted="0"` → у **круговых** имя первого ряда, у прочих — `AUTO_TITLE = "Название диаграммы"` (русская замена англ. плейсхолдеру Word); палитра `accent1..6` темы, легенда по умолчанию снизу, позиция `t` поддержана, `overlay` (§21.2.2.132) → рисуется поверх области построения, место не резервирует (`ChartSpec.legendOverlay`, регрессия `ChartRendererTest#overlayLegend_drawnOverPlot`)) → `ChartRenderer` (осевые «круглые» шаги `niceUnit` 1/2/5·10ⁿ как Word; санитайзер `c:majorUnit` — `MAX_TICKS`: шаг ≤ 0/NaN/слишком мелкий в `axisBounds` заменяется niceUnit, иначе циклы делений вечные) → пейнтеры `CartesianPainter`/`PiePainter` (`PIE_DEPTH=0.22`, `PIE_FIT=0.865`)/`Surface3dPainter` (калибровка по эталону Word 300 dpi, камера — регрессия `cameraMatchesWordReference`: `DEPTH_RATIO=0.705`, `HEIGHT_RATIO=0.664`, `GUTTER_LEFT/RIGHT=0.1485`, `GUTTER_TOP=0.116`, `GUTTER_BOTTOM=0.146`, свет `LIGHT_X/Y/Z=0.83/0.48/0.28`); `SmartArtRenderer` рисует кэш разложенной схемы (relationship `…/office/2007/relationships/diagramDrawing`, фактически `word/diagrams/drawing1.xml`; fit-scale ×0.80), формы строит `PresetGeometry` — ECMA-пресет-геометрия `a:prstGeom`: avLst/gdLst/pathLst семи пресетов (rect, roundRect, ellipse, gear6, gear9, circularArrow, leftCircularArrow) дословно из `presetShapeDefinitions.xml`, вычислитель префиксных формул; оператор `?:` = «if x > 0 then y else z» (ISO/IEC 29500-1, НЕ x != 0), углы в Arc2D передавать со знаком минус (математическая конвенция y вверх), неизвестный пресет → прямоугольник ячейки (синхрон таблицы со стандартом пинит `PresetGeometryTest#tableMatchesEcmaXml`); палитра темы — `DrawMlColor` (instance; без ThemePart — дефолтная Office-палитра `accent1=4472C4`…); текст — `DrawMlText`; утилиты `RgbHsl`. Калибровочные константы менять только вместе с `Surface3dPainterTest`/`PiePainterTest`. Защитные лимиты против враждебного chart-XML: `ChartSpec.MAX_POINTS` (`c:pt/@idx` §21.2.2.150/.151 и `c:ptCount` §21.2.2.152 — ST_UnsignedInt без верхней границы, отказ `IllegalArgumentException` до предвыделения списка) и `MAX_TICKS` (см. выше); бросок перехватывает catch `DrawingPreRenderer.renderChart` → штатная деградация «объект удалён + warn». Обход `pkg.getParts()` — только по **снимку** списка (`createImagePart` мутирует реестр → CME); rels частей — `part.getRelationshipsPart()`, НЕ `getOwningRelationshipPart()` (это rels ссылающегося); обход XML обязан раскрывать `JAXBElement`.
### Критические инварианты (нарушение = битый вывод) ### Критические инварианты (нарушение = битый вывод)
@@ -61,6 +63,7 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр
|`.gitea/workflows/`|Gitea Actions: `pr.yml` (PR checks), `main.yml` (тесты + coverage-сводка и комментарий в PR → `images-app`/`images-web` (build+push в Nexus) → deploy (рендер прод-конфигов + pull) → autotests → rollback)| |`.gitea/workflows/`|Gitea Actions: `pr.yml` (PR checks), `main.yml` (тесты + coverage-сводка и комментарий в PR → `images-app`/`images-web` (build+push в Nexus) → deploy (рендер прод-конфигов + pull) → autotests → rollback)|
|корневой `GITEA-vars.md`|инструкция владельца: Secrets/Variables, защита ветки, перезапуск — только имена переменных, без значений| |корневой `GITEA-vars.md`|инструкция владельца: Secrets/Variables, защита ветки, перезапуск — только имена переменных, без значений|
|корневой `prod-autotests/`|прод-автотесты API (pytest + requests, 21 проверка): конфигурация стенда **только env** (`WORDPDF_BASE_URL` обязателен, `WORDPDF_API_KEY`/`WORDPDF_MAX_PAGES`/`WORDPDF_MAX_MB`/`WORDPDF_SAMPLES_DIR` факультативны) — прод-хостов/ключей в коде нет; окружение — mise (`mise.toml`: python 3.15 + автосоздаваемый `.venv`); прод-раннер вне git — `/home/pjandro/prod/java-word-pdf/run-prod-tests.sh`| |корневой `prod-autotests/`|прод-автотесты API (pytest + requests, 21 проверка): конфигурация стенда **только env** (`WORDPDF_BASE_URL` обязателен, `WORDPDF_API_KEY`/`WORDPDF_MAX_PAGES`/`WORDPDF_MAX_MB`/`WORDPDF_SAMPLES_DIR` факультативны) — прод-хостов/ключей в коде нет; окружение — mise (`mise.toml`: python 3.15 + автосоздаваемый `.venv`); прод-раннер вне git — `/home/pjandro/prod/java-word-pdf/run-prod-tests.sh`|
|`docs/standards/`|нормативная документация OOXML: PDF+md ECMA-376 Part 1 (5-е изд.), md [MS-OI29500]/[MS-ODRAWXML], XSD `schema/` — источник истины для chart-движка (правило — в секции «Chart-движок»); регенерация — `docs/standards/README.md`|
|`develop/` (вне git, gitignored)|рабочие материалы и эталоны Word для ручного сравнения — **не фикстуры**, в тесты/jar не подключать; на 2026-10 директория пуста (эталоны вынесены, пиксельные замеры зашиты числами в chart-тестах)| |`develop/` (вне git, gitignored)|рабочие материалы и эталоны Word для ручного сравнения — **не фикстуры**, в тесты/jar не подключать; на 2026-10 директория пуста (эталоны вынесены, пиксельные замеры зашиты числами в chart-тестах)|
## Development Commands ## Development Commands
@@ -165,12 +168,12 @@ SSH-пользователи/логины, ни хосты, ни директо
- Гейт `maven-pmd-plugin` 3.28.0 (PMD 7.17) на `verify` для обоих модулей, ruleset `pmd-ruleset.xml` (codestyle без opinionated-правил + unused-правила + XPath `LiteralFirstInEquals` — строковый литерал слева в `equals`/`equalsIgnoreCase`; `junit5TestPattern` разрешает underscore-имена регрессий; `includeTests=true` — тесты сканируются; `failurePriority` не задан — на практике `verify` валят нарушения любой приоритетности, проверено на priority 3–4: строки `[WARNING] PMD Failure` = BUILD FAILURE). Литералы в условиях `if` — только именованными константами (`AvoidLiteralsInIfCondition`; `else if`-ветки правило не проверяет, обычный вложенный `if` — проверяет; пустые `while` тоже валятся — `EmptyControlStatement`), `null` вместо пустой коллекции запрещён (`ReturnEmptyCollectionRatherThanNull` — `GlyphCoverageNormalizer.split` возвращает пустой список). - Гейт `maven-pmd-plugin` 3.28.0 (PMD 7.17) на `verify` для обоих модулей, ruleset `pmd-ruleset.xml` (codestyle без opinionated-правил + unused-правила + XPath `LiteralFirstInEquals` — строковый литерал слева в `equals`/`equalsIgnoreCase`; `junit5TestPattern` разрешает underscore-имена регрессий; `includeTests=true` — тесты сканируются; `failurePriority` не задан — на практике `verify` валят нарушения любой приоритетности, проверено на priority 3–4: строки `[WARNING] PMD Failure` = BUILD FAILURE). Литералы в условиях `if` — только именованными константами (`AvoidLiteralsInIfCondition`; `else if`-ветки правило не проверяет, обычный вложенный `if` — проверяет; пустые `while` тоже валятся — `EmptyControlStatement`), `null` вместо пустой коллекции запрещён (`ReturnEmptyCollectionRatherThanNull` — `GlyphCoverageNormalizer.split` возвращает пустой список).
- Гейт JaCoCo `0.8.15`: `jacoco:check` (правило LINE, COVEREDRATIO `0.90`) на `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`) и рендер-код, требующий эталонного Word. - Гейт JaCoCo `0.8.15`: `jacoco:check` (правило LINE, COVEREDRATIO `0.90`) на `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`) и рендер-код, требующий эталонного Word.
- 23 тестовых класса / 218 `@Test` (core 17/180, app 6/38: ConvertController 19 + ApiKeyFilter 7 + ConvertLimits 2 + ConversionService 5 + ApiExceptionHandler 4 + ConversionTimeout 1). JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true` в argLine; только `Assertions` (Mockito/AssertJ не использовать, несмотря на test-classpath Boot; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`); тестовые классы package-private, зеркалят main-пакеты; только `@Test` (+ единственный `@BeforeAll` — warm-up шрифтов в `GlyphCoverageNormalizerTest`). - 24 тестовых класса / 233 `@Test` (core 18/191, app 6/42: ConvertController 20 + ApiKeyFilter 8 + ConvertLimits 3 + ConversionService 5 + ApiExceptionHandler 4 + ConversionTimeout 2). JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true` в argLine; только `Assertions` (Mockito/AssertJ не использовать, несмотря на test-classpath Boot; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`); тестовые классы package-private, зеркалят main-пакеты; только `@Test` (+ единственный `@BeforeAll` — warm-up шрифтов в `GlyphCoverageNormalizerTest`).
- **PDF сравнивается текстом, не растеризацией**: PDFBox 3 (`Loader.loadPDF`) — `PDFTextStripper` для текста (пер-странично `setStartPage/setEndPage`), override `processTextPosition` для шрифта конкретного символа (`fontNameOf`), обход ресурсов страниц для встроенных шрифтов (`EAAAAA+Carlito-Bold`) и счётчика картинок (`imageCount`). Негативные маркеры — регрессии: `assertFalse(text.contains("#"))` (.notdef), `assertFalse(font.startsWith("Helvetica"))`. Текст нормализуется по пробелам (`norm`); в `tableImage_tableAndImage` — полное удаление пробелов (docx4j переносит слова в auto-fit таблицах). - **PDF сравнивается текстом, не растеризацией**: PDFBox 3 (`Loader.loadPDF`) — `PDFTextStripper` для текста (пер-странично `setStartPage/setEndPage`), override `processTextPosition` для шрифта конкретного символа (`fontNameOf`), обход ресурсов страниц для встроенных шрифтов (`EAAAAA+Carlito-Bold`) и счётчика картинок (`imageCount`). Негативные маркеры — регрессии: `assertFalse(text.contains("#"))` (.notdef), `assertFalse(font.startsWith("Helvetica"))`. Текст нормализуется по пробелам (`norm`); в `tableImage_tableAndImage` — полное удаление пробелов (docx4j переносит слова в auto-fit таблицах).
- Пиксели (BufferedImage) — только в unit-тестах chart-пейнтеров: безразмерные отношения к эталону Word, допуски `assertRatio` <0.06 (`PiePainterTest` аспект h/w=0.585) / <0.10 (`Surface3dPainterTest`, + `assertRange` ±6 pt для центров силуэта); пороги залитых px и перцентильные коридоры яркости. Эталонные замеры — по Word-экспорту 300 dpi (числа зашиты в тесты; эталонные файлы — `develop/`, вне git, на 2026-10 пуста). - Пиксели (BufferedImage) — только в unit-тестах chart-пейнтеров: безразмерные отношения к эталону Word, допуски `assertRatio` <0.06 (`PiePainterTest` аспект h/w=0.585) / <0.10 (`Surface3dPainterTest`, + `assertRange` ±6 pt для центров силуэта); пороги залитых px и перцентильные коридоры яркости. Эталонные замеры — по Word-экспорту 300 dpi (числа зашиты в тесты; эталонные файлы — `develop/`, вне git, на 2026-10 пуста).
- `GlyphFont` (fontbox): метрики пиксельно-метрически эквивалентны AWT (ascent/descent/leading/advance совпадают до 4-го знака, кернинг-дрейф 0.0000 — DejaVu Sans, Carlito). Приёмочный стенд без-fontconfig: контейнер без `libfontconfig.so.1*` и `/etc/fonts`, `mvn verify` + `java -jar` (до перехода на GlyphFont там падали `GlyphCoverageNormalizerTest` 12 / `CartesianPainterTest` 3 / `PiePainterTest` 2 / chart-тесты `WordPdfConverterTest` 4, chart-рендер молча деградировал). `GlyphFontTest` написан без единого `java.awt.Font` — обязан проходить на хосте без fontconfig. - `GlyphFont` (fontbox): метрики пиксельно-метрически эквивалентны AWT (ascent/descent/leading/advance совпадают до 4-го знака, кернинг-дрейф 0.0000 — DejaVu Sans, Carlito). Приёмочный стенд без-fontconfig: контейнер без `libfontconfig.so.1*` и `/etc/fonts`, `mvn verify` + `java -jar` (до перехода на GlyphFont там падали `GlyphCoverageNormalizerTest` 12 / `CartesianPainterTest` 3 / `PiePainterTest` 2 / chart-тесты `WordPdfConverterTest` 4, chart-рендер молча деградировал). `GlyphFontTest` написан без единого `java.awt.Font` — обязан проходить на хосте без fontconfig.
- Фикстуры — закоммиченные `samples/*.docx` (12; в тестах не генерировать): core грузит classpath-ресурсом → `byte[]`, PDF для PDFBox — временный файл; app читает `/samples/…` из **test-jar core** (classifier `tests`) → `mvn -pl wordpdf-app` без `-am` не соберётся. In-memory docx — `ZipOutputStream` из литеральных XML или POI в `byte[]`. Ключевые: `too-many-pages` (150 явных разрывов → 151), `stale-cache` (кэш `<Pages>1</Pages>` + 110 `lastRenderedPageBreak`), `charts-smartart` (4 растра; SmartArt-одиночка = ровно 2 Image XObject), `ole-embedded` (осиротевший bin с ложным `Default bin→footer+xml` + настоящий `w:object` с честным `Override → oleObject`; ручная, генератором не перезаписывать). - Фикстуры — закоммиченные `samples/*.docx` (12; в тестах не генерировать): core грузит classpath-ресурсом → `byte[]`, PDF для PDFBox — временный файл; app читает `/samples/…` из **test-jar core** (classifier `tests`) → `mvn -pl wordpdf-app` без `-am` не соберётся. In-memory docx — `ZipOutputStream` из литеральных XML или POI в `byte[]`. Ключевые: `too-many-pages` (150 явных разрывов → 151), `stale-cache` (кэш `<Pages>1</Pages>` + 110 `lastRenderedPageBreak`), `charts-smartart` (4 растра; SmartArt-одиночка = ровно 2 Image XObject), `ole-embedded` (осиротевший bin с ложным `Default bin→footer+xml` + настоящий `w:object` с честным `Override → oleObject`; ручная, генератором не перезаписывать).
- Юниты нормализаторов работают строками (`rewrite`) + zip'ами из `ZipOutputStream`; обязательные контракты: «нечего менять → тот же массив» (`assertSame` покрыт тестами только у zip-нормализаторов `DocxOnOff`/`SymbolFont`/`StrictOoxml` и у `OleObject` — `printerSettings`-bin/нет `.bin`; у `Field`/`GlyphCoverage` — `rewrite`→`null`) и неприкосновенность частей вне `word/*.xml` (`[Content_Types].xml`). Тесты бьют и в package-private API (`GlyphCoverageNormalizer.split(text, family)`, `ChartSpec.readTitle`). Исключение — `OleObjectNormalizerTest`: многочастный нормализатор без `rewrite`-хука, тесты только через `normalize` на in-memory zip. - Юниты нормализаторов работают строками (`rewrite`) + zip'ами из `ZipOutputStream`; обязательные контракты: «нечего менять → тот же массив» (`assertSame` покрыт тестами только у zip-нормализаторов `DocxOnOff`/`SymbolFont`/`StrictOoxml` и у `OleObject` — `printerSettings`-bin/нет `.bin`; у `Field`/`GlyphCoverage` — `rewrite`→`null`) и неприкосновенность частей вне `word/*.xml` (`[Content_Types].xml`). Тесты бьют и в package-private API (`GlyphCoverageNormalizer.split(text, family)`, `ChartSpec.readTitle`). Исключение — `OleObjectNormalizerTest`: многочастный нормализатор без `rewrite`-хука, тесты только через `normalize` на in-memory zip.
- App-тесты: `@SpringBootTest` + `@AutoConfigureMockMvc` (Boot 4: `org.springframework.boot.webmvc.test.autoconfigure`); три контекста — `ConvertControllerTest` (пустой ключ), `ApiKeyFilterTest` (`properties = "wordpdf.api-key=…"`), `ConvertLimitsTest` (`@TestPropertySource` с лимитами — отдельный класс, не `@Nested`). - App-тесты: `@SpringBootTest` + `@AutoConfigureMockMvc` (Boot 4: `org.springframework.boot.webmvc.test.autoconfigure`); три контекста — `ConvertControllerTest` (пустой ключ), `ApiKeyFilterTest` (`properties = "wordpdf.api-key=…"`), `ConvertLimitsTest` (`@TestPropertySource` с лимитами — отдельный класс, не `@Nested`).
- Регрессивные пары (фикс = нормализатор/pre-renderer + юнит + конвертер-тест с фикстурой): `StrictOoxmlNormalizerTest`↔`strictOoxml_convertsNotRejected` (+`pageCount_strictBreaksCountedLightweight` — lightweight против strict), `DocxOnOffNormalizerTest`↔`ruPlain_regularRunsUseRegularFont`, `SymbolFontNormalizerTest`↔`symbolFonts_bulletsAreNotHash`, `FieldNormalizerTest`↔`pageNumbers_recomputedNotCached`, `GlyphCoverageNormalizerTest`↔`exoticGlyphs_drawnNotHash`, `OleObjectNormalizerTest`↔`oleObjects_removedAndConverted`/`drawingErrors_errorFlagRejectsOle` (+app `errorFlagOle_rejected`/`oleObjects_removedByDefault`), `WordPdfValidatorTest`↔`staleCachePageCountRejectedBeforeRender` (+`checkPageCount_limitBoundary` 99/100/101, `pageCount_breaksInsideTablesAreCounted`, `pageCount_continuousSectionsNotCountedLightweight`, `validate_notAZip`↔`inputNotAZip_rejectedBeforeRender`, `validate_plainZipRejected`/`validate_xlsxRenamedRejected`/`validate_zipBombRejected`/`validate_tooManyEntriesRejected`↔`plainZipNotDocx_rejected`/`inputNotDocx_rejectedBeforeRender` — контейнер и zip-бомба), `BundledFontsTest`↔`ruPlain_emDashEmbeddedNotHelvetica`, `ChartSpecTest`↔автозаголовки, `PresetGeometryTest`↔`chartsSmartArt_drawingsBecomeImages` (`tableMatchesEcmaXml` — синхрон таблицы пресетов с ECMA XML; кольцевые стрелки — семантика `?:` и знаки дуг Arc2D), chart-пейнтеры↔`chartsSmartArt_drawingsBecomeImages` (+`drawingErrors_*`↔app `errorFlagCharts_rejected`/`errorFlagSmartArt_rejected`); `noLoggingWarningInPdf` — регрессия `slf4j-simple`, `pdfTitle_comesFromParameter` — регрессия PDF-title (юнит-партнёра нет). App-регрессии: `requestLimitParams_areIgnored`, `nonPositiveLimits_failStartup`, `unknownPath_notFound`, `concurrentRequests_bothSucceed` (гонка реестра `PhysicalFonts`), `corruptNotAZip_rejected`, `plainZipNotDocx_rejected` (голый zip без манифеста → 400), `junkInsideValidZip_conversionError` (500 на валидном .docx-контейнере с мусором), `nonDocxFilename_rejected`, `oversizedOverCoreLimit_rejected`, `drawingsAlwaysRendered`, `cyrillicAndPathInFilename_sanitizedResponseName` (RFC 5987 + path-traversal), `docsOpenWithoutKey`/`forwardedPrefix_healthStaysOpen`/`forwardedPrefix_docsOpenWithoutKey` (открытая документация + матч фильтра без forwarded-contextPath). - Регрессивные пары (фикс = нормализатор/pre-renderer + юнит + конвертер-тест с фикстурой): `StrictOoxmlNormalizerTest`↔`strictOoxml_convertsNotRejected` (+`pageCount_strictBreaksCountedLightweight` — lightweight против strict), `DocxOnOffNormalizerTest`↔`ruPlain_regularRunsUseRegularFont`, `SymbolFontNormalizerTest`↔`symbolFonts_bulletsAreNotHash`, `FieldNormalizerTest`↔`pageNumbers_recomputedNotCached`, `GlyphCoverageNormalizerTest`↔`exoticGlyphs_drawnNotHash`, `OleObjectNormalizerTest`↔`oleObjects_removedAndConverted`/`drawingErrors_errorFlagRejectsOle` (+app `errorFlagOle_rejected`/`oleObjects_removedByDefault`), `WordPdfValidatorTest`↔`staleCachePageCountRejectedBeforeRender` (+`checkPageCount_limitBoundary` 99/100/101, `pageCount_breaksInsideTablesAreCounted`, `pageCount_continuousSectionsNotCountedLightweight`, `validate_notAZip`↔`inputNotAZip_rejectedBeforeRender`, `validate_plainZipRejected`/`validate_xlsxRenamedRejected`/`validate_zipBombRejected`/`validate_tooManyEntriesRejected`↔`plainZipNotDocx_rejected`/`inputNotDocx_rejectedBeforeRender` — контейнер и zip-бомба), `BundledFontsTest`↔`ruPlain_emDashEmbeddedNotHelvetica`, `ChartSpecTest`↔автозаголовки, `PresetGeometryTest`↔`chartsSmartArt_drawingsBecomeImages` (`tableMatchesEcmaXml` — синхрон таблицы пресетов с ECMA XML; кольцевые стрелки — семантика `?:` и знаки дуг Arc2D), chart-пейнтеры↔`chartsSmartArt_drawingsBecomeImages` (+`drawingErrors_*`↔app `errorFlagCharts_rejected`/`errorFlagSmartArt_rejected`); `noLoggingWarningInPdf` — регрессия `slf4j-simple`, `pdfTitle_comesFromParameter` — регрессия PDF-title (юнит-партнёра нет). App-регрессии: `requestLimitParams_areIgnored`, `nonPositiveLimits_failStartup`, `unknownPath_notFound`, `concurrentRequests_bothSucceed` (гонка реестра `PhysicalFonts`), `corruptNotAZip_rejected`, `plainZipNotDocx_rejected` (голый zip без манифеста → 400), `junkInsideValidZip_conversionError` (500 на валидном .docx-контейнере с мусором), `nonDocxFilename_rejected`, `oversizedOverCoreLimit_rejected`, `drawingsAlwaysRendered`, `cyrillicAndPathInFilename_sanitizedResponseName` (RFC 5987 + path-traversal), `docsOpenWithoutKey`/`forwardedPrefix_healthStaysOpen`/`forwardedPrefix_docsOpenWithoutKey` (открытая документация + матч фильтра без forwarded-contextPath), `dotSegmentOpenPrefix_rejected` (точечные сегменты `..`/`%2e` — не открытый путь), `errorFlagNotBoolean_rejected` (битый error-флаг → 400); DoS/корректность core: `ChartSpecTest#hugePointIndex_rejectedNotOom`/`hugePtCount_rejectedNotOom`/`hugeCategoryIndex_rejectedNotOom` (`MAX_POINTS`), `Surface3dPainterTest#axisBounds_tinyMajorUnit_fallsBackToNiceUnit`/`axisBounds_zeroMajorUnit_fallsBackToNiceUnit` (`MAX_TICKS`), `GlyphCoverageNormalizerTest#multipleTextNodes_runLeftUntouched` (guard составного рана)/`nestedRunInTextBox_innerSplit` + `SymbolFontNormalizerTest#nestedRunInTextBox_innerNormalized` (вложенные раны текстбоксов), `CartesianPainterTest#areaFill_closesToBaseline` (AREA к базовой линии), `ChartRendererTest#overlayLegend_drawnOverPlot` + `ChartSpecTest#overlayLegend_keepsPositionAndFlag` (overlay-легенда).
- UI-тестов нет; гейт SPA — `npm run build` (tsc -b) + `npm run lint` (oxlint, `.oxlintrc.json`: rules-of-hooks error, only-export-components warn). Прод-автотесты (pytest 9 + requests, 21 проверка, env-конфиг, `mise exec -- python -m pytest -q .` из `prod-autotests/`) гоняются CI после deploy против живого прода; `WORDPDF_API_KEY` пуст → честный SKIP `@needs_key`-проверок. - UI-тестов нет; гейт SPA — `npm run build` (tsc -b) + `npm run lint` (oxlint, `.oxlintrc.json`: rules-of-hooks error, only-export-components warn). Прод-автотесты (pytest 9 + requests, 21 проверка, env-конфиг, `mise exec -- python -m pytest -q .` из `prod-autotests/`) гоняются CI после deploy против живого прода; `WORDPDF_API_KEY` пуст → честный SKIP `@needs_key`-проверок.
+1 -1
View File
@@ -26,7 +26,7 @@ services:
restart: unless-stopped restart: unless-stopped
# См. комментарий у app: дубль HEALTHCHECK из wordpdf-web/Containerfile # См. комментарий у app: дубль HEALTHCHECK из wordpdf-web/Containerfile
healthcheck: healthcheck:
test: ["CMD-SHELL", "http_proxy= https_proxy= wget -qO /dev/null http://127.0.0.1/ || exit 1"] test: ["CMD-SHELL", "HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1/ || exit 1"]
interval: 10s interval: 10s
timeout: 3s timeout: 3s
start_period: 10s start_period: 10s
+1 -1
View File
@@ -32,7 +32,7 @@ services:
restart: unless-stopped restart: unless-stopped
# См. комментарий у app: дубль HEALTHCHECK из wordpdf-web/Containerfile # См. комментарий у app: дубль HEALTHCHECK из wordpdf-web/Containerfile
healthcheck: healthcheck:
test: ["CMD-SHELL", "http_proxy= https_proxy= wget -qO /dev/null http://127.0.0.1/ || exit 1"] test: ["CMD-SHELL", "HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1/ || exit 1"]
interval: 10s interval: 10s
timeout: 3s timeout: 3s
start_period: 10s start_period: 10s
File diff suppressed because one or more lines are too long
+48
View File
@@ -0,0 +1,48 @@
# Нормативная документация OOXML
Источник истины для chart-движка (`wordpdf-core/.../internal/chart/`) и нормализаторов: любые правки диаграмм/SmartArt/представления docx — по документам ниже, а не по догадкам. Правило закреплено в `AGENTS.md` (секция «Chart-движок»).
## Источники
|Файл|Документ|Редакция/дата|URL|SHA-256|
|---|---|---|---|---|
|`ECMA-376-1_5th_edition_december_2016.pdf`|ECMA-376 Part 1 «Fundamentals and Markup Language Reference»|5-е изд., декабрь 2016|https://ecma-international.org/wp-content/uploads/ECMA-376-1_5th_edition_december_2016.pdf|`7cccfd0ad0e2ef89316acece15e44a8a088d0603ce4bba4e7b0361b50d13a37d`|
|`ecma376-part1-5th.md`|Тот же текст, извлечённый из PDF (поиск по номерам секций)|5-е изд.|производный (см. регенерацию)|`86af445c080d9a481eaa426fc1721d50a1c4eff875535f9d03fe93d2b95b21b6`|
|`ms-oi29500.md`|[MS-OI29500] «Office Implementation Information for ISO/IEC-29500 Standards» — как Word реально пишет docx (§2.1 — комментарий к Part 1, §3.1 — к Part 4)|260818 (август 2026)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-OI29500/%5bMS-OI29500%5d-260818.docx|`3e3eabb060a3772d096f001e7fee682fc4be12a2dd55ea360430fff14dd5845d`|
|`ms-odrawxml.md`|[MS-ODRAWXML] «Office Drawing Extensions to Office Open XML» — расширения Word/Excel для чартов (ChartEx, стили/цвета)|261006 (октябрь 2026)|https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-ODRAWXML/%5bMS-ODRAWXML%5d-261006.docx|`f5a2517c4984b2ba2f0ade504bd0c9660c74f619290910a9b491c0f2ca9db64a`|
|`schema/dml-chart.xsd`|XSD DrawingML Charts (`c:`-пространство имён)|5-е изд.|вложенный `OfficeOpenXML-XMLSchema-Strict.zip` в ECMA-архиве выше|`189b9631129a7d6c9f971b42b94c8942d260f11f81615f427db059bbf442cdc3`|
|`schema/dml-diagram.xsd`|XSD DrawingML Diagrams (`dgm:`)|5-е изд.|там же|`179cd2fa4b981e1e2faa9ce99bb18c5d4d896dc1edb144af50f5cc8c52eb8569`|
|`schema/dml-main.xsd`|XSD DrawingML Main (`a:`, пресет-геометрия — типы)|5-е изд.|там же|`078871240cff323ddd22a395281421b737fa61508fd39ffaa2947ba2bc01175e`|
SHA-256 `.md`-файлов — справочные: они производные от инструментов извлечения (poppler/pandoc), при регенерации другим инструментом могут измениться; первичен PDF/docx выше.
## Что где искать
- **Диаграммы (`c:chart`)** — ECMA-376 §21.2 (`grep -n "^21.2" ecma376-part1-5th.md`; каждый элемент — секция вида `21.2.2.132 overlay (Overlay)`) + `schema/dml-chart.xsd`; расширения Word — `ms-odrawxml.md`.
- **Диаграммы-схемы SmartArt (`dgm:`)** — ECMA-376 §21.4 + `schema/dml-diagram.xsd`. Кэш разложенной схемы (`word/diagrams/drawing1.xml`, relationship `…/office/2007/relationships/diagramDrawing`) — проприетарный MS-формат, нормативного XSD нет; authoritative источник фактической геометрии — сам `dsp:drawing`.
- **Пресет-геометрия (`a:prstGeom`)** — ECMA-376 Annex D; машинная копия таблицы пресетов — `wordpdf-core/src/test/resources/geom/presetShapeDefinitions.xml` (синхрон пинит `PresetGeometryTest#tableMatchesEcmaXml`).
- **Chart Drawings (`c:drawing`)** — ECMA-376 §21.3.
- **Поведение Word (что он реально пишет в `w:r`/`w:t`/`lastRenderedPageBreak`, текстбоксы, чарты)** — `ms-oi29500.md` (указатели на секции Part 1, напр. §2.17.3.3.13 → Part 1 §17.3.3.13).
## Регенерация
```bash
# ecma376-part1-5th.md — из PDF в репозитории (постобработка: выбросить строки
# `^\s*\d{1,4}\s*$` (номера страниц), `^ECMA-376 Part 1\s*$` (колонтитул),
# строки с `.....` (точки оглавления); остальной текст — как есть)
pdftotext -layout docs/standards/ECMA-376-1_5th_edition_december_2016.pdf /tmp/p1.txt
# ms-oi29500.md / ms-odrawxml.md — свежие dated-.docx с learn.microsoft.com
# (при 404 — самый свежий .docx со страниц лендингов:
# https://learn.microsoft.com/en-us/openspecs/office_standards/ms-oi29500/1fd4a662-8623-49c0-82f0-18fa91b413b8
# https://learn.microsoft.com/en-us/openspecs/office_standards/ms-odrawxml/06cff208-c6e1-4db7-bb68-665135e5f0de)
curl -sSL -o /tmp/oi29500.docx "https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-OI29500/%5bMS-OI29500%5d-260818.docx"
curl -sSL -o /tmp/odrawxml.docx "https://officeprotocoldocs-f5hpbjgea6b8gneq.b02.azurefd.net/files/MS-ODRAWXML/%5bMS-ODRAWXML%5d-261006.docx"
pandoc /tmp/oi29500.docx -t gfm-raw_html --wrap=none -o docs/standards/ms-oi29500.md
pandoc /tmp/odrawxml.docx -t gfm-raw_html --wrap=none -o docs/standards/ms-odrawxml.md
# schema/*.xsd — из официального ECMA-архива
curl -sSL -o /tmp/p1.zip "https://ecma-international.org/wp-content/uploads/ECMA-376-1_5th_edition_december_2016.zip"
unzip -o /tmp/p1.zip "OfficeOpenXML-XMLSchema-Strict.zip" -d /tmp/
unzip -o /tmp/OfficeOpenXML-XMLSchema-Strict.zip dml-chart.xsd dml-diagram.xsd dml-main.xsd -d docs/standards/schema/
```
File diff suppressed because it is too large Load Diff
File diff suppressed because it is too large Load Diff
File diff suppressed because one or more lines are too long
File diff suppressed because it is too large Load Diff
File diff suppressed because it is too large Load Diff
File diff suppressed because it is too large Load Diff
@@ -2,6 +2,7 @@ package ru.pjandro.wordpdf.app;
import org.slf4j.Logger; import org.slf4j.Logger;
import org.slf4j.LoggerFactory; import org.slf4j.LoggerFactory;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.http.HttpStatus; import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity; import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.MissingServletRequestParameterException; import org.springframework.web.bind.MissingServletRequestParameterException;
@@ -9,6 +10,7 @@ import org.springframework.web.bind.annotation.ExceptionHandler;
import org.springframework.web.bind.annotation.RestControllerAdvice; import org.springframework.web.bind.annotation.RestControllerAdvice;
import org.springframework.web.multipart.MaxUploadSizeExceededException; import org.springframework.web.multipart.MaxUploadSizeExceededException;
import org.springframework.web.multipart.support.MissingServletRequestPartException; import org.springframework.web.multipart.support.MissingServletRequestPartException;
import org.springframework.web.method.annotation.MethodArgumentTypeMismatchException;
import org.springframework.web.servlet.resource.NoResourceFoundException; import org.springframework.web.servlet.resource.NoResourceFoundException;
import ru.pjandro.wordpdf.ValidationException; import ru.pjandro.wordpdf.ValidationException;
@@ -26,6 +28,13 @@ final class ApiExceptionHandler {
private static final Logger LOG = LoggerFactory.getLogger(ApiExceptionHandler.class); private static final Logger LOG = LoggerFactory.getLogger(ApiExceptionHandler.class);
/** Значение {@code spring.servlet.multipart.max-file-size} — для текста 413. */
private final String maxFileSize;
ApiExceptionHandler(@Value("${spring.servlet.multipart.max-file-size:100MB}") String maxFileSize) {
this.maxFileSize = maxFileSize;
}
/** Тело ответа ошибки; Jackson сериализует record как есть. */ /** Тело ответа ошибки; Jackson сериализует record как есть. */
record ApiError(String error) { record ApiError(String error) {
} }
@@ -65,15 +74,16 @@ final class ApiExceptionHandler {
} }
/** /**
* Контейнерный потолок multipart (100 МБ в application.properties) * Контейнерный потолок multipart ({@code spring.servlet.multipart.max-file-size})
* сработал раньше ядра: срабатывает только на инфраструктурный лимит, * сработал раньше ядра: срабатывает только на инфраструктурный лимит,
* авторитетный (свойство {@code wordpdf.max-mb}/env {@code WORDPDF_MAX_MB}) * авторитетный (свойство {@code wordpdf.max-mb}/env {@code WORDPDF_MAX_MB})
* проверяет {@code WordPdfValidator} и отвечает 400 своим текстом. * проверяет {@code WordPdfValidator} и отвечает 400 своим текстом.
* Текст берётся из свойства — не расходится с реальной конфигурацией сервера.
*/ */
@ExceptionHandler(MaxUploadSizeExceededException.class) @ExceptionHandler(MaxUploadSizeExceededException.class)
ResponseEntity<ApiError> tooLarge(MaxUploadSizeExceededException e) { ResponseEntity<ApiError> tooLarge(MaxUploadSizeExceededException e) {
return ResponseEntity.status(HttpStatus.PAYLOAD_TOO_LARGE) return ResponseEntity.status(HttpStatus.PAYLOAD_TOO_LARGE)
.body(new ApiError("Файл больше 100 МБ")); .body(new ApiError("Файл больше " + maxFileSize + " — лимит multipart сервера"));
} }
/** Партита {@code file} нет в запросе — обе формы исключения возможны. */ /** Партита {@code file} нет в запросе — обе формы исключения возможны. */
@@ -96,6 +106,13 @@ final class ApiExceptionHandler {
.body(new ApiError("Не найдено")); .body(new ApiError("Не найдено"));
} }
/** Битое значение факультативного параметра (errorOnCharts=tru3) — ошибка клиента. */
@ExceptionHandler(MethodArgumentTypeMismatchException.class)
ResponseEntity<ApiError> badParam(MethodArgumentTypeMismatchException e) {
return ResponseEntity.badRequest()
.body(new ApiError("Некорректное значение параметра «" + e.getName() + "»"));
}
/** Прочее — внутренняя ошибка; подробность только в лог, не в ответ. */ /** Прочее — внутренняя ошибка; подробность только в лог, не в ответ. */
@ExceptionHandler(Exception.class) @ExceptionHandler(Exception.class)
ResponseEntity<ApiError> unexpected(Exception e) { ResponseEntity<ApiError> unexpected(Exception e) {
@@ -24,6 +24,11 @@ import java.security.MessageDigest;
* *
* <p>Регрессии — ApiKeyFilterTest#forwardedPrefix_healthStaysOpen, * <p>Регрессии — ApiKeyFilterTest#forwardedPrefix_healthStaysOpen,
* ApiKeyFilterTest#docsOpenWithoutKey.</p> * ApiKeyFilterTest#docsOpenWithoutKey.</p>
*
* <p>Путь с точечными сегментами ({@code ..}, {@code %2e}) не считается
* открытым: контейнер матчит по сырому URI, а нормализацию {@code /actuator/../api/…}
* может выполнить последующий обработчик — ключ спрашиваем всегда.
* Регрессия — ApiKeyFilterTest#dotSegmentOpenPrefix_rejected.</p>
*/ */
@Component @Component
final class ApiKeyFilter extends OncePerRequestFilter { final class ApiKeyFilter extends OncePerRequestFilter {
@@ -33,6 +38,10 @@ final class ApiKeyFilter extends OncePerRequestFilter {
/** Открытые пути без ключа: actuator (HEALTHCHECK контейнера) и springdoc-документация. */ /** Открытые пути без ключа: actuator (HEALTHCHECK контейнера) и springdoc-документация. */
private static final String[] OPEN_PREFIXES = {"/actuator/", "/swagger-ui", "/v3/api-docs"}; private static final String[] OPEN_PREFIXES = {"/actuator/", "/swagger-ui", "/v3/api-docs"};
/** Точечные сегменты в сыром URI — не «открытый» путь (см. javadoc класса). */
private static final String DOT_SEGMENT = "..";
private static final String ENCODED_DOT = "%2e";
/** null — аутентификация выключена. */ /** null — аутентификация выключена. */
private final byte[] expected; private final byte[] expected;
@@ -73,6 +82,10 @@ final class ApiKeyFilter extends OncePerRequestFilter {
} }
private static boolean isOpen(String path) { private static boolean isOpen(String path) {
if (path.contains(DOT_SEGMENT)
|| path.toLowerCase(java.util.Locale.ROOT).contains(ENCODED_DOT)) {
return false;
}
for (String prefix : OPEN_PREFIXES) { for (String prefix : OPEN_PREFIXES) {
if (path.startsWith(prefix)) { if (path.startsWith(prefix)) {
return true; return true;
@@ -17,7 +17,7 @@ import static org.junit.jupiter.api.Assertions.assertFalse;
*/ */
class ApiExceptionHandlerTest { class ApiExceptionHandlerTest {
private final ApiExceptionHandler handler = new ApiExceptionHandler(); private final ApiExceptionHandler handler = new ApiExceptionHandler("100MB");
/** Занятая очередь — 503 с подсказкой «повторите», текст — контракт. */ /** Занятая очередь — 503 с подсказкой «повторите», текст — контракт. */
@Test @Test
@@ -42,7 +42,7 @@ class ApiExceptionHandlerTest {
void tooLarge_returns413ContainerLimit() { void tooLarge_returns413ContainerLimit() {
var response = handler.tooLarge(new MaxUploadSizeExceededException(100L * 1024 * 1024)); var response = handler.tooLarge(new MaxUploadSizeExceededException(100L * 1024 * 1024));
assertEquals(HttpStatus.PAYLOAD_TOO_LARGE, response.getStatusCode()); assertEquals(HttpStatus.PAYLOAD_TOO_LARGE, response.getStatusCode());
assertEquals("Файл больше 100 МБ", response.getBody().error()); assertEquals("Файл больше 100MB — лимит multipart сервера", response.getBody().error());
} }
/** Прочее исключение — 500 с общим текстом; подробность причины — только в лог. */ /** Прочее исключение — 500 с общим текстом; подробность причины — только в лог. */
@@ -113,4 +113,18 @@ class ApiKeyFilterTest {
mockMvc.perform(get("/v3/api-docs").header("X-Forwarded-Prefix", "/pdf-converter")) mockMvc.perform(get("/v3/api-docs").header("X-Forwarded-Prefix", "/pdf-converter"))
.andExpect(status().isOk()); .andExpect(status().isOk());
} }
/**
* {@code /actuator/../api/v1/convert}: фильтр матчает по сырому URI, но
* нормализацию может выполнить последующий обработчик — путь с точечными
* сегментами не «открытый», ключ спрашивается всегда.
* Регрессия — ApiKeyFilterTest#dotSegmentOpenPrefix_rejected.
*/
@Test
void dotSegmentOpenPrefix_rejected() throws Exception {
mockMvc.perform(get("/actuator/../api/v1/convert"))
.andExpect(status().isUnauthorized());
mockMvc.perform(get(java.net.URI.create("/actuator/%2e%2e/api/v1/convert")))
.andExpect(status().isUnauthorized());
}
} }
@@ -218,6 +218,21 @@ class ConvertControllerTest {
org.hamcrest.Matchers.containsString("OLE-объект"))); org.hamcrest.Matchers.containsString("OLE-объект")));
} }
/**
* errorOnCharts=tru3 — некорректное значение факультативного параметра:
* 400 с именем параметра (не 500 от catch-all).
* Регрессия — ConvertControllerTest#errorFlagNotBoolean_rejected.
*/
@Test
void errorFlagNotBoolean_rejected() throws Exception {
mockMvc.perform(multipart("/api/v1/convert")
.file(docx("ru-plain.docx", bytes("/samples/ru-plain.docx")))
.param("errorOnCharts", "tru3"))
.andExpect(status().isBadRequest())
.andExpect(jsonPath("$.error",
org.hamcrest.Matchers.containsString("errorOnCharts")));
}
/** /**
* Без параметров OLE-объекты тихо удаляются: 200, PDF. * Без параметров OLE-объекты тихо удаляются: 200, PDF.
* Регрессия — WordPdfConverterTest#oleObjects_removedAndConverted, * Регрессия — WordPdfConverterTest#oleObjects_removedAndConverted,
@@ -37,7 +37,9 @@ import java.io.OutputStream;
* подменяются метрически совместимыми open-source аналогами * подменяются метрически совместимыми open-source аналогами
* (см. {@link BundledFontMapper}). * (см. {@link BundledFontMapper}).
* *
* Класс stateless, все методы статические. * Класс stateless, все методы статические. Класс НЕ потокобезопасен:
* конвертации из нескольких потоков необходимо сериализовать (глобальный
* реестр {@code PhysicalFonts}, кэши шрифтов/покрытия).
*/ */
public final class WordPdfConverter { public final class WordPdfConverter {
@@ -146,6 +146,9 @@ public final class BundledFonts {
"Шрифт не найден в jar: " + CLASSPATH_DIR + "/" + entry.file()); "Шрифт не найден в jar: " + CLASSPATH_DIR + "/" + entry.file());
} }
Files.copy(in, target, StandardCopyOption.REPLACE_EXISTING); Files.copy(in, target, StandardCopyOption.REPLACE_EXISTING);
// deleteOnExit не рекурсивен: каталог удалится только пустым,
// поэтому регистрируем каждый выгруженный TTF.
target.toFile().deleteOnExit();
} catch (IOException e) { } catch (IOException e) {
throw new IllegalStateException("Не удалось выгрузить шрифт " + entry.file(), e); throw new IllegalStateException("Не удалось выгрузить шрифт " + entry.file(), e);
} }
@@ -46,7 +46,7 @@ public final class GlyphFont {
private final String key; private final String key;
private final TrueTypeFont ttf; private final TrueTypeFont ttf;
private CmapLookup cmap; private volatile CmapLookup cmap;
private GlyphFont(String key, TrueTypeFont ttf) { private GlyphFont(String key, TrueTypeFont ttf) {
this.key = key; this.key = key;
@@ -9,7 +9,6 @@ import java.io.ByteArrayOutputStream;
import java.io.IOException; import java.io.IOException;
import java.nio.charset.StandardCharsets; import java.nio.charset.StandardCharsets;
import java.util.ArrayList; import java.util.ArrayList;
import java.util.HashMap;
import java.util.List; import java.util.List;
import java.util.Map; import java.util.Map;
import java.util.regex.Matcher; import java.util.regex.Matcher;
@@ -17,6 +16,7 @@ import java.util.regex.Pattern;
import java.util.zip.ZipEntry; import java.util.zip.ZipEntry;
import java.util.zip.ZipInputStream; import java.util.zip.ZipInputStream;
import java.util.zip.ZipOutputStream; import java.util.zip.ZipOutputStream;
import java.util.concurrent.ConcurrentHashMap;
/** /**
* Разрезание ранов по покрытию глифов — до загрузки docx4j. * Разрезание ранов по покрытию глифов — до загрузки docx4j.
@@ -75,8 +75,8 @@ public final class GlyphCoverageNormalizer {
private static final Pattern NUMERIC_ENTITY = Pattern.compile( private static final Pattern NUMERIC_ENTITY = Pattern.compile(
"&#(x?)([0-9A-Fa-f]+);"); "&#(x?)([0-9A-Fa-f]+);");
/** Кэш покрытия: семейство -> множества проверенных/покрытых кодов. */ /** Кэш покрытия: семейство -> множества проверенных/покрытых кодов (общий между конвертациями). */
private static final Map<String, Coverage> COVERAGE = new HashMap<>(); private static final Map<String, Coverage> COVERAGE = new ConcurrentHashMap<>();
private GlyphCoverageNormalizer() { private GlyphCoverageNormalizer() {
} }
@@ -122,9 +122,11 @@ public final class GlyphCoverageNormalizer {
} }
/** /**
* Проходит невложенные блоки {@code <w:r>} ... {@code </w:r>} и заменяет * Проходит блоки {@code <w:r>} ... {@code </w:r>} и заменяет каждый через
* каждый через {@link #rewriteBlock}. Приём тот же, что в * {@link #rewriteBlock}. Вложенные раны текстбоксов (w:r → w:drawing →
* {@link SymbolFontNormalizer}: полные раны не вложены друг в друга. * txbxContent → w:r) переписываются рекурсивно по телу внешнего блока —
* каркас внешнего рана остаётся нетронутым. Приём общий с
* {@link SymbolFontNormalizer}.
*/ */
private static String rewriteBlocks(String xml, String tag) { private static String rewriteBlocks(String xml, String tag) {
String open = "<" + tag; String open = "<" + tag;
@@ -141,6 +143,15 @@ public final class GlyphCoverageNormalizer {
if (openEnd < 0 || end < 0) { if (openEnd < 0 || end < 0) {
break; break;
} }
int matching = matchingClose(xml, open, close, openEnd);
if (matching > end) {
// Внешний ран с вложенным: тело — рекурсивно, каркас внешнего не трогаем.
sb.append(xml, pos, start).append(xml, start, openEnd + 1)
.append(rewriteBlocks(xml.substring(openEnd + 1, matching), tag))
.append(close);
pos = matching + close.length();
continue;
}
end += close.length(); end += close.length();
sb.append(xml, pos, start).append(rewriteBlock(xml.substring(start, end))); sb.append(xml, pos, start).append(rewriteBlock(xml.substring(start, end)));
pos = end; pos = end;
@@ -169,6 +180,30 @@ public final class GlyphCoverageNormalizer {
return -1; return -1;
} }
/** Позиция закрывающего тега, балансирующего открывающий тег на openEnd; -1 — не сбалансирован. */
private static int matchingClose(String xml, String open, String close, int openEnd) {
int depth = 1;
int i = openEnd;
while (i < xml.length()) {
int nextOpen = indexOfOpenTag(xml, open, i);
int nextClose = xml.indexOf(close, i);
if (nextClose < 0) {
return -1;
}
if (nextOpen >= 0 && nextOpen < nextClose) {
depth++;
i = nextOpen + open.length();
} else {
depth--;
if (depth == 0) {
return nextClose;
}
i = nextClose + close.length();
}
}
return -1;
}
/** /**
* Разрезает один {@code w:r}: части текста без глифа в шрифте ранa * Разрезает один {@code w:r}: части текста без глифа в шрифте ранa
* получают собственное {@code w:rFonts}. * получают собственное {@code w:rFonts}.
@@ -200,6 +235,13 @@ public final class GlyphCoverageNormalizer {
// Составной ран (w:tab, w:drawing, несколько w:t) не трогаем. // Составной ран (w:tab, w:drawing, несколько w:t) не трогаем.
return block; return block;
} }
if (text.group(2).contains("</w:t>")) {
// matches() с ленивой (.*?) поглощает разметку между w:t (напр.
// lastRenderedPageBreak) — в сырой текст w:t литеральный </w:t> не
// попадает (XML-экранирование), значит это составной ран.
// Регрессия — GlyphCoverageNormalizerTest#multipleTextNodes_runLeftUntouched.
return block;
}
String decoded = decode(text.group(2)); String decoded = decode(text.group(2));
List<Segment> segments = split(decoded, runFamily); List<Segment> segments = split(decoded, runFamily);
if (segments.isEmpty()) { if (segments.isEmpty()) {
@@ -295,12 +337,8 @@ public final class GlyphCoverageNormalizer {
} }
private static Coverage coverage(String family) { private static Coverage coverage(String family) {
Coverage c = COVERAGE.get(family); return COVERAGE.computeIfAbsent(family,
if (c == null) { f -> new Coverage(GlyphFont.of(f, BundledFonts.V_REGULAR)));
c = new Coverage(GlyphFont.of(family, BundledFonts.V_REGULAR));
COVERAGE.put(family, c);
}
return c;
} }
/** /**
@@ -320,7 +358,9 @@ public final class GlyphCoverageNormalizer {
this.font = font; this.font = font;
} }
boolean covers(int cp) { // synchronized: BitSet не потокобезопасен (рост words[] и порядок
// checked/covered под гонкой дают ложное «не покрыт»).
synchronized boolean covers(int cp) {
if (font == null || cp < 0) { if (font == null || cp < 0) {
return false; return false;
} }
@@ -116,8 +116,11 @@ public final class SymbolFontNormalizer {
} }
/** /**
* Проходит невложенные блоки {@code <tag ...>} ... {@code </tag>} и * Проходит блоки {@code <tag ...>} ... {@code </tag>} и заменяет каждый через
* заменяет каждый через {@link #rewriteBlock}. * {@link #rewriteBlock}. Вложенные раны текстбоксов (w:r → w:drawing →
* txbxContent → w:r) переписываются рекурсивно по телу внешнего блока —
* каркас внешнего рана остаётся нетронутым (тот же приём, что в
* {@link GlyphCoverageNormalizer}).
*/ */
private static String rewriteBlocks(String xml, String tag) { private static String rewriteBlocks(String xml, String tag) {
String open = "<" + tag; String open = "<" + tag;
@@ -134,6 +137,15 @@ public final class SymbolFontNormalizer {
if (openEnd < 0 || end < 0) { if (openEnd < 0 || end < 0) {
break; break;
} }
int matching = matchingClose(xml, open, close, openEnd);
if (matching > end) {
// Внешний ран с вложенным: тело — рекурсивно, каркас внешнего не трогаем.
sb.append(xml, pos, start).append(xml, start, openEnd + 1)
.append(rewriteBlocks(xml.substring(openEnd + 1, matching), tag))
.append(close);
pos = matching + close.length();
continue;
}
end += close.length(); end += close.length();
String block = xml.substring(start, end); String block = xml.substring(start, end);
sb.append(xml, pos, start).append(rewriteBlock(block)); sb.append(xml, pos, start).append(rewriteBlock(block));
@@ -174,6 +186,30 @@ public final class SymbolFontNormalizer {
return -1; return -1;
} }
/** Позиция закрывающего тега, балансирующего открывающий тег на openEnd; -1 — не сбалансирован. */
private static int matchingClose(String xml, String open, String close, int openEnd) {
int depth = 1;
int i = openEnd;
while (i < xml.length()) {
int nextOpen = indexOfOpenTag(xml, open, i);
int nextClose = xml.indexOf(close, i);
if (nextClose < 0) {
return -1;
}
if (nextOpen >= 0 && nextOpen < nextClose) {
depth++;
i = nextOpen + open.length();
} else {
depth--;
if (depth == 0) {
return nextClose;
}
i = nextClose + close.length();
}
}
return -1;
}
/** Переписывает один блок {@code w:lvl} или {@code w:r}. */ /** Переписывает один блок {@code w:lvl} или {@code w:r}. */
private static String rewriteBlock(String block) { private static String rewriteBlock(String block) {
String symbolFont = symbolFontOf(block); String symbolFont = symbolFontOf(block);
@@ -284,10 +284,14 @@ final class CartesianPainter {
p.lineTo(toX(along.get(i), cross.get(i), horizontal), p.lineTo(toX(along.get(i), cross.get(i), horizontal),
toY(along.get(i), cross.get(i), horizontal)); toY(along.get(i), cross.get(i), horizontal));
} }
p.lineTo(toX(along.get(along.size() - 1), cross.get(cross.size() - 1), horizontal), // Word заполняет область между кривой и осью категорий (ECMA-376
toY(along.get(along.size() - 1), cross.get(cross.size() - 1), horizontal)); // §21.2.2.5 c:areaChart), а не хордой последняя→первая: замыкаем
p.lineTo(toX(along.get(0), cross.get(0), horizontal), // путь по базовой линии (значение lo).
toY(along.get(0), cross.get(0), horizontal)); // Регрессия — CartesianPainterTest#areaFill_closesToBaseline.
double base = valuePos(lo, lo, hi, plot, horizontal);
p.lineTo(toX(along.get(along.size() - 1), base, horizontal),
toY(along.get(along.size() - 1), base, horizontal));
p.lineTo(toX(along.get(0), base, horizontal), toY(along.get(0), base, horizontal));
p.closePath(); p.closePath();
g.setColor(DrawMlColor.withAlpha(c, 0.55)); g.setColor(DrawMlColor.withAlpha(c, 0.55));
g.fill(p); g.fill(p);
@@ -40,6 +40,16 @@ final class ChartRenderer {
/** Порог «значение целое» при форматировании подписей. */ /** Порог «значение целое» при форматировании подписей. */
private static final double INTEGER_EPSILON = 1e-9; private static final double INTEGER_EPSILON = 1e-9;
/**
* Верхняя граница числа делений: {@code c:majorUnit} (ECMA-376 §21.2.2.103) —
* double без нижней границы; Word пишет «круглые» значения, а враждебный docx —
* 0 или 1e-300, и циклы делений (CartesianPainter, SURFACE3D-легенда) становятся
* вечными/OOM. Непригодный шаг заменяется niceUnit — axisBounds единственный
* choke point, откуда циклы берут шаг.
* Регрессия — Surface3dPainterTest#axisBounds_tinyMajorUnit_fallsBackToNiceUnit.
*/
private static final double MAX_TICKS = 1000;
private ChartRenderer() { private ChartRenderer() {
} }
@@ -68,13 +78,16 @@ final class ChartRenderer {
box.getWidth(), box.getHeight() - titleH); box.getWidth(), box.getHeight() - titleH);
Legend legend = measureLegend(spec, palette); Legend legend = measureLegend(spec, palette);
double legendH = legend == null ? 0 : legend.height; // c:overlay (ECMA-376 §21.2.2.132): легенда не резервирует место и
if (legend != null && "b".equals(spec.legendPos)) { // дорисовывается поверх после художника. Регрессия — ChartRendererTest#overlayLegend_drawnOverPlot.
double legendH = legend == null || spec.legendOverlay ? 0 : legend.height;
Rectangle2D box0 = box;
if (legend != null && !spec.legendOverlay && "b".equals(spec.legendPos)) {
legend.draw(g, box.getX(), box.getY() + box.getHeight() - legendH, legend.draw(g, box.getX(), box.getY() + box.getHeight() - legendH,
box.getWidth()); box.getWidth());
box = new Rectangle2D.Double(box.getX(), box.getY(), box = new Rectangle2D.Double(box.getX(), box.getY(),
box.getWidth(), box.getHeight() - legendH); box.getWidth(), box.getHeight() - legendH);
} else if (legend != null && "t".equals(spec.legendPos)) { } else if (legend != null && !spec.legendOverlay && "t".equals(spec.legendPos)) {
legend.draw(g, box.getX(), box.getY(), box.getWidth()); legend.draw(g, box.getX(), box.getY(), box.getWidth());
box = new Rectangle2D.Double(box.getX(), box.getY() + legendH, box = new Rectangle2D.Double(box.getX(), box.getY() + legendH,
box.getWidth(), box.getHeight() - legendH); box.getWidth(), box.getHeight() - legendH);
@@ -82,13 +95,19 @@ final class ChartRenderer {
switch (spec.type) { switch (spec.type) {
case PIE, PIE3D, DOUGHNUT -> case PIE, PIE3D, DOUGHNUT ->
PiePainter.paint(g, spec, box, palette, legend); PiePainter.paint(g, spec, box, palette,
spec.legendOverlay ? null : legend);
case LINE, AREA, BAR, BAR_HORIZONTAL -> case LINE, AREA, BAR, BAR_HORIZONTAL ->
CartesianPainter.paint(g, spec, box, palette); CartesianPainter.paint(g, spec, box, palette);
case SURFACE3D -> case SURFACE3D ->
Surface3dPainter.paint(g, spec, box, palette); Surface3dPainter.paint(g, spec, box, palette);
default -> { /* UNSUPPORTED: вызывающий не должен сюда доходить */ } default -> { /* UNSUPPORTED: вызывающий не должен сюда доходить */ }
} }
if (legend != null && spec.legendOverlay) {
double y = "t".equals(spec.legendPos)
? box0.getY() : box0.getY() + box0.getHeight() - legend.height;
legend.draw(g, box0.getX(), y, box0.getWidth());
}
} finally { } finally {
g.dispose(); g.dispose();
} }
@@ -330,6 +349,7 @@ final class ChartRenderer {
static double[] axisBounds(ChartSpec.AxisSpec axis, double dataMin, double dataMax, static double[] axisBounds(ChartSpec.AxisSpec axis, double dataMin, double dataMax,
boolean padMax) { boolean padMax) {
double unit = axis != null && axis.majorUnit != null double unit = axis != null && axis.majorUnit != null
&& usableMajorUnit(axis.majorUnit, dataMax - dataMin)
? axis.majorUnit ? axis.majorUnit
: niceUnit((dataMax - dataMin) / 5.0); : niceUnit((dataMax - dataMin) / 5.0);
// Линейная ось значений без явного c:min всегда начинается с нуля // Линейная ось значений без явного c:min всегда начинается с нуля
@@ -350,6 +370,11 @@ final class ChartRenderer {
return new double[]{lo, hi, unit}; return new double[]{lo, hi, unit};
} }
/** Шаг делений пригоден, если положителен, конечен и даёт не более {@link #MAX_TICKS} делений. */
private static boolean usableMajorUnit(double unit, double span) {
return unit > 0 && Double.isFinite(unit) && span / unit <= MAX_TICKS;
}
/** Формат числа для подписей оси ("General" -> без лишних нулей). */ /** Формат числа для подписей оси ("General" -> без лишних нулей). */
static String formatValue(double v, String fmt) { static String formatValue(double v, String fmt) {
if (fmt != null && !"General".equalsIgnoreCase(fmt)) { if (fmt != null && !"General".equalsIgnoreCase(fmt)) {
@@ -58,6 +58,16 @@ final class ChartSpec {
* строку своего UI-языка — у нас русская). */ * строку своего UI-языка — у нас русская). */
static final String AUTO_TITLE = "Название диаграммы"; static final String AUTO_TITLE = "Название диаграммы";
/**
* Верхняя граница индекса точки ({@code c:pt/@idx}, ECMA-376 §21.2.2.150/.151) и
* счётчика ({@code c:ptCount}, §21.2.2.152): оба — ST_UnsignedInt без верхней
* границы, а предвыделение списка под idx/ptCount из враждебного chart-XML —
* удалённый OOM в обход деградации (бросок ДО любой аллокации, перехватывает
* catch в DrawingPreRenderer.renderChart → объект удалён + warn).
* Регрессия — ChartSpecTest#hugePointIndex_rejectedNotOom.
*/
static final int MAX_POINTS = 100_000;
enum Type { enum Type {
PIE, PIE3D, DOUGHNUT, BAR, BAR_HORIZONTAL, LINE, AREA, SURFACE3D, UNSUPPORTED PIE, PIE3D, DOUGHNUT, BAR, BAR_HORIZONTAL, LINE, AREA, SURFACE3D, UNSUPPORTED
} }
@@ -107,6 +117,8 @@ final class ChartSpec {
DrawMlText.Style titleStyle; DrawMlText.Style titleStyle;
DrawMlText.Style legendStyle; DrawMlText.Style legendStyle;
String legendPos = "b"; String legendPos = "b";
/** c:overlay (ECMA-376 §21.2.2.132): легенда рисуется поверх, место не резервируется. */
boolean legendOverlay;
final List<Series> series = new ArrayList<>(); final List<Series> series = new ArrayList<>();
final List<String> categories = new ArrayList<>(); final List<String> categories = new ArrayList<>();
AxisSpec valAxis; AxisSpec valAxis;
@@ -353,15 +365,19 @@ final class ChartSpec {
if (val != null) { if (val != null) {
var num = val.getNumRef() != null ? val.getNumRef().getNumCache() : val.getNumLit(); var num = val.getNumRef() != null ? val.getNumRef().getNumCache() : val.getNumLit();
if (num != null) { if (num != null) {
int count = num.getPtCount() != null ? (int) num.getPtCount().getVal() : -1; long count = num.getPtCount() != null ? num.getPtCount().getVal() : -1;
if (count > MAX_POINTS) {
throw new IllegalArgumentException("c:pt idx/ptCount превышает лимит " + MAX_POINTS);
}
for (CTNumVal v : num.getPt()) { for (CTNumVal v : num.getPt()) {
checkPointIndex(v.getIdx());
while (ser.values.size() < (int) v.getIdx()) { while (ser.values.size() < (int) v.getIdx()) {
ser.values.add(null); ser.values.add(null);
} }
ser.values.add(parseDouble(v.getV())); ser.values.add(parseDouble(v.getV()));
} }
if (count > ser.values.size()) { if (count > ser.values.size()) {
while (ser.values.size() < count) { while (ser.values.size() < (int) count) {
ser.values.add(null); ser.values.add(null);
} }
} }
@@ -405,10 +421,10 @@ final class ChartSpec {
return; return;
} }
var legend = chart.getLegend(); var legend = chart.getLegend();
if (isTrue(legend.getOverlay())) { // c:overlay (§21.2.2.132) — «other chart elements shall be allowed to
// легенда поверх области построения — не резервируем место // overlap this chart element»: легенда остаётся и сохраняет позицию,
spec.legendPos = null; // просто не резервирует место. Регрессия — ChartSpecTest#overlayLegend_keepsPositionAndFlag.
} spec.legendOverlay = isTrue(legend.getOverlay());
if (legend.getLegendPos() != null && legend.getLegendPos().getVal() != null) { if (legend.getLegendPos() != null && legend.getLegendPos().getVal() != null) {
spec.legendPos = legend.getLegendPos().getVal().value(); spec.legendPos = legend.getLegendPos().getVal().value();
} }
@@ -571,6 +587,7 @@ final class ChartSpec {
var str = cat.getStrRef() != null ? cat.getStrRef().getStrCache() : cat.getStrLit(); var str = cat.getStrRef() != null ? cat.getStrRef().getStrCache() : cat.getStrLit();
if (str != null) { if (str != null) {
for (CTStrVal v : str.getPt()) { for (CTStrVal v : str.getPt()) {
checkPointIndex(v.getIdx());
while (out.size() < v.getIdx()) { while (out.size() < v.getIdx()) {
out.add(""); out.add("");
} }
@@ -581,6 +598,7 @@ final class ChartSpec {
var num = cat.getNumRef() != null ? cat.getNumRef().getNumCache() : cat.getNumLit(); var num = cat.getNumRef() != null ? cat.getNumRef().getNumCache() : cat.getNumLit();
if (num != null) { if (num != null) {
for (CTNumVal v : num.getPt()) { for (CTNumVal v : num.getPt()) {
checkPointIndex(v.getIdx());
while (out.size() < v.getIdx()) { while (out.size() < v.getIdx()) {
out.add(""); out.add("");
} }
@@ -590,6 +608,13 @@ final class ChartSpec {
return out; return out;
} }
/** Индекс точки вне лимита — отказ до аллокации (см. {@link #MAX_POINTS}). */
private static void checkPointIndex(long idx) {
if (idx > MAX_POINTS) {
throw new IllegalArgumentException("c:pt idx/ptCount превышает лимит " + MAX_POINTS);
}
}
private static Double parseDouble(String s) { private static Double parseDouble(String s) {
if (s == null || s.isBlank()) { if (s == null || s.isBlank()) {
return null; return null;
@@ -96,6 +96,40 @@ class GlyphCoverageNormalizerTest {
assertNull(GlyphCoverageNormalizer.rewrite(xml)); assertNull(GlyphCoverageNormalizer.rewrite(xml));
} }
/**
* Ленивая (.*?) в matches() поглощала разметку между двумя w:t: ран с
* lastRenderedPageBreak между текстами не должен переписываться.
* Регрессия — GlyphCoverageNormalizerTest#multipleTextNodes_runLeftUntouched.
*/
@Test
void multipleTextNodes_runLeftUntouched() {
String xml = run(timesRPr(),
"<w:t>foo</w:t><w:lastRenderedPageBreak/><w:t>bar" + ROMAN + "</w:t>");
assertNull(GlyphCoverageNormalizer.rewrite(xml));
}
/** Ран внутри текстбокса (вложенный w:r) разрезается, каркас внешнего цел. */
@Test
void nestedRunInTextBox_innerSplit() {
String inner = "<w:r>" + timesRPr() + "<w:t>ы" + ROMAN + "ы</w:t></w:r>";
String xml = NS + "<w:r><w:rPr><w:rFonts w:ascii=\"Calibri\"/></w:rPr>"
+ "<w:drawing><wp:inline><wp:txbx><w:txbxContent><w:p>"
+ inner
+ "</w:p></w:txbxContent></wp:txbx></wp:inline></w:drawing></w:r>"
+ "</w:body></w:document>";
String out = GlyphCoverageNormalizer.rewrite(xml);
assertNotNull(out, "вложенный ран не разрезан");
assertTrue(out.contains("DejaVu Serif"), "нет подстановки во вложенном ране: " + out);
assertTrue(out.contains("<w:r><w:rPr><w:rFonts w:ascii=\"Calibri\"/></w:rPr><w:drawing>"),
"каркас внешнего рана повреждён: " + out);
assertTrue(out.endsWith("</w:p></w:txbxContent></wp:txbx></wp:inline></w:drawing></w:r>"
+ "</w:body></w:document>"), "хвост внешнего рана потерян: " + out);
}
/** Знака нет ни в одном бандл-шрифте: решётку не прячем за случайный шрифт. */ /** Знака нет ни в одном бандл-шрифте: решётку не прячем за случайный шрифт. */
@Test @Test
void glyphMissingEverywhereUntouched() { void glyphMissingEverywhereUntouched() {
@@ -156,4 +156,27 @@ class SymbolFontNormalizerTest {
assertNull(SymbolFontNormalizer.rewrite( assertNull(SymbolFontNormalizer.rewrite(
"<w:r><w:rPr><w:rFonts w:ascii=\"Arial\"/></w:rPr><w:t>\uF0A7</w:t></w:r>")); "<w:r><w:rPr><w:rFonts w:ascii=\"Arial\"/></w:rPr><w:t>\uF0A7</w:t></w:r>"));
} }
/**
* Ран внутри текстбокса (вложенный w:r): внутренний ран с Wingdings
* переписывается, каркас внешнего остаётся целым.
* Регрессия — SymbolFontNormalizerTest#nestedRunInTextBox_innerNormalized.
*/
@Test
void nestedRunInTextBox_innerNormalized() {
String xml = "<w:document><w:r><w:rPr><w:rFonts w:ascii=\"Calibri\"/></w:rPr>"
+ "<w:drawing><wp:inline><wp:txbx><w:txbxContent><w:p>"
+ "<w:r><w:rPr><w:rFonts w:ascii=\"Wingdings\"/></w:rPr><w:t>\uF0A7 хвостик</w:t></w:r>"
+ "</w:p></w:txbxContent></wp:txbx></wp:inline></w:drawing></w:r></w:document>";
String out = SymbolFontNormalizer.rewrite(xml);
assertNotNull(out, "внутренний ран не переписан");
assertTrue(out.contains("<w:t>▪ хвостик</w:t>"), "PUA не стал Unicode: " + out);
assertFalse(out.contains("Wingdings"), "имя шрифта не заменено: " + out);
assertTrue(out.contains("w:ascii=\"" + SymbolFontNormalizer.REPLACEMENT_FAMILY + "\""),
"нет fallback-семейства: " + out);
assertTrue(out.contains("<w:r><w:rPr><w:rFonts w:ascii=\"Calibri\"/></w:rPr><w:drawing>"),
"каркас внешнего рана повреждён: " + out);
}
} }
@@ -50,6 +50,66 @@ class CartesianPainterTest {
runs.get(0)[1] - runs.get(0)[0] + 1, 0.75 * slot); runs.get(0)[1] - runs.get(0)[0] + 1, 0.75 * slot);
} }
/**
* AREA замыкается по базовой линии оси значений (Word заполняет область
* между кривой и осью категорий, ECMA-376 §21.2.2.5), а не хордой
* последняя→первая: у базовой линии посередине между категориями 2 и 3
* заливка обязана быть.
* Регрессия — CartesianPainterTest#areaFill_closesToBaseline.
*/
@Test
void areaFill_closesToBaseline() {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.AREA;
spec.legendPos = null;
DrawMlText.Style style = new DrawMlText.Style(9, false, false,
new Color(0x59, 0x59, 0x59), "carlito");
spec.catAxis = new ChartSpec.AxisSpec();
spec.catAxis.labelStyle = style;
spec.valAxis = new ChartSpec.AxisSpec();
spec.valAxis.labelStyle = style;
ChartSpec.Series s = new ChartSpec.Series();
s.values.add(0.0);
s.values.add(100.0);
s.values.add(50.0);
spec.series.add(s);
BufferedImage img = ChartRenderer.render(spec, 219.23, 149.08, new DrawMlColor(null));
int lowest = -1;
int xLeft = -1;
int xRight = -1;
for (int y = img.getHeight() - 1; y >= 0 && lowest < 0; y--) {
for (int x = 0; x < img.getWidth(); x++) {
if (saturated(img.getRGB(x, y))) {
lowest = y;
break;
}
}
}
for (int x = 0; x < img.getWidth(); x++) {
boolean any = false;
for (int y = 0; y < img.getHeight(); y++) {
if (saturated(img.getRGB(x, y))) {
any = true;
break;
}
}
if (any) {
if (xLeft < 0) {
xLeft = x;
}
xRight = x;
}
}
assertTrue(xLeft >= 0 && xRight > xLeft, "заливки области не найдено");
assertTrue(lowest > 0, "нижнего края заливки не найдено");
int xMid = (xLeft + xRight) / 2;
assertTrue(saturated(img.getRGB(xMid, lowest - 6)),
"на середине между категориями 2 и 3 у базовой линии пусто: "
+ "путь замкнут хордой последняя→первая, а не по оси");
}
private static ChartSpec barSpec(double gapWidth, double overlap, int nSer) { private static ChartSpec barSpec(double gapWidth, double overlap, int nSer) {
ChartSpec spec = new ChartSpec(); ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.BAR; spec.type = ChartSpec.Type.BAR;
@@ -0,0 +1,102 @@
package ru.pjandro.wordpdf.internal.chart;
import org.junit.jupiter.api.Test;
import java.awt.Color;
import java.awt.image.BufferedImage;
import static org.junit.jupiter.api.Assertions.*;
/**
* Компоновка chartSpace в {@link ChartRenderer}: легенда c c:overlay
* (ECMA-376 §21.2.2.132) остаётся видимой и не резервирует место —
* область построения выше, чем без overlay.
*/
class ChartRendererTest {
/**
* Одна и та же LINE-спека с legendOverlay=false/true: легенда видима
* в обеих (нижняя полоса), но у overlay кривая опускается ниже —
* место под легенду не вырезано из области построения.
* Регрессия — ChartRendererTest#overlayLegend_drawnOverPlot.
*/
@Test
void overlayLegend_drawnOverPlot() {
BufferedImage plain = ChartRenderer.render(lineSpec(false), 219.23, 149.08,
new DrawMlColor(null));
BufferedImage overlay = ChartRenderer.render(lineSpec(true), 219.23, 149.08,
new DrawMlColor(null));
assertTrue(hasSaturated(plain, plain.getWidth() / 2,
(int) (plain.getHeight() * 0.90), plain.getHeight()),
"легенда пропала без overlay");
assertTrue(hasSaturated(overlay, overlay.getWidth() / 2,
(int) (overlay.getHeight() * 0.90), overlay.getHeight()),
"overlay-легенда не нарисована");
int yPlain = lowestSaturated(plain, rightEdge(plain) - 5);
int yOverlay = lowestSaturated(overlay, rightEdge(overlay) - 5);
assertTrue(yOverlay > yPlain + 5,
"overlay не отдаёт область построения обратно: yPlain=" + yPlain
+ ", yOverlay=" + yOverlay);
}
private static ChartSpec lineSpec(boolean overlay) {
ChartSpec spec = new ChartSpec();
spec.type = ChartSpec.Type.LINE;
spec.legendPos = "b";
spec.legendOverlay = overlay;
DrawMlText.Style style = new DrawMlText.Style(9, false, false,
new Color(0x59, 0x59, 0x59), "carlito");
spec.catAxis = new ChartSpec.AxisSpec();
spec.catAxis.labelStyle = style;
spec.valAxis = new ChartSpec.AxisSpec();
spec.valAxis.labelStyle = style;
ChartSpec.Series s = new ChartSpec.Series();
s.name = "R";
s.values.add(50.0);
s.values.add(100.0);
s.values.add(0.0);
spec.series.add(s);
return spec;
}
/** Правый насыщенный столбец (конец кривой). */
private static int rightEdge(BufferedImage img) {
for (int x = img.getWidth() - 1; x >= 0; x--) {
for (int y = 0; y < img.getHeight(); y++) {
if (saturated(img.getRGB(x, y))) {
return x;
}
}
}
return -1;
}
/** Есть ли насыщенный (цвет ряда) пиксель в столбце x между строками y0..y1. */
private static boolean hasSaturated(BufferedImage img, int x, int y0, int y1) {
for (int y = y0; y < y1; y++) {
if (saturated(img.getRGB(x, y))) {
return true;
}
}
return false;
}
/** Нижняя насыщенная строка в столбце x; -1 — нет таких. */
private static int lowestSaturated(BufferedImage img, int x) {
for (int y = img.getHeight() - 1; y >= 0; y--) {
if (saturated(img.getRGB(x, y))) {
return y;
}
}
return -1;
}
private static boolean saturated(int rgb) {
int r = (rgb >> 16) & 0xFF;
int g = (rgb >> 8) & 0xFF;
int b = rgb & 0xFF;
return Math.max(Math.max(r, g), b) - Math.min(Math.min(r, g), b) > 25;
}
}
@@ -456,17 +456,9 @@ class ChartSpecTest {
assertEquals(1, spec.series.get(0).pointFills.size()); assertEquals(1, spec.series.get(0).pointFills.size());
} }
/** overlay не затирает позицию: явный c:legendPos сохраняет силу (ECMA-376 §21.2.2.132). */
@Test @Test
void legendOverlayClearsPosExplicitPosWins() { void legendOverlayKeepsExplicitPos() {
CTChart chart = new CTChart();
CTLegend legend = new CTLegend();
CTBoolean overlay = new CTBoolean();
overlay.setVal(Boolean.TRUE);
legend.setOverlay(overlay);
chart.setLegend(legend);
ChartSpec spec = ChartSpec.parse(spaceWith(chart), new DrawMlColor(null));
assertNull(spec.legendPos, "overlay-легенда не резервирует место");
CTChart chart2 = new CTChart(); CTChart chart2 = new CTChart();
CTLegend legend2 = new CTLegend(); CTLegend legend2 = new CTLegend();
CTBoolean overlay2 = new CTBoolean(); CTBoolean overlay2 = new CTBoolean();
@@ -478,6 +470,7 @@ class ChartSpecTest {
chart2.setLegend(legend2); chart2.setLegend(legend2);
ChartSpec spec2 = ChartSpec.parse(spaceWith(chart2), new DrawMlColor(null)); ChartSpec spec2 = ChartSpec.parse(spaceWith(chart2), new DrawMlColor(null));
assertEquals("t", spec2.legendPos); assertEquals("t", spec2.legendPos);
assertTrue(spec2.legendOverlay);
} }
@Test @Test
@@ -603,6 +596,89 @@ class ChartSpecTest {
assertEquals(List.of("Я", "Ф", "М"), spec.categories); assertEquals(List.of("Я", "Ф", "М"), spec.categories);
} }
/**
* c:pt/@idx = 2·10⁹ (ECMA-376 §21.2.2.150 — ST_UnsignedInt без верхней границы):
* отказ до предвыделения списка, OOM не наступает.
* Регрессия — ChartSpecTest#hugePointIndex_rejectedNotOom.
*/
@Test
void hugePointIndex_rejectedNotOom() {
CTNumData cache = new CTNumData();
cache.getPt().add(numPt(2_000_000_000L, "5"));
CTChart chart = barChartWithVal(numSource(cache));
assertThrows(IllegalArgumentException.class,
() -> ChartSpec.parse(spaceWith(chart), new DrawMlColor(null)));
}
/** c:ptCount = 1.5·10⁹ (§21.2.2.152) — тот же отказ. */
@Test
void hugePtCount_rejectedNotOom() {
CTNumData cache = new CTNumData();
cache.setPtCount(uint(1_500_000_000L));
cache.getPt().add(numPt(0, "5"));
CTChart chart = barChartWithVal(numSource(cache));
assertThrows(IllegalArgumentException.class,
() -> ChartSpec.parse(spaceWith(chart), new DrawMlColor(null)));
}
/** c:pt/@idx = 4·10⁹ в категориях (§21.2.2.151) — отказ и в str-ветке. */
@Test
void hugeCategoryIndex_rejectedNotOom() {
CTAxDataSource cat = new CTAxDataSource();
CTStrRef ref = new CTStrRef();
CTStrData cache = new CTStrData();
CTStrVal pt = new CTStrVal();
pt.setIdx(4_000_000_000L);
pt.setV("X");
cache.getPt().add(pt);
ref.setStrCache(cache);
cat.setStrRef(ref);
CTChart chart = new CTChart();
CTPlotArea pa = new CTPlotArea();
CTBarChart bar = new CTBarChart();
CTBarSer ser = new CTBarSer();
ser.setCat(cat);
bar.getSer().add(ser);
pa.getAreaChartOrArea3DChartOrLineChart().add(bar);
chart.setPlotArea(pa);
assertThrows(IllegalArgumentException.class,
() -> ChartSpec.parse(spaceWith(chart), new DrawMlColor(null)));
}
/** c:overlay=1 без c:legendPos: флаг взведён, позиция осталась дефолтной «b». */
@Test
void overlayLegend_keepsPositionAndFlag() {
CTChart chart = new CTChart();
CTLegend legend = new CTLegend();
CTBoolean overlay = new CTBoolean();
overlay.setVal(true);
legend.setOverlay(overlay);
chart.setLegend(legend);
ChartSpec spec = ChartSpec.parse(spaceWith(chart), new DrawMlColor(null));
assertTrue(spec.legendOverlay, "оверлей не запомнен");
assertEquals("b", spec.legendPos, "позиция легенды затёрта");
}
private static CTChart barChartWithVal(CTNumDataSource val) {
CTChart chart = new CTChart();
CTPlotArea pa = new CTPlotArea();
CTBarChart bar = new CTBarChart();
CTBarSer ser = new CTBarSer();
ser.setVal(val);
bar.getSer().add(ser);
pa.getAreaChartOrArea3DChartOrLineChart().add(bar);
chart.setPlotArea(pa);
return chart;
}
private static CTNumDataSource numSource(CTNumData cache) {
CTNumDataSource val = new CTNumDataSource();
CTNumRef ref = new CTNumRef();
ref.setNumCache(cache);
val.setNumRef(ref);
return val;
}
private static CTChartSpace spaceWith(CTChart chart) { private static CTChartSpace spaceWith(CTChart chart) {
CTChartSpace space = new CTChartSpace(); CTChartSpace space = new CTChartSpace();
space.setChart(chart); space.setChart(chart);
@@ -56,6 +56,29 @@ class Surface3dPainterTest {
+ negative[0] + ".." + negative[1]); + negative[0] + ".." + negative[1]);
} }
/**
* c:majorUnit = 1e-300 (ECMA-376 §21.2.2.103 — double без нижней границы):
* шаг заменяется niceUnit, число делений ограничено — иначе цикл делений вечный/OOM.
* Регрессия — Surface3dPainterTest#axisBounds_tinyMajorUnit_fallsBackToNiceUnit.
*/
@Test
void axisBounds_tinyMajorUnit_fallsBackToNiceUnit() {
ChartSpec.AxisSpec axis = new ChartSpec.AxisSpec();
axis.majorUnit = 1e-300;
double[] b = ChartRenderer.axisBounds(axis, 0, 100);
assertEquals(20, b[2], 1e-9, "шаг должен быть niceUnit((100-0)/5)=20");
assertTrue((b[1] - b[0]) / b[2] <= 10, "слишком много делений: " + b[0] + ".." + b[1]);
}
/** c:majorUnit = 0 — иначе `v += 0` в цикле делений не завершается. */
@Test
void axisBounds_zeroMajorUnit_fallsBackToNiceUnit() {
ChartSpec.AxisSpec axis = new ChartSpec.AxisSpec();
axis.majorUnit = 0.0;
double[] b = ChartRenderer.axisBounds(axis, 0, 100);
assertEquals(20, b[2], 1e-9);
}
@Test @Test
void paint_drawsShadedFacets() { void paint_drawsShadedFacets() {
ChartSpec spec = surfaceSpec(); ChartSpec spec = surfaceSpec();
+1 -1
View File
@@ -19,4 +19,4 @@ FROM docker.io/library/nginx:alpine
COPY --from=build /build/dist /usr/share/nginx/html COPY --from=build /build/dist /usr/share/nginx/html
# прокси-переменные хоста подмешиваются в HEALTHCHECK-шелл — обнуляем на команде # прокси-переменные хоста подмешиваются в HEALTHCHECK-шелл — обнуляем на команде
HEALTHCHECK --interval=10s --timeout=3s --start-period=10s \ HEALTHCHECK --interval=10s --timeout=3s --start-period=10s \
CMD http_proxy= https_proxy= wget -qO /dev/null http://127.0.0.1/ || exit 1 CMD HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1/ || exit 1