PMD: движок 6.55.0 (maven-pmd-plugin 3.21.2) + закрытый набор правил #107
@@ -96,8 +96,8 @@ python3 docs/standards/docx/validate-fixtures.py wordpdf-core/src/test/resources
|
||||
- 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`.
|
||||
- Логирование: `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]+)*$`).
|
||||
- PMD (`pmd-ruleset.xml`, execution `pmd-check` на `verify` в обоих модулях, `includeTests=true`, валится нарушение любой приоритетности): полные исключения категории и настройки правил — в самом ruleset. Нарушения чинятся кодом; подавление (`@SuppressWarnings("PMD…")`, `// NOPMD`) запрещено.
|
||||
- Тестовые методы: регрессионные — `объект_условие` через underscore (`ruPlain_cyrillicAndStyles`), юниты — camelCase (`pageFieldBecomesFldSimple`); конвенция репозитория, PMD её не проверяет (в наборе правил нет правил именования).
|
||||
- PMD (`pmd-ruleset.xml`, execution `pmd-check` на `verify` в обоих модулях, `includeTests=true`, валит нарушение любой приоритетности): закрытый список rule-ref — в самом ruleset; правила не исключаются и не перенастраиваются. Нарушения чинятся кодом; подавление (`@SuppressWarnings("PMD…")`, `// NOPMD`) запрещено.
|
||||
|
||||
## Runtime & Tooling
|
||||
|
||||
@@ -116,7 +116,7 @@ python3 docs/standards/docx/validate-fixtures.py wordpdf-core/src/test/resources
|
||||
|
||||
## 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`.
|
||||
- **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`.
|
||||
|
||||
@@ -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/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).
|
||||
- Корневой `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).
|
||||
- `.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.
|
||||
@@ -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 таблицах).
|
||||
|
||||
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`.
|
||||
|
||||
|
||||
+22
-80
@@ -2,94 +2,36 @@
|
||||
<ruleset name="WordPDF code style" xmlns="http://pmd.sourceforge.net/ruleset/2.0.0"
|
||||
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">
|
||||
<description>Код-стиль java-word-pdf: codestyle без opinionated-правил, unused-правила,
|
||||
NPE-safe сравнения, гигиена ошибок/ресурсов/многопоточности. Нарушения чинятся
|
||||
кодом — подавление @SuppressWarnings("PMD…") и // NOPMD запрещены.</description>
|
||||
<description>Код-стиль java-word-pdf: закрытый список правил под движок PMD 6.55.0
|
||||
(maven-pmd-plugin 3.21.2; откат с PMD 7 — правила *MustUseBraces удалены в 7-й
|
||||
мажорной, их deprecation-предупреждения в логе verify ожидаемы). Нарушения чинятся
|
||||
кодом — подавление @SuppressWarnings("PMD…") и // NOPMD запрещены; правила не
|
||||
исключаются и не перенастраиваются.</description>
|
||||
|
||||
<!-- ==================== codestyle ==================== -->
|
||||
<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/bestpractices.xml/ForLoopCanBeForeach"/>
|
||||
<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/CloseResource"/>
|
||||
<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/AssignmentToNonFinalStatic"/>
|
||||
<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/MisplacedNullCheck"/>
|
||||
<rule ref="category/java/errorprone.xml/ImplicitSwitchFallThrough"/>
|
||||
|
||||
<!-- ==================== multithreading ==================== -->
|
||||
<rule ref="category/java/bestpractices.xml/UnusedPrivateMethod"/>
|
||||
<rule ref="category/java/bestpractices.xml/UnusedPrivateField"/>
|
||||
<rule ref="category/java/codestyle.xml/UnnecessaryImport"/>
|
||||
<rule ref="category/java/bestpractices.xml/SystemPrintln"/>
|
||||
<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>
|
||||
|
||||
@@ -159,7 +159,7 @@
|
||||
<plugin>
|
||||
<groupId>org.apache.maven.plugins</groupId>
|
||||
<artifactId>maven-pmd-plugin</artifactId>
|
||||
<version>3.28.0</version>
|
||||
<version>3.21.2</version>
|
||||
<configuration>
|
||||
<rulesets>
|
||||
<ruleset>${maven.multiModuleProjectDirectory}/pmd-ruleset.xml</ruleset>
|
||||
|
||||
@@ -66,6 +66,15 @@ public final class WordPdfValidator {
|
||||
/** Элемент-контейнер body, внутри которого sectPr — межсекционный разрыв. */
|
||||
private static final String BODY_ELEMENT = "body";
|
||||
|
||||
/** Кэш-элемент <Pages> в 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 <Pages>. */
|
||||
private static final String APP_PART = "docProps/app.xml";
|
||||
|
||||
@@ -563,7 +572,7 @@ public final class WordPdfValidator {
|
||||
XMLStreamReader xr = newSecureReader().createXMLStreamReader(in);
|
||||
while (xr.hasNext()) {
|
||||
if (xr.next() == XMLStreamReader.START_ELEMENT
|
||||
&& "Pages".equals(xr.getLocalName())) {
|
||||
&& PAGES_ELEMENT.equals(xr.getLocalName())) {
|
||||
String text = xr.getElementText().trim();
|
||||
return Math.max(0, Integer.parseInt(text));
|
||||
}
|
||||
@@ -652,7 +661,7 @@ public final class WordPdfValidator {
|
||||
// различает финальную и межсекционные)
|
||||
}
|
||||
case "type" -> {
|
||||
if (inBodySectPr && "sectPr".equals(parent)) {
|
||||
if (inBodySectPr && SECTION_PROPERTIES.equals(parent)) {
|
||||
sectTypeVal = attrLocal(xr, "val");
|
||||
}
|
||||
}
|
||||
@@ -660,7 +669,7 @@ public final class WordPdfValidator {
|
||||
}
|
||||
}
|
||||
} else if (ev == XMLStreamReader.END_ELEMENT) {
|
||||
if ("sectPr".equals(xr.getLocalName()) && inBodySectPr) {
|
||||
if (SECTION_PROPERTIES.equals(xr.getLocalName()) && inBodySectPr) {
|
||||
if (pendingNewPageSection) {
|
||||
bodyDirectSectPr++;
|
||||
}
|
||||
@@ -693,7 +702,7 @@ public final class WordPdfValidator {
|
||||
XMLStreamReader xr = newSecureReader().createXMLStreamReader(in);
|
||||
while (xr.hasNext()) {
|
||||
if (xr.next() == XMLStreamReader.START_ELEMENT
|
||||
&& "br".equals(xr.getLocalName()) && isPageBreak(xr)) {
|
||||
&& BREAK_ELEMENT.equals(xr.getLocalName()) && isPageBreak(xr)) {
|
||||
count++;
|
||||
}
|
||||
}
|
||||
|
||||
@@ -72,6 +72,10 @@ final class HiddenTextNormalizer {
|
||||
/** Закрывающий слэш самозакрывающегося тега. */
|
||||
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>} и прочее не матчатся по границе имени. */
|
||||
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 {
|
||||
Set<String> vanishStyles = Set.of();
|
||||
try (ZipFile zf = new ZipFile(new SeekableInMemoryByteChannel(docx))) {
|
||||
ZipArchiveEntry styles = zf.getEntry("word/styles.xml");
|
||||
ZipArchiveEntry styles = zf.getEntry(STYLES_PART);
|
||||
if (styles != null) {
|
||||
vanishStyles = vanishStyles(new String(
|
||||
zf.getInputStream(styles).readAllBytes(), StandardCharsets.UTF_8));
|
||||
@@ -152,7 +156,7 @@ final class HiddenTextNormalizer {
|
||||
* @return новая строка либо null, если менять нечего
|
||||
*/
|
||||
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 rewrite(vanishStyleIds, xml);
|
||||
|
||||
@@ -75,6 +75,9 @@ public final class OleObjectNormalizer {
|
||||
/** Сегмент «наверх» в относительном Target rels. */
|
||||
private static final String PARENT_DIR = "..";
|
||||
|
||||
/** Сегмент «текущий каталог» в относительном Target rels. */
|
||||
private static final String CURRENT_DIR = ".";
|
||||
|
||||
private static final Pattern DEFAULT_TYPE = Pattern.compile(
|
||||
"<Default\\b[^>]*\\bExtension=\"([^\"]*)\"[^>]*\\bContentType=\"([^\"]*)\"[^>]*/>"
|
||||
+ "|<Default\\b[^>]*\\bContentType=\"([^\"]*)\"[^>]*\\bExtension=\"([^\"]*)\"[^>]*/>");
|
||||
@@ -373,7 +376,7 @@ public final class OleObjectNormalizer {
|
||||
}
|
||||
}
|
||||
for (String s : target.split("/")) {
|
||||
if (s.isEmpty() || ".".equals(s)) {
|
||||
if (s.isEmpty() || CURRENT_DIR.equals(s)) {
|
||||
continue;
|
||||
}
|
||||
if (PARENT_DIR.equals(s)) {
|
||||
|
||||
@@ -52,6 +52,10 @@ final class ChartRenderer {
|
||||
/** Порог «значение целое» при форматировании подписей. */
|
||||
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) —
|
||||
* double без нижней границы; Word пишет «круглые» значения, а враждебный docx —
|
||||
@@ -110,12 +114,12 @@ final class ChartRenderer {
|
||||
// дорисовывается поверх после художника. Регрессия — ChartRendererTest#overlayLegend_drawnOverPlot.
|
||||
double legendH = legend == null || spec.legendOverlay ? 0 : legend.height;
|
||||
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,
|
||||
box.getWidth());
|
||||
box = new Rectangle2D.Double(box.getX(), box.getY(),
|
||||
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());
|
||||
box = new Rectangle2D.Double(box.getX(), box.getY() + legendH,
|
||||
box.getWidth(), box.getHeight() - legendH);
|
||||
@@ -144,7 +148,7 @@ final class ChartRenderer {
|
||||
default -> LOG.warn("тип графика {} не поддерживается — пустой PNG", spec.type);
|
||||
}
|
||||
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;
|
||||
legend.draw(g, box0.getX(), y, box0.getWidth());
|
||||
}
|
||||
|
||||
@@ -57,6 +57,8 @@ final class DrawMlText {
|
||||
|
||||
/** Значения выравнивания DrawingML (a:pPr/@algn, a:bodyPr/@anchor). */
|
||||
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";
|
||||
|
||||
/** Длина строки, дальше которую рез не идёт (прогресс гарантирован 1 символом). */
|
||||
@@ -241,7 +243,7 @@ final class DrawMlText {
|
||||
String align = line.align() != null ? line.align() : defAlign;
|
||||
if (ALIGN_CTR.equals(align)) {
|
||||
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();
|
||||
}
|
||||
fontFor(line.style()).draw(g, line.text(), x, y + line.ascent(),
|
||||
|
||||
+15
-10
@@ -402,19 +402,24 @@ final class Surface3dPainter {
|
||||
|
||||
private static List<double[]> clipHalf(List<double[]> poly, double bound, boolean keepAbove) {
|
||||
List<double[]> out = new ArrayList<>();
|
||||
for (int i = 0; i < poly.size(); i++) {
|
||||
double[] cur = poly.get(i);
|
||||
double[] nxt = poly.get((i + 1) % poly.size());
|
||||
if (poly.isEmpty()) {
|
||||
return out;
|
||||
}
|
||||
// Рёбра (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 inNxt = keepAbove ? nxt[2] >= bound : nxt[2] <= bound;
|
||||
if (inCur) {
|
||||
out.add(cur);
|
||||
if (inPrev) {
|
||||
out.add(prev);
|
||||
}
|
||||
if (inCur != inNxt && Math.abs(nxt[2] - cur[2]) > 1e-12) {
|
||||
double t = (bound - cur[2]) / (nxt[2] - cur[2]);
|
||||
out.add(new double[]{cur[0] + t * (nxt[0] - cur[0]),
|
||||
cur[1] + t * (nxt[1] - cur[1]), bound});
|
||||
if (inPrev != inCur && Math.abs(cur[2] - prev[2]) > 1e-12) {
|
||||
double t = (bound - prev[2]) / (cur[2] - prev[2]);
|
||||
out.add(new double[]{prev[0] + t * (cur[0] - prev[0]),
|
||||
prev[1] + t * (cur[1] - prev[1]), bound});
|
||||
}
|
||||
prev = cur;
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
@@ -256,6 +256,8 @@ public final class DocToDocx {
|
||||
private static final char QUOTE = '"';
|
||||
/** Переключатель якорной ссылки Word. */
|
||||
private static final String ANCHOR_SWITCH = "\\l";
|
||||
/** Токен поля HYPERLINK в начале инструкции. */
|
||||
private static final String HYPERLINK_FIELD = "HYPERLINK";
|
||||
|
||||
private final PieceTable pieces;
|
||||
private final ChpxIndex chpx;
|
||||
@@ -950,7 +952,7 @@ public final class DocToDocx {
|
||||
while (end < s.length() && !Character.isWhitespace(s.charAt(end))) {
|
||||
end++;
|
||||
}
|
||||
if (!"HYPERLINK".equalsIgnoreCase(s.substring(0, end))) {
|
||||
if (!HYPERLINK_FIELD.equalsIgnoreCase(s.substring(0, end))) {
|
||||
return null;
|
||||
}
|
||||
int p = end;
|
||||
|
||||
@@ -86,8 +86,12 @@ final class Tables {
|
||||
int[] centers() {
|
||||
int[] c = new int[colWidths.length + 1];
|
||||
c[0] = indent;
|
||||
for (int i = 0; i < colWidths.length; i++) {
|
||||
c[i + 1] = c[i] + colWidths[i];
|
||||
int i = 1;
|
||||
// foreach: индексный for по компоненту рекорда валит ForLoopCanBeForeach
|
||||
// на PMD 6.55.0 (ClassCastException в VariableNameDeclaration.isArray)
|
||||
for (int w : colWidths) {
|
||||
c[i] = c[i - 1] + w;
|
||||
i++;
|
||||
}
|
||||
return c;
|
||||
}
|
||||
|
||||
+8
-4
@@ -47,6 +47,10 @@ class PresetGeometryTest {
|
||||
private static final int DEPTH_BLOCK = 2;
|
||||
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
|
||||
void tableMatchesEcmaXml() throws Exception {
|
||||
Map<String, PresetGeometry.Preset> fromXml = parseEcmaXml();
|
||||
@@ -196,14 +200,14 @@ class PresetGeometryTest {
|
||||
case "avLst", "gdLst", "pathLst" -> ln;
|
||||
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") + " "
|
||||
+ r.getAttributeValue(null, "fmla");
|
||||
switch (section) {
|
||||
case "avLst" -> av.add(entry);
|
||||
default -> gd.add(entry);
|
||||
}
|
||||
} else if (block != null && "pathLst".equals(section)) {
|
||||
} else if (block != null && PATH_LIST_SECTION.equals(section)) {
|
||||
switch (ln) {
|
||||
case "moveTo", "lnTo" -> {
|
||||
String[] pt = readPt(r);
|
||||
@@ -241,7 +245,7 @@ class PresetGeometryTest {
|
||||
private static String[] readPt(XMLStreamReader r) throws Exception {
|
||||
while (r.hasNext()) {
|
||||
if (r.next() == XMLStreamConstants.START_ELEMENT
|
||||
&& "pt".equals(r.getLocalName())) {
|
||||
&& POINT_ELEMENT.equals(r.getLocalName())) {
|
||||
String[] attrs = {
|
||||
r.getAttributeValue(null, "x"),
|
||||
r.getAttributeValue(null, "y"),
|
||||
@@ -249,7 +253,7 @@ class PresetGeometryTest {
|
||||
boolean closed = false;
|
||||
while (!closed) {
|
||||
closed = r.next() == XMLStreamConstants.END_ELEMENT
|
||||
&& "pt".equals(r.getLocalName());
|
||||
&& POINT_ELEMENT.equals(r.getLocalName());
|
||||
}
|
||||
return attrs;
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user