Пин w:framePr: фрейм hAnchor=page позиционируется от края страницы #102
@@ -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`.
|
||||
|
||||
@@ -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: кэш `<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.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},
|
||||
|
||||
@@ -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);
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
Binary file not shown.
Reference in New Issue
Block a user