diff --git a/AGENTS.md b/AGENTS.md
index cdee305..cf23257 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -135,7 +135,7 @@ SSH-пользователи/логины, ни хосты, ни директо
- `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` (test), POI `5.5.1` (test, только генератор фикстур), 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`.
-- Корневой `pmd-ruleset.xml` — ruleset PMD (см. Testing & QA): `category/java/codestyle.xml` минус opinionated-правила, `MethodNamingConventions` с `junit5TestPattern` под underscore-имена регрессий, `TooManyStaticImports` до 12, XPath-правило `LiteralFirstInEquals`, unused-правила из `bestpractices.xml`.
+- Корневой `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` НЕ проксирует.
- `wordpdf-core/src/test/java/ru/pjandro/wordpdf/SampleDocxGenerator.java` — main()-утилита пересоздания фикстур.
@@ -153,7 +153,7 @@ 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` — тесты сканируются).
+- Гейт `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` не задан — дефолт 2, т.е. нарушения priority ≤ 2 валят build, priority 3 — только WARNING в отчёт). Литералы в условиях `if` — только именованными константами (`AvoidLiteralsInIfCondition`), `null` вместо пустой коллекции запрещён (`ReturnEmptyCollectionRatherThanNull` — `GlyphCoverageNormalizer.split` возвращает пустой список).
- 15 тестовых классов / 144 `@Test` (core 12/118, app 3/26). JUnit 6 (`org.junit.jupiter:junit-jupiter`), surefire 3.6.0 с `-Djava.awt.headless=true` в argLine; только `Assertions` (Mockito/AssertJ не использовать, несмотря на test-classpath Boot; в app-тестах допустим inline-Hamcrest `org.hamcrest.Matchers.containsString` в `andExpect`); тестовые классы package-private, зеркалят main-пакеты; только `@Test` (+ единственный `@BeforeAll` — warm-up шрифтов в `GlyphCoverageNormalizerTest`).
- **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).
diff --git a/pmd-ruleset.xml b/pmd-ruleset.xml
index 544de9b..6fc376f 100644
--- a/pmd-ruleset.xml
+++ b/pmd-ruleset.xml
@@ -63,4 +63,15 @@
+
+
+
+
+
+
+ 2
+
+
+ 2
+
diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfValidator.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfValidator.java
index a49ed2a..59b326e 100644
--- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfValidator.java
+++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfValidator.java
@@ -61,6 +61,9 @@ import java.util.zip.ZipInputStream;
*/
public final class WordPdfValidator {
+ /** Элемент-контейнер body, внутри которого sectPr — межсекционный разрыв. */
+ private static final String BODY_ELEMENT = "body";
+
private WordPdfValidator() {
}
@@ -392,7 +395,7 @@ public final class WordPdfValidator {
}
}
case "sectPr" -> {
- if ("body".equals(parent)) {
+ if (BODY_ELEMENT.equals(parent)) {
inBodySectPr = true;
sectTypeVal = null;
}
diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/GlyphCoverageNormalizer.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/GlyphCoverageNormalizer.java
index f617a76..47a379f 100644
--- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/GlyphCoverageNormalizer.java
+++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/GlyphCoverageNormalizer.java
@@ -202,7 +202,7 @@ public final class GlyphCoverageNormalizer {
}
String decoded = decode(text.group(2));
List segments = split(decoded, runFamily);
- if (segments == null) {
+ if (segments.isEmpty()) {
return block;
}
@@ -219,7 +219,7 @@ public final class GlyphCoverageNormalizer {
/**
* Разбивает текст на части по семейству, которое обязано его отрисовать.
*
- * @return части либо null, если весь текст остаётся на шрифте ранa
+ * @return части либо пустой список, если весь текст остаётся на шрифте ранa
* (или ни один бандл-шрифт не покрывает недостающие знаки)
*/
static List split(String text, String runFamily) {
@@ -240,11 +240,11 @@ public final class GlyphCoverageNormalizer {
i = next;
}
if (text.isEmpty()) {
- return null;
+ return List.of();
}
segments.add(new Segment(text.substring(start), current));
boolean changed = segments.size() > 1 || segments.get(0).family != null;
- return changed ? segments : null;
+ return changed ? segments : List.of();
}
/**
diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/CartesianPainter.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/CartesianPainter.java
index ff1aa77..821e685 100644
--- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/CartesianPainter.java
+++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/CartesianPainter.java
@@ -15,6 +15,9 @@ import java.util.List;
*/
final class CartesianPainter {
+ /** Линия/область рисуется только из двух и более точек. */
+ private static final int MIN_POLYLINE_POINTS = 2;
+
private CartesianPainter() {
}
@@ -236,7 +239,7 @@ final class CartesianPainter {
along.add(catPos(i, nCat, plot, horizontal));
cross.add(valuePos(v, lo, hi, plot, horizontal));
}
- if (along.size() > 1) {
+ if (along.size() >= MIN_POLYLINE_POINTS) {
g.draw(ChartRenderer.polyline(along, cross, false));
}
if (s.marker) {
@@ -271,7 +274,7 @@ final class CartesianPainter {
along.add(catPos(i, nCat, plot, horizontal));
cross.add(valuePos(v, lo, hi, plot, horizontal));
}
- if (along.size() < 2) {
+ if (along.size() < MIN_POLYLINE_POINTS) {
continue;
}
Path2D p = new Path2D.Double();
diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartRenderer.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartRenderer.java
index 2ca996d..25bef1b 100644
--- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartRenderer.java
+++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/ChartRenderer.java
@@ -32,6 +32,14 @@ final class ChartRenderer {
/** Поля вокруг chartSpace от рамки графика. Auto-layout Word — Word-эмпирика. */
private static final double PADDING = 4.0;
+ /** «Круглые» множители шага делений 1/2/5·10ⁿ (как подбирает Word). */
+ private static final double NICE_STEP_ONE = 1;
+ private static final double NICE_STEP_TWO = 2;
+ private static final double NICE_STEP_FIVE = 5;
+
+ /** Порог «значение целое» при форматировании подписей. */
+ private static final double INTEGER_EPSILON = 1e-9;
+
private ChartRenderer() {
}
@@ -208,8 +216,7 @@ final class ChartRenderer {
}
}
default -> {
- for (int i = 0; i < spec.series.size(); i++) {
- ChartSpec.Series s = spec.series.get(i);
+ for (ChartSpec.Series s : spec.series) {
Color c = s.lineColor != null ? s.lineColor
: s.fillAt(0, palette);
boolean lineLike = spec.type == ChartSpec.Type.LINE;
@@ -281,14 +288,14 @@ final class ChartRenderer {
double exp = Math.floor(Math.log10(raw));
double base = Math.pow(10, exp);
double frac = raw / base;
- if (frac <= 1) {
+ if (frac <= NICE_STEP_ONE) {
return base;
}
- if (frac <= 2) {
- return 2 * base;
+ if (frac <= NICE_STEP_TWO) {
+ return NICE_STEP_TWO * base;
}
- if (frac <= 5) {
- return 5 * base;
+ if (frac <= NICE_STEP_FIVE) {
+ return NICE_STEP_FIVE * base;
}
return 10 * base;
}
@@ -353,7 +360,7 @@ final class ChartRenderer {
return String.format(java.util.Locale.ROOT, "%.1f", v);
}
}
- if (Math.abs(v - Math.rint(v)) < 1e-9) {
+ if (Math.abs(v - Math.rint(v)) < INTEGER_EPSILON) {
return String.valueOf((long) Math.rint(v));
}
String s = String.format(java.util.Locale.ROOT, "%.2f", v);
diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlColor.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlColor.java
index 6e1a2d4..8dc9b7c 100644
--- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlColor.java
+++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlColor.java
@@ -50,6 +50,10 @@ final class DrawMlColor {
"hlink", "0563C1", "folHlink", "954F72",
};
+ /** Word: bg1/tx1 — псевдонимы lt1/dk1. */
+ private static final String ALIAS_BG1 = "bg1";
+ private static final String ALIAS_TX1 = "tx1";
+
DrawMlColor(Theme theme) {
for (int i = 0; i < OFFICE_DEFAULT.length; i += 2) {
scheme.put(OFFICE_DEFAULT[i], decodeHex(OFFICE_DEFAULT[i + 1]));
@@ -112,9 +116,9 @@ final class DrawMlColor {
}
String n = name.toLowerCase(Locale.ROOT);
// Word: bg1/tx1 — псевдонимы lt1/dk1
- if ("bg1".equals(n)) {
+ if (ALIAS_BG1.equals(n)) {
n = "lt1";
- } else if ("tx1".equals(n)) {
+ } else if (ALIAS_TX1.equals(n)) {
n = "dk1";
}
Color c = scheme.get(n);
diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlText.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlText.java
index 33c709d..1459eee 100644
--- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlText.java
+++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawMlText.java
@@ -44,6 +44,10 @@ final class DrawMlText {
record Paragraph(String text, Style style, String align) {
}
+ /** Значения выравнивания DrawingML (a:pPr/@algn, a:bodyPr/@anchor). */
+ private static final String ALIGN_CTR = "ctr";
+ private static final String VALIGN_BOTTOM = "b";
+
private DrawMlText() {
}
@@ -193,9 +197,9 @@ final class DrawMlText {
}
}
double y = box.getY();
- if ("ctr".equals(vAlign)) {
+ if (ALIGN_CTR.equals(vAlign)) {
y += (box.getHeight() - totalHeight) / 2.0;
- } else if ("b".equals(vAlign)) {
+ } else if (VALIGN_BOTTOM.equals(vAlign)) {
y += box.getHeight() - totalHeight;
}
y = Math.max(box.getY(), y);
@@ -203,7 +207,7 @@ final class DrawMlText {
g.setColor(line.style().color());
double x = box.getX();
String align = line.align() != null ? line.align() : defAlign;
- if ("ctr".equals(align)) {
+ if (ALIGN_CTR.equals(align)) {
x += (box.getWidth() - line.width()) / 2.0;
} else if ("r".equals(align) || "far".equals(align)) {
x += box.getWidth() - line.width();
diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawingPreRenderer.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawingPreRenderer.java
index a44a967..7546d90 100644
--- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawingPreRenderer.java
+++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/internal/chart/DrawingPreRenderer.java
@@ -104,7 +104,7 @@ public final class DrawingPreRenderer {
continue;
}
List