Merge pull request 'ValidationException в ядре, checkPageCount, дефолты лимитов 5 MiB / 100 страниц' (#11) from feat/validation-exception-and-default-limits into main
Reviewed-on: #11
This commit was merged in pull request #11.
This commit is contained in:
+4
-4
@@ -5,7 +5,7 @@ WORDPDF_API_KEY=
|
|||||||
# Лимиты входа (задаёт только сервер; параметрами запроса не переопределяются).
|
# Лимиты входа (задаёт только сервер; параметрами запроса не переопределяются).
|
||||||
# Либо закомментировано (тогда дефолт), либо конкретное число — пустое
|
# Либо закомментировано (тогда дефолт), либо конкретное число — пустое
|
||||||
# значение ломает старт приложения.
|
# значение ломает старт приложения.
|
||||||
# Максимальный размер .docx в байтах (дефолт 20971520 = 20 МБ)
|
# Максимальный размер .docx в байтах (дефолт 5242880 = 5 МБ)
|
||||||
#WORDPDF_MAX_BYTES=20971520
|
#WORDPDF_MAX_BYTES=5242880
|
||||||
# Максимальное число страниц (дефолт 1000)
|
# Максимальное число страниц (дефолт 100)
|
||||||
#WORDPDF_MAX_PAGES=1000
|
#WORDPDF_MAX_PAGES=100
|
||||||
|
|||||||
@@ -2,17 +2,17 @@
|
|||||||
|
|
||||||
## Project Overview
|
## Project Overview
|
||||||
|
|
||||||
Конвертер `.docx` → `.pdf` на чистом Java (docx4j 17.3.2 + форк Apache FOP, без LibreOffice/Aspose). Java 21, только Maven. Модули: `wordpdf-core` (библиотека), `wordpdf-app` (Spring Boot 4.1.1 REST API); `wordpdf-web` — React SPA в nginx-контейнере (отдельный деп, вне Maven). Единственный гейт перед `git push` — `mvn clean verify` (CI нет; SPA гейтуется `npm run build` + `npm run lint`). Вход стека — контейнер `gateway` (nginx), НЕ 8080. README устарел шире секции про контейнеры: лимиты (пишет 5 МБ/100 стр./6 МБ multipart — фактически 20 MiB/1000/100 MB), порты («всё на :8080» — фактически gateway :9010/:9011), API-ключ вообще не упомянут; плюс «фикстуры генерируются POI» (они закоммичены, POI только в генераторе) и Swagger UI без оговорки, что в проде она открыта без ключа, — авторитет этот файл.
|
Конвертер `.docx` → `.pdf` на чистом Java (docx4j 17.3.2 + форк Apache FOP, без LibreOffice/Aspose). Java 21, только Maven. Модули: `wordpdf-core` (библиотека), `wordpdf-app` (Spring Boot 4.1.1 REST API); `wordpdf-web` — React SPA в nginx-контейнере (отдельный деп, вне Maven). Единственный гейт перед `git push` — `mvn clean verify` (CI нет; SPA гейтуется `npm run build` + `npm run lint`). Вход стека — контейнер `gateway` (nginx), НЕ 8080. README устарел шире секции про контейнеры: лимиты (пишет 5 МБ/100 стр. — совпадает с кодом; 6 МБ multipart — фактически 100 MB), порты («всё на :8080» — фактически gateway :9010/:9011), API-ключ вообще не упомянут; плюс «фикстуры генерируются POI» (они закоммичены, POI только в генераторе) и Swagger UI без оговорки, что в проде она открыта без ключа, — авторитет этот файл.
|
||||||
|
|
||||||
## Architecture & Data Flow
|
## Architecture & Data Flow
|
||||||
|
|
||||||
### Пайплайн `WordPdfConverter.convert(byte[], String[, ConvertOptions])` (порядок фиксирован, менять местами нельзя)
|
### Пайплайн `WordPdfConverter.convert(byte[], String[, ConvertOptions])` (порядок фиксирован, менять местами нельзя)
|
||||||
|
|
||||||
Наружу `checkInput(bytes, maxBytes)` вызывается **до** приватного `convertToStream`; внутри `convertToStream`:
|
Наружу `WordPdfValidator.validate(docxBytes, options)` (размер → zip-подпись `PK\x03\x04` → страницы) вызывается **до** приватного `convertToStream`; внутри `convertToStream`:
|
||||||
|
|
||||||
1. `new BundledFontMapper()` → `BundledFonts.init()` → `BundledFonts.restrictToBundled()`. Конструктор маппера каждый раз добавляет системные шрифты в реестр `PhysicalFonts`; ключ реестра — имя из name-таблицы TTF, `addPhysicalFont(URI)` не перезаписывает занятый → `init()` вызывает `dropNonBundled()` **до** регистрации и `load()` (иначе системный Calibri ломает em-dash-fallback).
|
1. `new BundledFontMapper()` → `BundledFonts.init()` → `BundledFonts.restrictToBundled()`. Конструктор маппера каждый раз добавляет системные шрифты в реестр `PhysicalFonts`; ключ реестра — имя из name-таблицы TTF, `addPhysicalFont(URI)` не перезаписывает занятый → `init()` вызывает `dropNonBundled()` **до** регистрации и `load()` (иначе системный Calibri ломает em-dash-fallback).
|
||||||
2. Нормализация байтов docx до JAXB-загрузки (цепочка `byte[] → byte[]`, порядок значим): `StrictOoxmlNormalizer` (strict-OOXML → transitional-байт: `a:`-проценты и `w14:fillToRect` → тысячные ×1000, текст `wp14:pctWidth`/`pctHeight`, элементы и атрибуты `w:start`/`w:end` → `w:left`/`w:right` (кроме `w:lvl/w:start` в numbering.xml), значения `start`/`end` у `w:jc`/`w:tab`; в `mc-preprocessor.xslt` docx4j ветка `%` закомментирована, start/end не маппятся; namespaces и `pt`-значения правит сам mc-preprocessor — собственный рерайт URI ломает его pt-конверсию) → `DocxOnOffNormalizer` (`w:val="off"/"on"` → `false`/`true`) → `SymbolFontNormalizer` (PUA U+F0xx Symbol/Wingdings/Webdings → Unicode + DejaVu Sans, переписывает и элементы `<w:sym>`; 5 карт по 256 слотов, таблица `SymbolMapper` сгенерирована из docx4j 17.x) → `FieldNormalizer` (`fldChar` PAGE/NUMPAGES/SECTIONPAGES → `w:fldSimple`, вложенные/битые поля пропускает) → `GlyphCoverageNormalizer` (режет ран по покрытию глифов, пишет семейство в `w:rFonts`, иначе FOP рисует «#»; покрытие — `java.awt.Font.canDisplay` + BitSet-кэш, НЕ docx4j `GlyphCheck` — тот плодит INFO-лог; для serif-ран fallback ищется сначала в `SERIF_FAMILIES` (DejaVu Serif/Tinos/Caladea), затем в sans) → `WordprocessingMLPackage.load`.
|
2. Нормализация байтов docx до JAXB-загрузки (цепочка `byte[] → byte[]`, порядок значим): `StrictOoxmlNormalizer` (strict-OOXML → transitional-байт: `a:`-проценты и `w14:fillToRect` → тысячные ×1000, текст `wp14:pctWidth`/`pctHeight`, элементы и атрибуты `w:start`/`w:end` → `w:left`/`w:right` (кроме `w:lvl/w:start` в numbering.xml), значения `start`/`end` у `w:jc`/`w:tab`; в `mc-preprocessor.xslt` docx4j ветка `%` закомментирована, start/end не маппятся; namespaces и `pt`-значения правит сам mc-preprocessor — собственный рерайт URI ломает его pt-конверсию) → `DocxOnOffNormalizer` (`w:val="off"/"on"` → `false`/`true`) → `SymbolFontNormalizer` (PUA U+F0xx Symbol/Wingdings/Webdings → Unicode + DejaVu Sans, переписывает и элементы `<w:sym>`; 5 карт по 256 слотов, таблица `SymbolMapper` сгенерирована из docx4j 17.x) → `FieldNormalizer` (`fldChar` PAGE/NUMPAGES/SECTIONPAGES → `w:fldSimple`, вложенные/битые поля пропускает) → `GlyphCoverageNormalizer` (режет ран по покрытию глифов, пишет семейство в `w:rFonts`, иначе FOP рисует «#»; покрытие — `java.awt.Font.canDisplay` + BitSet-кэш, НЕ docx4j `GlyphCheck` — тот плодит INFO-лог; для serif-ран fallback ищется сначала в `SERIF_FAMILIES` (DejaVu Serif/Tinos/Caladea), затем в sans) → `WordprocessingMLPackage.load`.
|
||||||
3. `WordPdfValidator.checkPageCount(pkg, maxPages)` — **до** рендера.
|
3. `WordPdfValidator.checkPageCount(docxBytes, maxPages)` — **до** рендера, lightweight (zip/StAX) по нормализованным байтам — тот же путь, что у приложения до очереди.
|
||||||
4. `pkg.setFontMapper(mapper)` → `DrawingPreRenderer.run(pkg, options)` (шаг 3.5: `c:chart`/`dgm:relIds` docx2fo.xslt не умеет — свой Java2D-движок `internal/chart/*` рендерит в PNG 300 dpi и подменяет на `pic:pic`; объект, выключенный в `ConvertOptions`, пропускается до рендера и остаётся в docx; упавший рендер — объект **удаляется** из docx (`gd.getAny().clear()`) + warn, деградация не падение).
|
4. `pkg.setFontMapper(mapper)` → `DrawingPreRenderer.run(pkg, options)` (шаг 3.5: `c:chart`/`dgm:relIds` docx2fo.xslt не умеет — свой Java2D-движок `internal/chart/*` рендерит в PNG 300 dpi и подменяет на `pic:pic`; объект, выключенный в `ConvertOptions`, пропускается до рендера и остаётся в docx; упавший рендер — объект **удаляется** из docx (`gd.getAny().clear()`) + warn, деградация не падение).
|
||||||
5. `new FOSettings(pkg)` + `FopFallbackFonts.declare` (декларирует **все** бандл-семейства — FOP встраивает только задекларированные) → `FORendererApacheFOP`/`FOUserAgent` (непустой `title` → заголовок PDF) → `Docx4J.toFO(..., FLAG_EXPORT_PREFER_XSL)`.
|
5. `new FOSettings(pkg)` + `FopFallbackFonts.declare` (декларирует **все** бандл-семейства — FOP встраивает только задекларированные) → `FORendererApacheFOP`/`FOUserAgent` (непустой `title` → заголовок PDF) → `Docx4J.toFO(..., FLAG_EXPORT_PREFER_XSL)`.
|
||||||
6. `finally`: `deleteEmbeddedFontTempFiles()` (в 17.x `OpcPackage.close()` нет).
|
6. `finally`: `deleteEmbeddedFontTempFiles()` (в 17.x `OpcPackage.close()` нет).
|
||||||
@@ -21,9 +21,9 @@
|
|||||||
|
|
||||||
- Единственный эндпоинт `POST /api/v1/convert` (multipart-поле `file`, факультативные `renderCharts`/`renderSmartArt` — query или form) → `application/pdf`, `Content-Disposition: attachment; filename*=UTF-8''…`. Проверка `.docx`-расширения — в `ConvertController`; `safeBaseName` в `ConversionService` — единый источник имени для файла, заголовка ответа и PDF-title (разрешены `[\p{L}\p{N} ._-]`, пустое → `document`).
|
- Единственный эндпоинт `POST /api/v1/convert` (multipart-поле `file`, факультативные `renderCharts`/`renderSmartArt` — query или form) → `application/pdf`, `Content-Disposition: attachment; filename*=UTF-8''…`. Проверка `.docx`-расширения — в `ConvertController`; `safeBaseName` в `ConversionService` — единый источник имени для файла, заголовка ответа и PDF-title (разрешены `[\p{L}\p{N} ._-]`, пустое → `document`).
|
||||||
- Конвертации **сериализованы** однопоточным `ThreadPoolExecutor` (`ConversionService.QUEUE_CAPACITY = 16`, переполнение → 503): ядро мутирует глобальный реестр `PhysicalFonts`. `future.cancel(true)` при таймауте не останавливает FOP мгновенно — осознанный компромисс.
|
- Конвертации **сериализованы** однопоточным `ThreadPoolExecutor` (`ConversionService.QUEUE_CAPACITY = 16`, переполнение → 503): ядро мутирует глобальный реестр `PhysicalFonts`. `future.cancel(true)` при таймауте не останавливает FOP мгновенно — осознанный компромисс.
|
||||||
- Ошибки (`ApiExceptionHandler`, тело `{"error": …}`): `ValidationException` → 400; `ConversionFailedException` → 500; `ConversionRejectedException` → 503; `ConversionTimeoutException` (`wordpdf.convert-timeout`, 2m) → 504; `MaxUploadSizeExceededException` → 413; `MissingServletRequestPartException`/`MissingServletRequestParameterException` → 400; `NoResourceFoundException` (неизвестный путь) → 404; catch-all → 500 (подробности только в лог). Четыре app-исключения (`ValidationException`, `ConversionFailedException`, `ConversionRejectedException`, `ConversionTimeoutException`) — package-private, несут семантику 400/500/503/504. Граница: сломанный контейнер (не zip / размер / страницы) → 400, валидный zip с мусором внутри → 500. Валидация до очереди: `checkInput` → zip-магик `PK\x03\x04` → `checkPageCountLightweight` (порядок значим).
|
- Ошибки (`ApiExceptionHandler`, тело `{"error": …}`): `ValidationException` → 400; `ConversionFailedException` → 500; `ConversionRejectedException` → 503; `ConversionTimeoutException` (`wordpdf.convert-timeout`, 2m) → 504; `MaxUploadSizeExceededException` → 413; `MissingServletRequestPartException`/`MissingServletRequestParameterException` → 400; `NoResourceFoundException` (неизвестный путь) → 404; catch-all → 500 (подробности только в лог). `ValidationException` — тип ядра `ru.pjandro.wordpdf.ValidationException extends ConversionException` (публичный), валидатор бросает его сам, app-дубликата нет; три app-исключения (`ConversionFailedException`, `ConversionRejectedException`, `ConversionTimeoutException`) — package-private, несут семантику 500/503/504. `doConvert` перехватывает `ValidationException` раньше `ConversionException` — отказ страницы-лимита из конвейера ядра даёт 400, а не 500. Граница: сломанный контейнер (не zip / размер / страницы) → 400, валидный zip с мусором внутри → 500. Валидация до очереди: `WordPdfValidator.validate(docxBytes, options)` (внутри порядок значим: `checkInput` → zip-магик `PK\x03\x04` → `checkPageCount`); тот же метод — вход ядра.
|
||||||
- **Ключ доступа**: `ApiKeyFilter` сверяет заголовок `X-API-Key` (`ApiKeyFilter.HEADER`) со свойством `wordpdf.api-key` (env `WORDPDF_API_KEY`, сравнение `MessageDigest.isEqual`). Пустое свойство = аутентификация выключена (dev `java -jar`, тесты). Без ключа открыты `/actuator/**` (HEALTHCHECK) и документация springdoc (`/swagger-ui*`, `/v3/api-docs*`) — матч по пути **без forwarded-contextPath** (`getRequestURI()` минус `getContextPath()`; иначе под `X-Forwarded-Prefix` HEALTHCHECK получил бы 401). 401 пишет сам фильтр (`ApiExceptionHandler` ошибок фильтров не видит). Springdoc в проде **включён**, документация открыта без ключа под `https://pjandro.ru/pdf-converter/swagger-ui.html` (server-URL/swagger-config собираются из `X-Forwarded-*`, `server.forward-headers-strategy=framework` — `native`-клапан Tomcat `X-Forwarded-Prefix` не понимает). Регрессии — `ApiKeyFilterTest#forwardedPrefix_healthStaysOpen`, `ApiKeyFilterTest#docsOpenWithoutKey`.
|
- **Ключ доступа**: `ApiKeyFilter` сверяет заголовок `X-API-Key` (`ApiKeyFilter.HEADER`) со свойством `wordpdf.api-key` (env `WORDPDF_API_KEY`, сравнение `MessageDigest.isEqual`). Пустое свойство = аутентификация выключена (dev `java -jar`, тесты). Без ключа открыты `/actuator/**` (HEALTHCHECK) и документация springdoc (`/swagger-ui*`, `/v3/api-docs*`) — матч по пути **без forwarded-contextPath** (`getRequestURI()` минус `getContextPath()`; иначе под `X-Forwarded-Prefix` HEALTHCHECK получил бы 401). 401 пишет сам фильтр (`ApiExceptionHandler` ошибок фильтров не видит). Springdoc в проде **включён**, документация открыта без ключа под `https://pjandro.ru/pdf-converter/swagger-ui.html` (server-URL/swagger-config собираются из `X-Forwarded-*`, `server.forward-headers-strategy=framework` — `native`-клапан Tomcat `X-Forwarded-Prefix` не понимает). Регрессии — `ApiKeyFilterTest#forwardedPrefix_healthStaysOpen`, `ApiKeyFilterTest#docsOpenWithoutKey`.
|
||||||
- Лимиты входа задаёт **только конфигурация сервера**: `wordpdf.max-bytes`/`wordpdf.max-pages` (env `WORDPDF_MAX_BYTES`/`WORDPDF_MAX_PAGES`), `@Value` в `ConvertController` с дефолтом-SpEL из `WordPdfSettings` (20 MiB / 1000); значение ≤ 0 → `IllegalStateException` на старте; параметрами запроса не переопределяются. Ключи в `application.properties` **не объявлены** — пустое значение затенит SpEL-дефолт.
|
- Лимиты входа задаёт **только конфигурация сервера**: `wordpdf.max-bytes`/`wordpdf.max-pages` (env `WORDPDF_MAX_BYTES`/`WORDPDF_MAX_PAGES`), `@Value` в `ConvertController` с дефолтом-SpEL из `WordPdfSettings` (5 MiB / 100); значение ≤ 0 → `IllegalStateException` на старте; параметрами запроса не переопределяются. Ключи в `application.properties` **не объявлены** — пустое значение затенит SpEL-дефолт.
|
||||||
- SPA: вся сеть в `src/api.ts` (компоненты `fetch` не вызывают); ключ в `localStorage` (`wordpdf.api.key`), при 401 очищается, экран `ApiKeyGate` (`UnauthorizedError` — наследник `ApiError`, проверяется раньше); гейт показывается только когда `probeApiKey()` (GET /api/v1/convert → 401 от `ApiKeyFilter`) подтвердил требование ключа — в dev без ключа форма открывается сразу; запросы на `${import.meta.env.BASE_URL}api/...` (vite `base` из `VITE_BASE`, дефолт `/`) — CORS не нужен (dev: vite-proxy → :8080; prod: nginx с префиксом `/pdf-converter/`).
|
- SPA: вся сеть в `src/api.ts` (компоненты `fetch` не вызывают); ключ в `localStorage` (`wordpdf.api.key`), при 401 очищается, экран `ApiKeyGate` (`UnauthorizedError` — наследник `ApiError`, проверяется раньше); гейт показывается только когда `probeApiKey()` (GET /api/v1/convert → 401 от `ApiKeyFilter`) подтвердил требование ключа — в dev без ключа форма открывается сразу; запросы на `${import.meta.env.BASE_URL}api/...` (vite `base` из `VITE_BASE`, дефолт `/`) — CORS не нужен (dev: vite-proxy → :8080; prod: nginx с префиксом `/pdf-converter/`).
|
||||||
|
|
||||||
### Chart-движок (`internal/chart`, package-private кроме `DrawingPreRenderer.run`)
|
### Chart-движок (`internal/chart`, package-private кроме `DrawingPreRenderer.run`)
|
||||||
@@ -35,7 +35,7 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр
|
|||||||
- `docx4j.convert.out.fo.gsubFeatures=false` — static-блок `WordPdfConverter`. Иначе FO невалиден → `WordLayoutFixups` молча отказывает всем фиксам (без них нет колонок) → FOP падает на `docx4j-baseline`.
|
- `docx4j.convert.out.fo.gsubFeatures=false` — static-блок `WordPdfConverter`. Иначе FO невалиден → `WordLayoutFixups` молча отказывает всем фиксам (без них нет колонок) → FOP падает на `docx4j-baseline`.
|
||||||
- `slf4j-simple` обязателен в ядре: без SLF4J-провайдера docx4j пишет «TO HIDE THESE MESSAGES» прямо в PDF (регрессия `noLoggingWarningInPdf`). Приложение исключает его из зависимости ядра — логи ведёт logback.
|
- `slf4j-simple` обязателен в ядре: без SLF4J-провайдера docx4j пишет «TO HIDE THESE MESSAGES» прямо в PDF (регрессия `noLoggingWarningInPdf`). Приложение исключает его из зависимости ядра — логи ведёт logback.
|
||||||
- FOP — форк `org.docx4j:docx4j-fo-renderer*` 2.11-docx4j.2 (пакеты `org.apache.fop.*`); `Fop.Renderers.getRenderer()` возвращает **список** (рендер выбирается по mime `application/pdf`). `docx2fo.xslt` в репозитории нет — он в jar `docx4j-export-fo`.
|
- FOP — форк `org.docx4j:docx4j-fo-renderer*` 2.11-docx4j.2 (пакеты `org.apache.fop.*`); `Fop.Renderers.getRenderer()` возвращает **список** (рендер выбирается по mime `application/pdf`). `docx2fo.xslt` в репозитории нет — он в jar `docx4j-export-fo`.
|
||||||
- Страницы в валидаторе = `max(кэш docProps/app.xml, явные разрывы, lastRenderedPageBreak+1)`; explicit = межсекционные `sectPr` в body + `w:br type="page"` + `pageBreakBefore` (рекурсивно, включая таблицы и `w:sdt`). Lightweight-путь (StAX по zip, secure-ридер без DTD/external entities): атрибуты — по локальному имени (`attrLocal`, не по transitional-URI: иначе в strict-документе `w:br type="page"` не засчитываются); `sectPr` внутри `pPr` не считает, последнюю body-direct секцию не считает, `continuous`-секции не считает, в колонтитулах — только `w:br type="page"`, `pageBreakBefore` — только внутри `pPr` вне `sectPr` (truthy-значения `val`: `null|true|1|on`); на не-zip молчит — подпись проверяет вызывающий. Расхождение lightweight↔JAXB допустимо только в завышение. `pageCountOf` package-private намеренно (тесты); при провале JAXB-разбора (`getJaxbElement()` → null) бросает `ConversionException`, а не NPE.
|
- Страницы в валидаторе = `max(кэш docProps/app.xml, явные разрывы, lastRenderedPageBreak+1)`; explicit = межсекционные `sectPr` в body + `w:br type="page"` + `pageBreakBefore` (включая таблицы и `w:sdt`). Единственный путь — lightweight (StAX по zip, secure-ридер без DTD/external entities; JAXB-обход удалён — `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 молчит — подпись проверяет вызывающий. Все отказы — `ValidationException`.
|
||||||
- Известный остаток эталона: U+2188/U+218A — глифов нет в OFL-шрифтах бандла, остаются `.notdef` (GNU FreeSerif GPL — не добавляем намеренно).
|
- Известный остаток эталона: U+2188/U+218A — глифов нет в OFL-шрифтах бандла, остаются `.notdef` (GNU FreeSerif GPL — не добавляем намеренно).
|
||||||
- Внимательно: комментарии в `WordPdfConverter`/`DocxOnOffNormalizer` говорят «docx4j 11.x» — устаревшее число, фактически 17.3.2 (описанное поведение верно).
|
- Внимательно: комментарии в `WordPdfConverter`/`DocxOnOffNormalizer` говорят «docx4j 11.x» — устаревшее число, фактически 17.3.2 (описанное поведение верно).
|
||||||
|
|
||||||
@@ -47,7 +47,7 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр
|
|||||||
|
|
||||||
|Путь|Назначение|
|
|Путь|Назначение|
|
||||||
|---|---|
|
|---|---|
|
||||||
|`wordpdf-core/src/main/java/ru/pjandro/wordpdf/`|публичный API: `WordPdfConverter`, `WordPdfValidator` (перегрузки `checkInput`/`checkPageCountLightweight`/`checkPageCount` — `byte[]` или pkg, с лимитом/без), `ConversionException`, `WordPdfSettings` (константы-дефолты), `ConvertOptions` (record: renderCharts, renderSmartArt, maxBytes, maxPages)|
|
|`wordpdf-core/src/main/java/ru/pjandro/wordpdf/`|публичный API: `WordPdfConverter`, `WordPdfValidator` (перегрузки `checkInput`/`checkPageCount` — `byte[]`, с лимитом/без, и `validate(byte[], ConvertOptions)` — полная цепочка размер → zip-подпись → страницы; без зависимости от docx4j), `ConversionException`, `ValidationException` (наследник — «вход некорректен»), `WordPdfSettings` (константы-дефолты), `ConvertOptions` (record: renderCharts, renderSmartArt, maxBytes, maxPages)|
|
||||||
|`…/wordpdf/fonts/`|`BundledFonts` (реестр/выгрузка TTF, `families()`, `FALLBACK_FAMILY`), `BundledFontMapper` (алиасы MS→open-source, self-map, DISPLAY_NAMES, public-хук `bundledFamily`)|
|
|`…/wordpdf/fonts/`|`BundledFonts` (реестр/выгрузка TTF, `families()`, `FALLBACK_FAMILY`), `BundledFontMapper` (алиасы MS→open-source, self-map, DISPLAY_NAMES, public-хук `bundledFamily`)|
|
||||||
|`…/wordpdf/internal/`|5 байтовых нормализатора + `FopFallbackFonts` (классы `public` — вызываются из родительского пакета; публичные члены только `normalize`/`declare`)|
|
|`…/wordpdf/internal/`|5 байтовых нормализатора + `FopFallbackFonts` (классы `public` — вызываются из родительского пакета; публичные члены только `normalize`/`declare`)|
|
||||||
|`…/wordpdf/internal/chart/`|11 классов Java2D-рендера диаграмм/SmartArt в PNG (public только `DrawingPreRenderer`)|
|
|`…/wordpdf/internal/chart/`|11 классов Java2D-рендера диаграмм/SmartArt в PNG (public только `DrawingPreRenderer`)|
|
||||||
@@ -55,7 +55,7 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр
|
|||||||
|`wordpdf-core/src/test/resources/samples/`|11 закоммиченных `.docx`-фикстур (единственные фикстуры)|
|
|`wordpdf-core/src/test/resources/samples/`|11 закоммиченных `.docx`-фикстур (единственные фикстуры)|
|
||||||
|`wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/`|REST API (10 классов): `WordPdfApplication` (единственный public), `ConvertController`, `ConversionService` (очередь), `ApiExceptionHandler`, `ApiKeyFilter`, `OpenApiConfig` (`@SecurityScheme` X-API-Key для springdoc) + 4 класса исключений|
|
|`wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/`|REST API (10 классов): `WordPdfApplication` (единственный public), `ConvertController`, `ConversionService` (очередь), `ApiExceptionHandler`, `ApiKeyFilter`, `OpenApiConfig` (`@SecurityScheme` X-API-Key для springdoc) + 4 класса исключений|
|
||||||
|`wordpdf-web/src/`|SPA (React 19 + TS + Vite + Tailwind): `api.ts` (вся сеть), `components/` (App, ApiKeyGate, PdfPreview, StatusMessage, DropZone, Logo)|
|
|`wordpdf-web/src/`|SPA (React 19 + TS + Vite + Tailwind): `api.ts` (вся сеть), `components/` (App, ApiKeyGate, PdfPreview, StatusMessage, DropZone, Logo)|
|
||||||
|корневые `Containerfile`, `compose.yml`, `compose.dev.yml`, `gateway/nginx.conf`|образ бэкенда (multi-stage maven:3.9-temurin-21 → temurin-21-jre, non-root, HEALTHCHECK actuator); compose app+web+gateway: web-образ со своим HEALTHCHECK (`wget /`), в обоих compose `depends_on web: condition: service_healthy` (без health web gateway не стартует); прод-compose интерполирует `WORDPDF_MAX_BYTES:-20971520`/`WORDPDF_MAX_PAGES:-1000`; podman-специфика обоих compose: `x-podman.name_separator_compat` (docker-style имена контейнеров), явные `healthcheck` app/web (дубли Containerfile-HEALTHCHECK — OCI-выгрузка его теряет), зафиксированная подсеть `10.113.0.0/24` gw `10.113.0.1` под резолвер aardvark-dns; два repo-стенда одновременно не поднять (общая подсеть)|
|
|корневые `Containerfile`, `compose.yml`, `compose.dev.yml`, `gateway/nginx.conf`|образ бэкенда (multi-stage maven:3.9-temurin-21 → temurin-21-jre, non-root, HEALTHCHECK actuator); compose app+web+gateway: web-образ со своим HEALTHCHECK (`wget /`), в обоих compose `depends_on web: condition: service_healthy` (без health web gateway не стартует); прод-compose интерполирует `WORDPDF_MAX_BYTES:-5242880`/`WORDPDF_MAX_PAGES:-100`; podman-специфика обоих compose: `x-podman.name_separator_compat` (docker-style имена контейнеров), явные `healthcheck` app/web (дубли Containerfile-HEALTHCHECK — OCI-выгрузка его теряет), зафиксированная подсеть `10.113.0.0/24` gw `10.113.0.1` под резолвер aardvark-dns; два repo-стенда одновременно не поднять (общая подсеть)|
|
||||||
|корневой `.env.example`|шаблон env: `WORDPDF_API_KEY` (`openssl rand -hex 32`), закомментированные `WORDPDF_MAX_BYTES`/`WORDPDF_MAX_PAGES`; реальный прод `.env` — на прод-сервере (координаты: `/home/pjandro/prod/java-word-pdf/DEPLOY.md`, вне репо)|
|
|корневой `.env.example`|шаблон env: `WORDPDF_API_KEY` (`openssl rand -hex 32`), закомментированные `WORDPDF_MAX_BYTES`/`WORDPDF_MAX_PAGES`; реальный прод `.env` — на прод-сервере (координаты: `/home/pjandro/prod/java-word-pdf/DEPLOY.md`, вне репо)|
|
||||||
|`develop/` (вне git)|рабочие материалы и эталоны Word 365 (`word.docx`+`word.pdf`, `word-export.*`, `convert.pdf`, `1212.pdf`, `diff/`) — **ручное сравнение, не фикстуры**, в тесты/jar не подключать|
|
|`develop/` (вне git)|рабочие материалы и эталоны Word 365 (`word.docx`+`word.pdf`, `word-export.*`, `convert.pdf`, `1212.pdf`, `diff/`) — **ручное сравнение, не фикстуры**, в тесты/jar не подключать|
|
||||||
|
|
||||||
@@ -96,7 +96,7 @@ java -cp wordpdf-core/target/test-classes:$(cat /tmp/cp.txt) \
|
|||||||
## Important Files
|
## Important Files
|
||||||
|
|
||||||
- `wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java` — точка входа библиотеки + static-блок `gsubFeatures`.
|
- `wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java` — точка входа библиотеки + static-блок `gsubFeatures`.
|
||||||
- `wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfSettings.java` — все дефолты ядра (`MAX_INPUT_BYTES` 20 MiB, `MAX_PAGES` 1000, `RENDER_CHARTS/SMARTART`); рантайм-конфигурации в ядре нет.
|
- `wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfSettings.java` — все дефолты ядра (`MAX_INPUT_BYTES` 5 MiB, `MAX_PAGES` 100, `RENDER_CHARTS/SMARTART`); рантайм-конфигурации в ядре нет.
|
||||||
- `wordpdf-app/src/main/resources/application.properties` — multipart 100MB (`max-file-size`/`max-request-size` + `file-size-threshold=100MB`, держит файл в памяти; в тон gateway `client_max_body_size 100m`), `wordpdf.convert-timeout=2m`, пустой `wordpdf.api-key`, `server.forward-headers-strategy=framework` (префикс прод-прокси для springdoc) + `springdoc.swagger-ui.persist-authorization=true`; `wordpdf.max-bytes`/`max-pages` здесь намеренно нет.
|
- `wordpdf-app/src/main/resources/application.properties` — multipart 100MB (`max-file-size`/`max-request-size` + `file-size-threshold=100MB`, держит файл в памяти; в тон gateway `client_max_body_size 100m`), `wordpdf.convert-timeout=2m`, пустой `wordpdf.api-key`, `server.forward-headers-strategy=framework` (префикс прод-прокси для springdoc) + `springdoc.swagger-ui.persist-authorization=true`; `wordpdf.max-bytes`/`max-pages` здесь намеренно нет.
|
||||||
- `wordpdf-app/pom.xml` — `spring-boot-maven-plugin` с **явной** execution `repackage` (в 4.1.1 сам не связывается, jar останется тонким); `slf4j-simple` исключён; `spring-boot-starter-webmvc` (Boot 4: переименован из starter-web) + `spring-boot-starter-actuator` (нужен HEALTHCHECK контейнера `/actuator/health`); тест-зависимости: `spring-boot-webmvc-test` (в Boot 4 автоконфиг MockMvc вынесен из starter-test), test-jar core.
|
- `wordpdf-app/pom.xml` — `spring-boot-maven-plugin` с **явной** execution `repackage` (в 4.1.1 сам не связывается, jar останется тонким); `slf4j-simple` исключён; `spring-boot-starter-webmvc` (Boot 4: переименован из starter-web) + `spring-boot-starter-actuator` (нужен HEALTHCHECK контейнера `/actuator/health`); тест-зависимости: `spring-boot-webmvc-test` (в Boot 4 автоконфиг MockMvc вынесен из starter-test), test-jar core.
|
||||||
- `wordpdf-core/pom.xml` — `maven-jar-plugin` execution `test-jar` (публикует фикстуры для app).
|
- `wordpdf-core/pom.xml` — `maven-jar-plugin` execution `test-jar` (публикует фикстуры для app).
|
||||||
@@ -117,11 +117,11 @@ java -cp wordpdf-core/target/test-classes:$(cat /tmp/cp.txt) \
|
|||||||
|
|
||||||
## Testing & QA
|
## Testing & QA
|
||||||
|
|
||||||
- 14 тестовых классов / 126 `@Test` (core 11/104, app 3/22). JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true` в argLine; только `Assertions` (Mockito/AssertJ не использовать, несмотря на test-classpath Boot; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`); тестовые классы package-private, зеркалят main-пакеты; только `@Test` (+ единственный `@BeforeAll` — warm-up шрифтов в `GlyphCoverageNormalizerTest`).
|
- 14 тестовых классов / 132 `@Test` (core 11/107, app 3/25). 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-пейнтеров, допуски 6–10% против эталона Word (`PiePainterTest` аспект h/w=0.585, `assertRatio` отклонение <0.06; `Surface3dPainterTest` `assertRange` ±6 pt для центров силуэта + `assertRatio` допуск 0.10 для геометрических отношений; shading — не допуск, а перцентильные коридоры яркости p5∈[0.74,0.90], median∈[0.90,1.10], p95∈[1.02,1.20]).
|
- Пиксели (BufferedImage) — только в unit-тестах chart-пейнтеров, допуски 6–10% против эталона Word (`PiePainterTest` аспект h/w=0.585, `assertRatio` отклонение <0.06; `Surface3dPainterTest` `assertRange` ±6 pt для центров силуэта + `assertRatio` допуск 0.10 для геометрических отношений; shading — не допуск, а перцентильные коридоры яркости p5∈[0.74,0.90], median∈[0.90,1.10], p95∈[1.02,1.20]).
|
||||||
- Фикстуры — закоммиченные `samples/*.docx` (11; в тестах не генерировать): core грузит classpath-ресурсом → `byte[]`, PDF для PDFBox — временный файл; app читает `/samples/…` из **test-jar core** (classifier `tests`) → `mvn -pl wordpdf-app` без `-am` не соберётся. In-memory docx — `ZipOutputStream` из литеральных XML или POI в `byte[]`. Ключевые: `too-many-pages` (150 явных разрывов → 151), `stale-cache` (кэш `<Pages>1</Pages>` + 110 `lastRenderedPageBreak`), `charts-smartart` (4 растра; SmartArt-одиночка = ровно 2 Image XObject).
|
- Фикстуры — закоммиченные `samples/*.docx` (11; в тестах не генерировать): core грузит classpath-ресурсом → `byte[]`, PDF для PDFBox — временный файл; app читает `/samples/…` из **test-jar core** (classifier `tests`) → `mvn -pl wordpdf-app` без `-am` не соберётся. In-memory docx — `ZipOutputStream` из литеральных XML или POI в `byte[]`. Ключевые: `too-many-pages` (150 явных разрывов → 151), `stale-cache` (кэш `<Pages>1</Pages>` + 110 `lastRenderedPageBreak`), `charts-smartart` (4 растра; SmartArt-одиночка = ровно 2 Image XObject).
|
||||||
- Юниты нормализаторов работают строками (`rewrite`) + zip'ами из `ZipOutputStream`; обязательные контракты: «нечего менять → тот же массив» (`assertSame` покрыт тестами только у zip-нормализаторов `DocxOnOff`/`SymbolFont`/`StrictOoxml`; у `Field`/`GlyphCoverage` — `rewrite`→`null`) и неприкосновенность частей вне `word/*.xml` (`[Content_Types].xml`). Тесты бьют и в package-private API (`GlyphCoverageNormalizer.split(text, family)`, `pageCountOf`, `ChartSpec.readTitle`).
|
- Юниты нормализаторов работают строками (`rewrite`) + zip'ами из `ZipOutputStream`; обязательные контракты: «нечего менять → тот же массив» (`assertSame` покрыт тестами только у zip-нормализаторов `DocxOnOff`/`SymbolFont`/`StrictOoxml`; у `Field`/`GlyphCoverage` — `rewrite`→`null`) и неприкосновенность частей вне `word/*.xml` (`[Content_Types].xml`). Тесты бьют и в package-private API (`GlyphCoverageNormalizer.split(text, family)`, `ChartSpec.readTitle`).
|
||||||
- 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`, `WordPdfValidatorTest`↔`staleCachePageCountRejectedBeforeRender` (+`checkPageCountLightweight_agreesWithJaxbPath` 99/100/101, `pageCount_breaksInsideTablesAreCounted`, `pageCount_continuousSectionsNotCountedLightweight`), `BundledFontsTest`↔`ruPlain_emDashEmbeddedNotHelvetica`, `ChartSpecTest`↔автозаголовки, chart-пейнтеры↔`chartsSmartArt_drawingsBecomeImages` (+`drawingToggles_offRemovesRasters`/`drawingToggles_chartsOffSmartArtOn`); `noLoggingWarningInPdf` — регрессия `slf4j-simple`, `pdfTitle_comesFromParameter` — регрессия PDF-title (юнит-партнёра нет). App-регрессии: `requestLimitParams_areIgnored`, `nonPositiveLimits_failStartup`, `unknownPath_notFound`, `concurrentRequests_bothSucceed` (гонка реестра `PhysicalFonts`), `corruptNotAZip_rejected`, `junkInsideValidZip_conversionError`, `nonDocxFilename_rejected`, `oversizedOverCoreLimit_rejected`, `renderFlagsOff_convertsWithoutDrawings`, `cyrillicAndPathInFilename_sanitizedResponseName` (RFC 5987 + path-traversal), `docsOpenWithoutKey`/`forwardedPrefix_healthStaysOpen`/`forwardedPrefix_docsOpenWithoutKey` (открытая документация + матч фильтра без forwarded-contextPath).
|
- Регрессивные пары (фикс = нормализатор/pre-renderer + юнит + конвертер-тест с фикстурой): `StrictOoxmlNormalizerTest`↔`strictOoxml_convertsNotRejected` (+`pageCount_strictBreaksCountedLightweight` — lightweight против strict), `DocxOnOffNormalizerTest`↔`ruPlain_regularRunsUseRegularFont`, `SymbolFontNormalizerTest`↔`symbolFonts_bulletsAreNotHash`, `FieldNormalizerTest`↔`pageNumbers_recomputedNotCached`, `GlyphCoverageNormalizerTest`↔`exoticGlyphs_drawnNotHash`, `WordPdfValidatorTest`↔`staleCachePageCountRejectedBeforeRender` (+`checkPageCount_limitBoundary` 99/100/101, `pageCount_breaksInsideTablesAreCounted`, `pageCount_continuousSectionsNotCountedLightweight`, `validate_notAZip`↔`inputNotAZip_rejectedBeforeRender`), `BundledFontsTest`↔`ruPlain_emDashEmbeddedNotHelvetica`, `ChartSpecTest`↔автозаголовки, chart-пейнтеры↔`chartsSmartArt_drawingsBecomeImages` (+`drawingToggles_offRemovesRasters`/`drawingToggles_chartsOffSmartArtOn`); `noLoggingWarningInPdf` — регрессия `slf4j-simple`, `pdfTitle_comesFromParameter` — регрессия PDF-title (юнит-партнёра нет). App-регрессии: `requestLimitParams_areIgnored`, `nonPositiveLimits_failStartup`, `unknownPath_notFound`, `concurrentRequests_bothSucceed` (гонка реестра `PhysicalFonts`), `corruptNotAZip_rejected`, `junkInsideValidZip_conversionError`, `nonDocxFilename_rejected`, `oversizedOverCoreLimit_rejected`, `renderFlagsOff_convertsWithoutDrawings`, `cyrillicAndPathInFilename_sanitizedResponseName` (RFC 5987 + path-traversal), `docsOpenWithoutKey`/`forwardedPrefix_healthStaysOpen`/`forwardedPrefix_docsOpenWithoutKey` (открытая документация + матч фильтра без forwarded-contextPath).
|
||||||
- UI-тестов нет; гейт SPA — `npm run build` (tsc -b) + `npm run lint` (oxlint, `.oxlintrc.json`: rules-of-hooks error, only-export-components warn).
|
- UI-тестов нет; гейт SPA — `npm run build` (tsc -b) + `npm run lint` (oxlint, `.oxlintrc.json`: rules-of-hooks error, only-export-components warn).
|
||||||
|
|||||||
+2
-2
@@ -25,8 +25,8 @@ services:
|
|||||||
# лимиты входа (байты/страницы); значение из .env, иначе дефолты ядра;
|
# лимиты входа (байты/страницы); значение из .env, иначе дефолты ядра;
|
||||||
# интерполяция :- подставляет и на unset, и на пустое — пустая строка
|
# интерполяция :- подставляет и на unset, и на пустое — пустая строка
|
||||||
# сломала бы binding long/int
|
# сломала бы binding long/int
|
||||||
WORDPDF_MAX_BYTES: "${WORDPDF_MAX_BYTES:-20971520}"
|
WORDPDF_MAX_BYTES: "${WORDPDF_MAX_BYTES:-5242880}"
|
||||||
WORDPDF_MAX_PAGES: "${WORDPDF_MAX_PAGES:-1000}"
|
WORDPDF_MAX_PAGES: "${WORDPDF_MAX_PAGES:-100}"
|
||||||
web:
|
web:
|
||||||
build: ./wordpdf-web
|
build: ./wordpdf-web
|
||||||
restart: unless-stopped
|
restart: unless-stopped
|
||||||
|
|||||||
+1
-1
@@ -4,7 +4,7 @@ server {
|
|||||||
listen 80;
|
listen 80;
|
||||||
# потолок загрузки стека: больше не пропустит ни шлюз, ни Spring multipart;
|
# потолок загрузки стека: больше не пропустит ни шлюз, ни Spring multipart;
|
||||||
# авторитетный лимит — свойство wordpdf.max-bytes (env WORDPDF_MAX_BYTES,
|
# авторитетный лимит — свойство wordpdf.max-bytes (env WORDPDF_MAX_BYTES,
|
||||||
# дефолт 20 MiB). Без директивы upload режется HTML-413 от шлюза до бэкенда.
|
# дефолт 5 MiB). Без директивы upload режется HTML-413 от шлюза до бэкенда.
|
||||||
client_max_body_size 100m;
|
client_max_body_size 100m;
|
||||||
# app/web резолвятся aardvark-dns, который сидит на шлюзе сети стека
|
# app/web резолвятся aardvark-dns, который сидит на шлюзе сети стека
|
||||||
# (подсеть зафиксирована в compose.yml / compose.dev.yml, адрес стабилен).
|
# (подсеть зафиксирована в compose.yml / compose.dev.yml, адрес стабилен).
|
||||||
|
|||||||
@@ -10,14 +10,16 @@ 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.servlet.resource.NoResourceFoundException;
|
import org.springframework.web.servlet.resource.NoResourceFoundException;
|
||||||
|
import ru.pjandro.wordpdf.ValidationException;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Единый перевод исключений в JSON {@code {"error": "..."}} с кодом по смыслу.
|
* Единый перевод исключений в JSON {@code {"error": "..."}} с кодом по смыслу.
|
||||||
*
|
*
|
||||||
* <p>Голый {@code ru.pjandro.wordpdf.ConversionException} ядра сюда не доходит:
|
* <p>{@link ValidationException} ядра доходит сюда напрямую — валидатор
|
||||||
* контроллер и {@link ConversionService} превращают его на границе в
|
* бросает его сам; в {@link ConversionFailedException} превращается только
|
||||||
* {@link ValidationException}/{@link ConversionFailedException}; случайная
|
* прочий {@code ru.pjandro.wordpdf.ConversionException} рендер-стадии.
|
||||||
* утечка попадёт в обработчик {@link Exception} (500).</p>
|
* Случайная утечка прочего исключения попадёт в обработчик {@link Exception}
|
||||||
|
* (500).</p>
|
||||||
*/
|
*/
|
||||||
@RestControllerAdvice
|
@RestControllerAdvice
|
||||||
final class ApiExceptionHandler {
|
final class ApiExceptionHandler {
|
||||||
|
|||||||
@@ -4,8 +4,9 @@ package ru.pjandro.wordpdf.app;
|
|||||||
* Ошибка преобразования: контейнер .docx принят валидацией, но упал сам
|
* Ошибка преобразования: контейнер .docx принят валидацией, но упал сам
|
||||||
* рендер (ядро, FOP, повреждённое содержимое внутри валидного zip).
|
* рендер (ядро, FOP, повреждённое содержимое внутри валидного zip).
|
||||||
*
|
*
|
||||||
* <p>Смысл отличается от {@link ValidationException}: вход формально корректен,
|
* <p>Смысл отличается от {@code ru.pjandro.wordpdf.ValidationException}:
|
||||||
* отказал движок конвертации. Маппится в HTTP 500 ({@link ApiExceptionHandler}).</p>
|
* вход формально корректен, отказал движок конвертации.
|
||||||
|
* Маппится в HTTP 500 ({@link ApiExceptionHandler}).</p>
|
||||||
*
|
*
|
||||||
* <p>Регрессия — ConvertControllerTest#junkInsideValidZip_conversionError.</p>
|
* <p>Регрессия — ConvertControllerTest#junkInsideValidZip_conversionError.</p>
|
||||||
*/
|
*/
|
||||||
|
|||||||
@@ -8,6 +8,7 @@ import ru.pjandro.wordpdf.ConversionException;
|
|||||||
import ru.pjandro.wordpdf.DrawingFoundException;
|
import ru.pjandro.wordpdf.DrawingFoundException;
|
||||||
import ru.pjandro.wordpdf.WordPdfConverter;
|
import ru.pjandro.wordpdf.WordPdfConverter;
|
||||||
import ru.pjandro.wordpdf.WordPdfValidator;
|
import ru.pjandro.wordpdf.WordPdfValidator;
|
||||||
|
import ru.pjandro.wordpdf.ValidationException;
|
||||||
|
|
||||||
import java.time.Duration;
|
import java.time.Duration;
|
||||||
import java.util.Locale;
|
import java.util.Locale;
|
||||||
@@ -34,9 +35,10 @@ import java.util.concurrent.TimeoutException;
|
|||||||
* {@link ValidationException} (400), ошибка рендер-стадии →
|
* {@link ValidationException} (400), ошибка рендер-стадии →
|
||||||
* {@link ConversionFailedException} (500). Граница: сломанный контейнер
|
* {@link ConversionFailedException} (500). Граница: сломанный контейнер
|
||||||
* (не zip / битый zip / слишком большой / слишком длинный) — 400; валидный
|
* (не zip / битый zip / слишком большой / слишком длинный) — 400; валидный
|
||||||
* zip с мусором внутри (нет {@code word/document.xml}) — 500: lightweight-
|
* zip с мусором внутри (нет {@code word/document.xml}) — 500: до очереди и
|
||||||
* подсчёт страниц согласован с JAXB-путём ядра (может только завышать),
|
* в конвейере ядра вход проверяется тем же
|
||||||
* поэтому уже принятый запрос внутренняя проверка ядра в ошибку не превратит.</p>
|
* {@link WordPdfValidator#validate(byte[], ConvertOptions)}, поэтому уже
|
||||||
|
* принятый запрос внутренняя проверка ядра в ошибку не превратит.</p>
|
||||||
*/
|
*/
|
||||||
@Service
|
@Service
|
||||||
final class ConversionService {
|
final class ConversionService {
|
||||||
@@ -68,7 +70,7 @@ final class ConversionService {
|
|||||||
* {@code null} не допускается (контроллер строит всегда).</p>
|
* {@code null} не допускается (контроллер строит всегда).</p>
|
||||||
*/
|
*/
|
||||||
byte[] convert(byte[] docxBytes, String originalFilename, ConvertOptions options) {
|
byte[] convert(byte[] docxBytes, String originalFilename, ConvertOptions options) {
|
||||||
validate(docxBytes, options);
|
WordPdfValidator.validate(docxBytes, options);
|
||||||
Future<byte[]> future;
|
Future<byte[]> future;
|
||||||
try {
|
try {
|
||||||
future = workers.submit(() -> doConvert(docxBytes, originalFilename, options));
|
future = workers.submit(() -> doConvert(docxBytes, originalFilename, options));
|
||||||
@@ -110,36 +112,6 @@ final class ConversionService {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
|
||||||
* Валидация байтов переиспользует публичные byte-API ядра. Порядок значим:
|
|
||||||
* размер (дешёвая) → magic bytes → lightweight-разбор zip. Лимиты
|
|
||||||
* размера/страниц берутся из {@code options} (контроллер подставляет их
|
|
||||||
* из конфигурации сервера: свойства {@code wordpdf.max-bytes}/
|
|
||||||
* {@code wordpdf.max-pages}, дефолт — константы ядра).
|
|
||||||
*
|
|
||||||
* <p>Проверка zip-подписи отдельным шагом обязательна:
|
|
||||||
* {@code ZipInputStream.getNextEntry()} на не-zip-потоке возвращает
|
|
||||||
* {@code null} молча, и {@link WordPdfValidator#checkPageCountLightweight(byte[])}
|
|
||||||
* такой вход не отверг бы (0 страниц). Регрессия —
|
|
||||||
* ConvertControllerTest#corruptNotAZip_rejected.</p>
|
|
||||||
*/
|
|
||||||
void validate(byte[] docxBytes, ConvertOptions options) {
|
|
||||||
try {
|
|
||||||
WordPdfValidator.checkInput(docxBytes, options.maxBytes());
|
|
||||||
} catch (ConversionException e) {
|
|
||||||
throw new ValidationException(e.getMessage(), e);
|
|
||||||
}
|
|
||||||
if (docxBytes.length < 4 || docxBytes[0] != 'P' || docxBytes[1] != 'K'
|
|
||||||
|| (docxBytes[2] & 0xFF) != 0x03 || (docxBytes[3] & 0xFF) != 0x04) {
|
|
||||||
throw new ValidationException("Содержимое не похоже на .docx (не zip-архив)");
|
|
||||||
}
|
|
||||||
try {
|
|
||||||
WordPdfValidator.checkPageCountLightweight(docxBytes, options.maxPages());
|
|
||||||
} catch (ConversionException e) {
|
|
||||||
throw new ValidationException(e.getMessage(), e);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Тело задачи воркера. Ядро принимает байты — временные файлы не нужны;
|
* Тело задачи воркера. Ядро принимает байты — временные файлы не нужны;
|
||||||
* имя влияет только на заголовок PDF (параметр {@code title}), потому
|
* имя влияет только на заголовок PDF (параметр {@code title}), потому
|
||||||
@@ -149,6 +121,10 @@ final class ConversionService {
|
|||||||
try {
|
try {
|
||||||
// заголовок PDF — санитизированный base исходного имени
|
// заголовок PDF — санитизированный base исходного имени
|
||||||
return WordPdfConverter.convert(docxBytes, safeBaseName(originalFilename), options);
|
return WordPdfConverter.convert(docxBytes, safeBaseName(originalFilename), options);
|
||||||
|
} catch (ValidationException e) {
|
||||||
|
// отказ проверки страниц внутри конвейера ядра — некорректный
|
||||||
|
// вход (400), а не ошибка рендера: без этого утонул бы в 500
|
||||||
|
throw e;
|
||||||
} catch (DrawingFoundException e) {
|
} catch (DrawingFoundException e) {
|
||||||
// отказ по настройке запроса (error-флаг) — не ошибка рендера: 422,
|
// отказ по настройке запроса (error-флаг) — не ошибка рендера: 422,
|
||||||
// иначе утонет в общем catch ниже как 500
|
// иначе утонет в общем catch ниже как 500
|
||||||
|
|||||||
@@ -13,6 +13,7 @@ import org.springframework.beans.factory.annotation.Value;
|
|||||||
import org.springframework.web.multipart.MultipartFile;
|
import org.springframework.web.multipart.MultipartFile;
|
||||||
import ru.pjandro.wordpdf.ConvertOptions;
|
import ru.pjandro.wordpdf.ConvertOptions;
|
||||||
import ru.pjandro.wordpdf.WordPdfSettings;
|
import ru.pjandro.wordpdf.WordPdfSettings;
|
||||||
|
import ru.pjandro.wordpdf.ValidationException;
|
||||||
|
|
||||||
import java.io.IOException;
|
import java.io.IOException;
|
||||||
import java.nio.charset.StandardCharsets;
|
import java.nio.charset.StandardCharsets;
|
||||||
|
|||||||
@@ -1,23 +0,0 @@
|
|||||||
package ru.pjandro.wordpdf.app;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Некорректный вход: пустой файл, не .docx, не zip-архив, размер или число
|
|
||||||
* страниц сверх переданных в запросе (или дефолтных) лимитов.
|
|
||||||
*
|
|
||||||
* <p>Отличается от {@link ConversionFailedException} смыслом: запрос
|
|
||||||
* некорректен сам по себе, повтор его же ничего не изменит. Маппится в HTTP 400
|
|
||||||
* ({@link ApiExceptionHandler}).</p>
|
|
||||||
*
|
|
||||||
* <p>Регрессия — ConvertControllerTest#nonDocxFilename_rejected,
|
|
||||||
* #oversizedOverCoreLimit_rejected, #corruptNotAZip_rejected.</p>
|
|
||||||
*/
|
|
||||||
class ValidationException extends RuntimeException {
|
|
||||||
|
|
||||||
ValidationException(String message) {
|
|
||||||
super(message);
|
|
||||||
}
|
|
||||||
|
|
||||||
ValidationException(String message, Throwable cause) {
|
|
||||||
super(message, cause);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -2,9 +2,9 @@ spring.application.name=wordpdf-app
|
|||||||
# Потолок инфраструктуры — 100 МБ (совпадает с client_max_body_size в
|
# Потолок инфраструктуры — 100 МБ (совпадает с client_max_body_size в
|
||||||
# nginx-шлюзах): больше не пропустит ни шлюз, ни контейнер. Авторитетный
|
# nginx-шлюзах): больше не пропустит ни шлюз, ни контейнер. Авторитетный
|
||||||
# лимит — свойство wordpdf.max-bytes (env WORDPDF_MAX_BYTES), по умолчанию
|
# лимит — свойство wordpdf.max-bytes (env WORDPDF_MAX_BYTES), по умолчанию
|
||||||
# WordPdfSettings.MAX_INPUT_BYTES = 20 MiB; здесь только потолок загрузки.
|
# WordPdfSettings.MAX_INPUT_BYTES = 5 MiB; здесь только потолок загрузки.
|
||||||
# Лимиты входа: env WORDPDF_MAX_BYTES (байты) / WORDPDF_MAX_PAGES (страницы),
|
# Лимиты входа: env WORDPDF_MAX_BYTES (байты) / WORDPDF_MAX_PAGES (страницы),
|
||||||
# дефолты — константы ядра (20 MiB / 1000), задаются ConvertController.
|
# дефолты — константы ядра (5 MiB / 100), задаются ConvertController.
|
||||||
# Значение <= 0 — падение на старте. Сами ключи здесь не объявлены:
|
# Значение <= 0 — падение на старте. Сами ключи здесь не объявлены:
|
||||||
# пустое значение затенит SpEL-дефолт @Value.
|
# пустое значение затенит SpEL-дефолт @Value.
|
||||||
# file-size-threshold=100MB держит файл в памяти (ядро и так читает всё в RAM).
|
# file-size-threshold=100MB держит файл в памяти (ядро и так читает всё в RAM).
|
||||||
|
|||||||
@@ -252,14 +252,14 @@ class ConvertControllerTest {
|
|||||||
|
|
||||||
@Test
|
@Test
|
||||||
void oversizedOverCoreLimit_rejected() throws Exception {
|
void oversizedOverCoreLimit_rejected() throws Exception {
|
||||||
// 20 MiB + 1 байт: проходит контейнерный multipart-лимит (100 МБ)
|
// 5 MiB + 1 байт: проходит контейнерный multipart-лимит (100 МБ)
|
||||||
// и отсекается валидацией ядра до очереди (дефолт ядра цел —
|
// и отсекается валидацией ядра до очереди (дефолт ядра цел —
|
||||||
// лимит задаёт только конфигурация сервера)
|
// лимит задаёт только конфигурация сервера)
|
||||||
byte[] big = new byte[20 * 1024 * 1024 + 1];
|
byte[] big = new byte[5 * 1024 * 1024 + 1];
|
||||||
mockMvc.perform(multipart("/api/v1/convert").file(docx("big.docx", big)))
|
mockMvc.perform(multipart("/api/v1/convert").file(docx("big.docx", big)))
|
||||||
.andExpect(status().isBadRequest())
|
.andExpect(status().isBadRequest())
|
||||||
.andExpect(jsonPath("$.error",
|
.andExpect(jsonPath("$.error",
|
||||||
org.hamcrest.Matchers.containsString("больше 20 МБ")));
|
org.hamcrest.Matchers.containsString("больше 5 МБ")));
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
|
|||||||
@@ -0,0 +1,22 @@
|
|||||||
|
package ru.pjandro.wordpdf;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Некорректный вход: {@code null}-байты, размер или число страниц сверх
|
||||||
|
* лимитов, неразбираемый .docx-контейнер (не zip / битый XML).
|
||||||
|
*
|
||||||
|
* <p>Отличается от прочего {@link ConversionException} смыслом: вход плох сам
|
||||||
|
* по себе, повтор с теми же байтами ничего не изменит. Наследник
|
||||||
|
* {@code ConversionException} — наружу по-прежнему ловится только он
|
||||||
|
* (в т.ч. из {@link WordPdfConverter}, который вызывает валидатор сам).
|
||||||
|
* Регрессия — WordPdfValidatorTest, ConvertControllerTest#corruptNotAZip_rejected.</p>
|
||||||
|
*/
|
||||||
|
public class ValidationException extends ConversionException {
|
||||||
|
|
||||||
|
public ValidationException(String message) {
|
||||||
|
super(message);
|
||||||
|
}
|
||||||
|
|
||||||
|
public ValidationException(String message, Throwable cause) {
|
||||||
|
super(message, cause);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -57,16 +57,18 @@ public final class WordPdfConverter {
|
|||||||
* Конвертирует байты .docx в PDF. Работа с файлами — забота вызывающего
|
* Конвертирует байты .docx в PDF. Работа с файлами — забота вызывающего
|
||||||
* (файловое API было здесь раньше; ядро пути не принимает).
|
* (файловое API было здесь раньше; ядро пути не принимает).
|
||||||
*
|
*
|
||||||
* <p>Вход проверяется валидатором до рендера: {@link WordPdfValidator#checkInput(byte[])}
|
* <p>Вход проверяется {@link WordPdfValidator#validate(byte[], ConvertOptions)} до рендера:
|
||||||
* (null / больше {@link WordPdfSettings#MAX_INPUT_BYTES}), затем число страниц
|
* {@code null} / размер больше {@link WordPdfSettings#MAX_INPUT_BYTES} / zip-подпись /
|
||||||
* ({@link WordPdfSettings#MAX_PAGES}) — при отказе байтов результата нет.
|
* число страниц больше {@link WordPdfSettings#MAX_PAGES} — при отказе байтов результата нет;
|
||||||
|
* страницы дополнительно перепроверяются по нормализованным байтам (шаг 2.5).
|
||||||
*
|
*
|
||||||
* @param docxBytes байты .docx
|
* @param docxBytes байты .docx
|
||||||
* @param title заголовок PDF (метаданные); {@code null}/пустая — заголовок не задаётся
|
* @param title заголовок PDF (метаданные); {@code null}/пустая — заголовок не задаётся
|
||||||
* @return байты готового PDF
|
* @return байты готового PDF
|
||||||
* @throws ConversionException при ошибке (битый .docx, размер больше
|
* @throws ValidationException некорректный вход: {@code null}, размер больше
|
||||||
* {@link WordPdfSettings#MAX_INPUT_BYTES}, результат длиннее
|
* {@link WordPdfSettings#MAX_INPUT_BYTES}, не zip-архив, документ длиннее
|
||||||
* {@link WordPdfSettings#MAX_PAGES} страниц и т.п.)
|
* {@link WordPdfSettings#MAX_PAGES} страниц
|
||||||
|
* @throws ConversionException прочие ошибки (битый .docx, ошибка рендера)
|
||||||
*/
|
*/
|
||||||
public static byte[] convert(byte[] docxBytes, String title) throws ConversionException {
|
public static byte[] convert(byte[] docxBytes, String title) throws ConversionException {
|
||||||
return convert(docxBytes, title, ConvertOptions.defaults());
|
return convert(docxBytes, title, ConvertOptions.defaults());
|
||||||
@@ -76,26 +78,30 @@ public final class WordPdfConverter {
|
|||||||
* Конвертирует байты .docx в PDF с настройками на вызов: рисование
|
* Конвертирует байты .docx в PDF с настройками на вызов: рисование
|
||||||
* диаграмм/SmartArt и лимиты входа.
|
* диаграмм/SmartArt и лимиты входа.
|
||||||
*
|
*
|
||||||
* <p>Вход проверяется валидатором до рендера: {@link WordPdfValidator#checkInput(byte[], long)}
|
* <p>Вход проверяется {@link WordPdfValidator#validate(byte[], ConvertOptions)} до рендера:
|
||||||
* (null / больше {@code options.maxBytes()}), затем число страниц
|
* {@code null} / размер больше {@code options.maxBytes()} / zip-подпись / число страниц
|
||||||
* ({@code options.maxPages()}) — при отказе байтов результата нет.
|
* больше {@code options.maxPages()} — при отказе байтов результата нет; страницы
|
||||||
|
* дополнительно перепроверяются по нормализованным байтам (шаг 2.5).
|
||||||
*
|
*
|
||||||
* @param docxBytes байты .docx
|
* @param docxBytes байты .docx
|
||||||
* @param title заголовок PDF (метаданные); {@code null}/пустая — заголовок не задаётся
|
* @param title заголовок PDF (метаданные); {@code null}/пустая — заголовок не задаётся
|
||||||
* @param options рисование и лимиты входа на этот вызов; {@code null} —
|
* @param options рисование и лимиты входа на этот вызов; {@code null} —
|
||||||
* дефолты (константы {@link WordPdfSettings})
|
* дефолты (константы {@link WordPdfSettings})
|
||||||
* @return байты готового PDF
|
* @return байты готового PDF
|
||||||
* @throws ConversionException при ошибке (битый .docx, размер больше
|
* @throws ValidationException некорректный вход: {@code null}, размер больше
|
||||||
* {@code options.maxBytes()}, результат длиннее
|
* {@code options.maxBytes()}, не zip-архив, документ длиннее
|
||||||
* {@code options.maxPages()} страниц и т.п.)
|
* {@code options.maxPages()} страниц
|
||||||
|
* @throws ConversionException прочие ошибки (битый .docx, ошибка рендера)
|
||||||
*/
|
*/
|
||||||
public static byte[] convert(byte[] docxBytes, String title, ConvertOptions options) throws ConversionException {
|
public static byte[] convert(byte[] docxBytes, String title, ConvertOptions options) throws ConversionException {
|
||||||
ConvertOptions opts = options == null ? ConvertOptions.defaults() : options;
|
ConvertOptions opts = options == null ? ConvertOptions.defaults() : options;
|
||||||
WordPdfValidator.checkInput(docxBytes, opts.maxBytes());
|
WordPdfValidator.validate(docxBytes, opts);
|
||||||
ByteArrayOutputStream bos = new ByteArrayOutputStream();
|
ByteArrayOutputStream bos = new ByteArrayOutputStream();
|
||||||
try {
|
try {
|
||||||
convertToStream(docxBytes, title, opts, bos);
|
convertToStream(docxBytes, title, opts, bos);
|
||||||
} catch (ConversionException e) {
|
} catch (ConversionException e) {
|
||||||
|
// ValidationException (отказ валидации входа) — подтип, уходит
|
||||||
|
// вызывающему без обёртки
|
||||||
throw e;
|
throw e;
|
||||||
} catch (Exception e) {
|
} catch (Exception e) {
|
||||||
throw new ConversionException("Не удалось конвертировать документ", e);
|
throw new ConversionException("Не удалось конвертировать документ", e);
|
||||||
@@ -139,12 +145,13 @@ public final class WordPdfConverter {
|
|||||||
WordprocessingMLPackage pkg = WordprocessingMLPackage.load(
|
WordprocessingMLPackage pkg = WordprocessingMLPackage.load(
|
||||||
new ByteArrayInputStream(docxBytes));
|
new ByteArrayInputStream(docxBytes));
|
||||||
try {
|
try {
|
||||||
// 2.5 Проверка числа страниц по самому .docx: кэш Word
|
// 2.5 Проверка числа страниц по самому .docx: lightweight-оценка
|
||||||
// (docProps/app.xml <Pages>) или нижняя оценка по явным
|
// по zip (кэш docProps/app.xml <Pages>, явные разрывы, маркеры
|
||||||
// разрывам. Делается до рендера, чтобы не тратить время на
|
// w:lastRenderedPageBreak, включая колонтитулы) — без JAXB-модели.
|
||||||
// заведомо длинный документ; внутри try — чтобы и на отказе
|
// Делается до рендера, чтобы не тратить время на заведомо
|
||||||
// отработал finally с чисткой temp-файлов встроенных шрифтов.
|
// длинный документ; внутри try — чтобы и на отказе отработал
|
||||||
WordPdfValidator.checkPageCount(pkg, options.maxPages());
|
// finally с чисткой temp-файлов встроенных шрифтов.
|
||||||
|
WordPdfValidator.checkPageCount(docxBytes, options.maxPages());
|
||||||
// 3. Привязка маппера: docx4j сопоставляет шрифты документа
|
// 3. Привязка маппера: docx4j сопоставляет шрифты документа
|
||||||
// с физическими TTF (учитывая и шрифты, встроенные в docx)
|
// с физическими TTF (учитывая и шрифты, встроенные в docx)
|
||||||
pkg.setFontMapper(mapper);
|
pkg.setFontMapper(mapper);
|
||||||
|
|||||||
@@ -9,11 +9,11 @@ package ru.pjandro.wordpdf;
|
|||||||
*/
|
*/
|
||||||
public final class WordPdfSettings {
|
public final class WordPdfSettings {
|
||||||
|
|
||||||
/** Максимальный размер входного .docx (дефолт). 20 MiB = 20 × 1024 × 1024. */
|
/** Максимальный размер входного .docx (дефолт). 5 MiB = 5 × 1024 × 1024. */
|
||||||
public static final long MAX_INPUT_BYTES = 20L * 1024 * 1024;
|
public static final long MAX_INPUT_BYTES = 5L * 1024 * 1024;
|
||||||
|
|
||||||
/** Документ длиннее — ошибка (дефолт). */
|
/** Документ длиннее — ошибка (дефолт). */
|
||||||
public static final int MAX_PAGES = 1000;
|
public static final int MAX_PAGES = 100;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Генерация диаграмм (c:chart → PNG, chart-движок). {@code false} — диаграммы
|
* Генерация диаграмм (c:chart → PNG, chart-движок). {@code false} — диаграммы
|
||||||
|
|||||||
@@ -1,15 +1,5 @@
|
|||||||
package ru.pjandro.wordpdf;
|
package ru.pjandro.wordpdf;
|
||||||
|
|
||||||
import org.docx4j.openpackaging.packages.WordprocessingMLPackage;
|
|
||||||
import org.docx4j.wml.Br;
|
|
||||||
import org.docx4j.wml.ContentAccessor;
|
|
||||||
import org.docx4j.wml.P;
|
|
||||||
import org.docx4j.wml.R;
|
|
||||||
import org.docx4j.wml.SectPr;
|
|
||||||
import org.docx4j.wml.STBrType;
|
|
||||||
|
|
||||||
import jakarta.xml.bind.JAXBElement;
|
|
||||||
|
|
||||||
import javax.xml.stream.XMLInputFactory;
|
import javax.xml.stream.XMLInputFactory;
|
||||||
import javax.xml.stream.XMLStreamException;
|
import javax.xml.stream.XMLStreamException;
|
||||||
import javax.xml.stream.XMLStreamReader;
|
import javax.xml.stream.XMLStreamReader;
|
||||||
@@ -27,9 +17,8 @@ import java.util.zip.ZipInputStream;
|
|||||||
* Валидатор ограничений на входной .docx:
|
* Валидатор ограничений на входной .docx:
|
||||||
* размер входа и число страниц.
|
* размер входа и число страниц.
|
||||||
*
|
*
|
||||||
* <p>Вход валидатора — только {@code byte[]} (или уже загруженный
|
* <p>Вход валидатора — только {@code byte[]}: файловых проверок нет,
|
||||||
* {@link WordprocessingMLPackage}): файловых проверок нет, работа с
|
* работа с файлами — забота вызывающего (приложения).
|
||||||
* файлами — забота вызывающего (приложения).
|
|
||||||
*
|
*
|
||||||
* <p>Конвертер {@link WordPdfConverter} вызывает валидатор автоматически,
|
* <p>Конвертер {@link WordPdfConverter} вызывает валидатор автоматически,
|
||||||
* но им можно пользоваться и напрямую — например, проверить байты
|
* но им можно пользоваться и напрямую — например, проверить байты
|
||||||
@@ -55,7 +44,7 @@ import java.util.zip.ZipInputStream;
|
|||||||
* <p>Проверка делается <b>до</b> рендера — это позволяет отсекать слишком
|
* <p>Проверка делается <b>до</b> рендера — это позволяет отсекать слишком
|
||||||
* длинные документы, не тратя время на конвертацию.
|
* длинные документы, не тратя время на конвертацию.
|
||||||
*
|
*
|
||||||
* <p>Все ошибки — {@link ConversionException}.
|
* <p>Все ошибки — {@link ValidationException} (наследник {@link ConversionException}).
|
||||||
*/
|
*/
|
||||||
public final class WordPdfValidator {
|
public final class WordPdfValidator {
|
||||||
|
|
||||||
@@ -65,9 +54,9 @@ public final class WordPdfValidator {
|
|||||||
/**
|
/**
|
||||||
* Проверяет размер байтов входа (для документа, полученного из сети/БД).
|
* Проверяет размер байтов входа (для документа, полученного из сети/БД).
|
||||||
*
|
*
|
||||||
* @throws ConversionException при {@code null} или превышении лимита
|
* @throws ValidationException при {@code null} или превышении лимита
|
||||||
*/
|
*/
|
||||||
public static void checkInput(byte[] docxBytes) throws ConversionException {
|
public static void checkInput(byte[] docxBytes) throws ValidationException {
|
||||||
checkInput(docxBytes, WordPdfSettings.MAX_INPUT_BYTES);
|
checkInput(docxBytes, WordPdfSettings.MAX_INPUT_BYTES);
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -75,18 +64,18 @@ public final class WordPdfValidator {
|
|||||||
* Проверяет размер байтов входа против явного лимита (переопределение
|
* Проверяет размер байтов входа против явного лимита (переопределение
|
||||||
* на вызов, см. {@link ConvertOptions#maxBytes()}).
|
* на вызов, см. {@link ConvertOptions#maxBytes()}).
|
||||||
*
|
*
|
||||||
* @throws ConversionException при {@code null} или превышении {@code maxBytes}
|
* @throws ValidationException при {@code null} или превышении {@code maxBytes}
|
||||||
*/
|
*/
|
||||||
public static void checkInput(byte[] docxBytes, long maxBytes) throws ConversionException {
|
public static void checkInput(byte[] docxBytes, long maxBytes) throws ValidationException {
|
||||||
if (docxBytes == null) {
|
if (docxBytes == null) {
|
||||||
throw new ConversionException("Не указаны байты входного файла");
|
throw new ValidationException("Не указаны байты входного файла");
|
||||||
}
|
}
|
||||||
if (docxBytes.length > maxBytes) {
|
if (docxBytes.length > maxBytes) {
|
||||||
// дефолтный лимит кратен MiB — сообщение остаётся «... 20 МБ ...»
|
// дефолтный лимит кратен MiB — сообщение остаётся «... 5 МБ ...»
|
||||||
String limit = maxBytes % (1024 * 1024) == 0
|
String limit = maxBytes % (1024 * 1024) == 0
|
||||||
? (maxBytes / (1024 * 1024)) + " МБ"
|
? (maxBytes / (1024 * 1024)) + " МБ"
|
||||||
: maxBytes + " байт";
|
: maxBytes + " байт";
|
||||||
throw new ConversionException("Файл больше " + limit
|
throw new ValidationException("Файл больше " + limit
|
||||||
+ ": " + docxBytes.length + " байт > " + maxBytes + " байт");
|
+ ": " + docxBytes.length + " байт > " + maxBytes + " байт");
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -98,32 +87,41 @@ public final class WordPdfValidator {
|
|||||||
* {@code docProps/app.xml}). Дешёвый путь для проверки байтов из
|
* {@code docProps/app.xml}). Дешёвый путь для проверки байтов из
|
||||||
* сети/БД до любой работы с библиотекой.
|
* сети/БД до любой работы с библиотекой.
|
||||||
*
|
*
|
||||||
* <p>Оценка согласована с {@link #checkPageCount(WordprocessingMLPackage)}
|
* <p>Оценка — максимум трёх нижних оценок: кэша Word в
|
||||||
* по всем источникам; на границе лимита оба пути дают одинаковый ответ
|
* {@code docProps/app.xml} ({@code <Pages>}; сам по себе недостоверен —
|
||||||
* (регрессия — {@code checkPageCountLightweight_agreesWithJaxbPath},
|
* в регрессной фикстуре {@code stale-cache.docx} равен 1 при 110
|
||||||
* включая 99/100/101 разрывов). Lightweight-путь дополнительно считает
|
* границах страниц), явных разрывов ({@code w:br type="page"},
|
||||||
* разрывы в колонтитулах — он консервативнее, расхождение возможно
|
* {@code w:pageBreakBefore}, межсекционные {@code w:sectPr} — абзацы
|
||||||
|
* ищутся рекурсивно, включая ячейки таблиц и контентные контролы
|
||||||
|
* {@code w:sdt}) и маркеров {@code w:lastRenderedPageBreak} — границ
|
||||||
|
* страниц, которые Word записал при последнем рендере. Оценка нижняя:
|
||||||
|
* документ без явных разрывов и без маркеров (никогда не открывался в
|
||||||
|
* Word) оценивается в 1 страницу независимо от фактической длины —
|
||||||
|
* такие документы лимит не отсекают. На границе лимита оценка точна
|
||||||
|
* (регрессия — {@code checkPageCount_limitBoundary},
|
||||||
|
* включая 99/100/101 разрывов); путь дополнительно считает разрывы в
|
||||||
|
* колонтитулах — консервативная нижняя оценка, расхождение возможно
|
||||||
* только в сторону завышения.
|
* только в сторону завышения.
|
||||||
*
|
*
|
||||||
* <p>Не-zip байты не отвергаются: {@code ZipInputStream} доходит до EOF
|
* <p>Не-zip байты не отвергаются: {@code ZipInputStream} доходит до EOF
|
||||||
* без единой записи — молча, оценка «1 страница». Корректность контейнера
|
* без единой записи — молча, оценка «1 страница». Корректность контейнера
|
||||||
* проверяет вызывающий по zip-подписи ({@code ConversionService.validate}
|
* по zip-подписи проверяет {@link #validate(byte[], ConvertOptions)}
|
||||||
* в приложении; регрессия — {@code ConvertControllerTest#corruptNotAZip_rejected}).
|
* (регрессия — {@code WordPdfValidatorTest#validate_notAZip}).
|
||||||
* @throws ConversionException при {@code null}, ошибке разбора zip или превышении {@link WordPdfSettings#MAX_PAGES}
|
* @throws ValidationException при {@code null}, ошибке разбора zip или превышении {@link WordPdfSettings#MAX_PAGES}
|
||||||
*/
|
*/
|
||||||
public static void checkPageCountLightweight(byte[] docxBytes) throws ConversionException {
|
public static void checkPageCount(byte[] docxBytes) throws ValidationException {
|
||||||
checkPageCountLightweight(docxBytes, WordPdfSettings.MAX_PAGES);
|
checkPageCount(docxBytes, WordPdfSettings.MAX_PAGES);
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* То же, что {@link #checkPageCountLightweight(byte[])}, с явным лимитом
|
* То же, что {@link #checkPageCount(byte[])}, с явным лимитом
|
||||||
* страниц (переопределение на вызов, см. {@link ConvertOptions#maxPages()}).
|
* страниц (переопределение на вызов, см. {@link ConvertOptions#maxPages()}).
|
||||||
*
|
*
|
||||||
* @throws ConversionException при {@code null}, ошибке разбора zip или превышении {@code maxPages}
|
* @throws ValidationException при {@code null}, ошибке разбора zip или превышении {@code maxPages}
|
||||||
*/
|
*/
|
||||||
public static void checkPageCountLightweight(byte[] docxBytes, int maxPages) throws ConversionException {
|
public static void checkPageCount(byte[] docxBytes, int maxPages) throws ValidationException {
|
||||||
if (docxBytes == null) {
|
if (docxBytes == null) {
|
||||||
throw new ConversionException("Не указаны байты входного .docx");
|
throw new ValidationException("Не указаны байты входного .docx");
|
||||||
}
|
}
|
||||||
int pages;
|
int pages;
|
||||||
try (ZipInputStream zip = new ZipInputStream(new ByteArrayInputStream(docxBytes))) {
|
try (ZipInputStream zip = new ZipInputStream(new ByteArrayInputStream(docxBytes))) {
|
||||||
@@ -145,194 +143,37 @@ public final class WordPdfValidator {
|
|||||||
return b == null ? null : new ByteArrayInputStream(b);
|
return b == null ? null : new ByteArrayInputStream(b);
|
||||||
}, headerFooter);
|
}, headerFooter);
|
||||||
} catch (IOException | RuntimeException e) {
|
} catch (IOException | RuntimeException e) {
|
||||||
throw new ConversionException("Не удалось разобрать байты .docx", e);
|
throw new ValidationException("Не удалось разобрать байты .docx", e);
|
||||||
}
|
}
|
||||||
if (pages > maxPages) {
|
if (pages > maxPages) {
|
||||||
throw new ConversionException("Документ длиннее " + maxPages
|
throw new ValidationException("Документ длиннее " + maxPages
|
||||||
+ " страниц: получено не менее " + pages);
|
+ " страниц: получено не менее " + pages);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Считает страницы .docx в байтах и проверяет лимит.
|
* Полная проверка входа: размер → zip-подпись → число страниц. Порядок
|
||||||
|
* значим: размер — дешёвая, разбор zip без подписи бессмысленен. Лимиты
|
||||||
|
* берутся из {@link ConvertOptions} (переопределение на вызов, см.
|
||||||
|
* {@link ConvertOptions#maxBytes()}, {@link ConvertOptions#maxPages()}).
|
||||||
*
|
*
|
||||||
* @throws ConversionException при {@code null}, ошибке загрузки или превышении лимита
|
* <p>Проверка zip-подписи отдельным шагом обязательна:
|
||||||
*/
|
* {@code ZipInputStream.getNextEntry()} на не-zip-потоке возвращает
|
||||||
public static void checkPageCount(byte[] docxBytes) throws ConversionException {
|
* {@code null} молча, и {@link #checkPageCount(byte[], int)} такой вход
|
||||||
checkPageCount(docxBytes, WordPdfSettings.MAX_PAGES);
|
* не отверг бы (оценка «1 страница»). Регрессия —
|
||||||
}
|
* {@code WordPdfValidatorTest#validate_notAZip} (на HTTP-границе —
|
||||||
|
* {@code ConvertControllerTest#corruptNotAZip_rejected}).</p>
|
||||||
/**
|
|
||||||
* То же, что {@link #checkPageCount(byte[])}, с явным лимитом страниц
|
|
||||||
* (переопределение на вызов, см. {@link ConvertOptions#maxPages()}).
|
|
||||||
*
|
*
|
||||||
* @throws ConversionException при {@code null}, ошибке загрузки или
|
* @throws ValidationException при {@code null}, превышении {@code options.maxBytes()},
|
||||||
* превышении {@code maxPages}
|
* отсутствии zip-подписи, ошибке разбора zip или превышении {@code options.maxPages()}
|
||||||
*/
|
*/
|
||||||
public static void checkPageCount(byte[] docxBytes, int maxPages) throws ConversionException {
|
public static void validate(byte[] docxBytes, ConvertOptions options) throws ValidationException {
|
||||||
if (docxBytes == null) {
|
checkInput(docxBytes, options.maxBytes());
|
||||||
throw new ConversionException("Не указаны байты входного .docx");
|
if (docxBytes.length < 4 || docxBytes[0] != 'P' || docxBytes[1] != 'K'
|
||||||
|
|| (docxBytes[2] & 0xFF) != 0x03 || (docxBytes[3] & 0xFF) != 0x04) {
|
||||||
|
throw new ValidationException("Содержимое не похоже на .docx (не zip-архив)");
|
||||||
}
|
}
|
||||||
WordprocessingMLPackage pkg;
|
checkPageCount(docxBytes, options.maxPages());
|
||||||
try {
|
|
||||||
pkg = WordprocessingMLPackage.load(new ByteArrayInputStream(docxBytes));
|
|
||||||
} catch (Exception e) {
|
|
||||||
throw new ConversionException("Не удалось разобрать байты .docx", e);
|
|
||||||
}
|
|
||||||
checkPageCount(pkg, maxPages);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Считает страницы уже загруженного .docx и проверяет лимит.
|
|
||||||
*
|
|
||||||
* <p>Число страниц — максимум трёх нижних оценок:
|
|
||||||
* <ol>
|
|
||||||
* <li>Кэш Word в {@code docProps/app.xml} ({@code <Pages>}).
|
|
||||||
* Сам по себе недостоверен: Word может сохранить устаревшее
|
|
||||||
* значение (в регрессной фикстуре {@code stale-cache.docx}
|
|
||||||
* кэш равен 1 при 110 границах страниц).</li>
|
|
||||||
* <li>Явные разрывы: {@code w:br[@w:type='page']},
|
|
||||||
* {@code w:pageBreakBefore} и {@code w:sectPr} прямо в
|
|
||||||
* {@code w:body}. Абзацы ищутся не только прямо в {@code w:body},
|
|
||||||
* но и внутри таблиц, контентных контролов {@code w:sdt}
|
|
||||||
* (Word держит нумерацию именно в контентном контроле) и
|
|
||||||
* прочего содержимого, реализующего {@link ContentAccessor}.</li>
|
|
||||||
* <li>Маркеры {@code w:lastRenderedPageBreak} — границы страниц,
|
|
||||||
* которые Word записал при последнем рендере. Единственный
|
|
||||||
* источник оценки для документов без явных разрывов, порванных
|
|
||||||
* по заполнению.</li>
|
|
||||||
* </ol>
|
|
||||||
*
|
|
||||||
* <p>Оценка остаётся нижней: документ без явных разрывов и без
|
|
||||||
* маркеров (никогда не открывался в Word) оценивается в 1 страницу
|
|
||||||
* независимо от фактической длины — такие документы лимит не отсекают.
|
|
||||||
* @throws ConversionException при превышении {@link WordPdfSettings#MAX_PAGES}
|
|
||||||
*/
|
|
||||||
public static void checkPageCount(WordprocessingMLPackage pkg) throws ConversionException {
|
|
||||||
checkPageCount(pkg, WordPdfSettings.MAX_PAGES);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* То же, что {@link #checkPageCount(WordprocessingMLPackage)}, с явным
|
|
||||||
* лимитом страниц (переопределение на вызов, см. {@link ConvertOptions#maxPages()}).
|
|
||||||
*
|
|
||||||
* @throws ConversionException при превышении {@code maxPages}
|
|
||||||
*/
|
|
||||||
public static void checkPageCount(WordprocessingMLPackage pkg, int maxPages) throws ConversionException {
|
|
||||||
if (pkg == null) {
|
|
||||||
throw new ConversionException("Не указан загруженный .docx");
|
|
||||||
}
|
|
||||||
int pages = pageCountOf(pkg);
|
|
||||||
if (pages > maxPages) {
|
|
||||||
throw new ConversionException("Документ длиннее " + maxPages
|
|
||||||
+ " страниц: получено не менее " + pages);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Возвращает число страниц: максимум кэша {@code <Pages>}, оценки по
|
|
||||||
* явным разрывам и оценки по {@code w:lastRenderedPageBreak}.
|
|
||||||
* Виден только из тестов и пакета.
|
|
||||||
*/
|
|
||||||
static int pageCountOf(WordprocessingMLPackage pkg) {
|
|
||||||
int cached = 0;
|
|
||||||
try {
|
|
||||||
if (pkg.getDocPropsExtendedPart() != null) {
|
|
||||||
org.docx4j.docProps.extended.Properties ext =
|
|
||||||
pkg.getDocPropsExtendedPart().getContents();
|
|
||||||
if (ext != null && ext.getPages() != null && ext.getPages() > 0) {
|
|
||||||
cached = ext.getPages();
|
|
||||||
}
|
|
||||||
}
|
|
||||||
} catch (Exception ignored) {
|
|
||||||
// docPropsExtended может быть не полностью инициализирован —
|
|
||||||
// тогда остаётся оценка по разрывам.
|
|
||||||
}
|
|
||||||
// getJaxbElement() возвращает null, когда JAXB-разбор части провалился
|
|
||||||
// (docx4j пишет в лог «Problem with part» и «gives up») — без проверки
|
|
||||||
// здесь была бы NPE вместо внятной ошибки.
|
|
||||||
var document = pkg.getMainDocumentPart() == null
|
|
||||||
? null : pkg.getMainDocumentPart().getJaxbElement();
|
|
||||||
if (document == null || document.getBody() == null) {
|
|
||||||
throw new ConversionException("Не удалось разобрать word/document.xml");
|
|
||||||
}
|
|
||||||
var body = document.getBody();
|
|
||||||
var content = body.getContent();
|
|
||||||
int explicit = 1; // сам документ — минимум одна страница
|
|
||||||
for (Object child : content) {
|
|
||||||
// В JAXB-модели в body.getContent() лежат только межсекционные
|
|
||||||
// sectPr; финальная секция — в body.getSectPr(), её здесь нет.
|
|
||||||
if (child instanceof SectPr sect && startsNewPage(sect)) {
|
|
||||||
explicit++;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
explicit += walkForPageBreaks(content);
|
|
||||||
int lastRendered = countLastRendered(content);
|
|
||||||
return Math.max(Math.max(cached, explicit), lastRendered + 1);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Обход содержимого на явные разрывы: абзацы ищутся рекурсивно —
|
|
||||||
* прямо в {@code w:body}, в ячейках таблиц, в контентных контролах
|
|
||||||
* {@code w:sdt} и прочем содержимом, реализующем {@link ContentAccessor}.
|
|
||||||
* Элементы модели приходят и напрямую, и обёрнутыми в
|
|
||||||
* {@link JAXBElement} (например {@code w:tbl} в {@code w:body}) —
|
|
||||||
* обёртка раскрывается через {@link #unwrap}.
|
|
||||||
* Считаются {@code w:br type="page"} и {@code pageBreakBefore}
|
|
||||||
* (по одному на абзац), как и в lightweight-пути.
|
|
||||||
*/
|
|
||||||
private static int walkForPageBreaks(List<?> content) {
|
|
||||||
int count = 0;
|
|
||||||
for (Object raw : content) {
|
|
||||||
Object item = unwrap(raw);
|
|
||||||
if (item instanceof P p) {
|
|
||||||
if (p.getPPr() != null
|
|
||||||
&& p.getPPr().getPageBreakBefore() != null
|
|
||||||
&& p.getPPr().getPageBreakBefore().isVal()) {
|
|
||||||
count++;
|
|
||||||
}
|
|
||||||
for (Object runChild : p.getContent()) {
|
|
||||||
if (unwrap(runChild) instanceof org.docx4j.wml.R r) {
|
|
||||||
for (Object innerRaw : r.getContent()) {
|
|
||||||
if (unwrap(innerRaw) instanceof Br br
|
|
||||||
&& br.getType() == STBrType.PAGE) {
|
|
||||||
count++;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
} else if (item instanceof ContentAccessor ca) {
|
|
||||||
// w:tbl / w:tr / w:tc / w:sdt / w:sdtContent и т.п.
|
|
||||||
count += walkForPageBreaks(ca.getContent());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return count;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Подсчёт маркеров {@code w:lastRenderedPageBreak} в содержимом. */
|
|
||||||
private static int countLastRendered(List<?> content) {
|
|
||||||
int count = 0;
|
|
||||||
for (Object raw : content) {
|
|
||||||
Object item = unwrap(raw);
|
|
||||||
if (item instanceof R.LastRenderedPageBreak) {
|
|
||||||
count++;
|
|
||||||
} else if (item instanceof ContentAccessor ca) {
|
|
||||||
count += countLastRendered(ca.getContent());
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return count;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Раскрывает обёртку {@link JAXBElement} (docx4j так отдаёт tbl и часть содержимого). */
|
|
||||||
private static Object unwrap(Object item) {
|
|
||||||
return item instanceof JAXBElement<?> je ? je.getValue() : item;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Секция, начинающая новую страницу (continuous — нет). */
|
|
||||||
private static boolean startsNewPage(SectPr sect) {
|
|
||||||
return sect.getType() == null
|
|
||||||
|| sect.getType().getVal() == null
|
|
||||||
|| !sect.getType().getVal().equals("continuous");
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/** Поставщик потока по имени части zip; null — части нет. */
|
/** Поставщик потока по имени части zip; null — части нет. */
|
||||||
@@ -348,8 +189,7 @@ public final class WordPdfValidator {
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* Лёгкий расчёт числа страниц прямо по zip-пакету .docx, без docx4j.
|
* Лёгкий расчёт числа страниц прямо по zip-пакету .docx, без docx4j.
|
||||||
* Та же логика, что у {@link #pageCountOf(WordprocessingMLPackage)}:
|
* Максимум кэша {@code docProps/app.xml <Pages>}, явных разрывов и
|
||||||
* максимум кэша {@code docProps/app.xml <Pages>}, явных разрывов и
|
|
||||||
* {@code w:lastRenderedPageBreak}. Считаются все колонтитулы
|
* {@code w:lastRenderedPageBreak}. Считаются все колонтитулы
|
||||||
* ({@code word/header*.xml}, {@code word/footer*.xml}) — там Word тоже
|
* ({@code word/header*.xml}, {@code word/footer*.xml}) — там Word тоже
|
||||||
* держит {@code w:br type="page"}.
|
* держит {@code w:br type="page"}.
|
||||||
|
|||||||
@@ -432,22 +432,37 @@ class WordPdfConverterTest {
|
|||||||
|
|
||||||
@Test
|
@Test
|
||||||
void invalidInputRejected() {
|
void invalidInputRejected() {
|
||||||
assertThrows(ConversionException.class, () ->
|
assertThrows(ValidationException.class, () ->
|
||||||
WordPdfConverter.convert(null, "x"));
|
WordPdfConverter.convert(null, "x"));
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Лимит на размер входа: больше 20 MiB — отказ до рендера.
|
* Лимит на размер входа: больше 5 MiB — отказ до рендера.
|
||||||
*/
|
*/
|
||||||
@Test
|
@Test
|
||||||
void inputTooLarge() {
|
void inputTooLarge() {
|
||||||
byte[] tooBig = new byte[(int) WordPdfSettings.MAX_INPUT_BYTES + 1];
|
byte[] tooBig = new byte[(int) WordPdfSettings.MAX_INPUT_BYTES + 1];
|
||||||
ConversionException ex = assertThrows(ConversionException.class, () ->
|
ValidationException ex = assertThrows(ValidationException.class, () ->
|
||||||
WordPdfConverter.convert(tooBig, "too-big"));
|
WordPdfConverter.convert(tooBig, "too-big"));
|
||||||
assertTrue(ex.getMessage().contains("20 МБ"),
|
assertTrue(ex.getMessage().contains("5 МБ"),
|
||||||
"сообщение должно упоминать лимит: " + ex.getMessage());
|
"сообщение должно упоминать лимит: " + ex.getMessage());
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Вход без zip-подписи — отказ как некорректный вход (ValidationException),
|
||||||
|
* а не ошибка рендера: вход конвертера прогоняет тот же
|
||||||
|
* {@link WordPdfValidator#validate(byte[], ConvertOptions)}, что и приложение до очереди.
|
||||||
|
* Регрессия — WordPdfValidatorTest#validate_notAZip.
|
||||||
|
*/
|
||||||
|
@Test
|
||||||
|
void inputNotAZip_rejectedBeforeRender() {
|
||||||
|
byte[] junk = new byte[]{1, 2, 3, 4, 5, 6, 7, 8};
|
||||||
|
ValidationException ex = assertThrows(ValidationException.class, () ->
|
||||||
|
WordPdfConverter.convert(junk, "junk"));
|
||||||
|
assertTrue(ex.getMessage().contains("не zip-архив"),
|
||||||
|
"сообщение должно упоминать zip-подпись: " + ex.getMessage());
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Лимит размера переопределяется {@link ConvertOptions} на вызов:
|
* Лимит размера переопределяется {@link ConvertOptions} на вызов:
|
||||||
* maxBytes=1000 отсекает даже маленький документ до рендера, сообщение
|
* maxBytes=1000 отсекает даже маленький документ до рендера, сообщение
|
||||||
@@ -455,7 +470,7 @@ class WordPdfConverterTest {
|
|||||||
*/
|
*/
|
||||||
@Test
|
@Test
|
||||||
void limitsOverriddenByOptions() throws Exception {
|
void limitsOverriddenByOptions() throws Exception {
|
||||||
ConversionException ex = assertThrows(ConversionException.class, () ->
|
ValidationException ex = assertThrows(ValidationException.class, () ->
|
||||||
WordPdfConverter.convert(sampleBytes("ru-plain.docx"), "x",
|
WordPdfConverter.convert(sampleBytes("ru-plain.docx"), "x",
|
||||||
new ConvertOptions(true, true, false, false, 1000, WordPdfSettings.MAX_PAGES)));
|
new ConvertOptions(true, true, false, false, 1000, WordPdfSettings.MAX_PAGES)));
|
||||||
assertTrue(ex.getMessage().contains("1000 байт"),
|
assertTrue(ex.getMessage().contains("1000 байт"),
|
||||||
@@ -469,7 +484,7 @@ class WordPdfConverterTest {
|
|||||||
*/
|
*/
|
||||||
@Test
|
@Test
|
||||||
void tooManyPages() {
|
void tooManyPages() {
|
||||||
ConversionException ex = assertThrows(ConversionException.class, () ->
|
ValidationException ex = assertThrows(ValidationException.class, () ->
|
||||||
WordPdfConverter.convert(
|
WordPdfConverter.convert(
|
||||||
sampleBytes("too-many-pages.docx"), "too-many-pages",
|
sampleBytes("too-many-pages.docx"), "too-many-pages",
|
||||||
new ConvertOptions(true, true, false, false, WordPdfSettings.MAX_INPUT_BYTES, 100)));
|
new ConvertOptions(true, true, false, false, WordPdfSettings.MAX_INPUT_BYTES, 100)));
|
||||||
@@ -486,7 +501,7 @@ class WordPdfConverterTest {
|
|||||||
*/
|
*/
|
||||||
@Test
|
@Test
|
||||||
void staleCachePageCountRejectedBeforeRender() {
|
void staleCachePageCountRejectedBeforeRender() {
|
||||||
ConversionException ex = assertThrows(ConversionException.class, () ->
|
ValidationException ex = assertThrows(ValidationException.class, () ->
|
||||||
WordPdfConverter.convert(sampleBytes("stale-cache.docx"), "stale-cache",
|
WordPdfConverter.convert(sampleBytes("stale-cache.docx"), "stale-cache",
|
||||||
new ConvertOptions(true, true, false, false, WordPdfSettings.MAX_INPUT_BYTES, 100)));
|
new ConvertOptions(true, true, false, false, WordPdfSettings.MAX_INPUT_BYTES, 100)));
|
||||||
assertTrue(ex.getMessage().contains("100"),
|
assertTrue(ex.getMessage().contains("100"),
|
||||||
|
|||||||
@@ -4,7 +4,6 @@ import org.apache.poi.xwpf.usermodel.BreakType;
|
|||||||
import org.apache.poi.xwpf.usermodel.XWPFDocument;
|
import org.apache.poi.xwpf.usermodel.XWPFDocument;
|
||||||
import org.apache.poi.xwpf.usermodel.XWPFParagraph;
|
import org.apache.poi.xwpf.usermodel.XWPFParagraph;
|
||||||
import org.apache.poi.xwpf.usermodel.XWPFTable;
|
import org.apache.poi.xwpf.usermodel.XWPFTable;
|
||||||
import org.docx4j.openpackaging.packages.WordprocessingMLPackage;
|
|
||||||
import org.junit.jupiter.api.Test;
|
import org.junit.jupiter.api.Test;
|
||||||
|
|
||||||
import java.io.ByteArrayOutputStream;
|
import java.io.ByteArrayOutputStream;
|
||||||
@@ -16,7 +15,7 @@ import static org.junit.jupiter.api.Assertions.*;
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* Юнит-тесты валидатора: размер и число страниц
|
* Юнит-тесты валидатора: размер и число страниц
|
||||||
* (byte[] и уже загруженный пакет).
|
* (byte[], lightweight-путь zip/StAX).
|
||||||
*/
|
*/
|
||||||
class WordPdfValidatorTest {
|
class WordPdfValidatorTest {
|
||||||
|
|
||||||
@@ -42,15 +41,15 @@ class WordPdfValidatorTest {
|
|||||||
@Test
|
@Test
|
||||||
void checkInput_bytesOverLimit() {
|
void checkInput_bytesOverLimit() {
|
||||||
byte[] big = new byte[(int) WordPdfSettings.MAX_INPUT_BYTES + 1];
|
byte[] big = new byte[(int) WordPdfSettings.MAX_INPUT_BYTES + 1];
|
||||||
ConversionException ex = assertThrows(ConversionException.class,
|
ValidationException ex = assertThrows(ValidationException.class,
|
||||||
() -> WordPdfValidator.checkInput(big));
|
() -> WordPdfValidator.checkInput(big));
|
||||||
assertTrue(ex.getMessage().contains("20 МБ"),
|
assertTrue(ex.getMessage().contains("5 МБ"),
|
||||||
"сообщение должно упоминать лимит: " + ex.getMessage());
|
"сообщение должно упоминать лимит: " + ex.getMessage());
|
||||||
}
|
}
|
||||||
|
|
||||||
@Test
|
@Test
|
||||||
void checkInput_bytesNull() {
|
void checkInput_bytesNull() {
|
||||||
assertThrows(ConversionException.class,
|
assertThrows(ValidationException.class,
|
||||||
() -> WordPdfValidator.checkInput((byte[]) null));
|
() -> WordPdfValidator.checkInput((byte[]) null));
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -61,119 +60,58 @@ class WordPdfValidatorTest {
|
|||||||
@Test
|
@Test
|
||||||
void checkInput_customLimit() {
|
void checkInput_customLimit() {
|
||||||
assertDoesNotThrow(() -> WordPdfValidator.checkInput(new byte[10], 100));
|
assertDoesNotThrow(() -> WordPdfValidator.checkInput(new byte[10], 100));
|
||||||
ConversionException ex = assertThrows(ConversionException.class,
|
ValidationException ex = assertThrows(ValidationException.class,
|
||||||
() -> WordPdfValidator.checkInput(new byte[11], 10));
|
() -> WordPdfValidator.checkInput(new byte[11], 10));
|
||||||
assertTrue(ex.getMessage().contains("10 байт"),
|
assertTrue(ex.getMessage().contains("10 байт"),
|
||||||
"сообщение должно упоминать переданный лимит: " + ex.getMessage());
|
"сообщение должно упоминать переданный лимит: " + ex.getMessage());
|
||||||
}
|
}
|
||||||
|
|
||||||
@Test
|
// ---- lightweight (zip/StAX, без docx4j) ----
|
||||||
void checkPageCount_pkgWithinLimit() throws Exception {
|
|
||||||
byte[] bytes = docxWithPageBreaks(5); // 1 + 5 = 6 страниц по оценке
|
|
||||||
WordprocessingMLPackage pkg = WordprocessingMLPackage.load(
|
|
||||||
new java.io.ByteArrayInputStream(bytes));
|
|
||||||
assertDoesNotThrow(() -> WordPdfValidator.checkPageCount(pkg));
|
|
||||||
}
|
|
||||||
|
|
||||||
@Test
|
@Test
|
||||||
void checkPageCount_pkgOverLimit() throws Exception {
|
void checkPageCount_bytesWithinLimit() throws Exception {
|
||||||
byte[] bytes = docxWithPageBreaks(120); // 1 + 120 = 121
|
byte[] bytes = docxWithPageBreaks(5);
|
||||||
WordprocessingMLPackage pkg = WordprocessingMLPackage.load(
|
assertDoesNotThrow(() -> WordPdfValidator.checkPageCount(bytes));
|
||||||
new java.io.ByteArrayInputStream(bytes));
|
|
||||||
ConversionException ex = assertThrows(ConversionException.class,
|
|
||||||
() -> WordPdfValidator.checkPageCount(pkg, 100));
|
|
||||||
assertTrue(ex.getMessage().contains("100"),
|
|
||||||
"сообщение должно упоминать лимит: " + ex.getMessage());
|
|
||||||
}
|
}
|
||||||
|
|
||||||
@Test
|
@Test
|
||||||
void checkPageCount_bytesOverLimit() throws Exception {
|
void checkPageCount_bytesOverLimit() throws Exception {
|
||||||
byte[] bytes = docxWithPageBreaks(120);
|
byte[] bytes = docxWithPageBreaks(120);
|
||||||
ConversionException ex = assertThrows(ConversionException.class,
|
ValidationException ex = assertThrows(ValidationException.class,
|
||||||
() -> WordPdfValidator.checkPageCount(bytes, 100));
|
() -> WordPdfValidator.checkPageCount(bytes, 100));
|
||||||
assertTrue(ex.getMessage().contains("100"),
|
assertTrue(ex.getMessage().contains("100"),
|
||||||
"сообщение должно упоминать лимит: " + ex.getMessage());
|
"сообщение должно упоминать лимит: " + ex.getMessage());
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
|
||||||
* Явный лимит страниц для загруженного пакета: docx с 2 разрывами
|
|
||||||
* (оценка 3) отсекается maxPages=1 и проходит при maxPages=1000.
|
|
||||||
*/
|
|
||||||
@Test
|
|
||||||
void checkPageCount_pkg_customLimit() throws Exception {
|
|
||||||
byte[] bytes = docxWithPageBreaks(2);
|
|
||||||
WordprocessingMLPackage pkg = WordprocessingMLPackage.load(
|
|
||||||
new java.io.ByteArrayInputStream(bytes));
|
|
||||||
ConversionException ex = assertThrows(ConversionException.class,
|
|
||||||
() -> WordPdfValidator.checkPageCount(pkg, 1));
|
|
||||||
assertTrue(ex.getMessage().contains("длиннее 1 страниц"),
|
|
||||||
"сообщение должно упоминать переданный лимит: " + ex.getMessage());
|
|
||||||
assertDoesNotThrow(() -> WordPdfValidator.checkPageCount(pkg, 1000));
|
|
||||||
}
|
|
||||||
|
|
||||||
@Test
|
|
||||||
void checkPageCount_bytesNull() {
|
|
||||||
assertThrows(ConversionException.class,
|
|
||||||
() -> WordPdfValidator.checkPageCount((byte[]) null));
|
|
||||||
}
|
|
||||||
|
|
||||||
@Test
|
|
||||||
void checkPageCount_pkgNull() {
|
|
||||||
assertThrows(ConversionException.class,
|
|
||||||
() -> WordPdfValidator.checkPageCount((WordprocessingMLPackage) null));
|
|
||||||
}
|
|
||||||
|
|
||||||
// ---- lightweight (zip/StAX, без docx4j) ----
|
|
||||||
|
|
||||||
@Test
|
|
||||||
void checkPageCountLightweight_bytesWithinLimit() throws Exception {
|
|
||||||
byte[] bytes = docxWithPageBreaks(5);
|
|
||||||
assertDoesNotThrow(() -> WordPdfValidator.checkPageCountLightweight(bytes));
|
|
||||||
}
|
|
||||||
|
|
||||||
@Test
|
|
||||||
void checkPageCountLightweight_bytesOverLimit() throws Exception {
|
|
||||||
byte[] bytes = docxWithPageBreaks(120);
|
|
||||||
ConversionException ex = assertThrows(ConversionException.class,
|
|
||||||
() -> WordPdfValidator.checkPageCountLightweight(bytes, 100));
|
|
||||||
assertTrue(ex.getMessage().contains("100"),
|
|
||||||
"сообщение должно упоминать лимит: " + ex.getMessage());
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Явный лимит страниц lightweight-пути: те же 3 страницы
|
* Явный лимит страниц lightweight-пути: те же 3 страницы
|
||||||
* (2 разрыва) отсекаются maxPages=1 и проходят при maxPages=1000.
|
* (2 разрыва) отсекаются maxPages=1 и проходят при maxPages=1000.
|
||||||
*/
|
*/
|
||||||
@Test
|
@Test
|
||||||
void checkPageCountLightweight_customLimit() throws Exception {
|
void checkPageCount_customLimit() throws Exception {
|
||||||
byte[] bytes = docxWithPageBreaks(2);
|
byte[] bytes = docxWithPageBreaks(2);
|
||||||
ConversionException ex = assertThrows(ConversionException.class,
|
ValidationException ex = assertThrows(ValidationException.class,
|
||||||
() -> WordPdfValidator.checkPageCountLightweight(bytes, 1));
|
() -> WordPdfValidator.checkPageCount(bytes, 1));
|
||||||
assertTrue(ex.getMessage().contains("длиннее 1 страниц"),
|
assertTrue(ex.getMessage().contains("длиннее 1 страниц"),
|
||||||
"сообщение должно упоминать переданный лимит: " + ex.getMessage());
|
"сообщение должно упоминать переданный лимит: " + ex.getMessage());
|
||||||
assertDoesNotThrow(() -> WordPdfValidator.checkPageCountLightweight(bytes, 1000));
|
assertDoesNotThrow(() -> WordPdfValidator.checkPageCount(bytes, 1000));
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Точная граница лимита lightweight-пути: 99 разрывов = 100 страниц
|
||||||
|
* (проходит), 100/101 = 101/102 (отказ с оценкой «не менее 1+breaks»).
|
||||||
|
*/
|
||||||
@Test
|
@Test
|
||||||
void checkPageCountLightweight_agreesWithJaxbPath() throws Exception {
|
void checkPageCount_limitBoundary() throws Exception {
|
||||||
// на фикстурах без кэша Pages оба пути обязаны совпадать,
|
|
||||||
// включая границу лимита: 99 разрывов = 100 страниц (проходит),
|
|
||||||
// 100/101 = 101/102 (отказ)
|
|
||||||
for (int breaks : new int[]{0, 3, 99, 100, 101}) {
|
for (int breaks : new int[]{0, 3, 99, 100, 101}) {
|
||||||
byte[] bytes = docxWithPageBreaks(breaks);
|
byte[] bytes = docxWithPageBreaks(breaks);
|
||||||
WordprocessingMLPackage pkg = WordprocessingMLPackage.load(
|
|
||||||
new java.io.ByteArrayInputStream(bytes));
|
|
||||||
int jaxb = WordPdfValidator.pageCountOf(pkg);
|
|
||||||
// lightweight-путь приватный; проверяем через границу лимита:
|
|
||||||
// 1+breaks совпадает с оценкой JAXB
|
|
||||||
assertEquals(1 + breaks, jaxb, "JAXB-оценка для " + breaks + " разрывов");
|
|
||||||
if (breaks < 100) {
|
if (breaks < 100) {
|
||||||
assertDoesNotThrow(() -> WordPdfValidator.checkPageCountLightweight(bytes, 100));
|
assertDoesNotThrow(() -> WordPdfValidator.checkPageCount(bytes, 100));
|
||||||
} else {
|
} else {
|
||||||
ConversionException ex = assertThrows(ConversionException.class,
|
ValidationException ex = assertThrows(ValidationException.class,
|
||||||
() -> WordPdfValidator.checkPageCountLightweight(bytes, 100));
|
() -> WordPdfValidator.checkPageCount(bytes, 100));
|
||||||
assertTrue(ex.getMessage().contains("не менее " + (1 + breaks)),
|
assertTrue(ex.getMessage().contains("не менее " + (1 + breaks)),
|
||||||
"оценка lightweight должна совпадать с JAXB: " + ex.getMessage());
|
"оценка = 1 + число разрывов: " + ex.getMessage());
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -186,10 +124,9 @@ class WordPdfValidatorTest {
|
|||||||
* 101 страница, отказ (старый код считал «все минус одна» без
|
* 101 страница, отказ (старый код считал «все минус одна» без
|
||||||
* учёта типа: 101−1=100 и пропускал). Случай B: 101
|
* учёта типа: 101−1=100 и пропускал). Случай B: 101
|
||||||
* {@code continuous} + финальная {@code nextPage} — 1 страница,
|
* {@code continuous} + финальная {@code nextPage} — 1 страница,
|
||||||
* проходит (старый код раздувал до 102 и отвергал). В JAXB-модели
|
* проходит (старый код раздувал до 102 и отвергал); разрывы в
|
||||||
* body-direct sectPr не видны (docx4j оставляет только финальную
|
* колонтитулах только усиливают нижнюю оценку — расхождение с
|
||||||
* в {@code body.getSectPr()}, {@code getContent()} пуст), поэтому
|
* точным числом страниц здесь — допустимое завышение.
|
||||||
* расхождение lightweight здесь — допустимое завышение.
|
|
||||||
* Регрессия — WordPdfValidator#scanDocument.
|
* Регрессия — WordPdfValidator#scanDocument.
|
||||||
*/
|
*/
|
||||||
@Test
|
@Test
|
||||||
@@ -200,8 +137,8 @@ class WordPdfValidatorTest {
|
|||||||
}
|
}
|
||||||
typesA.add("continuous"); // финальная секция — непрерывная
|
typesA.add("continuous"); // финальная секция — непрерывная
|
||||||
byte[] overLimit = docxWithBodySections(typesA);
|
byte[] overLimit = docxWithBodySections(typesA);
|
||||||
ConversionException exLwA = assertThrows(ConversionException.class,
|
ValidationException exLwA = assertThrows(ValidationException.class,
|
||||||
() -> WordPdfValidator.checkPageCountLightweight(overLimit, 100));
|
() -> WordPdfValidator.checkPageCount(overLimit, 100));
|
||||||
assertTrue(exLwA.getMessage().contains("не менее 101"),
|
assertTrue(exLwA.getMessage().contains("не менее 101"),
|
||||||
"оценка = 1 + 100 межсекционных nextPage: " + exLwA.getMessage());
|
"оценка = 1 + 100 межсекционных nextPage: " + exLwA.getMessage());
|
||||||
|
|
||||||
@@ -211,7 +148,7 @@ class WordPdfValidatorTest {
|
|||||||
}
|
}
|
||||||
typesB.add("nextPage"); // финальная секция
|
typesB.add("nextPage"); // финальная секция
|
||||||
byte[] ok = docxWithBodySections(typesB);
|
byte[] ok = docxWithBodySections(typesB);
|
||||||
assertDoesNotThrow(() -> WordPdfValidator.checkPageCountLightweight(ok, 100),
|
assertDoesNotThrow(() -> WordPdfValidator.checkPageCount(ok, 100),
|
||||||
"continuous-границы не страницы");
|
"continuous-границы не страницы");
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -280,16 +217,10 @@ class WordPdfValidatorTest {
|
|||||||
@Test
|
@Test
|
||||||
void pageCount_staleCacheLosesToLastRenderedMarkers() throws Exception {
|
void pageCount_staleCacheLosesToLastRenderedMarkers() throws Exception {
|
||||||
byte[] bytes = staleCacheFixture();
|
byte[] bytes = staleCacheFixture();
|
||||||
WordprocessingMLPackage pkg = WordprocessingMLPackage.load(
|
ValidationException ex = assertThrows(ValidationException.class,
|
||||||
new java.io.ByteArrayInputStream(bytes));
|
() -> WordPdfValidator.checkPageCount(bytes, 100));
|
||||||
assertEquals(111, WordPdfValidator.pageCountOf(pkg),
|
assertTrue(ex.getMessage().contains("не менее 111"),
|
||||||
"оценка = max(кэш 1, разрывы 1, маркеры 110+1)");
|
"оценка = max(кэш 1, разрывы 1, маркеры 110+1): " + ex.getMessage());
|
||||||
ConversionException ex = assertThrows(ConversionException.class,
|
|
||||||
() -> WordPdfValidator.checkPageCount(pkg, 100));
|
|
||||||
assertTrue(ex.getMessage().contains("100"), ex.getMessage());
|
|
||||||
// lightweight-путь обязан согласовать тот же отказ
|
|
||||||
assertThrows(ConversionException.class,
|
|
||||||
() -> WordPdfValidator.checkPageCountLightweight(bytes, 100));
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -311,20 +242,62 @@ class WordPdfValidatorTest {
|
|||||||
doc.write(bos);
|
doc.write(bos);
|
||||||
bytes = bos.toByteArray();
|
bytes = bos.toByteArray();
|
||||||
}
|
}
|
||||||
WordprocessingMLPackage pkg = WordprocessingMLPackage.load(
|
ValidationException ex = assertThrows(ValidationException.class,
|
||||||
new java.io.ByteArrayInputStream(bytes));
|
|
||||||
assertEquals(121, WordPdfValidator.pageCountOf(pkg),
|
|
||||||
"разрывы в ячейке таблицы должны считаться");
|
|
||||||
assertThrows(ConversionException.class,
|
|
||||||
() -> WordPdfValidator.checkPageCount(bytes, 100));
|
() -> WordPdfValidator.checkPageCount(bytes, 100));
|
||||||
assertThrows(ConversionException.class,
|
assertTrue(ex.getMessage().contains("не менее 121"),
|
||||||
() -> WordPdfValidator.checkPageCountLightweight(bytes, 100));
|
"120 разрывов в ячейке таблицы + первая страница: " + ex.getMessage());
|
||||||
}
|
}
|
||||||
|
|
||||||
@Test
|
@Test
|
||||||
void checkPageCountLightweight_bytesNull() {
|
void checkPageCount_bytesNull() {
|
||||||
assertThrows(ConversionException.class,
|
assertThrows(ValidationException.class,
|
||||||
() -> WordPdfValidator.checkPageCountLightweight((byte[]) null));
|
() -> WordPdfValidator.checkPageCount((byte[]) null));
|
||||||
|
}
|
||||||
|
|
||||||
|
// ===== validate(byte[], ConvertOptions) =====
|
||||||
|
|
||||||
|
private static ConvertOptions options(long maxBytes, int maxPages) {
|
||||||
|
return new ConvertOptions(true, true, false, false, maxBytes, maxPages);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void validate_withinLimits() throws Exception {
|
||||||
|
assertDoesNotThrow(() -> WordPdfValidator.validate(
|
||||||
|
docxWithPageBreaks(5), ConvertOptions.defaults()));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void validate_bytesOverLimit() {
|
||||||
|
byte[] big = new byte[(int) WordPdfSettings.MAX_INPUT_BYTES + 1];
|
||||||
|
ValidationException ex = assertThrows(ValidationException.class,
|
||||||
|
() -> WordPdfValidator.validate(big, ConvertOptions.defaults()));
|
||||||
|
assertTrue(ex.getMessage().contains("5 МБ"),
|
||||||
|
"размер проверяется первым: " + ex.getMessage());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void validate_notAZip() {
|
||||||
|
byte[] junk = new byte[]{1, 2, 3, 4, 5};
|
||||||
|
ValidationException ex = assertThrows(ValidationException.class,
|
||||||
|
() -> WordPdfValidator.validate(junk, ConvertOptions.defaults()));
|
||||||
|
assertTrue(ex.getMessage().contains("не zip-архив"),
|
||||||
|
"сообщение должно упоминать zip-подпись: " + ex.getMessage());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void validate_tooManyPages() throws Exception {
|
||||||
|
byte[] bytes = docxWithPageBreaks(120);
|
||||||
|
ValidationException ex = assertThrows(ValidationException.class,
|
||||||
|
() -> WordPdfValidator.validate(bytes,
|
||||||
|
options(WordPdfSettings.MAX_INPUT_BYTES, 100)));
|
||||||
|
assertTrue(ex.getMessage().contains("не менее 121"),
|
||||||
|
"оценка = 1 + 120 разрывов: " + ex.getMessage());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void validate_nullBytes() {
|
||||||
|
assertThrows(ValidationException.class,
|
||||||
|
() -> WordPdfValidator.validate(null, ConvertOptions.defaults()));
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -354,9 +327,9 @@ class WordPdfValidatorTest {
|
|||||||
|
|
||||||
// 3 разрыва + первая страница = не менее 4; до фикса lightweight
|
// 3 разрыва + первая страница = не менее 4; до фикса lightweight
|
||||||
// не видел разрывы в strict-namespace и возвращал 1
|
// не видел разрывы в strict-namespace и возвращал 1
|
||||||
assertDoesNotThrow(() -> WordPdfValidator.checkPageCountLightweight(docx, 4));
|
assertDoesNotThrow(() -> WordPdfValidator.checkPageCount(docx, 4));
|
||||||
ConversionException ex = assertThrows(ConversionException.class,
|
ValidationException ex = assertThrows(ValidationException.class,
|
||||||
() -> WordPdfValidator.checkPageCountLightweight(docx, 3));
|
() -> WordPdfValidator.checkPageCount(docx, 3));
|
||||||
assertTrue(ex.getMessage().contains("не менее 4"), ex.getMessage());
|
assertTrue(ex.getMessage().contains("не менее 4"), ex.getMessage());
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -152,8 +152,8 @@ export default function App() {
|
|||||||
<div>
|
<div>
|
||||||
<h1 className="text-2xl font-semibold">Word → PDF</h1>
|
<h1 className="text-2xl font-semibold">Word → PDF</h1>
|
||||||
<p className="mt-1 text-sm text-muted">
|
<p className="mt-1 text-sm text-muted">
|
||||||
docx → PDF на docx4j + Apache FOP. Лимиты (файл ≤ 20 МБ,
|
docx → PDF на docx4j + Apache FOP. Лимиты (файл ≤ 5 МБ,
|
||||||
≤ 1000 страниц) задаёт сервер; переопределение из формы убрано.
|
≤ 100 страниц) задаёт сервер; переопределение из формы убрано.
|
||||||
</p>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
</header>
|
</header>
|
||||||
|
|||||||
Reference in New Issue
Block a user