Compare commits
15 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
| bd43d0d80d | |||
| 96865daef4 | |||
| 4d6cc2a795 | |||
| bcfabfb0e9 | |||
| 5f0cabd8e2 | |||
| a07e739682 | |||
| ee49993aff | |||
| e7db0c6b06 | |||
| 5482bfac60 | |||
| 45b78f7fc9 | |||
| f09b629270 | |||
| faf6d048a5 | |||
| 65746db9d2 | |||
| ab1b25c352 | |||
| 2750486c91 |
+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
|
||||||
|
|||||||
@@ -6,6 +6,11 @@ dependency-reduced-pom.xml
|
|||||||
node_modules/
|
node_modules/
|
||||||
wordpdf-web/dist/
|
wordpdf-web/dist/
|
||||||
|
|
||||||
|
# Python (prod-autotests)
|
||||||
|
.venv/
|
||||||
|
__pycache__/
|
||||||
|
.pytest_cache/
|
||||||
|
|
||||||
# IDE
|
# IDE
|
||||||
.idea/
|
.idea/
|
||||||
*.iml
|
*.iml
|
||||||
|
|||||||
@@ -2,19 +2,19 @@
|
|||||||
|
|
||||||
## Project Overview
|
## Project Overview
|
||||||
|
|
||||||
Конвертер `.docx`/`.doc` → `.pdf` на чистом Java (docx4j 17.3.2 + форк Apache FOP; бинарный `.doc` Word 97-2003 — через POI HWPF, без LibreOffice/Aspose). Java 21, только Maven. Модули: `wordpdf-core` (библиотека), `wordpdf-app` (Spring Boot 4.1.1 REST API); `wordpdf-web` — React SPA в nginx-контейнере (отдельный деп, вне Maven). Единственный гейт перед `git push` — `mvn clean verify` (CI нет; SPA гейтуется `npm run build` + `npm run lint`). Вход стека — контейнер `gateway` (nginx), НЕ 8080. README устарел шире Docker-секции: лимиты (пишет 5 МБ/100 стр./6 МБ multipart — фактически 20 MiB/1000/100 MB), порты («всё на :8080» — фактически gateway :9010/:9011), API-ключ вообще не упомянут; плюс «фикстуры генерируются POI» (они закоммичены, POI только в генераторе) и Swagger UI без оговорки, что в проде она открыта без ключа, — авторитет этот файл.
|
Конвертер `.docx`/`.doc` → `.pdf` на чистом Java (docx4j 17.3.2 + форк Apache FOP; бинарный `.doc` Word 97-2003 — через POI HWPF, без LibreOffice/Aspose). Java 21, только Maven. Модули: `wordpdf-core` (библиотека), `wordpdf-app` (Spring Boot 4.1.1 REST API); `wordpdf-web` — React SPA в nginx-контейнере (отдельный деп, вне Maven). Единственный гейт перед `git push` — `mvn clean verify` (CI нет; SPA гейтуется `npm run build` + `npm run lint`). Вход стека — контейнер `gateway` (nginx), НЕ 8080. README устарел шире секции про контейнеры: лимиты (пишет 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`:
|
||||||
|
|
||||||
**Шаг 0**: вход с OLE2-магиком `D0 CF 11 E0 A1 B1 1A E1` (бинарный `.doc`) уходит в `internal.DocToPdfRenderer.render` **до** создания `BundledFontMapper` — docx4j-машинерия и все нормализаторы (zip-путь) для него бессмысленны; см. «Ветка .doc» ниже.
|
**Шаг 0**: вход с OLE2-магиком `D0 CF 11 E0 A1 B1 1A E1` (бинарный `.doc`) уходит в `internal.DocToPdfRenderer.render` **до** создания `BundledFontMapper` — docx4j-машинерия и все нормализаторы (zip-путь) для него бессмысленны; см. «Ветка .doc» ниже.
|
||||||
|
|
||||||
1. `new BundledFontMapper()` → `BundledFonts.init()` → `BundledFonts.restrictToBundled()`. Конструктор маппера каждый раз добавляет системные шрифты в реестр `PhysicalFonts`; ключ реестра — имя из name-таблицы TTF, `addPhysicalFont(URI)` не перезаписывает занятый → `init()` вызывает `dropNonBundled()` **до** регистрации и `load()` (иначе системный Calibri ломает em-dash-fallback).
|
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()` нет).
|
||||||
@@ -27,10 +27,10 @@ POI `WordToFoConverter` (HWPF→XSL-FO) → тот же FOP-форк. Поряд
|
|||||||
|
|
||||||
- Единственный эндпоинт `POST /api/v1/convert` (multipart-поле `file`, факультативные `renderCharts`/`renderSmartArt` — query или form) → `application/pdf`, `Content-Disposition: attachment; filename*=UTF-8''…`. Проверка расширений `.docx`/`.doc` — в `ConvertController`; `safeBaseName` в `ConversionService` — единый источник имени для файла, заголовка ответа и PDF-title (разрешены `[\p{L}\p{N} ._-]`, пустое → `document`). Для `.doc` ответ несёт `X-Wordpdf-Degraded: headers-footers-exotic-glyphs` (деградация вёрстки/колонтитулов/экзотических глифов).
|
- Единственный эндпоинт `POST /api/v1/convert` (multipart-поле `file`, факультативные `renderCharts`/`renderSmartArt` — query или form) → `application/pdf`, `Content-Disposition: attachment; filename*=UTF-8''…`. Проверка расширений `.docx`/`.doc` — в `ConvertController`; `safeBaseName` в `ConversionService` — единый источник имени для файла, заголовка ответа и PDF-title (разрешены `[\p{L}\p{N} ._-]`, пустое → `document`). Для `.doc` ответ несёт `X-Wordpdf-Degraded: headers-footers-exotic-glyphs` (деградация вёрстки/колонтитулов/экзотических глифов).
|
||||||
- Конвертации **сериализованы** однопоточным `ThreadPoolExecutor` (`ConversionService.QUEUE_CAPACITY = 16`, переполнение → 503): ядро мутирует глобальный реестр `PhysicalFonts`. `future.cancel(true)` при таймауте не останавливает FOP мгновенно — осознанный компромисс.
|
- Конвертации **сериализованы** однопоточным `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 / не OLE2 / размер / страницы) → 400, валидный контейнер с мусором внутри → 500. Валидация до очереди — развилка по магiku: `checkInput` → zip `PK\x03\x04` → `checkPageCountLightweight` **или** OLE2 `D0 CF 11 E0` → `checkDocPageCountLightweight` (порядок значим).
|
- Ошибки (`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 / не OLE2 / размер / страницы) → 400, валидный контейнер с мусором внутри → 500. Валидация до очереди: `WordPdfValidator.validate(docxBytes, options)` (внутри порядок значим: `checkInput` → подпись контейнера (zip `PK\x03\x04` **или** OLE2 `D0 CF 11 E0`) → страницы); тот же метод — вход ядра.
|
||||||
- **Ключ доступа**: `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`, проверяется раньше); запросы на `${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`)
|
||||||
|
|
||||||
@@ -40,9 +40,9 @@ 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.6 (пакеты `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`.
|
||||||
- Форк FOP вырезал `PageMaster.setupRegions` (в jar нет `layoutmgr/PageMaster*`/`RegionXY`): `area.Page` строит viewport `region-body` как page-area минус **собственные** margin'ы body, `extent` у `region-before`/`region-after` body-регион не уменьшает — в `.doc`-ветке разводка body и колонтитулов только margin'ами `region-body` (регрессия `DocToPdfTest#legacyDoc_bodyClearsHeaderFooterRegions`). Docx-ветку не касается: docx4j сам закладывает высоты колонтитулов в margin'ы мастера.
|
- Форк FOP вырезал `PageMaster.setupRegions` (в jar нет `layoutmgr/PageMaster*`/`RegionXY`): `area.Page` строит viewport `region-body` как page-area минус **собственные** margin'ы body, `extent` у `region-before`/`region-after` body-регион не уменьшает — в `.doc`-ветке разводка body и колонтитулов только margin'ами `region-body` (регрессия `DocToPdfTest#legacyDoc_bodyClearsHeaderFooterRegions`). Docx-ветку не касается: docx4j сам закладывает высоты колонтитулов в margin'ы мастера.
|
||||||
- Страницы в валидаторе = `max(кэш docProps/app.xml, явные разрывы, lastRenderedPageBreak+1)`; explicit = межсекционные `sectPr` в body + `w:br type="page"` + `pageBreakBefore` (рекурсивно, включая таблицы и `w:sdt`). Lightweight-путь (StAX по zip, secure-ридер без DTD/external entities): атрибуты — по локальному имени (`attrLocal`, не по transitional-URI: иначе в strict-документе `w:br type="page"` не засчитываются); `sectPr` внутри `pPr` не считает, последнюю body-direct секцию не считает, `continuous`-секции не считает, в колонтитулах — только `w:br type="page"`, `pageBreakBefore` — только внутри `pPr` вне `sectPr` (truthy-значения `val`: `null|true|1|on`); на не-zip молчит — подпись проверяет вызывающий. Расхождение lightweight↔JAXB допустимо только в завышение. `pageCountOf` package-private намеренно (тесты); при провале JAXB-разбора (`getJaxbElement()` → null) бросает `ConversionException`, а не NPE.
|
- Страницы в валидаторе = `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`.
|
||||||
- `.doc`: `checkDocPageCountLightweight` = кэш `SummaryInformation.getPacket().getPageCount()` (Word 97-2003 писал число страниц в OLE2-метаданные; явных разрывов из FIB не извлечь) — тот же stale-cache риск, что и `docProps/app.xml`; `0`/отсутствие пакета → молча. FOP-конфиг `.doc`-ветки — строка с `auto-detect="false"` + `resource://fonts/...` (классы `FOPFontProvider`/`FopConfParser` package-private, JAXB-обход `rendererFonts` к ним не применим). Кэш шрифтов отключён (`FOUserAgent.getFontManager().disableFontCache()` в `renderFo`): дефолт форка — `<user.home>/.fop/fop-fonts.cache`, а при непригодном `user.home` (null/несуществующий каталог — non-root контейнер без HOME) файл `.fop` в текущем каталоге, `/app` в образе не пишется → 500 на `.doc` (регрессия `DocToPdfTest#legacyDoc_fontCacheNotWrittenToWorkingDir`).
|
- `.doc`: `checkDocPageCountLightweight` = кэш `SummaryInformation.getPacket().getPageCount()` (Word 97-2003 писал число страниц в OLE2-метаданные; явных разрывов из FIB не извлечь) — тот же stale-cache риск, что и `docProps/app.xml`; `0`/отсутствие пакета → молча. FOP-конфиг `.doc`-ветки — строка с `auto-detect="false"` + `resource://fonts/...` (классы `FOPFontProvider`/`FopConfParser` package-private, JAXB-обход `rendererFonts` к ним не применим). Кэш шрифтов отключён (`FOUserAgent.getFontManager().disableFontCache()` в `renderFo`): дефолт форка — `<user.home>/.fop/fop-fonts.cache`, а при непригодном `user.home` (null/несуществующий каталог — non-root контейнер без HOME) файл `.fop` в текущем каталоге, `/app` в образе не пишется → 500 на `.doc` (регрессия `DocToPdfTest#legacyDoc_fontCacheNotWrittenToWorkingDir`).
|
||||||
- Известный остаток эталона: 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 (описанное поведение верно).
|
||||||
@@ -55,7 +55,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, с лимитом/без; `checkDocPageCountLightweight` — только `byte[]` + лимит, для OLE2-`.doc`), `ConversionException`, `WordPdfSettings` (константы-дефолты), `ConvertOptions` (record: renderCharts, renderSmartArt, maxBytes, maxPages)|
|
|`wordpdf-core/src/main/java/ru/pjandro/wordpdf/`|публичный API: `WordPdfConverter`, `WordPdfValidator` (перегрузки `checkInput`/`checkPageCount` — `byte[]`, с лимитом/без, `checkDocPageCountLightweight` — OLE2-`.doc`, и `validate(byte[], ConvertOptions)` — полная цепочка размер → подпись контейнера (zip/OLE2) → страницы; без зависимости от docx4j — только POI для `.doc`), `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` + `DocToPdfRenderer` (ветка `.doc`; классы `public` — вызываются из родительского пакета; публичные члены только `normalize`/`declare`/`render`)|
|
|`…/wordpdf/internal/`|5 байтовых нормализатора + `FopFallbackFonts` + `DocToPdfRenderer` (ветка `.doc`; классы `public` — вызываются из родительского пакета; публичные члены только `normalize`/`declare`/`render`)|
|
||||||
|`…/wordpdf/internal/chart/`|11 классов Java2D-рендера диаграмм/SmartArt в PNG (public только `DrawingPreRenderer`)|
|
|`…/wordpdf/internal/chart/`|11 классов Java2D-рендера диаграмм/SmartArt в PNG (public только `DrawingPreRenderer`)|
|
||||||
@@ -63,14 +63,15 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр
|
|||||||
|`wordpdf-core/src/test/resources/samples/`|12 закоммиченных фикстур: 11 `.docx` + `legacy-doc.doc` (OLE2, ветка `.doc`)|
|
|`wordpdf-core/src/test/resources/samples/`|12 закоммиченных фикстур: 11 `.docx` + `legacy-doc.doc` (OLE2, ветка `.doc`)|
|
||||||
|`wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/`|REST API (10 классов): `WordPdfApplication` (единственный public), `ConvertController`, `ConversionService` (очередь), `ApiExceptionHandler`, `ApiKeyFilter`, `OpenApiConfig` (`@SecurityScheme` X-API-Key для springdoc) + 4 класса исключений|
|
|`wordpdf-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)|
|
||||||
|корневые `Dockerfile`, `docker-compose.yml`, `docker-compose.dev.yml`, `gateway/nginx.conf`|образ бэкенда (multi-stage maven:3.9-temurin-21 → temurin-21-jre, non-root, HEALTHCHECK actuator); compose app+web+gateway: web-образ со своим HEALTHCHECK (`wget /`), в обоих compose `depends_on web: condition: service_healthy` (без health web gateway не стартует); прод-compose интерполирует `WORDPDF_MAX_BYTES:-20971520`/`WORDPDF_MAX_PAGES:-1000`|
|
|корневые `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`, вне репо)|
|
||||||
|
|корневой `prod-autotests/`|прод-автотесты API (pytest + requests, 18 проверок): конфигурация стенда **только env** (`WORDPDF_BASE_URL` обязателен, `WORDPDF_API_KEY`/`WORDPDF_MAX_PAGES`/`WORDPDF_SAMPLES_DIR` факультативны) — прод-хостов/ключей в коде нет; окружение — mise (`mise.toml`: python 3.15 + автосоздаваемый `.venv`, в venv от uv pip досеивается `ensurepip`); прод-раннер вне git — `/home/pjandro/prod/java-word-pdf/run-prod-tests.sh` (знает прод-настройки: base URL, лимит 1000 стр., ключ из соседнего `.env`)|
|
||||||
|`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 не подключать|
|
||||||
|
|
||||||
## Development Commands
|
## Development Commands
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
mvn clean verify # все модули + тесты — обязательный гейт перед push
|
mvn clean verify # все модули + тесты + PMD (pmd-ruleset.xml) — обязательный гейт перед push
|
||||||
mvn -pl wordpdf-app -am package # исполняемый jar бэкенда
|
mvn -pl wordpdf-app -am package # исполняемый jar бэкенда
|
||||||
java -jar wordpdf-app/target/wordpdf-app-1.0.0.jar # :8080, ключ выключен
|
java -jar wordpdf-app/target/wordpdf-app-1.0.0.jar # :8080, ключ выключен
|
||||||
curl -F "file=@doc.docx" http://localhost:8080/api/v1/convert -o doc.pdf
|
curl -F "file=@doc.docx" http://localhost:8080/api/v1/convert -o doc.pdf
|
||||||
@@ -78,7 +79,7 @@ mvn -pl wordpdf-core test -Dtest=WordPdfConverterTest#pageNumbers_recomputedNotC
|
|||||||
mvn -pl wordpdf-app -am test -Dtest=ConvertControllerTest#convertSample_returnsPdf # -am обязателен (test-jar core)
|
mvn -pl wordpdf-app -am test -Dtest=ConvertControllerTest#convertSample_returnsPdf # -am обязателен (test-jar core)
|
||||||
npm run dev # (wordpdf-web/) SPA :5173, vite-proxy /api → :8080
|
npm run dev # (wordpdf-web/) SPA :5173, vite-proxy /api → :8080
|
||||||
npm run build # (wordpdf-web/) tsc -b && vite build — гейт SPA; lint: npm run lint (oxlint)
|
npm run build # (wordpdf-web/) tsc -b && vite build — гейт SPA; lint: npm run lint (oxlint)
|
||||||
docker compose -f docker-compose.dev.yml up -d --build # dev-стенд: http://127.0.0.1:9011, без ключа, springdoc вкл
|
podman-compose -f compose.dev.yml up -d --build # dev-стенд: http://<LAN-IP хоста>:9011 (0.0.0.0), без ключа, springdoc вкл
|
||||||
```
|
```
|
||||||
|
|
||||||
Пересоздать 10 фикстур (POI, test scope; `charts-smartart.docx` и `legacy-doc.doc` НЕ генерируются — созданы вручную, не перезаписывать):
|
Пересоздать 10 фикстур (POI, test scope; `charts-smartart.docx` и `legacy-doc.doc` НЕ генерируются — созданы вручную, не перезаписывать):
|
||||||
@@ -89,7 +90,7 @@ java -cp wordpdf-core/target/test-classes:$(cat /tmp/cp.txt) \
|
|||||||
ru.pjandro.wordpdf.SampleDocxGenerator wordpdf-core/src/test/resources/samples
|
ru.pjandro.wordpdf.SampleDocxGenerator wordpdf-core/src/test/resources/samples
|
||||||
```
|
```
|
||||||
|
|
||||||
Деплой. **Прод** — на пользовательском LAN-сервере; координаты сервера, каталог, restart-секвенция, ключ и гейты успешности — вне репо: `/home/pjandro/prod/java-word-pdf/DEPLOY.md` (обязательно прочитать перед любым деплоем/перезапуском; в том каталоге лежат архивные файлы старого стека 88.14 — `restart.sh.old-88.14`, старый compose/nginx — **не поднимать**). Единая точка входа с dev-машины — `/home/pjandro/prod/java-word-pdf/restart.sh` (пробрасывает флаги удалённому скрипту: `--build` — пересборка образов из `origin/main` + перезапуск; без флага — restart контейнеров; предупреждает о не запушенном в `main`). В прод попадает только запушенное в `main` — рабочее дерево на сборку не влияет. Наружный вход `https://pjandro.ru/pdf-converter/` (префикс срезает наружный nginx прод-хоста, не репозиторный gateway-конф; прод-копия gateway-конфа дополнительно содержит `proxy_read_timeout 300s` — в репо её нет, дефолтные 60s рвут 2-минутные конвертации). Тот же наружный nginx в `location /pdf-converter/` добавляет `X-Forwarded-Host: $host` и `X-Forwarded-Prefix: /pdf-converter` — из них springdoc собирает server-URL спека и swagger-config под префиксом (без `X-Forwarded-Host` server = `https://app:8080`, gateway шлёт приложению `Host: app:8080`); канонический URL документации `https://pjandro.ru/pdf-converter/swagger-ui.html` — открыт без ключа. **Dev-стенд** — из репо `docker-compose.dev.yml` (проект `wordpdf-dev`, `127.0.0.1:9011:80`, без env → ключ пуст, springdoc вкл). Репозиторный `docker-compose.yml` — третий вариант (проект `wordpdf`, `9010:80` на все интерфейсы, `WORDPDF_API_KEY` fail-closed без `.env` — `up` упадёт, `VITE_BASE` — build-arg `wordpdf-web/Dockerfile` — репо-compose НЕ передаёт: `compose build` без arg даёт base `/` и битые ассеты под префиксом, прод передаёт arg по DEPLOY.md). Запуск по просьбе пользователя = прод-стек; dev/`java -jar`/`npm run dev` — внутренняя отладка.
|
Деплой. **Прод** — на пользовательском LAN-сервере (podman 5.8.2 + podman-compose 1.6.0, бинарников `docker`/`docker-compose` на сервере нет); координаты сервера, каталог, restart-секвенция, ключ и гейты успешности — вне репо: `/home/pjandro/prod/java-word-pdf/DEPLOY.md` (обязательно прочитать перед любым деплоем/перезапуском; в том каталоге лежат архивные файлы старого стека 88.14 — `restart.sh.old-88.14`, старый compose/nginx — **не поднимать**). Единая точка входа с dev-машины — `/home/pjandro/prod/java-word-pdf/restart.sh` (пробрасывает флаги удалённому скрипту: `--build` — пересборка образов из `origin/main` + перезапуск; без флага — restart контейнеров; предупреждает о не запушенном в `main`). В прод попадает только запушенное в `main` — рабочее дерево на сборку не влияет. Прод-compose `/opt/wordpdf/docker-compose.yml` (вне git) содержит podman-специфику: `x-podman.name_separator_compat` (имена `wordpdf-prod-app-1`, от них зависит `restart.sh`), явные healthcheck app/web и фиксированную подсеть `10.112.0.0/24` gw `10.112.0.1`. Наружный вход `https://pjandro.ru/pdf-converter/` (префикс срезает наружный nginx прод-хоста, не репозиторный gateway-конф; прод-копия gateway-конфа отличается от репо только резолвером `10.112.0.1` — под свою подсеть — и `proxy_read_timeout 300s` — в репо его нет, дефолтные 60s рвут 2-минутные конвертации; resolver + `proxy_pass` через переменную есть и там и там). Тот же наружный nginx в `location /pdf-converter/` добавляет `X-Forwarded-Host: $host` и `X-Forwarded-Prefix: /pdf-converter` — из них springdoc собирает server-URL спека и swagger-config под префиксом (без `X-Forwarded-Host` server = `https://app:8080`, gateway шлёт приложению `Host: app:8080`); канонический URL документации `https://pjandro.ru/pdf-converter/swagger-ui.html` — открыт без ключа. **Dev-стенд** — из репо `compose.dev.yml` (проект `wordpdf-dev`, `9011:80` на все интерфейсы — вход по LAN-IP хоста, без env → ключ пуст, springdoc вкл). Репозиторный `compose.yml` — третий вариант (проект `wordpdf`, `9010:80` на все интерфейсы, `WORDPDF_API_KEY` fail-closed без `.env` — `up` упадёт, `VITE_BASE` — build-arg `wordpdf-web/Containerfile` — репо-compose НЕ передаёт: `compose build` без arg даёт base `/` и битые ассеты под префиксом, прод передаёт arg по DEPLOY.md). Запуск по просьбе пользователя = прод-стек; dev/`java -jar`/`npm run dev` — внутренняя отладка.
|
||||||
|
|
||||||
## Code Conventions & Common Patterns
|
## Code Conventions & Common Patterns
|
||||||
|
|
||||||
@@ -104,11 +105,12 @@ 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` (нужен Docker 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).
|
||||||
- Корневой `pom.xml` — все версии зависимостей (в модулях версии не объявлять): docx4j `17.3.2`, slf4j `2.0.20`, JUnit `6.1.3`, PDFBox `3.0.8` (test), POI `5.5.1` (compile в core — `poi-scratchpad`, ветка `.doc`; test — `poi-ooxml`, генератор фикстур), Spring Boot `4.1.1` (BOM-import), springdoc `3.1.1`; pluginManagement: compiler `3.16.0`, surefire `3.6.0` с `-Djava.awt.headless=true`, jar `3.5.1`.
|
- Корневой `pom.xml` — все версии зависимостей (в модулях версии не объявлять): docx4j `17.3.2`, slf4j `2.0.20`, JUnit `6.1.3`, PDFBox `3.0.8` (test), POI `5.5.1` (compile в core — `poi-scratchpad`, ветка `.doc`; test — `poi-ooxml`, генератор фикстур), Spring Boot `4.1.1` (BOM-import), springdoc `3.1.1`; pluginManagement: compiler `3.16.0`, surefire `3.6.0` с `-Djava.awt.headless=true`, jar `3.5.1`.
|
||||||
|
- Корневой `pmd-ruleset.xml` — ruleset PMD (см. Testing & QA): `category/java/codestyle.xml` минус opinionated-правила, `MethodNamingConventions` с `junit5TestPattern` под underscore-имена регрессий, `TooManyStaticImports` до 12, XPath-правило `LiteralFirstInEquals`, unused-правила из `bestpractices.xml`.
|
||||||
- `wordpdf-core/src/main/resources/slf4j-simple.properties` — без него предупреждение лезет в PDF.
|
- `wordpdf-core/src/main/resources/slf4j-simple.properties` — без него предупреждение лезет в PDF.
|
||||||
- `gateway/nginx.conf` — единственный вход: `/api/`, `/swagger-ui`, `/v3/api-docs`, `/actuator` → `app:8080`, остальное → `web:80`; `client_max_body_size 100m` (без директивы upload режется HTML-413 шлюза вместо JSON-ошибки API). `wordpdf-web/nginx.conf` — чистая статика с SPA-fallback, `/api` НЕ проксирует.
|
- `gateway/nginx.conf` — единственный вход: `/api/`, `/swagger-ui`, `/v3/api-docs`, `/actuator` → `app:8080`, остальное → `web:80`; `client_max_body_size 100m` (без директивы upload режется HTML-413 шлюза вместо JSON-ошибки API). `wordpdf-web/nginx.conf` — чистая статика с SPA-fallback, `/api` НЕ проксирует.
|
||||||
- `wordpdf-core/src/test/java/ru/pjandro/wordpdf/SampleDocxGenerator.java` — main()-утилита пересоздания фикстур.
|
- `wordpdf-core/src/test/java/ru/pjandro/wordpdf/SampleDocxGenerator.java` — main()-утилита пересоздания фикстур.
|
||||||
@@ -118,18 +120,19 @@ java -cp wordpdf-core/target/test-classes:$(cat /tmp/cp.txt) \
|
|||||||
|
|
||||||
- Java 21 + Maven (обязательны; wrapper `mvnw` нет); UTF-8. Только Maven — никакого Gradle/Ant.
|
- Java 21 + Maven (обязательны; wrapper `mvnw` нет); UTF-8. Только Maven — никакого Gradle/Ant.
|
||||||
- Версии зависимостей — только в корневом `pom.xml` (properties + dependencyManagement); новые зависимости — latest stable.
|
- Версии зависимостей — только в корневом `pom.xml` (properties + dependencyManagement); новые зависимости — latest stable.
|
||||||
- Фронт: Node `^20.19.0 || >=22.12.0` (engines vite/oxlint из lockfile), npm с закоммиченным `package-lock.json` (`npm ci`); vite `^8.3.0`, React `^19.2`, TS `~6.0` (**`strict` нигде не включён** — `npm run build` не является strict-гейтом), Tailwind `^4.3`, oxlint `^1.81`; docker-сборка web на `node:24-alpine`.
|
- Фронт: Node `^20.19.0 || >=22.12.0` (engines vite/oxlint из lockfile), npm с закоммиченным `package-lock.json` (`npm ci`); vite `^8.3.0`, React `^19.2`, TS `~6.0` (**`strict` нигде не включён** — `npm run build` не является strict-гейтом), Tailwind `^4.3`, oxlint `^1.81`; podman-сборка web на `node:24-alpine`.
|
||||||
- CI, линтеров, форматтеров, checkstyle для Java — нет; проверка одна: `mvn clean verify`.
|
- CI, форматтеров, checkstyle для Java — нет; статический линтер — PMD на `verify` (см. Testing & QA); проверка одна: `mvn clean verify`.
|
||||||
- Исполняемый jar бэкенда проверять только `java -jar` (тесты идут по classpath и repackage-специфику не видят; `BundledFontsTest#listedFilesCoverAllTtfInResources` требует `file:`-протокол classpath — только surefire, не fat-jar).
|
- Исполняемый jar бэкенда проверять только `java -jar` (тесты идут по classpath и repackage-специфику не видят; `BundledFontsTest#listedFilesCoverAllTtfInResources` требует `file:`-протокол classpath — только surefire, не fat-jar).
|
||||||
- Git: origin `git.pjandro.ru:pjandro/java-word-pdf`, `main`/`dev` защищены (правила глобального AGENTS.md; локально только `main`, `dev` нет; на origin висит остаточная смерженная `docs/regenerate-agents-md`).
|
- Git: origin `git.pjandro.ru:pjandro/java-word-pdf`, `main`/`dev` защищены (правила глобального AGENTS.md; локально только `main`, `dev` нет; на origin висит остаточная смерженная `docs/regenerate-agents-md`).
|
||||||
|
|
||||||
## Testing & QA
|
## Testing & QA
|
||||||
|
|
||||||
- 15 тестовых классов / 142 `@Test` (core 12/116, app 3/26). JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true` в argLine; только `Assertions` (Mockito/AssertJ не использовать, несмотря на test-classpath Boot; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`); тестовые классы package-private, зеркалят main-пакеты; только `@Test` (+ единственный `@BeforeAll` — warm-up шрифтов в `GlyphCoverageNormalizerTest`).
|
- Гейт `maven-pmd-plugin` 3.28.0 (PMD 7.17) на `verify` для обоих модулей, ruleset `pmd-ruleset.xml` (codestyle без opinionated-правил + unused-правила + XPath `LiteralFirstInEquals` — строковый литерал слева в `equals`/`equalsIgnoreCase`; `junit5TestPattern` разрешает underscore-имена регрессий; `includeTests=true` — тесты сканируются).
|
||||||
|
- 15 тестовых классов / 145 `@Test` (core 12/116, app 3/29). JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true` в argLine; только `Assertions` (Mockito/AssertJ не использовать, несмотря на test-classpath Boot; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`); тестовые классы package-private, зеркалят main-пакеты; только `@Test` (+ единственный `@BeforeAll` — warm-up шрифтов в `GlyphCoverageNormalizerTest`).
|
||||||
- **PDF сравнивается текстом, не растеризацией**: PDFBox 3 (`Loader.loadPDF`) — `PDFTextStripper` для текста (пер-странично `setStartPage/setEndPage`), override `processTextPosition` для шрифта конкретного символа (`fontNameOf`), обход ресурсов страниц для встроенных шрифтов (`EAAAAA+Carlito-Bold`) и счётчика картинок (`imageCount`). Негативные маркеры — регрессии: `assertFalse(text.contains("#"))` (.notdef), `assertFalse(font.startsWith("Helvetica"))`. Текст нормализуется по пробелам (`norm`); в `tableImage_tableAndImage` — полное удаление пробелов (docx4j переносит слова в auto-fit таблицах). В `DocToPdfTest` маркер `#` НЕ проверяется: в `.doc`-ветке нет `GlyphCoverageNormalizer`, экзотические глифы легально остаются `.notdef`, а PDFBox «ремонтирует» подмножества установленных в системе шрифтов и извлекает `#` — текст/assertions только по Tinos/Carlito-ранам.
|
- **PDF сравнивается текстом, не растеризацией**: PDFBox 3 (`Loader.loadPDF`) — `PDFTextStripper` для текста (пер-странично `setStartPage/setEndPage`), override `processTextPosition` для шрифта конкретного символа (`fontNameOf`), обход ресурсов страниц для встроенных шрифтов (`EAAAAA+Carlito-Bold`) и счётчика картинок (`imageCount`). Негативные маркеры — регрессии: `assertFalse(text.contains("#"))` (.notdef), `assertFalse(font.startsWith("Helvetica"))`. Текст нормализуется по пробелам (`norm`); в `tableImage_tableAndImage` — полное удаление пробелов (docx4j переносит слова в auto-fit таблицах). В `DocToPdfTest` маркер `#` НЕ проверяется: в `.doc`-ветке нет `GlyphCoverageNormalizer`, экзотические глифы легально остаются `.notdef`, а PDFBox «ремонтирует» подмножества установленных в системе шрифтов и извлекает `#` — текст/assertions только по Tinos/Carlito-ранам.
|
||||||
- Пиксели (BufferedImage) — только в unit-тестах chart-пейнтеров, допуски 6–10% против эталона Word (`PiePainterTest` аспект h/w=0.585, `assertRatio` отклонение <0.06; `Surface3dPainterTest` `assertRange` ±6 pt для центров силуэта + `assertRatio` допуск 0.10 для геометрических отношений; shading — не допуск, а перцентильные коридоры яркости p5∈[0.74,0.90], median∈[0.90,1.10], p95∈[1.02,1.20]).
|
- Пиксели (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/*` (12; в тестах не генерировать): core грузит classpath-ресурсом → `byte[]`, PDF для PDFBox — временный файл; app читает `/samples/…` из **test-jar core** (classifier `tests`) → `mvn -pl wordpdf-app` без `-am` не соберётся. In-memory docx — `ZipOutputStream` из литеральных XML или POI в `byte[]`. Ключевые: `too-many-pages` (150 явных разрывов → 151), `stale-cache` (кэш `<Pages>1</Pages>` + 110 `lastRenderedPageBreak`), `charts-smartart` (4 растра; SmartArt-одиночка = ровно 2 Image XObject), `legacy-doc.doc` (реальный Word 97-2003: 43 картинки, колонтитулы с PAGE-полем, кэш `Pages=12`).
|
- Фикстуры — закоммиченные `samples/*` (12: 11 `.docx` + `legacy-doc.doc`; в тестах не генерировать): core грузит classpath-ресурсом → `byte[]`, PDF для PDFBox — временный файл; app читает `/samples/…` из **test-jar core** (classifier `tests`) → `mvn -pl wordpdf-app` без `-am` не соберётся. In-memory docx — `ZipOutputStream` из литеральных XML или POI в `byte[]`. Ключевые: `too-many-pages` (150 явных разрывов → 151), `stale-cache` (кэш `<Pages>1</Pages>` + 110 `lastRenderedPageBreak`), `charts-smartart` (4 растра; SmartArt-одиночка = ровно 2 Image XObject), `legacy-doc.doc` (реальный Word 97-2003: 43 картинки, колонтитулы с PAGE-полем, кэш `Pages=12`).
|
||||||
- Юниты нормализаторов работают строками (`rewrite`) + zip'ами из `ZipOutputStream`; обязательные контракты: «нечего менять → тот же массив» (`assertSame` покрыт тестами только у zip-нормализаторов `DocxOnOff`/`SymbolFont`/`StrictOoxml`; у `Field`/`GlyphCoverage` — `rewrite`→`null`) и неприкосновенность частей вне `word/*.xml` (`[Content_Types].xml`). Тесты бьют и в package-private API (`GlyphCoverageNormalizer.split(text, family)`, `pageCountOf`, `ChartSpec.readTitle`).
|
- Юниты нормализаторов работают строками (`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`), `DocToPdfTest`↔`DocToPdfRenderer` (`legacyDoc_convertsToPdf` — Tinos/Carlito без Helvetica + 43 картинки; `legacyDoc_footersCarryPageNumbers` — инъекция колонтитулов + PAGE; `ole2Junk_rejected`; `legacyDoc_fontCacheNotWrittenToWorkingDir` — кэш шрифтов не в CWD (контейнер: /app не пишется)); `noLoggingWarningInPdf` — регрессия `slf4j-simple`, `pdfTitle_comesFromParameter` — регрессия PDF-title (юнит-партнёра нет). App-регрессии: `requestLimitParams_areIgnored`, `nonPositiveLimits_failStartup`, `unknownPath_notFound`, `concurrentRequests_bothSucceed` (гонка реестра `PhysicalFonts`), `corruptNotAZip_rejected`, `junkInsideValidZip_conversionError`, `nonDocxFilename_rejected`, `oversizedOverCoreLimit_rejected`, `renderFlagsOff_convertsWithoutDrawings`, `cyrillicAndPathInFilename_sanitizedResponseName` (RFC 5987 + path-traversal), `docsOpenWithoutKey`/`forwardedPrefix_healthStaysOpen`/`forwardedPrefix_docsOpenWithoutKey` (открытая документация + матч фильтра без forwarded-contextPath), `legacyDoc_convertsToPdf` (OLE2-развилка `ConversionService.validate` + заголовок `X-Wordpdf-Degraded`).
|
- Регрессивные пары (фикс = нормализатор/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_neitherDocxNorDoc`↔`inputNotAZip_rejectedBeforeRender`), `BundledFontsTest`↔`ruPlain_emDashEmbeddedNotHelvetica`, `ChartSpecTest`↔автозаголовки, chart-пейнтеры↔`chartsSmartArt_drawingsBecomeImages` (+`drawingToggles_offRemovesRasters`/`drawingToggles_chartsOffSmartArtOn`), `DocToPdfTest`↔`DocToPdfRenderer` (`legacyDoc_convertsToPdf` — Tinos/Carlito без Helvetica + 43 картинки; `legacyDoc_footersCarryPageNumbers` — инъекция колонтитулов + PAGE; `ole2Junk_rejected`; `legacyDoc_fontCacheNotWrittenToWorkingDir` — кэш шрифтов не в CWD (контейнер: /app не пишется)); `noLoggingWarningInPdf` — регрессия `slf4j-simple`, `pdfTitle_comesFromParameter` — регрессия PDF-title (юнит-партнёра нет). App-регрессии: `requestLimitParams_areIgnored`, `nonPositiveLimits_failStartup`, `unknownPath_notFound`, `concurrentRequests_bothSucceed` (гонка реестра `PhysicalFonts`), `corruptNotAZip_rejected`, `junkInsideValidZip_conversionError`, `nonDocxFilename_rejected`, `oversizedOverCoreLimit_rejected`, `renderFlagsOff_convertsWithoutDrawings`, `cyrillicAndPathInFilename_sanitizedResponseName` (RFC 5987 + path-traversal), `docsOpenWithoutKey`/`forwardedPrefix_healthStaysOpen`/`forwardedPrefix_docsOpenWithoutKey` (открытая документация + матч фильтра без forwarded-contextPath), `legacyDoc_convertsToPdf` (OLE2-развилка валидации ядра + заголовок `X-Wordpdf-Degraded`).
|
||||||
- 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).
|
||||||
|
|||||||
@@ -1,4 +1,6 @@
|
|||||||
FROM maven:3.9-eclipse-temurin-21 AS build
|
# FROM с полным именем реестра: podman не резолвит short-name без
|
||||||
|
# unqualified-search-registries в /etc/containers/registries.conf.
|
||||||
|
FROM docker.io/library/maven:3.9-eclipse-temurin-21 AS build
|
||||||
WORKDIR /build
|
WORKDIR /build
|
||||||
COPY pom.xml .
|
COPY pom.xml .
|
||||||
COPY wordpdf-core/pom.xml wordpdf-core/
|
COPY wordpdf-core/pom.xml wordpdf-core/
|
||||||
@@ -7,11 +9,12 @@ RUN mvn -B -q dependency:go-offline
|
|||||||
COPY . .
|
COPY . .
|
||||||
RUN mvn -B -q -DskipTests package
|
RUN mvn -B -q -DskipTests package
|
||||||
|
|
||||||
FROM eclipse-temurin:21-jre
|
FROM docker.io/library/eclipse-temurin:21-jre
|
||||||
# curl — только для HEALTHCHECK; runtime полный jre (не alpine-slim): Java2D
|
# curl — только для HEALTHCHECK; runtime полный jre (не alpine-slim): Java2D
|
||||||
# chart-движка нужны AWT и fontconfig-нативки; бандл-шрифты лежат в jar,
|
# chart-движка нужны AWT и fontconfig-нативки; бандл-шрифты лежат в jar,
|
||||||
# системные шрифты не нужны. Тесты в образе не гоняем — гейт mvn clean verify.
|
# системные шрифты не нужны. Тесты в образе не гоняем — гейт mvn clean verify.
|
||||||
# Прокси из docker-config подмешивается в HEALTHCHECK-шелл и ломает curl
|
# Прокси-переменные хоста (HTTP_PROXY/HTTPS_PROXY/http_proxy/https_proxy)
|
||||||
|
# podman/buildah подмешивает в шелл RUN/HEALTHCHECK и ломает curl
|
||||||
# (127.0.0.1:proxy внутри контейнера недоступен) — обнуляем на команде.
|
# (127.0.0.1:proxy внутри контейнера недоступен) — обнуляем на команде.
|
||||||
RUN apt-get update \
|
RUN apt-get update \
|
||||||
&& apt-get install -y --no-install-recommends curl \
|
&& apt-get install -y --no-install-recommends curl \
|
||||||
@@ -86,17 +86,17 @@ Files.write(Path.of("out.pdf"), pdf);
|
|||||||
больше ста) бросают `ConversionException`. Работа с файлами — забота
|
больше ста) бросают `ConversionException`. Работа с файлами — забота
|
||||||
вызывающего: ядро пути не принимает.
|
вызывающего: ядро пути не принимает.
|
||||||
|
|
||||||
### Веб-интерфейс и Docker
|
### Веб-интерфейс и контейнеры (podman)
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
docker compose up -d --build
|
podman-compose up -d --build
|
||||||
```
|
```
|
||||||
|
|
||||||
Всё на `http://localhost:8080/`: nginx-контейнер `web` раздаёт SPA и проксирует
|
Всё на `http://localhost:8080/`: nginx-контейнер `web` раздаёт SPA и проксирует
|
||||||
`/api`, `/swagger-ui`, `/v3/api-docs` на бэкенд (контейнер `app` наружу не
|
`/api`, `/swagger-ui`, `/v3/api-docs` на бэкенд (контейнер `app` наружу не
|
||||||
публикуется).
|
публикуется).
|
||||||
|
|
||||||
Dev-режим без Docker: бэкенд `java -jar wordpdf-app/target/wordpdf-app-1.0.0.jar`
|
Dev-режим без контейнеров: бэкенд `java -jar wordpdf-app/target/wordpdf-app-1.0.0.jar`
|
||||||
(порт 8080) + `npm run dev` в `wordpdf-web/` → `http://localhost:5173`
|
(порт 8080) + `npm run dev` в `wordpdf-web/` → `http://localhost:5173`
|
||||||
(Vite проксирует `/api` на 8080, CORS не нужен).
|
(Vite проксирует `/api` на 8080, CORS не нужен).
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1,54 @@
|
|||||||
|
# Dev-стенд без ключа доступа: WORDPDF_API_KEY не задан → wordpdf.api-key пуст
|
||||||
|
# → ApiKeyFilter прозрачен, springdoc включён. Проект wordpdf-dev — собственные
|
||||||
|
# образы/контейнеры, с прод-запуском (wordpdf-prod, :9010) не конфликтует.
|
||||||
|
# Запуск: podman-compose -f compose.dev.yml up -d --build
|
||||||
|
# Вход: http://<LAN-IP хоста>:9011 (доступен из локальной сети; hostname -I на хосте)
|
||||||
|
name: wordpdf-dev
|
||||||
|
# podman-compose по умолчанию разделяет имя проекта/сервиса/номера подчёркиванием
|
||||||
|
# (wordpdf-dev_app_1). Compat-флаг возвращает docker-style имена (wordpdf-dev-app-1).
|
||||||
|
x-podman:
|
||||||
|
name_separator_compat: true
|
||||||
|
services:
|
||||||
|
app:
|
||||||
|
build: .
|
||||||
|
restart: unless-stopped
|
||||||
|
# Дублирует HEALTHCHECK из Containerfile: podman выгружает образы в OCI,
|
||||||
|
# где поля healthcheck нет — без явного healthcheck depends_on
|
||||||
|
# service_healthy ждал бы healthy вечно. Прокси обнуляем на команде.
|
||||||
|
healthcheck:
|
||||||
|
test: ["CMD-SHELL", "HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= curl -fsS http://127.0.0.1:8080/actuator/health >/dev/null || exit 1"]
|
||||||
|
interval: 10s
|
||||||
|
timeout: 3s
|
||||||
|
start_period: 45s
|
||||||
|
retries: 5
|
||||||
|
web:
|
||||||
|
build: ./wordpdf-web
|
||||||
|
restart: unless-stopped
|
||||||
|
# См. комментарий у app: дубль HEALTHCHECK из wordpdf-web/Containerfile
|
||||||
|
healthcheck:
|
||||||
|
test: ["CMD-SHELL", "http_proxy= https_proxy= wget -qO /dev/null http://127.0.0.1/ || exit 1"]
|
||||||
|
interval: 10s
|
||||||
|
timeout: 3s
|
||||||
|
start_period: 10s
|
||||||
|
gateway:
|
||||||
|
image: docker.io/library/nginx:alpine
|
||||||
|
volumes:
|
||||||
|
- ./gateway/nginx.conf:/etc/nginx/conf.d/default.conf:ro
|
||||||
|
ports: ["9011:80"]
|
||||||
|
depends_on:
|
||||||
|
app:
|
||||||
|
condition: service_healthy
|
||||||
|
web:
|
||||||
|
condition: service_healthy
|
||||||
|
restart: unless-stopped
|
||||||
|
|
||||||
|
networks:
|
||||||
|
# Подсеть зафиксирована намеренно: nginx в gateway/nginx.conf резолвит app/web
|
||||||
|
# через aardvark-dns на шлюзе сети (10.113.0.1), адрес обязан быть
|
||||||
|
# предсказуемым. Оба repo-стенда делят её осознанно: они взаимоисключающие
|
||||||
|
# варианты отладки, одновременно не поднимаются.
|
||||||
|
default:
|
||||||
|
ipam:
|
||||||
|
config:
|
||||||
|
- subnet: 10.113.0.0/24
|
||||||
|
gateway: 10.113.0.1
|
||||||
+59
@@ -0,0 +1,59 @@
|
|||||||
|
name: wordpdf
|
||||||
|
# podman-compose по умолчанию разделяет имя проекта/сервиса/номера подчёркиванием
|
||||||
|
# (wordpdf_app_1). Compat-флаг возвращает docker-style имена (wordpdf-app-1).
|
||||||
|
x-podman:
|
||||||
|
name_separator_compat: true
|
||||||
|
services:
|
||||||
|
app:
|
||||||
|
build: .
|
||||||
|
restart: unless-stopped
|
||||||
|
# Дублирует HEALTHCHECK из Containerfile: podman выгружает образы в OCI,
|
||||||
|
# где поля healthcheck нет — без явного healthcheck depends_on
|
||||||
|
# service_healthy ждал бы healthy вечно. Прокси обнуляем на команде.
|
||||||
|
healthcheck:
|
||||||
|
test: ["CMD-SHELL", "HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= curl -fsS http://127.0.0.1:8080/actuator/health >/dev/null || exit 1"]
|
||||||
|
interval: 10s
|
||||||
|
timeout: 3s
|
||||||
|
start_period: 45s
|
||||||
|
retries: 5
|
||||||
|
environment:
|
||||||
|
# без ключа стек не поднимется (:? на пустое/unset) — прод fail-closed
|
||||||
|
WORDPDF_API_KEY: "${WORDPDF_API_KEY:?WORDPDF_API_KEY not set: put it in .env (openssl rand -hex 32)}"
|
||||||
|
# документация в прод-интернете не нужна (в dev/java -jar остаётся включена)
|
||||||
|
SPRINGDOC_API_DOCS_ENABLED: "false"
|
||||||
|
SPRINGDOC_SWAGGER_UI_ENABLED: "false"
|
||||||
|
# лимиты входа (байты/страницы); значение из .env, иначе дефолты ядра;
|
||||||
|
# интерполяция :- подставляет и на unset, и на пустое — пустая строка
|
||||||
|
# сломала бы binding long/int
|
||||||
|
WORDPDF_MAX_BYTES: "${WORDPDF_MAX_BYTES:-5242880}"
|
||||||
|
WORDPDF_MAX_PAGES: "${WORDPDF_MAX_PAGES:-100}"
|
||||||
|
web:
|
||||||
|
build: ./wordpdf-web
|
||||||
|
restart: unless-stopped
|
||||||
|
# См. комментарий у app: дубль HEALTHCHECK из wordpdf-web/Containerfile
|
||||||
|
healthcheck:
|
||||||
|
test: ["CMD-SHELL", "http_proxy= https_proxy= wget -qO /dev/null http://127.0.0.1/ || exit 1"]
|
||||||
|
interval: 10s
|
||||||
|
timeout: 3s
|
||||||
|
start_period: 10s
|
||||||
|
gateway:
|
||||||
|
image: docker.io/library/nginx:alpine
|
||||||
|
volumes:
|
||||||
|
- ./gateway/nginx.conf:/etc/nginx/conf.d/default.conf:ro
|
||||||
|
ports: ["9010:80"]
|
||||||
|
depends_on:
|
||||||
|
app:
|
||||||
|
condition: service_healthy
|
||||||
|
web:
|
||||||
|
condition: service_healthy
|
||||||
|
restart: unless-stopped
|
||||||
|
|
||||||
|
networks:
|
||||||
|
# Подсеть зафиксирована намеренно: nginx в gateway/nginx.conf резолвит app/web
|
||||||
|
# через aardvark-dns на шлюзе сети (10.113.0.1), адрес обязан быть
|
||||||
|
# предсказуемым. Отличается от прод-10.112.0.0/24, чтобы стенды не конфликтовали.
|
||||||
|
default:
|
||||||
|
ipam:
|
||||||
|
config:
|
||||||
|
- subnet: 10.113.0.0/24
|
||||||
|
gateway: 10.113.0.1
|
||||||
@@ -1,24 +0,0 @@
|
|||||||
# Dev-стенд без ключа доступа: WORDPDF_API_KEY не задан → wordpdf.api-key пуст
|
|
||||||
# → ApiKeyFilter прозрачен, springdoc включён. Проект wordpdf-dev — собственные
|
|
||||||
# образы/контейнеры, с прод-запуском (wordpdf-prod, :9010) не конфликтует.
|
|
||||||
# Запуск: docker compose -f docker-compose.dev.yml up --build
|
|
||||||
# Вход: http://127.0.0.1:9011
|
|
||||||
name: wordpdf-dev
|
|
||||||
services:
|
|
||||||
app:
|
|
||||||
build: .
|
|
||||||
restart: unless-stopped
|
|
||||||
web:
|
|
||||||
build: ./wordpdf-web
|
|
||||||
restart: unless-stopped
|
|
||||||
gateway:
|
|
||||||
image: nginx:alpine
|
|
||||||
volumes:
|
|
||||||
- ./gateway/nginx.conf:/etc/nginx/conf.d/default.conf:ro
|
|
||||||
ports: ["127.0.0.1:9011:80"]
|
|
||||||
depends_on:
|
|
||||||
app:
|
|
||||||
condition: service_healthy
|
|
||||||
web:
|
|
||||||
condition: service_healthy
|
|
||||||
restart: unless-stopped
|
|
||||||
@@ -1,30 +0,0 @@
|
|||||||
name: wordpdf
|
|
||||||
services:
|
|
||||||
app:
|
|
||||||
build: .
|
|
||||||
restart: unless-stopped
|
|
||||||
environment:
|
|
||||||
# без ключа стек не поднимется (:? на пустое/unset) — прод fail-closed
|
|
||||||
WORDPDF_API_KEY: "${WORDPDF_API_KEY:?WORDPDF_API_KEY not set: put it in .env (openssl rand -hex 32)}"
|
|
||||||
# документация в прод-интернете не нужна (в dev/java -jar остаётся включена)
|
|
||||||
SPRINGDOC_API_DOCS_ENABLED: "false"
|
|
||||||
SPRINGDOC_SWAGGER_UI_ENABLED: "false"
|
|
||||||
# лимиты входа (байты/страницы); значение из .env, иначе дефолты ядра;
|
|
||||||
# интерполяция :- подставляет и на unset, и на пустое — пустая строка
|
|
||||||
# сломала бы binding long/int
|
|
||||||
WORDPDF_MAX_BYTES: "${WORDPDF_MAX_BYTES:-20971520}"
|
|
||||||
WORDPDF_MAX_PAGES: "${WORDPDF_MAX_PAGES:-1000}"
|
|
||||||
web:
|
|
||||||
build: ./wordpdf-web
|
|
||||||
restart: unless-stopped
|
|
||||||
gateway:
|
|
||||||
image: nginx:alpine
|
|
||||||
volumes:
|
|
||||||
- ./gateway/nginx.conf:/etc/nginx/conf.d/default.conf:ro
|
|
||||||
ports: ["9010:80"]
|
|
||||||
depends_on:
|
|
||||||
app:
|
|
||||||
condition: service_healthy
|
|
||||||
web:
|
|
||||||
condition: service_healthy
|
|
||||||
restart: unless-stopped
|
|
||||||
+16
-6
@@ -4,12 +4,22 @@ 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;
|
||||||
location /api/ { proxy_pass http://app:8080; }
|
# app/web резолвятся aardvark-dns, который сидит на шлюзе сети стека
|
||||||
location /swagger-ui { proxy_pass http://app:8080; }
|
# (подсеть зафиксирована в compose.yml / compose.dev.yml, адрес стабилен).
|
||||||
location /v3/api-docs { proxy_pass http://app:8080; }
|
# Статический proxy_pass резолвит имя ровно один раз при старте nginx:
|
||||||
|
# если gateway поднялся раньше app (так стартует podman-restart.service при
|
||||||
|
# загрузке хоста), апстрим навсегда оставался мёртвым — 502 до перезапуска
|
||||||
|
# gateway. resolver + переменная заставляют резолвить на каждый запрос.
|
||||||
|
resolver 10.113.0.1 valid=10s ipv6=off;
|
||||||
|
set $upstream_app http://app:8080;
|
||||||
|
set $upstream_web http://web:80;
|
||||||
|
|
||||||
|
location /api/ { proxy_pass $upstream_app; }
|
||||||
|
location /swagger-ui { proxy_pass $upstream_app; }
|
||||||
|
location /v3/api-docs { proxy_pass $upstream_app; }
|
||||||
# открыт фильтром приложения (wordpdf.api-key его не проверяет) — мониторинг/HEALTHCHECK снаружи
|
# открыт фильтром приложения (wordpdf.api-key его не проверяет) — мониторинг/HEALTHCHECK снаружи
|
||||||
location /actuator { proxy_pass http://app:8080; }
|
location /actuator { proxy_pass $upstream_app; }
|
||||||
location / { proxy_pass http://web:80; }
|
location / { proxy_pass $upstream_web; }
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,66 @@
|
|||||||
|
<?xml version="1.0"?>
|
||||||
|
<ruleset name="WordPDF code style" xmlns="http://pmd.sourceforge.net/ruleset/2.0.0"
|
||||||
|
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||||
|
xsi:schemaLocation="http://pmd.sourceforge.net/ruleset/2.0.0 https://pmd.sourceforge.io/ruleset_2_0_0.xsd">
|
||||||
|
<description>Код-стиль java-word-pdf: codestyle без opinionated-правил + unused-правила + NPE-safe equals</description>
|
||||||
|
|
||||||
|
<rule ref="category/java/codestyle.xml">
|
||||||
|
<!-- opinionated/шумные, намеренно выключены -->
|
||||||
|
<exclude name="AtLeastOneConstructor"/>
|
||||||
|
<exclude name="CallSuperInConstructor"/>
|
||||||
|
<exclude name="CommentDefaultAccessModifier"/>
|
||||||
|
<exclude name="ConfusingTernary"/>
|
||||||
|
<exclude name="FieldDeclarationsShouldBeAtStartOfClass"/>
|
||||||
|
<exclude name="LocalVariableCouldBeFinal"/>
|
||||||
|
<exclude name="LongVariable"/>
|
||||||
|
<exclude name="MethodArgumentCouldBeFinal"/>
|
||||||
|
<exclude name="OnlyOneReturn"/>
|
||||||
|
<exclude name="PrematureDeclaration"/>
|
||||||
|
<exclude name="ShortMethodName"/>
|
||||||
|
<exclude name="ShortVariable"/>
|
||||||
|
<exclude name="UseExplicitTypes"/>
|
||||||
|
<exclude name="UseUnderscoresInNumericLiterals"/>
|
||||||
|
<!-- переопределены ниже -->
|
||||||
|
<exclude name="MethodNamingConventions"/>
|
||||||
|
<exclude name="TooManyStaticImports"/>
|
||||||
|
</rule>
|
||||||
|
|
||||||
|
<!-- регрессионные тесты репо именуются объект_условие (AGENTS.md) -->
|
||||||
|
<rule ref="category/java/codestyle.xml/MethodNamingConventions">
|
||||||
|
<properties>
|
||||||
|
<property name="junit5TestPattern" value="^[a-z][a-zA-Z0-9]*(_[a-zA-Z0-9]+)*$"/>
|
||||||
|
</properties>
|
||||||
|
</rule>
|
||||||
|
|
||||||
|
<!-- MockMvc-тесты: >4 статических импортов — норма -->
|
||||||
|
<rule ref="category/java/codestyle.xml/TooManyStaticImports">
|
||||||
|
<properties>
|
||||||
|
<property name="maximumStaticImports" value="12"/>
|
||||||
|
</properties>
|
||||||
|
</rule>
|
||||||
|
|
||||||
|
<!-- PMD 7 удалил EqualsAvoidsNull; NPE-safe порядок операндов: литерал слева -->
|
||||||
|
<rule name="LiteralFirstInEquals" language="java"
|
||||||
|
message="NPE-safe сравнение строк: строковый литерал должен стоять слева: "lit".equals(x)"
|
||||||
|
class="net.sourceforge.pmd.lang.rule.xpath.XPathRule">
|
||||||
|
<priority>3</priority>
|
||||||
|
<properties>
|
||||||
|
<property name="xpath">
|
||||||
|
<value><![CDATA[
|
||||||
|
//MethodCall[
|
||||||
|
(@MethodName = 'equals' or @MethodName = 'equalsIgnoreCase')
|
||||||
|
and ArgumentList/StringLiteral
|
||||||
|
and not(*[1][self::StringLiteral
|
||||||
|
or (self::VariableAccess and @CompileTimeConstant = true())])
|
||||||
|
]
|
||||||
|
]]></value>
|
||||||
|
</property>
|
||||||
|
</properties>
|
||||||
|
</rule>
|
||||||
|
|
||||||
|
<rule ref="category/java/bestpractices.xml/UnusedAssignment"/>
|
||||||
|
<rule ref="category/java/bestpractices.xml/UnusedFormalParameter"/>
|
||||||
|
<rule ref="category/java/bestpractices.xml/UnusedLocalVariable"/>
|
||||||
|
<rule ref="category/java/bestpractices.xml/UnusedPrivateField"/>
|
||||||
|
<rule ref="category/java/bestpractices.xml/UnusedPrivateMethod"/>
|
||||||
|
</ruleset>
|
||||||
@@ -122,6 +122,28 @@
|
|||||||
<artifactId>maven-jar-plugin</artifactId>
|
<artifactId>maven-jar-plugin</artifactId>
|
||||||
<version>3.5.1</version>
|
<version>3.5.1</version>
|
||||||
</plugin>
|
</plugin>
|
||||||
|
<plugin>
|
||||||
|
<groupId>org.apache.maven.plugins</groupId>
|
||||||
|
<artifactId>maven-pmd-plugin</artifactId>
|
||||||
|
<version>3.28.0</version>
|
||||||
|
<configuration>
|
||||||
|
<rulesets>
|
||||||
|
<ruleset>${maven.multiModuleProjectDirectory}/pmd-ruleset.xml</ruleset>
|
||||||
|
</rulesets>
|
||||||
|
<includeTests>true</includeTests>
|
||||||
|
<printFailingErrors>true</printFailingErrors>
|
||||||
|
<linkXRef>false</linkXRef>
|
||||||
|
</configuration>
|
||||||
|
<executions>
|
||||||
|
<execution>
|
||||||
|
<id>pmd-check</id>
|
||||||
|
<phase>verify</phase>
|
||||||
|
<goals>
|
||||||
|
<goal>check</goal>
|
||||||
|
</goals>
|
||||||
|
</execution>
|
||||||
|
</executions>
|
||||||
|
</plugin>
|
||||||
<plugin>
|
<plugin>
|
||||||
<groupId>org.springframework.boot</groupId>
|
<groupId>org.springframework.boot</groupId>
|
||||||
<artifactId>spring-boot-maven-plugin</artifactId>
|
<artifactId>spring-boot-maven-plugin</artifactId>
|
||||||
@@ -129,5 +151,12 @@
|
|||||||
</plugin>
|
</plugin>
|
||||||
</plugins>
|
</plugins>
|
||||||
</pluginManagement>
|
</pluginManagement>
|
||||||
|
|
||||||
|
<plugins>
|
||||||
|
<plugin>
|
||||||
|
<groupId>org.apache.maven.plugins</groupId>
|
||||||
|
<artifactId>maven-pmd-plugin</artifactId>
|
||||||
|
</plugin>
|
||||||
|
</plugins>
|
||||||
</build>
|
</build>
|
||||||
</project>
|
</project>
|
||||||
|
|||||||
@@ -0,0 +1,86 @@
|
|||||||
|
"""Автотесты прода wordpdf: стенд задаётся исключительно переменными окружения.
|
||||||
|
|
||||||
|
Запуск из этого каталога (подхватывается mise.toml — python + venv + зависимости):
|
||||||
|
|
||||||
|
WORDPDF_BASE_URL=<стенд> [WORDPDF_API_KEY=<ключ>] mise exec -- python -m pytest -q .
|
||||||
|
|
||||||
|
WORDPDF_BASE_URL обязателен: без него все проверки падают — набор принципиально
|
||||||
|
не знает ни одного хоста. WORDPDF_API_KEY факультативен: без него проверки,
|
||||||
|
где есть заголовок ключа или ожидается 401, пропускаются (без локального ключа
|
||||||
|
нельзя знать, включена ли аутентификация на стенде). WORDPDF_MAX_PAGES — ожидаемый
|
||||||
|
лимит страниц стенда (конфигурация сервера, не константа набора; дефолт 100 =
|
||||||
|
дефолт ядра). .docx-фикстуры — из wordpdf-core/src/test/resources/samples,
|
||||||
|
либо из WORDPDF_SAMPLES_DIR.
|
||||||
|
"""
|
||||||
|
|
||||||
|
import os
|
||||||
|
from pathlib import Path
|
||||||
|
|
||||||
|
import pytest
|
||||||
|
|
||||||
|
# (connect, read): read 180 с — с запасом над серверным wordpdf.convert-timeout=2m
|
||||||
|
# (504 по таймауту — тоже ответ сервера, но до него не доходим).
|
||||||
|
TIMEOUT = (10, 180)
|
||||||
|
|
||||||
|
# Навешивается на все проверки с заголовком ключа или ожиданием 401: на стенде
|
||||||
|
# без аутентификации (dev) они дали бы ложный FAIL, а не честный SKIP.
|
||||||
|
needs_key = pytest.mark.skipif(
|
||||||
|
not os.environ.get("WORDPDF_API_KEY", "").strip(),
|
||||||
|
reason="WORDPDF_API_KEY не задан — стенд без аутентификации или ключ не передан",
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.fixture(scope="session")
|
||||||
|
def base_url():
|
||||||
|
"""Корень стенда только из env; пустой — провал, а не дефолт-хост."""
|
||||||
|
url = os.environ.get("WORDPDF_BASE_URL", "").strip().rstrip("/")
|
||||||
|
if not url:
|
||||||
|
pytest.fail("WORDPDF_BASE_URL не задан — набор привязан к стенду только этой переменной")
|
||||||
|
return url
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.fixture(scope="session")
|
||||||
|
def url(base_url):
|
||||||
|
"""Единая склейка base + путь — все запросы тестов идут через неё."""
|
||||||
|
|
||||||
|
def join(path):
|
||||||
|
return base_url + path
|
||||||
|
|
||||||
|
return join
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.fixture(scope="session")
|
||||||
|
def max_pages():
|
||||||
|
"""Ожидаемый лимит страниц стенда: серверная конфигурация, не константа набора."""
|
||||||
|
return int(os.environ.get("WORDPDF_MAX_PAGES", "100"))
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.fixture(scope="session")
|
||||||
|
def api_key():
|
||||||
|
return os.environ.get("WORDPDF_API_KEY", "").strip()
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.fixture(scope="session")
|
||||||
|
def key_header(api_key):
|
||||||
|
return {"X-API-Key": api_key} if api_key else {}
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.fixture(scope="session")
|
||||||
|
def samples():
|
||||||
|
"""Каталог закоммиченных .docx-фикстур ядра (только чтение)."""
|
||||||
|
env = os.environ.get("WORDPDF_SAMPLES_DIR", "").strip()
|
||||||
|
d = Path(env) if env else (
|
||||||
|
Path(__file__).resolve().parents[1]
|
||||||
|
/ "wordpdf-core" / "src" / "test" / "resources" / "samples"
|
||||||
|
)
|
||||||
|
if not (d / "en-plain.docx").is_file():
|
||||||
|
pytest.fail("фикстуры не найдены: укажите WORDPDF_SAMPLES_DIR")
|
||||||
|
return d
|
||||||
|
|
||||||
|
|
||||||
|
@pytest.fixture
|
||||||
|
def notzip_docx(tmp_path):
|
||||||
|
"""Файл с валидным .docx-суффиксом и случайным содержимым — граница «не zip → 400, а не 500»."""
|
||||||
|
p = tmp_path / "notzip.docx"
|
||||||
|
p.write_bytes(os.urandom(2048))
|
||||||
|
return p
|
||||||
@@ -0,0 +1,5 @@
|
|||||||
|
[tools]
|
||||||
|
python = "3.15"
|
||||||
|
|
||||||
|
[env]
|
||||||
|
_.python.venv = { path = ".venv", create = true }
|
||||||
@@ -0,0 +1,2 @@
|
|||||||
|
pytest==9.1.1
|
||||||
|
requests==2.34.2
|
||||||
@@ -0,0 +1,250 @@
|
|||||||
|
"""Проверки прода-API wordpdf: gateway → Spring Boot (`POST /api/v1/convert` за X-API-Key) + SPA.
|
||||||
|
|
||||||
|
Коды и тела ответов соответствуют ApiExceptionHandler / ApiKeyFilter /
|
||||||
|
ConvertController на main. Флаги конвертации передаются только в query-строке
|
||||||
|
(контроллер принимает и form, но query детерминированнее).
|
||||||
|
"""
|
||||||
|
|
||||||
|
import requests
|
||||||
|
|
||||||
|
from conftest import TIMEOUT, needs_key
|
||||||
|
|
||||||
|
CONVERT = "/api/v1/convert"
|
||||||
|
|
||||||
|
|
||||||
|
# --- открытые пути (ключ не нужен ни при каком стенде) -----------------------
|
||||||
|
|
||||||
|
|
||||||
|
def test_health(url):
|
||||||
|
"""Живость: actuator health открыт без ключа (HEALTHCHECK контейнера)."""
|
||||||
|
r = requests.get(url("/actuator/health"), timeout=TIMEOUT)
|
||||||
|
assert r.status_code == 200
|
||||||
|
assert r.json()["status"] == "UP"
|
||||||
|
|
||||||
|
|
||||||
|
def test_spa_root(url):
|
||||||
|
"""SPA отдаётся гейтваем: корень — HTML приложения с монтажным узлом."""
|
||||||
|
r = requests.get(url("/"), timeout=TIMEOUT)
|
||||||
|
assert r.status_code == 200
|
||||||
|
assert "text/html" in r.headers["content-type"]
|
||||||
|
assert 'id="root"' in r.text
|
||||||
|
|
||||||
|
|
||||||
|
def test_swagger_ui_open_without_key(url):
|
||||||
|
"""Документация открыта без ключа — регрессия docsOpenWithoutKey."""
|
||||||
|
r = requests.get(url("/swagger-ui.html"), timeout=TIMEOUT)
|
||||||
|
assert r.status_code == 200
|
||||||
|
|
||||||
|
|
||||||
|
def test_api_docs_spec(url):
|
||||||
|
"""Спек OpenAPI открыт без ключа и описывает единственный эндпоинт."""
|
||||||
|
r = requests.get(url("/v3/api-docs"), timeout=TIMEOUT)
|
||||||
|
assert r.status_code == 200
|
||||||
|
assert "/api/v1/convert" in r.text
|
||||||
|
|
||||||
|
|
||||||
|
# --- дальше все проверки требуют переданный ключ ----------------------------
|
||||||
|
|
||||||
|
|
||||||
|
@needs_key
|
||||||
|
def test_no_key_rejected(url, samples):
|
||||||
|
"""Граница доступа: запрос без заголовка X-API-Key — 401 от ApiKeyFilter."""
|
||||||
|
r = requests.post(
|
||||||
|
url(CONVERT),
|
||||||
|
files={"file": ("en-plain.docx", (samples / "en-plain.docx").read_bytes())},
|
||||||
|
timeout=TIMEOUT,
|
||||||
|
)
|
||||||
|
assert r.status_code == 401
|
||||||
|
assert "X-API-Key" in r.json()["error"]
|
||||||
|
|
||||||
|
|
||||||
|
@needs_key
|
||||||
|
def test_wrong_key_rejected(url, samples):
|
||||||
|
"""Граница доступа: неверный ключ — тот же 401, без различения «нет/неверен»."""
|
||||||
|
r = requests.post(
|
||||||
|
url(CONVERT),
|
||||||
|
headers={"X-API-Key": "wrong-key-000"},
|
||||||
|
files={"file": ("en-plain.docx", (samples / "en-plain.docx").read_bytes())},
|
||||||
|
timeout=TIMEOUT,
|
||||||
|
)
|
||||||
|
assert r.status_code == 401
|
||||||
|
|
||||||
|
|
||||||
|
@needs_key
|
||||||
|
def test_convert_returns_pdf(url, samples, key_header):
|
||||||
|
"""Основной путь: .docx → PDF-аттачмент с ASCII-именем в filename*."""
|
||||||
|
r = requests.post(
|
||||||
|
url(CONVERT),
|
||||||
|
headers=key_header,
|
||||||
|
files={"file": ("en-plain.docx", (samples / "en-plain.docx").read_bytes())},
|
||||||
|
timeout=TIMEOUT,
|
||||||
|
)
|
||||||
|
assert r.status_code == 200
|
||||||
|
assert "application/pdf" in r.headers["content-type"]
|
||||||
|
assert r.content[:4] == b"%PDF"
|
||||||
|
disp = r.headers["content-disposition"]
|
||||||
|
assert "attachment" in disp
|
||||||
|
assert "filename*=UTF-8''en-plain.pdf" in disp
|
||||||
|
|
||||||
|
|
||||||
|
@needs_key
|
||||||
|
def test_convert_cyrillic_filename_rfc5987(url, samples, key_header):
|
||||||
|
"""Кириллическое имя части → RFC 5987 filename* (safeBaseName), заголовок не режется наружным nginx.
|
||||||
|
|
||||||
|
Если стенд вернёт filename*=UTF-8''document.pdf — Tomcat не раскодировал
|
||||||
|
UTF-8 имя части (имя теряется на стенде); тогда ассерт фиксирует фактическое значение.
|
||||||
|
"""
|
||||||
|
r = requests.post(
|
||||||
|
url(CONVERT),
|
||||||
|
headers=key_header,
|
||||||
|
files={"file": ("тест документ.docx", (samples / "en-plain.docx").read_bytes())},
|
||||||
|
timeout=TIMEOUT,
|
||||||
|
)
|
||||||
|
assert r.status_code == 200
|
||||||
|
assert (
|
||||||
|
"filename*=UTF-8''%D1%82%D0%B5%D1%81%D1%82%20"
|
||||||
|
"%D0%B4%D0%BE%D0%BA%D1%83%D0%BC%D0%B5%D0%BD%D1%82.pdf"
|
||||||
|
in r.headers["content-disposition"]
|
||||||
|
)
|
||||||
|
|
||||||
|
|
||||||
|
@needs_key
|
||||||
|
def test_too_many_pages_vs_limit(url, samples, key_header, max_pages):
|
||||||
|
"""too-many-pages.docx (151 стр.): сверх лимита стенда — 400 до рендера; ниже лимита — конвертится.
|
||||||
|
|
||||||
|
Лимит страниц — конфигурация сервера (env WORDPDF_MAX_PAGES), не константа
|
||||||
|
набора: прод идёт со 1000, там фикстура — валидный вход; 400-ветка покрыта
|
||||||
|
Java-регрессией WordPdfConverterTest#staleCachePageCountRejectedBeforeRender.
|
||||||
|
"""
|
||||||
|
r = requests.post(
|
||||||
|
url(CONVERT),
|
||||||
|
headers=key_header,
|
||||||
|
files={"file": ("too-many-pages.docx", (samples / "too-many-pages.docx").read_bytes())},
|
||||||
|
timeout=TIMEOUT,
|
||||||
|
)
|
||||||
|
if max_pages < 151:
|
||||||
|
assert r.status_code == 400
|
||||||
|
assert "error" in r.json()
|
||||||
|
else:
|
||||||
|
assert r.status_code == 200
|
||||||
|
assert r.content[:4] == b"%PDF"
|
||||||
|
|
||||||
|
|
||||||
|
@needs_key
|
||||||
|
def test_stale_cache_vs_limit(url, samples, key_header, max_pages):
|
||||||
|
"""stale-cache.docx (кэш <Pages>1 + 110 lastRenderedPageBreak = 111 стр.): валидатор считает разрывы, не кэш.
|
||||||
|
|
||||||
|
Сверх лимита — 400 (заниженный кэш не спасает), ниже лимита — 200;
|
||||||
|
ветки те же, что у test_too_many_pages_vs_limit.
|
||||||
|
"""
|
||||||
|
r = requests.post(
|
||||||
|
url(CONVERT),
|
||||||
|
headers=key_header,
|
||||||
|
files={"file": ("stale-cache.docx", (samples / "stale-cache.docx").read_bytes())},
|
||||||
|
timeout=TIMEOUT,
|
||||||
|
)
|
||||||
|
if max_pages < 111:
|
||||||
|
assert r.status_code == 400
|
||||||
|
assert "error" in r.json()
|
||||||
|
else:
|
||||||
|
assert r.status_code == 200
|
||||||
|
assert r.content[:4] == b"%PDF"
|
||||||
|
|
||||||
|
|
||||||
|
@needs_key
|
||||||
|
def test_not_a_zip_rejected(url, notzip_docx, key_header):
|
||||||
|
"""Граница «сломанный контейнер → 400, а не 500»: .docx-суффикс, содержимое — мусор."""
|
||||||
|
r = requests.post(
|
||||||
|
url(CONVERT),
|
||||||
|
headers=key_header,
|
||||||
|
files={"file": (notzip_docx.name, notzip_docx.read_bytes())},
|
||||||
|
timeout=TIMEOUT,
|
||||||
|
)
|
||||||
|
assert r.status_code == 400
|
||||||
|
assert "error" in r.json()
|
||||||
|
|
||||||
|
|
||||||
|
@needs_key
|
||||||
|
def test_wrong_extension_rejected(url, samples, key_header):
|
||||||
|
"""Расширение проверяет контроллер (ядро байтов его не видит) — регрессия nonDocxFilename_rejected."""
|
||||||
|
r = requests.post(
|
||||||
|
url(CONVERT),
|
||||||
|
headers=key_header,
|
||||||
|
files={"file": ("file.txt", (samples / "en-plain.docx").read_bytes())},
|
||||||
|
timeout=TIMEOUT,
|
||||||
|
)
|
||||||
|
assert r.status_code == 400
|
||||||
|
assert ".docx" in r.json()["error"]
|
||||||
|
|
||||||
|
|
||||||
|
@needs_key
|
||||||
|
def test_empty_file_rejected(url, key_header):
|
||||||
|
"""Пустая часть — некорректный вход (400), а не ошибка рендера."""
|
||||||
|
r = requests.post(
|
||||||
|
url(CONVERT),
|
||||||
|
headers=key_header,
|
||||||
|
files={"file": ("empty.docx", b"")},
|
||||||
|
timeout=TIMEOUT,
|
||||||
|
)
|
||||||
|
assert r.status_code == 400
|
||||||
|
assert "error" in r.json()
|
||||||
|
|
||||||
|
|
||||||
|
@needs_key
|
||||||
|
def test_missing_part_rejected(url, key_header):
|
||||||
|
"""Партиты `file` нет в multipart — 400 от MissingServletRequestPartException."""
|
||||||
|
r = requests.post(
|
||||||
|
url(CONVERT),
|
||||||
|
headers=key_header,
|
||||||
|
files={"junk": ("x", b"1")},
|
||||||
|
timeout=TIMEOUT,
|
||||||
|
)
|
||||||
|
assert r.status_code == 400
|
||||||
|
assert "file" in r.json()["error"]
|
||||||
|
|
||||||
|
|
||||||
|
@needs_key
|
||||||
|
def test_unknown_path_not_found(url, key_header):
|
||||||
|
"""Неизвестный путь под ключом — 404 JSON, а не 500 (regression unknownPath_notFound)."""
|
||||||
|
r = requests.get(url("/api/v1/nope"), headers=key_header, timeout=TIMEOUT)
|
||||||
|
assert r.status_code == 404
|
||||||
|
assert "error" in r.json()
|
||||||
|
|
||||||
|
|
||||||
|
@needs_key
|
||||||
|
def test_error_on_charts_rejected(url, samples, key_header):
|
||||||
|
"""errorOnCharts при выключенном renderCharts — 422 (DrawingRejectedException); render-флаг приоритетнее."""
|
||||||
|
r = requests.post(
|
||||||
|
url(CONVERT) + "?errorOnCharts=true&renderCharts=false",
|
||||||
|
headers=key_header,
|
||||||
|
files={"file": ("charts-smartart.docx", (samples / "charts-smartart.docx").read_bytes())},
|
||||||
|
timeout=TIMEOUT,
|
||||||
|
)
|
||||||
|
assert r.status_code == 422
|
||||||
|
assert "error" in r.json()
|
||||||
|
|
||||||
|
|
||||||
|
@needs_key
|
||||||
|
def test_render_flags_off_converts(url, samples, key_header):
|
||||||
|
"""Оба render-флага выключены — диаграммы/SmartArt пропускаются до рендера, PDF без них."""
|
||||||
|
r = requests.post(
|
||||||
|
url(CONVERT) + "?renderCharts=false&renderSmartArt=false",
|
||||||
|
headers=key_header,
|
||||||
|
files={"file": ("charts-smartart.docx", (samples / "charts-smartart.docx").read_bytes())},
|
||||||
|
timeout=TIMEOUT,
|
||||||
|
)
|
||||||
|
assert r.status_code == 200
|
||||||
|
assert r.content[:4] == b"%PDF"
|
||||||
|
|
||||||
|
|
||||||
|
@needs_key
|
||||||
|
def test_charts_full_render(url, samples, key_header):
|
||||||
|
"""Дефолтные флаги — полный Java2D-путь диаграмм/SmartArt в PNG — фикстура charts-smartart.docx."""
|
||||||
|
r = requests.post(
|
||||||
|
url(CONVERT),
|
||||||
|
headers=key_header,
|
||||||
|
files={"file": ("charts-smartart.docx", (samples / "charts-smartart.docx").read_bytes())},
|
||||||
|
timeout=TIMEOUT,
|
||||||
|
)
|
||||||
|
assert r.status_code == 200
|
||||||
|
assert r.content[:4] == b"%PDF"
|
||||||
+1
-1
@@ -41,7 +41,7 @@
|
|||||||
<artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
|
<artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
|
||||||
</dependency>
|
</dependency>
|
||||||
|
|
||||||
<!-- /actuator/health — open-эндпоинт для Docker HEALTHCHECK -->
|
<!-- /actuator/health — open-эндпоинт для HEALTHCHECK контейнера -->
|
||||||
<dependency>
|
<dependency>
|
||||||
<groupId>org.springframework.boot</groupId>
|
<groupId>org.springframework.boot</groupId>
|
||||||
<artifactId>spring-boot-starter-actuator</artifactId>
|
<artifactId>spring-boot-starter-actuator</artifactId>
|
||||||
|
|||||||
@@ -10,19 +10,21 @@ 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 {
|
||||||
|
|
||||||
private static final Logger log = LoggerFactory.getLogger(ApiExceptionHandler.class);
|
private static final Logger LOG = LoggerFactory.getLogger(ApiExceptionHandler.class);
|
||||||
|
|
||||||
/** Тело ответа ошибки; Jackson сериализует record как есть. */
|
/** Тело ответа ошибки; Jackson сериализует record как есть. */
|
||||||
record ApiError(String error) {
|
record ApiError(String error) {
|
||||||
@@ -97,7 +99,7 @@ final class ApiExceptionHandler {
|
|||||||
/** Прочее — внутренняя ошибка; подробность только в лог, не в ответ. */
|
/** Прочее — внутренняя ошибка; подробность только в лог, не в ответ. */
|
||||||
@ExceptionHandler(Exception.class)
|
@ExceptionHandler(Exception.class)
|
||||||
ResponseEntity<ApiError> unexpected(Exception e) {
|
ResponseEntity<ApiError> unexpected(Exception e) {
|
||||||
log.error("Необработанное исключение в API", e);
|
LOG.error("Необработанное исключение в API", e);
|
||||||
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
|
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
|
||||||
.body(new ApiError("Внутренняя ошибка конвертации"));
|
.body(new ApiError("Внутренняя ошибка конвертации"));
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -15,7 +15,7 @@ import java.security.MessageDigest;
|
|||||||
/**
|
/**
|
||||||
* Единственная граница доступа: заголовок {@value #HEADER} обязан совпадать с
|
* Единственная граница доступа: заголовок {@value #HEADER} обязан совпадать с
|
||||||
* {@code wordpdf.api-key}. Пустое свойство = фильтрация выключена (dev/тесты).
|
* {@code wordpdf.api-key}. Пустое свойство = фильтрация выключена (dev/тесты).
|
||||||
* Наружу без ключа открыты {@code /actuator/**} (им дышит Docker HEALTHCHECK)
|
* Наружу без ключа открыты {@code /actuator/**} (им дышит HEALTHCHECK контейнера)
|
||||||
* и документация springdoc ({@code /swagger-ui*}, {@code /v3/api-docs*}) —
|
* и документация springdoc ({@code /swagger-ui*}, {@code /v3/api-docs*}) —
|
||||||
* браузер не может положить ключ в заголовок при загрузке UI; ключ обязателен
|
* браузер не может положить ключ в заголовок при загрузке UI; ключ обязателен
|
||||||
* для всего остального (фактически {@code /api/**}). Ответ 401 пишется здесь же,
|
* для всего остального (фактически {@code /api/**}). Ответ 401 пишется здесь же,
|
||||||
@@ -30,7 +30,7 @@ final class ApiKeyFilter extends OncePerRequestFilter {
|
|||||||
|
|
||||||
static final String HEADER = "X-API-Key";
|
static final String HEADER = "X-API-Key";
|
||||||
|
|
||||||
/** Открытые пути без ключа: actuator (Docker HEALTHCHECK) и springdoc-документация. */
|
/** Открытые пути без ключа: actuator (HEALTHCHECK контейнера) и springdoc-документация. */
|
||||||
private static final String[] OPEN_PREFIXES = {"/actuator/", "/swagger-ui", "/v3/api-docs"};
|
private static final String[] OPEN_PREFIXES = {"/actuator/", "/swagger-ui", "/v3/api-docs"};
|
||||||
|
|
||||||
/** null — аутентификация выключена. */
|
/** null — аутентификация выключена. */
|
||||||
@@ -66,7 +66,7 @@ final class ApiKeyFilter extends OncePerRequestFilter {
|
|||||||
* Путь приложения без forwarded-префикса: при
|
* Путь приложения без forwarded-префикса: при
|
||||||
* server.forward-headers-strategy=framework заголовок X-Forwarded-Prefix
|
* server.forward-headers-strategy=framework заголовок X-Forwarded-Prefix
|
||||||
* становится contextPath, и getRequestURI() возвращает URI уже с ним —
|
* становится contextPath, и getRequestURI() возвращает URI уже с ним —
|
||||||
* матч по сырому URI теряет /actuator/ (Docker HEALTHCHECK получил бы 401).
|
* матч по сырому URI теряет /actuator/ (HEALTHCHECK контейнера получил бы 401).
|
||||||
*/
|
*/
|
||||||
private static String path(HttpServletRequest request) {
|
private static String path(HttpServletRequest request) {
|
||||||
return request.getRequestURI().substring(request.getContextPath().length());
|
return request.getRequestURI().substring(request.getContextPath().length());
|
||||||
|
|||||||
@@ -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));
|
||||||
@@ -111,52 +113,7 @@ final class ConversionService {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Валидация байтов переиспользует публичные byte-API ядра. Порядок значим:
|
|
||||||
* размер (дешёвая) → magic bytes → lightweight-разбор zip. Лимиты
|
|
||||||
* размера/страниц берутся из {@code options} (контроллер подставляет их
|
|
||||||
* из конфигурации сервера: свойства {@code wordpdf.max-bytes}/
|
|
||||||
* {@code wordpdf.max-pages}, дефолт — константы ядра).
|
|
||||||
*
|
|
||||||
* <p>Проверка подписи контейнера отдельным шагом обязательна:
|
|
||||||
* {@code ZipInputStream.getNextEntry()} на не-zip-потоке возвращает
|
|
||||||
* {@code null} молча, и {@link WordPdfValidator#checkPageCountLightweight(byte[])}
|
|
||||||
* такой вход не отверг бы (0 страниц). Регрессия —
|
|
||||||
* ConvertControllerTest#corruptNotAZip_rejected. Бинарный .doc — не zip,
|
|
||||||
* а OLE2 (CFB): для него свой магик и свой счётчик страниц
|
|
||||||
* ({@link WordPdfValidator#checkDocPageCountLightweight(byte[], int)}).</p>
|
|
||||||
*/
|
|
||||||
void validate(byte[] docxBytes, ConvertOptions options) {
|
|
||||||
try {
|
|
||||||
WordPdfValidator.checkInput(docxBytes, options.maxBytes());
|
|
||||||
} catch (ConversionException e) {
|
|
||||||
throw new ValidationException(e.getMessage(), e);
|
|
||||||
}
|
|
||||||
boolean zip = docxBytes.length >= 4 && docxBytes[0] == 'P' && docxBytes[1] == 'K'
|
|
||||||
&& (docxBytes[2] & 0xFF) == 0x03 && (docxBytes[3] & 0xFF) == 0x04;
|
|
||||||
if (!zip && !isOle2(docxBytes)) {
|
|
||||||
throw new ValidationException("Содержимое не похоже на .docx или .doc");
|
|
||||||
}
|
|
||||||
try {
|
|
||||||
if (zip) {
|
|
||||||
WordPdfValidator.checkPageCountLightweight(docxBytes, options.maxPages());
|
|
||||||
} else {
|
|
||||||
WordPdfValidator.checkDocPageCountLightweight(docxBytes, options.maxPages());
|
|
||||||
}
|
|
||||||
} catch (ConversionException e) {
|
|
||||||
throw new ValidationException(e.getMessage(), e);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Магик OLE2 (CFB): {@code D0 CF 11 E0 A1 B1 1A E1} — контейнер .doc. */
|
|
||||||
private static boolean isOle2(byte[] bytes) {
|
|
||||||
return bytes.length >= 8
|
|
||||||
&& (bytes[0] & 0xFF) == 0xD0 && (bytes[1] & 0xFF) == 0xCF
|
|
||||||
&& (bytes[2] & 0xFF) == 0x11 && (bytes[3] & 0xFF) == 0xE0
|
|
||||||
&& (bytes[4] & 0xFF) == 0xA1 && (bytes[5] & 0xFF) == 0xB1
|
|
||||||
&& (bytes[6] & 0xFF) == 0x1A && (bytes[7] & 0xFF) == 0xE1;
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Тело задачи воркера. Ядро принимает байты — временные файлы не нужны;
|
* Тело задачи воркера. Ядро принимает байты — временные файлы не нужны;
|
||||||
* имя влияет только на заголовок PDF (параметр {@code title}), потому
|
* имя влияет только на заголовок PDF (параметр {@code title}), потому
|
||||||
* санитизировано.
|
* санитизировано.
|
||||||
@@ -165,6 +122,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
|
||||||
|
|||||||
@@ -12,7 +12,9 @@ import org.springframework.web.bind.annotation.RestController;
|
|||||||
import org.springframework.beans.factory.annotation.Value;
|
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.WordPdfValidator;
|
||||||
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;
|
||||||
@@ -23,8 +25,9 @@ import java.util.Locale;
|
|||||||
* {@code file} (.docx или бинарный .doc) → синхронный ответ байтами PDF.
|
* {@code file} (.docx или бинарный .doc) → синхронный ответ байтами PDF.
|
||||||
*
|
*
|
||||||
* <p>Здесь только HTTP-слой: проверка presence/расширения и формирование
|
* <p>Здесь только HTTP-слой: проверка presence/расширения и формирование
|
||||||
* {@code Content-Disposition}; проверка содержимого (zip, размер, страницы) —
|
* {@code Content-Disposition}; проверка содержимого (подпись контейнера
|
||||||
* зона {@link ConversionService#validate}. Ошибки в JSON-ответ переводит
|
* zip/OLE2, размер, страницы) — зона {@link WordPdfValidator#validate(byte[], ConvertOptions)}.
|
||||||
|
* Ошибки в JSON-ответ переводит
|
||||||
* {@link ApiExceptionHandler}. Лимиты входа — только конфигурация сервера
|
* {@link ApiExceptionHandler}. Лимиты входа — только конфигурация сервера
|
||||||
* (свойства {@code wordpdf.max-bytes}/{@code wordpdf.max-pages}, env
|
* (свойства {@code wordpdf.max-bytes}/{@code wordpdf.max-pages}, env
|
||||||
* {@code WORDPDF_MAX_BYTES}/{@code WORDPDF_MAX_PAGES}); параметрами запроса
|
* {@code WORDPDF_MAX_BYTES}/{@code WORDPDF_MAX_PAGES}); параметрами запроса
|
||||||
|
|||||||
@@ -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).
|
||||||
@@ -15,7 +15,7 @@ spring.servlet.multipart.file-size-threshold=100MB
|
|||||||
wordpdf.convert-timeout=2m
|
wordpdf.convert-timeout=2m
|
||||||
|
|
||||||
# Ключ доступа (заголовок X-API-Key). Пусто = аутентификация выключена
|
# Ключ доступа (заголовок X-API-Key). Пусто = аутентификация выключена
|
||||||
# (dev: java -jar / тесты). В docker-compose задан ${WORDPDF_API_KEY:?} — fail-closed.
|
# (dev: java -jar / тесты). В compose.yml задан ${WORDPDF_API_KEY:?} — fail-closed.
|
||||||
wordpdf.api-key=
|
wordpdf.api-key=
|
||||||
|
|
||||||
# Работа за префикс-срезающим прокси (прод: наружный nginx срезает
|
# Работа за префикс-срезающим прокси (прод: наружный nginx срезает
|
||||||
|
|||||||
@@ -75,13 +75,13 @@ class ApiKeyFilterTest {
|
|||||||
.andExpect(status().isOk())
|
.andExpect(status().isOk())
|
||||||
.andReturn();
|
.andReturn();
|
||||||
byte[] pdf = result.getResponse().getContentAsByteArray();
|
byte[] pdf = result.getResponse().getContentAsByteArray();
|
||||||
assertTrue(new String(pdf, 0, 4, StandardCharsets.US_ASCII).equals("%PDF"),
|
assertTrue("%PDF".equals(new String(pdf, 0, 4, StandardCharsets.US_ASCII)),
|
||||||
"ответ не PDF");
|
"ответ не PDF");
|
||||||
}
|
}
|
||||||
|
|
||||||
@Test
|
@Test
|
||||||
void healthOpenWithoutKey() throws Exception {
|
void healthOpenWithoutKey() throws Exception {
|
||||||
// Docker HEALTHCHECK дышит /actuator/** без ключа — иначе контейнер
|
// HEALTHCHECK контейнера дышит /actuator/** без ключа — иначе контейнер
|
||||||
// никогда не станет healthy
|
// никогда не станет healthy
|
||||||
mockMvc.perform(get("/actuator/health"))
|
mockMvc.perform(get("/actuator/health"))
|
||||||
.andExpect(status().isOk());
|
.andExpect(status().isOk());
|
||||||
|
|||||||
@@ -116,7 +116,7 @@ class ConvertControllerTest {
|
|||||||
.andExpect(header().doesNotExist("X-Wordpdf-Degraded"))
|
.andExpect(header().doesNotExist("X-Wordpdf-Degraded"))
|
||||||
.andReturn();
|
.andReturn();
|
||||||
byte[] pdf = result.getResponse().getContentAsByteArray();
|
byte[] pdf = result.getResponse().getContentAsByteArray();
|
||||||
assertTrue(new String(pdf, 0, 4, StandardCharsets.US_ASCII).equals("%PDF"),
|
assertTrue("%PDF".equals(new String(pdf, 0, 4, StandardCharsets.US_ASCII)),
|
||||||
"тело не начинается с %PDF");
|
"тело не начинается с %PDF");
|
||||||
String text = norm(pdfText(pdf));
|
String text = norm(pdfText(pdf));
|
||||||
assertTrue(text.contains("Привет, мир!"), "нет «Привет, мир!»: " + text);
|
assertTrue(text.contains("Привет, мир!"), "нет «Привет, мир!»: " + text);
|
||||||
@@ -253,14 +253,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 МБ")));
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -309,7 +309,7 @@ class ConvertControllerTest {
|
|||||||
.andExpect(status().isOk())
|
.andExpect(status().isOk())
|
||||||
.andReturn();
|
.andReturn();
|
||||||
byte[] pdf = r.getResponse().getContentAsByteArray();
|
byte[] pdf = r.getResponse().getContentAsByteArray();
|
||||||
assertTrue(new String(pdf, 0, 4, StandardCharsets.US_ASCII).equals("%PDF"),
|
assertTrue("%PDF".equals(new String(pdf, 0, 4, StandardCharsets.US_ASCII)),
|
||||||
"ответ не PDF");
|
"ответ не PDF");
|
||||||
} catch (Exception e) {
|
} catch (Exception e) {
|
||||||
throw new IllegalStateException(e);
|
throw new IllegalStateException(e);
|
||||||
@@ -357,7 +357,7 @@ class ConvertControllerTest {
|
|||||||
"headers-footers-exotic-glyphs"))
|
"headers-footers-exotic-glyphs"))
|
||||||
.andReturn();
|
.andReturn();
|
||||||
byte[] pdf = result.getResponse().getContentAsByteArray();
|
byte[] pdf = result.getResponse().getContentAsByteArray();
|
||||||
assertTrue(new String(pdf, 0, 4, StandardCharsets.US_ASCII).equals("%PDF"),
|
assertTrue("%PDF".equals(new String(pdf, 0, 4, StandardCharsets.US_ASCII)),
|
||||||
"тело не начинается с %PDF");
|
"тело не начинается с %PDF");
|
||||||
String text = norm(pdfText(pdf));
|
String text = norm(pdfText(pdf));
|
||||||
assertTrue(text.contains("Нижний колонтитул"), "нет колонтитула: " + text);
|
assertTrue(text.contains("Нижний колонтитул"), "нет колонтитула: " + text);
|
||||||
|
|||||||
@@ -12,7 +12,6 @@ import org.springframework.test.web.servlet.MockMvc;
|
|||||||
import java.io.ByteArrayOutputStream;
|
import java.io.ByteArrayOutputStream;
|
||||||
import java.io.IOException;
|
import java.io.IOException;
|
||||||
import java.io.InputStream;
|
import java.io.InputStream;
|
||||||
import java.nio.charset.StandardCharsets;
|
|
||||||
import java.util.Random;
|
import java.util.Random;
|
||||||
import java.util.zip.ZipEntry;
|
import java.util.zip.ZipEntry;
|
||||||
import java.util.zip.ZipOutputStream;
|
import java.util.zip.ZipOutputStream;
|
||||||
|
|||||||
@@ -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);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -59,16 +59,18 @@ public final class WordPdfConverter {
|
|||||||
* выбирается по магическому байту контейнера) в PDF. Работа с файлами — забота
|
* выбирается по магическому байту контейнера) в 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());
|
||||||
@@ -78,26 +80,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);
|
||||||
@@ -151,12 +157,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,18 +1,7 @@
|
|||||||
package ru.pjandro.wordpdf;
|
package ru.pjandro.wordpdf;
|
||||||
|
|
||||||
import org.docx4j.openpackaging.packages.WordprocessingMLPackage;
|
|
||||||
import org.apache.poi.hwpf.HWPFDocument;
|
import org.apache.poi.hwpf.HWPFDocument;
|
||||||
import org.apache.poi.poifs.filesystem.POIFSFileSystem;
|
import org.apache.poi.poifs.filesystem.POIFSFileSystem;
|
||||||
import org.apache.poi.ddf.EscherRecordTypes;
|
|
||||||
import org.docx4j.wml.Br;
|
|
||||||
import org.docx4j.wml.ContentAccessor;
|
|
||||||
import org.docx4j.wml.P;
|
|
||||||
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;
|
||||||
@@ -30,9 +19,8 @@ import java.util.zip.ZipInputStream;
|
|||||||
* Валидатор ограничений на входной .docx:
|
* Валидатор ограничений на входной .docx:
|
||||||
* размер входа и число страниц.
|
* размер входа и число страниц.
|
||||||
*
|
*
|
||||||
* <p>Вход валидатора — только {@code byte[]} (или уже загруженный
|
* <p>Вход валидатора — только {@code byte[]}: файловых проверок нет,
|
||||||
* {@link WordprocessingMLPackage}): файловых проверок нет, работа с
|
* работа с файлами — забота вызывающего (приложения).
|
||||||
* файлами — забота вызывающего (приложения).
|
|
||||||
*
|
*
|
||||||
* <p>Конвертер {@link WordPdfConverter} вызывает валидатор автоматически,
|
* <p>Конвертер {@link WordPdfConverter} вызывает валидатор автоматически,
|
||||||
* но им можно пользоваться и напрямую — например, проверить байты
|
* но им можно пользоваться и напрямую — например, проверить байты
|
||||||
@@ -58,7 +46,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 {
|
||||||
|
|
||||||
@@ -68,9 +56,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);
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -78,18 +66,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 + " байт");
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -101,32 +89,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))) {
|
||||||
@@ -135,7 +132,7 @@ public final class WordPdfValidator {
|
|||||||
ZipEntry entry;
|
ZipEntry entry;
|
||||||
while ((entry = zip.getNextEntry()) != null) {
|
while ((entry = zip.getNextEntry()) != null) {
|
||||||
String n = entry.getName();
|
String n = entry.getName();
|
||||||
if (n.equals("docProps/app.xml") || n.equals("word/document.xml")
|
if ("docProps/app.xml".equals(n) || "word/document.xml".equals(n)
|
||||||
|| isHeaderFooterPart(n)) {
|
|| isHeaderFooterPart(n)) {
|
||||||
parts.put(n, zip.readAllBytes());
|
parts.put(n, zip.readAllBytes());
|
||||||
if (isHeaderFooterPart(n)) {
|
if (isHeaderFooterPart(n)) {
|
||||||
@@ -148,14 +145,58 @@ 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);
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Полная проверка входа: размер → подпись контейнера (zip или OLE2) →
|
||||||
|
* число страниц. Порядок значим: размер — дешёвая, разбор контейнера без
|
||||||
|
* подписи бессмысленен. Лимиты берутся из {@link ConvertOptions}
|
||||||
|
* (переопределение на вызов, см. {@link ConvertOptions#maxBytes()},
|
||||||
|
* {@link ConvertOptions#maxPages()}).
|
||||||
|
*
|
||||||
|
* <p>Проверка подписи отдельным шагом обязательна:
|
||||||
|
* {@code ZipInputStream.getNextEntry()} на не-zip-потоке возвращает
|
||||||
|
* {@code null} молча, и {@link #checkPageCount(byte[], int)} такой вход
|
||||||
|
* не отверг бы (оценка «1 страница»). Бинарный .doc — не zip, а OLE2
|
||||||
|
* (CFB): для него свой магик и свой счётчик страниц
|
||||||
|
* ({@link #checkDocPageCountLightweight(byte[], int)}). Регрессия —
|
||||||
|
* {@code WordPdfValidatorTest#validate_neitherDocxNorDoc} (на HTTP-границе —
|
||||||
|
* {@code ConvertControllerTest#corruptNotAZip_rejected}).</p>
|
||||||
|
*
|
||||||
|
* @throws ValidationException при {@code null}, превышении {@code options.maxBytes()},
|
||||||
|
* отсутствии подписи контейнера (ни zip, ни OLE2), ошибке разбора
|
||||||
|
* контейнера или превышении {@code options.maxPages()}
|
||||||
|
*/
|
||||||
|
public static void validate(byte[] docxBytes, ConvertOptions options) throws ValidationException {
|
||||||
|
checkInput(docxBytes, options.maxBytes());
|
||||||
|
boolean zip = docxBytes.length >= 4 && docxBytes[0] == 'P' && docxBytes[1] == 'K'
|
||||||
|
&& (docxBytes[2] & 0xFF) == 0x03 && (docxBytes[3] & 0xFF) == 0x04;
|
||||||
|
boolean ole2 = docxBytes.length >= 8
|
||||||
|
&& (docxBytes[0] & 0xFF) == 0xD0 && (docxBytes[1] & 0xFF) == 0xCF
|
||||||
|
&& (docxBytes[2] & 0xFF) == 0x11 && (docxBytes[3] & 0xFF) == 0xE0
|
||||||
|
&& (docxBytes[4] & 0xFF) == 0xA1 && (docxBytes[5] & 0xFF) == 0xB1
|
||||||
|
&& (docxBytes[6] & 0xFF) == 0x1A && (docxBytes[7] & 0xFF) == 0xE1;
|
||||||
|
if (!zip && !ole2) {
|
||||||
|
throw new ValidationException("Содержимое не похоже на .docx или .doc (ни zip, ни OLE2)");
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
if (zip) {
|
||||||
|
checkPageCount(docxBytes, options.maxPages());
|
||||||
|
} else {
|
||||||
|
checkDocPageCountLightweight(docxBytes, options.maxPages());
|
||||||
|
}
|
||||||
|
} catch (ConversionException e) {
|
||||||
|
// сломанный OLE2-контейнер — некорректный вход (400), как не-zip в zip-ветке
|
||||||
|
throw new ValidationException(e.getMessage(), e);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Проверяет число страниц бинарного .doc (Word 97-2003) по кэшу
|
* Проверяет число страниц бинарного .doc (Word 97-2003) по кэшу
|
||||||
* {@code SummaryInformation.PageCount} — аналогу {@code docProps/app.xml}
|
* {@code SummaryInformation.PageCount} — аналогу {@code docProps/app.xml}
|
||||||
@@ -194,188 +235,6 @@ public final class WordPdfValidator {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
|
||||||
* Считает страницы .docx в байтах и проверяет лимит.
|
|
||||||
*
|
|
||||||
* @throws ConversionException при {@code null}, ошибке загрузки или превышении лимита
|
|
||||||
*/
|
|
||||||
public static void checkPageCount(byte[] docxBytes) throws ConversionException {
|
|
||||||
checkPageCount(docxBytes, WordPdfSettings.MAX_PAGES);
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* То же, что {@link #checkPageCount(byte[])}, с явным лимитом страниц
|
|
||||||
* (переопределение на вызов, см. {@link ConvertOptions#maxPages()}).
|
|
||||||
*
|
|
||||||
* @throws ConversionException при {@code null}, ошибке загрузки или
|
|
||||||
* превышении {@code maxPages}
|
|
||||||
*/
|
|
||||||
public static void checkPageCount(byte[] docxBytes, int maxPages) throws ConversionException {
|
|
||||||
if (docxBytes == null) {
|
|
||||||
throw new ConversionException("Не указаны байты входного .docx");
|
|
||||||
}
|
|
||||||
WordprocessingMLPackage pkg;
|
|
||||||
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 — части нет. */
|
||||||
private interface PartStream {
|
private interface PartStream {
|
||||||
InputStream open(String name) throws IOException;
|
InputStream open(String name) throws IOException;
|
||||||
@@ -389,8 +248,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"}.
|
||||||
@@ -419,7 +277,7 @@ public final class WordPdfValidator {
|
|||||||
XMLStreamReader xr = newSecureReader().createXMLStreamReader(in);
|
XMLStreamReader xr = newSecureReader().createXMLStreamReader(in);
|
||||||
while (xr.hasNext()) {
|
while (xr.hasNext()) {
|
||||||
if (xr.next() == XMLStreamReader.START_ELEMENT
|
if (xr.next() == XMLStreamReader.START_ELEMENT
|
||||||
&& xr.getLocalName().equals("Pages")) {
|
&& "Pages".equals(xr.getLocalName())) {
|
||||||
String text = xr.getElementText().trim();
|
String text = xr.getElementText().trim();
|
||||||
return Math.max(0, Integer.parseInt(text));
|
return Math.max(0, Integer.parseInt(text));
|
||||||
}
|
}
|
||||||
@@ -545,7 +403,7 @@ public final class WordPdfValidator {
|
|||||||
XMLStreamReader xr = newSecureReader().createXMLStreamReader(in);
|
XMLStreamReader xr = newSecureReader().createXMLStreamReader(in);
|
||||||
while (xr.hasNext()) {
|
while (xr.hasNext()) {
|
||||||
if (xr.next() == XMLStreamReader.START_ELEMENT
|
if (xr.next() == XMLStreamReader.START_ELEMENT
|
||||||
&& xr.getLocalName().equals("br") && isPageBreak(xr)) {
|
&& "br".equals(xr.getLocalName()) && isPageBreak(xr)) {
|
||||||
count++;
|
count++;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -585,7 +443,7 @@ public final class WordPdfValidator {
|
|||||||
|
|
||||||
private static boolean truthy(XMLStreamReader xr) {
|
private static boolean truthy(XMLStreamReader xr) {
|
||||||
String v = attrLocal(xr, "val");
|
String v = attrLocal(xr, "val");
|
||||||
return v == null || v.equals("true") || v.equals("1") || v.equals("on");
|
return v == null || "true".equals(v) || "1".equals(v) || "on".equals(v);
|
||||||
}
|
}
|
||||||
|
|
||||||
private static boolean inside(Deque<String> path, String ancestor) {
|
private static boolean inside(Deque<String> path, String ancestor) {
|
||||||
|
|||||||
@@ -54,7 +54,7 @@ public final class BundledFonts {
|
|||||||
|
|
||||||
/** Описание одного файла: имя в jar, ключ семейства, начертание.
|
/** Описание одного файла: имя в jar, ключ семейства, начертание.
|
||||||
* Package-private: доступ для теста. */
|
* Package-private: доступ для теста. */
|
||||||
static record Entry(String file, String family, String variant) {
|
record Entry(String file, String family, String variant) {
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -222,7 +222,7 @@ public final class BundledFonts {
|
|||||||
* FO может запросить любой из них (фолбэк docx4j по покрытию глифов),
|
* FO может запросить любой из них (фолбэк docx4j по покрытию глифов),
|
||||||
* а FOP знает только задекларированные.
|
* а FOP знает только задекларированные.
|
||||||
*/
|
*/
|
||||||
public static java.util.List<String> families() {
|
public static List<String> families() {
|
||||||
return ENTRIES.stream().map(Entry::family).distinct().toList();
|
return ENTRIES.stream().map(Entry::family).distinct().toList();
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -79,7 +79,7 @@ public final class DocxOnOffNormalizer {
|
|||||||
m.reset();
|
m.reset();
|
||||||
StringBuilder sb = new StringBuilder(xml.length());
|
StringBuilder sb = new StringBuilder(xml.length());
|
||||||
while (m.find()) {
|
while (m.find()) {
|
||||||
String value = m.group(2).equalsIgnoreCase("on") ? "true" : "false";
|
String value = "on".equalsIgnoreCase(m.group(2)) ? "true" : "false";
|
||||||
m.appendReplacement(sb, Matcher.quoteReplacement(
|
m.appendReplacement(sb, Matcher.quoteReplacement(
|
||||||
"w:val=" + m.group(1) + value + m.group(1)));
|
"w:val=" + m.group(1) + value + m.group(1)));
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -98,7 +98,7 @@ public final class StrictOoxmlNormalizer {
|
|||||||
// в numbering.xml w:start — элемент стартового значения
|
// в numbering.xml w:start — элемент стартового значения
|
||||||
// счётчика, его не переименовываем
|
// счётчика, его не переименовываем
|
||||||
String fixed = rewrite(new String(data, StandardCharsets.UTF_8),
|
String fixed = rewrite(new String(data, StandardCharsets.UTF_8),
|
||||||
!name.equals("word/numbering.xml"));
|
!"word/numbering.xml".equals(name));
|
||||||
if (fixed != null) {
|
if (fixed != null) {
|
||||||
changed = true;
|
changed = true;
|
||||||
data = fixed.getBytes(StandardCharsets.UTF_8);
|
data = fixed.getBytes(StandardCharsets.UTF_8);
|
||||||
@@ -225,7 +225,7 @@ public final class StrictOoxmlNormalizer {
|
|||||||
m.reset();
|
m.reset();
|
||||||
StringBuilder sb = new StringBuilder(xml.length());
|
StringBuilder sb = new StringBuilder(xml.length());
|
||||||
while (m.find()) {
|
while (m.find()) {
|
||||||
String value = m.group(2).equals("start") ? "left" : "right";
|
String value = "start".equals(m.group(2)) ? "left" : "right";
|
||||||
m.appendReplacement(sb,
|
m.appendReplacement(sb,
|
||||||
Matcher.quoteReplacement(m.group(1) + value + "\""));
|
Matcher.quoteReplacement(m.group(1) + value + "\""));
|
||||||
}
|
}
|
||||||
|
|||||||
+13
-17
@@ -43,8 +43,8 @@ final class CartesianPainter {
|
|||||||
|
|
||||||
// 1. Поля под подписи осей
|
// 1. Поля под подписи осей
|
||||||
double catGutter = 0;
|
double catGutter = 0;
|
||||||
for (String c : cats) {
|
if (!cats.isEmpty()) {
|
||||||
catGutter = Math.max(catGutter, DrawMlText.textHeight(catStyle, g.getFontRenderContext()));
|
catGutter = DrawMlText.textHeight(catStyle, g.getFontRenderContext());
|
||||||
}
|
}
|
||||||
catGutter += 6;
|
catGutter += 6;
|
||||||
|
|
||||||
@@ -86,8 +86,7 @@ final class CartesianPainter {
|
|||||||
if (valAxis.gridlines && !valAxis.deleted) {
|
if (valAxis.gridlines && !valAxis.deleted) {
|
||||||
g.setColor(valAxis.gridColor);
|
g.setColor(valAxis.gridColor);
|
||||||
g.setStroke(new BasicStroke(0.6f));
|
g.setStroke(new BasicStroke(0.6f));
|
||||||
int i = 0;
|
for (double v = lo; v <= hi + unit / 2; v += unit) {
|
||||||
for (double v = lo; v <= hi + unit / 2; v += unit, i++) {
|
|
||||||
double t = (v - lo) / (hi - lo);
|
double t = (v - lo) / (hi - lo);
|
||||||
if (horizontal) {
|
if (horizontal) {
|
||||||
double x = plot.getX() + t * plot.getWidth();
|
double x = plot.getX() + t * plot.getWidth();
|
||||||
@@ -259,7 +258,6 @@ final class CartesianPainter {
|
|||||||
private static void drawAreas(Graphics2D g, ChartSpec spec, Rectangle2D plot,
|
private static void drawAreas(Graphics2D g, ChartSpec spec, Rectangle2D plot,
|
||||||
List<Color> palette, double lo, double hi, int nCat,
|
List<Color> palette, double lo, double hi, int nCat,
|
||||||
boolean horizontal) {
|
boolean horizontal) {
|
||||||
double baseline = horizontal ? plot.getX() : plot.getY() + plot.getHeight();
|
|
||||||
for (int si = 0; si < spec.series.size(); si++) {
|
for (int si = 0; si < spec.series.size(); si++) {
|
||||||
ChartSpec.Series s = spec.series.get(si);
|
ChartSpec.Series s = spec.series.get(si);
|
||||||
Color c = s.fill != null ? s.fill : s.fillAt(si, palette);
|
Color c = s.fill != null ? s.fill : s.fillAt(si, palette);
|
||||||
@@ -277,18 +275,16 @@ final class CartesianPainter {
|
|||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
Path2D p = new Path2D.Double();
|
Path2D p = new Path2D.Double();
|
||||||
p.moveTo(toX(along.get(0), cross.get(0), baseline, horizontal),
|
p.moveTo(toX(along.get(0), cross.get(0), horizontal),
|
||||||
toY(along.get(0), cross.get(0), baseline, horizontal));
|
toY(along.get(0), cross.get(0), horizontal));
|
||||||
for (int i = 0; i < along.size(); i++) {
|
for (int i = 0; i < along.size(); i++) {
|
||||||
p.lineTo(toX(along.get(i), cross.get(i), baseline, horizontal),
|
p.lineTo(toX(along.get(i), cross.get(i), horizontal),
|
||||||
toY(along.get(i), cross.get(i), baseline, horizontal));
|
toY(along.get(i), cross.get(i), horizontal));
|
||||||
}
|
}
|
||||||
p.lineTo(toX(along.get(along.size() - 1), cross.get(cross.size() - 1),
|
p.lineTo(toX(along.get(along.size() - 1), cross.get(cross.size() - 1), horizontal),
|
||||||
baseline, horizontal),
|
toY(along.get(along.size() - 1), cross.get(cross.size() - 1), horizontal));
|
||||||
toY(along.get(along.size() - 1), cross.get(cross.size() - 1),
|
p.lineTo(toX(along.get(0), cross.get(0), horizontal),
|
||||||
baseline, horizontal));
|
toY(along.get(0), cross.get(0), horizontal));
|
||||||
p.lineTo(toX(along.get(0), cross.get(0), baseline, horizontal),
|
|
||||||
toY(along.get(0), cross.get(0), baseline, horizontal));
|
|
||||||
p.closePath();
|
p.closePath();
|
||||||
g.setColor(DrawMlColor.withAlpha(c, 0.55));
|
g.setColor(DrawMlColor.withAlpha(c, 0.55));
|
||||||
g.fill(p);
|
g.fill(p);
|
||||||
@@ -299,11 +295,11 @@ final class CartesianPainter {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/** (вдоль категории, вдоль значения) -> экранные координаты. */
|
/** (вдоль категории, вдоль значения) -> экранные координаты. */
|
||||||
private static double toX(double along, double cross, double baseline, boolean horizontal) {
|
private static double toX(double along, double cross, boolean horizontal) {
|
||||||
return horizontal ? cross : along;
|
return horizontal ? cross : along;
|
||||||
}
|
}
|
||||||
|
|
||||||
private static double toY(double along, double cross, double baseline, boolean horizontal) {
|
private static double toY(double along, double cross, boolean horizontal) {
|
||||||
return horizontal ? along : cross;
|
return horizontal ? along : cross;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -179,8 +179,6 @@ final class ChartRenderer {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
case SURFACE3D -> {
|
case SURFACE3D -> {
|
||||||
List<Double> vals = spec.series.isEmpty()
|
|
||||||
? List.of() : spec.series.get(0).values;
|
|
||||||
double min = Double.MAX_VALUE;
|
double min = Double.MAX_VALUE;
|
||||||
double max = -Double.MAX_VALUE;
|
double max = -Double.MAX_VALUE;
|
||||||
for (ChartSpec.Series s : spec.series) {
|
for (ChartSpec.Series s : spec.series) {
|
||||||
@@ -330,7 +328,7 @@ final class ChartRenderer {
|
|||||||
// (так делает Word) — иначе surface3D теряет нижнюю полосу и легенда
|
// (так делает Word) — иначе surface3D теряет нижнюю полосу и легенда
|
||||||
// съезжает с «0-1 … 4-5» на «1-2 … 4-5».
|
// съезжает с «0-1 … 4-5» на «1-2 … 4-5».
|
||||||
double lo = axis != null && axis.min != null ? axis.min
|
double lo = axis != null && axis.min != null ? axis.min
|
||||||
: (dataMin >= 0 ? 0 : Math.floor(dataMin / unit) * unit);
|
: dataMin >= 0 ? 0 : Math.floor(dataMin / unit) * unit;
|
||||||
double hi;
|
double hi;
|
||||||
if (axis != null && axis.max != null) {
|
if (axis != null && axis.max != null) {
|
||||||
hi = axis.max;
|
hi = axis.max;
|
||||||
@@ -346,7 +344,7 @@ final class ChartRenderer {
|
|||||||
|
|
||||||
/** Формат числа для подписей оси ("General" -> без лишних нулей). */
|
/** Формат числа для подписей оси ("General" -> без лишних нулей). */
|
||||||
static String formatValue(double v, String fmt) {
|
static String formatValue(double v, String fmt) {
|
||||||
if (fmt != null && !fmt.equalsIgnoreCase("General")) {
|
if (fmt != null && !"General".equalsIgnoreCase(fmt)) {
|
||||||
if (fmt.contains("0.00")) {
|
if (fmt.contains("0.00")) {
|
||||||
return String.format(java.util.Locale.ROOT, "%.2f", v);
|
return String.format(java.util.Locale.ROOT, "%.2f", v);
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -122,10 +122,6 @@ final class ChartSpec {
|
|||||||
Color chartBorder = new Color(0xBF, 0xBF, 0xBF);
|
Color chartBorder = new Color(0xBF, 0xBF, 0xBF);
|
||||||
double chartBorderWidth = 0.75;
|
double chartBorderWidth = 0.75;
|
||||||
|
|
||||||
/** package-private: тестам нужен пустой spec без CTChartSpace. */
|
|
||||||
ChartSpec() {
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Цвета акцента темы — базовая палитра рядов (как в Word). */
|
/** Цвета акцента темы — базовая палитра рядов (как в Word). */
|
||||||
static List<Color> palette(DrawMlColor colors) {
|
static List<Color> palette(DrawMlColor colors) {
|
||||||
List<Color> p = new ArrayList<>();
|
List<Color> p = new ArrayList<>();
|
||||||
@@ -228,25 +224,24 @@ final class ChartSpec {
|
|||||||
if (group instanceof CTPie3DChart g) {
|
if (group instanceof CTPie3DChart g) {
|
||||||
spec.type = Type.PIE3D;
|
spec.type = Type.PIE3D;
|
||||||
for (CTPieSer s : g.getSer()) {
|
for (CTPieSer s : g.getSer()) {
|
||||||
spec.series.add(readPieSer(s, colors, palette));
|
spec.series.add(readPieSer(s, colors));
|
||||||
}
|
}
|
||||||
} else if (group instanceof CTPieChart g) {
|
} else if (group instanceof CTPieChart g) {
|
||||||
spec.type = Type.PIE;
|
spec.type = Type.PIE;
|
||||||
for (CTPieSer s : g.getSer()) {
|
for (CTPieSer s : g.getSer()) {
|
||||||
spec.series.add(readPieSer(s, colors, palette));
|
spec.series.add(readPieSer(s, colors));
|
||||||
}
|
}
|
||||||
} else if (group instanceof CTDoughnutChart g) {
|
} else if (group instanceof CTDoughnutChart g) {
|
||||||
spec.type = Type.DOUGHNUT;
|
spec.type = Type.DOUGHNUT;
|
||||||
for (CTPieSer s : g.getSer()) {
|
for (CTPieSer s : g.getSer()) {
|
||||||
spec.series.add(readPieSer(s, colors, palette));
|
spec.series.add(readPieSer(s, colors));
|
||||||
}
|
}
|
||||||
} else if (group instanceof CTLineChart g) {
|
} else if (group instanceof CTLineChart g) {
|
||||||
spec.type = Type.LINE;
|
spec.type = Type.LINE;
|
||||||
for (CTLineSer s : g.getSer()) {
|
for (CTLineSer s : g.getSer()) {
|
||||||
Series ser = new Series();
|
Series ser = new Series();
|
||||||
readCommon(s.getTx(), s.getCat(), s.getVal(), s.getDPt(), ser, colors, palette);
|
readCommon(s.getTx(), s.getCat(), s.getVal(), s.getDPt(), ser, colors);
|
||||||
readLineProps(s.getSpPr(), ser, colors, palette,
|
readLineProps(s.getSpPr(), ser, colors);
|
||||||
spec.series.size());
|
|
||||||
CTMarker m = s.getMarker();
|
CTMarker m = s.getMarker();
|
||||||
if (m != null) {
|
if (m != null) {
|
||||||
ser.marker = m.getSymbol() == null
|
ser.marker = m.getSymbol() == null
|
||||||
@@ -260,11 +255,11 @@ final class ChartSpec {
|
|||||||
} else if (group instanceof CTBarChart g) {
|
} else if (group instanceof CTBarChart g) {
|
||||||
boolean horizontal = g.getBarDir() != null
|
boolean horizontal = g.getBarDir() != null
|
||||||
&& g.getBarDir().getVal() != null
|
&& g.getBarDir().getVal() != null
|
||||||
&& g.getBarDir().getVal().value().equalsIgnoreCase("bar");
|
&& "bar".equalsIgnoreCase(g.getBarDir().getVal().value());
|
||||||
spec.type = horizontal ? Type.BAR_HORIZONTAL : Type.BAR;
|
spec.type = horizontal ? Type.BAR_HORIZONTAL : Type.BAR;
|
||||||
for (CTBarSer s : g.getSer()) {
|
for (CTBarSer s : g.getSer()) {
|
||||||
Series ser = new Series();
|
Series ser = new Series();
|
||||||
readCommon(s.getTx(), s.getCat(), s.getVal(), s.getDPt(), ser, colors, palette);
|
readCommon(s.getTx(), s.getCat(), s.getVal(), s.getDPt(), ser, colors);
|
||||||
if (s.getSpPr() != null && s.getSpPr().getSolidFill() != null) {
|
if (s.getSpPr() != null && s.getSpPr().getSolidFill() != null) {
|
||||||
ser.fill = colors.resolveFill(s.getSpPr().getSolidFill());
|
ser.fill = colors.resolveFill(s.getSpPr().getSolidFill());
|
||||||
}
|
}
|
||||||
@@ -274,11 +269,11 @@ final class ChartSpec {
|
|||||||
spec.type = Type.AREA;
|
spec.type = Type.AREA;
|
||||||
for (org.docx4j.dml.chart.CTAreaSer s : g.getSer()) {
|
for (org.docx4j.dml.chart.CTAreaSer s : g.getSer()) {
|
||||||
Series ser = new Series();
|
Series ser = new Series();
|
||||||
readCommon(s.getTx(), s.getCat(), s.getVal(), s.getDPt(), ser, colors, palette);
|
readCommon(s.getTx(), s.getCat(), s.getVal(), s.getDPt(), ser, colors);
|
||||||
if (s.getSpPr() != null && s.getSpPr().getSolidFill() != null) {
|
if (s.getSpPr() != null && s.getSpPr().getSolidFill() != null) {
|
||||||
ser.fill = colors.resolveFill(s.getSpPr().getSolidFill());
|
ser.fill = colors.resolveFill(s.getSpPr().getSolidFill());
|
||||||
}
|
}
|
||||||
readLineProps(s.getSpPr(), ser, colors, palette, spec.series.size());
|
readLineProps(s.getSpPr(), ser, colors);
|
||||||
spec.series.add(ser);
|
spec.series.add(ser);
|
||||||
}
|
}
|
||||||
} else if (group instanceof CTSurface3DChart g) {
|
} else if (group instanceof CTSurface3DChart g) {
|
||||||
@@ -286,7 +281,7 @@ final class ChartSpec {
|
|||||||
spec.wireframe = isTrue(g.getWireframe());
|
spec.wireframe = isTrue(g.getWireframe());
|
||||||
for (CTSurfaceSer s : g.getSer()) {
|
for (CTSurfaceSer s : g.getSer()) {
|
||||||
Series ser = new Series();
|
Series ser = new Series();
|
||||||
readCommon(s.getTx(), s.getCat(), s.getVal(), List.of(), ser, colors, palette);
|
readCommon(s.getTx(), s.getCat(), s.getVal(), List.of(), ser, colors);
|
||||||
if (s.getSpPr() != null && s.getSpPr().getSolidFill() != null) {
|
if (s.getSpPr() != null && s.getSpPr().getSolidFill() != null) {
|
||||||
ser.fill = colors.resolveFill(s.getSpPr().getSolidFill());
|
ser.fill = colors.resolveFill(s.getSpPr().getSolidFill());
|
||||||
}
|
}
|
||||||
@@ -305,9 +300,9 @@ final class ChartSpec {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
private static Series readPieSer(CTPieSer s, DrawMlColor colors, List<Color> palette) {
|
private static Series readPieSer(CTPieSer s, DrawMlColor colors) {
|
||||||
Series ser = new Series();
|
Series ser = new Series();
|
||||||
readCommon(s.getTx(), s.getCat(), s.getVal(), s.getDPt(), ser, colors, palette);
|
readCommon(s.getTx(), s.getCat(), s.getVal(), s.getDPt(), ser, colors);
|
||||||
if (s.getSpPr() != null) {
|
if (s.getSpPr() != null) {
|
||||||
if (s.getSpPr().getSolidFill() != null) {
|
if (s.getSpPr().getSolidFill() != null) {
|
||||||
ser.fill = colors.resolveFill(s.getSpPr().getSolidFill());
|
ser.fill = colors.resolveFill(s.getSpPr().getSolidFill());
|
||||||
@@ -328,8 +323,7 @@ final class ChartSpec {
|
|||||||
|
|
||||||
/** Общее для всех типов: имя, категории, значения, переопределения точек. */
|
/** Общее для всех типов: имя, категории, значения, переопределения точек. */
|
||||||
private static void readCommon(CTSerTx tx, CTAxDataSource cat, CTNumDataSource val,
|
private static void readCommon(CTSerTx tx, CTAxDataSource cat, CTNumDataSource val,
|
||||||
List<CTDPt> dPts, Series ser, DrawMlColor colors,
|
List<CTDPt> dPts, Series ser, DrawMlColor colors) {
|
||||||
List<Color> palette) {
|
|
||||||
ser.name = seriesName(tx);
|
ser.name = seriesName(tx);
|
||||||
ser.categories.addAll(categoryNames(cat));
|
ser.categories.addAll(categoryNames(cat));
|
||||||
if (val != null) {
|
if (val != null) {
|
||||||
@@ -362,8 +356,7 @@ final class ChartSpec {
|
|||||||
}
|
}
|
||||||
|
|
||||||
/** a:ln ряда (цвет и толщина линии графика). */
|
/** a:ln ряда (цвет и толщина линии графика). */
|
||||||
private static void readLineProps(CTShapeProperties sp, Series ser, DrawMlColor colors,
|
private static void readLineProps(CTShapeProperties sp, Series ser, DrawMlColor colors) {
|
||||||
List<Color> palette, int seriesIndex) {
|
|
||||||
if (sp == null) {
|
if (sp == null) {
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -112,9 +112,9 @@ final class DrawMlColor {
|
|||||||
}
|
}
|
||||||
String n = name.toLowerCase(Locale.ROOT);
|
String n = name.toLowerCase(Locale.ROOT);
|
||||||
// Word: bg1/tx1 — псевдонимы lt1/dk1
|
// Word: bg1/tx1 — псевдонимы lt1/dk1
|
||||||
if (n.equals("bg1")) {
|
if ("bg1".equals(n)) {
|
||||||
n = "lt1";
|
n = "lt1";
|
||||||
} else if (n.equals("tx1")) {
|
} else if ("tx1".equals(n)) {
|
||||||
n = "dk1";
|
n = "dk1";
|
||||||
}
|
}
|
||||||
Color c = scheme.get(n);
|
Color c = scheme.get(n);
|
||||||
@@ -171,7 +171,7 @@ final class DrawMlColor {
|
|||||||
}
|
}
|
||||||
case "hueMod" -> {
|
case "hueMod" -> {
|
||||||
hsl = RgbHsl.toHsl(toRgb(hsl));
|
hsl = RgbHsl.toHsl(toRgb(hsl));
|
||||||
hsl[0] = (hsl[0] * p) % 360.0;
|
hsl[0] = hsl[0] * p % 360.0;
|
||||||
hslDirty = true;
|
hslDirty = true;
|
||||||
}
|
}
|
||||||
case "hueOff" -> {
|
case "hueOff" -> {
|
||||||
@@ -260,9 +260,9 @@ final class DrawMlColor {
|
|||||||
if (c.getScrgbClr() != null) {
|
if (c.getScrgbClr() != null) {
|
||||||
CTScRgbColor s = c.getScrgbClr();
|
CTScRgbColor s = c.getScrgbClr();
|
||||||
return new Color(
|
return new Color(
|
||||||
clamp255((int) Math.round(s.getR() * 255)),
|
clamp255(Math.round(s.getR() * 255)),
|
||||||
clamp255((int) Math.round(s.getG() * 255)),
|
clamp255(Math.round(s.getG() * 255)),
|
||||||
clamp255((int) Math.round(s.getB() * 255)));
|
clamp255(Math.round(s.getB() * 255)));
|
||||||
}
|
}
|
||||||
if (c.getHslClr() != null) {
|
if (c.getHslClr() != null) {
|
||||||
CTHslColor h = c.getHslClr();
|
CTHslColor h = c.getHslClr();
|
||||||
|
|||||||
@@ -12,7 +12,6 @@ import ru.pjandro.wordpdf.fonts.BundledFonts;
|
|||||||
import java.awt.Color;
|
import java.awt.Color;
|
||||||
import java.awt.Font;
|
import java.awt.Font;
|
||||||
import java.awt.Graphics2D;
|
import java.awt.Graphics2D;
|
||||||
import java.awt.Font;
|
|
||||||
import java.awt.font.FontRenderContext;
|
import java.awt.font.FontRenderContext;
|
||||||
import java.awt.font.TextLayout;
|
import java.awt.font.TextLayout;
|
||||||
import java.awt.geom.Rectangle2D;
|
import java.awt.geom.Rectangle2D;
|
||||||
@@ -214,7 +213,7 @@ final class DrawMlText {
|
|||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
StringBuilder cur = new StringBuilder();
|
StringBuilder cur = new StringBuilder();
|
||||||
double curWidth = 0;
|
double curWidth;
|
||||||
for (String word : hard.split(" ")) {
|
for (String word : hard.split(" ")) {
|
||||||
if (word.isEmpty()) {
|
if (word.isEmpty()) {
|
||||||
continue;
|
continue;
|
||||||
@@ -224,7 +223,6 @@ final class DrawMlText {
|
|||||||
if (w <= limit || cur.length() == 0) {
|
if (w <= limit || cur.length() == 0) {
|
||||||
cur.setLength(0);
|
cur.setLength(0);
|
||||||
cur.append(candidate);
|
cur.append(candidate);
|
||||||
curWidth = w;
|
|
||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
out.add(cur.toString());
|
out.add(cur.toString());
|
||||||
@@ -251,13 +249,13 @@ final class DrawMlText {
|
|||||||
|
|
||||||
/** Ширина строки в тех же единицах, что и размер шрифта. */
|
/** Ширина строки в тех же единицах, что и размер шрифта. */
|
||||||
static double textWidth(String text, Style style, FontRenderContext frc) {
|
static double textWidth(String text, Style style, FontRenderContext frc) {
|
||||||
return new java.awt.font.TextLayout(text, fontFor(style), frc).getAdvance();
|
return new TextLayout(text, fontFor(style), frc).getAdvance();
|
||||||
}
|
}
|
||||||
|
|
||||||
/** Высота строки (ascent+descent+leading) для стиля. */
|
/** Высота строки (ascent+descent+leading) для стиля. */
|
||||||
static double textHeight(Style style, FontRenderContext frc) {
|
static double textHeight(Style style, FontRenderContext frc) {
|
||||||
Font f = fontFor(style);
|
Font f = fontFor(style);
|
||||||
java.awt.font.TextLayout tl = new java.awt.font.TextLayout("Xpg", f, frc);
|
TextLayout tl = new TextLayout("Xpg", f, frc);
|
||||||
return tl.getAscent() + tl.getDescent() + tl.getLeading();
|
return tl.getAscent() + tl.getDescent() + tl.getLeading();
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
+14
-14
@@ -63,7 +63,7 @@ import java.util.Set;
|
|||||||
*/
|
*/
|
||||||
public final class DrawingPreRenderer {
|
public final class DrawingPreRenderer {
|
||||||
|
|
||||||
private static final Logger log = LoggerFactory.getLogger(DrawingPreRenderer.class);
|
private static final Logger LOG = LoggerFactory.getLogger(DrawingPreRenderer.class);
|
||||||
|
|
||||||
private static final String CHART_ELEMENT =
|
private static final String CHART_ELEMENT =
|
||||||
"{http://schemas.openxmlformats.org/drawingml/2006/chart}chart";
|
"{http://schemas.openxmlformats.org/drawingml/2006/chart}chart";
|
||||||
@@ -185,7 +185,7 @@ public final class DrawingPreRenderer {
|
|||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
if (cx <= 0 || cy <= 0) {
|
if (cx <= 0 || cy <= 0) {
|
||||||
log.warn("drawing без wp:extent — оставлен как есть");
|
LOG.warn("drawing без wp:extent — оставлен как есть");
|
||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
GraphicData gd = graphic.getGraphicData();
|
GraphicData gd = graphic.getGraphicData();
|
||||||
@@ -208,7 +208,7 @@ public final class DrawingPreRenderer {
|
|||||||
}
|
}
|
||||||
continue; // настройка выключена — drawing остаётся в docx как есть
|
continue; // настройка выключена — drawing остаётся в docx как есть
|
||||||
}
|
}
|
||||||
img = renderChart(part, (CTRelId) el.getValue(), pkg, colors, cx, cy);
|
img = renderChart(part, (CTRelId) el.getValue(), colors, cx, cy);
|
||||||
label = "график";
|
label = "график";
|
||||||
} else if (DIAGRAM_ELEMENT.equals(name)) {
|
} else if (DIAGRAM_ELEMENT.equals(name)) {
|
||||||
if (!options.renderSmartArt()) {
|
if (!options.renderSmartArt()) {
|
||||||
@@ -217,13 +217,13 @@ public final class DrawingPreRenderer {
|
|||||||
}
|
}
|
||||||
continue;
|
continue;
|
||||||
}
|
}
|
||||||
img = renderDiagram(part, (CTRelIds) el.getValue(), pkg, colors, cx, cy);
|
img = renderDiagram(part, (CTRelIds) el.getValue(), colors, cx, cy);
|
||||||
label = "SmartArt";
|
label = "SmartArt";
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
if (img == null) {
|
if (img == null) {
|
||||||
if (label != null) {
|
if (label != null) {
|
||||||
log.warn("не удалось отрендерить {} — объект удалён из документа", label);
|
LOG.warn("не удалось отрендерить {} — объект удалён из документа", label);
|
||||||
gd.getAny().clear();
|
gd.getAny().clear();
|
||||||
}
|
}
|
||||||
continue;
|
continue;
|
||||||
@@ -232,28 +232,28 @@ public final class DrawingPreRenderer {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
private static BufferedImage renderChart(Part part, CTRelId ref, WordprocessingMLPackage pkg,
|
private static BufferedImage renderChart(Part part, CTRelId ref,
|
||||||
DrawMlColor colors, long cx, long cy) {
|
DrawMlColor colors, long cx, long cy) {
|
||||||
Part target = resolve(part, ref.getId());
|
Part target = resolve(part, ref.getId());
|
||||||
if (!(target instanceof JaxbXmlPart<?> jp) || !(jp.getJaxbElement() instanceof CTChartSpace space)) {
|
if (!(target instanceof JaxbXmlPart<?> jp) || !(jp.getJaxbElement() instanceof CTChartSpace space)) {
|
||||||
log.warn("chart-часть не найдена по r:id={}", ref.getId());
|
LOG.warn("chart-часть не найдена по r:id={}", ref.getId());
|
||||||
return null;
|
return null;
|
||||||
}
|
}
|
||||||
try {
|
try {
|
||||||
ChartSpec spec = ChartSpec.parse(space, colors);
|
ChartSpec spec = ChartSpec.parse(space, colors);
|
||||||
return ChartRenderer.render(spec, cx / 12700.0, cy / 12700.0, colors);
|
return ChartRenderer.render(spec, cx / 12700.0, cy / 12700.0, colors);
|
||||||
} catch (RuntimeException e) {
|
} catch (RuntimeException e) {
|
||||||
log.warn("рендер графика r:id={} упал: {}", ref.getId(), e.toString());
|
LOG.warn("рендер графика r:id={} упал: {}", ref.getId(), e.toString());
|
||||||
return null;
|
return null;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
private static BufferedImage renderDiagram(Part part, CTRelIds refs, WordprocessingMLPackage pkg,
|
private static BufferedImage renderDiagram(Part part, CTRelIds refs,
|
||||||
DrawMlColor colors, long cx, long cy) {
|
DrawMlColor colors, long cx, long cy) {
|
||||||
Part drawingPart = diagramDrawingPart(part);
|
Part drawingPart = diagramDrawingPart(part);
|
||||||
if (!(drawingPart instanceof JaxbXmlPart<?> jp)
|
if (!(drawingPart instanceof JaxbXmlPart<?> jp)
|
||||||
|| !(jp.getJaxbElement() instanceof CTDrawing drawing)) {
|
|| !(jp.getJaxbElement() instanceof CTDrawing drawing)) {
|
||||||
log.warn("dsp:drawing (SmartArt) не найден — схема пропущена");
|
LOG.warn("dsp:drawing (SmartArt) не найден — схема пропущена");
|
||||||
return null;
|
return null;
|
||||||
}
|
}
|
||||||
CTDataModel data = null;
|
CTDataModel data = null;
|
||||||
@@ -264,7 +264,7 @@ public final class DrawingPreRenderer {
|
|||||||
try {
|
try {
|
||||||
return SmartArtRenderer.render(drawing, data, colors, cx / 12700.0, cy / 12700.0);
|
return SmartArtRenderer.render(drawing, data, colors, cx / 12700.0, cy / 12700.0);
|
||||||
} catch (RuntimeException e) {
|
} catch (RuntimeException e) {
|
||||||
log.warn("рендер SmartArt упал: {}", e.toString());
|
LOG.warn("рендер SmartArt упал: {}", e.toString());
|
||||||
return null;
|
return null;
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -306,19 +306,19 @@ public final class DrawingPreRenderer {
|
|||||||
ImageIO.write(img, "png", bos);
|
ImageIO.write(img, "png", bos);
|
||||||
png = bos.toByteArray();
|
png = bos.toByteArray();
|
||||||
} catch (Exception e) {
|
} catch (Exception e) {
|
||||||
log.warn("PNG не собран: {}", e.toString());
|
LOG.warn("PNG не собран: {}", e.toString());
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
BinaryPartAbstractImage imagePart;
|
BinaryPartAbstractImage imagePart;
|
||||||
try {
|
try {
|
||||||
imagePart = BinaryPartAbstractImage.createImagePart(pkg, part, png);
|
imagePart = BinaryPartAbstractImage.createImagePart(pkg, part, png);
|
||||||
} catch (Exception e) {
|
} catch (Exception e) {
|
||||||
log.warn("ImagePart не создан: {}", e.toString());
|
LOG.warn("ImagePart не создан: {}", e.toString());
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
String relId = relIdFor(part, imagePart);
|
String relId = relIdFor(part, imagePart);
|
||||||
if (relId == null) {
|
if (relId == null) {
|
||||||
log.warn("r:id для ImagePart {} не найден", imagePart.getPartName());
|
LOG.warn("r:id для ImagePart {} не найден", imagePart.getPartName());
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -84,7 +84,7 @@ final class PiePainter {
|
|||||||
double sweep = 360.0 * v / total;
|
double sweep = 360.0 * v / total;
|
||||||
Color fill = s.fillAt(i, palette);
|
Color fill = s.fillAt(i, palette);
|
||||||
Color outline = s.outlineNoFill ? null
|
Color outline = s.outlineNoFill ? null
|
||||||
: (s.outlineColor != null ? s.outlineColor : Color.WHITE);
|
: s.outlineColor != null ? s.outlineColor : Color.WHITE;
|
||||||
double ow = s.outlineWidth > 0 ? s.outlineWidth : 1.0;
|
double ow = s.outlineWidth > 0 ? s.outlineWidth : 1.0;
|
||||||
slices.add(new Slice(angle, sweep, fill, outline, ow));
|
slices.add(new Slice(angle, sweep, fill, outline, ow));
|
||||||
angle += sweep;
|
angle += sweep;
|
||||||
|
|||||||
@@ -48,13 +48,13 @@ final class PrstGeomShapes {
|
|||||||
return new Shape(new Area(new Ellipse2D.Double(x, y, w, h)), null);
|
return new Shape(new Area(new Ellipse2D.Double(x, y, w, h)), null);
|
||||||
}
|
}
|
||||||
case "gear6", "gear9" -> {
|
case "gear6", "gear9" -> {
|
||||||
int teeth = p.equals("gear6") ? 6 : 9;
|
int teeth = "gear6".equals(p) ? 6 : 9;
|
||||||
return gear(x, y, w, h, teeth);
|
return gear(x, y, w, h, teeth);
|
||||||
}
|
}
|
||||||
case "circularArrow", "leftCircularArrow", "rightCircularArrow",
|
case "circularArrow", "leftCircularArrow", "rightCircularArrow",
|
||||||
"curvedRightArrow", "curvedLeftArrow" -> {
|
"curvedRightArrow", "curvedLeftArrow" -> {
|
||||||
return circularArrow(x, y, w, h, adj,
|
return circularArrow(x, y, w, h, adj,
|
||||||
p.equals("leftCircularArrow") || p.equals("curvedLeftArrow"));
|
"leftCircularArrow".equals(p) || "curvedLeftArrow".equals(p));
|
||||||
}
|
}
|
||||||
default -> {
|
default -> {
|
||||||
return new Shape(new Area(new Rectangle2D.Double(x, y, w, h)), null);
|
return new Shape(new Area(new Rectangle2D.Double(x, y, w, h)), null);
|
||||||
@@ -126,8 +126,8 @@ final class PrstGeomShapes {
|
|||||||
a1 += 2 * Math.PI;
|
a1 += 2 * Math.PI;
|
||||||
}
|
}
|
||||||
Path2D path = new Path2D.Double();
|
Path2D path = new Path2D.Double();
|
||||||
arcSegment(path, cx, cy, rOuter, a0, a1, true);
|
arcSegment(path, cx, cy, rOuter, a0, a1);
|
||||||
arcSegment(path, cx, cy, rInner, a1, a0, false);
|
arcSegment(path, cx, cy, rInner, a1, a0);
|
||||||
path.closePath();
|
path.closePath();
|
||||||
Area area = new Area(path);
|
Area area = new Area(path);
|
||||||
|
|
||||||
@@ -152,7 +152,7 @@ final class PrstGeomShapes {
|
|||||||
}
|
}
|
||||||
|
|
||||||
private static void arcSegment(Path2D path, double cx, double cy, double r,
|
private static void arcSegment(Path2D path, double cx, double cy, double r,
|
||||||
double a0, double a1, boolean forward) {
|
double a0, double a1) {
|
||||||
int steps = Math.max(2, (int) (Math.abs(a1 - a0) / Math.toRadians(4)));
|
int steps = Math.max(2, (int) (Math.abs(a1 - a0) / Math.toRadians(4)));
|
||||||
for (int i = 0; i <= steps; i++) {
|
for (int i = 0; i <= steps; i++) {
|
||||||
double t = a0 + (a1 - a0) * i / steps;
|
double t = a0 + (a1 - a0) * i / steps;
|
||||||
|
|||||||
@@ -38,7 +38,7 @@ final class RgbHsl {
|
|||||||
}
|
}
|
||||||
|
|
||||||
static Color fromHsl(double h, double s, double l) {
|
static Color fromHsl(double h, double s, double l) {
|
||||||
double hh = (((h % 360) + 360) % 360) / 360.0;
|
double hh = (h % 360 + 360) % 360 / 360.0;
|
||||||
double ss = Math.max(0, Math.min(1, s));
|
double ss = Math.max(0, Math.min(1, s));
|
||||||
double ll = Math.max(0, Math.min(1, l));
|
double ll = Math.max(0, Math.min(1, l));
|
||||||
double r, g, b;
|
double r, g, b;
|
||||||
|
|||||||
@@ -8,12 +8,10 @@ import org.docx4j.dml.CTPositiveSize2D;
|
|||||||
import org.docx4j.dml.CTPresetGeometry2D;
|
import org.docx4j.dml.CTPresetGeometry2D;
|
||||||
import org.docx4j.dml.CTShapeProperties;
|
import org.docx4j.dml.CTShapeProperties;
|
||||||
import org.docx4j.dml.CTShapeStyle;
|
import org.docx4j.dml.CTShapeStyle;
|
||||||
import org.docx4j.dml.CTTextBody;
|
|
||||||
import org.docx4j.dml.CTTransform2D;
|
import org.docx4j.dml.CTTransform2D;
|
||||||
import org.docx4j.dml.diagram.CTCxn;
|
import org.docx4j.dml.diagram.CTCxn;
|
||||||
import org.docx4j.dml.diagram.CTDataModel;
|
import org.docx4j.dml.diagram.CTDataModel;
|
||||||
import org.docx4j.dml.diagram.STCxnType;
|
import org.docx4j.dml.diagram.STCxnType;
|
||||||
import org.docx4j.dml.diagram.CTElemPropSet;
|
|
||||||
import org.docx4j.dml.diagram.CTPt;
|
import org.docx4j.dml.diagram.CTPt;
|
||||||
import org.docx4j.dml.diagram2008.CTDrawing;
|
import org.docx4j.dml.diagram2008.CTDrawing;
|
||||||
import org.docx4j.dml.diagram2008.CTShape;
|
import org.docx4j.dml.diagram2008.CTShape;
|
||||||
|
|||||||
@@ -187,7 +187,7 @@ final class Surface3dPainter {
|
|||||||
Fit fit = new Fit(scale, scale, offX, offY);
|
Fit fit = new Fit(scale, scale, offX, offY);
|
||||||
|
|
||||||
// 3. Пол, дальняя стенка и их сетки — под поверхностью
|
// 3. Пол, дальняя стенка и их сетки — под поверхностью
|
||||||
drawFloor(g, spec, floor, valueAnchors, nCat, nSer, lo, hi, unit, span,
|
drawFloor(g, spec, floor, nCat, nSer, lo, hi, unit, span,
|
||||||
rotX, rotY, depthScale, heightScale, persp, fit);
|
rotX, rotY, depthScale, heightScale, persp, fit);
|
||||||
|
|
||||||
// 4. Грани: два треугольника на ячейку, каждый разрезан по
|
// 4. Грани: два треугольника на ячейку, каждый разрезан по
|
||||||
@@ -379,7 +379,7 @@ final class Surface3dPainter {
|
|||||||
|
|
||||||
/** Сетка пола и дальней стенки; рисуется до поверхности. */
|
/** Сетка пола и дальней стенки; рисуется до поверхности. */
|
||||||
private static void drawFloor(Graphics2D g, ChartSpec spec, Node[] floor,
|
private static void drawFloor(Graphics2D g, ChartSpec spec, Node[] floor,
|
||||||
List<Node> valueAnchors, int nCat, int nSer,
|
int nCat, int nSer,
|
||||||
double lo, double hi, double unit, double span,
|
double lo, double hi, double unit, double span,
|
||||||
double rotX, double rotY, double depthScale,
|
double rotX, double rotY, double depthScale,
|
||||||
double heightScale, double persp,
|
double heightScale, double persp,
|
||||||
|
|||||||
@@ -193,7 +193,7 @@ public final class SampleDocxGenerator {
|
|||||||
// Размеры в EMU (1 px @ 96 dpi = 9525 EMU)
|
// Размеры в EMU (1 px @ 96 dpi = 9525 EMU)
|
||||||
XWPFParagraph imgPara = doc.createParagraph();
|
XWPFParagraph imgPara = doc.createParagraph();
|
||||||
XWPFRun imgRun = imgPara.createRun();
|
XWPFRun imgRun = imgPara.createRun();
|
||||||
imgRun.addPicture(new java.io.ByteArrayInputStream(bos.toByteArray()),
|
imgRun.addPicture(new ByteArrayInputStream(bos.toByteArray()),
|
||||||
PictureType.PNG, "test-image.png",
|
PictureType.PNG, "test-image.png",
|
||||||
120 * 9525, 60 * 9525);
|
120 * 9525, 60 * 9525);
|
||||||
|
|
||||||
@@ -392,7 +392,7 @@ public final class SampleDocxGenerator {
|
|||||||
java.util.zip.ZipEntry e;
|
java.util.zip.ZipEntry e;
|
||||||
while ((e = zin.getNextEntry()) != null) {
|
while ((e = zin.getNextEntry()) != null) {
|
||||||
byte[] data = zin.readAllBytes();
|
byte[] data = zin.readAllBytes();
|
||||||
if (e.getName().equals("word/document.xml")) {
|
if ("word/document.xml".equals(e.getName())) {
|
||||||
String xml = new String(data, java.nio.charset.StandardCharsets.UTF_8);
|
String xml = new String(data, java.nio.charset.StandardCharsets.UTF_8);
|
||||||
StringBuilder sb = new StringBuilder(xml.length() + 4096);
|
StringBuilder sb = new StringBuilder(xml.length() + 4096);
|
||||||
int i = 0;
|
int i = 0;
|
||||||
|
|||||||
@@ -432,22 +432,38 @@ 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, ни OLE2) — отказ как некорректный
|
||||||
|
* вход (ValidationException), а не ошибка рендера: вход конвертера
|
||||||
|
* прогоняет тот же {@link WordPdfValidator#validate(byte[], ConvertOptions)},
|
||||||
|
* что и приложение до очереди. Регрессия —
|
||||||
|
* WordPdfValidatorTest#validate_neitherDocxNorDoc.
|
||||||
|
*/
|
||||||
|
@Test
|
||||||
|
void inputNotAZip_rejectedBeforeRender() {
|
||||||
|
byte[] junk = {1, 2, 3, 4, 5, 6, 7, 8};
|
||||||
|
ValidationException ex = assertThrows(ValidationException.class, () ->
|
||||||
|
WordPdfConverter.convert(junk, "junk"));
|
||||||
|
assertTrue(ex.getMessage().contains("не похоже на .docx или .doc"),
|
||||||
|
"сообщение должно упоминать подписи контейнера: " + ex.getMessage());
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Лимит размера переопределяется {@link ConvertOptions} на вызов:
|
* Лимит размера переопределяется {@link ConvertOptions} на вызов:
|
||||||
* maxBytes=1000 отсекает даже маленький документ до рендера, сообщение
|
* maxBytes=1000 отсекает даже маленький документ до рендера, сообщение
|
||||||
@@ -455,7 +471,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 +485,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 +502,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-границы не страницы");
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -227,12 +164,12 @@ class WordPdfValidatorTest {
|
|||||||
ByteArrayOutputStream out = new ByteArrayOutputStream();
|
ByteArrayOutputStream out = new ByteArrayOutputStream();
|
||||||
try (java.util.zip.ZipInputStream zin = new java.util.zip.ZipInputStream(
|
try (java.util.zip.ZipInputStream zin = new java.util.zip.ZipInputStream(
|
||||||
new java.io.ByteArrayInputStream(base));
|
new java.io.ByteArrayInputStream(base));
|
||||||
java.util.zip.ZipOutputStream zout = new java.util.zip.ZipOutputStream(out)) {
|
ZipOutputStream zout = new ZipOutputStream(out)) {
|
||||||
java.util.zip.ZipEntry e;
|
ZipEntry e;
|
||||||
while ((e = zin.getNextEntry()) != null) {
|
while ((e = zin.getNextEntry()) != null) {
|
||||||
byte[] data = zin.readAllBytes();
|
byte[] data = zin.readAllBytes();
|
||||||
if (e.getName().equals("word/document.xml")) {
|
if ("word/document.xml".equals(e.getName())) {
|
||||||
String xml = new String(data, java.nio.charset.StandardCharsets.UTF_8);
|
String xml = new String(data, StandardCharsets.UTF_8);
|
||||||
StringBuilder sb = new StringBuilder();
|
StringBuilder sb = new StringBuilder();
|
||||||
for (String t : types) {
|
for (String t : types) {
|
||||||
sb.append("<w:sectPr><w:type w:val=\"").append(t)
|
sb.append("<w:sectPr><w:type w:val=\"").append(t)
|
||||||
@@ -250,9 +187,9 @@ class WordPdfValidatorTest {
|
|||||||
xml = xml.substring(0, at) + "<w:body>" + sb + "</w:body>"
|
xml = xml.substring(0, at) + "<w:body>" + sb + "</w:body>"
|
||||||
+ xml.substring(at + "<w:body/>".length());
|
+ xml.substring(at + "<w:body/>".length());
|
||||||
}
|
}
|
||||||
data = xml.getBytes(java.nio.charset.StandardCharsets.UTF_8);
|
data = xml.getBytes(StandardCharsets.UTF_8);
|
||||||
}
|
}
|
||||||
zout.putNextEntry(new java.util.zip.ZipEntry(e.getName()));
|
zout.putNextEntry(new ZipEntry(e.getName()));
|
||||||
zout.write(data);
|
zout.write(data);
|
||||||
zout.closeEntry();
|
zout.closeEntry();
|
||||||
}
|
}
|
||||||
@@ -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));
|
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -307,24 +238,66 @@ class WordPdfValidatorTest {
|
|||||||
p.createRun().setText("t" + i);
|
p.createRun().setText("t" + i);
|
||||||
p.createRun().addBreak(BreakType.PAGE);
|
p.createRun().addBreak(BreakType.PAGE);
|
||||||
}
|
}
|
||||||
java.io.ByteArrayOutputStream bos = new java.io.ByteArrayOutputStream();
|
ByteArrayOutputStream bos = new ByteArrayOutputStream();
|
||||||
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_neitherDocxNorDoc() {
|
||||||
|
byte[] junk = {1, 2, 3, 4, 5};
|
||||||
|
ValidationException ex = assertThrows(ValidationException.class,
|
||||||
|
() -> WordPdfValidator.validate(junk, ConvertOptions.defaults()));
|
||||||
|
assertTrue(ex.getMessage().contains("не похоже на .docx или .doc"),
|
||||||
|
"сообщение должно упоминать обе подписи контейнера: " + 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());
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -92,7 +92,7 @@ class BundledFontsTest {
|
|||||||
|
|
||||||
// populateFontMappings вызывается при setFontMapper; проверяем
|
// populateFontMappings вызывается при setFontMapper; проверяем
|
||||||
// итоговое состояние через публичный get()
|
// итоговое состояние через публичный get()
|
||||||
java.util.Set<String> names = new java.util.HashSet<>(List.of(
|
Set<String> names = new java.util.HashSet<>(List.of(
|
||||||
"Calibri", "Times New Roman", "Arial", "Cousine", "UnknownExoticFont"));
|
"Calibri", "Times New Roman", "Arial", "Cousine", "UnknownExoticFont"));
|
||||||
// wmlFonts не может быть null (super обращается к getFont()),
|
// wmlFonts не может быть null (super обращается к getFont()),
|
||||||
// поэтому — пустой объект (как у документа без fontTable)
|
// поэтому — пустой объект (как у документа без fontTable)
|
||||||
|
|||||||
-2
@@ -24,8 +24,6 @@ class GlyphCoverageNormalizerTest {
|
|||||||
private static final String ROMAN = "\u2181";
|
private static final String ROMAN = "\u2181";
|
||||||
/** Знак, которого нет ни в одном бандл-шрифте. */
|
/** Знак, которого нет ни в одном бандл-шрифте. */
|
||||||
private static final String NOWHERE = "\u2188";
|
private static final String NOWHERE = "\u2188";
|
||||||
/** Обычная кириллица — есть в Tinos. */
|
|
||||||
private static final String CYRILLIC = "ы";
|
|
||||||
|
|
||||||
@BeforeAll
|
@BeforeAll
|
||||||
static void initFonts() {
|
static void initFonts() {
|
||||||
|
|||||||
@@ -0,0 +1,22 @@
|
|||||||
|
# FROM с полным именем реестра: podman не резолвит short-name без
|
||||||
|
# unqualified-search-registries в /etc/containers/registries.conf.
|
||||||
|
FROM docker.io/library/node:24-alpine AS build
|
||||||
|
# buildah подмешивает прокси-переменные хоста в каждый RUN (ENV не перебивает),
|
||||||
|
# а 127.0.0.1 внутри контейнера недостижим — npm ci падает с ECONNREFUSED на
|
||||||
|
# 127.0.0.1:proxy. Контейнер в сеть ходит напрямую, потому обнуляем прокси
|
||||||
|
# на самой команде.
|
||||||
|
WORKDIR /build
|
||||||
|
COPY package.json package-lock.json ./
|
||||||
|
RUN HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= ALL_PROXY= all_proxy= npm ci
|
||||||
|
COPY . .
|
||||||
|
# base для сборки SPA под префиксом: прод pjandro.ru — /pdf-converter/
|
||||||
|
# (compose прод-запуска передаёт arg); дефолт '/' — standalone
|
||||||
|
ARG VITE_BASE=/
|
||||||
|
ENV VITE_BASE=${VITE_BASE}
|
||||||
|
RUN npm run build
|
||||||
|
|
||||||
|
FROM docker.io/library/nginx:alpine
|
||||||
|
COPY --from=build /build/dist /usr/share/nginx/html
|
||||||
|
# прокси-переменные хоста подмешиваются в HEALTHCHECK-шелл — обнуляем на команде
|
||||||
|
HEALTHCHECK --interval=10s --timeout=3s --start-period=10s \
|
||||||
|
CMD http_proxy= https_proxy= wget -qO /dev/null http://127.0.0.1/ || exit 1
|
||||||
@@ -1,21 +0,0 @@
|
|||||||
FROM node:24-alpine AS build
|
|
||||||
# docker-прокси из ~/.docker/config.json BuildKit подмешивает в каждый RUN
|
|
||||||
# (ENV не перебивает), а 127.0.0.1 внутри контейнера недостижим — npm ci падает
|
|
||||||
# с ECONNREFUSED. Контейнер в сеть ходит напрямую, потому обнуляем прокси
|
|
||||||
# на самой команде.
|
|
||||||
WORKDIR /build
|
|
||||||
COPY package.json package-lock.json ./
|
|
||||||
RUN HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= ALL_PROXY= all_proxy= npm ci
|
|
||||||
COPY . .
|
|
||||||
# base для сборки SPA под префиксом: прод pjandro.ru — /pdf-converter/
|
|
||||||
# (compose прод-запуска передаёт arg); дефолт '/' — standalone
|
|
||||||
ARG VITE_BASE=/
|
|
||||||
ENV VITE_BASE=${VITE_BASE}
|
|
||||||
RUN npm run build
|
|
||||||
|
|
||||||
FROM nginx:alpine
|
|
||||||
COPY nginx.conf /etc/nginx/conf.d/default.conf
|
|
||||||
COPY --from=build /build/dist /usr/share/nginx/html
|
|
||||||
# прокси из docker-config подмешивается в HEALTHCHECK-шелл — обнуляем на команде
|
|
||||||
HEALTHCHECK --interval=10s --timeout=3s --start-period=10s \
|
|
||||||
CMD http_proxy= https_proxy= wget -qO /dev/null http://127.0.0.1/ || exit 1
|
|
||||||
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
SPA-фронт конвертера Word → PDF: React 19 + TypeScript + Vite + Tailwind CSS v4.
|
SPA-фронт конвертера Word → PDF: React 19 + TypeScript + Vite + Tailwind CSS v4.
|
||||||
В Maven-сборку не входит; деплоится отдельным nginx-контейнером (см.
|
В Maven-сборку не входит; деплоится отдельным nginx-контейнером (см.
|
||||||
`Dockerfile`/`nginx.conf` и корневой `docker-compose.yml`).
|
`Containerfile`/`nginx.conf` и корневой `compose.yml`).
|
||||||
|
|
||||||
## Dev
|
## Dev
|
||||||
|
|
||||||
|
|||||||
@@ -70,3 +70,25 @@ export async function convertDocx(
|
|||||||
const blob = await resp.blob()
|
const blob = await resp.blob()
|
||||||
return { blob, filename }
|
return { blob, filename }
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Требует ли сервер ключ: GET /api/v1/convert (эндпоинт POST-only) —
|
||||||
|
* 401 пишет ApiKeyFilter при требуемом и непринятом ключе; при выключенной
|
||||||
|
* аутентификации (dev) до фильтра дело не доходит — 405 от Spring.
|
||||||
|
* Сетевая ошибка — 'open': не блокировать UI, конвертация сама покажет ошибку.
|
||||||
|
*/
|
||||||
|
export async function probeApiKey(): Promise<'open' | 'required'> {
|
||||||
|
const key = getApiKey()
|
||||||
|
try {
|
||||||
|
const resp = await fetch(`${import.meta.env.BASE_URL}api/v1/convert`, {
|
||||||
|
headers: key ? { 'X-API-Key': key } : undefined,
|
||||||
|
})
|
||||||
|
if (resp.status === 401) {
|
||||||
|
clearApiKey() // ключ устарел/отозван — форма откроется пустой
|
||||||
|
return 'required'
|
||||||
|
}
|
||||||
|
return 'open'
|
||||||
|
} catch {
|
||||||
|
return 'open'
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|||||||
@@ -1,5 +1,5 @@
|
|||||||
import { useEffect, useRef, useState } from 'react'
|
import { useEffect, useRef, useState } from 'react'
|
||||||
import { ApiError, convertDocx, getApiKey, setApiKey, UnauthorizedError } from '../api'
|
import { ApiError, convertDocx, probeApiKey, setApiKey, UnauthorizedError } from '../api'
|
||||||
import ApiKeyGate from './ApiKeyGate'
|
import ApiKeyGate from './ApiKeyGate'
|
||||||
import DropZone from './DropZone'
|
import DropZone from './DropZone'
|
||||||
import Logo from './Logo'
|
import Logo from './Logo'
|
||||||
@@ -47,8 +47,11 @@ export default function App() {
|
|||||||
if (on) setRenderSmartArt(false)
|
if (on) setRenderSmartArt(false)
|
||||||
}
|
}
|
||||||
|
|
||||||
// ключ в localStorage: публичная статика, в бандл зашивать нельзя
|
// экран ключа показываем только когда сервер реально требует ключ: зонд
|
||||||
const [apiKey, setApiKeyValue] = useState<string | null>(() => getApiKey())
|
// probeApiKey (GET /api/v1/convert → 401) решает до загрузки файла; в dev
|
||||||
|
// без ключа форма открывается сразу. Ключ лежит в localStorage (публичная
|
||||||
|
// статика, в бандл зашивать нельзя), читает его api.ts сам.
|
||||||
|
const [gate, setGate] = useState<'checking' | 'open' | 'required'>('checking')
|
||||||
const [keyError, setKeyError] = useState<string | null>(null)
|
const [keyError, setKeyError] = useState<string | null>(null)
|
||||||
|
|
||||||
// снимаем blob-URL предыдущего результата — иначе он течёт до закрытия вкладки
|
// снимаем blob-URL предыдущего результата — иначе он течёт до закрытия вкладки
|
||||||
@@ -90,7 +93,7 @@ export default function App() {
|
|||||||
// UnauthorizedError раньше ApiError: он её наследник; ключ уже
|
// UnauthorizedError раньше ApiError: он её наследник; ключ уже
|
||||||
// очищен в api.ts — форма откроется пустой
|
// очищен в api.ts — форма откроется пустой
|
||||||
if (e instanceof UnauthorizedError) {
|
if (e instanceof UnauthorizedError) {
|
||||||
setApiKeyValue(null)
|
setGate('required')
|
||||||
setKeyError('Ключ доступа не принят — введите заново')
|
setKeyError('Ключ доступа не принят — введите заново')
|
||||||
setStatus('idle')
|
setStatus('idle')
|
||||||
return
|
return
|
||||||
@@ -112,13 +115,22 @@ export default function App() {
|
|||||||
[],
|
[],
|
||||||
)
|
)
|
||||||
|
|
||||||
if (!apiKey)
|
useEffect(() => {
|
||||||
|
probeApiKey().then(setGate)
|
||||||
|
}, [])
|
||||||
|
|
||||||
|
// зонд — один быстрый same-origin запрос, спиннер не вводим
|
||||||
|
if (gate === 'checking') return null
|
||||||
|
|
||||||
|
if (gate === 'required')
|
||||||
return (
|
return (
|
||||||
<ApiKeyGate
|
<ApiKeyGate
|
||||||
error={keyError}
|
error={keyError}
|
||||||
onSubmit={(k) => {
|
onSubmit={(k) => {
|
||||||
setApiKey(k)
|
setApiKey(k)
|
||||||
setApiKeyValue(k)
|
// повторный зонд не шлём: неверный ключ всплывёт 401 на первой
|
||||||
|
// конвертации (текущий контракт гейта)
|
||||||
|
setGate('open')
|
||||||
setKeyError(null)
|
setKeyError(null)
|
||||||
// возврат после отзыва ключа не должен показать «Конвертация…»/старый результат
|
// возврат после отзыва ключа не должен показать «Конвертация…»/старый результат
|
||||||
setStatus('idle')
|
setStatus('idle')
|
||||||
@@ -140,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/doc → PDF на docx4j + Apache FOP. Лимиты (файл ≤ 20 МБ,
|
docx/doc → PDF на docx4j + Apache FOP. Лимиты (файл ≤ 5 МБ,
|
||||||
≤ 1000 страниц) задаёт сервер; переопределение из формы убрано.
|
≤ 100 страниц) задаёт сервер; переопределение из формы убрано.
|
||||||
</p>
|
</p>
|
||||||
</div>
|
</div>
|
||||||
</header>
|
</header>
|
||||||
|
|||||||
@@ -9,6 +9,8 @@ export default defineConfig({
|
|||||||
base: process.env.VITE_BASE ?? '/',
|
base: process.env.VITE_BASE ?? '/',
|
||||||
plugins: [react(), tailwindcss()],
|
plugins: [react(), tailwindcss()],
|
||||||
server: {
|
server: {
|
||||||
|
// dev-сервер наружу: слушает все интерфейсы (LAN-доступ к стенду с других машин)
|
||||||
|
host: true,
|
||||||
// dev без CORS: запросы /api и документация (/swagger-ui*, /v3/api-docs*) идут на бэкенд через прокси
|
// dev без CORS: запросы /api и документация (/swagger-ui*, /v3/api-docs*) идут на бэкенд через прокси
|
||||||
proxy: {
|
proxy: {
|
||||||
'/api': 'http://localhost:8080',
|
'/api': 'http://localhost:8080',
|
||||||
|
|||||||
Reference in New Issue
Block a user