test(core): пин w:framePr - фрейм hAnchor=page позиционируется от края страницы (17.4.31)
PR checks / web (pull_request) Successful in 41s
PR checks / java (pull_request) Successful in 1m47s

docx4j 17.3.6 транслирует w:framePr в fo:block-container absolute-position=fixed
(left/top) - до апгрейда текст фрейма шёл общим потоком у левого поля. Замер
реаудита (x=252pt) был для hAnchor=margin; фикстура frame-pr.docx пинит
hAnchor/vAnchor=page x=3600 -> текст на 180pt от края страницы, обычный абзац -
72pt от поля. Регрессия WordPdfConverterTest#framePr_positionedLikeWord.
Счётчики: фикстуры 14 docx, тесты 57/885 (догнаны до фактических).
This commit is contained in:
Pjandro
2026-11-08 23:26:30 +00:00
parent 87b9288aaf
commit 7d11572487
5 changed files with 82 additions and 3 deletions
+1 -1
View File
@@ -120,7 +120,7 @@ python3 docs/standards/docx/validate-fixtures.py wordpdf-core/src/test/resources
- Стек: 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`.
- Фикстуры — только закоммиченные `samples/*.docx` (13) + `samples/*.doc` (12), в тестах не генерировать; контракт нормализаторов «нечего менять → тот же массив» (`assertSame`) + неприкосновенность частей вне `word/*.xml`. - Фикстуры — только закоммиченные `samples/*.docx` (14) + `samples/*.doc` (12), в тестах не генерировать; контракт нормализаторов «нечего менять → тот же массив» (`assertSame`) + неприкосновенность частей вне `word/*.xml`.
- App-тесты: `@SpringBootTest` + `@AutoConfigureMockMvc` (Boot 4: `org.springframework.boot.webmvc.test.autoconfigure`); четыре набора свойств = четыре контекста (отдельные классы, не `@Nested`); `ConversionServiceTest`/`ApiExceptionHandlerTest` — без Spring. Core-юниты Spring **не поднимают**; app-тесты проверяют только HTTP-код/заголовки/текст ошибки. Детали — `docs/agent/testing.md`. - App-тесты: `@SpringBootTest` + `@AutoConfigureMockMvc` (Boot 4: `org.springframework.boot.webmvc.test.autoconfigure`); четыре набора свойств = четыре контекста (отдельные классы, не `@Nested`); `ConversionServiceTest`/`ApiExceptionHandlerTest` — без Spring. Core-юниты Spring **не поднимают**; app-тесты проверяют только HTTP-код/заголовки/текст ошибки. Детали — `docs/agent/testing.md`.
- Жизненный цикл: только `@Test`; исключения — два `@BeforeAll` (прогрев шрифтов) и `@AfterEach drainWorker` в `ConversionTimeoutTest`. Ни `@Nested`, ни `@ParameterizedTest`, ни `@Disabled`, ни `assertAll`. - Жизненный цикл: только `@Test`; исключения — два `@BeforeAll` (прогрев шрифтов) и `@AfterEach drainWorker` в `ConversionTimeoutTest`. Ни `@Nested`, ни `@ParameterizedTest`, ни `@Disabled`, ни `assertAll`.
- Идиомы загрузки фикстур: **core** — classloader без ведущего слэша, **app** — class-relative со слэшем (core test-jar). Синтетика: docx — `ZipOutputStream`, `.doc` — крафт `POIFSFileSystem`. - Идиомы загрузки фикстур: **core** — classloader без ведущего слэша, **app** — class-relative со слэшем (core test-jar). Синтетика: docx — `ZipOutputStream`, `.doc` — крафт `POIFSFileSystem`.
+2 -2
View File
@@ -2,7 +2,7 @@
### Счётчики (2026-11) ### Счётчики (2026-11)
- 57 тестовых классов / 881 тест: core 51/833 (`internal/doc/` 17/232, `internal/chart/` 17/277, `WordPdfConverterTest` 82), app 6/48 (ConvertController 26, ApiKeyFilter 8, ConversionService 5, ApiExceptionHandler 5, ConvertLimits 3, ConversionTimeout 1). Обновлять при изменении набора. - 57 тестовых классов / 885 тест: core 51/837 (`internal/doc/` 17/232, `internal/chart/` 17/277, `WordPdfConverterTest` 83), app 6/48 (ConvertController 26, ApiKeyFilter 8, ConversionService 5, ApiExceptionHandler 5, ConvertLimits 3, ConversionTimeout 1). Обновлять при изменении набора.
### Пиксели, метрики шрифтов, стенд без fontconfig ### Пиксели, метрики шрифтов, стенд без fontconfig
@@ -12,7 +12,7 @@
### Фикстуры ### Фикстуры
- Фикстуры — закоммиченные `samples/*.docx` + `samples/*.doc` (13 + 12; в тестах не генерировать; `.docx` все ECMA-conformant по `docs/standards/docx/validate-fixtures.py` — фикстура невалидна, правится фикстура, не код; `.doc` — эталоны заказчика, конвертируются мостом): core грузит classpath-ресурсом → `byte[]`, PDF для PDFBox — временный файл; app читает `/samples/…` из **test-jar core** (classifier `tests`) → `mvn -pl wordpdf-app` без `-am` не соберётся. In-memory docx — `ZipOutputStream` из литеральных XML или POI в `byte[]`; in-memory `.doc` — POIFS (`POIFSFileSystem`) вокруг крафтовых WordDocument/1Table/Data (`DocToDocxFormattingTest`). Ключевые: `too-many-pages` (150 явных разрывов → 151; `.doc`-пара — кэш PageCount=150 → 400 «не менее 151»), `stale-cache` (docx: кэш `<Pages>1</Pages>` + 110 `lastRenderedPageBreak` → 400; doc: кэш 5 → конвертируется — семантика запинена), `charts-smartart` (4 растра; SmartArt-одиночка = ровно 2 Image XObject; `.doc`-пара — 3 BLIP-fallback → 3 картинки), `ole-embedded` (осиротевший bin с ложным `Default bin→footer+xml` + настоящий `w:object` с честным `Override → oleObject` и VML-плейсхолдером `media/fallback.png` — ручная, генератором не перезаписывать; `.doc`-пара — OLE-fallback BLIP → 1 картинка), `chart-types` (14 графиков: 9 типов + ofPie-pie + lineChart stacked + `c:wireframe` + combo barChart+lineChart на вторичной `c:valAx` pos="r"; пересоздание — `ChartTypesDocxGenerator`; `.doc`-аналога нет), `doc-formats.doc` (2 страницы — лимит страниц на .doc-пути). - Фикстуры — закоммиченные `samples/*.docx` + `samples/*.doc` (14 + 12; в тестах не генерировать; `.docx` все ECMA-conformant по `docs/standards/docx/validate-fixtures.py` — фикстура невалидна, правится фикстура, не код; `.doc` — эталоны заказчика, конвертируются мостом): core грузит classpath-ресурсом → `byte[]`, PDF для PDFBox — временный файл; app читает `/samples/…` из **test-jar core** (classifier `tests`) → `mvn -pl wordpdf-app` без `-am` не соберётся. In-memory docx — `ZipOutputStream` из литеральных XML или POI в `byte[]`; in-memory `.doc` — POIFS (`POIFSFileSystem`) вокруг крафтовых WordDocument/1Table/Data (`DocToDocxFormattingTest`). Ключевые: `too-many-pages` (150 явных разрывов → 151; `.doc`-пара — кэш PageCount=150 → 400 «не менее 151»), `stale-cache` (docx: кэш `<Pages>1</Pages>` + 110 `lastRenderedPageBreak` → 400; doc: кэш 5 → конвертируется — семантика запинена), `charts-smartart` (4 растра; SmartArt-одиночка = ровно 2 Image XObject; `.doc`-пара — 3 BLIP-fallback → 3 картинки), `ole-embedded` (осиротевший bin с ложным `Default bin→footer+xml` + настоящий `w:object` с честным `Override → oleObject` и VML-плейсхолдером `media/fallback.png` — ручная, генератором не перезаписывать; `.doc`-пара — OLE-fallback BLIP → 1 картинка), `chart-types` (14 графиков: 9 типов + ofPie-pie + lineChart stacked + `c:wireframe` + combo barChart+lineChart на вторичной `c:valAx` pos="r"; пересоздание — `ChartTypesDocxGenerator`; `.doc`-аналога нет), `doc-formats.doc` (2 страницы — лимит страниц на .doc-пути), `frame-pr` (`w:framePr hAnchor/vAnchor="page"` `x=3600` — текст фрейма на 180pt от края страницы, §17.4.31; регрессия `framePr_positionedLikeWord`).
### Юниты ### Юниты
@@ -12,12 +12,16 @@ import org.apache.poi.wp.usermodel.HeaderFooterType;
import org.apache.poi.xwpf.usermodel.ParagraphAlignment; import org.apache.poi.xwpf.usermodel.ParagraphAlignment;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTAbstractNum; import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTAbstractNum;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTFonts; import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTFonts;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTFramePr;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTLvl; import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTLvl;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTNumPr; import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTNumPr;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTPPr; import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTPPr;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTSym; import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTSym;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.STFldCharType; import org.openxmlformats.schemas.wordprocessingml.x2006.main.STFldCharType;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.STHAnchor;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.STNumberFormat; import org.openxmlformats.schemas.wordprocessingml.x2006.main.STNumberFormat;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.STVAnchor;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.STWrap;
import org.apache.poi.xwpf.usermodel.XWPFAbstractNum; import org.apache.poi.xwpf.usermodel.XWPFAbstractNum;
import org.apache.poi.xwpf.usermodel.XWPFNumbering; import org.apache.poi.xwpf.usermodel.XWPFNumbering;
import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTR; import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTR;
@@ -76,6 +80,7 @@ public final class SampleDocxGenerator {
exoticGlyphs(dir.resolve("exotic-glyphs.docx")); exoticGlyphs(dir.resolve("exotic-glyphs.docx"));
tooManyPages(dir.resolve("too-many-pages.docx")); tooManyPages(dir.resolve("too-many-pages.docx"));
staleCache(dir.resolve("stale-cache.docx")); staleCache(dir.resolve("stale-cache.docx"));
framePr(dir.resolve("frame-pr.docx"));
System.out.println("Готово: " + dir.toAbsolutePath()); System.out.println("Готово: " + dir.toAbsolutePath());
} }
@@ -381,6 +386,34 @@ public final class SampleDocxGenerator {
} }
} }
/**
* w:framePr (Part 1 §17.4.31): фрейм {@code hAnchor/vAnchor="page"},
* {@code x=3600 y=1440} twips → левый край текста 72+180=252pt от края
* страницы; обычный абзац печатается от поля (72pt). docx4j 17.3.6
* транслирует фрейм в абсолютно позиционированный блок FOP (до апгрейда
* текст фрейма шёл общим потоком у левого поля).
* Регрессия — WordPdfConverterTest#framePr_positionedLikeWord.
*/
private static void framePr(Path out) throws Exception {
try (XWPFDocument doc = new XWPFDocument()) {
heading(doc, "Frame anchored text", "Calibri");
XWPFParagraph base = doc.createParagraph();
run(base, "BASELINE ordinary line", "Calibri", false, false);
XWPFParagraph framed = doc.createParagraph();
CTPPr pPr = framed.getCTP().isSetPPr() ? framed.getCTP().getPPr() : framed.getCTP().addNewPPr();
CTFramePr frame = pPr.addNewFramePr();
frame.setHAnchor(STHAnchor.PAGE);
frame.setVAnchor(STVAnchor.PAGE);
frame.setX("3600");
frame.setY("1440");
frame.setW("4320");
frame.setH("2880");
frame.setWrap(STWrap.NONE);
run(framed, "FRAME anchored line", "Calibri", false, false);
save(doc, out);
}
}
/** /**
* Переупаковывает .docx, вставляя {@code w:lastRenderedPageBreak} * Переупаковывает .docx, вставляя {@code w:lastRenderedPageBreak}
* перед каждым текстовым тегом {@code w:t} в {@code word/document.xml}, * перед каждым текстовым тегом {@code w:t} в {@code word/document.xml},
@@ -2932,4 +2932,50 @@ class WordPdfConverterTest {
} }
} }
/**
* w:framePr (Part 1 §17.4.31): фрейм {@code hAnchor/vAnchor="page"} с
* {@code x=3600 y=1440} twips позиционируется от края страницы — левый
* край его текста 180pt (не от поля!); обычный абзац начинается у поля
* (72pt). docx4j 17.3.6 транслирует фрейм в {@code fo:block-container
* absolute-position="fixed" left top} (до апгрейда текст фрейма шёл общим
* потоком). Фикстура — samples/frame-pr.docx.
*/
@Test
void framePr_positionedLikeWord() throws Exception {
Path pdf = convertPdf(sampleBytes("frame-pr.docx"), "frame-pr");
Map<Long, double[]> lefts = new LinkedHashMap<>();
Map<Long, StringBuilder> lineTexts = new LinkedHashMap<>();
try (PDDocument doc = Loader.loadPDF(pdf.toFile())) {
PDFTextStripper stripper = new PDFTextStripper() {
@Override
protected void processTextPosition(org.apache.pdfbox.text.TextPosition tp) {
String u = tp.getUnicode();
if (!u.trim().isEmpty()) {
long y = Math.round(tp.getYDirAdj());
double[] min = lefts.computeIfAbsent(y, k -> new double[]{Double.MAX_VALUE});
min[0] = Math.min(min[0], tp.getXDirAdj());
lineTexts.computeIfAbsent(y, k -> new StringBuilder()).append(u);
}
super.processTextPosition(tp);
}
};
String text = stripper.getText(doc);
assertTrue(text.contains("FRAME anchored line"), "текст фрейма напечатан");
}
Double base = null;
Double frame = null;
for (Map.Entry<Long, StringBuilder> e : lineTexts.entrySet()) {
String line = e.getValue().toString().trim();
if (line.startsWith("BASELINE")) {
base = lefts.get(e.getKey())[0];
} else if (line.startsWith("FRAME")) {
frame = lefts.get(e.getKey())[0];
}
}
assertTrue(base != null && frame != null, "строки-маркеры найдены");
assertTrue(Math.abs(base - 72.0) < 1.0, "обычный абзац у поля 72pt, реально=" + base);
assertTrue(Math.abs(frame - 180.0) < 1.0,
"фрейм hAnchor=page: x = 180pt от края страницы, реально=" + frame);
}
} }