From 7d11572487dfbe841938412d1571ad76206765b6 Mon Sep 17 00:00:00 2001 From: Pjandro Date: Sun, 8 Nov 2026 23:26:30 +0000 Subject: [PATCH] =?UTF-8?q?test(core):=20=D0=BF=D0=B8=D0=BD=20w:framePr=20?= =?UTF-8?q?-=20=D1=84=D1=80=D0=B5=D0=B9=D0=BC=20hAnchor=3Dpage=20=D0=BF?= =?UTF-8?q?=D0=BE=D0=B7=D0=B8=D1=86=D0=B8=D0=BE=D0=BD=D0=B8=D1=80=D1=83?= =?UTF-8?q?=D0=B5=D1=82=D1=81=D1=8F=20=D0=BE=D1=82=20=D0=BA=D1=80=D0=B0?= =?UTF-8?q?=D1=8F=20=D1=81=D1=82=D1=80=D0=B0=D0=BD=D0=B8=D1=86=D1=8B=20(17?= =?UTF-8?q?.4.31)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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 (догнаны до фактических). --- AGENTS.md | 2 +- docs/agent/testing.md | 4 +- .../pjandro/wordpdf/SampleDocxGenerator.java | 33 +++++++++++++ .../pjandro/wordpdf/WordPdfConverterTest.java | 46 ++++++++++++++++++ .../src/test/resources/samples/frame-pr.docx | Bin 0 -> 2430 bytes 5 files changed, 82 insertions(+), 3 deletions(-) create mode 100644 wordpdf-core/src/test/resources/samples/frame-pr.docx diff --git a/AGENTS.md b/AGENTS.md index fb4e8b2..3280857 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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`. - **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`. -- Фикстуры — только закоммиченные `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`. - Жизненный цикл: только `@Test`; исключения — два `@BeforeAll` (прогрев шрифтов) и `@AfterEach drainWorker` в `ConversionTimeoutTest`. Ни `@Nested`, ни `@ParameterizedTest`, ни `@Disabled`, ни `assertAll`. - Идиомы загрузки фикстур: **core** — classloader без ведущего слэша, **app** — class-relative со слэшем (core test-jar). Синтетика: docx — `ZipOutputStream`, `.doc` — крафт `POIFSFileSystem`. diff --git a/docs/agent/testing.md b/docs/agent/testing.md index 72ad428..a40b9d0 100644 --- a/docs/agent/testing.md +++ b/docs/agent/testing.md @@ -2,7 +2,7 @@ ### Счётчики (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 @@ -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: кэш `1` + 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: кэш `1` + 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`). ### Юниты diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/SampleDocxGenerator.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/SampleDocxGenerator.java index 0410380..38eafed 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/SampleDocxGenerator.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/SampleDocxGenerator.java @@ -12,12 +12,16 @@ import org.apache.poi.wp.usermodel.HeaderFooterType; import org.apache.poi.xwpf.usermodel.ParagraphAlignment; import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTAbstractNum; 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.CTNumPr; import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTPPr; import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTSym; 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.STVAnchor; +import org.openxmlformats.schemas.wordprocessingml.x2006.main.STWrap; import org.apache.poi.xwpf.usermodel.XWPFAbstractNum; import org.apache.poi.xwpf.usermodel.XWPFNumbering; import org.openxmlformats.schemas.wordprocessingml.x2006.main.CTR; @@ -76,6 +80,7 @@ public final class SampleDocxGenerator { exoticGlyphs(dir.resolve("exotic-glyphs.docx")); tooManyPages(dir.resolve("too-many-pages.docx")); staleCache(dir.resolve("stale-cache.docx")); + framePr(dir.resolve("frame-pr.docx")); 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} * перед каждым текстовым тегом {@code w:t} в {@code word/document.xml}, diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java index 467bc9f..bca7ee8 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java @@ -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 lefts = new LinkedHashMap<>(); + Map 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 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); + } + } diff --git a/wordpdf-core/src/test/resources/samples/frame-pr.docx b/wordpdf-core/src/test/resources/samples/frame-pr.docx new file mode 100644 index 0000000000000000000000000000000000000000..442228ddc81ab042897d48f16117b6c7e41f5791 GIT binary patch literal 2430 zcma)72{@Gd8XpE@H!{eQWvpWvila%CUCnSBDNAU`%#p#^8?qD~BHIj338^IIGLepv zv2Ri2SWb4=5-JHN!q~dsoO{nTdG6`C@Av$_=lj0rd;ib-{{FxB_rqeqTrdzXFE8jh z3T}y;`*?JG!ouP{2}ULR#jk+5 z66ta0L=tSWx1zk&x+b&`v84QkFtV}}ZI#r1iPFu3OWMqbNrfFq{^F)xXRyf3Xs2Wz zCi2P=13|Fj!eLps`-@sRpB}MRFNEFN1WZCP)~i71C1UDO=pl`5njuAmz*G-i;>rt> z{=ve&)~uKgCg`+%wPQ$Vyl5m^%3>C3oD*i%8sUw)fn}AVi&+ZgmBz)gZ62_=nkJ7S zRR8GO%cPV24R`b7=oQj7-7am~+{ypov5^xK6LUt*xE5Q;zj}HP|2f+(Q_F31%DB|> zI+vqVYDLh!^nO|55g&0k90g}nbmV7Hg}<#$&JN8 zc-8I(N*v$-f#kp-5cY4;6#&r11rdCMb&#w(Eqx3PJ_xnKsdPpi9^r@g{(2a`@?*iV z21@5nx2>v;mEZV36=LbWri~rC%r0^kzSj7~%NlAXHRBqgFZTZQk>n!sQu!6v(HO)H z#6(M?Z0_TROV6SU`6{el>CRrzP!fk+Bi2>Y*JI!}ljnV#k8{k#EqhEy2 zj2gJ>_D_qj>AMKe!ijEy4+Uc)-1t9L4$qejk9 z)h4rBa=*I7r=k&9r|Dsne9tka_=6lNrQgi1*fVyt4AL){w4R!aqZn^;=ZLVN(W&Xn zo&p-T;rt#nP~Z=|zb7`xKOk7gBOrjqI@{Dn{w7_h#bUH&d+peqsYP#QEN|Yt>2ZaE z5rb}DvvTzD@!a3vcIu`*V!SS$NUGsuaz%B3P*`rG7~ZT>DAlBYBTi?1Ng=!^Ryv~iLZR~gS5|V_B zS=&=CJRgT`t?@?-Z-80tOh%FisX(!n!20`>7G-b8(?5v7>c@}LgKpM^#p6__>x^wR zJ>%)-nKAcJ0aHsz}Ds$$}$h=@Kz&Bx@EJByLITQjq$m1*#u#pEaI7(Fx=^T2TI z%!+rtZGYyv!ms;kdz^a2E;EWS-c|a-`{t+ets{_rmLpIt$WnQ$>AL=yinFW1)<0`!jqvEO%bxw_a+(x;+CDTX4kx%?rUCzC8 zu0!v~lz%y<6V|ofI)mY>pH-V27<#^;A<+vTG9LYL^s{Tz-RzI2SRh)KJ-EXIjLTDC zeIG=!e-K^=AV#PkphzqbYt!vc0i_Xiv=cK6COz$+NATHb%o;$;X zf1Z8O*UMq7T+xs5RtTJ8q7<;Gb|`zLWmdXYAhX&G%|ouC%4jN5F2^hg@C|(M!rz^_ zscDLmsG#R7pP!F1THB^|W#cT)o-H-qQMlp|S{>$mZ1lMH$@f_nB#{EDI#NJyyIDix zS$WjDlPI{k5|QBGV?w7G1wFsj@3$Hl>_AFfS?4BK}Ifqz#|HA`de(BzrR zQ-R@my>UNv_sQqK`+7SHfEmJ@bEq%|1wh{S-BFYUxcevU|CTCt@c)#pl;2omDabS7 zh^VS2$ywmXknnkpWe#+XUn@=97Phv!3P&wX9OPr}6p(NoT6tOR+@<$4(9rj`WnF3f zq-_G3%e18SP4LoVcgt9MQ7Ou&OH;q<1Y9N$X4CnHvdV2fNn6W=_se)*@1EQa{a24) zyQQhG5yB}SMy}EjhQ$h@bk3fS`fyDJe3zpg_4TNm(oV+y_(mxs$g)%Sa+*6c(A1z} zbn8tG2dirniuU^wpeMQik8Ht&kPvT@S1^lgLP@5=O$t!ZVqNU~80m|PNm=iFsoHv8D~d zi755(1Il7+tJL(!PfnM7Pt#qMDMVaf;#y#&`)4Z0yW^~K@0;J23joTE02UU*!3hKH zS~a`Pu&nyq_#ei-cLR1YX1URBoCnZh^QOIt?6Sww>fHzj$h23v_hz%tJ4+gO;{;%s z|IPkODEFqb^Y+{H6t4epm7S$~)7c5YBKK}^@qC}^dv{_#n{Nx*_-iM2`d~5Kz-JH$ O0$lX~zC{q$+rI!OOPz86 literal 0 HcmV?d00001