JaCoCo: гейт покрытия 90% строк + сводка/артефакты репортов в CI
Корневой pom: jacoco-maven-plugin 0.8.15 (prepare-agent, report+check на
verify, report раньше check — отчёт готов даже при провале гейта), surefire
argLine через @{argLine}. pr.yml/main.yml job java: Coverage summary в
step summary + артефакт jacoco-html (оба шага if: always()).
Тесты ради гейта (23 класса / 218 @Test): app ConversionService/
ApiExceptionHandler/ConversionTimeout +1 в ConvertController; core
DrawMlColor/DrawMlText + инкременты ChartSpec/PresetGeometry.
Покрытие: core 91,0%, app 92,9% строк.
This commit is contained in:
@@ -32,6 +32,39 @@ jobs:
|
||||
- name: Build and test (PMD gate included)
|
||||
run: mvn -B clean verify
|
||||
|
||||
- name: Coverage summary
|
||||
if: always()
|
||||
run: |
|
||||
python3 - <<'PY' >> "$GITHUB_STEP_SUMMARY"
|
||||
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)\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
|
||||
|
||||
- name: Upload coverage reports
|
||||
if: always()
|
||||
uses: actions/upload-artifact@v4
|
||||
with:
|
||||
name: jacoco-html
|
||||
path: |
|
||||
wordpdf-core/target/site/jacoco/
|
||||
wordpdf-app/target/site/jacoco/
|
||||
|
||||
web:
|
||||
runs-on: ubuntu-latest
|
||||
steps:
|
||||
|
||||
@@ -31,6 +31,39 @@ jobs:
|
||||
- name: Build and test (PMD gate included)
|
||||
run: mvn -B clean verify
|
||||
|
||||
- name: Coverage summary
|
||||
if: always()
|
||||
run: |
|
||||
python3 - <<'PY' >> "$GITHUB_STEP_SUMMARY"
|
||||
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)\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
|
||||
|
||||
- name: Upload coverage reports
|
||||
if: always()
|
||||
uses: actions/upload-artifact@v4
|
||||
with:
|
||||
name: jacoco-html
|
||||
path: |
|
||||
wordpdf-core/target/site/jacoco/
|
||||
wordpdf-app/target/site/jacoco/
|
||||
|
||||
web:
|
||||
runs-on: ubuntu-latest
|
||||
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)|
|
||||
|корневые `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` на проде удаляется деплоем|
|
||||
|`.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-сводка/артефакты JaCoCo → `images-app`/`images-web` (build+push в Nexus) → deploy (рендер прод-конфигов + pull) → autotests → rollback)|
|
||||
|корневой `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`|
|
||||
|`develop/` (вне git, gitignored)|рабочие материалы и эталоны Word для ручного сравнения — **не фикстуры**, в тесты/jar не подключать; на 2026-10 директория пуста (эталоны вынесены, пиксельные замеры зашиты числами в chart-тестах)|
|
||||
@@ -66,7 +66,7 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр
|
||||
## Development Commands
|
||||
|
||||
```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 бэкенда
|
||||
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
|
||||
@@ -90,7 +90,9 @@ java -cp wordpdf-core/target/test-classes:$(cat /tmp/cp.txt) \
|
||||
## CI/CD (Gitea Actions)
|
||||
|
||||
Два 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-сниппетом в лог job'а и
|
||||
`actions/upload-artifact` HTML-отчётов обоих модулей артефактом `jacoco-html`)
|
||||
и `web` (кеш `~/.npm`, `npm ci`/`build`/`lint`). `.gitea/workflows/main.yml` — `Main: tests,
|
||||
deploy, autotests` (`push` в `main` + `workflow_dispatch`): те же `java`/`web` (байт-в-байт
|
||||
дубль — файлы самодостаточны, reusable-workflow не вводить), затем `images-app`/`images-web`
|
||||
@@ -135,7 +137,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/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).
|
||||
- Корневой `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.
|
||||
- `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` НЕ проксирует.
|
||||
@@ -155,7 +157,8 @@ SSH-пользователи/логины, ни хосты, ни директо
|
||||
## 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` возвращает пустой список).
|
||||
- 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 таблицах).
|
||||
- Пиксели (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.
|
||||
|
||||
@@ -33,6 +33,12 @@
|
||||
<junit.version>6.1.3</junit.version>
|
||||
<pdfbox.version>3.0.8</pdfbox.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>
|
||||
|
||||
<dependencyManagement>
|
||||
@@ -132,7 +138,7 @@
|
||||
<version>3.6.0</version>
|
||||
<!-- docx4j/FOP не требуют дисплея -->
|
||||
<configuration>
|
||||
<argLine>-Djava.awt.headless=true</argLine>
|
||||
<argLine>@{argLine} -Djava.awt.headless=true</argLine>
|
||||
</configuration>
|
||||
</plugin>
|
||||
<plugin>
|
||||
@@ -162,6 +168,49 @@
|
||||
</execution>
|
||||
</executions>
|
||||
</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>
|
||||
<groupId>org.springframework.boot</groupId>
|
||||
<artifactId>spring-boot-maven-plugin</artifactId>
|
||||
@@ -175,6 +224,10 @@
|
||||
<groupId>org.apache.maven.plugins</groupId>
|
||||
<artifactId>maven-pmd-plugin</artifactId>
|
||||
</plugin>
|
||||
<plugin>
|
||||
<groupId>org.jacoco</groupId>
|
||||
<artifactId>jacoco-maven-plugin</artifactId>
|
||||
</plugin>
|
||||
</plugins>
|
||||
</build>
|
||||
</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.test.web.servlet.MockMvc;
|
||||
import org.springframework.test.web.servlet.MvcResult;
|
||||
import ru.pjandro.wordpdf.ValidationException;
|
||||
|
||||
import java.io.ByteArrayOutputStream;
|
||||
import java.io.IOException;
|
||||
@@ -400,4 +401,25 @@ class ConvertControllerTest {
|
||||
.andExpect(jsonPath("$.error",
|
||||
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;
|
||||
|
||||
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.CTBarDir;
|
||||
import org.docx4j.dml.chart.CTBarSer;
|
||||
import org.docx4j.dml.chart.CTBoolean;
|
||||
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.CTFirstSliceAng;
|
||||
import org.docx4j.dml.chart.CTGapAmount;
|
||||
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.CTPerspective;
|
||||
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.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 java.awt.Color;
|
||||
import java.util.List;
|
||||
|
||||
import static org.junit.jupiter.api.Assertions.*;
|
||||
@@ -92,11 +146,13 @@ class ChartSpecTest {
|
||||
CTHoleSize hole = new CTHoleSize();
|
||||
hole.setVal((short) 75);
|
||||
chart.setHoleSize(hole);
|
||||
chart.getSer().add(new CTPieSer());
|
||||
ChartSpec spec = new ChartSpec();
|
||||
ChartSpec.readGroup(chart, spec, new DrawMlColor(null), List.of());
|
||||
assertEquals(ChartSpec.Type.DOUGHNUT, spec.type);
|
||||
assertEquals(45, spec.firstSliceAng);
|
||||
assertEquals(75, spec.holeSize);
|
||||
assertEquals(1, spec.series.size());
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -115,6 +171,492 @@ class ChartSpecTest {
|
||||
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() {
|
||||
CTChart chart = new CTChart();
|
||||
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);
|
||||
}
|
||||
|
||||
/** Арифметика префиксных формул (+, -, *, /), голый литерал, пустая/битая 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