Замена wordpdf-cli на Spring Boot REST API: wordpdf-app, SPA wordpdf-web, docker-compose
This commit is contained in:
@@ -0,0 +1,10 @@
|
|||||||
|
target/
|
||||||
|
*/target/
|
||||||
|
.git/
|
||||||
|
.codegraph/
|
||||||
|
diff/
|
||||||
|
.idea/
|
||||||
|
*.iml
|
||||||
|
dependency-reduced-pom.xml
|
||||||
|
wordpdf-web/node_modules
|
||||||
|
wordpdf-web/dist
|
||||||
@@ -2,6 +2,10 @@
|
|||||||
target/
|
target/
|
||||||
dependency-reduced-pom.xml
|
dependency-reduced-pom.xml
|
||||||
|
|
||||||
|
# Node (wordpdf-web)
|
||||||
|
node_modules/
|
||||||
|
wordpdf-web/dist/
|
||||||
|
|
||||||
# IDE
|
# IDE
|
||||||
.idea/
|
.idea/
|
||||||
*.iml
|
*.iml
|
||||||
|
|||||||
@@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
## Project Overview
|
## Project Overview
|
||||||
|
|
||||||
Конвертер `.docx` → `.pdf` на чистом Java (docx4j + Apache FOP, без LibreOffice/Aspose). Java 17, только Maven. Модули: `wordpdf-core` (библиотека), `wordpdf-cli` (fat-jar через maven-shade). Единственный гейт перед `git push` — `mvn clean verify` (CI/lint в репозитории нет).
|
Конвертер `.docx` → `.pdf` на чистом Java (docx4j + Apache FOP, без LibreOffice/Aspose). Java 21, только Maven. Модули: `wordpdf-core` (библиотека), `wordpdf-app` (Spring Boot REST API); плюс `wordpdf-web` — React SPA в nginx-контейнере (отдельный деп, вне Maven). Единственный гейт перед `git push` — `mvn clean verify` (CI/lint в репозитории нет; SPA гейтуется `npm run build`).
|
||||||
|
|
||||||
## Architecture & Data Flow
|
## Architecture & Data Flow
|
||||||
|
|
||||||
@@ -21,16 +21,21 @@
|
|||||||
→ `Docx4J.toFO(..., FLAG_EXPORT_PREFER_XSL)`.
|
→ `Docx4J.toFO(..., FLAG_EXPORT_PREFER_XSL)`.
|
||||||
5. `finally`: `deleteEmbeddedFontTempFiles()` (в 17.x `OpcPackage.close()` нет).
|
5. `finally`: `deleteEmbeddedFontTempFiles()` (в 17.x `OpcPackage.close()` нет).
|
||||||
|
|
||||||
|
### REST API (`wordpdf-app`)
|
||||||
|
|
||||||
|
- Конвертации **сериализованы** однопоточным `ThreadPoolExecutor` (очередь 16, переполнение → 503): ядро мутирует глобальный реестр `PhysicalFonts` (шаг 1 пайплайна), параллельные конвертации вырывают его друг у друга из-под рендера.
|
||||||
|
- Разделение ошибок: валидация байтов до очереди (`WordPdfValidator.checkInput(byte[])` + проверка zip-подписи + `checkPageCountLightweight(byte[])`) → `ValidationException` → 400; ошибки ядра/рендера → `ConversionFailedException` → 500; очередь занята → 503; таймаут (`wordpdf.convert-timeout`, 2m) → 504. Граница: сломанный контейнер → 400, валидный zip с мусором внутри → 500.
|
||||||
|
- Фронт ходит только на относительный `/api/...` — CORS не нужен (dev: vite-proxy → :8080; prod: nginx).
|
||||||
|
|
||||||
### Критические инварианты (нарушение = битый вывод)
|
### Критические инварианты (нарушение = битый вывод)
|
||||||
|
|
||||||
- **`docx4j.convert.out.fo.gsubFeatures=false`** — ставится в статическом блоке `WordPdfConverter`. Иначе docx4j навешивает `fox:gsub-features` без объявления префикса → FO невалиден → `WordLayoutFixups` молча отказывается от всех фиксов → FOP падает на `docx4j-baseline`. Без фиксов нет колонок и колонок таблиц.
|
- **`docx4j.convert.out.fo.gsubFeatures=false`** — ставится в статическом блоке `WordPdfConverter`. Иначе docx4j навешивает `fox:gsub-features` без объявления префикса → FO невалиден → `WordLayoutFixups` молча отказывается от всех фиксов → FOP падает на `docx4j-baseline`. Без фиксов нет колонок и колонок таблиц.
|
||||||
- **`ServicesResourceTransformer` в maven-shade (`wordpdf-cli`) обязателен**: `META-INF/services/org.apache.fop.fo.ElementMapping` дублируется в `docx4j-fo-renderer-core` и `docx4j-export-fo`; без слияния FOP падает на `UnknownXMLObj cannot be cast to Root`. В fat-jar из тестов не видно — проверять `java -jar`.
|
- **`slf4j-simple` обязателен** в ядре: без него docx4j пишет «TO HIDE THESE MESSAGES» прямо в выходной PDF (регрессия `noLoggingWarningInPdf`). Приложение (`wordpdf-app`) исключает `slf4j-simple` из зависимости ядра — логи ведёт logback из Boot; предупреждение в PDF возникает только при полном отсутствии SLF4J-провайдера, `slf4j-simple.properties` из core остаётся инертным ресурсом.
|
||||||
- **Не убирать shade-фильтры `META-INF/*.SF|*.DSA|*.RSA`** — подписанные jar ломают fat-jar.
|
|
||||||
- **`slf4j-simple` обязателен**: без него docx4j пишет «TO HIDE THESE MESSAGES» прямо в выходной PDF (регрессия `noLoggingWarningInPdf`).
|
|
||||||
- **JAXB-обход обязан раскрывать `JAXBElement`** (иначе таблицы/раны молча пропускаются — оценка «1» вместо 121). Рекурсия через `ContentAccessor` из `org.docx4j.wml` (НЕ `org.docx4j.contentcontrol` — в 17.x его нет). Тип секции — `SectPr$Type.getVal()`; маркер — `R.LastRenderedPageBreak` (`CTLastRenderedPageBreak` в 17.x отсутствует).
|
- **JAXB-обход обязан раскрывать `JAXBElement`** (иначе таблицы/раны молча пропускаются — оценка «1» вместо 121). Рекурсия через `ContentAccessor` из `org.docx4j.wml` (НЕ `org.docx4j.contentcontrol` — в 17.x его нет). Тип секции — `SectPr$Type.getVal()`; маркер — `R.LastRenderedPageBreak` (`CTLastRenderedPageBreak` в 17.x отсутствует).
|
||||||
- FOP — форк `org.docx4j:docx4j-fo-renderer*` 2.11-docx4j.2 (пакеты `org.apache.fop.*`), умеет хинты `docx4j:baseline`/`docx4j:line-box`. `Fop.Renderers.getRenderer()` возвращает **список** — `FopFallbackFonts.rendererFonts` ищет `application/pdf`.
|
- FOP — форк `org.docx4j:docx4j-fo-renderer*` 2.11-docx4j.2 (пакеты `org.apache.fop.*`), умеет хинты `docx4j:baseline`/`docx4j:line-box`. `Fop.Renderers.getRenderer()` возвращает **список** — `FopFallbackFonts.rendererFonts` ищет `application/pdf`.
|
||||||
- `docx2fo.xslt` в репозитория нет — он в jar `docx4j-export-fo`. `WordLayoutFixups` (включён по умолчанию в 17.x) постобработкой DOM FO даёт реальные колонки `w:cols/@w:num` и колонки таблиц; побочный эффект — авто-ширины колонок без `tblGrid`/`tcW` стали уже (слово может перенестись в ячейке).
|
- `docx2fo.xslt` в репозитория нет — он в jar `docx4j-export-fo`. `WordLayoutFixups` (включён по умолчанию в 17.x) постобработкой DOM FO даёт реальные колонки `w:cols/@w:num` и колонки таблиц; побочный эффект — авто-ширины колонок без `tblGrid`/`tcW` стали уже (слово может перенестись в ячейке).
|
||||||
- Известный остаток эталона: U+2188 (ↈ) и U+218A (↊) — глифов нет ни в одном OFL-шрифте бандла, остаются `.notdef` (GNU FreeSerif GPL — не добавляем намеренно).
|
- Известный остаток эталона: U+2188 (ↈ) и U+218A (↊) — глифов нет ни в одном OFL-шрифте бандла, остаются `.notdef` (GNU FreeSerif GPL — не добавляем намеренно).
|
||||||
|
- **nginx `client_max_body_size 6m`** (`wordpdf-web/nginx.conf`) обязателен: без него upload > 1 МБ режется HTML-413 от nginx до бэкенда вместо JSON-ошибки API.
|
||||||
|
|
||||||
### Шрифты (30 TTF в `wordpdf-core/src/main/resources/fonts/`, SIL OFL)
|
### Шрифты (30 TTF в `wordpdf-core/src/main/resources/fonts/`, SIL OFL)
|
||||||
|
|
||||||
@@ -56,7 +61,10 @@
|
|||||||
| `…/wordpdf/internal/chart/` | Java2D-рендер диаграмм/SmartArt в PNG |
|
| `…/wordpdf/internal/chart/` | Java2D-рендер диаграмм/SmartArt в PNG |
|
||||||
| `wordpdf-core/src/main/resources/fonts/` | 30 TTF + лицензии — бинарные фикстуры, часть jar |
|
| `wordpdf-core/src/main/resources/fonts/` | 30 TTF + лицензии — бинарные фикстуры, часть jar |
|
||||||
| `wordpdf-core/src/test/resources/samples/` | 11 закоммиченных `.docx`-фикстур (единственные фикстуры) |
|
| `wordpdf-core/src/test/resources/samples/` | 11 закоммиченных `.docx`-фикстур (единственные фикстуры) |
|
||||||
| `wordpdf-cli/src/main/java/…/cli/` | `WordPdfCli` (fat-jar) |
|
| `wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/` | REST API: `ConvertController`, `ConversionService` (очередь), `ApiExceptionHandler` |
|
||||||
|
| `wordpdf-web/src/` | SPA (React+TS+Vite+Tailwind): компоненты в `components/`, вся сеть в `api.ts` |
|
||||||
|
| корневые `Dockerfile`, `docker-compose.yml` | образ бэкенда (multi-stage, temurin-21); compose web+app |
|
||||||
|
| `wordpdf-web/Dockerfile`, `wordpdf-web/nginx.conf` | образ SPA (node→nginx); прокси `/api`, `/swagger-ui`, `/v3/api-docs` |
|
||||||
| `references/` | эталон Word 365 (`word.docx` + `word.pdf`) — **ручное сравнение, не фикстуры**, в тесты/jar не подключать |
|
| `references/` | эталон Word 365 (`word.docx` + `word.pdf`) — **ручное сравнение, не фикстуры**, в тесты/jar не подключать |
|
||||||
| `diff/`, корневые `word-export.*` | gitignored артефакты ручной калибровки |
|
| `diff/`, корневые `word-export.*` | gitignored артефакты ручной калибровки |
|
||||||
|
|
||||||
@@ -64,14 +72,14 @@
|
|||||||
|
|
||||||
```bash
|
```bash
|
||||||
mvn clean verify # все модули + тесты — обязательный гейт перед push
|
mvn clean verify # все модули + тесты — обязательный гейт перед push
|
||||||
mvn -pl wordpdf-cli package # fat-jar (из корня); из каталога cli — только с -am
|
mvn -pl wordpdf-app -am package # исполняемый jar бэкенда
|
||||||
java -jar wordpdf-cli/target/wordpdf-cli-1.0.0.jar in.docx [out.pdf]
|
java -jar wordpdf-app/target/wordpdf-app-1.0.0.jar # :8080, POST /api/v1/convert
|
||||||
|
npm run dev # (wordpdf-web/) SPA :5173, proxy /api → :8080
|
||||||
|
docker compose up -d --build # всё вместе: SPA+nginx публикует :8080, app не публикуется
|
||||||
mvn -pl wordpdf-core test -Dtest=WordPdfConverterTest#pageNumbers_recomputedNotCached # один тест
|
mvn -pl wordpdf-core test -Dtest=WordPdfConverterTest#pageNumbers_recomputedNotCached # один тест
|
||||||
```
|
```
|
||||||
|
|
||||||
CLI: 1 аргумент → PDF рядом с исходником; 2-й `.pdf` → явный выход; **два `.docx` = пакетная конвертация**. Коды возврата: 0 успех, 1 ошибка использования, 2 не сконвертирован хотя бы один файл.
|
Compose: `web` проксирует `/api`, `/swagger-ui`, `/v3/api-docs` на `app` (DNS-имя в сети compose); бэкенд наружу не публикуется. `wordpdf.convert-timeout` переопределяется env `WORDPDF_CONVERT_TIMEOUT` (relaxed binding Boot).
|
||||||
|
|
||||||
`dependency-reduced-pom.xml` — артефакт shade, не коммитить.
|
|
||||||
|
|
||||||
Пересоздать 10 фикстур (POI, test scope; `charts-smartart.docx` НЕ генерируется — исключение):
|
Пересоздать 10 фикстур (POI, test scope; `charts-smartart.docx` НЕ генерируется — исключение):
|
||||||
|
|
||||||
@@ -83,35 +91,35 @@ java -cp wordpdf-core/target/test-classes:$(cat /tmp/cp.txt) \
|
|||||||
|
|
||||||
## Code Conventions & Common Patterns
|
## Code Conventions & Common Patterns
|
||||||
|
|
||||||
- Классы `final`, приватный конструктор, только `static` (stateless, DI нет; конфигурация — `Docx4jProperties` + classpath-ресурсы). Исключения — экземпляры по природе docx4j: `BundledFontMapper` (наследник `BestMatchingMapper`), `DrawMlColor` (палитра темы).
|
- Классы `final`, приватный конструктор, только `static` (stateless, DI нет; конфигурация — `Docx4jProperties` + classpath-ресурсы). Исключения — экземпляры по природе: docx4j-классы `BundledFontMapper` (наследник `BestMatchingMapper`), `DrawMlColor` (палитра темы) и Spring-компоненты `wordpdf-app`.
|
||||||
- Нормализаторы — единая сигнатура `public static byte[] normalize(byte[] docx) throws IOException` с флагом `changed`: нечего менять → вернуть **тот же массив** (`assertSame` в тестах); package-private хук `static String rewrite(String xml)` для юнит-тестов.
|
- Нормализаторы — единая сигнатура `public static byte[] normalize(byte[] docx) throws IOException` с флагом `changed`: нечего менять → вернуть **тот же массив** (`assertSame` в тестах); package-private хук `static String rewrite(String xml)` для юнит-тестов.
|
||||||
- Ошибки публичного API — только `ConversionException extends RuntimeException`; внутренние `IOException`/`IllegalStateException` оборачиваются на границе. В chart — деградация вместо падения: неизвестный пресет → прямоугольник + лог.
|
- Ошибки публичного API — только `ConversionException extends RuntimeException`; внутренние `IOException`/`IllegalStateException` оборачиваются на границе. В chart — деградация вместо падения: неизвестный пресет → прямоугольник + лог.
|
||||||
- Javadoc на русском, объясняет «почему» и ссылается на регрессию и фикстуру (формат: `Регрессия — WordPdfConverterTest#имя, фикстура samples/….docx`) — новый фикс оформлять так же.
|
- Javadoc на русском, объясняет «почему» и ссылается на регрессию и фикстуру (формат: `Регрессия — WordPdfConverterTest#имя, фикстура samples/….docx`) — новый фикс оформлять так же.
|
||||||
- Константы UPPER_SNAKE с числовыми эталонными значениями (`CAMERA_DISTANCE`, `MAX_PAGES`); начертания `V_REGULAR/V_BOLD/...`; модели — `record`; размеры в chart — в пунктах, растр × `DPI/72`.
|
- Константы UPPER_SNAKE с числовыми эталонными значениями (`CAMERA_DISTANCE`, `MAX_PAGES`); начертания `V_REGULAR/V_BOLD/...`; модели — `record`; размеры в chart — в пунктах, растр × `DPI/72`.
|
||||||
- Внутренние API package-private; наружу из `internal` торчат только `normalize`/`declare`/`DrawingPreRenderer.run`.
|
- Внутренние API package-private; наружу из `internal` торчат только `normalize`/`declare`/`DrawingPreRenderer.run`.
|
||||||
- `WordPdfCli.main` тонко обёртывает `public static int run(String[])` — CLI тестируется без `System.exit`.
|
- В `wordpdf-app` всё package-private (контроллер, advice, service, исключения); в SPA вся сетевая логика только в `src/api.ts` — компоненты `fetch` не вызывают.
|
||||||
|
|
||||||
## 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-cli/pom.xml` — shade: Main-Class, `ServicesResourceTransformer`, фильтры подписей.
|
- `wordpdf-app/pom.xml` — `spring-boot-maven-plugin` с **явной** execution `repackage` (в 4.1.1 сам не связывается, jar останется тонким); `slf4j-simple` исключён из зависимости ядра.
|
||||||
- Корневой `pom.xml` — все версии зависимостей (в модулях версии не объявлять): docx4j `17.3.0`, slf4j `2.0.17`, JUnit `5.12.2`, PDFBox `3.0.7` (test), POI `5.5.1` (test, только генератор фикстур); форки FOP/jeuclid приходят транзитивно с `docx4j-export-fo`, пинить не надо.
|
- Корневой `pom.xml` — все версии зависимостей (в модулях версии не объявлять): docx4j `17.3.2`, slf4j `2.0.20`, JUnit `6.1.3`, PDFBox `3.0.8` (test), POI `5.5.1` (test, только генератор фикстур), Spring Boot `4.1.1` (BOM-import), springdoc `3.1.1`; форки FOP/jeuclid приходят транзитивно с `docx4j-export-fo`, пинить не надо.
|
||||||
- `wordpdf-core/src/main/resources/slf4j-simple.properties` — без него предупреждение лезет в PDF.
|
- `wordpdf-core/src/main/resources/slf4j-simple.properties` — без него предупреждение лезет в PDF.
|
||||||
- `wordpdf-core/src/test/java/ru/pjandro/wordpdf/SampleDocxGenerator.java` — main()-утилита пересоздания фикстур (команда в javadoc).
|
- `wordpdf-core/src/test/java/ru/pjandro/wordpdf/SampleDocxGenerator.java` — main()-утилита пересоздания фикстур (команда в javadoc).
|
||||||
|
|
||||||
## Runtime & Tooling Preferences
|
## Runtime & Tooling Preferences
|
||||||
|
|
||||||
- Java 17 + Maven (обязательны; wrapper `mvnw` нет). UTF-8.
|
- Java 21 + Maven (обязательны; wrapper `mvnw` нет). UTF-8. Фронт: Node.js ≥ 20.19 (Vite 7+), вне Maven-депа.
|
||||||
- Только Maven (никакого Gradle/Ant); новые зависимости — latest stable, версии только в корневой `dependencyManagement`.
|
- Только Maven (никакого Gradle/Ant); новые зависимости — latest stable, версии только в корневой `dependencyManagement`.
|
||||||
- CI, линтеров, форматтеров, checkstyle — нет; проверка одна: `mvn clean verify`.
|
- CI, линтеров, форматтеров, checkstyle — нет; проверка одна: `mvn clean verify`.
|
||||||
- Fat-jar проверять только `java -jar` (тесты идут по classpath и shade-проблем не видят).
|
- Исполняемый jar бэкенда проверять только `java -jar` (тесты идут по classpath и repackage-специфику не видят).
|
||||||
|
|
||||||
## Testing & QA
|
## Testing & QA
|
||||||
|
|
||||||
- JUnit 5, surefire c `-Djava.awt.headless=true`; только `Assertions` (без Mockito/AssertJ), package-private тесты в mirror-пакетах.
|
- JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire c `-Djava.awt.headless=true`; только `Assertions` (без Mockito/AssertJ, несмотря на test-классpath Boot), package-private тесты в mirror-пакетах.
|
||||||
- **PDF сравнивается текстом, не растеризацией**: PDFBox `PDFTextStripper` для текста, override `processTextPosition` для шрифта конкретного символа (`fontNameOf`), обход ресурсов страницы для встроенных шрифтов (`EAAAAA+Carlito-Bold`) и счётчика картинок. Негативные маркеры — регрессии: `assertFalse(text.contains("#"))` (.notdef), `assertFalse(font.startsWith("Helvetica"))`. Пиксели — только в unit-тестах chart-пейнтеров (там сам код — Java2D); допуски 6–10%.
|
- **PDF сравнивается текстом, не растеризацией**: PDFBox `PDFTextStripper` для текста, override `processTextPosition` для шрифта конкретного символа (`fontNameOf`), обход ресурсов страницы для встроенных шрифтов (`EAAAAA+Carlito-Bold`) и счётчика картинок. Негативные маркеры — регрессии: `assertFalse(text.contains("#"))` (.notdef), `assertFalse(font.startsWith("Helvetica"))`. Пиксели — только в unit-тестах chart-пейнтеров (там сам код — Java2D); допуски 6–10%.
|
||||||
- Текст нормализуется по пробелам (`tableImage_tableAndImage` — полное удаление пробелов: docx4j переносит слова в auto-fit таблицах).
|
- Текст нормализуется по пробелам (`tableImage_tableAndImage` — полное удаление пробелов: docx4j переносит слова в auto-fit таблицах).
|
||||||
- Фикстуры — закоммиченные `samples/*.docx` (не генерировать в тестах); classpath → временный файл (`extractSample`/`extractToTemp`). In-memory docx — `ZipOutputStream` из литеральных XML или POI в `byte[]` (`WordPdfValidatorTest`).
|
- Фикстуры — закоммиченные `samples/*.docx` (не генерировать в тестах); classpath → временный файл (`extractSample`/`extractToTemp`). In-memory docx — `ZipOutputStream` из литеральных XML или POI в `byte[]` (`WordPdfValidatorTest`).
|
||||||
- Юниты нормализаторов работают строками (`rewrite`) и проверяют контракт «нечего менять → null / тот же массив» и неприкосновенность `[Content_Types].xml`.
|
- Юниты нормализаторов работают строками (`rewrite`) и проверяют контракт «нечего менять → null / тот же массив» и неприкосновенность `[Content_Types].xml`.
|
||||||
- Тесты `wordpdf-cli` берут фикстуры из test-jar core (classifier `tests`) → `-pl wordpdf-cli` без `-am` не соберётся; проверять коды возврата `WordPdfCli.run`.
|
- Тесты `wordpdf-app` (`ConvertControllerTest`, MockMvc) берут фикстуры из test-jar core (classifier `tests`) → `-pl wordpdf-app` без `-am` не соберётся. Гейт SPA — `npm run build` (tsc -b); UI-тестов нет.
|
||||||
- Каждый фикс бага docx4j/FOP сопровождается: байтовый нормализатор/pre-renderer + регрессионный тест с фикстурой + javadoc-ссылка. Проверенные пары: `DocxOnOffNormalizerTest`/`ruPlain_regularRunsUseRegularFont`, `FieldNormalizerTest`/`pageNumbers_recomputedNotCached`, `SymbolFontNormalizerTest`/`symbolFonts_bulletsAreNotHash`, `GlyphCoverageNormalizerTest`/`exoticGlyphs_drawnNotHash`, `WordPdfValidatorTest`/`staleCachePageCountRejectedBeforeRender`, `BundledFontsTest`/`noLoggingWarningInPdf`, `Surface3dPainterTest`/`chartsSmartArt_drawingsBecomeImages`.
|
- Каждый фикс бага docx4j/FOP сопровождается: байтовый нормализатор/pre-renderer + регрессионный тест с фикстурой + javadoc-ссылка. Проверенные пары: `DocxOnOffNormalizerTest`/`ruPlain_regularRunsUseRegularFont`, `FieldNormalizerTest`/`pageNumbers_recomputedNotCached`, `SymbolFontNormalizerTest`/`symbolFonts_bulletsAreNotHash`, `GlyphCoverageNormalizerTest`/`exoticGlyphs_drawnNotHash`, `WordPdfValidatorTest`/`staleCachePageCountRejectedBeforeRender`, `BundledFontsTest`/`noLoggingWarningInPdf`, `Surface3dPainterTest`/`chartsSmartArt_drawingsBecomeImages`.
|
||||||
|
|||||||
+26
@@ -0,0 +1,26 @@
|
|||||||
|
FROM maven:3.9-eclipse-temurin-21 AS build
|
||||||
|
WORKDIR /build
|
||||||
|
COPY pom.xml .
|
||||||
|
COPY wordpdf-core/pom.xml wordpdf-core/
|
||||||
|
COPY wordpdf-app/pom.xml wordpdf-app/
|
||||||
|
RUN mvn -B -q dependency:go-offline
|
||||||
|
COPY . .
|
||||||
|
RUN mvn -B -q -DskipTests package
|
||||||
|
|
||||||
|
FROM eclipse-temurin:21-jre
|
||||||
|
# curl — только для HEALTHCHECK; runtime полный jre (не alpine-slim): Java2D
|
||||||
|
# chart-движка нужны AWT и fontconfig-нативки; бандл-шрифты лежат в jar,
|
||||||
|
# системные шрифты не нужны. Тесты в образе не гоняем — гейт mvn clean verify.
|
||||||
|
# Прокси из docker-config подмешивается в HEALTHCHECK-шелл и ломает curl
|
||||||
|
# (127.0.0.1:proxy внутри контейнера недоступен) — обнуляем на команде.
|
||||||
|
RUN apt-get update \
|
||||||
|
&& apt-get install -y --no-install-recommends curl \
|
||||||
|
&& rm -rf /var/lib/apt/lists/* \
|
||||||
|
&& useradd -r -u 10001 app
|
||||||
|
WORKDIR /app
|
||||||
|
COPY --from=build /build/wordpdf-app/target/wordpdf-app-1.0.0.jar app.jar
|
||||||
|
USER app
|
||||||
|
EXPOSE 8080
|
||||||
|
HEALTHCHECK --interval=10s --timeout=3s --start-period=45s --retries=5 \
|
||||||
|
CMD HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= curl -fsS http://127.0.0.1:8080/v3/api-docs >/dev/null || exit 1
|
||||||
|
ENTRYPOINT ["java", "-Djava.awt.headless=true", "-jar", "/app/app.jar"]
|
||||||
@@ -11,14 +11,16 @@ LibreOffice/Aspose. Шрифты упакованы в jar — конверта
|
|||||||
в docx4j/FOP.
|
в docx4j/FOP.
|
||||||
- Частые MS-шрифты подменяются метрически совместимыми open-source аналогами
|
- Частые MS-шрифты подменяются метрически совместимыми open-source аналогами
|
||||||
(см. «Шрифты» ниже).
|
(см. «Шрифты» ниже).
|
||||||
- Клиентская библиотека (`wordpdf-core`) и CLI (`wordpdf-cli`, fat-jar).
|
- Клиентская библиотека (`wordpdf-core`), REST API (`wordpdf-app`, Spring Boot)
|
||||||
|
и веб-интерфейс (`wordpdf-web`, React SPA).
|
||||||
|
|
||||||
## Структура
|
## Структура
|
||||||
|
|
||||||
```
|
```
|
||||||
java-word-pdf/
|
java-word-pdf/
|
||||||
├── wordpdf-core/ библиотека: конвертер, шрифты, маппинг
|
├── wordpdf-core/ библиотека: конвертер, шрифты, маппинг
|
||||||
└── wordpdf-cli/ командная строка (fat-jar через maven-shade)
|
├── wordpdf-app/ REST API: POST /api/v1/convert (Spring Boot, Swagger UI)
|
||||||
|
└── wordpdf-web/ веб-интерфейс (React + TypeScript + Vite + Tailwind, вне Maven)
|
||||||
```
|
```
|
||||||
|
|
||||||
Ключевые классы (`wordpdf-core`):
|
Ключевые классы (`wordpdf-core`):
|
||||||
@@ -34,28 +36,39 @@ java-word-pdf/
|
|||||||
|
|
||||||
## Сборка
|
## Сборка
|
||||||
|
|
||||||
Требуется **Java 17** и **Maven**.
|
Требуется **Java 21** и **Maven** (бэкенд), **Node.js ≥ 20.19** (веб-интерфейс).
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
mvn clean verify # сборка всех модулей + тесты
|
mvn clean verify # все модули + тесты
|
||||||
mvn -pl wordpdf-cli package # только fat-jar CLI
|
mvn -pl wordpdf-app -am package # исполняемый jar бэкенда
|
||||||
```
|
```
|
||||||
|
|
||||||
Результат: `wordpdf-cli/target/wordpdf-cli-<версия>.jar` (fat-jar, все
|
Результат: `wordpdf-app/target/wordpdf-app-<версия>.jar` (все зависимости
|
||||||
зависимости внутри).
|
внутри). Для фронтенда — отдельный деп: `npm install && npm run build`
|
||||||
|
в `wordpdf-web/` (результат — статика в `wordpdf-web/dist/`).
|
||||||
|
|
||||||
## Использование
|
## Использование
|
||||||
|
|
||||||
### CLI
|
### REST API
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
java -jar wordpdf-cli-1.0.0.jar in.docx # рядом создаётся in.pdf
|
java -jar wordpdf-app/target/wordpdf-app-1.0.0.jar
|
||||||
java -jar wordpdf-cli-1.0.0.jar in.docx out.pdf # в указанный файл
|
curl -F "file=@doc.docx" http://localhost:8080/api/v1/convert -o doc.pdf
|
||||||
java -jar wordpdf-cli-1.0.0.jar a.docx b.docx # пакетно: каждый -> свой .pdf
|
|
||||||
```
|
```
|
||||||
|
|
||||||
Коды возврата: `0` — успех, `1` — ошибка использования, `2` — не удалось
|
`POST /api/v1/convert` принимает multipart-поле `file` (.docx) и синхронно
|
||||||
конвертировать хотя бы один файл.
|
возвращает байты PDF (`application/pdf`, attachment).
|
||||||
|
|
||||||
|
|Код|Смысл|
|
||||||
|
|---|---|
|
||||||
|
|200|PDF в теле ответа|
|
||||||
|
|400|некорректный вход: не .docx / пустой / не zip / > 5 МБ / > 100 страниц|
|
||||||
|
|413|тело запроса больше контейнерного лимита multipart (6 МБ)|
|
||||||
|
|503|очередь конвертации занята — повторить позже|
|
||||||
|
|504|конвертация дольше таймаута (`wordpdf.convert-timeout`, по умолчанию 2m)|
|
||||||
|
|
||||||
|
Ошибки — JSON `{"error": "..."}`. Интерактивная документация:
|
||||||
|
Swagger UI — `/swagger-ui.html`, OpenAPI — `/v3/api-docs`.
|
||||||
|
|
||||||
### Библиотека
|
### Библиотека
|
||||||
|
|
||||||
@@ -69,6 +82,20 @@ WordPdfConverter.convert(Path.of("doc.docx"), Path.of("out.pdf")); // явный
|
|||||||
|
|
||||||
Ошибки валидации (не `.docx`, файл не найден) бросают `ConversionException`.
|
Ошибки валидации (не `.docx`, файл не найден) бросают `ConversionException`.
|
||||||
|
|
||||||
|
### Веб-интерфейс и Docker
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker compose up -d --build
|
||||||
|
```
|
||||||
|
|
||||||
|
Всё на `http://localhost:8080/`: nginx-контейнер `web` раздаёт SPA и проксирует
|
||||||
|
`/api`, `/swagger-ui`, `/v3/api-docs` на бэкенд (контейнер `app` наружу не
|
||||||
|
публикуется).
|
||||||
|
|
||||||
|
Dev-режим без Docker: бэкенд `java -jar wordpdf-app/target/wordpdf-app-1.0.0.jar`
|
||||||
|
(порт 8080) + `npm run dev` в `wordpdf-web/` → `http://localhost:5173`
|
||||||
|
(Vite проксирует `/api` на 8080, CORS не нужен).
|
||||||
|
|
||||||
## Шрифты
|
## Шрифты
|
||||||
|
|
||||||
В `wordpdf-core/src/main/resources/fonts/` упакованы 30 TTF: 7 текстовых
|
В `wordpdf-core/src/main/resources/fonts/` упакованы 30 TTF: 7 текстовых
|
||||||
@@ -139,3 +166,6 @@ docx ──> нормализация байтов ──> docx4j (Wordprocessin
|
|||||||
Тесты используют готовые `.docx` из `wordpdf-core/src/test/resources/samples/`
|
Тесты используют готовые `.docx` из `wordpdf-core/src/test/resources/samples/`
|
||||||
(генерируются POI) и проверяют извлечённый PDFBox'ом текст и встраивание
|
(генерируются POI) и проверяют извлечённый PDFBox'ом текст и встраивание
|
||||||
шрифтов. Запуск: `mvn test`.
|
шрифтов. Запуск: `mvn test`.
|
||||||
|
|
||||||
|
API (`wordpdf-app`) проверяется `MockMvc`-сквозняками (`ConvertControllerTest`)
|
||||||
|
на тех же фикстурах — ядро отдаёт их test-jar'ом.
|
||||||
|
|||||||
@@ -0,0 +1,12 @@
|
|||||||
|
name: wordpdf
|
||||||
|
services:
|
||||||
|
app:
|
||||||
|
build: .
|
||||||
|
restart: unless-stopped
|
||||||
|
web:
|
||||||
|
build: ./wordpdf-web
|
||||||
|
ports: ["8080:80"]
|
||||||
|
depends_on:
|
||||||
|
app:
|
||||||
|
condition: service_healthy
|
||||||
|
restart: unless-stopped
|
||||||
@@ -14,32 +14,49 @@
|
|||||||
|
|
||||||
<modules>
|
<modules>
|
||||||
<module>wordpdf-core</module>
|
<module>wordpdf-core</module>
|
||||||
<module>wordpdf-cli</module>
|
<module>wordpdf-app</module>
|
||||||
</modules>
|
</modules>
|
||||||
|
|
||||||
<properties>
|
<properties>
|
||||||
<maven.compiler.source>17</maven.compiler.source>
|
<maven.compiler.release>21</maven.compiler.release>
|
||||||
<maven.compiler.target>17</maven.compiler.target>
|
|
||||||
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
|
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
|
||||||
|
|
||||||
<!-- docx4j: последняя стабильная версия на Maven Central -->
|
<!-- docx4j: последняя стабильная версия на Maven Central -->
|
||||||
<docx4j.version>17.3.0</docx4j.version>
|
<docx4j.version>17.3.2</docx4j.version>
|
||||||
<slf4j.version>2.0.17</slf4j.version>
|
<slf4j.version>2.0.20</slf4j.version>
|
||||||
|
|
||||||
|
<!-- Spring Boot + springdoc: последние стабильные на Maven Central -->
|
||||||
|
<spring-boot.version>4.1.1</spring-boot.version>
|
||||||
|
<springdoc.version>3.1.1</springdoc.version>
|
||||||
|
|
||||||
<!-- Тесты -->
|
<!-- Тесты -->
|
||||||
<junit.version>5.12.2</junit.version>
|
<junit.version>6.1.3</junit.version>
|
||||||
<pdfbox.version>3.0.7</pdfbox.version>
|
<pdfbox.version>3.0.8</pdfbox.version>
|
||||||
<poi.version>5.5.1</poi.version>
|
<poi.version>5.5.1</poi.version>
|
||||||
</properties>
|
</properties>
|
||||||
|
|
||||||
<dependencyManagement>
|
<dependencyManagement>
|
||||||
<dependencies>
|
<dependencies>
|
||||||
|
<!-- BOM Spring Boot: версии web-стека; прямые записи ниже имеют приоритет -->
|
||||||
|
<dependency>
|
||||||
|
<groupId>org.springframework.boot</groupId>
|
||||||
|
<artifactId>spring-boot-dependencies</artifactId>
|
||||||
|
<version>${spring-boot.version}</version>
|
||||||
|
<type>pom</type>
|
||||||
|
<scope>import</scope>
|
||||||
|
</dependency>
|
||||||
|
<!-- Swagger UI (/swagger-ui.html) + OpenAPI (/v3/api-docs); в Boot-BOM нет -->
|
||||||
|
<dependency>
|
||||||
|
<groupId>org.springdoc</groupId>
|
||||||
|
<artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
|
||||||
|
<version>${springdoc.version}</version>
|
||||||
|
</dependency>
|
||||||
<dependency>
|
<dependency>
|
||||||
<groupId>org.docx4j</groupId>
|
<groupId>org.docx4j</groupId>
|
||||||
<artifactId>docx4j-core</artifactId>
|
<artifactId>docx4j-core</artifactId>
|
||||||
<version>${docx4j.version}</version>
|
<version>${docx4j.version}</version>
|
||||||
</dependency>
|
</dependency>
|
||||||
<!-- Реализация JAXB (Java 17, без javax-пакетов) -->
|
<!-- Реализация JAXB (без javax-пакетов) -->
|
||||||
<dependency>
|
<dependency>
|
||||||
<groupId>org.docx4j</groupId>
|
<groupId>org.docx4j</groupId>
|
||||||
<artifactId>docx4j-JAXB-ReferenceImpl</artifactId>
|
<artifactId>docx4j-JAXB-ReferenceImpl</artifactId>
|
||||||
@@ -83,12 +100,12 @@
|
|||||||
<plugin>
|
<plugin>
|
||||||
<groupId>org.apache.maven.plugins</groupId>
|
<groupId>org.apache.maven.plugins</groupId>
|
||||||
<artifactId>maven-compiler-plugin</artifactId>
|
<artifactId>maven-compiler-plugin</artifactId>
|
||||||
<version>3.15.0</version>
|
<version>3.16.0</version>
|
||||||
</plugin>
|
</plugin>
|
||||||
<plugin>
|
<plugin>
|
||||||
<groupId>org.apache.maven.plugins</groupId>
|
<groupId>org.apache.maven.plugins</groupId>
|
||||||
<artifactId>maven-surefire-plugin</artifactId>
|
<artifactId>maven-surefire-plugin</artifactId>
|
||||||
<version>3.5.6</version>
|
<version>3.6.0</version>
|
||||||
<!-- docx4j/FOP не требуют дисплея -->
|
<!-- docx4j/FOP не требуют дисплея -->
|
||||||
<configuration>
|
<configuration>
|
||||||
<argLine>-Djava.awt.headless=true</argLine>
|
<argLine>-Djava.awt.headless=true</argLine>
|
||||||
@@ -97,12 +114,12 @@
|
|||||||
<plugin>
|
<plugin>
|
||||||
<groupId>org.apache.maven.plugins</groupId>
|
<groupId>org.apache.maven.plugins</groupId>
|
||||||
<artifactId>maven-jar-plugin</artifactId>
|
<artifactId>maven-jar-plugin</artifactId>
|
||||||
<version>3.4.2</version>
|
<version>3.5.1</version>
|
||||||
</plugin>
|
</plugin>
|
||||||
<plugin>
|
<plugin>
|
||||||
<groupId>org.apache.maven.plugins</groupId>
|
<groupId>org.springframework.boot</groupId>
|
||||||
<artifactId>maven-shade-plugin</artifactId>
|
<artifactId>spring-boot-maven-plugin</artifactId>
|
||||||
<version>3.6.2</version>
|
<version>${spring-boot.version}</version>
|
||||||
</plugin>
|
</plugin>
|
||||||
</plugins>
|
</plugins>
|
||||||
</pluginManagement>
|
</pluginManagement>
|
||||||
|
|||||||
@@ -0,0 +1,94 @@
|
|||||||
|
<?xml version="1.0" encoding="UTF-8"?>
|
||||||
|
<project xmlns="http://maven.apache.org/POM/4.0.0"
|
||||||
|
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||||
|
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
|
||||||
|
<modelVersion>4.0.0</modelVersion>
|
||||||
|
|
||||||
|
<parent>
|
||||||
|
<groupId>ru.pjandro</groupId>
|
||||||
|
<artifactId>java-word-pdf</artifactId>
|
||||||
|
<version>1.0.0</version>
|
||||||
|
</parent>
|
||||||
|
|
||||||
|
<artifactId>wordpdf-app</artifactId>
|
||||||
|
<name>wordpdf-app</name>
|
||||||
|
<description>REST API поверх wordpdf-core: POST /api/v1/convert (Spring Boot, Swagger UI)</description>
|
||||||
|
|
||||||
|
<dependencies>
|
||||||
|
<dependency>
|
||||||
|
<groupId>ru.pjandro</groupId>
|
||||||
|
<artifactId>wordpdf-core</artifactId>
|
||||||
|
<version>${project.version}</version>
|
||||||
|
<!-- slf4j-simple из ядра исключаем: с logback из Boot получилось бы
|
||||||
|
два SLF4J-провайдера и недетерминированный выбор; предупреждение
|
||||||
|
docx4j в PDF возникает только при полном отсутствии провайдеров,
|
||||||
|
logback его закрывает. -->
|
||||||
|
<exclusions>
|
||||||
|
<exclusion>
|
||||||
|
<groupId>org.slf4j</groupId>
|
||||||
|
<artifactId>slf4j-simple</artifactId>
|
||||||
|
</exclusion>
|
||||||
|
</exclusions>
|
||||||
|
</dependency>
|
||||||
|
<!-- Web MVC (в Boot 4 стартер переименован из spring-boot-starter-web) -->
|
||||||
|
<dependency>
|
||||||
|
<groupId>org.springframework.boot</groupId>
|
||||||
|
<artifactId>spring-boot-starter-webmvc</artifactId>
|
||||||
|
</dependency>
|
||||||
|
<!-- Swagger UI /swagger-ui.html + OpenAPI /v3/api-docs -->
|
||||||
|
<dependency>
|
||||||
|
<groupId>org.springdoc</groupId>
|
||||||
|
<artifactId>springdoc-openapi-starter-webmvc-ui</artifactId>
|
||||||
|
</dependency>
|
||||||
|
|
||||||
|
<!-- ============ Тесты ============ -->
|
||||||
|
<dependency>
|
||||||
|
<groupId>org.springframework.boot</groupId>
|
||||||
|
<artifactId>spring-boot-starter-test</artifactId>
|
||||||
|
<scope>test</scope>
|
||||||
|
</dependency>
|
||||||
|
<!-- MockMvc-автоконфигурация (@AutoConfigureMockMvc) в Boot 4 вынесена
|
||||||
|
из starter-test в отдельный модуль spring-boot-webmvc-test -->
|
||||||
|
<dependency>
|
||||||
|
<groupId>org.springframework.boot</groupId>
|
||||||
|
<artifactId>spring-boot-webmvc-test</artifactId>
|
||||||
|
<scope>test</scope>
|
||||||
|
</dependency>
|
||||||
|
<!-- Фикстуры samples/*.docx из ядра -->
|
||||||
|
<dependency>
|
||||||
|
<groupId>ru.pjandro</groupId>
|
||||||
|
<artifactId>wordpdf-core</artifactId>
|
||||||
|
<version>${project.version}</version>
|
||||||
|
<classifier>tests</classifier>
|
||||||
|
<type>test-jar</type>
|
||||||
|
<scope>test</scope>
|
||||||
|
</dependency>
|
||||||
|
<!-- Разбор ответного PDF в тестах -->
|
||||||
|
<dependency>
|
||||||
|
<groupId>org.apache.pdfbox</groupId>
|
||||||
|
<artifactId>pdfbox</artifactId>
|
||||||
|
<scope>test</scope>
|
||||||
|
</dependency>
|
||||||
|
</dependencies>
|
||||||
|
|
||||||
|
<build>
|
||||||
|
<plugins>
|
||||||
|
<!-- Исполняемый jar: repackage явно привязан к package (в 4.1.1
|
||||||
|
сам не связывается), main-класс определяется автоматически.
|
||||||
|
Вложенные jar'ы сохраняются раздельно — слияние
|
||||||
|
META-INF/services (как был нужен shade в CLI) здесь не требуется. -->
|
||||||
|
<plugin>
|
||||||
|
<groupId>org.springframework.boot</groupId>
|
||||||
|
<artifactId>spring-boot-maven-plugin</artifactId>
|
||||||
|
<executions>
|
||||||
|
<execution>
|
||||||
|
<id>repackage</id>
|
||||||
|
<goals>
|
||||||
|
<goal>repackage</goal>
|
||||||
|
</goals>
|
||||||
|
</execution>
|
||||||
|
</executions>
|
||||||
|
</plugin>
|
||||||
|
</plugins>
|
||||||
|
</build>
|
||||||
|
</project>
|
||||||
@@ -0,0 +1,82 @@
|
|||||||
|
package ru.pjandro.wordpdf.app;
|
||||||
|
|
||||||
|
import org.slf4j.Logger;
|
||||||
|
import org.slf4j.LoggerFactory;
|
||||||
|
import org.springframework.http.HttpStatus;
|
||||||
|
import org.springframework.http.ResponseEntity;
|
||||||
|
import org.springframework.web.bind.MissingServletRequestParameterException;
|
||||||
|
import org.springframework.web.bind.annotation.ExceptionHandler;
|
||||||
|
import org.springframework.web.bind.annotation.RestControllerAdvice;
|
||||||
|
import org.springframework.web.multipart.MaxUploadSizeExceededException;
|
||||||
|
import org.springframework.web.multipart.support.MissingServletRequestPartException;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Единый перевод исключений в JSON {@code {"error": "..."}} с кодом по смыслу.
|
||||||
|
*
|
||||||
|
* <p>Голый {@code ru.pjandro.wordpdf.ConversionException} ядра сюда не доходит:
|
||||||
|
* контроллер и {@link ConversionService} превращают его на границе в
|
||||||
|
* {@link ValidationException}/{@link ConversionFailedException}; случайная
|
||||||
|
* утечка попадёт в обработчик {@link Exception} (500).</p>
|
||||||
|
*/
|
||||||
|
@RestControllerAdvice
|
||||||
|
final class ApiExceptionHandler {
|
||||||
|
|
||||||
|
private static final Logger log = LoggerFactory.getLogger(ApiExceptionHandler.class);
|
||||||
|
|
||||||
|
/** Тело ответа ошибки; Jackson сериализует record как есть. */
|
||||||
|
record ApiError(String error) {
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Некорректный вход: пустой, не .docx, не zip, битый zip, > 5 MiB, > 100 страниц. */
|
||||||
|
@ExceptionHandler(ValidationException.class)
|
||||||
|
ResponseEntity<ApiError> validation(ValidationException e) {
|
||||||
|
return ResponseEntity.badRequest().body(new ApiError(e.getMessage()));
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Ошибка ядра/рендера при формально корректном входе. */
|
||||||
|
@ExceptionHandler(ConversionFailedException.class)
|
||||||
|
ResponseEntity<ApiError> conversionFailed(ConversionFailedException e) {
|
||||||
|
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
|
||||||
|
.body(new ApiError(e.getMessage()));
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Очередь конвертации занята/прерывание — повторить позже. */
|
||||||
|
@ExceptionHandler(ConversionRejectedException.class)
|
||||||
|
ResponseEntity<ApiError> rejected(ConversionRejectedException e) {
|
||||||
|
return ResponseEntity.status(HttpStatus.SERVICE_UNAVAILABLE)
|
||||||
|
.body(new ApiError(e.getMessage()));
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Конвертация дольше {@code wordpdf.convert-timeout}. */
|
||||||
|
@ExceptionHandler(ConversionTimeoutException.class)
|
||||||
|
ResponseEntity<ApiError> timeout(ConversionTimeoutException e) {
|
||||||
|
return ResponseEntity.status(HttpStatus.GATEWAY_TIMEOUT)
|
||||||
|
.body(new ApiError(e.getMessage()));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Контейнерный лимит multipart (6 МБ в application.properties) сработал
|
||||||
|
* раньше ядра: текст свой, смысл тот же, что у 400 от {@code WordPdfValidator}.
|
||||||
|
*/
|
||||||
|
@ExceptionHandler(MaxUploadSizeExceededException.class)
|
||||||
|
ResponseEntity<ApiError> tooLarge(MaxUploadSizeExceededException e) {
|
||||||
|
return ResponseEntity.status(HttpStatus.PAYLOAD_TOO_LARGE)
|
||||||
|
.body(new ApiError("Файл больше 5 МБ"));
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Партита {@code file} нет в запросе — обе формы исключения возможны. */
|
||||||
|
@ExceptionHandler({MissingServletRequestPartException.class,
|
||||||
|
MissingServletRequestParameterException.class})
|
||||||
|
ResponseEntity<ApiError> missingFile(Exception e) {
|
||||||
|
return ResponseEntity.badRequest()
|
||||||
|
.body(new ApiError("Файл не передан (multipart-поле «file» обязательно)"));
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Прочее — внутренняя ошибка; подробность только в лог, не в ответ. */
|
||||||
|
@ExceptionHandler(Exception.class)
|
||||||
|
ResponseEntity<ApiError> unexpected(Exception e) {
|
||||||
|
log.error("Необработанное исключение в API", e);
|
||||||
|
return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
|
||||||
|
.body(new ApiError("Внутренняя ошибка конвертации"));
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,21 @@
|
|||||||
|
package ru.pjandro.wordpdf.app;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Ошибка преобразования: контейнер .docx принят валидацией, но упал сам
|
||||||
|
* рендер (ядро, FOP, повреждённое содержимое внутри валидного zip).
|
||||||
|
*
|
||||||
|
* <p>Смысл отличается от {@link ValidationException}: вход формально корректен,
|
||||||
|
* отказал движок конвертации. Маппится в HTTP 500 ({@link ApiExceptionHandler}).</p>
|
||||||
|
*
|
||||||
|
* <p>Регрессия — ConvertControllerTest#junkInsideValidZip_conversionError.</p>
|
||||||
|
*/
|
||||||
|
class ConversionFailedException extends RuntimeException {
|
||||||
|
|
||||||
|
ConversionFailedException(String message, Throwable cause) {
|
||||||
|
super(message, cause);
|
||||||
|
}
|
||||||
|
|
||||||
|
ConversionFailedException(Throwable cause) {
|
||||||
|
super("Внутренняя ошибка конвертации", cause);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,15 @@
|
|||||||
|
package ru.pjandro.wordpdf.app;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Очередь конвертации переполнена ({@code ConversionService.QUEUE_CAPACITY})
|
||||||
|
* либо поток ожидания был прерван — сервис временно не может принять задачу.
|
||||||
|
*
|
||||||
|
* <p>Маппится в HTTP 503 ({@link ApiExceptionHandler}); клиенту осмысленно
|
||||||
|
* повторить тот же запрос позже.</p>
|
||||||
|
*/
|
||||||
|
class ConversionRejectedException extends RuntimeException {
|
||||||
|
|
||||||
|
ConversionRejectedException() {
|
||||||
|
super("Сервис конвертации занят — повторите позже");
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,204 @@
|
|||||||
|
package ru.pjandro.wordpdf.app;
|
||||||
|
|
||||||
|
import jakarta.annotation.PreDestroy;
|
||||||
|
import org.springframework.beans.factory.annotation.Value;
|
||||||
|
import org.springframework.stereotype.Service;
|
||||||
|
import ru.pjandro.wordpdf.ConversionException;
|
||||||
|
import ru.pjandro.wordpdf.WordPdfConverter;
|
||||||
|
import ru.pjandro.wordpdf.WordPdfValidator;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.nio.file.Files;
|
||||||
|
import java.nio.file.Path;
|
||||||
|
import java.time.Duration;
|
||||||
|
import java.util.Locale;
|
||||||
|
import java.util.concurrent.ArrayBlockingQueue;
|
||||||
|
import java.util.concurrent.ExecutionException;
|
||||||
|
import java.util.concurrent.Future;
|
||||||
|
import java.util.concurrent.RejectedExecutionException;
|
||||||
|
import java.util.concurrent.ThreadPoolExecutor;
|
||||||
|
import java.util.concurrent.TimeUnit;
|
||||||
|
import java.util.concurrent.TimeoutException;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Конвертация .docx-байтов в PDF-байты поверх {@code wordpdf-core}.
|
||||||
|
*
|
||||||
|
* <p>Конвертации СЕРИАЛИЗОВАНЫ однопоточным executor'ом — не «на всякий
|
||||||
|
* случай»: каждая конвертация мутирует ГЛОБАЛЬНЫЙ реестр шрифтов docx4j
|
||||||
|
* ({@code new BundledFontMapper()} заново добавляет системные шрифты
|
||||||
|
* в {@code PhysicalFonts}, {@code BundledFonts.init()/restrictToBundled()}
|
||||||
|
* их вычищают — WordPdfConverter.java:125-130). Параллельные конвертации
|
||||||
|
* вырывают реестр друг у друга из-под рендера, ядро не потокобезопасно
|
||||||
|
* by design. Регрессия — ConvertControllerTest#concurrentRequests_bothSucceed.</p>
|
||||||
|
*
|
||||||
|
* <p>Ошибки разделены по смыслу (требование к API): некорректный вход →
|
||||||
|
* {@link ValidationException} (400), ошибка рендер-стадии →
|
||||||
|
* {@link ConversionFailedException} (500). Граница: сломанный контейнер
|
||||||
|
* (не zip / битый zip / слишком большой / слишком длинный) — 400; валидный
|
||||||
|
* zip с мусором внутри (нет {@code word/document.xml}) — 500: lightweight-
|
||||||
|
* подсчёт страниц согласован с JAXB-путём ядра (может только завышать),
|
||||||
|
* поэтому уже принятый запрос внутренняя проверка ядра в ошибку не превратит.</p>
|
||||||
|
*/
|
||||||
|
@Service
|
||||||
|
final class ConversionService {
|
||||||
|
|
||||||
|
/** Сколько запросов ждут свободный воркер, прежде чем получить 503. */
|
||||||
|
static final int QUEUE_CAPACITY = 16;
|
||||||
|
|
||||||
|
private final ThreadPoolExecutor workers;
|
||||||
|
private final Duration timeout;
|
||||||
|
|
||||||
|
ConversionService(@Value("${wordpdf.convert-timeout:2m}") Duration timeout) {
|
||||||
|
this.timeout = timeout;
|
||||||
|
this.workers = new ThreadPoolExecutor(1, 1, 0L, TimeUnit.MILLISECONDS,
|
||||||
|
new ArrayBlockingQueue<>(QUEUE_CAPACITY));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Полный путь: синхронная валидация байтов (до очереди — от obvious-отказа
|
||||||
|
* единый воркер не должен быть занят) → постановка в очередь → ожидание
|
||||||
|
* результата с таймаутом.
|
||||||
|
*
|
||||||
|
* @throws ValidationException некорректный вход (400)
|
||||||
|
* @throws ConversionFailedException ошибка ядра/рендера (500)
|
||||||
|
* @throws ConversionRejectedException очередь полна / прерывание (503)
|
||||||
|
* @throws ConversionTimeoutException конвертация дольше {@code wordpdf.convert-timeout} (504)
|
||||||
|
*/
|
||||||
|
byte[] convert(byte[] docxBytes, String originalFilename) {
|
||||||
|
validate(docxBytes);
|
||||||
|
Future<byte[]> future;
|
||||||
|
try {
|
||||||
|
future = workers.submit(() -> doConvert(docxBytes, originalFilename));
|
||||||
|
} catch (RejectedExecutionException e) {
|
||||||
|
throw new ConversionRejectedException();
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
return future.get(timeout.toMillis(), TimeUnit.MILLISECONDS);
|
||||||
|
} catch (TimeoutException e) {
|
||||||
|
// cancel(true) не гарантирует мгновенной остановки FOP-рендера:
|
||||||
|
// воркер может ещё поработать на отменённой задаче. Принято
|
||||||
|
// осознанно — защита от зависания важнее точности отмены.
|
||||||
|
future.cancel(true);
|
||||||
|
throw new ConversionTimeoutException(timeout);
|
||||||
|
} catch (InterruptedException e) {
|
||||||
|
Thread.currentThread().interrupt();
|
||||||
|
future.cancel(true);
|
||||||
|
throw new ConversionRejectedException();
|
||||||
|
} catch (ExecutionException e) {
|
||||||
|
Throwable cause = e.getCause();
|
||||||
|
if (cause instanceof ValidationException ve) {
|
||||||
|
throw ve;
|
||||||
|
}
|
||||||
|
if (cause instanceof ConversionFailedException cfe) {
|
||||||
|
throw cfe;
|
||||||
|
}
|
||||||
|
if (cause instanceof ConversionRejectedException cre) {
|
||||||
|
throw cre;
|
||||||
|
}
|
||||||
|
if (cause instanceof ConversionTimeoutException cte) {
|
||||||
|
throw cte;
|
||||||
|
}
|
||||||
|
// любой прочий выход из воркера (в т.ч. не завёрнутый
|
||||||
|
// ConversionException ядра) — внутренняя ошибка, 500
|
||||||
|
throw new ConversionFailedException(e);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Валидация байтов переиспользует публичные byte-API ядра. Порядок значим:
|
||||||
|
* размер (дешёвая) → magic bytes → lightweight-разбор zip.
|
||||||
|
*
|
||||||
|
* <p>Проверка zip-подписи отдельным шагом обязательна:
|
||||||
|
* {@code ZipInputStream.getNextEntry()} на не-zip-потоке возвращает
|
||||||
|
* {@code null} молча, и {@link WordPdfValidator#checkPageCountLightweight(byte[])}
|
||||||
|
* такой вход не отверг бы (0 страниц). Регрессия —
|
||||||
|
* ConvertControllerTest#corruptNotAZip_rejected.</p>
|
||||||
|
*/
|
||||||
|
void validate(byte[] docxBytes) {
|
||||||
|
try {
|
||||||
|
WordPdfValidator.checkInput(docxBytes);
|
||||||
|
} catch (ConversionException e) {
|
||||||
|
throw new ValidationException(e.getMessage(), e);
|
||||||
|
}
|
||||||
|
if (docxBytes.length < 4 || docxBytes[0] != 'P' || docxBytes[1] != 'K'
|
||||||
|
|| (docxBytes[2] & 0xFF) != 0x03 || (docxBytes[3] & 0xFF) != 0x04) {
|
||||||
|
throw new ValidationException("Содержимое не похоже на .docx (не zip-архив)");
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
WordPdfValidator.checkPageCountLightweight(docxBytes);
|
||||||
|
} catch (ConversionException e) {
|
||||||
|
throw new ValidationException(e.getMessage(), e);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Тело задачи воркера. Байтового API в ядре нет ({@code convertToStream}
|
||||||
|
* private и принимает {@code Path}), поэтому временные файлы; имя docx
|
||||||
|
* влияет на заголовок PDF (ядро берёт baseName файла), потому санитизировано.
|
||||||
|
*/
|
||||||
|
private static byte[] doConvert(byte[] docxBytes, String originalFilename) {
|
||||||
|
Path dir = null;
|
||||||
|
Path in = null;
|
||||||
|
Path out = null;
|
||||||
|
try {
|
||||||
|
dir = Files.createTempDirectory("wordpdf-");
|
||||||
|
String docxName = safeDocxName(originalFilename);
|
||||||
|
in = dir.resolve(docxName);
|
||||||
|
out = dir.resolve(safeBaseName(originalFilename) + ".pdf");
|
||||||
|
Files.write(in, docxBytes);
|
||||||
|
WordPdfConverter.convert(in, out);
|
||||||
|
return Files.readAllBytes(out);
|
||||||
|
} catch (ConversionException e) {
|
||||||
|
// всё, что упало на рендер-стадии, — ошибка преобразования, 500
|
||||||
|
throw new ConversionFailedException("Не удалось конвертировать документ: "
|
||||||
|
+ e.getMessage(), e);
|
||||||
|
} catch (IOException e) {
|
||||||
|
throw new ConversionFailedException(e);
|
||||||
|
} finally {
|
||||||
|
deleteQuietly(out);
|
||||||
|
deleteQuietly(in);
|
||||||
|
deleteQuietly(dir);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Имя docx для временного файла: чистый base + обязательный суффикс .docx. */
|
||||||
|
static String safeDocxName(String original) {
|
||||||
|
return safeBaseName(original) + ".docx";
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Санитизация имени (единый источник для имени файла и Content-Disposition):
|
||||||
|
* без каталога, только буквы/цифры/пробел/ {@code . _ -}, без суффикса
|
||||||
|
* .docx; пустое после очистки → {@code document}. Кириллица разрешена —
|
||||||
|
* на Linux это валидное имя файла, и заголовок PDF остаётся читаемым.
|
||||||
|
*/
|
||||||
|
static String safeBaseName(String original) {
|
||||||
|
String base = original == null ? ""
|
||||||
|
: original.substring(Math.max(original.lastIndexOf('/'),
|
||||||
|
original.lastIndexOf('\\')) + 1);
|
||||||
|
base = base.replaceAll("[^\\p{L}\\p{N} ._-]", "");
|
||||||
|
if (base.toLowerCase(Locale.ROOT).endsWith(".docx")) {
|
||||||
|
base = base.substring(0, base.length() - ".docx".length());
|
||||||
|
}
|
||||||
|
if (base.isBlank()) {
|
||||||
|
base = "document";
|
||||||
|
}
|
||||||
|
return base.strip();
|
||||||
|
}
|
||||||
|
|
||||||
|
private static void deleteQuietly(Path p) {
|
||||||
|
if (p == null) {
|
||||||
|
return;
|
||||||
|
}
|
||||||
|
try {
|
||||||
|
Files.deleteIfExists(p);
|
||||||
|
} catch (IOException ignored) {
|
||||||
|
// вторичная ошибка очистки не должна затенять основной результат
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@PreDestroy
|
||||||
|
void shutdown() {
|
||||||
|
workers.shutdownNow();
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,18 @@
|
|||||||
|
package ru.pjandro.wordpdf.app;
|
||||||
|
|
||||||
|
import java.time.Duration;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Конвертация не завершилась за {@code wordpdf.convert-timeout}.
|
||||||
|
*
|
||||||
|
* <p>Маппится в HTTP 504 ({@link ApiExceptionHandler}). Отмена задачи
|
||||||
|
* не гарантирует мгновенной остановки FOP-рендера — воркер может ещё
|
||||||
|
* недолго поработать на отменённой задаче (осознанный компромисс,
|
||||||
|
* см. {@link ConversionService}).</p>
|
||||||
|
*/
|
||||||
|
class ConversionTimeoutException extends RuntimeException {
|
||||||
|
|
||||||
|
ConversionTimeoutException(Duration timeout) {
|
||||||
|
super("Конвертация превысила " + timeout.toSeconds() + " с — документ слишком сложный");
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,64 @@
|
|||||||
|
package ru.pjandro.wordpdf.app;
|
||||||
|
|
||||||
|
import io.swagger.v3.oas.annotations.Operation;
|
||||||
|
import org.springframework.http.ContentDisposition;
|
||||||
|
import org.springframework.http.HttpHeaders;
|
||||||
|
import org.springframework.http.MediaType;
|
||||||
|
import org.springframework.http.ResponseEntity;
|
||||||
|
import org.springframework.web.bind.annotation.PostMapping;
|
||||||
|
import org.springframework.web.bind.annotation.RequestParam;
|
||||||
|
import org.springframework.web.bind.annotation.RestController;
|
||||||
|
import org.springframework.web.multipart.MultipartFile;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.nio.charset.StandardCharsets;
|
||||||
|
import java.util.Locale;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Единственный эндпоинт API: {@code POST /api/v1/convert} — multipart-поле
|
||||||
|
* {@code file} (.docx) → синхронный ответ байтами PDF.
|
||||||
|
*
|
||||||
|
* <p>Здесь только HTTP-слой: проверка presence/расширения и формирование
|
||||||
|
* {@code Content-Disposition}; проверка содержимого (zip, размер, страницы) —
|
||||||
|
* зона {@link ConversionService#validate}. Ошибки в JSON-ответ переводит
|
||||||
|
* {@link ApiExceptionHandler}.</p>
|
||||||
|
*/
|
||||||
|
@RestController
|
||||||
|
final class ConvertController {
|
||||||
|
|
||||||
|
private final ConversionService conversionService;
|
||||||
|
|
||||||
|
ConvertController(ConversionService conversionService) {
|
||||||
|
this.conversionService = conversionService;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Operation(summary = "Конвертировать .docx в PDF")
|
||||||
|
@PostMapping(
|
||||||
|
path = "/api/v1/convert",
|
||||||
|
consumes = MediaType.MULTIPART_FORM_DATA_VALUE,
|
||||||
|
produces = MediaType.APPLICATION_PDF_VALUE)
|
||||||
|
ResponseEntity<byte[]> convert(@RequestParam("file") MultipartFile file) {
|
||||||
|
if (file == null || file.isEmpty()) {
|
||||||
|
throw new ValidationException("Файл не передан (multipart-поле «file» обязательно)");
|
||||||
|
}
|
||||||
|
String name = file.getOriginalFilename();
|
||||||
|
if (name == null || !name.toLowerCase(Locale.ROOT).endsWith(".docx")) {
|
||||||
|
// та же формулировка, что у WordPdfValidator.checkInput(Path)
|
||||||
|
throw new ValidationException("Поддерживается только .docx (без .doc): " + name);
|
||||||
|
}
|
||||||
|
byte[] docxBytes;
|
||||||
|
try {
|
||||||
|
docxBytes = file.getBytes();
|
||||||
|
} catch (IOException e) {
|
||||||
|
throw new ValidationException("Не удалось прочитать загруженный файл", e);
|
||||||
|
}
|
||||||
|
byte[] pdf = conversionService.convert(docxBytes, name);
|
||||||
|
ContentDisposition disposition = ContentDisposition.attachment()
|
||||||
|
.filename(ConversionService.safeBaseName(name) + ".pdf", StandardCharsets.UTF_8)
|
||||||
|
.build();
|
||||||
|
return ResponseEntity.ok()
|
||||||
|
.contentType(MediaType.APPLICATION_PDF)
|
||||||
|
.header(HttpHeaders.CONTENT_DISPOSITION, disposition.toString())
|
||||||
|
.body(pdf);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,23 @@
|
|||||||
|
package ru.pjandro.wordpdf.app;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Некорректный вход: пустой файл, не .docx, не zip-архив, размер больше
|
||||||
|
* {@code WordPdfValidator.MAX_INPUT_BYTES}, страниц больше ста.
|
||||||
|
*
|
||||||
|
* <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);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,20 @@
|
|||||||
|
package ru.pjandro.wordpdf.app;
|
||||||
|
|
||||||
|
import org.springframework.boot.SpringApplication;
|
||||||
|
import org.springframework.boot.autoconfigure.SpringBootApplication;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Точка входа REST-приложения: HTTP API конвертации .docx → PDF поверх
|
||||||
|
* {@code wordpdf-core}.
|
||||||
|
*
|
||||||
|
* <p>Единственное место в приложении, где класс не «final + только static»:
|
||||||
|
* Spring-компоненты по определению экземпляры (как {@code BundledFontMapper}
|
||||||
|
* в ядре).</p>
|
||||||
|
*/
|
||||||
|
@SpringBootApplication
|
||||||
|
public final class WordPdfApplication {
|
||||||
|
|
||||||
|
public static void main(String[] args) {
|
||||||
|
SpringApplication.run(WordPdfApplication.class, args);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,10 @@
|
|||||||
|
spring.application.name=wordpdf-app
|
||||||
|
# 6MB, а не 5MB: авторитетный лимит — ядро (WordPdfValidator.MAX_INPUT_BYTES
|
||||||
|
# = 5 MiB = 5 242 880 Б). С multipart-лимитом «5MB» (5 000 000 Б) файлы
|
||||||
|
# 5.0–5.24 МБ отбивались бы контейнером с неверным текстом ошибки раньше ядра.
|
||||||
|
# file-size-threshold=6MB держит файл в памяти (ядро и так читает всё в RAM).
|
||||||
|
spring.servlet.multipart.max-file-size=6MB
|
||||||
|
spring.servlet.multipart.max-request-size=6MB
|
||||||
|
spring.servlet.multipart.file-size-threshold=6MB
|
||||||
|
# Таймаут одной конвертации (binding Duration в ConversionService)
|
||||||
|
wordpdf.convert-timeout=2m
|
||||||
@@ -0,0 +1,224 @@
|
|||||||
|
package ru.pjandro.wordpdf.app;
|
||||||
|
|
||||||
|
import org.apache.pdfbox.Loader;
|
||||||
|
import org.apache.pdfbox.pdmodel.PDDocument;
|
||||||
|
import org.apache.pdfbox.text.PDFTextStripper;
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
import org.springframework.beans.factory.annotation.Autowired;
|
||||||
|
import org.springframework.boot.webmvc.test.autoconfigure.AutoConfigureMockMvc;
|
||||||
|
import org.springframework.boot.test.context.SpringBootTest;
|
||||||
|
import org.springframework.http.HttpHeaders;
|
||||||
|
import org.springframework.http.MediaType;
|
||||||
|
import org.springframework.mock.web.MockMultipartFile;
|
||||||
|
import org.springframework.test.web.servlet.MockMvc;
|
||||||
|
import org.springframework.test.web.servlet.MvcResult;
|
||||||
|
|
||||||
|
import java.io.ByteArrayOutputStream;
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.io.InputStream;
|
||||||
|
import java.nio.charset.StandardCharsets;
|
||||||
|
import java.util.concurrent.CountDownLatch;
|
||||||
|
import java.util.concurrent.ExecutorService;
|
||||||
|
import java.util.concurrent.Executors;
|
||||||
|
import java.util.concurrent.Future;
|
||||||
|
import java.util.zip.ZipEntry;
|
||||||
|
import java.util.zip.ZipOutputStream;
|
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertNotNull;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertTrue;
|
||||||
|
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.multipart;
|
||||||
|
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.content;
|
||||||
|
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.header;
|
||||||
|
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
|
||||||
|
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Сквозные тесты HTTP API (MockMvc): фикстуры — samples/*.docx из test-jar
|
||||||
|
* ядра, PDF разбирается PDFBox, текст нормализуется по пробелам — паттерны
|
||||||
|
* {@code WordPdfConverterTest} (norm/pdfText).
|
||||||
|
*/
|
||||||
|
@SpringBootTest
|
||||||
|
@AutoConfigureMockMvc
|
||||||
|
class ConvertControllerTest {
|
||||||
|
|
||||||
|
private static final MediaType DOCX =
|
||||||
|
MediaType.parseMediaType("application/vnd.openxmlformats-officedocument.wordprocessingml.document");
|
||||||
|
|
||||||
|
@Autowired
|
||||||
|
private MockMvc mockMvc;
|
||||||
|
|
||||||
|
/** Байты фикстуры из classpath (test-jar core: samples/…). */
|
||||||
|
private static byte[] bytes(String resource) throws IOException {
|
||||||
|
try (InputStream in = ConvertControllerTest.class.getResourceAsStream(resource)) {
|
||||||
|
assertNotNull(in, "Нет ресурса: " + resource);
|
||||||
|
return in.readAllBytes();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
private static MockMultipartFile docx(String filename, byte[] content) {
|
||||||
|
return new MockMultipartFile("file", filename, DOCX.toString(), content);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Нормализует пробельные (PDFTextStripper вставляет переносы). */
|
||||||
|
private static String norm(String s) {
|
||||||
|
return s.replaceAll("\\s+", " ");
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Извлекает весь текст из PDF-байтов (PDFBox, PDFTextStripper). */
|
||||||
|
private static String pdfText(byte[] pdf) throws IOException {
|
||||||
|
try (PDDocument doc = Loader.loadPDF(pdf)) {
|
||||||
|
return new PDFTextStripper().getText(doc);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Валидный zip с одной мусорной записью (не OPC-пакет). */
|
||||||
|
private static byte[] zipWithGarbage() throws IOException {
|
||||||
|
ByteArrayOutputStream bos = new ByteArrayOutputStream();
|
||||||
|
try (ZipOutputStream zout = new ZipOutputStream(bos)) {
|
||||||
|
zout.putNextEntry(new ZipEntry("garbage.txt"));
|
||||||
|
zout.write("это не документ".getBytes(StandardCharsets.UTF_8));
|
||||||
|
zout.closeEntry();
|
||||||
|
}
|
||||||
|
return bos.toByteArray();
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void convertSample_returnsPdf() throws Exception {
|
||||||
|
MvcResult result = mockMvc.perform(multipart("/api/v1/convert")
|
||||||
|
.file(docx("ru-plain.docx", bytes("/samples/ru-plain.docx"))))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(content().contentType(MediaType.APPLICATION_PDF))
|
||||||
|
.andExpect(header().string(HttpHeaders.CONTENT_DISPOSITION,
|
||||||
|
org.hamcrest.Matchers.containsString("filename*=UTF-8''ru-plain.pdf")))
|
||||||
|
.andReturn();
|
||||||
|
byte[] pdf = result.getResponse().getContentAsByteArray();
|
||||||
|
assertTrue(new String(pdf, 0, 4, StandardCharsets.US_ASCII).equals("%PDF"),
|
||||||
|
"тело не начинается с %PDF");
|
||||||
|
String text = norm(pdfText(pdf));
|
||||||
|
assertTrue(text.contains("Привет, мир!"), "нет «Привет, мир!»: " + text);
|
||||||
|
assertTrue(text.contains("абвгдеёжзийклмнопрстуфхцчшщъыьэюя"),
|
||||||
|
"нет алфавита: " + text);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void cyrillicAndPathInFilename_sanitizedResponseName() throws Exception {
|
||||||
|
byte[] sample = bytes("/samples/ru-plain.docx");
|
||||||
|
// имя «отчёт.pdf» в RFC 5987-кодировке
|
||||||
|
mockMvc.perform(multipart("/api/v1/convert").file(docx("отчёт.docx", sample)))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(header().string(HttpHeaders.CONTENT_DISPOSITION,
|
||||||
|
org.hamcrest.Matchers.containsString(
|
||||||
|
"filename*=UTF-8''%D0%BE%D1%82%D1%87%D1%91%D1%82.pdf")));
|
||||||
|
// «a/../../evil.docx»: каталог и «..» обязаны быть вырезаны
|
||||||
|
mockMvc.perform(multipart("/api/v1/convert").file(docx("a/../../evil.docx", sample)))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andExpect(result -> {
|
||||||
|
String cd = result.getResponse().getHeader(HttpHeaders.CONTENT_DISPOSITION);
|
||||||
|
assertNotNull(cd);
|
||||||
|
assertTrue(!cd.contains("/") && !cd.contains(".."),
|
||||||
|
"в Content-Disposition остались путь/«..»: " + cd);
|
||||||
|
assertTrue(cd.contains("evil.pdf"), "имя не сохранено: " + cd);
|
||||||
|
});
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void nonDocxFilename_rejected() throws Exception {
|
||||||
|
mockMvc.perform(multipart("/api/v1/convert")
|
||||||
|
.file(docx("notes.txt", bytes("/samples/ru-plain.docx"))))
|
||||||
|
.andExpect(status().isBadRequest())
|
||||||
|
.andExpect(jsonPath("$.error",
|
||||||
|
org.hamcrest.Matchers.containsString(".docx")));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void missingPart_rejected() throws Exception {
|
||||||
|
mockMvc.perform(multipart("/api/v1/convert"))
|
||||||
|
.andExpect(status().isBadRequest())
|
||||||
|
.andExpect(jsonPath("$.error",
|
||||||
|
org.hamcrest.Matchers.containsString("не передан")));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void emptyFile_rejected() throws Exception {
|
||||||
|
mockMvc.perform(multipart("/api/v1/convert")
|
||||||
|
.file(docx("a.docx", new byte[0])))
|
||||||
|
.andExpect(status().isBadRequest());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void oversizedOverCoreLimit_rejected() throws Exception {
|
||||||
|
// 5 MiB + 1 байт: проходит контейнерный multipart-лимит (6 MB)
|
||||||
|
// и отсекается валидацией ядра до очереди
|
||||||
|
byte[] big = new byte[5 * 1024 * 1024 + 1];
|
||||||
|
mockMvc.perform(multipart("/api/v1/convert").file(docx("big.docx", big)))
|
||||||
|
.andExpect(status().isBadRequest())
|
||||||
|
.andExpect(jsonPath("$.error",
|
||||||
|
org.hamcrest.Matchers.containsString("больше 5 МБ")));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void tooManyPages_rejectedBeforeRender() throws Exception {
|
||||||
|
mockMvc.perform(multipart("/api/v1/convert")
|
||||||
|
.file(docx("too-many-pages.docx", bytes("/samples/too-many-pages.docx"))))
|
||||||
|
.andExpect(status().isBadRequest())
|
||||||
|
.andExpect(jsonPath("$.error",
|
||||||
|
org.hamcrest.Matchers.containsString("100")));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void concurrentRequests_bothSucceed() throws Exception {
|
||||||
|
// регрессия сериализации: без single-thread executor всплывает
|
||||||
|
// гонка глобального реестра PhysicalFonts в ядре
|
||||||
|
byte[] sample = bytes("/samples/ru-plain.docx");
|
||||||
|
ExecutorService pool = Executors.newFixedThreadPool(2);
|
||||||
|
CountDownLatch start = new CountDownLatch(1);
|
||||||
|
try {
|
||||||
|
Future<?>[] futures = new Future<?>[2];
|
||||||
|
for (int i = 0; i < 2; i++) {
|
||||||
|
futures[i] = pool.submit(() -> {
|
||||||
|
try {
|
||||||
|
start.await();
|
||||||
|
MvcResult r = mockMvc.perform(multipart("/api/v1/convert")
|
||||||
|
.file(docx("ru-plain.docx", sample)))
|
||||||
|
.andExpect(status().isOk())
|
||||||
|
.andReturn();
|
||||||
|
byte[] pdf = r.getResponse().getContentAsByteArray();
|
||||||
|
assertTrue(new String(pdf, 0, 4, StandardCharsets.US_ASCII).equals("%PDF"),
|
||||||
|
"ответ не PDF");
|
||||||
|
} catch (Exception e) {
|
||||||
|
throw new IllegalStateException(e);
|
||||||
|
}
|
||||||
|
});
|
||||||
|
}
|
||||||
|
start.countDown();
|
||||||
|
for (Future<?> f : futures) {
|
||||||
|
f.get();
|
||||||
|
}
|
||||||
|
} finally {
|
||||||
|
pool.shutdownNow();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void corruptNotAZip_rejected() throws Exception {
|
||||||
|
// без zip-подписи ZipInputStream молча даёт 0 записей — отсекает
|
||||||
|
// отдельная проверка magic bytes
|
||||||
|
mockMvc.perform(multipart("/api/v1/convert")
|
||||||
|
.file(docx("broken.docx", "это просто текст, не архив"
|
||||||
|
.getBytes(StandardCharsets.UTF_8))))
|
||||||
|
.andExpect(status().isBadRequest())
|
||||||
|
.andExpect(jsonPath("$.error",
|
||||||
|
org.hamcrest.Matchers.containsString("не zip-архив")));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void junkInsideValidZip_conversionError() throws Exception {
|
||||||
|
// контейнер целый (валидный zip), мусор внутри — это ошибка
|
||||||
|
// преобразования (500), а не валидации (400)
|
||||||
|
mockMvc.perform(multipart("/api/v1/convert")
|
||||||
|
.file(docx("bad.docx", zipWithGarbage())))
|
||||||
|
.andExpect(status().isInternalServerError())
|
||||||
|
.andExpect(jsonPath("$.error",
|
||||||
|
org.hamcrest.Matchers.containsString("Не удалось конвертировать")));
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -1,83 +0,0 @@
|
|||||||
<?xml version="1.0" encoding="UTF-8"?>
|
|
||||||
<project xmlns="http://maven.apache.org/POM/4.0.0"
|
|
||||||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
|
||||||
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
|
|
||||||
<modelVersion>4.0.0</modelVersion>
|
|
||||||
|
|
||||||
<parent>
|
|
||||||
<groupId>ru.pjandro</groupId>
|
|
||||||
<artifactId>java-word-pdf</artifactId>
|
|
||||||
<version>1.0.0</version>
|
|
||||||
</parent>
|
|
||||||
|
|
||||||
<artifactId>wordpdf-cli</artifactId>
|
|
||||||
<name>wordpdf-cli</name>
|
|
||||||
<description>CLI: конвертация docx в PDF (fat-jar)</description>
|
|
||||||
|
|
||||||
<dependencies>
|
|
||||||
<dependency>
|
|
||||||
<groupId>ru.pjandro</groupId>
|
|
||||||
<artifactId>wordpdf-core</artifactId>
|
|
||||||
<version>${project.version}</version>
|
|
||||||
</dependency>
|
|
||||||
|
|
||||||
<!-- ============ Тесты ============ -->
|
|
||||||
<dependency>
|
|
||||||
<groupId>org.junit.jupiter</groupId>
|
|
||||||
<artifactId>junit-jupiter</artifactId>
|
|
||||||
<scope>test</scope>
|
|
||||||
</dependency>
|
|
||||||
<!-- Готовые .docx для smoke-теста берутся из test-jar wordpdf-core -->
|
|
||||||
<dependency>
|
|
||||||
<groupId>ru.pjandro</groupId>
|
|
||||||
<artifactId>wordpdf-core</artifactId>
|
|
||||||
<version>${project.version}</version>
|
|
||||||
<classifier>tests</classifier>
|
|
||||||
<type>test-jar</type>
|
|
||||||
<scope>test</scope>
|
|
||||||
</dependency>
|
|
||||||
</dependencies>
|
|
||||||
|
|
||||||
<build>
|
|
||||||
<plugins>
|
|
||||||
<!-- Fat-jar: все зависимости внутри, Main-Class в манифесте.
|
|
||||||
Запуск: java -jar wordpdf-cli-1.0.0.jar file.docx [out.pdf] -->
|
|
||||||
<plugin>
|
|
||||||
<groupId>org.apache.maven.plugins</groupId>
|
|
||||||
<artifactId>maven-shade-plugin</artifactId>
|
|
||||||
<executions>
|
|
||||||
<execution>
|
|
||||||
<phase>package</phase>
|
|
||||||
<goals>
|
|
||||||
<goal>shade</goal>
|
|
||||||
</goals>
|
|
||||||
<configuration>
|
|
||||||
<transformers>
|
|
||||||
<transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
|
|
||||||
<mainClass>ru.pjandro.wordpdf.cli.WordPdfCli</mainClass>
|
|
||||||
</transformer>
|
|
||||||
<!-- FOP регистрирует ElementMapping/Renderer через
|
|
||||||
META-INF/services, и один и тот же файл лежит в
|
|
||||||
docx4j-fo-renderer-core и docx4j-export-fo:
|
|
||||||
без слияния второй перезаписывает первый и
|
|
||||||
FOP не узнаёт namespace fo: ("UnknownXMLObj"). -->
|
|
||||||
<transformer implementation="org.apache.maven.plugins.shade.resource.ServicesResourceTransformer"/>
|
|
||||||
</transformers>
|
|
||||||
<!-- Подписанные jar-файлы ломает shade -->
|
|
||||||
<filters>
|
|
||||||
<filter>
|
|
||||||
<artifact>*:*</artifact>
|
|
||||||
<excludes>
|
|
||||||
<exclude>META-INF/*.SF</exclude>
|
|
||||||
<exclude>META-INF/*.DSA</exclude>
|
|
||||||
<exclude>META-INF/*.RSA</exclude>
|
|
||||||
</excludes>
|
|
||||||
</filter>
|
|
||||||
</filters>
|
|
||||||
</configuration>
|
|
||||||
</execution>
|
|
||||||
</executions>
|
|
||||||
</plugin>
|
|
||||||
</plugins>
|
|
||||||
</build>
|
|
||||||
</project>
|
|
||||||
@@ -1,91 +0,0 @@
|
|||||||
package ru.pjandro.wordpdf.cli;
|
|
||||||
|
|
||||||
import ru.pjandro.wordpdf.ConversionException;
|
|
||||||
import ru.pjandro.wordpdf.WordPdfConverter;
|
|
||||||
|
|
||||||
import java.nio.file.Path;
|
|
||||||
import java.nio.file.Paths;
|
|
||||||
import java.util.Locale;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Командная строка: конвертация docx в PDF.
|
|
||||||
*
|
|
||||||
* Использование:
|
|
||||||
* <pre>
|
|
||||||
* java -jar wordpdf-cli-1.0.0.jar in.docx [in2.docx]
|
|
||||||
* java -jar wordpdf-cli-1.0.0.jar in.docx out.pdf
|
|
||||||
* </pre>
|
|
||||||
*
|
|
||||||
* <ul>
|
|
||||||
* <li>один аргумент: рядом с файлом создаётся {@code <имя>.pdf};</li>
|
|
||||||
* <li>два аргумента, второй — {@code .pdf}: конвертация в указанный файл;</li>
|
|
||||||
* <li>два аргумента, второй — {@code .docx}: пакетная конвертация,
|
|
||||||
* каждый исходник -> свой .pdf рядом с ним.</li>
|
|
||||||
* </ul>
|
|
||||||
*
|
|
||||||
* Коды возврата: 0 — всё успешно, 1 — ошибка использования,
|
|
||||||
* 2 — не удалось конвертировать хотя бы один файл.
|
|
||||||
*/
|
|
||||||
public final class WordPdfCli {
|
|
||||||
|
|
||||||
private WordPdfCli() {
|
|
||||||
}
|
|
||||||
|
|
||||||
public static void main(String[] args) {
|
|
||||||
System.exit(run(args));
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Точка входа без System.exit (удобно для тестов).
|
|
||||||
*
|
|
||||||
* @return код возврата (см. javadoc класса)
|
|
||||||
*/
|
|
||||||
public static int run(String[] args) {
|
|
||||||
if (args.length < 1 || args.length > 2) {
|
|
||||||
System.err.println(usage());
|
|
||||||
return 1;
|
|
||||||
}
|
|
||||||
|
|
||||||
boolean failed = false;
|
|
||||||
if (args.length == 2 && args[1].toLowerCase(Locale.ROOT).endsWith(".pdf")) {
|
|
||||||
// Два аргумента, второй — .pdf: явный выходной файл
|
|
||||||
failed |= !convertOne(Paths.get(args[0]), Paths.get(args[1]));
|
|
||||||
} else {
|
|
||||||
// Один входной, либо два .docx: каждый -> <имя>.pdf рядом с исходником
|
|
||||||
for (String in : args) {
|
|
||||||
failed |= !convertOne(Paths.get(in), null);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
return failed ? 2 : 0;
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Конвертирует один файл и печатает результат.
|
|
||||||
*
|
|
||||||
* @param in входной .docx
|
|
||||||
* @param out выходной .pdf, или null (рядом с исходником)
|
|
||||||
* @return успех?
|
|
||||||
*/
|
|
||||||
private static boolean convertOne(Path in, Path out) {
|
|
||||||
try {
|
|
||||||
Path result;
|
|
||||||
if (out == null) {
|
|
||||||
result = WordPdfConverter.convert(in);
|
|
||||||
} else {
|
|
||||||
WordPdfConverter.convert(in, out);
|
|
||||||
result = out;
|
|
||||||
}
|
|
||||||
System.out.println(result + " — готово");
|
|
||||||
return true;
|
|
||||||
} catch (ConversionException e) {
|
|
||||||
System.err.println(in + ": " + e.getMessage());
|
|
||||||
return false;
|
|
||||||
} catch (Exception e) {
|
|
||||||
System.err.println(in + ": неожиданная ошибка: " + e);
|
|
||||||
return false;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
private static String usage() {
|
|
||||||
return "Использование: java -jar wordpdf-cli.jar <file1.docx [file2.docx ...]>\n"
|
|
||||||
+ " java -jar wordpdf-cli.jar <in.docx out.pdf>";
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -1,116 +0,0 @@
|
|||||||
package ru.pjandro.wordpdf.cli;
|
|
||||||
|
|
||||||
import org.junit.jupiter.api.Test;
|
|
||||||
import ru.pjandro.wordpdf.WordPdfValidator;
|
|
||||||
|
|
||||||
import java.io.InputStream;
|
|
||||||
import java.nio.charset.StandardCharsets;
|
|
||||||
import java.nio.file.Files;
|
|
||||||
import java.nio.file.Path;
|
|
||||||
import java.nio.file.StandardCopyOption;
|
|
||||||
import java.util.List;
|
|
||||||
|
|
||||||
import static org.junit.jupiter.api.Assertions.*;
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Smoke-тест CLI. Готовый .docx берётся из test-jar wordpdf-core
|
|
||||||
* (classpath: samples/ru-plain.docx).
|
|
||||||
*/
|
|
||||||
class WordPdfCliTest {
|
|
||||||
|
|
||||||
@Test
|
|
||||||
void usageErrors() {
|
|
||||||
assertEquals(1, WordPdfCli.run(new String[]{}), "нет аргументов");
|
|
||||||
assertEquals(1, WordPdfCli.run(new String[]{"a.docx", "b.docx", "c.docx"}),
|
|
||||||
"слишком много аргументов");
|
|
||||||
}
|
|
||||||
|
|
||||||
@Test
|
|
||||||
void missingFileReturnsError() {
|
|
||||||
assertEquals(2, WordPdfCli.run(new String[]{"/tmp/no-such-file-xyz.docx"}));
|
|
||||||
}
|
|
||||||
|
|
||||||
/**
|
|
||||||
* Превышение 5 MiB на входе: CLI должен вернуть код 2 (ошибка конвертации)
|
|
||||||
* — валидатор бросает {@code ConversionException}, CLI ловит и печатает
|
|
||||||
* в stderr.
|
|
||||||
*/
|
|
||||||
@Test
|
|
||||||
void oversizedInputReturnsError() throws Exception {
|
|
||||||
Path tooBig = Files.createTempFile("cli-too-big-", ".docx");
|
|
||||||
try {
|
|
||||||
Files.write(tooBig,
|
|
||||||
new byte[(int) WordPdfValidator.MAX_INPUT_BYTES + 1]);
|
|
||||||
assertEquals(2, WordPdfCli.run(new String[]{tooBig.toString()}),
|
|
||||||
"превышение лимита должно давать код 2");
|
|
||||||
} finally {
|
|
||||||
// при регрессии guard'а CLI написал бы PDF рядом со входом —
|
|
||||||
// убирать и его, чтобы тест не оставлял артефактов
|
|
||||||
Files.deleteIfExists(tooBig);
|
|
||||||
Files.deleteIfExists(Path.of(
|
|
||||||
tooBig.toString().replaceFirst("\\.docx$", "") + ".pdf"));
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
@Test
|
|
||||||
void convertsSampleWithExplicitOutput() throws Exception {
|
|
||||||
// Сэмпл из test-jar wordpdf-core
|
|
||||||
Path in = extractToTemp("samples/ru-plain.docx", "cli-in-");
|
|
||||||
Path out = in.resolveSibling("cli-out.pdf");
|
|
||||||
|
|
||||||
int code = WordPdfCli.run(new String[]{in.toString(), out.toString()});
|
|
||||||
|
|
||||||
assertEquals(0, code, "CLI вернул ошибку");
|
|
||||||
assertTrue(Files.isRegularFile(out), "PDF не создан");
|
|
||||||
// Магический заголовок PDF
|
|
||||||
byte[] header = new byte[4];
|
|
||||||
try (InputStream is = Files.newInputStream(out)) {
|
|
||||||
int read = is.readNBytes(header, 0, 4);
|
|
||||||
assertEquals(4, read);
|
|
||||||
}
|
|
||||||
assertEquals("%PDF", new String(header, StandardCharsets.US_ASCII));
|
|
||||||
}
|
|
||||||
|
|
||||||
@Test
|
|
||||||
void convertsSampleWithoutExplicitOutput() throws Exception {
|
|
||||||
// Выход = <имя без .docx>.pdf рядом с исходником
|
|
||||||
Path in = extractToTemp("samples/en-plain.docx", "cli-in2-");
|
|
||||||
String name = in.getFileName().toString();
|
|
||||||
int dot = name.lastIndexOf('.');
|
|
||||||
Path expected = in.resolveSibling(name.substring(0, dot) + ".pdf");
|
|
||||||
|
|
||||||
int code = WordPdfCli.run(new String[]{in.toString()});
|
|
||||||
|
|
||||||
assertEquals(0, code, "CLI вернул ошибку");
|
|
||||||
assertTrue(Files.isRegularFile(expected), "PDF не создан: " + expected);
|
|
||||||
}
|
|
||||||
|
|
||||||
@Test
|
|
||||||
void batchConvertsBothInputs() throws Exception {
|
|
||||||
// Два .docx-аргумента = пакетная конвертация (не «вход/выход»):
|
|
||||||
// каждый исходник -> свой .pdf рядом
|
|
||||||
Path in1 = extractToTemp("samples/ru-plain.docx", "cli-b1-");
|
|
||||||
Path in2 = extractToTemp("samples/en-plain.docx", "cli-b2-");
|
|
||||||
|
|
||||||
int code = WordPdfCli.run(new String[]{in1.toString(), in2.toString()});
|
|
||||||
|
|
||||||
assertEquals(0, code, "CLI вернул ошибку");
|
|
||||||
for (Path in : List.of(in1, in2)) {
|
|
||||||
String name = in.getFileName().toString();
|
|
||||||
int dot = name.lastIndexOf('.');
|
|
||||||
Path expected = in.resolveSibling(name.substring(0, dot) + ".pdf");
|
|
||||||
assertTrue(Files.isRegularFile(expected), "PDF не создан: " + expected);
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
/** Выгружает ресурс (сэмпл) из classpath во временный файл. */
|
|
||||||
private static Path extractToTemp(String resource, String prefix) throws Exception {
|
|
||||||
try (InputStream in = WordPdfCliTest.class.getClassLoader()
|
|
||||||
.getResourceAsStream(resource)) {
|
|
||||||
assertNotNull(in, "Нет ресурса: " + resource);
|
|
||||||
Path tmp = Files.createTempFile(prefix, ".docx");
|
|
||||||
Files.copy(in, tmp, StandardCopyOption.REPLACE_EXISTING);
|
|
||||||
return tmp;
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
@@ -20,7 +20,7 @@
|
|||||||
<groupId>org.docx4j</groupId>
|
<groupId>org.docx4j</groupId>
|
||||||
<artifactId>docx4j-core</artifactId>
|
<artifactId>docx4j-core</artifactId>
|
||||||
</dependency>
|
</dependency>
|
||||||
<!-- Реализация JAXB для docx4j на Java 17 -->
|
<!-- Реализация JAXB для docx4j -->
|
||||||
<dependency>
|
<dependency>
|
||||||
<groupId>org.docx4j</groupId>
|
<groupId>org.docx4j</groupId>
|
||||||
<artifactId>docx4j-JAXB-ReferenceImpl</artifactId>
|
<artifactId>docx4j-JAXB-ReferenceImpl</artifactId>
|
||||||
@@ -61,7 +61,7 @@
|
|||||||
<build>
|
<build>
|
||||||
<plugins>
|
<plugins>
|
||||||
<!-- Тестовый jar с готовыми .docx из src/test/resources/samples:
|
<!-- Тестовый jar с готовыми .docx из src/test/resources/samples:
|
||||||
используется CLI-модулем для smoke-теста. -->
|
используется тестами wordpdf-app. -->
|
||||||
<plugin>
|
<plugin>
|
||||||
<groupId>org.apache.maven.plugins</groupId>
|
<groupId>org.apache.maven.plugins</groupId>
|
||||||
<artifactId>maven-jar-plugin</artifactId>
|
<artifactId>maven-jar-plugin</artifactId>
|
||||||
|
|||||||
@@ -0,0 +1,2 @@
|
|||||||
|
node_modules
|
||||||
|
dist
|
||||||
@@ -0,0 +1,24 @@
|
|||||||
|
# Logs
|
||||||
|
logs
|
||||||
|
*.log
|
||||||
|
npm-debug.log*
|
||||||
|
yarn-debug.log*
|
||||||
|
yarn-error.log*
|
||||||
|
pnpm-debug.log*
|
||||||
|
lerna-debug.log*
|
||||||
|
|
||||||
|
node_modules
|
||||||
|
dist
|
||||||
|
dist-ssr
|
||||||
|
*.local
|
||||||
|
|
||||||
|
# Editor directories and files
|
||||||
|
.vscode/*
|
||||||
|
!.vscode/extensions.json
|
||||||
|
.idea
|
||||||
|
.DS_Store
|
||||||
|
*.suo
|
||||||
|
*.ntvs*
|
||||||
|
*.njsproj
|
||||||
|
*.sln
|
||||||
|
*.sw?
|
||||||
@@ -0,0 +1,8 @@
|
|||||||
|
{
|
||||||
|
"$schema": "./node_modules/oxlint/configuration_schema.json",
|
||||||
|
"plugins": ["react", "typescript", "oxc"],
|
||||||
|
"rules": {
|
||||||
|
"react/rules-of-hooks": "error",
|
||||||
|
"react/only-export-components": ["warn", { "allowConstantExport": true }]
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,17 @@
|
|||||||
|
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 . .
|
||||||
|
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
|
||||||
@@ -0,0 +1,22 @@
|
|||||||
|
# wordpdf-web
|
||||||
|
|
||||||
|
SPA-фронт конвертера Word → PDF: React 19 + TypeScript + Vite + Tailwind CSS v4.
|
||||||
|
В Maven-сборку не входит; деплоится отдельным nginx-контейнером (см.
|
||||||
|
`Dockerfile`/`nginx.conf` и корневой `docker-compose.yml`).
|
||||||
|
|
||||||
|
## Dev
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm install
|
||||||
|
npm run dev # http://localhost:5173, /api проксируется на :8080
|
||||||
|
```
|
||||||
|
|
||||||
|
Бэкенд для dev: `java -jar ../wordpdf-app/target/wordpdf-app-1.0.0.jar`.
|
||||||
|
|
||||||
|
## Сборка
|
||||||
|
|
||||||
|
```bash
|
||||||
|
npm run build # tsc -b && vite build → dist/
|
||||||
|
```
|
||||||
|
|
||||||
|
UI-тестов нет; гейт — успешная сборка (`tsc -b` ловит типизацию).
|
||||||
@@ -0,0 +1,13 @@
|
|||||||
|
<!doctype html>
|
||||||
|
<html lang="ru">
|
||||||
|
<head>
|
||||||
|
<meta charset="UTF-8" />
|
||||||
|
<link rel="icon" type="image/svg+xml" href="/favicon.svg" />
|
||||||
|
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
|
||||||
|
<title>Word → PDF</title>
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
<div id="root"></div>
|
||||||
|
<script type="module" src="/src/main.tsx"></script>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
@@ -0,0 +1,11 @@
|
|||||||
|
server {
|
||||||
|
listen 80;
|
||||||
|
root /usr/share/nginx/html;
|
||||||
|
index index.html;
|
||||||
|
# без него upload >1MB режется HTML-413 от nginx до бэкенда
|
||||||
|
client_max_body_size 6m;
|
||||||
|
location /api/ { proxy_pass http://app:8080; }
|
||||||
|
location /swagger-ui { proxy_pass http://app:8080; }
|
||||||
|
location /v3/api-docs { proxy_pass http://app:8080; }
|
||||||
|
location / { try_files $uri $uri/ /index.html; }
|
||||||
|
}
|
||||||
Generated
+1942
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,27 @@
|
|||||||
|
{
|
||||||
|
"name": "wordpdf-web",
|
||||||
|
"private": true,
|
||||||
|
"version": "0.0.0",
|
||||||
|
"type": "module",
|
||||||
|
"scripts": {
|
||||||
|
"dev": "vite",
|
||||||
|
"build": "tsc -b && vite build",
|
||||||
|
"lint": "oxlint",
|
||||||
|
"preview": "vite preview"
|
||||||
|
},
|
||||||
|
"dependencies": {
|
||||||
|
"@tailwindcss/vite": "^4.3.3",
|
||||||
|
"react": "^19.2.8",
|
||||||
|
"react-dom": "^19.2.8",
|
||||||
|
"tailwindcss": "^4.3.3"
|
||||||
|
},
|
||||||
|
"devDependencies": {
|
||||||
|
"@types/node": "^24.13.3",
|
||||||
|
"@types/react": "^19.2.18",
|
||||||
|
"@types/react-dom": "^19.2.7",
|
||||||
|
"@vitejs/plugin-react": "^6.1.1",
|
||||||
|
"oxlint": "^1.81.0",
|
||||||
|
"typescript": "~6.0.2",
|
||||||
|
"vite": "^8.3.0"
|
||||||
|
}
|
||||||
|
}
|
||||||
File diff suppressed because one or more lines are too long
|
After Width: | Height: | Size: 9.3 KiB |
@@ -0,0 +1,32 @@
|
|||||||
|
/** Ошибка API: сервер ответил не 2xx — текст из JSON `{"error": …}`. */
|
||||||
|
export class ApiError extends Error {}
|
||||||
|
|
||||||
|
export interface ConvertResult {
|
||||||
|
blob: Blob
|
||||||
|
filename: string
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Единственная сетевая точка приложения: POST /api/v1/convert (multipart,
|
||||||
|
* поле `file`) → PDF-blob + имя файла из Content-Disposition.
|
||||||
|
* Таймаут на фронте не ставим: конвертация долгая — это ожидаемо.
|
||||||
|
*/
|
||||||
|
export async function convertDocx(
|
||||||
|
file: File,
|
||||||
|
signal: AbortSignal,
|
||||||
|
): Promise<ConvertResult> {
|
||||||
|
const fd = new FormData()
|
||||||
|
fd.append('file', file, file.name)
|
||||||
|
const resp = await fetch('/api/v1/convert', { method: 'POST', body: fd, signal })
|
||||||
|
if (!resp.ok) {
|
||||||
|
const json = (await resp.json().catch(() => null)) as { error?: string } | null
|
||||||
|
throw new ApiError(json?.error ?? `HTTP ${resp.status}`)
|
||||||
|
}
|
||||||
|
// Framework 7 отдаёт `filename*=UTF-8''…` (charset в верхнем регистре) —
|
||||||
|
// флаг i обязателен; фолбэк — имя исходника с заменой расширения
|
||||||
|
const cd = resp.headers.get('Content-Disposition') ?? ''
|
||||||
|
const m = /filename\*=utf-8''([^;]+)/i.exec(cd)
|
||||||
|
const filename = m ? decodeURIComponent(m[1]) : file.name.replace(/\.docx$/i, '') + '.pdf'
|
||||||
|
const blob = await resp.blob()
|
||||||
|
return { blob, filename }
|
||||||
|
}
|
||||||
@@ -0,0 +1,137 @@
|
|||||||
|
import { useEffect, useRef, useState } from 'react'
|
||||||
|
import { ApiError, convertDocx } from '../api'
|
||||||
|
import DropZone from './DropZone'
|
||||||
|
import Logo from './Logo'
|
||||||
|
import PdfPreview from './PdfPreview'
|
||||||
|
import StatusMessage from './StatusMessage'
|
||||||
|
|
||||||
|
type Status = 'idle' | 'converting' | 'done' | 'error'
|
||||||
|
|
||||||
|
interface Result {
|
||||||
|
url: string
|
||||||
|
filename: string
|
||||||
|
size: number
|
||||||
|
}
|
||||||
|
|
||||||
|
export default function App() {
|
||||||
|
const [file, setFile] = useState<File | null>(null)
|
||||||
|
const [status, setStatus] = useState<Status>('idle')
|
||||||
|
const [result, setResult] = useState<Result | null>(null)
|
||||||
|
const [error, setError] = useState<string | null>(null)
|
||||||
|
const abortRef = useRef<AbortController | null>(null)
|
||||||
|
const urlRef = useRef<string | null>(null)
|
||||||
|
|
||||||
|
// снимаем blob-URL предыдущего результата — иначе он течёт до закрытия вкладки
|
||||||
|
const resetResult = () => {
|
||||||
|
if (urlRef.current) {
|
||||||
|
URL.revokeObjectURL(urlRef.current)
|
||||||
|
urlRef.current = null
|
||||||
|
}
|
||||||
|
setResult(null)
|
||||||
|
setError(null)
|
||||||
|
}
|
||||||
|
|
||||||
|
const selectFile = (picked: File) => {
|
||||||
|
resetResult()
|
||||||
|
setStatus('idle')
|
||||||
|
setFile(picked)
|
||||||
|
}
|
||||||
|
|
||||||
|
const convert = () => {
|
||||||
|
if (!file || status === 'converting') return
|
||||||
|
resetResult()
|
||||||
|
setStatus('converting')
|
||||||
|
const ac = new AbortController()
|
||||||
|
abortRef.current = ac
|
||||||
|
convertDocx(file, ac.signal)
|
||||||
|
.then(({ blob, filename }) => {
|
||||||
|
const url = URL.createObjectURL(blob)
|
||||||
|
urlRef.current = url
|
||||||
|
setResult({ url, filename, size: blob.size })
|
||||||
|
setStatus('done')
|
||||||
|
})
|
||||||
|
.catch((e: unknown) => {
|
||||||
|
if (e instanceof DOMException && e.name === 'AbortError') return
|
||||||
|
// ApiError — осмысленный текст из JSON; всё остальное — нет связи
|
||||||
|
setError(e instanceof ApiError ? e.message : 'Сервер недоступен')
|
||||||
|
setStatus('error')
|
||||||
|
})
|
||||||
|
.finally(() => {
|
||||||
|
abortRef.current = null
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
useEffect(
|
||||||
|
() => () => {
|
||||||
|
abortRef.current?.abort()
|
||||||
|
if (urlRef.current) URL.revokeObjectURL(urlRef.current)
|
||||||
|
},
|
||||||
|
[],
|
||||||
|
)
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="min-h-screen bg-bg">
|
||||||
|
<div className="mx-auto max-w-[760px] px-5 py-12">
|
||||||
|
<header className="mb-8 flex items-center gap-3">
|
||||||
|
<Logo className="h-10 w-10 shrink-0 text-accent" />
|
||||||
|
<div>
|
||||||
|
<h1 className="text-2xl font-semibold">Word → PDF</h1>
|
||||||
|
<p className="mt-1 text-sm text-muted">
|
||||||
|
docx → PDF на docx4j + Apache FOP. Лимиты: файл ≤ 5 МБ, документ ≤ 100
|
||||||
|
страниц.
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
</header>
|
||||||
|
|
||||||
|
<section className="rounded-2xl border border-border bg-surface p-6 shadow-sm">
|
||||||
|
<DropZone file={file} disabled={status === 'converting'} onSelect={selectFile} />
|
||||||
|
|
||||||
|
<div className="mt-5">
|
||||||
|
<button
|
||||||
|
type="button"
|
||||||
|
onClick={convert}
|
||||||
|
disabled={!file || status === 'converting'}
|
||||||
|
className={`flex items-center gap-2 rounded-lg bg-accent px-6 py-3 font-medium text-white ${
|
||||||
|
!file || status === 'converting' ? 'cursor-default opacity-60' : 'hover:bg-accent/90'
|
||||||
|
}`}
|
||||||
|
>
|
||||||
|
{status === 'converting' ? (
|
||||||
|
<>
|
||||||
|
<span
|
||||||
|
className="h-4 w-4 animate-spin rounded-full border-2 border-white/40 border-t-white"
|
||||||
|
aria-hidden="true"
|
||||||
|
/>
|
||||||
|
Конвертация…
|
||||||
|
</>
|
||||||
|
) : (
|
||||||
|
'Конвертировать'
|
||||||
|
)}
|
||||||
|
</button>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{status === 'done' && result && (
|
||||||
|
<StatusMessage
|
||||||
|
kind="success"
|
||||||
|
text={`Готово · ${result.filename} · ${(result.size / 1024).toFixed(0)} КБ`}
|
||||||
|
/>
|
||||||
|
)}
|
||||||
|
{status === 'error' && error && <StatusMessage kind="error" text={error} />}
|
||||||
|
|
||||||
|
{status === 'done' && result && (
|
||||||
|
<PdfPreview url={result.url} filename={result.filename} />
|
||||||
|
)}
|
||||||
|
</section>
|
||||||
|
|
||||||
|
<footer className="mt-8 text-sm text-muted">
|
||||||
|
<a href="/swagger-ui.html" className="underline-offset-2 hover:text-accent hover:underline">
|
||||||
|
Swagger UI
|
||||||
|
</a>
|
||||||
|
{' · '}
|
||||||
|
<a href="/v3/api-docs" className="underline-offset-2 hover:text-accent hover:underline">
|
||||||
|
OpenAPI
|
||||||
|
</a>
|
||||||
|
</footer>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
}
|
||||||
@@ -0,0 +1,77 @@
|
|||||||
|
import { useRef, useState } from 'react'
|
||||||
|
import type { DragEvent } from 'react'
|
||||||
|
|
||||||
|
interface Props {
|
||||||
|
file: File | null
|
||||||
|
disabled: boolean
|
||||||
|
onSelect: (file: File) => void
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Зона drag&drop + клик для выбора .docx. Скрытый input[type=file] —
|
||||||
|
* единственный источник выбора; drop берёт первый файл.
|
||||||
|
*/
|
||||||
|
export default function DropZone({ file, disabled, onSelect }: Props) {
|
||||||
|
const inputRef = useRef<HTMLInputElement>(null)
|
||||||
|
const [dragging, setDragging] = useState(false)
|
||||||
|
|
||||||
|
const onDrop = (e: DragEvent<HTMLLabelElement>) => {
|
||||||
|
e.preventDefault()
|
||||||
|
setDragging(false)
|
||||||
|
if (disabled) return
|
||||||
|
const dropped = e.dataTransfer.files[0]
|
||||||
|
if (dropped) onSelect(dropped)
|
||||||
|
}
|
||||||
|
|
||||||
|
return (
|
||||||
|
<label
|
||||||
|
onDragOver={(e) => {
|
||||||
|
e.preventDefault()
|
||||||
|
if (!disabled) setDragging(true)
|
||||||
|
}}
|
||||||
|
onDragLeave={(e) => {
|
||||||
|
e.preventDefault()
|
||||||
|
setDragging(false)
|
||||||
|
}}
|
||||||
|
onDrop={onDrop}
|
||||||
|
className={`flex cursor-pointer flex-col items-center gap-3 rounded-xl border-2 border-dashed p-9 text-center transition-colors ${
|
||||||
|
dragging
|
||||||
|
? 'border-accent bg-accent/6'
|
||||||
|
: 'border-border hover:border-accent hover:bg-accent/6'
|
||||||
|
}`}
|
||||||
|
>
|
||||||
|
<svg
|
||||||
|
viewBox="0 0 24 24"
|
||||||
|
fill="none"
|
||||||
|
stroke="currentColor"
|
||||||
|
strokeWidth="1.8"
|
||||||
|
strokeLinecap="round"
|
||||||
|
strokeLinejoin="round"
|
||||||
|
className="h-9 w-9 text-accent"
|
||||||
|
aria-hidden="true"
|
||||||
|
>
|
||||||
|
<path d="M12 16V4m0 0-4 4m4-4 4 4" />
|
||||||
|
<path d="M4 16v3a1 1 0 0 0 1 1h14a1 1 0 0 0 1-1v-3" />
|
||||||
|
</svg>
|
||||||
|
<span>Перетащите .docx сюда или нажмите для выбора</span>
|
||||||
|
{file && (
|
||||||
|
<span className="text-sm text-muted">
|
||||||
|
{file.name} · {(file.size / 1024).toFixed(0)} КБ
|
||||||
|
</span>
|
||||||
|
)}
|
||||||
|
<input
|
||||||
|
ref={inputRef}
|
||||||
|
type="file"
|
||||||
|
accept=".docx"
|
||||||
|
className="sr-only"
|
||||||
|
disabled={disabled}
|
||||||
|
onChange={(e) => {
|
||||||
|
const picked = e.target.files?.[0]
|
||||||
|
if (picked) onSelect(picked)
|
||||||
|
// сбрасываем value — иначе повторный выбор того же файла не событие
|
||||||
|
e.target.value = ''
|
||||||
|
}}
|
||||||
|
/>
|
||||||
|
</label>
|
||||||
|
)
|
||||||
|
}
|
||||||
@@ -0,0 +1,21 @@
|
|||||||
|
/** Логотип: лист A4 → стрелка → лист PDF. Красится currentColor. */
|
||||||
|
export default function Logo({ className }: { className?: string }) {
|
||||||
|
return (
|
||||||
|
<svg
|
||||||
|
viewBox="0 0 40 40"
|
||||||
|
fill="none"
|
||||||
|
stroke="currentColor"
|
||||||
|
strokeWidth="2"
|
||||||
|
strokeLinecap="round"
|
||||||
|
strokeLinejoin="round"
|
||||||
|
className={className}
|
||||||
|
aria-hidden="true"
|
||||||
|
>
|
||||||
|
<rect x="2.5" y="8" width="15" height="24" rx="2" />
|
||||||
|
<path d="M6.5 14.5h7M6.5 19h7M6.5 23.5h4" />
|
||||||
|
<path d="M20 20h7m0 0-2.5-2.5M27 20l-2.5 2.5" />
|
||||||
|
<rect x="29.5" y="8" width="8" height="24" rx="2" />
|
||||||
|
<path d="M31.5 26.5h4M31.5 14h4v5h-4z" />
|
||||||
|
</svg>
|
||||||
|
)
|
||||||
|
}
|
||||||
@@ -0,0 +1,34 @@
|
|||||||
|
interface Props {
|
||||||
|
url: string
|
||||||
|
filename: string
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Предпросмотр PDF (blob-URL в iframe) + кнопки скачивания. */
|
||||||
|
export default function PdfPreview({ url, filename }: Props) {
|
||||||
|
return (
|
||||||
|
<section className="mt-6">
|
||||||
|
<iframe
|
||||||
|
src={url}
|
||||||
|
title="Предпросмотр PDF"
|
||||||
|
className="h-[65vh] w-full rounded-xl border-0 shadow-sm"
|
||||||
|
/>
|
||||||
|
<div className="mt-4 flex gap-3">
|
||||||
|
<a
|
||||||
|
href={url}
|
||||||
|
download={filename}
|
||||||
|
className="rounded-lg bg-accent px-6 py-3 font-medium text-white hover:bg-accent/90"
|
||||||
|
>
|
||||||
|
Скачать PDF
|
||||||
|
</a>
|
||||||
|
<a
|
||||||
|
href={url}
|
||||||
|
target="_blank"
|
||||||
|
rel="noopener"
|
||||||
|
className="rounded-lg border border-border px-6 py-3 font-medium hover:border-accent"
|
||||||
|
>
|
||||||
|
Открыть в новой вкладке
|
||||||
|
</a>
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
)
|
||||||
|
}
|
||||||
@@ -0,0 +1,33 @@
|
|||||||
|
interface Props {
|
||||||
|
kind: 'success' | 'error'
|
||||||
|
/** Для success: «Готово · имя · КБ»; для error: текст ошибки. */
|
||||||
|
text: string
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Строка результата над/под кнопкой: успех (зелёный) или ошибка (красный). */
|
||||||
|
export default function StatusMessage({ kind, text }: Props) {
|
||||||
|
const ok = kind === 'success'
|
||||||
|
return (
|
||||||
|
<p
|
||||||
|
role="status"
|
||||||
|
aria-live="polite"
|
||||||
|
className={`mt-5 flex items-center gap-2 text-sm font-medium ${
|
||||||
|
ok ? 'text-ok' : 'text-err'
|
||||||
|
}`}
|
||||||
|
>
|
||||||
|
<svg
|
||||||
|
viewBox="0 0 20 20"
|
||||||
|
fill="none"
|
||||||
|
stroke="currentColor"
|
||||||
|
strokeWidth="2"
|
||||||
|
strokeLinecap="round"
|
||||||
|
strokeLinejoin="round"
|
||||||
|
className="h-4.5 w-4.5 shrink-0"
|
||||||
|
aria-hidden="true"
|
||||||
|
>
|
||||||
|
{ok ? <path d="M4 10.5l4 4 8-9" /> : <path d="M5 5l10 10M15 5 5 15" />}
|
||||||
|
</svg>
|
||||||
|
{text}
|
||||||
|
</p>
|
||||||
|
)
|
||||||
|
}
|
||||||
@@ -0,0 +1,29 @@
|
|||||||
|
@import "tailwindcss";
|
||||||
|
|
||||||
|
@theme {
|
||||||
|
--color-bg: #f6f7f9;
|
||||||
|
--color-surface: #ffffff;
|
||||||
|
--color-border: #e3e6ea;
|
||||||
|
--color-text: #1c2333;
|
||||||
|
--color-muted: #667085;
|
||||||
|
--color-accent: #2f6fed;
|
||||||
|
--color-ok: #1a7f37;
|
||||||
|
--color-err: #d1242f;
|
||||||
|
}
|
||||||
|
|
||||||
|
@media (prefers-color-scheme: dark) {
|
||||||
|
:root {
|
||||||
|
--color-bg: #0f1420;
|
||||||
|
--color-surface: #171e2e;
|
||||||
|
--color-border: #2a3348;
|
||||||
|
--color-text: #e6e9f0;
|
||||||
|
--color-muted: #98a2b3;
|
||||||
|
--color-accent: #4f83f1;
|
||||||
|
--color-ok: #3fb950;
|
||||||
|
--color-err: #f85149;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
body {
|
||||||
|
@apply bg-bg text-text antialiased;
|
||||||
|
}
|
||||||
@@ -0,0 +1,10 @@
|
|||||||
|
import { StrictMode } from 'react'
|
||||||
|
import { createRoot } from 'react-dom/client'
|
||||||
|
import './index.css'
|
||||||
|
import App from './components/App'
|
||||||
|
|
||||||
|
createRoot(document.getElementById('root')!).render(
|
||||||
|
<StrictMode>
|
||||||
|
<App />
|
||||||
|
</StrictMode>,
|
||||||
|
)
|
||||||
@@ -0,0 +1,26 @@
|
|||||||
|
{
|
||||||
|
"compilerOptions": {
|
||||||
|
"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.app.tsbuildinfo",
|
||||||
|
"target": "es2023",
|
||||||
|
"lib": ["ES2023", "DOM"],
|
||||||
|
"module": "esnext",
|
||||||
|
"types": ["vite/client"],
|
||||||
|
"allowArbitraryExtensions": true,
|
||||||
|
"skipLibCheck": true,
|
||||||
|
|
||||||
|
/* Bundler mode */
|
||||||
|
"moduleResolution": "bundler",
|
||||||
|
"allowImportingTsExtensions": true,
|
||||||
|
"verbatimModuleSyntax": true,
|
||||||
|
"moduleDetection": "force",
|
||||||
|
"noEmit": true,
|
||||||
|
"jsx": "react-jsx",
|
||||||
|
|
||||||
|
/* Linting */
|
||||||
|
"noUnusedLocals": true,
|
||||||
|
"noUnusedParameters": true,
|
||||||
|
"erasableSyntaxOnly": true,
|
||||||
|
"noFallthroughCasesInSwitch": true
|
||||||
|
},
|
||||||
|
"include": ["src"]
|
||||||
|
}
|
||||||
@@ -0,0 +1,7 @@
|
|||||||
|
{
|
||||||
|
"files": [],
|
||||||
|
"references": [
|
||||||
|
{ "path": "./tsconfig.app.json" },
|
||||||
|
{ "path": "./tsconfig.node.json" }
|
||||||
|
]
|
||||||
|
}
|
||||||
@@ -0,0 +1,23 @@
|
|||||||
|
{
|
||||||
|
"compilerOptions": {
|
||||||
|
"tsBuildInfoFile": "./node_modules/.tmp/tsconfig.node.tsbuildinfo",
|
||||||
|
"target": "es2023",
|
||||||
|
"lib": ["ES2023"],
|
||||||
|
"types": ["node"],
|
||||||
|
"skipLibCheck": true,
|
||||||
|
|
||||||
|
/* Bundler mode */
|
||||||
|
"module": "nodenext",
|
||||||
|
"allowImportingTsExtensions": true,
|
||||||
|
"verbatimModuleSyntax": true,
|
||||||
|
"moduleDetection": "force",
|
||||||
|
"noEmit": true,
|
||||||
|
|
||||||
|
/* Linting */
|
||||||
|
"noUnusedLocals": true,
|
||||||
|
"noUnusedParameters": true,
|
||||||
|
"erasableSyntaxOnly": true,
|
||||||
|
"noFallthroughCasesInSwitch": true
|
||||||
|
},
|
||||||
|
"include": ["vite.config.ts"]
|
||||||
|
}
|
||||||
@@ -0,0 +1,14 @@
|
|||||||
|
import tailwindcss from '@tailwindcss/vite'
|
||||||
|
import react from '@vitejs/plugin-react'
|
||||||
|
import { defineConfig } from 'vite'
|
||||||
|
|
||||||
|
// https://vite.dev/config/
|
||||||
|
export default defineConfig({
|
||||||
|
plugins: [react(), tailwindcss()],
|
||||||
|
server: {
|
||||||
|
// dev без CORS: запросы /api идут на бэкенд через прокси
|
||||||
|
proxy: {
|
||||||
|
'/api': 'http://localhost:8080',
|
||||||
|
},
|
||||||
|
},
|
||||||
|
})
|
||||||
Reference in New Issue
Block a user