JaCoCo: гейт покрытия 90% + сводка/артефакты репортов в CI #35
@@ -32,6 +32,67 @@ jobs:
|
|||||||
- name: Build and test (PMD gate included)
|
- name: Build and test (PMD gate included)
|
||||||
run: mvn -B clean verify
|
run: mvn -B clean verify
|
||||||
|
|
||||||
|
- name: Coverage summary
|
||||||
|
if: always()
|
||||||
|
run: |
|
||||||
|
python3 - <<'PY' > coverage-summary.md
|
||||||
|
import os
|
||||||
|
import xml.etree.ElementTree as ET
|
||||||
|
def pct(root, kind):
|
||||||
|
for c in root.findall("counter"):
|
||||||
|
if c.get("type") == kind:
|
||||||
|
missed, covered = int(c.get("missed")), int(c.get("covered"))
|
||||||
|
return f"{100.0 * covered / (missed + covered):.1f}%"
|
||||||
|
return "—"
|
||||||
|
print("<!-- jacoco-coverage -->")
|
||||||
|
print("## Покрытие (JaCoCo)\n")
|
||||||
|
print("| Модуль | Строки | Ветви | Порог строк |")
|
||||||
|
print("|---|---|---|---|")
|
||||||
|
for m in ("wordpdf-core", "wordpdf-app"):
|
||||||
|
p = f"{m}/target/site/jacoco/jacoco.xml"
|
||||||
|
if not os.path.exists(p):
|
||||||
|
print(f"| {m} | нет данных | — | 90% |")
|
||||||
|
continue
|
||||||
|
r = ET.parse(p).getroot()
|
||||||
|
print(f"| {m} | {pct(r, 'LINE')} | {pct(r, 'BRANCH')} | 90% |")
|
||||||
|
PY
|
||||||
|
cat coverage-summary.md >> "$GITHUB_STEP_SUMMARY"
|
||||||
|
|
||||||
|
# Таблица покрытия — комментарием в PR: видно в обсуждении, не открывая run.
|
||||||
|
# Повторные push обновляют тот же комментарий (поиск по маркеру),
|
||||||
|
# github.token — task-токен раннера, падение не валит job. Артефактов с
|
||||||
|
# отчётами НЕТ намеренно: upload-artifact@v4 Gitea не поддерживает, @v3 на
|
||||||
|
# этом стенде висит на загрузке (отменена и с 153 файлами, и с одним zip);
|
||||||
|
# HTML — локально в target/site/jacoco. Шаг байт-в-байт одинаков в обоих
|
||||||
|
# workflow, в main.yml if не срабатывает — нет PR-события
|
||||||
|
- name: Comment coverage on PR
|
||||||
|
if: always() && github.event_name == 'pull_request'
|
||||||
|
continue-on-error: true
|
||||||
|
env:
|
||||||
|
GITEA_TOKEN: ${{ github.token }}
|
||||||
|
API: ${{ github.api_url }}
|
||||||
|
REPO: ${{ github.repository }}
|
||||||
|
PR_NUMBER: ${{ github.event.pull_request.number }}
|
||||||
|
run: |
|
||||||
|
[ -s coverage-summary.md ] || exit 0
|
||||||
|
python3 - <<'PY'
|
||||||
|
import json, os, urllib.request
|
||||||
|
api, repo, pr = os.environ["API"], os.environ["REPO"], os.environ["PR_NUMBER"]
|
||||||
|
token = os.environ["GITEA_TOKEN"]
|
||||||
|
body = open("coverage-summary.md").read()
|
||||||
|
def req(method, url, payload=None):
|
||||||
|
data = json.dumps(payload).encode() if payload is not None else None
|
||||||
|
r = urllib.request.Request(url, data=data, method=method,
|
||||||
|
headers={"Authorization": f"token {token}",
|
||||||
|
"Content-Type": "application/json"})
|
||||||
|
return json.loads(urllib.request.urlopen(r).read() or "null")
|
||||||
|
base = f"{api}/repos/{repo}/issues/{pr}/comments"
|
||||||
|
existing = next((c["id"] for c in req("GET", base)
|
||||||
|
if "<!-- jacoco-coverage -->" in c.get("body", "")), None)
|
||||||
|
req("PATCH" if existing else "POST",
|
||||||
|
f"{base}/{existing}" if existing else base, {"body": body})
|
||||||
|
PY
|
||||||
|
|
||||||
web:
|
web:
|
||||||
runs-on: ubuntu-latest
|
runs-on: ubuntu-latest
|
||||||
steps:
|
steps:
|
||||||
|
|||||||
@@ -31,6 +31,67 @@ jobs:
|
|||||||
- name: Build and test (PMD gate included)
|
- name: Build and test (PMD gate included)
|
||||||
run: mvn -B clean verify
|
run: mvn -B clean verify
|
||||||
|
|
||||||
|
- name: Coverage summary
|
||||||
|
if: always()
|
||||||
|
run: |
|
||||||
|
python3 - <<'PY' > coverage-summary.md
|
||||||
|
import os
|
||||||
|
import xml.etree.ElementTree as ET
|
||||||
|
def pct(root, kind):
|
||||||
|
for c in root.findall("counter"):
|
||||||
|
if c.get("type") == kind:
|
||||||
|
missed, covered = int(c.get("missed")), int(c.get("covered"))
|
||||||
|
return f"{100.0 * covered / (missed + covered):.1f}%"
|
||||||
|
return "—"
|
||||||
|
print("<!-- jacoco-coverage -->")
|
||||||
|
print("## Покрытие (JaCoCo)\n")
|
||||||
|
print("| Модуль | Строки | Ветви | Порог строк |")
|
||||||
|
print("|---|---|---|---|")
|
||||||
|
for m in ("wordpdf-core", "wordpdf-app"):
|
||||||
|
p = f"{m}/target/site/jacoco/jacoco.xml"
|
||||||
|
if not os.path.exists(p):
|
||||||
|
print(f"| {m} | нет данных | — | 90% |")
|
||||||
|
continue
|
||||||
|
r = ET.parse(p).getroot()
|
||||||
|
print(f"| {m} | {pct(r, 'LINE')} | {pct(r, 'BRANCH')} | 90% |")
|
||||||
|
PY
|
||||||
|
cat coverage-summary.md >> "$GITHUB_STEP_SUMMARY"
|
||||||
|
|
||||||
|
# Таблица покрытия — комментарием в PR: видно в обсуждении, не открывая run.
|
||||||
|
# Повторные push обновляют тот же комментарий (поиск по маркеру),
|
||||||
|
# github.token — task-токен раннера, падение не валит job. Артефактов с
|
||||||
|
# отчётами НЕТ намеренно: upload-artifact@v4 Gitea не поддерживает, @v3 на
|
||||||
|
# этом стенде висит на загрузке (отменена и с 153 файлами, и с одним zip);
|
||||||
|
# HTML — локально в target/site/jacoco. Шаг байт-в-байт одинаков в обоих
|
||||||
|
# workflow, в main.yml if не срабатывает — нет PR-события
|
||||||
|
- name: Comment coverage on PR
|
||||||
|
if: always() && github.event_name == 'pull_request'
|
||||||
|
continue-on-error: true
|
||||||
|
env:
|
||||||
|
GITEA_TOKEN: ${{ github.token }}
|
||||||
|
API: ${{ github.api_url }}
|
||||||
|
REPO: ${{ github.repository }}
|
||||||
|
PR_NUMBER: ${{ github.event.pull_request.number }}
|
||||||
|
run: |
|
||||||
|
[ -s coverage-summary.md ] || exit 0
|
||||||
|
python3 - <<'PY'
|
||||||
|
import json, os, urllib.request
|
||||||
|
api, repo, pr = os.environ["API"], os.environ["REPO"], os.environ["PR_NUMBER"]
|
||||||
|
token = os.environ["GITEA_TOKEN"]
|
||||||
|
body = open("coverage-summary.md").read()
|
||||||
|
def req(method, url, payload=None):
|
||||||
|
data = json.dumps(payload).encode() if payload is not None else None
|
||||||
|
r = urllib.request.Request(url, data=data, method=method,
|
||||||
|
headers={"Authorization": f"token {token}",
|
||||||
|
"Content-Type": "application/json"})
|
||||||
|
return json.loads(urllib.request.urlopen(r).read() or "null")
|
||||||
|
base = f"{api}/repos/{repo}/issues/{pr}/comments"
|
||||||
|
existing = next((c["id"] for c in req("GET", base)
|
||||||
|
if "<!-- jacoco-coverage -->" in c.get("body", "")), None)
|
||||||
|
req("PATCH" if existing else "POST",
|
||||||
|
f"{base}/{existing}" if existing else base, {"body": body})
|
||||||
|
PY
|
||||||
|
|
||||||
web:
|
web:
|
||||||
runs-on: ubuntu-latest
|
runs-on: ubuntu-latest
|
||||||
steps:
|
steps:
|
||||||
|
|||||||
@@ -58,7 +58,7 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр
|
|||||||
|`wordpdf-web/src/`|SPA (React 19 + TS + Vite + Tailwind): `api.ts` (вся сеть), `components/` (App, ApiKeyGate, PdfPreview, StatusMessage, DropZone, Logo)|
|
|`wordpdf-web/src/`|SPA (React 19 + TS + Vite + Tailwind): `api.ts` (вся сеть), `components/` (App, ApiKeyGate, PdfPreview, StatusMessage, DropZone, Logo)|
|
||||||
|корневые `Containerfile`, `compose.yml`, `compose.dev.yml`, `gateway/nginx.conf`|образ бэкенда (multi-stage maven:3.9-temurin-21 → temurin-**21-jre-alpine** (musl) — chart-движку нужен только модуль java.desktop (Graphics2D, он внутри JRE); fontconfig и системные шрифты рантайму не нужны — текст рисуется глифами fontbox, см. `fonts/GlyphFont` (проверено на musl-стенде без libfontconfig/`/etc/fonts`); HEALTHCHECK busybox `wget` (curl/apt не ставим), non-root uid 10001); compose app+web+gateway: web-образ со своим HEALTHCHECK (`wget /`), в обоих compose `depends_on web: condition: service_healthy`; прод-compose не в репо — его рендерит job `deploy` (лимиты запекаются из Variables); podman-специфика обоих compose: `x-podman.name_separator_compat` (docker-style имена), явные `healthcheck` app/web (дубли Containerfile-HEALTHCHECK — OCI-выгрузка его теряет; app-хелсчеки — `wget`, как в Containerfile), зафиксированная подсеть `10.113.0.0/24` gw `10.113.0.1` под резолвер aardvark-dns; два repo-стенда одновременно не поднять (общая подсеть)|
|
|корневые `Containerfile`, `compose.yml`, `compose.dev.yml`, `gateway/nginx.conf`|образ бэкенда (multi-stage maven:3.9-temurin-21 → temurin-**21-jre-alpine** (musl) — chart-движку нужен только модуль java.desktop (Graphics2D, он внутри JRE); fontconfig и системные шрифты рантайму не нужны — текст рисуется глифами fontbox, см. `fonts/GlyphFont` (проверено на musl-стенде без libfontconfig/`/etc/fonts`); HEALTHCHECK busybox `wget` (curl/apt не ставим), non-root uid 10001); compose app+web+gateway: web-образ со своим HEALTHCHECK (`wget /`), в обоих compose `depends_on web: condition: service_healthy`; прод-compose не в репо — его рендерит job `deploy` (лимиты запекаются из Variables); podman-специфика обоих compose: `x-podman.name_separator_compat` (docker-style имена), явные `healthcheck` app/web (дубли Containerfile-HEALTHCHECK — OCI-выгрузка его теряет; app-хелсчеки — `wget`, как в Containerfile), зафиксированная подсеть `10.113.0.0/24` gw `10.113.0.1` под резолвер aardvark-dns; два repo-стенда одновременно не поднять (общая подсеть)|
|
||||||
|корневой `.env.example`|шаблон env для локальных/compose-стендов: `WORDPDF_API_KEY` (`openssl rand -hex 32`), закомментированные `WORDPDF_MAX_MB`/`WORDPDF_MAX_PAGES` (пустое значение ломает старт — binding long/int); проду `.env` **не нужен**: ключ и лимиты подаёт job `deploy` из Gitea Secrets/Variables, legacy-`.env` на проде удаляется деплоем|
|
|корневой `.env.example`|шаблон env для локальных/compose-стендов: `WORDPDF_API_KEY` (`openssl rand -hex 32`), закомментированные `WORDPDF_MAX_MB`/`WORDPDF_MAX_PAGES` (пустое значение ломает старт — binding long/int); проду `.env` **не нужен**: ключ и лимиты подаёт job `deploy` из Gitea Secrets/Variables, legacy-`.env` на проде удаляется деплоем|
|
||||||
|`.gitea/workflows/`|Gitea Actions: `pr.yml` (PR checks), `main.yml` (тесты → `images-app`/`images-web` (build+push в Nexus) → deploy (рендер прод-конфигов + pull) → autotests → rollback)|
|
|`.gitea/workflows/`|Gitea Actions: `pr.yml` (PR checks), `main.yml` (тесты + coverage-сводка и комментарий в PR → `images-app`/`images-web` (build+push в Nexus) → deploy (рендер прод-конфигов + pull) → autotests → rollback)|
|
||||||
|корневой `GITEA-vars.md`|инструкция владельца: Secrets/Variables, защита ветки, перезапуск — только имена переменных, без значений|
|
|корневой `GITEA-vars.md`|инструкция владельца: Secrets/Variables, защита ветки, перезапуск — только имена переменных, без значений|
|
||||||
|корневой `prod-autotests/`|прод-автотесты API (pytest + requests, 21 проверка): конфигурация стенда **только env** (`WORDPDF_BASE_URL` обязателен, `WORDPDF_API_KEY`/`WORDPDF_MAX_PAGES`/`WORDPDF_MAX_MB`/`WORDPDF_SAMPLES_DIR` факультативны) — прод-хостов/ключей в коде нет; окружение — mise (`mise.toml`: python 3.15 + автосоздаваемый `.venv`); прод-раннер вне git — `/home/pjandro/prod/java-word-pdf/run-prod-tests.sh`|
|
|корневой `prod-autotests/`|прод-автотесты API (pytest + requests, 21 проверка): конфигурация стенда **только env** (`WORDPDF_BASE_URL` обязателен, `WORDPDF_API_KEY`/`WORDPDF_MAX_PAGES`/`WORDPDF_MAX_MB`/`WORDPDF_SAMPLES_DIR` факультативны) — прод-хостов/ключей в коде нет; окружение — mise (`mise.toml`: python 3.15 + автосоздаваемый `.venv`); прод-раннер вне git — `/home/pjandro/prod/java-word-pdf/run-prod-tests.sh`|
|
||||||
|`develop/` (вне git, gitignored)|рабочие материалы и эталоны Word для ручного сравнения — **не фикстуры**, в тесты/jar не подключать; на 2026-10 директория пуста (эталоны вынесены, пиксельные замеры зашиты числами в chart-тестах)|
|
|`develop/` (вне git, gitignored)|рабочие материалы и эталоны Word для ручного сравнения — **не фикстуры**, в тесты/jar не подключать; на 2026-10 директория пуста (эталоны вынесены, пиксельные замеры зашиты числами в chart-тестах)|
|
||||||
@@ -66,7 +66,7 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр
|
|||||||
## Development Commands
|
## Development Commands
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
mvn clean verify # все модули + тесты + PMD (pmd-ruleset.xml) — обязательный гейт перед push
|
mvn clean verify # все модули + тесты + PMD (pmd-ruleset.xml) + гейт покрытия JaCoCo 90% строк — обязательный гейт перед push
|
||||||
mvn -pl wordpdf-app -am package # исполняемый jar бэкенда
|
mvn -pl wordpdf-app -am package # исполняемый jar бэкенда
|
||||||
java -jar wordpdf-app/target/wordpdf-app-1.0.0.jar # :8080, ключ выключен
|
java -jar wordpdf-app/target/wordpdf-app-1.0.0.jar # :8080, ключ выключен
|
||||||
curl -F "file=@doc.docx" http://localhost:8080/api/v1/convert -o doc.pdf
|
curl -F "file=@doc.docx" http://localhost:8080/api/v1/convert -o doc.pdf
|
||||||
@@ -90,7 +90,16 @@ java -cp wordpdf-core/target/test-classes:$(cat /tmp/cp.txt) \
|
|||||||
## CI/CD (Gitea Actions)
|
## CI/CD (Gitea Actions)
|
||||||
|
|
||||||
Два workflow. `.gitea/workflows/pr.yml` — `PR checks` (`pull_request` + `workflow_dispatch`):
|
Два workflow. `.gitea/workflows/pr.yml` — `PR checks` (`pull_request` + `workflow_dispatch`):
|
||||||
job `java` (temurin 21, кеш `~/.m2` через `actions/cache`, Maven 3.9.16 ставится вручную с dlcdn, `mvn -B clean verify`)
|
job `java` (temurin 21, кеш `~/.m2` через `actions/cache`, Maven 3.9.16 ставится вручную с dlcdn, `mvn -B clean verify`,
|
||||||
|
затем `Coverage summary` — разбор `target/site/jacoco/jacoco.xml` python-сниппетом в файл
|
||||||
|
`coverage-summary.md` + step summary job'а и `Comment coverage on PR` — тот же текст
|
||||||
|
комментарием в PR (создаётся один раз, повторные push обновляют по маркеру
|
||||||
|
`<!-- jacoco-coverage -->`; `continue-on-error` — падение комментария не валит job;
|
||||||
|
в `main.yml` шаг продублирован байт-в-байт, но `if: github.event_name == 'pull_request'`
|
||||||
|
там не срабатывает). **Артефактов покрытия нет намеренно**: `upload-artifact@v4` Gitea
|
||||||
|
не поддерживает («not currently supported on GHES»), `@v3` на этом стенде зависает на
|
||||||
|
загрузке (проверено: отменена и с ~150 файлов, и с одним zip); HTML-отчёт — локально
|
||||||
|
`target/site/jacoco/`)
|
||||||
и `web` (кеш `~/.npm`, `npm ci`/`build`/`lint`). `.gitea/workflows/main.yml` — `Main: tests,
|
и `web` (кеш `~/.npm`, `npm ci`/`build`/`lint`). `.gitea/workflows/main.yml` — `Main: tests,
|
||||||
deploy, autotests` (`push` в `main` + `workflow_dispatch`): те же `java`/`web` (байт-в-байт
|
deploy, autotests` (`push` в `main` + `workflow_dispatch`): те же `java`/`web` (байт-в-байт
|
||||||
дубль — файлы самодостаточны, reusable-workflow не вводить), затем `images-app`/`images-web`
|
дубль — файлы самодостаточны, reusable-workflow не вводить), затем `images-app`/`images-web`
|
||||||
@@ -135,7 +144,7 @@ SSH-пользователи/логины, ни хосты, ни директо
|
|||||||
- `wordpdf-app/src/main/resources/application.properties` — multipart 100MB (`max-file-size`/`max-request-size` + `file-size-threshold=100MB`, держит файл в памяти; в тон gateway `client_max_body_size 100m`), `wordpdf.convert-timeout=2m`, пустой `wordpdf.api-key`, `server.forward-headers-strategy=framework` (префикс прод-прокси для springdoc) + `springdoc.swagger-ui.persist-authorization=true`; `wordpdf.max-mb`/`max-pages` здесь намеренно нет.
|
- `wordpdf-app/src/main/resources/application.properties` — multipart 100MB (`max-file-size`/`max-request-size` + `file-size-threshold=100MB`, держит файл в памяти; в тон gateway `client_max_body_size 100m`), `wordpdf.convert-timeout=2m`, пустой `wordpdf.api-key`, `server.forward-headers-strategy=framework` (префикс прод-прокси для springdoc) + `springdoc.swagger-ui.persist-authorization=true`; `wordpdf.max-mb`/`max-pages` здесь намеренно нет.
|
||||||
- `wordpdf-app/pom.xml` — `spring-boot-maven-plugin` с **явной** execution `repackage` (в 4.1.1 сам не связывается, jar останется тонким); `slf4j-simple` исключён; `spring-boot-starter-webmvc` (Boot 4: переименован из starter-web) + `spring-boot-starter-actuator` (нужен HEALTHCHECK контейнера `/actuator/health`); тест-зависимости: `spring-boot-webmvc-test` (в Boot 4 автоконфиг MockMvc вынесен из starter-test), test-jar core.
|
- `wordpdf-app/pom.xml` — `spring-boot-maven-plugin` с **явной** execution `repackage` (в 4.1.1 сам не связывается, jar останется тонким); `slf4j-simple` исключён; `spring-boot-starter-webmvc` (Boot 4: переименован из starter-web) + `spring-boot-starter-actuator` (нужен HEALTHCHECK контейнера `/actuator/health`); тест-зависимости: `spring-boot-webmvc-test` (в Boot 4 автоконфиг MockMvc вынесен из starter-test), test-jar core.
|
||||||
- `wordpdf-core/pom.xml` — `maven-jar-plugin` execution `test-jar` (публикует фикстуры для app).
|
- `wordpdf-core/pom.xml` — `maven-jar-plugin` execution `test-jar` (публикует фикстуры для app).
|
||||||
- Корневой `pom.xml` — все версии зависимостей (в модулях версии не объявлять): docx4j `17.3.2`, slf4j `2.0.20`, JUnit `6.1.3`, PDFBox `3.0.8` (`fontbox` — compile в core: глиф-движок `GlyphFont`; `pdfbox` — test в обоих модулях), POI `5.5.1` (test: генератор фикстур + in-memory документы в `WordPdfValidatorTest`), Spring Boot `4.1.1` (BOM-import), springdoc `3.1.1`; pluginManagement: compiler `3.16.0`, surefire `3.6.0` с `-Djava.awt.headless=true`, jar `3.5.1`, PMD `3.28.0`.
|
- Корневой `pom.xml` — все версии зависимостей (в модулях версии не объявлять): docx4j `17.3.2`, slf4j `2.0.20`, JUnit `6.1.3`, PDFBox `3.0.8` (`fontbox` — compile в core: глиф-движок `GlyphFont`; `pdfbox` — test в обоих модулях), POI `5.5.1` (test: генератор фикстур + in-memory документы в `WordPdfValidatorTest`), Spring Boot `4.1.1` (BOM-import), springdoc `3.1.1`; pluginManagement: compiler `3.16.0`, surefire `3.6.0` с `-Djava.awt.headless=true`, jar `3.5.1`, PMD `3.28.0`, JaCoCo `0.8.15`.
|
||||||
- Корневой `pmd-ruleset.xml` — ruleset PMD (см. Testing & QA): `category/java/codestyle.xml` минус opinionated-правила, `MethodNamingConventions` с `junit5TestPattern` под underscore-имена регрессий, `TooManyStaticImports` до 12, XPath-правило `LiteralFirstInEquals`, unused-правила из `bestpractices.xml`, `ReturnEmptyCollectionRatherThanNull` (errorprone, priority 1), `AvoidLiteralsInIfCondition` (errorprone, дефолтная 3), `EmptyCatchBlock` (errorprone) и `ForLoopCanBeForeach` (bestpractices) — оба priority 2.
|
- Корневой `pmd-ruleset.xml` — ruleset PMD (см. Testing & QA): `category/java/codestyle.xml` минус opinionated-правила, `MethodNamingConventions` с `junit5TestPattern` под underscore-имена регрессий, `TooManyStaticImports` до 12, XPath-правило `LiteralFirstInEquals`, unused-правила из `bestpractices.xml`, `ReturnEmptyCollectionRatherThanNull` (errorprone, priority 1), `AvoidLiteralsInIfCondition` (errorprone, дефолтная 3), `EmptyCatchBlock` (errorprone) и `ForLoopCanBeForeach` (bestpractices) — оба priority 2.
|
||||||
- `wordpdf-core/src/main/resources/slf4j-simple.properties` — без него предупреждение лезет в PDF.
|
- `wordpdf-core/src/main/resources/slf4j-simple.properties` — без него предупреждение лезет в PDF.
|
||||||
- `gateway/nginx.conf` — единственный вход: `/api/`, `/swagger-ui`, `/v3/api-docs`, `/actuator` → `app:8080`, остальное → `web:80`; `client_max_body_size 100m` (без директивы upload режется HTML-413 шлюза вместо JSON-ошибки API); `resolver 10.113.0.1` + `proxy_pass` через переменные (статический proxy_pass резолвит имя один раз при старте — gateway раньше app поднялся бы с 502 до перезапуска). `wordpdf-web/nginx.conf` — чистая статика с SPA-fallback, `/api` НЕ проксирует.
|
- `gateway/nginx.conf` — единственный вход: `/api/`, `/swagger-ui`, `/v3/api-docs`, `/actuator` → `app:8080`, остальное → `web:80`; `client_max_body_size 100m` (без директивы upload режется HTML-413 шлюза вместо JSON-ошибки API); `resolver 10.113.0.1` + `proxy_pass` через переменные (статический proxy_pass резолвит имя один раз при старте — gateway раньше app поднялся бы с 502 до перезапуска). `wordpdf-web/nginx.conf` — чистая статика с SPA-fallback, `/api` НЕ проксирует.
|
||||||
@@ -155,7 +164,8 @@ SSH-пользователи/логины, ни хосты, ни директо
|
|||||||
## Testing & QA
|
## Testing & QA
|
||||||
|
|
||||||
- Гейт `maven-pmd-plugin` 3.28.0 (PMD 7.17) на `verify` для обоих модулей, ruleset `pmd-ruleset.xml` (codestyle без opinionated-правил + unused-правила + XPath `LiteralFirstInEquals` — строковый литерал слева в `equals`/`equalsIgnoreCase`; `junit5TestPattern` разрешает underscore-имена регрессий; `includeTests=true` — тесты сканируются; `failurePriority` не задан — на практике `verify` валят нарушения любой приоритетности, проверено на priority 3–4: строки `[WARNING] PMD Failure` = BUILD FAILURE). Литералы в условиях `if` — только именованными константами (`AvoidLiteralsInIfCondition`; `else if`-ветки правило не проверяет, обычный вложенный `if` — проверяет; пустые `while` тоже валятся — `EmptyControlStatement`), `null` вместо пустой коллекции запрещён (`ReturnEmptyCollectionRatherThanNull` — `GlyphCoverageNormalizer.split` возвращает пустой список).
|
- Гейт `maven-pmd-plugin` 3.28.0 (PMD 7.17) на `verify` для обоих модулей, ruleset `pmd-ruleset.xml` (codestyle без opinionated-правил + unused-правила + XPath `LiteralFirstInEquals` — строковый литерал слева в `equals`/`equalsIgnoreCase`; `junit5TestPattern` разрешает underscore-имена регрессий; `includeTests=true` — тесты сканируются; `failurePriority` не задан — на практике `verify` валят нарушения любой приоритетности, проверено на priority 3–4: строки `[WARNING] PMD Failure` = BUILD FAILURE). Литералы в условиях `if` — только именованными константами (`AvoidLiteralsInIfCondition`; `else if`-ветки правило не проверяет, обычный вложенный `if` — проверяет; пустые `while` тоже валятся — `EmptyControlStatement`), `null` вместо пустой коллекции запрещён (`ReturnEmptyCollectionRatherThanNull` — `GlyphCoverageNormalizer.split` возвращает пустой список).
|
||||||
- 18 тестовых классов / 170 `@Test` (core 15/143, app 3/27: ConvertController 18 + ApiKeyFilter 7 + ConvertLimits 2). JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true` в argLine; только `Assertions` (Mockito/AssertJ не использовать, несмотря на test-classpath Boot; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`); тестовые классы package-private, зеркалят main-пакеты; только `@Test` (+ единственный `@BeforeAll` — warm-up шрифтов в `GlyphCoverageNormalizerTest`).
|
- Гейт JaCoCo `0.8.15`: `jacoco:check` (правило LINE, COVEREDRATIO `0.90`) на `verify` обоих модулей; агент подключается в surefire через `argLine` = `@{argLine} -Djava.awt.headless=true` (свойство `argLine` в корневом pom по умолчанию пусто и перезаписывается `prepare-agent` — `mvn test -Djacoco.skip=true` без агента работоспособно); `report` и `check` оба на `verify`, report раньше — при провале порога отчёт уже на диске; отчёты `target/site/jacoco/` (html+xml, xml нужен CI-сводке). Плотность покрытия держат тесты, а не заглушки: промахи в основном недостижимые IOException/catch-ветки (`GlyphFont`, `BundledFonts`) и рендер-код, требующий эталонного Word.
|
||||||
|
- 23 тестовых класса / 218 `@Test` (core 17/180, app 6/38: ConvertController 19 + ApiKeyFilter 7 + ConvertLimits 2 + ConversionService 5 + ApiExceptionHandler 4 + ConversionTimeout 1). JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true` в argLine; только `Assertions` (Mockito/AssertJ не использовать, несмотря на test-classpath Boot; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`); тестовые классы package-private, зеркалят main-пакеты; только `@Test` (+ единственный `@BeforeAll` — warm-up шрифтов в `GlyphCoverageNormalizerTest`).
|
||||||
- **PDF сравнивается текстом, не растеризацией**: PDFBox 3 (`Loader.loadPDF`) — `PDFTextStripper` для текста (пер-странично `setStartPage/setEndPage`), override `processTextPosition` для шрифта конкретного символа (`fontNameOf`), обход ресурсов страниц для встроенных шрифтов (`EAAAAA+Carlito-Bold`) и счётчика картинок (`imageCount`). Негативные маркеры — регрессии: `assertFalse(text.contains("#"))` (.notdef), `assertFalse(font.startsWith("Helvetica"))`. Текст нормализуется по пробелам (`norm`); в `tableImage_tableAndImage` — полное удаление пробелов (docx4j переносит слова в auto-fit таблицах).
|
- **PDF сравнивается текстом, не растеризацией**: PDFBox 3 (`Loader.loadPDF`) — `PDFTextStripper` для текста (пер-странично `setStartPage/setEndPage`), override `processTextPosition` для шрифта конкретного символа (`fontNameOf`), обход ресурсов страниц для встроенных шрифтов (`EAAAAA+Carlito-Bold`) и счётчика картинок (`imageCount`). Негативные маркеры — регрессии: `assertFalse(text.contains("#"))` (.notdef), `assertFalse(font.startsWith("Helvetica"))`. Текст нормализуется по пробелам (`norm`); в `tableImage_tableAndImage` — полное удаление пробелов (docx4j переносит слова в auto-fit таблицах).
|
||||||
- Пиксели (BufferedImage) — только в unit-тестах chart-пейнтеров: безразмерные отношения к эталону Word, допуски `assertRatio` <0.06 (`PiePainterTest` аспект h/w=0.585) / <0.10 (`Surface3dPainterTest`, + `assertRange` ±6 pt для центров силуэта); пороги залитых px и перцентильные коридоры яркости. Эталонные замеры — по Word-экспорту 300 dpi (числа зашиты в тесты; эталонные файлы — `develop/`, вне git, на 2026-10 пуста).
|
- Пиксели (BufferedImage) — только в unit-тестах chart-пейнтеров: безразмерные отношения к эталону Word, допуски `assertRatio` <0.06 (`PiePainterTest` аспект h/w=0.585) / <0.10 (`Surface3dPainterTest`, + `assertRange` ±6 pt для центров силуэта); пороги залитых px и перцентильные коридоры яркости. Эталонные замеры — по Word-экспорту 300 dpi (числа зашиты в тесты; эталонные файлы — `develop/`, вне git, на 2026-10 пуста).
|
||||||
- `GlyphFont` (fontbox): метрики пиксельно-метрически эквивалентны AWT (ascent/descent/leading/advance совпадают до 4-го знака, кернинг-дрейф 0.0000 — DejaVu Sans, Carlito). Приёмочный стенд без-fontconfig: контейнер без `libfontconfig.so.1*` и `/etc/fonts`, `mvn verify` + `java -jar` (до перехода на GlyphFont там падали `GlyphCoverageNormalizerTest` 12 / `CartesianPainterTest` 3 / `PiePainterTest` 2 / chart-тесты `WordPdfConverterTest` 4, chart-рендер молча деградировал). `GlyphFontTest` написан без единого `java.awt.Font` — обязан проходить на хосте без fontconfig.
|
- `GlyphFont` (fontbox): метрики пиксельно-метрически эквивалентны AWT (ascent/descent/leading/advance совпадают до 4-го знака, кернинг-дрейф 0.0000 — DejaVu Sans, Carlito). Приёмочный стенд без-fontconfig: контейнер без `libfontconfig.so.1*` и `/etc/fonts`, `mvn verify` + `java -jar` (до перехода на GlyphFont там падали `GlyphCoverageNormalizerTest` 12 / `CartesianPainterTest` 3 / `PiePainterTest` 2 / chart-тесты `WordPdfConverterTest` 4, chart-рендер молча деградировал). `GlyphFontTest` написан без единого `java.awt.Font` — обязан проходить на хосте без fontconfig.
|
||||||
|
|||||||
@@ -33,6 +33,12 @@
|
|||||||
<junit.version>6.1.3</junit.version>
|
<junit.version>6.1.3</junit.version>
|
||||||
<pdfbox.version>3.0.8</pdfbox.version>
|
<pdfbox.version>3.0.8</pdfbox.version>
|
||||||
<poi.version>5.5.1</poi.version>
|
<poi.version>5.5.1</poi.version>
|
||||||
|
|
||||||
|
<!-- Покрытие: последняя стабильная на Maven Central -->
|
||||||
|
<jacoco.version>0.8.15</jacoco.version>
|
||||||
|
<!-- Пустой дефолт: при -Djacoco.skip=true surefire не споткнётся
|
||||||
|
о неразвёрнутый @{argLine}; prepare-agent перезаписывает его -->
|
||||||
|
<argLine></argLine>
|
||||||
</properties>
|
</properties>
|
||||||
|
|
||||||
<dependencyManagement>
|
<dependencyManagement>
|
||||||
@@ -132,7 +138,7 @@
|
|||||||
<version>3.6.0</version>
|
<version>3.6.0</version>
|
||||||
<!-- docx4j/FOP не требуют дисплея -->
|
<!-- docx4j/FOP не требуют дисплея -->
|
||||||
<configuration>
|
<configuration>
|
||||||
<argLine>-Djava.awt.headless=true</argLine>
|
<argLine>@{argLine} -Djava.awt.headless=true</argLine>
|
||||||
</configuration>
|
</configuration>
|
||||||
</plugin>
|
</plugin>
|
||||||
<plugin>
|
<plugin>
|
||||||
@@ -162,6 +168,49 @@
|
|||||||
</execution>
|
</execution>
|
||||||
</executions>
|
</executions>
|
||||||
</plugin>
|
</plugin>
|
||||||
|
<plugin>
|
||||||
|
<groupId>org.jacoco</groupId>
|
||||||
|
<artifactId>jacoco-maven-plugin</artifactId>
|
||||||
|
<version>${jacoco.version}</version>
|
||||||
|
<executions>
|
||||||
|
<execution>
|
||||||
|
<id>prepare-agent</id>
|
||||||
|
<goals>
|
||||||
|
<goal>prepare-agent</goal>
|
||||||
|
</goals>
|
||||||
|
</execution>
|
||||||
|
<!-- report раньше check: оба на verify — XML/HTML пишутся
|
||||||
|
до гейта, при провале порога отчёт готов -->
|
||||||
|
<execution>
|
||||||
|
<id>report</id>
|
||||||
|
<phase>verify</phase>
|
||||||
|
<goals>
|
||||||
|
<goal>report</goal>
|
||||||
|
</goals>
|
||||||
|
</execution>
|
||||||
|
<execution>
|
||||||
|
<id>check</id>
|
||||||
|
<phase>verify</phase>
|
||||||
|
<goals>
|
||||||
|
<goal>check</goal>
|
||||||
|
</goals>
|
||||||
|
<configuration>
|
||||||
|
<rules>
|
||||||
|
<rule>
|
||||||
|
<element>BUNDLE</element>
|
||||||
|
<limits>
|
||||||
|
<limit>
|
||||||
|
<counter>LINE</counter>
|
||||||
|
<value>COVEREDRATIO</value>
|
||||||
|
<minimum>0.90</minimum>
|
||||||
|
</limit>
|
||||||
|
</limits>
|
||||||
|
</rule>
|
||||||
|
</rules>
|
||||||
|
</configuration>
|
||||||
|
</execution>
|
||||||
|
</executions>
|
||||||
|
</plugin>
|
||||||
<plugin>
|
<plugin>
|
||||||
<groupId>org.springframework.boot</groupId>
|
<groupId>org.springframework.boot</groupId>
|
||||||
<artifactId>spring-boot-maven-plugin</artifactId>
|
<artifactId>spring-boot-maven-plugin</artifactId>
|
||||||
@@ -175,6 +224,10 @@
|
|||||||
<groupId>org.apache.maven.plugins</groupId>
|
<groupId>org.apache.maven.plugins</groupId>
|
||||||
<artifactId>maven-pmd-plugin</artifactId>
|
<artifactId>maven-pmd-plugin</artifactId>
|
||||||
</plugin>
|
</plugin>
|
||||||
|
<plugin>
|
||||||
|
<groupId>org.jacoco</groupId>
|
||||||
|
<artifactId>jacoco-maven-plugin</artifactId>
|
||||||
|
</plugin>
|
||||||
</plugins>
|
</plugins>
|
||||||
</build>
|
</build>
|
||||||
</project>
|
</project>
|
||||||
|
|||||||
@@ -0,0 +1,57 @@
|
|||||||
|
package ru.pjandro.wordpdf.app;
|
||||||
|
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
import org.springframework.http.HttpStatus;
|
||||||
|
import org.springframework.web.multipart.MaxUploadSizeExceededException;
|
||||||
|
|
||||||
|
import java.time.Duration;
|
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertEquals;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertFalse;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Прямые юниты {@link ApiExceptionHandler} для кодов, не выжимаемых из
|
||||||
|
* MockMvc детерминированно: 503 (очередь полна — гонка по времени), 413
|
||||||
|
* (нужна загрузка за 100 МБ), catch-all 500 (все штатные исключения
|
||||||
|
* замаплены). Контракт — код + дословный текст {@code {"error": …}}.
|
||||||
|
*/
|
||||||
|
class ApiExceptionHandlerTest {
|
||||||
|
|
||||||
|
private final ApiExceptionHandler handler = new ApiExceptionHandler();
|
||||||
|
|
||||||
|
/** Занятая очередь — 503 с подсказкой «повторите», текст — контракт. */
|
||||||
|
@Test
|
||||||
|
void rejected_returns503WithRetryHint() {
|
||||||
|
var response = handler.rejected(new ConversionRejectedException());
|
||||||
|
assertEquals(HttpStatus.SERVICE_UNAVAILABLE, response.getStatusCode());
|
||||||
|
assertEquals("Сервис конвертации занят — повторите позже",
|
||||||
|
response.getBody().error());
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Превышение wordpdf.convert-timeout — 504 с длительностью лимита. */
|
||||||
|
@Test
|
||||||
|
void timeout_returns504WithLimitSeconds() {
|
||||||
|
var response = handler.timeout(new ConversionTimeoutException(Duration.ofSeconds(120)));
|
||||||
|
assertEquals(HttpStatus.GATEWAY_TIMEOUT, response.getStatusCode());
|
||||||
|
assertEquals("Конвертация превысила 120 с — документ слишком сложный",
|
||||||
|
response.getBody().error());
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Контейнерный потолок multipart — 413 со своим текстом (не 400 ядра). */
|
||||||
|
@Test
|
||||||
|
void tooLarge_returns413ContainerLimit() {
|
||||||
|
var response = handler.tooLarge(new MaxUploadSizeExceededException(100L * 1024 * 1024));
|
||||||
|
assertEquals(HttpStatus.PAYLOAD_TOO_LARGE, response.getStatusCode());
|
||||||
|
assertEquals("Файл больше 100 МБ", response.getBody().error());
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Прочее исключение — 500 с общим текстом; подробность причины — только в лог. */
|
||||||
|
@Test
|
||||||
|
void unexpected_returns500WithoutDetails() {
|
||||||
|
var response = handler.unexpected(new IllegalStateException("секретная подробность"));
|
||||||
|
assertEquals(HttpStatus.INTERNAL_SERVER_ERROR, response.getStatusCode());
|
||||||
|
assertEquals("Внутренняя ошибка конвертации", response.getBody().error());
|
||||||
|
assertFalse(response.getBody().error().contains("секретная"),
|
||||||
|
"подробность исключения утекла в ответ");
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,144 @@
|
|||||||
|
package ru.pjandro.wordpdf.app;
|
||||||
|
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
import ru.pjandro.wordpdf.ConvertOptions;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.io.InputStream;
|
||||||
|
import java.lang.reflect.Field;
|
||||||
|
import java.nio.charset.StandardCharsets;
|
||||||
|
import java.time.Duration;
|
||||||
|
import java.util.ArrayList;
|
||||||
|
import java.util.List;
|
||||||
|
import java.util.concurrent.CountDownLatch;
|
||||||
|
import java.util.concurrent.Future;
|
||||||
|
import java.util.concurrent.ThreadPoolExecutor;
|
||||||
|
import java.util.concurrent.TimeUnit;
|
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertEquals;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertSame;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertThrows;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertTrue;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Юниты {@link ConversionService} вне Spring и HTTP: ветки отказa очереди
|
||||||
|
* ({@link ConversionRejectedException}), прерывания ожидающего потока,
|
||||||
|
* фолбэка санитизации имени. Сквозные успех/400/500 — в
|
||||||
|
* {@code ConvertControllerTest}, таймаут 504 — в {@code ConversionTimeoutTest}.
|
||||||
|
*/
|
||||||
|
class ConversionServiceTest {
|
||||||
|
|
||||||
|
/** Инспекция приватного executor'а: детерминированная сатурация очереди. */
|
||||||
|
private static ThreadPoolExecutor workersOf(ConversionService svc) throws Exception {
|
||||||
|
Field f = ConversionService.class.getDeclaredField("workers");
|
||||||
|
f.setAccessible(true);
|
||||||
|
return (ThreadPoolExecutor) f.get(svc);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Байты фикстуры из classpath (test-jar core: samples/…). */
|
||||||
|
private static byte[] bytes(String resource) throws IOException {
|
||||||
|
try (InputStream in = ConversionServiceTest.class.getResourceAsStream(resource)) {
|
||||||
|
assertTrue(in != null, "Нет ресурса: " + resource);
|
||||||
|
return in.readAllBytes();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Очередь забита (1 воркер занят + QUEUE_CAPACITY в ожидании) — новый
|
||||||
|
* запрос отвергается сразу, не становясь 17-м в очереди: 503-контракт
|
||||||
|
* {@code RejectedExecutionException → ConversionRejectedException}.
|
||||||
|
*/
|
||||||
|
@Test
|
||||||
|
void saturatedQueue_rejectsImmediately() throws Exception {
|
||||||
|
ConversionService svc = new ConversionService(Duration.ofMinutes(2));
|
||||||
|
ThreadPoolExecutor workers = workersOf(svc);
|
||||||
|
CountDownLatch block = new CountDownLatch(1);
|
||||||
|
List<Future<?>> fillers = new ArrayList<>();
|
||||||
|
try {
|
||||||
|
// заглушки-блокировки вместо реальных конвертаций: воркер занят,
|
||||||
|
// очередь полна, ни одной лишней конвертации в JVM
|
||||||
|
for (int i = 0; i <= ConversionService.QUEUE_CAPACITY; i++) {
|
||||||
|
fillers.add(workers.submit(() -> {
|
||||||
|
block.await();
|
||||||
|
return null;
|
||||||
|
}));
|
||||||
|
}
|
||||||
|
long deadline = System.nanoTime() + 5_000_000_000L;
|
||||||
|
while ((workers.getActiveCount() < 1
|
||||||
|
|| workers.getQueue().size() < ConversionService.QUEUE_CAPACITY)
|
||||||
|
&& System.nanoTime() < deadline) {
|
||||||
|
Thread.sleep(5);
|
||||||
|
}
|
||||||
|
assertEquals(1, workers.getActiveCount(), "воркер не занят");
|
||||||
|
assertEquals(ConversionService.QUEUE_CAPACITY, workers.getQueue().size(),
|
||||||
|
"очередь не полна");
|
||||||
|
|
||||||
|
byte[] sample = bytes("/samples/ru-plain.docx");
|
||||||
|
ConversionRejectedException e = assertThrows(ConversionRejectedException.class,
|
||||||
|
() -> svc.convert(sample, "queue.docx", ConvertOptions.defaults()));
|
||||||
|
assertEquals("Сервис конвертации занят — повторите позже", e.getMessage());
|
||||||
|
} finally {
|
||||||
|
block.countDown();
|
||||||
|
for (Future<?> f : fillers) {
|
||||||
|
f.get(10, TimeUnit.SECONDS);
|
||||||
|
}
|
||||||
|
svc.shutdown();
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Поток ожидания прерван — {@code future.get} бросает
|
||||||
|
* {@code InterruptedException}: флаг прерывания восстанавливается, задача
|
||||||
|
* отменяется, ответ — тот же 503-контракт занятости.
|
||||||
|
*/
|
||||||
|
@Test
|
||||||
|
void interruptedWaiter_rejectsAndRestoresFlag() throws Exception {
|
||||||
|
ConversionService svc = new ConversionService(Duration.ofMinutes(2));
|
||||||
|
byte[] sample = bytes("/samples/ru-plain.docx");
|
||||||
|
try {
|
||||||
|
Thread.currentThread().interrupt();
|
||||||
|
ConversionRejectedException e = assertThrows(ConversionRejectedException.class,
|
||||||
|
() -> svc.convert(sample, "ru-plain.docx", ConvertOptions.defaults()));
|
||||||
|
assertEquals("Сервис конвертации занят — повторите позже", e.getMessage());
|
||||||
|
assertTrue(Thread.currentThread().isInterrupted(),
|
||||||
|
"флаг прерывания обязан быть восстановлен");
|
||||||
|
} finally {
|
||||||
|
Thread.interrupted(); // не травим subsequent-тесты surefire-потока
|
||||||
|
}
|
||||||
|
// барьер: отменённая задача ещё домучивает рендер на воркере, а
|
||||||
|
// глобальный реестр шрифтов ядра не потокобезопасен — ждём освобождения
|
||||||
|
// воркера через успешную сериализованную конвертацию
|
||||||
|
byte[] pdf = svc.convert(sample, "barrier.docx", ConvertOptions.defaults());
|
||||||
|
assertEquals("%PDF", new String(pdf, 0, 4, StandardCharsets.US_ASCII));
|
||||||
|
svc.shutdown();
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Пустое после очистки имя (и {@code null}) — фолбэк {@code document}. */
|
||||||
|
@Test
|
||||||
|
void safeBaseName_blankAfterSanitize_fallsBackToDocument() {
|
||||||
|
assertEquals("document", ConversionService.safeBaseName(null));
|
||||||
|
assertEquals("document", ConversionService.safeBaseName(" "));
|
||||||
|
assertEquals("document", ConversionService.safeBaseName("###.docx"));
|
||||||
|
assertEquals("document", ConversionService.safeBaseName("!!!"));
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Каталог (оба разделителя) и суффикс .docx вырезаются, кириллица живёт. */
|
||||||
|
@Test
|
||||||
|
void safeBaseName_stripsDirectoryAndSuffix() {
|
||||||
|
assertEquals("evil", ConversionService.safeBaseName("a/../../evil.docx"));
|
||||||
|
assertEquals("evil", ConversionService.safeBaseName("C:\\tmp\\evil.docx"));
|
||||||
|
assertEquals("отчёт", ConversionService.safeBaseName("отчёт.DOCX"));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Оборачиваемый отказ воркера: single-arg конструктор даёт единый
|
||||||
|
* пользовательский текст 500 без подробностей причины (они — в логе).
|
||||||
|
*/
|
||||||
|
@Test
|
||||||
|
void failedException_singleArg_genericMessageWithCause() {
|
||||||
|
Throwable cause = new IllegalStateException("подробность воркера");
|
||||||
|
ConversionFailedException e = new ConversionFailedException(cause);
|
||||||
|
assertEquals("Внутренняя ошибка конвертации", e.getMessage());
|
||||||
|
assertSame(cause, e.getCause());
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,91 @@
|
|||||||
|
package ru.pjandro.wordpdf.app;
|
||||||
|
|
||||||
|
import org.junit.jupiter.api.AfterEach;
|
||||||
|
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.MediaType;
|
||||||
|
import org.springframework.mock.web.MockMultipartFile;
|
||||||
|
import org.springframework.test.context.TestPropertySource;
|
||||||
|
import org.springframework.test.web.servlet.MockMvc;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
import java.io.InputStream;
|
||||||
|
import java.lang.reflect.Field;
|
||||||
|
import java.util.concurrent.ThreadPoolExecutor;
|
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertNotNull;
|
||||||
|
import static org.springframework.test.web.servlet.request.MockMvcRequestBuilders.multipart;
|
||||||
|
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath;
|
||||||
|
import static org.springframework.test.web.servlet.result.MockMvcResultMatchers.status;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Таймаут конвертации сквозь HTTP: отдельный контекст с
|
||||||
|
* {@code wordpdf.convert-timeout=1ms} — конвертация заведомо дольше
|
||||||
|
* (docx4j + FOP — сотни миллисекунд), значит ответ обязан быть 504 с
|
||||||
|
* текстом {@link ConversionTimeoutException}, а не зависание и не 500.
|
||||||
|
* Отдельный класс: {@code @TestPropertySource} даёт отдельный контекст,
|
||||||
|
* а 1 мс в общем контексте сломала бы все успех-тесты.
|
||||||
|
*/
|
||||||
|
@SpringBootTest
|
||||||
|
@AutoConfigureMockMvc
|
||||||
|
@TestPropertySource(properties = "wordpdf.convert-timeout=1ms")
|
||||||
|
class ConversionTimeoutTest {
|
||||||
|
|
||||||
|
private static final MediaType DOCX =
|
||||||
|
MediaType.parseMediaType("application/vnd.openxmlformats-officedocument.wordprocessingml.document");
|
||||||
|
|
||||||
|
@Autowired
|
||||||
|
private MockMvc mockMvc;
|
||||||
|
|
||||||
|
@Autowired
|
||||||
|
private ConversionService conversionService;
|
||||||
|
|
||||||
|
private static byte[] bytes(String resource) throws IOException {
|
||||||
|
try (InputStream in = ConversionTimeoutTest.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);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void conversionOverrunsTimeout_returns504() throws Exception {
|
||||||
|
byte[] sample = bytes("/samples/ru-plain.docx");
|
||||||
|
mockMvc.perform(multipart("/api/v1/convert")
|
||||||
|
.file(docx("ru-plain.docx", sample)))
|
||||||
|
.andExpect(status().isGatewayTimeout())
|
||||||
|
.andExpect(jsonPath("$.error",
|
||||||
|
org.hamcrest.Matchers.containsString("превысила")));
|
||||||
|
// воркер ещё домучивает отменённый рендер — второй запрос ждёт в
|
||||||
|
// очереди заведомо дольше 1 мс и тоже получает 504, а не 503:
|
||||||
|
// очередь при этом не переполнена
|
||||||
|
mockMvc.perform(multipart("/api/v1/convert")
|
||||||
|
.file(docx("ru-plain.docx", sample)))
|
||||||
|
.andExpect(status().isGatewayTimeout())
|
||||||
|
.andExpect(jsonPath("$.error",
|
||||||
|
org.hamcrest.Matchers.containsString("превысила")));
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Отменённая по таймауту задача продолжает рендерить на воркере
|
||||||
|
* (осознанный компромисс {@link ConversionService}) и мутирует глобальный
|
||||||
|
* реестр шрифтов ядра — дожидаться освобождения executor'я обязательно,
|
||||||
|
* иначе фоновый рендер гонит гонку с другими тест-классами JVM.
|
||||||
|
*/
|
||||||
|
@AfterEach
|
||||||
|
void drainWorker() throws Exception {
|
||||||
|
Field f = ConversionService.class.getDeclaredField("workers");
|
||||||
|
f.setAccessible(true);
|
||||||
|
ThreadPoolExecutor workers = (ThreadPoolExecutor) f.get(conversionService);
|
||||||
|
long deadline = System.nanoTime() + 60_000_000_000L;
|
||||||
|
while ((workers.getActiveCount() > 0 || !workers.getQueue().isEmpty())
|
||||||
|
&& System.nanoTime() < deadline) {
|
||||||
|
Thread.sleep(20);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -15,6 +15,7 @@ import org.springframework.http.MediaType;
|
|||||||
import org.springframework.mock.web.MockMultipartFile;
|
import org.springframework.mock.web.MockMultipartFile;
|
||||||
import org.springframework.test.web.servlet.MockMvc;
|
import org.springframework.test.web.servlet.MockMvc;
|
||||||
import org.springframework.test.web.servlet.MvcResult;
|
import org.springframework.test.web.servlet.MvcResult;
|
||||||
|
import ru.pjandro.wordpdf.ValidationException;
|
||||||
|
|
||||||
import java.io.ByteArrayOutputStream;
|
import java.io.ByteArrayOutputStream;
|
||||||
import java.io.IOException;
|
import java.io.IOException;
|
||||||
@@ -400,4 +401,25 @@ class ConvertControllerTest {
|
|||||||
.andExpect(jsonPath("$.error",
|
.andExpect(jsonPath("$.error",
|
||||||
org.hamcrest.Matchers.containsString("Не найдено")));
|
org.hamcrest.Matchers.containsString("Не найдено")));
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Отказ чтения партиты контейнером ({@code IOException} из
|
||||||
|
* {@code getBytes}) — {@link ValidationException} (400-смысл: вход не
|
||||||
|
* прочитан), а не 500 от catch-all.
|
||||||
|
*/
|
||||||
|
@Test
|
||||||
|
void unreadableUpload_rejected() {
|
||||||
|
MockMultipartFile broken = new MockMultipartFile(
|
||||||
|
"file", "x.docx", DOCX.toString(), "junk".getBytes(StandardCharsets.UTF_8)) {
|
||||||
|
@Override
|
||||||
|
public byte[] getBytes() throws IOException {
|
||||||
|
throw new IOException("поток загрузки оборвался");
|
||||||
|
}
|
||||||
|
};
|
||||||
|
ConvertController controller =
|
||||||
|
new ConvertController(new ConversionService(Duration.ofSeconds(5)), 5L, 100);
|
||||||
|
ValidationException e = assertThrows(ValidationException.class,
|
||||||
|
() -> controller.convert(broken, null, null, null));
|
||||||
|
assertTrue(e.getMessage().contains("Не удалось прочитать"), e.getMessage());
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -1,17 +1,71 @@
|
|||||||
package ru.pjandro.wordpdf.internal.chart;
|
package ru.pjandro.wordpdf.internal.chart;
|
||||||
|
|
||||||
|
import org.docx4j.dml.CTLineProperties;
|
||||||
|
import org.docx4j.dml.CTNoFillProperties;
|
||||||
|
import org.docx4j.dml.CTRegularTextRun;
|
||||||
|
import org.docx4j.dml.CTShapeProperties;
|
||||||
|
import org.docx4j.dml.CTSolidColorFillProperties;
|
||||||
|
import org.docx4j.dml.CTSRgbColor;
|
||||||
|
import org.docx4j.dml.CTTextBody;
|
||||||
|
import org.docx4j.dml.CTTextParagraph;
|
||||||
|
import org.docx4j.dml.chart.CTAreaChart;
|
||||||
|
import org.docx4j.dml.chart.CTAreaSer;
|
||||||
|
import org.docx4j.dml.chart.CTAxDataSource;
|
||||||
|
import org.docx4j.dml.chart.CTAxPos;
|
||||||
|
import org.docx4j.dml.chart.CTAxisUnit;
|
||||||
|
import org.docx4j.dml.chart.CTBandFmt;
|
||||||
|
import org.docx4j.dml.chart.CTBandFmts;
|
||||||
import org.docx4j.dml.chart.CTBarChart;
|
import org.docx4j.dml.chart.CTBarChart;
|
||||||
|
import org.docx4j.dml.chart.CTBarDir;
|
||||||
|
import org.docx4j.dml.chart.CTBarSer;
|
||||||
import org.docx4j.dml.chart.CTBoolean;
|
import org.docx4j.dml.chart.CTBoolean;
|
||||||
import org.docx4j.dml.chart.CTChart;
|
import org.docx4j.dml.chart.CTChart;
|
||||||
|
import org.docx4j.dml.chart.CTChartLines;
|
||||||
|
import org.docx4j.dml.chart.CTChartSpace;
|
||||||
|
import org.docx4j.dml.chart.CTDPt;
|
||||||
|
import org.docx4j.dml.chart.CTDateAx;
|
||||||
|
import org.docx4j.dml.chart.CTDepthPercent;
|
||||||
|
import org.docx4j.dml.chart.CTDouble;
|
||||||
import org.docx4j.dml.chart.CTDoughnutChart;
|
import org.docx4j.dml.chart.CTDoughnutChart;
|
||||||
import org.docx4j.dml.chart.CTFirstSliceAng;
|
import org.docx4j.dml.chart.CTFirstSliceAng;
|
||||||
import org.docx4j.dml.chart.CTGapAmount;
|
import org.docx4j.dml.chart.CTGapAmount;
|
||||||
import org.docx4j.dml.chart.CTHoleSize;
|
import org.docx4j.dml.chart.CTHoleSize;
|
||||||
|
import org.docx4j.dml.chart.CTLegend;
|
||||||
|
import org.docx4j.dml.chart.CTLegendPos;
|
||||||
|
import org.docx4j.dml.chart.CTLineChart;
|
||||||
|
import org.docx4j.dml.chart.CTLineSer;
|
||||||
|
import org.docx4j.dml.chart.CTMarker;
|
||||||
|
import org.docx4j.dml.chart.CTMarkerStyle;
|
||||||
|
import org.docx4j.dml.chart.CTNumData;
|
||||||
|
import org.docx4j.dml.chart.CTNumDataSource;
|
||||||
|
import org.docx4j.dml.chart.CTNumFmt;
|
||||||
|
import org.docx4j.dml.chart.CTNumRef;
|
||||||
|
import org.docx4j.dml.chart.CTNumVal;
|
||||||
import org.docx4j.dml.chart.CTOverlap;
|
import org.docx4j.dml.chart.CTOverlap;
|
||||||
|
import org.docx4j.dml.chart.CTPerspective;
|
||||||
import org.docx4j.dml.chart.CTPieChart;
|
import org.docx4j.dml.chart.CTPieChart;
|
||||||
|
import org.docx4j.dml.chart.CTPieSer;
|
||||||
|
import org.docx4j.dml.chart.CTPlotArea;
|
||||||
|
import org.docx4j.dml.chart.CTRotY;
|
||||||
|
import org.docx4j.dml.chart.CTScaling;
|
||||||
|
import org.docx4j.dml.chart.CTSerAx;
|
||||||
|
import org.docx4j.dml.chart.CTSerTx;
|
||||||
|
import org.docx4j.dml.chart.CTStrData;
|
||||||
|
import org.docx4j.dml.chart.CTStrRef;
|
||||||
|
import org.docx4j.dml.chart.CTStrVal;
|
||||||
|
import org.docx4j.dml.chart.CTSurface3DChart;
|
||||||
import org.docx4j.dml.chart.CTTitle;
|
import org.docx4j.dml.chart.CTTitle;
|
||||||
|
import org.docx4j.dml.chart.CTTx;
|
||||||
|
import org.docx4j.dml.chart.CTUnsignedInt;
|
||||||
|
import org.docx4j.dml.chart.CTValAx;
|
||||||
|
import org.docx4j.dml.chart.CTView3D;
|
||||||
|
import org.docx4j.dml.chart.STAxPos;
|
||||||
|
import org.docx4j.dml.chart.STBarDir;
|
||||||
|
import org.docx4j.dml.chart.STLegendPos;
|
||||||
|
import org.docx4j.dml.chart.STMarkerStyle;
|
||||||
import org.junit.jupiter.api.Test;
|
import org.junit.jupiter.api.Test;
|
||||||
|
|
||||||
|
import java.awt.Color;
|
||||||
import java.util.List;
|
import java.util.List;
|
||||||
|
|
||||||
import static org.junit.jupiter.api.Assertions.*;
|
import static org.junit.jupiter.api.Assertions.*;
|
||||||
@@ -92,11 +146,13 @@ class ChartSpecTest {
|
|||||||
CTHoleSize hole = new CTHoleSize();
|
CTHoleSize hole = new CTHoleSize();
|
||||||
hole.setVal((short) 75);
|
hole.setVal((short) 75);
|
||||||
chart.setHoleSize(hole);
|
chart.setHoleSize(hole);
|
||||||
|
chart.getSer().add(new CTPieSer());
|
||||||
ChartSpec spec = new ChartSpec();
|
ChartSpec spec = new ChartSpec();
|
||||||
ChartSpec.readGroup(chart, spec, new DrawMlColor(null), List.of());
|
ChartSpec.readGroup(chart, spec, new DrawMlColor(null), List.of());
|
||||||
assertEquals(ChartSpec.Type.DOUGHNUT, spec.type);
|
assertEquals(ChartSpec.Type.DOUGHNUT, spec.type);
|
||||||
assertEquals(45, spec.firstSliceAng);
|
assertEquals(45, spec.firstSliceAng);
|
||||||
assertEquals(75, spec.holeSize);
|
assertEquals(75, spec.holeSize);
|
||||||
|
assertEquals(1, spec.series.size());
|
||||||
}
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
@@ -115,6 +171,492 @@ class ChartSpecTest {
|
|||||||
assertEquals(0, bar.overlap);
|
assertEquals(0, bar.overlap);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void parseWithoutChartStaysUnsupported() {
|
||||||
|
ChartSpec spec = ChartSpec.parse(new CTChartSpace(), new DrawMlColor(null));
|
||||||
|
assertEquals(ChartSpec.Type.UNSUPPORTED, spec.type);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Пустой chartSpace без spPr/legend/title — только дефолты модели. */
|
||||||
|
@Test
|
||||||
|
void bareChartKeepsDefaults() {
|
||||||
|
ChartSpec spec = ChartSpec.parse(spaceWith(new CTChart()), new DrawMlColor(null));
|
||||||
|
assertEquals(Color.WHITE, spec.chartFill);
|
||||||
|
assertNull(spec.legendPos, "без c:legend легенды нет");
|
||||||
|
assertNull(spec.title);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void chartFrameFillAndBorderParsed() {
|
||||||
|
CTChartSpace space = spaceWith(new CTChart());
|
||||||
|
CTShapeProperties sp = new CTShapeProperties();
|
||||||
|
sp.setSolidFill(fill("FFEEEE"));
|
||||||
|
CTLineProperties ln = new CTLineProperties();
|
||||||
|
ln.setSolidFill(fill("EE0000"));
|
||||||
|
ln.setW(25400);
|
||||||
|
sp.setLn(ln);
|
||||||
|
space.setSpPr(sp);
|
||||||
|
ChartSpec spec = ChartSpec.parse(space, new DrawMlColor(null));
|
||||||
|
assertEquals(new Color(0xFF, 0xEE, 0xEE), spec.chartFill);
|
||||||
|
assertEquals(new Color(0xEE, 0, 0), spec.chartBorder);
|
||||||
|
assertEquals(2.0, spec.chartBorderWidth, 0.001);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void chartFrameBorderNoFillClearsBorder() {
|
||||||
|
CTChartSpace space = spaceWith(new CTChart());
|
||||||
|
CTShapeProperties sp = new CTShapeProperties();
|
||||||
|
CTLineProperties ln = new CTLineProperties();
|
||||||
|
ln.setNoFill(new CTNoFillProperties());
|
||||||
|
sp.setLn(ln);
|
||||||
|
space.setSpPr(sp);
|
||||||
|
ChartSpec spec = ChartSpec.parse(space, new DrawMlColor(null));
|
||||||
|
assertNull(spec.chartBorder);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void view3DPerspectiveAndNegativeRotY() {
|
||||||
|
CTChart chart = new CTChart();
|
||||||
|
CTView3D v = new CTView3D();
|
||||||
|
CTRotY ry = new CTRotY();
|
||||||
|
ry.setVal(-45);
|
||||||
|
CTPerspective p = new CTPerspective();
|
||||||
|
p.setVal((short) 45);
|
||||||
|
CTDepthPercent d = new CTDepthPercent();
|
||||||
|
d.setVal(80);
|
||||||
|
CTBoolean ra = new CTBoolean();
|
||||||
|
ra.setVal(Boolean.FALSE);
|
||||||
|
v.setRotY(ry);
|
||||||
|
v.setPerspective(p);
|
||||||
|
v.setDepthPercent(d);
|
||||||
|
v.setRAngAx(ra);
|
||||||
|
chart.setView3D(v);
|
||||||
|
ChartSpec spec = ChartSpec.parse(spaceWith(chart), new DrawMlColor(null));
|
||||||
|
assertEquals(315, spec.rotY);
|
||||||
|
assertEquals(45, spec.perspective);
|
||||||
|
assertEquals(80, spec.depthPercent);
|
||||||
|
assertFalse(spec.rightAngledAxes);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void horizontalBarDirectionParsed() {
|
||||||
|
CTBarChart bar = new CTBarChart();
|
||||||
|
CTBarDir dir = new CTBarDir();
|
||||||
|
dir.setVal(STBarDir.BAR);
|
||||||
|
bar.setBarDir(dir);
|
||||||
|
ChartSpec spec = new ChartSpec();
|
||||||
|
ChartSpec.readGroup(bar, spec, new DrawMlColor(null), List.of());
|
||||||
|
assertEquals(ChartSpec.Type.BAR_HORIZONTAL, spec.type);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** c:val с дырявыми c:pt и ptCount больше числа точек — дыры dobиваются null. */
|
||||||
|
@Test
|
||||||
|
void barSeriesSparseValuesPadded() {
|
||||||
|
CTBarChart bar = new CTBarChart();
|
||||||
|
CTBarSer ser = new CTBarSer();
|
||||||
|
CTSerTx tx = new CTSerTx();
|
||||||
|
tx.setStrRef(strRef("Продажи"));
|
||||||
|
ser.setTx(tx);
|
||||||
|
ser.setCat(catStr("Q1", "Q2"));
|
||||||
|
CTNumDataSource val = new CTNumDataSource();
|
||||||
|
CTNumRef numRef = new CTNumRef();
|
||||||
|
CTNumData cache = new CTNumData();
|
||||||
|
cache.setPtCount(uint(4));
|
||||||
|
cache.getPt().add(numPt(0, "1.0"));
|
||||||
|
cache.getPt().add(numPt(2, "abc"));
|
||||||
|
numRef.setNumCache(cache);
|
||||||
|
val.setNumRef(numRef);
|
||||||
|
ser.setVal(val);
|
||||||
|
CTShapeProperties sp = new CTShapeProperties();
|
||||||
|
sp.setSolidFill(fill("00FF00"));
|
||||||
|
ser.setSpPr(sp);
|
||||||
|
bar.getSer().add(ser);
|
||||||
|
ChartSpec spec = new ChartSpec();
|
||||||
|
ChartSpec.readGroup(bar, spec, new DrawMlColor(null), List.of());
|
||||||
|
ChartSpec.Series s = spec.series.get(0);
|
||||||
|
assertEquals("Продажи", s.name);
|
||||||
|
assertEquals(List.of("Q1", "Q2"), s.categories);
|
||||||
|
assertEquals(4, s.values.size());
|
||||||
|
assertEquals(1.0, s.values.get(0));
|
||||||
|
assertNull(s.values.get(1));
|
||||||
|
assertNull(s.values.get(2), "не-число — null, не падение");
|
||||||
|
assertNull(s.values.get(3));
|
||||||
|
assertEquals(new Color(0, 0xFF, 0), s.fill);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void areaSeriesFillAndLinePropsParsed() {
|
||||||
|
CTAreaChart area = new CTAreaChart();
|
||||||
|
CTAreaSer ser = new CTAreaSer();
|
||||||
|
CTShapeProperties sp = new CTShapeProperties();
|
||||||
|
sp.setSolidFill(fill("0000FF"));
|
||||||
|
CTLineProperties ln = new CTLineProperties();
|
||||||
|
ln.setSolidFill(fill("FF0000"));
|
||||||
|
ln.setW(12700);
|
||||||
|
sp.setLn(ln);
|
||||||
|
ser.setSpPr(sp);
|
||||||
|
area.getSer().add(ser);
|
||||||
|
CTAreaSer noSpPr = new CTAreaSer();
|
||||||
|
CTAreaSer fillOnly = new CTAreaSer();
|
||||||
|
CTShapeProperties fillSp = new CTShapeProperties();
|
||||||
|
fillSp.setSolidFill(fill("000001"));
|
||||||
|
fillOnly.setSpPr(fillSp);
|
||||||
|
area.getSer().add(noSpPr);
|
||||||
|
area.getSer().add(fillOnly);
|
||||||
|
ChartSpec spec = new ChartSpec();
|
||||||
|
ChartSpec.readGroup(area, spec, new DrawMlColor(null), List.of());
|
||||||
|
assertEquals(ChartSpec.Type.AREA, spec.type);
|
||||||
|
ChartSpec.Series s = spec.series.get(0);
|
||||||
|
assertNull(s.name, "c:tx без c:v и без strRef — имени нет");
|
||||||
|
assertEquals(new Color(0, 0, 0xFF), s.fill);
|
||||||
|
assertEquals(new Color(0xFF, 0, 0), s.lineColor);
|
||||||
|
assertEquals(1.0, s.lineWidth, 0.001);
|
||||||
|
assertNull(spec.series.get(1).lineColor, "spPr=null — линия не задана");
|
||||||
|
assertNull(spec.series.get(2).lineColor, "spPr без a:ln — линия не задана");
|
||||||
|
}
|
||||||
|
|
||||||
|
/** c:tx/c:v, пустой c:tx, дырявые строковые categories, пустое c:v. */
|
||||||
|
@Test
|
||||||
|
void seriesNameVariantsAndSparseCategories() {
|
||||||
|
CTBarChart bar = new CTBarChart();
|
||||||
|
CTBarSer withV = new CTBarSer();
|
||||||
|
CTSerTx txV = new CTSerTx();
|
||||||
|
txV.setV("Ряд1");
|
||||||
|
withV.setTx(txV);
|
||||||
|
CTAxDataSource cat = new CTAxDataSource();
|
||||||
|
CTStrRef strRef = new CTStrRef();
|
||||||
|
CTStrData cache = new CTStrData();
|
||||||
|
CTStrVal pt = new CTStrVal();
|
||||||
|
pt.setIdx(2);
|
||||||
|
pt.setV("Март");
|
||||||
|
cache.getPt().add(pt);
|
||||||
|
strRef.setStrCache(cache);
|
||||||
|
cat.setStrRef(strRef);
|
||||||
|
withV.setCat(cat);
|
||||||
|
CTBarSer emptyTx = new CTBarSer();
|
||||||
|
emptyTx.setTx(new CTSerTx());
|
||||||
|
CTBarSer blankVal = new CTBarSer();
|
||||||
|
CTNumDataSource val = new CTNumDataSource();
|
||||||
|
CTNumData lit = new CTNumData();
|
||||||
|
lit.getPt().add(numPt(0, " "));
|
||||||
|
val.setNumLit(lit);
|
||||||
|
blankVal.setVal(val);
|
||||||
|
bar.getSer().add(withV);
|
||||||
|
bar.getSer().add(emptyTx);
|
||||||
|
bar.getSer().add(blankVal);
|
||||||
|
ChartSpec spec = new ChartSpec();
|
||||||
|
ChartSpec.readGroup(bar, spec, new DrawMlColor(null), List.of());
|
||||||
|
assertEquals("Ряд1", spec.series.get(0).name);
|
||||||
|
assertEquals(List.of("", "", "Март"), spec.series.get(0).categories);
|
||||||
|
assertNull(spec.series.get(1).name);
|
||||||
|
assertEquals(1, spec.series.get(2).values.size());
|
||||||
|
assertNull(spec.series.get(2).values.get(0), "пустое значение — null");
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void lineSeriesNoFillAndMarkerNone() {
|
||||||
|
CTLineChart line = new CTLineChart();
|
||||||
|
CTLineSer ser = new CTLineSer();
|
||||||
|
CTShapeProperties sp = new CTShapeProperties();
|
||||||
|
CTLineProperties ln = new CTLineProperties();
|
||||||
|
ln.setNoFill(new CTNoFillProperties());
|
||||||
|
sp.setLn(ln);
|
||||||
|
ser.setSpPr(sp);
|
||||||
|
CTMarker m = new CTMarker();
|
||||||
|
CTMarkerStyle sym = new CTMarkerStyle();
|
||||||
|
sym.setVal(STMarkerStyle.NONE);
|
||||||
|
m.setSymbol(sym);
|
||||||
|
ser.setMarker(m);
|
||||||
|
line.getSer().add(ser);
|
||||||
|
ChartSpec spec = new ChartSpec();
|
||||||
|
ChartSpec.readGroup(line, spec, new DrawMlColor(null), List.of());
|
||||||
|
assertTrue(spec.series.get(0).lineNoFill);
|
||||||
|
assertFalse(spec.series.get(0).marker);
|
||||||
|
assertEquals("none", spec.series.get(0).markerSymbol);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void pieSeriesOutlineParsed() {
|
||||||
|
CTPieChart pie = new CTPieChart();
|
||||||
|
CTPieSer ser = new CTPieSer();
|
||||||
|
CTShapeProperties sp = new CTShapeProperties();
|
||||||
|
sp.setSolidFill(fill("112233"));
|
||||||
|
CTLineProperties ln = new CTLineProperties();
|
||||||
|
ln.setSolidFill(fill("445566"));
|
||||||
|
ln.setW(12700);
|
||||||
|
sp.setLn(ln);
|
||||||
|
ser.setSpPr(sp);
|
||||||
|
pie.getSer().add(ser);
|
||||||
|
ChartSpec spec = new ChartSpec();
|
||||||
|
ChartSpec.readGroup(pie, spec, new DrawMlColor(null), List.of());
|
||||||
|
ChartSpec.Series s = spec.series.get(0);
|
||||||
|
assertEquals(new Color(0x11, 0x22, 0x33), s.fill);
|
||||||
|
assertEquals(new Color(0x44, 0x55, 0x66), s.outlineColor);
|
||||||
|
assertEquals(1.0, s.outlineWidth, 0.001);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void pieSeriesOutlineNoFill() {
|
||||||
|
CTPieChart pie = new CTPieChart();
|
||||||
|
CTPieSer ser = new CTPieSer();
|
||||||
|
CTShapeProperties sp = new CTShapeProperties();
|
||||||
|
CTLineProperties ln = new CTLineProperties();
|
||||||
|
ln.setNoFill(new CTNoFillProperties());
|
||||||
|
sp.setLn(ln);
|
||||||
|
ser.setSpPr(sp);
|
||||||
|
pie.getSer().add(ser);
|
||||||
|
ChartSpec spec = new ChartSpec();
|
||||||
|
ChartSpec.readGroup(pie, spec, new DrawMlColor(null), List.of());
|
||||||
|
assertTrue(spec.series.get(0).outlineNoFill);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** c:bandFmt без своего цвета — цвет из палитры по c:idx. */
|
||||||
|
@Test
|
||||||
|
void surfaceBandFmtsExplicitAndPalette() {
|
||||||
|
CTSurface3DChart surf = new CTSurface3DChart();
|
||||||
|
CTBoolean wf = new CTBoolean();
|
||||||
|
wf.setVal(Boolean.TRUE);
|
||||||
|
surf.setWireframe(wf);
|
||||||
|
CTBandFmts fmts = new CTBandFmts();
|
||||||
|
CTBandFmt withColor = new CTBandFmt();
|
||||||
|
withColor.setIdx(uint(0));
|
||||||
|
CTShapeProperties sp = new CTShapeProperties();
|
||||||
|
sp.setSolidFill(fill("ABCDEF"));
|
||||||
|
withColor.setSpPr(sp);
|
||||||
|
CTBandFmt fallback = new CTBandFmt();
|
||||||
|
fallback.setIdx(uint(1));
|
||||||
|
fmts.getBandFmt().add(withColor);
|
||||||
|
fmts.getBandFmt().add(fallback);
|
||||||
|
surf.setBandFmts(fmts);
|
||||||
|
ChartSpec spec = new ChartSpec();
|
||||||
|
ChartSpec.readGroup(surf, spec, new DrawMlColor(null),
|
||||||
|
List.of(Color.RED, Color.GREEN, Color.BLUE));
|
||||||
|
assertTrue(spec.wireframe);
|
||||||
|
assertEquals(List.of(new Color(0xAB, 0xCD, 0xEF), Color.GREEN), spec.bandColors);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** c:dPt без c:spPr/c:solidFill пропускается, валидная точка получает цвет. */
|
||||||
|
@Test
|
||||||
|
void dataPointFillAppliedAndIncompleteSkipped() {
|
||||||
|
CTPieChart pie = new CTPieChart();
|
||||||
|
CTPieSer ser = new CTPieSer();
|
||||||
|
CTDPt good = new CTDPt();
|
||||||
|
good.setIdx(uint(1));
|
||||||
|
CTShapeProperties sp = new CTShapeProperties();
|
||||||
|
sp.setSolidFill(fill("FF00FF"));
|
||||||
|
good.setSpPr(sp);
|
||||||
|
CTDPt noFill = new CTDPt();
|
||||||
|
noFill.setIdx(uint(2));
|
||||||
|
ser.getDPt().add(good);
|
||||||
|
ser.getDPt().add(noFill);
|
||||||
|
pie.getSer().add(ser);
|
||||||
|
ChartSpec spec = new ChartSpec();
|
||||||
|
ChartSpec.readGroup(pie, spec, new DrawMlColor(null), List.of());
|
||||||
|
assertEquals(new Color(0xFF, 0, 0xFF), spec.series.get(0).pointFills.get(1));
|
||||||
|
assertEquals(1, spec.series.get(0).pointFills.size());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void legendOverlayClearsPosExplicitPosWins() {
|
||||||
|
CTChart chart = new CTChart();
|
||||||
|
CTLegend legend = new CTLegend();
|
||||||
|
CTBoolean overlay = new CTBoolean();
|
||||||
|
overlay.setVal(Boolean.TRUE);
|
||||||
|
legend.setOverlay(overlay);
|
||||||
|
chart.setLegend(legend);
|
||||||
|
ChartSpec spec = ChartSpec.parse(spaceWith(chart), new DrawMlColor(null));
|
||||||
|
assertNull(spec.legendPos, "overlay-легенда не резервирует место");
|
||||||
|
|
||||||
|
CTChart chart2 = new CTChart();
|
||||||
|
CTLegend legend2 = new CTLegend();
|
||||||
|
CTBoolean overlay2 = new CTBoolean();
|
||||||
|
overlay2.setVal(Boolean.TRUE);
|
||||||
|
legend2.setOverlay(overlay2);
|
||||||
|
CTLegendPos pos = new CTLegendPos();
|
||||||
|
pos.setVal(STLegendPos.T);
|
||||||
|
legend2.setLegendPos(pos);
|
||||||
|
chart2.setLegend(legend2);
|
||||||
|
ChartSpec spec2 = ChartSpec.parse(spaceWith(chart2), new DrawMlColor(null));
|
||||||
|
assertEquals("t", spec2.legendPos);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void titleFromStrRefAndRichText() {
|
||||||
|
CTChart chart = new CTChart();
|
||||||
|
CTTitle title = new CTTitle();
|
||||||
|
CTTx tx = new CTTx();
|
||||||
|
tx.setStrRef(strRef("Отчёт"));
|
||||||
|
title.setTx(tx);
|
||||||
|
chart.setTitle(title);
|
||||||
|
ChartSpec spec = new ChartSpec();
|
||||||
|
ChartSpec.readTitle(chart, spec, new DrawMlColor(null));
|
||||||
|
assertEquals("Отчёт", spec.title);
|
||||||
|
|
||||||
|
CTChart chart2 = new CTChart();
|
||||||
|
CTTitle title2 = new CTTitle();
|
||||||
|
CTTx tx2 = new CTTx();
|
||||||
|
CTTextBody rich = new CTTextBody();
|
||||||
|
CTTextParagraph p = new CTTextParagraph();
|
||||||
|
CTRegularTextRun run = new CTRegularTextRun();
|
||||||
|
run.setT("Привет");
|
||||||
|
p.getEGTextRun().add(run);
|
||||||
|
rich.getP().add(p);
|
||||||
|
tx2.setRich(rich);
|
||||||
|
title2.setTx(tx2);
|
||||||
|
chart2.setTitle(title2);
|
||||||
|
ChartSpec spec2 = new ChartSpec();
|
||||||
|
ChartSpec.readTitle(chart2, spec2, new DrawMlColor(null));
|
||||||
|
assertEquals("Привет", spec2.title);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** valAx со scaling/единицами/сеткой/numFmt, dateAx как catAxis, serAx. */
|
||||||
|
@Test
|
||||||
|
void axesParsedIncludingDateAxisFallback() {
|
||||||
|
CTChart chart = new CTChart();
|
||||||
|
CTPlotArea pa = new CTPlotArea();
|
||||||
|
CTValAx val = new CTValAx();
|
||||||
|
CTScaling scaling = new CTScaling();
|
||||||
|
CTDouble min = new CTDouble();
|
||||||
|
min.setVal(-5.0);
|
||||||
|
CTDouble max = new CTDouble();
|
||||||
|
max.setVal(50.0);
|
||||||
|
scaling.setMin(min);
|
||||||
|
scaling.setMax(max);
|
||||||
|
val.setScaling(scaling);
|
||||||
|
CTAxisUnit unit = new CTAxisUnit();
|
||||||
|
unit.setVal(10.0);
|
||||||
|
val.setMajorUnit(unit);
|
||||||
|
CTChartLines grid = new CTChartLines();
|
||||||
|
CTShapeProperties gsp = new CTShapeProperties();
|
||||||
|
CTLineProperties gln = new CTLineProperties();
|
||||||
|
gln.setSolidFill(fill("00FF00"));
|
||||||
|
gsp.setLn(gln);
|
||||||
|
grid.setSpPr(gsp);
|
||||||
|
val.setMajorGridlines(grid);
|
||||||
|
CTNumFmt fmt = new CTNumFmt();
|
||||||
|
fmt.setFormatCode("0.0");
|
||||||
|
val.setNumFmt(fmt);
|
||||||
|
CTBoolean del = new CTBoolean();
|
||||||
|
del.setVal(Boolean.TRUE);
|
||||||
|
val.setDelete(del);
|
||||||
|
CTAxPos pos = new CTAxPos();
|
||||||
|
pos.setVal(STAxPos.R);
|
||||||
|
val.setAxPos(pos);
|
||||||
|
CTShapeProperties asp = new CTShapeProperties();
|
||||||
|
CTLineProperties aln = new CTLineProperties();
|
||||||
|
aln.setNoFill(new CTNoFillProperties());
|
||||||
|
asp.setLn(aln);
|
||||||
|
val.setSpPr(asp);
|
||||||
|
pa.getValAxOrCatAxOrDateAx().add(val);
|
||||||
|
pa.getValAxOrCatAxOrDateAx().add(new CTDateAx());
|
||||||
|
pa.getValAxOrCatAxOrDateAx().add(new CTSerAx());
|
||||||
|
pa.getValAxOrCatAxOrDateAx().add("не-ось");
|
||||||
|
chart.setPlotArea(pa);
|
||||||
|
ChartSpec spec = ChartSpec.parse(spaceWith(chart), new DrawMlColor(null));
|
||||||
|
assertEquals(-5.0, spec.valAxis.min);
|
||||||
|
assertEquals(50.0, spec.valAxis.max);
|
||||||
|
assertEquals(10.0, spec.valAxis.majorUnit);
|
||||||
|
assertTrue(spec.valAxis.gridlines);
|
||||||
|
assertEquals(new Color(0, 0xFF, 0), spec.valAxis.gridColor);
|
||||||
|
assertEquals("0.0", spec.valAxis.numFmt);
|
||||||
|
assertTrue(spec.valAxis.deleted);
|
||||||
|
assertEquals("r", spec.valAxis.pos);
|
||||||
|
assertNull(spec.valAxis.axisLineColor);
|
||||||
|
assertNotNull(spec.catAxis, "c:dateAx становится catAxis");
|
||||||
|
assertEquals("General", spec.catAxis.numFmt);
|
||||||
|
assertNotNull(spec.serAxis);
|
||||||
|
assertEquals("General", spec.serAxis.numFmt);
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void numericCategoriesSparsePadded() {
|
||||||
|
CTBarChart bar = new CTBarChart();
|
||||||
|
CTBarSer ser = new CTBarSer();
|
||||||
|
CTAxDataSource cat = new CTAxDataSource();
|
||||||
|
CTNumRef numRef = new CTNumRef();
|
||||||
|
CTNumData cache = new CTNumData();
|
||||||
|
CTNumVal pt = new CTNumVal();
|
||||||
|
pt.setIdx(2);
|
||||||
|
pt.setV("2024");
|
||||||
|
cache.getPt().add(pt);
|
||||||
|
numRef.setNumCache(cache);
|
||||||
|
cat.setNumRef(numRef);
|
||||||
|
ser.setCat(cat);
|
||||||
|
bar.getSer().add(ser);
|
||||||
|
ChartSpec spec = new ChartSpec();
|
||||||
|
ChartSpec.readGroup(bar, spec, new DrawMlColor(null), List.of());
|
||||||
|
assertEquals(List.of("", "", "2024"), spec.series.get(0).categories);
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Общие categories пустые — берутся из первого ряда. */
|
||||||
|
@Test
|
||||||
|
void categoriesCopiedFromFirstSeries() {
|
||||||
|
CTChart chart = new CTChart();
|
||||||
|
CTPlotArea pa = new CTPlotArea();
|
||||||
|
CTBarChart bar = new CTBarChart();
|
||||||
|
CTBarSer ser = new CTBarSer();
|
||||||
|
ser.setCat(catStr("Я", "Ф", "М"));
|
||||||
|
bar.getSer().add(ser);
|
||||||
|
pa.getAreaChartOrArea3DChartOrLineChart().add(bar);
|
||||||
|
chart.setPlotArea(pa);
|
||||||
|
ChartSpec spec = ChartSpec.parse(spaceWith(chart), new DrawMlColor(null));
|
||||||
|
assertEquals(List.of("Я", "Ф", "М"), spec.categories);
|
||||||
|
}
|
||||||
|
|
||||||
|
private static CTChartSpace spaceWith(CTChart chart) {
|
||||||
|
CTChartSpace space = new CTChartSpace();
|
||||||
|
space.setChart(chart);
|
||||||
|
return space;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static CTSolidColorFillProperties fill(String hex) {
|
||||||
|
CTSolidColorFillProperties f = new CTSolidColorFillProperties();
|
||||||
|
CTSRgbColor s = new CTSRgbColor();
|
||||||
|
s.setVal(hex);
|
||||||
|
f.setSrgbClr(s);
|
||||||
|
return f;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static CTUnsignedInt uint(long v) {
|
||||||
|
CTUnsignedInt u = new CTUnsignedInt();
|
||||||
|
u.setVal(v);
|
||||||
|
return u;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static CTStrRef strRef(String v) {
|
||||||
|
CTStrRef ref = new CTStrRef();
|
||||||
|
CTStrData cache = new CTStrData();
|
||||||
|
CTStrVal pt = new CTStrVal();
|
||||||
|
pt.setIdx(0);
|
||||||
|
pt.setV(v);
|
||||||
|
cache.getPt().add(pt);
|
||||||
|
ref.setStrCache(cache);
|
||||||
|
return ref;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static CTAxDataSource catStr(String... names) {
|
||||||
|
CTAxDataSource cat = new CTAxDataSource();
|
||||||
|
CTStrRef ref = new CTStrRef();
|
||||||
|
CTStrData cache = new CTStrData();
|
||||||
|
for (int i = 0; i < names.length; i++) {
|
||||||
|
CTStrVal pt = new CTStrVal();
|
||||||
|
pt.setIdx(i);
|
||||||
|
pt.setV(names[i]);
|
||||||
|
cache.getPt().add(pt);
|
||||||
|
}
|
||||||
|
ref.setStrCache(cache);
|
||||||
|
cat.setStrRef(ref);
|
||||||
|
return cat;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static CTNumVal numPt(long idx, String v) {
|
||||||
|
CTNumVal pt = new CTNumVal();
|
||||||
|
pt.setIdx(idx);
|
||||||
|
pt.setV(v);
|
||||||
|
return pt;
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
private static CTChart emptyTitleChart() {
|
private static CTChart emptyTitleChart() {
|
||||||
CTChart chart = new CTChart();
|
CTChart chart = new CTChart();
|
||||||
chart.setTitle(new CTTitle());
|
chart.setTitle(new CTTitle());
|
||||||
|
|||||||
@@ -0,0 +1,245 @@
|
|||||||
|
package ru.pjandro.wordpdf.internal.chart;
|
||||||
|
|
||||||
|
import jakarta.xml.bind.JAXBElement;
|
||||||
|
import org.docx4j.dml.BaseStyles;
|
||||||
|
import org.docx4j.dml.CTColor;
|
||||||
|
import org.docx4j.dml.CTColorScheme;
|
||||||
|
import org.docx4j.dml.CTFixedPercentage;
|
||||||
|
import org.docx4j.dml.CTFontReference;
|
||||||
|
import org.docx4j.dml.CTGradientStop;
|
||||||
|
import org.docx4j.dml.CTHslColor;
|
||||||
|
import org.docx4j.dml.CTPercentage;
|
||||||
|
import org.docx4j.dml.CTPositiveFixedAngle;
|
||||||
|
import org.docx4j.dml.CTPositiveFixedPercentage;
|
||||||
|
import org.docx4j.dml.CTPositivePercentage;
|
||||||
|
import org.docx4j.dml.CTScRgbColor;
|
||||||
|
import org.docx4j.dml.CTSchemeColor;
|
||||||
|
import org.docx4j.dml.CTSRgbColor;
|
||||||
|
import org.docx4j.dml.CTSolidColorFillProperties;
|
||||||
|
import org.docx4j.dml.CTSystemColor;
|
||||||
|
import org.docx4j.dml.FontCollection;
|
||||||
|
import org.docx4j.dml.STSchemeColorVal;
|
||||||
|
import org.docx4j.dml.TextFont;
|
||||||
|
import org.docx4j.dml.Theme;
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
|
||||||
|
import javax.xml.namespace.QName;
|
||||||
|
import java.awt.Color;
|
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertEquals;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertNotNull;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertNull;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertTrue;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Палитра DrawingML: тема/дефолтная Office-палитра, базовые цвета
|
||||||
|
* (srgb/scrgb/hsl/sys/scheme) и цепочки трансформаций (lumMod/lumOff/
|
||||||
|
* satMod/satOff/hueMod/hueOff/tint/shade/alpha) со всеми классами
|
||||||
|
* процентных значений; неизвестная трансформация пропускается.
|
||||||
|
*/
|
||||||
|
class DrawMlColorTest {
|
||||||
|
|
||||||
|
private static final String DML_NS = "http://schemas.openxmlformats.org/drawingml/2006/main";
|
||||||
|
private static final Color OFFICE_ACCENT1 = new Color(0x44, 0x72, 0xC4);
|
||||||
|
private static final Color OFFICE_ACCENT2 = new Color(0xED, 0x7D, 0x31);
|
||||||
|
|
||||||
|
private static <T> JAXBElement<T> transform(String kind, Class<T> cls, T value) {
|
||||||
|
return new JAXBElement<>(new QName(DML_NS, kind), cls, value);
|
||||||
|
}
|
||||||
|
|
||||||
|
private static CTSRgbColor srgbColor(String hex) {
|
||||||
|
CTSRgbColor s = new CTSRgbColor();
|
||||||
|
s.setVal(hex);
|
||||||
|
return s;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static CTColor srgb(String hex) {
|
||||||
|
CTColor c = new CTColor();
|
||||||
|
c.setSrgbClr(srgbColor(hex));
|
||||||
|
return c;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static CTColor scheme(STSchemeColorVal val) {
|
||||||
|
CTColor c = new CTColor();
|
||||||
|
CTSchemeColor sc = new CTSchemeColor();
|
||||||
|
sc.setVal(val);
|
||||||
|
c.setSchemeClr(sc);
|
||||||
|
return c;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static CTPositiveFixedPercentage fixedPct(int val) {
|
||||||
|
CTPositiveFixedPercentage p = new CTPositiveFixedPercentage();
|
||||||
|
p.setVal(val);
|
||||||
|
return p;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static CTFixedPercentage fixed(int val) {
|
||||||
|
CTFixedPercentage p = new CTFixedPercentage();
|
||||||
|
p.setVal(val);
|
||||||
|
return p;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static CTPositivePercentage positive(int val) {
|
||||||
|
CTPositivePercentage p = new CTPositivePercentage();
|
||||||
|
p.setVal(val);
|
||||||
|
return p;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static CTPercentage pct(int val) {
|
||||||
|
CTPercentage p = new CTPercentage();
|
||||||
|
p.setVal(val);
|
||||||
|
return p;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static CTPositiveFixedAngle angle(int val) {
|
||||||
|
CTPositiveFixedAngle a = new CTPositiveFixedAngle();
|
||||||
|
a.setVal(val);
|
||||||
|
return a;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void themeColorsAndFontsParsed() {
|
||||||
|
Theme theme = new Theme();
|
||||||
|
BaseStyles el = new BaseStyles();
|
||||||
|
CTColorScheme cs = new CTColorScheme();
|
||||||
|
cs.setAccent1(srgb("FF0000"));
|
||||||
|
el.setClrScheme(cs);
|
||||||
|
BaseStyles.FontScheme fs = new BaseStyles.FontScheme();
|
||||||
|
FontCollection minor = new FontCollection();
|
||||||
|
TextFont latin = new TextFont();
|
||||||
|
latin.setTypeface("Arimo");
|
||||||
|
minor.setLatin(latin);
|
||||||
|
fs.setMinorFont(minor);
|
||||||
|
// majorFont без a:latin — имя остаётся дефолтным
|
||||||
|
fs.setMajorFont(new FontCollection());
|
||||||
|
el.setFontScheme(fs);
|
||||||
|
theme.setThemeElements(el);
|
||||||
|
DrawMlColor colors = new DrawMlColor(theme);
|
||||||
|
assertEquals(new Color(0xFF, 0, 0), colors.schemeColor("accent1"));
|
||||||
|
assertEquals("Arimo", colors.minorFontName());
|
||||||
|
assertEquals("Calibri Light", colors.majorFontName());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void schemeColorNullAndUnknownFallBackToBlack() {
|
||||||
|
DrawMlColor colors = new DrawMlColor(null);
|
||||||
|
assertEquals(Color.BLACK, colors.schemeColor(null));
|
||||||
|
assertEquals(Color.BLACK, colors.schemeColor("no-such-color"));
|
||||||
|
assertEquals(OFFICE_ACCENT1, colors.schemeColor("ACCENT1"));
|
||||||
|
assertEquals(colors.schemeColor("dk1"), colors.schemeColor("tx1"));
|
||||||
|
assertEquals(colors.schemeColor("lt1"), colors.schemeColor("bg1"));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void resolveNullsReturnNull() {
|
||||||
|
DrawMlColor colors = new DrawMlColor(null);
|
||||||
|
assertNull(colors.resolve(null));
|
||||||
|
assertNull(colors.resolve(new CTColor()));
|
||||||
|
assertNull(colors.resolveFill(null));
|
||||||
|
assertNull(colors.resolveStop(null));
|
||||||
|
assertNull(colors.resolveFontRef(null));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void baseColorKindsResolved() {
|
||||||
|
DrawMlColor colors = new DrawMlColor(null);
|
||||||
|
CTColor scrgb = new CTColor();
|
||||||
|
CTScRgbColor s = new CTScRgbColor();
|
||||||
|
s.setR(1);
|
||||||
|
s.setG(0);
|
||||||
|
s.setB(0);
|
||||||
|
scrgb.setScrgbClr(s);
|
||||||
|
assertEquals(Color.RED, colors.resolve(scrgb));
|
||||||
|
CTColor hsl = new CTColor();
|
||||||
|
CTHslColor h = new CTHslColor();
|
||||||
|
h.setHue(0);
|
||||||
|
h.setSat(100000);
|
||||||
|
h.setLum(50000);
|
||||||
|
hsl.setHslClr(h);
|
||||||
|
assertEquals(Color.RED, colors.resolve(hsl));
|
||||||
|
CTColor window = new CTColor();
|
||||||
|
CTSystemColor w = new CTSystemColor();
|
||||||
|
w.setVal("window");
|
||||||
|
window.setSysClr(w);
|
||||||
|
assertEquals(Color.WHITE, colors.resolve(window));
|
||||||
|
assertEquals(OFFICE_ACCENT1, colors.resolve(scheme(STSchemeColorVal.ACCENT_1)));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void srgbTransformsChainApplied() {
|
||||||
|
DrawMlColor colors = new DrawMlColor(null);
|
||||||
|
CTColor c = srgb("808080");
|
||||||
|
var transforms = c.getSrgbClr().getEGColorTransform();
|
||||||
|
transforms.add(transform("lumMod", CTPositiveFixedPercentage.class, fixedPct(50000)));
|
||||||
|
transforms.add(transform("lumOff", CTFixedPercentage.class, fixed(10000)));
|
||||||
|
transforms.add(transform("satMod", CTPositivePercentage.class, positive(200000)));
|
||||||
|
transforms.add(transform("satOff", CTPositivePercentage.class, positive(10000)));
|
||||||
|
transforms.add(transform("hueMod", CTPositiveFixedPercentage.class, fixedPct(50000)));
|
||||||
|
transforms.add(transform("hueOff", CTPositiveFixedAngle.class, angle(5400000)));
|
||||||
|
transforms.add(transform("tint", CTPositiveFixedPercentage.class, fixedPct(80000)));
|
||||||
|
transforms.add(transform("shade", CTPositiveFixedPercentage.class, fixedPct(90000)));
|
||||||
|
transforms.add(transform("alpha", CTPercentage.class, pct(50000)));
|
||||||
|
Color resolved = colors.resolve(c);
|
||||||
|
assertNotNull(resolved);
|
||||||
|
assertEquals(128, resolved.getAlpha());
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void unknownTransformSkipped() {
|
||||||
|
DrawMlColor colors = new DrawMlColor(null);
|
||||||
|
CTColor c = srgb("123456");
|
||||||
|
c.getSrgbClr().getEGColorTransform()
|
||||||
|
.add(transform("bogus", String.class, "x"));
|
||||||
|
assertEquals(new Color(0x12, 0x34, 0x56), colors.resolve(c));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void schemeAndSystemColorTransformsApplied() {
|
||||||
|
DrawMlColor colors = new DrawMlColor(null);
|
||||||
|
CTColor accent = scheme(STSchemeColorVal.ACCENT_1);
|
||||||
|
accent.getSchemeClr().getEGColorTransform()
|
||||||
|
.add(transform("tint", CTPositiveFixedPercentage.class, fixedPct(60000)));
|
||||||
|
Color resolved = colors.resolve(accent);
|
||||||
|
assertNotNull(resolved);
|
||||||
|
assertTrue(resolved.getRed() >= OFFICE_ACCENT1.getRed()
|
||||||
|
&& resolved.getBlue() >= OFFICE_ACCENT1.getBlue(),
|
||||||
|
"tint обязан осветлять, а не темнить");
|
||||||
|
CTColor sys = new CTColor();
|
||||||
|
CTSystemColor w = new CTSystemColor();
|
||||||
|
w.setVal("windowText");
|
||||||
|
w.getEGColorTransform()
|
||||||
|
.add(transform("shade", CTPositiveFixedPercentage.class, fixedPct(50000)));
|
||||||
|
sys.setSysClr(w);
|
||||||
|
assertEquals(Color.BLACK, colors.resolve(sys));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void gradientStopAndFontRefResolve() {
|
||||||
|
DrawMlColor colors = new DrawMlColor(null);
|
||||||
|
CTGradientStop gs = new CTGradientStop();
|
||||||
|
gs.setSrgbClr(srgbColor("FF8000"));
|
||||||
|
assertEquals(new Color(0xFF, 0x80, 0), colors.resolveStop(gs));
|
||||||
|
CTFontReference ref = new CTFontReference();
|
||||||
|
CTSchemeColor sc = new CTSchemeColor();
|
||||||
|
sc.setVal(STSchemeColorVal.ACCENT_2);
|
||||||
|
ref.setSchemeClr(sc);
|
||||||
|
assertEquals(OFFICE_ACCENT2, colors.resolveFontRef(ref));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void resolveFillWrapsColorSet() {
|
||||||
|
DrawMlColor colors = new DrawMlColor(null);
|
||||||
|
CTSolidColorFillProperties fill = new CTSolidColorFillProperties();
|
||||||
|
CTSchemeColor sc = new CTSchemeColor();
|
||||||
|
sc.setVal(STSchemeColorVal.DK_1);
|
||||||
|
fill.setSchemeClr(sc);
|
||||||
|
assertEquals(Color.BLACK, colors.resolveFill(fill));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void withAlphaScalesAlphaChannel() {
|
||||||
|
Color c = DrawMlColor.withAlpha(Color.BLUE, 0.5);
|
||||||
|
assertEquals(128, c.getAlpha());
|
||||||
|
assertEquals(Color.BLUE.getRGB() & 0xFFFFFF, c.getRGB() & 0xFFFFFF);
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -0,0 +1,164 @@
|
|||||||
|
package ru.pjandro.wordpdf.internal.chart;
|
||||||
|
|
||||||
|
import org.docx4j.dml.CTNoFillProperties;
|
||||||
|
import org.docx4j.dml.CTRegularTextRun;
|
||||||
|
import org.docx4j.dml.CTTextBody;
|
||||||
|
import org.docx4j.dml.CTTextCharacterProperties;
|
||||||
|
import org.docx4j.dml.CTTextParagraph;
|
||||||
|
import org.docx4j.dml.CTTextParagraphProperties;
|
||||||
|
import org.docx4j.dml.STTextAlignType;
|
||||||
|
import org.docx4j.dml.TextFont;
|
||||||
|
import org.junit.jupiter.api.Test;
|
||||||
|
import ru.pjandro.wordpdf.fonts.BundledFonts;
|
||||||
|
|
||||||
|
import java.awt.Color;
|
||||||
|
import java.awt.Graphics2D;
|
||||||
|
import java.awt.geom.Rectangle2D;
|
||||||
|
import java.awt.image.BufferedImage;
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertEquals;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertNotNull;
|
||||||
|
import static org.junit.jupiter.api.Assertions.assertTrue;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Текст DrawingML: наследование defRPr/rPr (включая a:noFill → прозрачный
|
||||||
|
* цвет и алиас «+mj-lt» → семейство темы), фолбэк шрифта для неизвестного
|
||||||
|
* семейства и растеризация: вертикальный/горизонтальный align, перенос
|
||||||
|
* длинного слова, жёсткий перевод строки, двойные пробелы.
|
||||||
|
*/
|
||||||
|
class DrawMlTextTest {
|
||||||
|
|
||||||
|
private static final DrawMlText.Style STYLE =
|
||||||
|
new DrawMlText.Style(10, false, false, Color.BLACK, "DejaVu Sans");
|
||||||
|
|
||||||
|
private static DrawMlText.Style style(String family, boolean bold, boolean italic) {
|
||||||
|
return new DrawMlText.Style(10, bold, italic, Color.BLACK, family);
|
||||||
|
}
|
||||||
|
|
||||||
|
private static final int MIN_INK_PER_ROW = 2;
|
||||||
|
|
||||||
|
/** Полосы строк: ряды не менее чем с двумя тёмными пикселями
|
||||||
|
* (одиночная вершина «A» не полоса). */
|
||||||
|
private static int inkBands(BufferedImage img) {
|
||||||
|
int bands = 0;
|
||||||
|
boolean in = false;
|
||||||
|
for (int y = 0; y < img.getHeight(); y++) {
|
||||||
|
int cnt = 0;
|
||||||
|
for (int x = 0; x < img.getWidth(); x++) {
|
||||||
|
int argb = img.getRGB(x, y);
|
||||||
|
if (argb >>> 24 > 0 && (argb & 0xFFFFFF) < 0x808080) {
|
||||||
|
cnt++;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
boolean dark = cnt >= MIN_INK_PER_ROW;
|
||||||
|
if (dark && !in) {
|
||||||
|
bands++;
|
||||||
|
in = true;
|
||||||
|
} else if (!dark) {
|
||||||
|
in = false;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return bands;
|
||||||
|
}
|
||||||
|
|
||||||
|
private static BufferedImage paint(List<DrawMlText.Paragraph> paragraphs,
|
||||||
|
Rectangle2D box, String defAlign, String vAlign) {
|
||||||
|
BufferedImage img = new BufferedImage((int) box.getWidth() + 10,
|
||||||
|
(int) box.getHeight() + 10, BufferedImage.TYPE_INT_ARGB);
|
||||||
|
Graphics2D g = img.createGraphics();
|
||||||
|
DrawMlText.paint(g, paragraphs, box, defAlign, vAlign, 1.2);
|
||||||
|
g.dispose();
|
||||||
|
return img;
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void defaultStyleNullPaths() {
|
||||||
|
DrawMlColor colors = new DrawMlColor(null);
|
||||||
|
DrawMlText.Style def = DrawMlText.defaultStyle(null, colors,
|
||||||
|
"DejaVu Sans", 9, Color.GRAY);
|
||||||
|
assertEquals(9, def.sizePt());
|
||||||
|
CTTextBody body = new CTTextBody();
|
||||||
|
body.getP().add(new CTTextParagraph());
|
||||||
|
DrawMlText.Style base = DrawMlText.defaultStyle(body, colors,
|
||||||
|
"DejaVu Sans", 9, Color.GRAY);
|
||||||
|
assertEquals(Color.GRAY, base.color(), "без a:pPr/a:defRPr — фолбэк-цвет");
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void paragraphsNullBodyAndRunStyles() {
|
||||||
|
BundledFonts.init();
|
||||||
|
DrawMlColor colors = new DrawMlColor(null);
|
||||||
|
assertTrue(DrawMlText.paragraphs(null, colors, "DejaVu Sans", 9, Color.GRAY).isEmpty());
|
||||||
|
CTTextBody body = new CTTextBody();
|
||||||
|
CTTextParagraph p = new CTTextParagraph();
|
||||||
|
CTTextParagraphProperties pPr = new CTTextParagraphProperties();
|
||||||
|
pPr.setAlgn(STTextAlignType.CTR);
|
||||||
|
CTTextCharacterProperties defRPr = new CTTextCharacterProperties();
|
||||||
|
defRPr.setSz(1400);
|
||||||
|
TextFont major = new TextFont();
|
||||||
|
major.setTypeface("+mj-lt");
|
||||||
|
defRPr.setLatin(major);
|
||||||
|
pPr.setDefRPr(defRPr);
|
||||||
|
p.setPPr(pPr);
|
||||||
|
CTRegularTextRun run = new CTRegularTextRun();
|
||||||
|
CTTextCharacterProperties rPr = new CTTextCharacterProperties();
|
||||||
|
rPr.setNoFill(new CTNoFillProperties());
|
||||||
|
run.setRPr(rPr);
|
||||||
|
run.setT("Привет");
|
||||||
|
p.getEGTextRun().add(run);
|
||||||
|
body.getP().add(p);
|
||||||
|
List<DrawMlText.Paragraph> paras = DrawMlText.paragraphs(body, colors,
|
||||||
|
"DejaVu Sans", 9, Color.GRAY);
|
||||||
|
assertEquals(1, paras.size());
|
||||||
|
assertEquals("Привет", paras.get(0).text());
|
||||||
|
assertEquals("ctr", paras.get(0).align());
|
||||||
|
assertEquals(14.0, paras.get(0).style().sizePt());
|
||||||
|
assertEquals("carlito", paras.get(0).style().family(),
|
||||||
|
"«+mj-lt» разрешается в major-шрифт темы");
|
||||||
|
assertEquals(0, paras.get(0).style().color().getAlpha(),
|
||||||
|
"a:noFill в a:rPr — прозрачный цвет");
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void fontForUnknownFamilyFallsBack() {
|
||||||
|
assertNotNull(DrawMlText.fontFor(style("NoSuchFamily", true, true)));
|
||||||
|
assertNotNull(DrawMlText.fontFor(style("Noto Naskh Arabic", false, true)),
|
||||||
|
"нет bold-italic в семействе — фолбэк без null");
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void paintEmptyIsNoop() {
|
||||||
|
BufferedImage img = paint(List.of(),
|
||||||
|
new Rectangle2D.Double(0, 0, 50, 50), null, null);
|
||||||
|
assertEquals(0, inkBands(img));
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void paintBottomAndRightAlignDrawsInk() {
|
||||||
|
BufferedImage img = paint(
|
||||||
|
List.of(new DrawMlText.Paragraph("Тест", STYLE, "r")),
|
||||||
|
new Rectangle2D.Double(0, 0, 120, 60), null, "b");
|
||||||
|
assertTrue(inkBands(img) >= 1, "right/bottom-выравнивание рисует текст");
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void paintHardNewlineCreatesGap() {
|
||||||
|
BufferedImage gap = paint(
|
||||||
|
List.of(new DrawMlText.Paragraph("A\n\nB", STYLE, null)),
|
||||||
|
new Rectangle2D.Double(0, 0, 120, 80), "ctr", "t");
|
||||||
|
assertEquals(2, inkBands(gap), "пустая строка между A и B — разрыв полос");
|
||||||
|
BufferedImage one = paint(
|
||||||
|
List.of(new DrawMlText.Paragraph("A B", STYLE, null)),
|
||||||
|
new Rectangle2D.Double(0, 0, 120, 40), null, "t");
|
||||||
|
assertEquals(1, inkBands(one), "двойной пробел не рвёт строку");
|
||||||
|
}
|
||||||
|
|
||||||
|
@Test
|
||||||
|
void paintLongWordSplitsIntoLines() {
|
||||||
|
BufferedImage img = paint(
|
||||||
|
List.of(new DrawMlText.Paragraph("A WWWWWWWWWWWWWWWWW", STYLE, null)),
|
||||||
|
new Rectangle2D.Double(0, 0, 20, 120), null, "t");
|
||||||
|
assertTrue(inkBands(img) >= 3, "длинное слово режется по символам");
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -272,4 +272,22 @@ class PresetGeometryTest {
|
|||||||
}
|
}
|
||||||
assertEquals(4, segments);
|
assertEquals(4, segments);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/** Арифметика префиксных формул (+, -, *, /), голый литерал, пустая/битая fmla → 0. */
|
||||||
|
@Test
|
||||||
|
void adjustValuesEvaluatesFormulasAndBlanks() {
|
||||||
|
CTPresetGeometry2D geom = new CTPresetGeometry2D();
|
||||||
|
CTGeomGuideList av = new CTGeomGuideList();
|
||||||
|
av.getGd().add(guide("adj1", "45000"));
|
||||||
|
av.getGd().add(guide("adj2", "+ 1 2"));
|
||||||
|
av.getGd().add(guide("adj3", "- 5 2"));
|
||||||
|
av.getGd().add(guide("adj4", "* 2 3 4"));
|
||||||
|
av.getGd().add(guide("adj5", "/ 2 4 6"));
|
||||||
|
av.getGd().add(guide("adj6", null));
|
||||||
|
av.getGd().add(guide("adj7", "+ 1"));
|
||||||
|
geom.setAvLst(av);
|
||||||
|
assertArrayEquals(new int[]{45000, 3, 3, 1, 1, 0, 0},
|
||||||
|
PresetGeometry.adjustValues(geom),
|
||||||
|
"* = a*b/c, / = (a+b)/c; пустая и оборванная формула — 0");
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
Reference in New Issue
Block a user