Замена wordpdf-cli на Spring Boot REST API: wordpdf-app, SPA wordpdf-web, docker-compose

This commit is contained in:
Pjandro
2026-10-13 16:38:18 +00:00
parent aec4dbffe7
commit 8c390104d2
44 changed files with 3439 additions and 337 deletions
+10
View File
@@ -0,0 +1,10 @@
target/
*/target/
.git/
.codegraph/
diff/
.idea/
*.iml
dependency-reduced-pom.xml
wordpdf-web/node_modules
wordpdf-web/dist
+4
View File
@@ -2,6 +2,10 @@
target/
dependency-reduced-pom.xml
# Node (wordpdf-web)
node_modules/
wordpdf-web/dist/
# IDE
.idea/
*.iml
+26 -18
View File
@@ -2,7 +2,7 @@
## 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
@@ -21,16 +21,21 @@
→ `Docx4J.toFO(..., FLAG_EXPORT_PREFER_XSL)`.
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`. Без фиксов нет колонок и колонок таблиц.
- **`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`.
- **Не убирать shade-фильтры `META-INF/*.SF|*.DSA|*.RSA`** — подписанные jar ломают fat-jar.
- **`slf4j-simple` обязателен**: без него docx4j пишет «TO HIDE THESE MESSAGES» прямо в выходной PDF (регрессия `noLoggingWarningInPdf`).
- **`slf4j-simple` обязателен** в ядре: без него docx4j пишет «TO HIDE THESE MESSAGES» прямо в выходной PDF (регрессия `noLoggingWarningInPdf`). Приложение (`wordpdf-app`) исключает `slf4j-simple` из зависимости ядра — логи ведёт logback из Boot; предупреждение в PDF возникает только при полном отсутствии SLF4J-провайдера, `slf4j-simple.properties` из core остаётся инертным ресурсом.
- **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`.
- `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 — не добавляем намеренно).
- **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)
@@ -56,7 +61,10 @@
| `…/wordpdf/internal/chart/` | Java2D-рендер диаграмм/SmartArt в PNG |
| `wordpdf-core/src/main/resources/fonts/` | 30 TTF + лицензии — бинарные фикстуры, часть jar |
| `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 не подключать |
| `diff/`, корневые `word-export.*` | gitignored артефакты ручной калибровки |
@@ -64,14 +72,14 @@
```bash
mvn clean verify # все модули + тесты — обязательный гейт перед push
mvn -pl wordpdf-cli package # fat-jar (из корня); из каталога cli — только с -am
java -jar wordpdf-cli/target/wordpdf-cli-1.0.0.jar in.docx [out.pdf]
mvn -pl wordpdf-app -am package # исполняемый jar бэкенда
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 # один тест
```
CLI: 1 аргумент → PDF рядом с исходником; 2-й `.pdf` → явный выход; **два `.docx` = пакетная конвертация**. Коды возврата: 0 успех, 1 ошибка использования, 2 не сконвертирован хотя бы один файл.
`dependency-reduced-pom.xml` — артефакт shade, не коммитить.
Compose: `web` проксирует `/api`, `/swagger-ui`, `/v3/api-docs` на `app` (DNS-имя в сети compose); бэкенд наружу не публикуется. `wordpdf.convert-timeout` переопределяется env `WORDPDF_CONVERT_TIMEOUT` (relaxed binding Boot).
Пересоздать 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
- Классы `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)` для юнит-тестов.
- Ошибки публичного API — только `ConversionException extends RuntimeException`; внутренние `IOException`/`IllegalStateException` оборачиваются на границе. В chart — деградация вместо падения: неизвестный пресет → прямоугольник + лог.
- Javadoc на русском, объясняет «почему» и ссылается на регрессию и фикстуру (формат: `Регрессия — WordPdfConverterTest#имя, фикстура samples/….docx`) — новый фикс оформлять так же.
- Константы UPPER_SNAKE с числовыми эталонными значениями (`CAMERA_DISTANCE`, `MAX_PAGES`); начертания `V_REGULAR/V_BOLD/...`; модели — `record`; размеры в chart — в пунктах, растр × `DPI/72`.
- Внутренние 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
- `wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java` — точка входа библиотеки + static-блок `gsubFeatures`.
- `wordpdf-cli/pom.xml` — shade: Main-Class, `ServicesResourceTransformer`, фильтры подписей.
- Корневой `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`, пинить не надо.
- `wordpdf-app/pom.xml` — `spring-boot-maven-plugin` с **явной** execution `repackage` (в 4.1.1 сам не связывается, jar останется тонким); `slf4j-simple` исключён из зависимости ядра.
- Корневой `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/test/java/ru/pjandro/wordpdf/SampleDocxGenerator.java` — main()-утилита пересоздания фикстур (команда в javadoc).
## 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`.
- CI, линтеров, форматтеров, checkstyle — нет; проверка одна: `mvn clean verify`.
- Fat-jar проверять только `java -jar` (тесты идут по classpath и shade-проблем не видят).
- Исполняемый jar бэкенда проверять только `java -jar` (тесты идут по classpath и repackage-специфику не видят).
## 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%.
- Текст нормализуется по пробелам (`tableImage_tableAndImage` — полное удаление пробелов: docx4j переносит слова в auto-fit таблицах).
- Фикстуры — закоммиченные `samples/*.docx` (не генерировать в тестах); classpath → временный файл (`extractSample`/`extractToTemp`). In-memory docx — `ZipOutputStream` из литеральных XML или POI в `byte[]` (`WordPdfValidatorTest`).
- Юниты нормализаторов работают строками (`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`.
+26
View File
@@ -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"]
+43 -13
View File
@@ -11,14 +11,16 @@ LibreOffice/Aspose. Шрифты упакованы в jar — конверта
в docx4j/FOP.
- Частые 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/
├── 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`):
@@ -34,28 +36,39 @@ java-word-pdf/
## Сборка
Требуется **Java 17** и **Maven**.
Требуется **Java 21** и **Maven** (бэкенд), **Node.js ≥ 20.19** (веб-интерфейс).
```bash
mvn clean verify # сборка всех модулей + тесты
mvn -pl wordpdf-cli package # только fat-jar CLI
mvn clean verify # все модули + тесты
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
java -jar wordpdf-cli-1.0.0.jar in.docx # рядом создаётся in.pdf
java -jar wordpdf-cli-1.0.0.jar in.docx out.pdf # в указанный файл
java -jar wordpdf-cli-1.0.0.jar a.docx b.docx # пакетно: каждый -> свой .pdf
java -jar wordpdf-app/target/wordpdf-app-1.0.0.jar
curl -F "file=@doc.docx" http://localhost:8080/api/v1/convert -o doc.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`.
### Веб-интерфейс и 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 текстовых
@@ -139,3 +166,6 @@ docx ──> нормализация байтов ──> docx4j (Wordprocessin
Тесты используют готовые `.docx` из `wordpdf-core/src/test/resources/samples/`
(генерируются POI) и проверяют извлечённый PDFBox'ом текст и встраивание
шрифтов. Запуск: `mvn test`.
API (`wordpdf-app`) проверяется `MockMvc`-сквозняками (`ConvertControllerTest`)
на тех же фикстурах — ядро отдаёт их test-jar'ом.
+12
View File
@@ -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
+31 -14
View File
@@ -14,32 +14,49 @@
<modules>
<module>wordpdf-core</module>
<module>wordpdf-cli</module>
<module>wordpdf-app</module>
</modules>
<properties>
<maven.compiler.source>17</maven.compiler.source>
<maven.compiler.target>17</maven.compiler.target>
<maven.compiler.release>21</maven.compiler.release>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<!-- docx4j: последняя стабильная версия на Maven Central -->
<docx4j.version>17.3.0</docx4j.version>
<slf4j.version>2.0.17</slf4j.version>
<docx4j.version>17.3.2</docx4j.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>
<pdfbox.version>3.0.7</pdfbox.version>
<junit.version>6.1.3</junit.version>
<pdfbox.version>3.0.8</pdfbox.version>
<poi.version>5.5.1</poi.version>
</properties>
<dependencyManagement>
<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>
<groupId>org.docx4j</groupId>
<artifactId>docx4j-core</artifactId>
<version>${docx4j.version}</version>
</dependency>
<!-- Реализация JAXB (Java 17, без javax-пакетов) -->
<!-- Реализация JAXB (без javax-пакетов) -->
<dependency>
<groupId>org.docx4j</groupId>
<artifactId>docx4j-JAXB-ReferenceImpl</artifactId>
@@ -83,12 +100,12 @@
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.15.0</version>
<version>3.16.0</version>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>3.5.6</version>
<version>3.6.0</version>
<!-- docx4j/FOP не требуют дисплея -->
<configuration>
<argLine>-Djava.awt.headless=true</argLine>
@@ -97,12 +114,12 @@
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
<version>3.4.2</version>
<version>3.5.1</version>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-shade-plugin</artifactId>
<version>3.6.2</version>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-maven-plugin</artifactId>
<version>${spring-boot.version}</version>
</plugin>
</plugins>
</pluginManagement>
+94
View File
@@ -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("Не удалось конвертировать")));
}
}
-83
View File
@@ -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;
}
}
}
+2 -2
View File
@@ -20,7 +20,7 @@
<groupId>org.docx4j</groupId>
<artifactId>docx4j-core</artifactId>
</dependency>
<!-- Реализация JAXB для docx4j на Java 17 -->
<!-- Реализация JAXB для docx4j -->
<dependency>
<groupId>org.docx4j</groupId>
<artifactId>docx4j-JAXB-ReferenceImpl</artifactId>
@@ -61,7 +61,7 @@
<build>
<plugins>
<!-- Тестовый jar с готовыми .docx из src/test/resources/samples:
используется CLI-модулем для smoke-теста. -->
используется тестами wordpdf-app. -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-jar-plugin</artifactId>
+2
View File
@@ -0,0 +1,2 @@
node_modules
dist
+24
View File
@@ -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?
+8
View File
@@ -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 }]
}
}
+17
View File
@@ -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
+22
View File
@@ -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` ловит типизацию).
+13
View File
@@ -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>
+11
View File
@@ -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; }
}
+1942
View File
File diff suppressed because it is too large Load Diff
+27
View File
@@ -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

+32
View File
@@ -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 }
}
+137
View File
@@ -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>
)
}
+77
View File
@@ -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>
)
}
+21
View File
@@ -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>
)
}
+34
View File
@@ -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>
)
}
+29
View File
@@ -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;
}
+10
View File
@@ -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>,
)
+26
View File
@@ -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"]
}
+7
View File
@@ -0,0 +1,7 @@
{
"files": [],
"references": [
{ "path": "./tsconfig.app.json" },
{ "path": "./tsconfig.node.json" }
]
}
+23
View File
@@ -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"]
}
+14
View File
@@ -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',
},
},
})