PMD: откат на движок 6.55.0 (maven-pmd-plugin 3.21.2), закрытый набор из 26 правил; нарушения починены кодом
PR checks / web (pull_request) Successful in 39s
PR checks / java (pull_request) Successful in 3m4s
Main: tests, deploy, autotests / java (push) Successful in 9s
Main: tests, deploy, autotests / web (push) Successful in 43s
Main: tests, deploy, autotests / images-app (push) Successful in 1m13s
Main: tests, deploy, autotests / images-web (push) Successful in 30s
Main: tests, deploy, autotests / deploy (push) Successful in 1m35s
Main: tests, deploy, autotests / autotests (push) Successful in 45s
Main: tests, deploy, autotests / rollback (push) Has been skipped

This commit was merged in pull request #107.
This commit is contained in:
Pjandro
2026-11-13 02:11:51 +03:00
parent 0b2dda8caa
commit 72cc717056
13 changed files with 93 additions and 114 deletions
+3 -3
View File
@@ -96,8 +96,8 @@ python3 docs/standards/docx/validate-fixtures.py wordpdf-core/src/test/resources
- Javadoc на русском, объясняет «почему» и ссылается на регрессию и фикстуру (формат: `Регрессия — WordPdfConverterTest#имя, фикстура samples/….docx`). - Javadoc на русском, объясняет «почему» и ссылается на регрессию и фикстуру (формат: `Регрессия — WordPdfConverterTest#имя, фикстура samples/….docx`).
- Константы UPPER_SNAKE с эталонными значениями (`PIE_DEPTH`, `DECOMPRESS_MB_PER_MAX_MB`); начертания `V_REGULAR/V_BOLD/V_ITALIC/V_BOLD_ITALIC`; модели — `record`; размеры в chart — в пунктах, растр × `DPI/72`. - Константы UPPER_SNAKE с эталонными значениями (`PIE_DEPTH`, `DECOMPRESS_MB_PER_MAX_MB`); начертания `V_REGULAR/V_BOLD/V_ITALIC/V_BOLD_ITALIC`; модели — `record`; размеры в chart — в пунктах, растр × `DPI/72`.
- Логирование: `java.util.logging.Logger` в корневом пакете и `internal/`, SLF4J — в `internal/chart` и `wordpdf-app`. - Логирование: `java.util.logging.Logger` в корневом пакете и `internal/`, SLF4J — в `internal/chart` и `wordpdf-app`.
- Тестовые методы: регрессионные — `объект_условие` через underscore (`ruPlain_cyrillicAndStyles`), юниты — camelCase (`pageFieldBecomesFldSimple`); оба стиля разрешает PMD-паттерн `junit5TestPattern` (`^[a-z][a-zA-Z0-9]*(_[a-zA-Z0-9]+)*$`). - Тестовые методы: регрессионные — `объект_условие` через underscore (`ruPlain_cyrillicAndStyles`), юниты — camelCase (`pageFieldBecomesFldSimple`); конвенция репозитория, PMD её не проверяет (в наборе правил нет правил именования).
- PMD (`pmd-ruleset.xml`, execution `pmd-check` на `verify` в обоих модулях, `includeTests=true`, валится нарушение любой приоритетности): полные исключения категории и настройки правил — в самом ruleset. Нарушения чинятся кодом; подавление (`@SuppressWarnings("PMD…")`, `// NOPMD`) запрещено. - PMD (`pmd-ruleset.xml`, execution `pmd-check` на `verify` в обоих модулях, `includeTests=true`, валит нарушение любой приоритетности): закрытый список rule-ref — в самом ruleset; правила не исключаются и не перенастраиваются. Нарушения чинятся кодом; подавление (`@SuppressWarnings("PMD…")`, `// NOPMD`) запрещено.
## Runtime & Tooling ## Runtime & Tooling
@@ -116,7 +116,7 @@ python3 docs/standards/docx/validate-fixtures.py wordpdf-core/src/test/resources
## Testing & QA ## Testing & QA
- Гейты: PMD `maven-pmd-plugin` 3.28.0 (`includeTests=true`) и JaCoCo `0.8.15` (`jacoco:check` на `verify`) — LINE `0.90` (оба модуля), BRANCH `0.85` (только core); отчёт `report` раньше `check` (`target/site/jacoco/`). Механика — `docs/agent/repo-map.md`. Плотность покрытия держат тесты, а не заглушки. - Гейты: PMD `maven-pmd-plugin` 3.21.2 (движок PMD 6.55.0; `includeTests=true`; откат с 3.28.0 осознанный — список правил включает удалённые в PMD 7 `*MustUseBraces`) и JaCoCo `0.8.15` (`jacoco:check` на `verify`) — LINE `0.90` (оба модуля), BRANCH `0.85` (только core); отчёт `report` раньше `check` (`target/site/jacoco/`). Механика — `docs/agent/repo-map.md`. Плотность покрытия держат тесты, а не заглушки.
- Стек: JUnit 6 (`org.junit.jupiter`), только `Assertions` — Mockito/AssertJ не использовать; в app-тестах допустим inline-Hamcrest `containsString` в `andExpect`; тестовые классы package-private, зеркалят main-пакеты. Счётчики — `docs/agent/testing.md`. - Стек: JUnit 6 (`org.junit.jupiter`), только `Assertions` — Mockito/AssertJ не использовать; в app-тестах допустим inline-Hamcrest `containsString` в `andExpect`; тестовые классы package-private, зеркалят main-пакеты. Счётчики — `docs/agent/testing.md`.
- **PDF сравнивается текстом, не растеризацией**: PDFBox 3, `PDFTextStripper`; негативные маркеры — `.notdef` (`#`) и `Helvetica`; текст нормализуется по пробелам (`norm`). Пиксельные проверки — только в юнитах chart-пейнтеров (допуски `assertRatio` < 0.06 / < 0.10). Детали — `docs/agent/repo-map.md`. - **PDF сравнивается текстом, не растеризацией**: PDFBox 3, `PDFTextStripper`; негативные маркеры — `.notdef` (`#`) и `Helvetica`; текст нормализуется по пробелам (`norm`). Пиксельные проверки — только в юнитах chart-пейнтеров (допуски `assertRatio` < 0.06 / < 0.10). Детали — `docs/agent/repo-map.md`.
- Регрессивная конвенция: фикс = нормализатор/рендерер + юнит + конвертер-тест; в javadoc фикса — ссылка «Регрессия — Test#имя, фикстура samples/…». Пары `XxxNormalizerTest`↔`тест-в-конвейере` воспроизводятся грепом по этим ссылкам; исключения — `docs/agent/testing.md`. - Регрессивная конвенция: фикс = нормализатор/рендерер + юнит + конвертер-тест; в javadoc фикса — ссылка «Регрессия — Test#имя, фикстура samples/…». Пары `XxxNormalizerTest`↔`тест-в-конвейере` воспроизводятся грепом по этим ссылкам; исключения — `docs/agent/testing.md`.
+2 -2
View File
@@ -34,7 +34,7 @@
- `wordpdf-app/src/main/resources/application.properties` — multipart 100MB (`max-file-size`/`max-request-size` + `file-size-threshold=2MB` — части крупнее 2 МБ на диск, не в память; в тон 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=2MB` — части крупнее 2 МБ на диск, не в память; в тон 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); JaCoCo execution `check` переопределён (LINE 0.90 + BRANCH 0.85). - `wordpdf-core/pom.xml` — `maven-jar-plugin` execution `test-jar` (публикует фикстуры для app); JaCoCo execution `check` переопределён (LINE 0.90 + BRANCH 0.85).
- Корневой `pom.xml` — все версии зависимостей (в модулях версии не объявлять): docx4j `17.3.2`, commons-compress `1.28.0`, slf4j `2.0.20`, JUnit `6.1.3`, PDFBox/fontbox `3.0.8` (`fontbox` — compile в core: глиф-движок `GlyphFont`; `pdfbox` — test в обоих модулях; commons-logging исключён, мост — `jcl-over-slf4j`), 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`, JaCoCo `0.8.15`; пустой дефолт `<argLine>` (для `-Djacoco.skip=true`). - Корневой `pom.xml` — все версии зависимостей (в модулях версии не объявлять): docx4j `17.3.2`, commons-compress `1.28.0`, slf4j `2.0.20`, JUnit `6.1.3`, PDFBox/fontbox `3.0.8` (`fontbox` — compile в core: глиф-движок `GlyphFont`; `pdfbox` — test в обоих модулях; commons-logging исключён, мост — `jcl-over-slf4j`), 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.21.2` (движок PMD `6.55.0`), JaCoCo `0.8.15`; пустой дефолт `<argLine>` (для `-Djacoco.skip=true`).
- `pmd-ruleset.xml` — ruleset PMD (см. Code Conventions). - `pmd-ruleset.xml` — ruleset PMD (см. Code Conventions).
- `.ci/maven-settings.xml` — Maven-зеркало Nexus с URL из `${env.MAVEN_MIRROR_URL}` (общий файл CI-job'ов `java` и Containerfile; координаты стенда в репо не хранятся — Variable/build-arg). - `.ci/maven-settings.xml` — Maven-зеркало Nexus с URL из `${env.MAVEN_MIRROR_URL}` (общий файл CI-job'ов `java` и Containerfile; координаты стенда в репо не хранятся — Variable/build-arg).
- `wordpdf-core/src/main/resources/slf4j-simple.properties` — без него предупреждение лезет в PDF. - `wordpdf-core/src/main/resources/slf4j-simple.properties` — без него предупреждение лезет в PDF.
@@ -105,7 +105,7 @@ unzip -p ~/.m2/repository/org/docx4j/docx4j-export-fo/<версия>/docx4j-expo
- **PDF сравнивается текстом, не растеризацией**: PDFBox 3 (`Loader.loadPDF`) — `PDFTextStripper` (пер-странично `setStartPage/setEndPage`), override `processTextPosition` для шрифта конкретного символа (`fontNameOf`), обход ресурсов страниц для встроенных шрифтов (`EAAAAA+Carlito-Bold`) и счётчик картинок (`imageCount`/`distinctImageCount` — SMask игнорируется). Негативные маркеры: `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`/`distinctImageCount` — SMask игнорируется). Негативные маркеры: `assertFalse(text.contains("#"))` (.notdef), `assertFalse(font.startsWith("Helvetica"))`. Текст нормализуется по пробелам (`norm`); в `tableImage_tableAndImage` — полное удаление пробелов (docx4j переносит слова в auto-fit таблицах).
PMD: `failurePriority` в плагине не задан — на практике `verify` валит нарушение любой приоритетности; перечень исключённых правил в AGENTS.md не дублируется — единственный источник `pmd-ruleset.xml`. PMD: `failurePriority` в плагине не задан — на практике `verify` валит нарушение любой приоритетности; закрытый список правил — единственный источник `pmd-ruleset.xml` (в AGENTS.md не дублируется). Четыре правила `*MustUseBraces` деприкейтед в 6.55.0 — предупреждения «Discontinue using…» в логе verify ожидаемы.
- Нормализаторы — единый контракт `internal/DocxNormalizer` + константа `STEP`; цепочка `WordPdfConverter.normalizers()` = `DocxRewritePipeline.STEP` (правила 1–10 одним zip-проходом) + лямбда `OleObjectNormalizer`; нечего менять → **тот же массив**; package-private хук `static String rewrite(String xml)` для юнит-тестов (возвращает `null` при отсутствии изменений; есть у 10 из 11 — у многочастного `OleObjectNormalizer` нет); у `StrictOoxmlNormalizer` есть также `rewritePart(entryName, xml)`, у `TableIndentNormalizer` — `rewritePart(name, xml, band)` (per-part-логика, хуки пайплайна); правятся только части `word/*.xml`. - Нормализаторы — единый контракт `internal/DocxNormalizer` + константа `STEP`; цепочка `WordPdfConverter.normalizers()` = `DocxRewritePipeline.STEP` (правила 1–10 одним zip-проходом) + лямбда `OleObjectNormalizer`; нечего менять → **тот же массив**; package-private хук `static String rewrite(String xml)` для юнит-тестов (возвращает `null` при отсутствии изменений; есть у 10 из 11 — у многочастного `OleObjectNormalizer` нет); у `StrictOoxmlNormalizer` есть также `rewritePart(entryName, xml)`, у `TableIndentNormalizer` — `rewritePart(name, xml, band)` (per-part-логика, хуки пайплайна); правятся только части `word/*.xml`.
+22 -80
View File
@@ -2,94 +2,36 @@
<ruleset name="WordPDF code style" xmlns="http://pmd.sourceforge.net/ruleset/2.0.0" <ruleset name="WordPDF code style" xmlns="http://pmd.sourceforge.net/ruleset/2.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://pmd.sourceforge.net/ruleset/2.0.0 https://pmd.sourceforge.io/ruleset_2_0_0.xsd"> xsi:schemaLocation="http://pmd.sourceforge.net/ruleset/2.0.0 https://pmd.sourceforge.io/ruleset_2_0_0.xsd">
<description>Код-стиль java-word-pdf: codestyle без opinionated-правил, unused-правила, <description>Код-стиль java-word-pdf: закрытый список правил под движок PMD 6.55.0
NPE-safe сравнения, гигиена ошибок/ресурсов/многопоточности. Нарушения чинятся (maven-pmd-plugin 3.21.2; откат с PMD 7 — правила *MustUseBraces удалены в 7-й
кодом — подавление @SuppressWarnings("PMD…") и // NOPMD запрещены.</description> мажорной, их deprecation-предупреждения в логе verify ожидаемы). Нарушения чинятся
кодом — подавление @SuppressWarnings("PMD…") и // NOPMD запрещены; правила не
исключаются и не перенастраиваются.</description>
<!-- ==================== codestyle ==================== --> <rule ref="category/java/bestpractices.xml/ForLoopCanBeForeach"/>
<rule ref="category/java/codestyle.xml">
<!-- opinionated/шумные, намеренно выключены -->
<exclude name="AtLeastOneConstructor"/>
<exclude name="CallSuperInConstructor"/>
<exclude name="CommentDefaultAccessModifier"/>
<exclude name="ConfusingTernary"/>
<exclude name="FieldDeclarationsShouldBeAtStartOfClass"/>
<exclude name="LocalVariableCouldBeFinal"/>
<exclude name="LongVariable"/>
<exclude name="MethodArgumentCouldBeFinal"/>
<exclude name="OnlyOneReturn"/>
<exclude name="PrematureDeclaration"/>
<exclude name="ShortMethodName"/>
<exclude name="ShortVariable"/>
<exclude name="UseExplicitTypes"/>
<exclude name="UseUnderscoresInNumericLiterals"/>
<!-- переопределены ниже -->
<exclude name="MethodNamingConventions"/>
<exclude name="TooManyStaticImports"/>
<exclude name="ControlStatementBraces"/>
<exclude name="UnnecessaryImport"/>
</rule>
<!-- регрессионные тесты репо именуются объект_условие (AGENTS.md) -->
<rule ref="category/java/codestyle.xml/MethodNamingConventions">
<properties>
<property name="junit5TestPattern" value="^[a-z][a-zA-Z0-9]*(_[a-zA-Z0-9]+)*$"/>
</properties>
</rule>
<!-- MockMvc-тесты: >4 статических импортов — норма -->
<rule ref="category/java/codestyle.xml/TooManyStaticImports">
<properties>
<property name="maximumStaticImports" value="12"/>
</properties>
</rule>
<rule ref="category/java/codestyle.xml/UnnecessaryImport"/>
<!-- case без скобок — норма для этого стиля; true, если строже -->
<rule ref="category/java/codestyle.xml/ControlStatementBraces">
<properties>
<property name="checkCaseStmt" value="false"/>
</properties>
</rule>
<!-- ==================== bestpractices ==================== -->
<rule ref="category/java/bestpractices.xml/UnusedAssignment"/>
<rule ref="category/java/bestpractices.xml/UnusedFormalParameter"/>
<rule ref="category/java/bestpractices.xml/UnusedLocalVariable"/>
<rule ref="category/java/bestpractices.xml/UnusedPrivateField"/>
<rule ref="category/java/bestpractices.xml/UnusedPrivateMethod"/>
<rule ref="category/java/bestpractices.xml/ForLoopCanBeForeach">
<priority>2</priority>
</rule>
<rule ref="category/java/bestpractices.xml/AvoidPrintStackTrace"/>
<rule ref="category/java/bestpractices.xml/SystemPrintln"/>
<!-- NPE-safe порядок операндов: литерал/константа слева. Заменило кастомное
XPath-правило LiteralFirstInEquals: штатное правило строго шире (константа
справа — тоже нарушение, плюс ==/!= по строкам). -->
<rule ref="category/java/bestpractices.xml/LiteralsFirstInComparisons"/>
<!-- ==================== design ==================== -->
<rule ref="category/java/design.xml/ExceptionAsFlowControl"/> <rule ref="category/java/design.xml/ExceptionAsFlowControl"/>
<!-- ==================== errorprone ==================== -->
<!-- null вместо пустой коллекции запрещён (priority 1 по умолчанию — валит verify) -->
<rule ref="category/java/errorprone.xml/ReturnEmptyCollectionRatherThanNull"/>
<!-- литералы в условиях if — только именованными константами -->
<rule ref="category/java/errorprone.xml/AvoidLiteralsInIfCondition"/>
<rule ref="category/java/errorprone.xml/EmptyCatchBlock">
<priority>2</priority>
</rule>
<rule ref="category/java/errorprone.xml/EqualsNull"/> <rule ref="category/java/errorprone.xml/EqualsNull"/>
<rule ref="category/java/errorprone.xml/CloseResource"/> <rule ref="category/java/errorprone.xml/CloseResource"/>
<rule ref="category/java/errorprone.xml/BrokenNullCheck"/> <rule ref="category/java/errorprone.xml/BrokenNullCheck"/>
<rule ref="category/java/bestpractices.xml/AvoidPrintStackTrace"/>
<rule ref="category/java/errorprone.xml/AvoidLosingExceptionInformation"/>
<rule ref="category/java/errorprone.xml/AvoidLiteralsInIfCondition"/>
<rule ref="category/java/errorprone.xml/AvoidCatchingNPE"/> <rule ref="category/java/errorprone.xml/AvoidCatchingNPE"/>
<rule ref="category/java/errorprone.xml/AssignmentToNonFinalStatic"/> <rule ref="category/java/errorprone.xml/AssignmentToNonFinalStatic"/>
<rule ref="category/java/errorprone.xml/DoNotCallGarbageCollectionExplicitly"/> <rule ref="category/java/errorprone.xml/DoNotCallGarbageCollectionExplicitly"/>
<rule ref="category/java/errorprone.xml/EmptyCatchBlock"/>
<rule ref="category/java/errorprone.xml/CompareObjectsWithEquals"/> <rule ref="category/java/errorprone.xml/CompareObjectsWithEquals"/>
<rule ref="category/java/errorprone.xml/MisplacedNullCheck"/> <rule ref="category/java/bestpractices.xml/UnusedPrivateMethod"/>
<rule ref="category/java/errorprone.xml/ImplicitSwitchFallThrough"/> <rule ref="category/java/bestpractices.xml/UnusedPrivateField"/>
<rule ref="category/java/codestyle.xml/UnnecessaryImport"/>
<!-- ==================== multithreading ==================== --> <rule ref="category/java/bestpractices.xml/SystemPrintln"/>
<rule ref="category/java/multithreading.xml/UnsynchronizedStaticFormatter"/> <rule ref="category/java/multithreading.xml/UnsynchronizedStaticFormatter"/>
<rule ref="category/java/errorprone.xml/ReturnEmptyCollectionRatherThanNull"/>
<rule ref="category/java/errorprone.xml/MisplacedNullCheck"/>
<rule ref="category/java/bestpractices.xml/LiteralsFirstInComparisons"/>
<rule ref="category/java/codestyle.xml/WhileLoopsMustUseBraces"/>
<rule ref="category/java/codestyle.xml/IfStmtsMustUseBraces"/>
<rule ref="category/java/codestyle.xml/IfElseStmtsMustUseBraces"/>
<rule ref="category/java/errorprone.xml/ImplicitSwitchFallThrough"/>
<rule ref="category/java/codestyle.xml/ForLoopsMustUseBraces"/>
</ruleset> </ruleset>
+1 -1
View File
@@ -159,7 +159,7 @@
<plugin> <plugin>
<groupId>org.apache.maven.plugins</groupId> <groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-pmd-plugin</artifactId> <artifactId>maven-pmd-plugin</artifactId>
<version>3.28.0</version> <version>3.21.2</version>
<configuration> <configuration>
<rulesets> <rulesets>
<ruleset>${maven.multiModuleProjectDirectory}/pmd-ruleset.xml</ruleset> <ruleset>${maven.multiModuleProjectDirectory}/pmd-ruleset.xml</ruleset>
@@ -66,6 +66,15 @@ public final class WordPdfValidator {
/** Элемент-контейнер body, внутри которого sectPr — межсекционный разрыв. */ /** Элемент-контейнер body, внутри которого sectPr — межсекционный разрыв. */
private static final String BODY_ELEMENT = "body"; private static final String BODY_ELEMENT = "body";
/** Кэш-элемент &lt;Pages&gt; в docProps/app.xml. */
private static final String PAGES_ELEMENT = "Pages";
/** Элемент sectPr — секция документа (межсекционный разрыв). */
private static final String SECTION_PROPERTIES = "sectPr";
/** Элемент w:br — разрыв строки/страницы. */
private static final String BREAK_ELEMENT = "br";
/** Кэш Word &lt;Pages&gt;. */ /** Кэш Word &lt;Pages&gt;. */
private static final String APP_PART = "docProps/app.xml"; private static final String APP_PART = "docProps/app.xml";
@@ -563,7 +572,7 @@ public final class WordPdfValidator {
XMLStreamReader xr = newSecureReader().createXMLStreamReader(in); XMLStreamReader xr = newSecureReader().createXMLStreamReader(in);
while (xr.hasNext()) { while (xr.hasNext()) {
if (xr.next() == XMLStreamReader.START_ELEMENT if (xr.next() == XMLStreamReader.START_ELEMENT
&& "Pages".equals(xr.getLocalName())) { && PAGES_ELEMENT.equals(xr.getLocalName())) {
String text = xr.getElementText().trim(); String text = xr.getElementText().trim();
return Math.max(0, Integer.parseInt(text)); return Math.max(0, Integer.parseInt(text));
} }
@@ -652,7 +661,7 @@ public final class WordPdfValidator {
// различает финальную и межсекционные) // различает финальную и межсекционные)
} }
case "type" -> { case "type" -> {
if (inBodySectPr && "sectPr".equals(parent)) { if (inBodySectPr && SECTION_PROPERTIES.equals(parent)) {
sectTypeVal = attrLocal(xr, "val"); sectTypeVal = attrLocal(xr, "val");
} }
} }
@@ -660,7 +669,7 @@ public final class WordPdfValidator {
} }
} }
} else if (ev == XMLStreamReader.END_ELEMENT) { } else if (ev == XMLStreamReader.END_ELEMENT) {
if ("sectPr".equals(xr.getLocalName()) && inBodySectPr) { if (SECTION_PROPERTIES.equals(xr.getLocalName()) && inBodySectPr) {
if (pendingNewPageSection) { if (pendingNewPageSection) {
bodyDirectSectPr++; bodyDirectSectPr++;
} }
@@ -693,7 +702,7 @@ public final class WordPdfValidator {
XMLStreamReader xr = newSecureReader().createXMLStreamReader(in); XMLStreamReader xr = newSecureReader().createXMLStreamReader(in);
while (xr.hasNext()) { while (xr.hasNext()) {
if (xr.next() == XMLStreamReader.START_ELEMENT if (xr.next() == XMLStreamReader.START_ELEMENT
&& "br".equals(xr.getLocalName()) && isPageBreak(xr)) { && BREAK_ELEMENT.equals(xr.getLocalName()) && isPageBreak(xr)) {
count++; count++;
} }
} }
@@ -72,6 +72,10 @@ final class HiddenTextNormalizer {
/** Закрывающий слэш самозакрывающегося тега. */ /** Закрывающий слэш самозакрывающегося тега. */
private static final char SELF_CLOSE = '/'; private static final char SELF_CLOSE = '/';
/** Части, которые рерайт пропускает: ранов там нет, а vanish в styles — входные данные. */
private static final String STYLES_PART = "word/styles.xml";
private static final String NUMBERING_PART = "word/numbering.xml";
/** Открывающий/закрывающий тег рана; {@code <w:rPr>}/{@code <w:rStyle>} и прочее не матчатся по границе имени. */ /** Открывающий/закрывающий тег рана; {@code <w:rPr>}/{@code <w:rStyle>} и прочее не матчатся по границе имени. */
private static final Pattern RUN_TOKEN = Pattern.compile("<w:r(?=[ >/])|</w:r>"); private static final Pattern RUN_TOKEN = Pattern.compile("<w:r(?=[ >/])|</w:r>");
@@ -110,7 +114,7 @@ final class HiddenTextNormalizer {
static byte[] normalize(byte[] docx) throws IOException { static byte[] normalize(byte[] docx) throws IOException {
Set<String> vanishStyles = Set.of(); Set<String> vanishStyles = Set.of();
try (ZipFile zf = new ZipFile(new SeekableInMemoryByteChannel(docx))) { try (ZipFile zf = new ZipFile(new SeekableInMemoryByteChannel(docx))) {
ZipArchiveEntry styles = zf.getEntry("word/styles.xml"); ZipArchiveEntry styles = zf.getEntry(STYLES_PART);
if (styles != null) { if (styles != null) {
vanishStyles = vanishStyles(new String( vanishStyles = vanishStyles(new String(
zf.getInputStream(styles).readAllBytes(), StandardCharsets.UTF_8)); zf.getInputStream(styles).readAllBytes(), StandardCharsets.UTF_8));
@@ -152,7 +156,7 @@ final class HiddenTextNormalizer {
* @return новая строка либо null, если менять нечего * @return новая строка либо null, если менять нечего
*/ */
static String rewritePart(String name, String xml, Set<String> vanishStyleIds) { static String rewritePart(String name, String xml, Set<String> vanishStyleIds) {
if ("word/styles.xml".equals(name) || "word/numbering.xml".equals(name)) { if (STYLES_PART.equals(name) || NUMBERING_PART.equals(name)) {
return null; return null;
} }
return rewrite(vanishStyleIds, xml); return rewrite(vanishStyleIds, xml);
@@ -75,6 +75,9 @@ public final class OleObjectNormalizer {
/** Сегмент «наверх» в относительном Target rels. */ /** Сегмент «наверх» в относительном Target rels. */
private static final String PARENT_DIR = ".."; private static final String PARENT_DIR = "..";
/** Сегмент «текущий каталог» в относительном Target rels. */
private static final String CURRENT_DIR = ".";
private static final Pattern DEFAULT_TYPE = Pattern.compile( private static final Pattern DEFAULT_TYPE = Pattern.compile(
"<Default\\b[^>]*\\bExtension=\"([^\"]*)\"[^>]*\\bContentType=\"([^\"]*)\"[^>]*/>" "<Default\\b[^>]*\\bExtension=\"([^\"]*)\"[^>]*\\bContentType=\"([^\"]*)\"[^>]*/>"
+ "|<Default\\b[^>]*\\bContentType=\"([^\"]*)\"[^>]*\\bExtension=\"([^\"]*)\"[^>]*/>"); + "|<Default\\b[^>]*\\bContentType=\"([^\"]*)\"[^>]*\\bExtension=\"([^\"]*)\"[^>]*/>");
@@ -373,7 +376,7 @@ public final class OleObjectNormalizer {
} }
} }
for (String s : target.split("/")) { for (String s : target.split("/")) {
if (s.isEmpty() || ".".equals(s)) { if (s.isEmpty() || CURRENT_DIR.equals(s)) {
continue; continue;
} }
if (PARENT_DIR.equals(s)) { if (PARENT_DIR.equals(s)) {
@@ -52,6 +52,10 @@ final class ChartRenderer {
/** Порог «значение целое» при форматировании подписей. */ /** Порог «значение целое» при форматировании подписей. */
private static final double INTEGER_EPSILON = 1e-9; private static final double INTEGER_EPSILON = 1e-9;
/** Позиции легенды (ECMA-376 §21.2.2.144 ST_LegendPos): снизу/сверху. */
private static final String LEGEND_BOTTOM = "b";
private static final String LEGEND_TOP = "t";
/** /**
* Верхняя граница числа делений: {@code c:majorUnit} (ECMA-376 §21.2.2.103) — * Верхняя граница числа делений: {@code c:majorUnit} (ECMA-376 §21.2.2.103) —
* double без нижней границы; Word пишет «круглые» значения, а враждебный docx — * double без нижней границы; Word пишет «круглые» значения, а враждебный docx —
@@ -110,12 +114,12 @@ final class ChartRenderer {
// дорисовывается поверх после художника. Регрессия — ChartRendererTest#overlayLegend_drawnOverPlot. // дорисовывается поверх после художника. Регрессия — ChartRendererTest#overlayLegend_drawnOverPlot.
double legendH = legend == null || spec.legendOverlay ? 0 : legend.height; double legendH = legend == null || spec.legendOverlay ? 0 : legend.height;
Rectangle2D box0 = box; Rectangle2D box0 = box;
if (legend != null && !spec.legendOverlay && "b".equals(spec.legendPos)) { if (legend != null && !spec.legendOverlay && LEGEND_BOTTOM.equals(spec.legendPos)) {
legend.draw(g, box.getX(), box.getY() + box.getHeight() - legendH, legend.draw(g, box.getX(), box.getY() + box.getHeight() - legendH,
box.getWidth()); box.getWidth());
box = new Rectangle2D.Double(box.getX(), box.getY(), box = new Rectangle2D.Double(box.getX(), box.getY(),
box.getWidth(), box.getHeight() - legendH); box.getWidth(), box.getHeight() - legendH);
} else if (legend != null && !spec.legendOverlay && "t".equals(spec.legendPos)) { } else if (legend != null && !spec.legendOverlay && LEGEND_TOP.equals(spec.legendPos)) {
legend.draw(g, box.getX(), box.getY(), box.getWidth()); legend.draw(g, box.getX(), box.getY(), box.getWidth());
box = new Rectangle2D.Double(box.getX(), box.getY() + legendH, box = new Rectangle2D.Double(box.getX(), box.getY() + legendH,
box.getWidth(), box.getHeight() - legendH); box.getWidth(), box.getHeight() - legendH);
@@ -144,7 +148,7 @@ final class ChartRenderer {
default -> LOG.warn("тип графика {} не поддерживается — пустой PNG", spec.type); default -> LOG.warn("тип графика {} не поддерживается — пустой PNG", spec.type);
} }
if (legend != null && spec.legendOverlay) { if (legend != null && spec.legendOverlay) {
double y = "t".equals(spec.legendPos) double y = LEGEND_TOP.equals(spec.legendPos)
? box0.getY() : box0.getY() + box0.getHeight() - legend.height; ? box0.getY() : box0.getY() + box0.getHeight() - legend.height;
legend.draw(g, box0.getX(), y, box0.getWidth()); legend.draw(g, box0.getX(), y, box0.getWidth());
} }
@@ -57,6 +57,8 @@ final class DrawMlText {
/** Значения выравнивания DrawingML (a:pPr/@algn, a:bodyPr/@anchor). */ /** Значения выравнивания DrawingML (a:pPr/@algn, a:bodyPr/@anchor). */
private static final String ALIGN_CTR = "ctr"; private static final String ALIGN_CTR = "ctr";
private static final String ALIGN_RIGHT = "r";
private static final String ALIGN_FAR = "far";
private static final String VALIGN_BOTTOM = "b"; private static final String VALIGN_BOTTOM = "b";
/** Длина строки, дальше которую рез не идёт (прогресс гарантирован 1 символом). */ /** Длина строки, дальше которую рез не идёт (прогресс гарантирован 1 символом). */
@@ -241,7 +243,7 @@ final class DrawMlText {
String align = line.align() != null ? line.align() : defAlign; String align = line.align() != null ? line.align() : defAlign;
if (ALIGN_CTR.equals(align)) { if (ALIGN_CTR.equals(align)) {
x += (box.getWidth() - line.width()) / 2.0; x += (box.getWidth() - line.width()) / 2.0;
} else if ("r".equals(align) || "far".equals(align)) { } else if (ALIGN_RIGHT.equals(align) || ALIGN_FAR.equals(align)) {
x += box.getWidth() - line.width(); x += box.getWidth() - line.width();
} }
fontFor(line.style()).draw(g, line.text(), x, y + line.ascent(), fontFor(line.style()).draw(g, line.text(), x, y + line.ascent(),
@@ -402,19 +402,24 @@ final class Surface3dPainter {
private static List<double[]> clipHalf(List<double[]> poly, double bound, boolean keepAbove) { private static List<double[]> clipHalf(List<double[]> poly, double bound, boolean keepAbove) {
List<double[]> out = new ArrayList<>(); List<double[]> out = new ArrayList<>();
for (int i = 0; i < poly.size(); i++) { if (poly.isEmpty()) {
double[] cur = poly.get(i); return out;
double[] nxt = poly.get((i + 1) % poly.size()); }
// Рёбра (prev → cur) по кругу от замыкающего: то же множество рёбер, что у
// индексного (i, (i+1)%n); foreach — ForLoopCanBeForeach.
double[] prev = poly.get(poly.size() - 1);
for (double[] cur : poly) {
boolean inPrev = keepAbove ? prev[2] >= bound : prev[2] <= bound;
boolean inCur = keepAbove ? cur[2] >= bound : cur[2] <= bound; boolean inCur = keepAbove ? cur[2] >= bound : cur[2] <= bound;
boolean inNxt = keepAbove ? nxt[2] >= bound : nxt[2] <= bound; if (inPrev) {
if (inCur) { out.add(prev);
out.add(cur);
} }
if (inCur != inNxt && Math.abs(nxt[2] - cur[2]) > 1e-12) { if (inPrev != inCur && Math.abs(cur[2] - prev[2]) > 1e-12) {
double t = (bound - cur[2]) / (nxt[2] - cur[2]); double t = (bound - prev[2]) / (cur[2] - prev[2]);
out.add(new double[]{cur[0] + t * (nxt[0] - cur[0]), out.add(new double[]{prev[0] + t * (cur[0] - prev[0]),
cur[1] + t * (nxt[1] - cur[1]), bound}); prev[1] + t * (cur[1] - prev[1]), bound});
} }
prev = cur;
} }
return out; return out;
} }
@@ -256,6 +256,8 @@ public final class DocToDocx {
private static final char QUOTE = '"'; private static final char QUOTE = '"';
/** Переключатель якорной ссылки Word. */ /** Переключатель якорной ссылки Word. */
private static final String ANCHOR_SWITCH = "\\l"; private static final String ANCHOR_SWITCH = "\\l";
/** Токен поля HYPERLINK в начале инструкции. */
private static final String HYPERLINK_FIELD = "HYPERLINK";
private final PieceTable pieces; private final PieceTable pieces;
private final ChpxIndex chpx; private final ChpxIndex chpx;
@@ -950,7 +952,7 @@ public final class DocToDocx {
while (end < s.length() && !Character.isWhitespace(s.charAt(end))) { while (end < s.length() && !Character.isWhitespace(s.charAt(end))) {
end++; end++;
} }
if (!"HYPERLINK".equalsIgnoreCase(s.substring(0, end))) { if (!HYPERLINK_FIELD.equalsIgnoreCase(s.substring(0, end))) {
return null; return null;
} }
int p = end; int p = end;
@@ -86,8 +86,12 @@ final class Tables {
int[] centers() { int[] centers() {
int[] c = new int[colWidths.length + 1]; int[] c = new int[colWidths.length + 1];
c[0] = indent; c[0] = indent;
for (int i = 0; i < colWidths.length; i++) { int i = 1;
c[i + 1] = c[i] + colWidths[i]; // foreach: индексный for по компоненту рекорда валит ForLoopCanBeForeach
// на PMD 6.55.0 (ClassCastException в VariableNameDeclaration.isArray)
for (int w : colWidths) {
c[i] = c[i - 1] + w;
i++;
} }
return c; return c;
} }
@@ -47,6 +47,10 @@ class PresetGeometryTest {
private static final int DEPTH_BLOCK = 2; private static final int DEPTH_BLOCK = 2;
private static final int DEPTH_SECTION = 3; private static final int DEPTH_SECTION = 3;
private static final String GUIDE_ELEMENT = "gd";
private static final String PATH_LIST_SECTION = "pathLst";
private static final String POINT_ELEMENT = "pt";
@Test @Test
void tableMatchesEcmaXml() throws Exception { void tableMatchesEcmaXml() throws Exception {
Map<String, PresetGeometry.Preset> fromXml = parseEcmaXml(); Map<String, PresetGeometry.Preset> fromXml = parseEcmaXml();
@@ -196,14 +200,14 @@ class PresetGeometryTest {
case "avLst", "gdLst", "pathLst" -> ln; case "avLst", "gdLst", "pathLst" -> ln;
default -> null; default -> null;
}; };
} else if (block != null && "gd".equals(ln) && section != null) { } else if (block != null && GUIDE_ELEMENT.equals(ln) && section != null) {
String entry = r.getAttributeValue(null, "name") + " " String entry = r.getAttributeValue(null, "name") + " "
+ r.getAttributeValue(null, "fmla"); + r.getAttributeValue(null, "fmla");
switch (section) { switch (section) {
case "avLst" -> av.add(entry); case "avLst" -> av.add(entry);
default -> gd.add(entry); default -> gd.add(entry);
} }
} else if (block != null && "pathLst".equals(section)) { } else if (block != null && PATH_LIST_SECTION.equals(section)) {
switch (ln) { switch (ln) {
case "moveTo", "lnTo" -> { case "moveTo", "lnTo" -> {
String[] pt = readPt(r); String[] pt = readPt(r);
@@ -241,7 +245,7 @@ class PresetGeometryTest {
private static String[] readPt(XMLStreamReader r) throws Exception { private static String[] readPt(XMLStreamReader r) throws Exception {
while (r.hasNext()) { while (r.hasNext()) {
if (r.next() == XMLStreamConstants.START_ELEMENT if (r.next() == XMLStreamConstants.START_ELEMENT
&& "pt".equals(r.getLocalName())) { && POINT_ELEMENT.equals(r.getLocalName())) {
String[] attrs = { String[] attrs = {
r.getAttributeValue(null, "x"), r.getAttributeValue(null, "x"),
r.getAttributeValue(null, "y"), r.getAttributeValue(null, "y"),
@@ -249,7 +253,7 @@ class PresetGeometryTest {
boolean closed = false; boolean closed = false;
while (!closed) { while (!closed) {
closed = r.next() == XMLStreamConstants.END_ELEMENT closed = r.next() == XMLStreamConstants.END_ELEMENT
&& "pt".equals(r.getLocalName()); && POINT_ELEMENT.equals(r.getLocalName());
} }
return attrs; return attrs;
} }