From 8a8e8a9f840631401c170d5e2c5ea8b12627a3ff Mon Sep 17 00:00:00 2001 From: Pjandro Date: Sun, 8 Nov 2026 19:13:38 +0000 Subject: [PATCH] =?UTF-8?q?fix(core):=20=D0=B1=D1=8E=D0=B4=D0=B6=D0=B5?= =?UTF-8?q?=D1=82=20=D1=80=D0=B0=D1=81=D0=BF=D0=B0=D0=BA=D0=BE=D0=B2=D0=BA?= =?UTF-8?q?=D0=B8=20docx=20=E2=80=94=20=D0=BF=D0=B0=D1=80=D0=B0=D0=BC?= =?UTF-8?q?=D0=B5=D1=82=D1=80=D0=BE=D0=BC=20=D0=B2=D0=B0=D0=BB=D0=B8=D0=B4?= =?UTF-8?q?=D0=B0=D1=82=D0=BE=D1=80=D0=B0=20=D0=B8=D0=B7=20maxMb/maxPages?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit checkDocxContainer получает бюджеты параметром; validate считает их из ConvertOptions.maxMb()/maxPages(): clamp(maxMb×10MiB + maxPages×64KiB, 16MiB, MAX_DECOMPRESSED_MB) и clamp(maxMb×4MiB + maxPages×32KiB, 4MiB, MAX_DECOMPRESSED_XML_MB) (коэффициенты/полы — package-private константы WordPdfConverter, compile-time инлайн — WordPdfValidator по-прежнему без зависимости от docx4j). Константы WordPdfSettings — жёсткие крышки (публичный API, защита JAXB DOM). Сообщения печатают вычисленный бюджет. Тесты: пол (16 МБ при maxMb=1), масштабирование и крышка (64 МБ при maxMb=10); доки синхронизированы. --- AGENTS.md | 2 +- docs/agent/repo-map.md | 2 +- .../ru/pjandro/wordpdf/WordPdfConverter.java | 18 ++++++ .../ru/pjandro/wordpdf/WordPdfSettings.java | 18 +++--- .../ru/pjandro/wordpdf/WordPdfValidator.java | 62 ++++++++++++++++--- .../pjandro/wordpdf/WordPdfValidatorTest.java | 56 +++++++++++++++-- 6 files changed, 134 insertions(+), 24 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 9f4db48..c0a57a9 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -35,7 +35,7 @@ - **Коды**: 400 — `ValidationException`/`BadRequestException`/битые параметры; 401 — `ApiKeyFilter`; 404/405/415 — путь/метод/content-type; 413 — multipart; **422** — `DrawingRejectedException` (core-`DrawingFoundException`, `Kind {CHARTS, SMARTART, OLE}`); 500/503/504 — `ConversionFailedException`/`ConversionRejectedException`/`ConversionTimeoutException`. 500 отвечает фиксированный текст («Внутренняя ошибка конвертации») — сообщение ядра логируется, наружу не попадает. Полная карта — `docs/agent/repo-map.md`. - **Текст 422** — контракт с фронтом: «Конвертация отменена: в документе найдены диаграммы/найден SmartArt/найдены OLE-объекты». - **Ключ**: `X-API-Key` ↔ `wordpdf.api-key` (пустое = выключено); без ключа открыты только `OPEN_PREFIXES` (`/actuator/`, `/swagger-ui`, `/v3/api-docs`), пути с точечными сегментами — никогда. -- **Очередь и лимиты**: конвертации сериализованы однопоточным `ThreadPoolExecutor` (`QUEUE_CAPACITY = 16`, переполнение → 503): ядро дополнительно сериализует конвертации монитором `WordPdfConverter.class` (`convert()` безопасен из нескольких потоков); головой очереди на старте стоит `warmup()`. До очереди — только дешёвый гейт размера (`WordPdfValidator.checkInput` на потоке Tomcat); полный `validate` (контейнер/страницы — распакованные проходы до 64 МБ) выполняется внутри воркера ядром, `ValidationException` из `ExecutionException` пробрасывается как 400. Лимиты входа — только конфигурация сервера (`wordpdf.max-mb`/`max-pages`, дефолты из `WordPdfSettings`; ≤ 0 → `IllegalStateException`; параметрами запроса не переопределяются). +- **Очередь и лимиты**: конвертации сериализованы однопоточным `ThreadPoolExecutor` (`QUEUE_CAPACITY = 16`, переполнение → 503): ядро дополнительно сериализует конвертации монитором `WordPdfConverter.class` (`convert()` безопасен из нескольких потоков); головой очереди на старте стоит `warmup()`. До очереди — только дешёвый гейт размера (`WordPdfValidator.checkInput` на потоке Tomcat); полный `validate` (контейнер/страницы — бюджет распаковки считается из лимитов входа `maxMb`/`maxPages`, крышки 64/32 МБ) выполняется внутри воркера ядром, `ValidationException` из `ExecutionException` пробрасывается как 400. Лимиты входа — только конфигурация сервера (`wordpdf.max-mb`/`max-pages`, дефолты из `WordPdfSettings`; ≤ 0 → `IllegalStateException`; параметрами запроса не переопределяются). - **SPA**: вся сеть в `wordpdf-web/src/api.ts`; ключ в `localStorage` (`wordpdf.api.key`); `ApiKeyGate` — только если `probeApiKey()` подтвердил требование ключа (признак открытого сервера — **405**); base — `VITE_BASE`; DropZone `.docx,.doc`. ## Chart/SmartArt-движок (`internal/chart`, 18 классов) diff --git a/docs/agent/repo-map.md b/docs/agent/repo-map.md index dab4144..806f47a 100644 --- a/docs/agent/repo-map.md +++ b/docs/agent/repo-map.md @@ -4,7 +4,7 @@ | Путь | Назначение | |---|---| -| `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=64`/`MAX_DECOMPRESSED_XML_MB=32`/`MAX_IMAGE_PIXELS=25_000_000`/`MAX_ZIP_ENTRIES=8192`, `ERROR_ON_*=false`), `ConvertOptions` (record) | +| `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=64`/`MAX_DECOMPRESSED_XML_MB=32` — сами бюджеты считает `WordPdfValidator.maxDecompressed*` из `maxMb`/`maxPages`, коэффициенты в `WordPdfConverter.DECOMPRESS_*`; защитные `MAX_IMAGE_PIXELS=25_000_000`/`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) | 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 ce0916a..28198ff 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java @@ -239,6 +239,24 @@ public final class WordPdfConverter { private static final Logger LOG = Logger.getLogger(WordPdfConverter.class.getName()); + // Бюджеты распаковки docx (считает WordPdfValidator.maxDecompressed* от + // лимитов входа ConvertOptions). Значения — строго литералы compile-time + // констант: javac инлайнит их в WordPdfValidator, и обращение из валидатора + // НЕ инициализирует этот класс (его static-блок выставляет sysprops docx4j — + // инвариант «WordPdfValidator не зависит от docx4j» сохраняется). + /** Бюджет суммарной распаковки: MiB на каждый МБ лимита размера входа. */ + static final int DECOMPRESS_MB_PER_MAX_MB = 10; + /** Бюджет суммарной распаковки: KiB на каждую страницу лимита. */ + static final int DECOMPRESS_KIB_PER_PAGE = 64; + /** Бюджет XML-частей: MiB на каждый МБ лимита (JAXB-разбор дороже байта). */ + static final int DECOMPRESS_XML_MB_PER_MAX_MB = 4; + /** Бюджет XML-частей: KiB на каждую страницу лимита. */ + static final int DECOMPRESS_XML_KIB_PER_PAGE = 32; + /** Пол бюджета суммарной распаковки (MiB) — чтобы мелкие лимиты не ломали легитимные документы. */ + static final long MIN_DECOMPRESSED_MB = 16; + /** Пол бюджета XML-частей (MiB). */ + static final long MIN_DECOMPRESSED_XML_MB = 4; + /** * Прогрев ядра: первая конвертация после старта JVM стоит 1,3–1,7 с * (JAXB/XSLT/FOP/классы), её платил первый запрос после деплоя. Прогоняет diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfSettings.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfSettings.java index 698b701..6972c9d 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfSettings.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfSettings.java @@ -16,17 +16,21 @@ public final class WordPdfSettings { public static final int MAX_PAGES = 100; /** - * Потолок суммарного распакованного размера архива (МБ) — защита от zip-бомбы. - * Вход ограничен {@link #MAX_INPUT_MB}, медиа в zip не сжимается — легитимный - * документ суммарно распаковывается в единицы МБ; 64 МБ — запас на huge-таблицы. + * Жёсткая крышка автоматического бюджета суммарного распакованного размера + * архива (МБ) — защита от zip-бомбы. Бюджет считается из лимитов входа + * ({@code maxMb}/{@code maxPages}) в {@link WordPdfValidator#maxDecompressedBytes} + * (коэффициенты — {@code WordPdfConverter.DECOMPRESS_*}); эта константа не + * даёт ему вырасти при raise-е {@code wordpdf.max-mb}: легитимный документ + * суммарно распаковывается в единицы МБ, 64 МБ — запас на huge-таблицы. */ public static final long MAX_DECOMPRESSED_MB = 64; /** - * Потолок суммарного распакованного размера XML-частей ({@code *.xml}, - * {@code *.rels}) в МБ — отдельный гейт: байтовый бюджет архива можно - * выжатый XML уложить в десятки МБ, а JAXB-разбор такого документа стоит - * CPU/heap несоизмеримо дороже байт. + * Жёсткая крышка автоматического бюджета суммарного распакованного размера + * XML-частей ({@code *.xml}, {@code *.rels}) в МБ + * ({@link WordPdfValidator#maxDecompressedXmlBytes}) — отдельный гейт: + * байтовый бюджет архива можно выжатый XML уложить в десятки МБ, а + * JAXB-разбор такого документа стоит CPU/heap несоизмеримо дороже байт. */ public static final long MAX_DECOMPRESSED_XML_MB = 32; 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 ad694d2..a47ba0a 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfValidator.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfValidator.java @@ -34,10 +34,12 @@ import java.util.zip.ZipInputStream; *