From 8d2fa3dad9b2fda90010266168c45dd1052c0b93 Mon Sep 17 00:00:00 2001 From: Pjandro Date: Sun, 8 Nov 2026 14:36:15 +0000 Subject: [PATCH] =?UTF-8?q?fix(core):=20=D1=81=D0=B8=D0=BD=D1=85=D1=80?= =?UTF-8?q?=D0=BE=D0=BD=D0=B8=D0=B7=D0=B0=D1=86=D0=B8=D1=8F=20=D1=87=D1=82?= =?UTF-8?q?=D0=B5=D0=BD=D0=B8=D1=8F=20=D1=80=D0=B5=D0=B5=D1=81=D1=82=D1=80?= =?UTF-8?q?=D0=B0=20=D0=BD=D0=B0=D1=87=D0=B5=D1=80=D1=82=D0=B0=D0=BD=D0=B8?= =?UTF-8?q?=D0=B9=20BundledFonts.font?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Аудит потокобезопасности ядра: font()/regular()/... читали VARIANTS (HashMap, пишется в init() под монитором BundledFonts.class) без замка — публичный API гонял с init(). font() стал synchronized (делегаты regular/bold/italic/boldItalic идут через него). Контракты зафиксированы javadoc: restrictToBundled() рядом с идущей конвертацией — только под монитором WordPdfConverter.class; потокобезопасность GlyphFont (монитор of(), volatile cmap, внутренние замки fontbox lockReadtable). Инвариант — AGENTS.md. Тест concurrentFontApi_callsAllSucceed — 4 потока × 50 итераций font-API. Регрессия — BundledFontsTest#concurrentFontApi_callsAllSucceed. --- AGENTS.md | 2 +- .../pjandro/wordpdf/fonts/BundledFonts.java | 10 +++++- .../ru/pjandro/wordpdf/fonts/GlyphFont.java | 6 ++++ .../wordpdf/fonts/BundledFontsTest.java | 34 +++++++++++++++++++ 4 files changed, 50 insertions(+), 2 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index be3fabc..1abe1b7 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -51,7 +51,7 @@ Java2D → PNG: `ChartRenderer.DPI = 300`, потолок `MAX_PIXELS = 16_777_2 - Единственный XSL-FO-стилист — вендорный `xslt/docx2fo.xslt` (копия из docx4j-export-fo 17.3.2 + два AUDIT-FIX-патча: `w:rPr/w:position` → `baseline-shift`, Part 1 §17.3.2.24; AUDIT-FIX-2 — `w:moveFrom`/`w:moveTo`/`w:bdo`/`w:dir`, иначе их ловит catch-all `match="*"` и текст теряется). Дрейф-гейт `vendoredXsltTracksJarCopy`: вне AUDIT-FIX-регионов копия побайтно равна стилю из jar'а. `setCustomXsltTemplates` принимает предкомпилированный `Templates`. - `slf4j-simple` обязателен в ядре: без SLF4J-провайдера docx4j пишет «TO HIDE THESE MESSAGES» прямо в PDF (регрессия `noLoggingWarningInPdf`); приложение исключает его — логи ведёт logback. - FOP — форк `org.docx4j:docx4j-fo-renderer*` 2.11-docx4j.6 (транзитив от `docx4j-export-fo`, в pom не пинится; пакеты `org.apache.fop.*`). `FopFallbackFonts` берёт `w:renderer` с mime `application/pdf`, иначе первый со шрифтами. -- `BundledFonts.init()` идемпотентен и `synchronized`, распаковывает TTF в `wordpdf-fonts-*` (`deleteOnExit`); `dropNonBundled()` чистит `PhysicalFonts` от всего, что вне бандла. +- `BundledFonts.init()` идемпотентен и `synchronized`, распаковывает TTF в `wordpdf-fonts-*` (`deleteOnExit`); `dropNonBundled()` чистит `PhysicalFonts` от всего, что вне бандла; `font()`/`regular()`/... синхронизированы с `init()` (реестр `VARIANTS`). Внешние `init()`/`restrictToBundled()` во время идущих конвертаций — только под монитором `WordPdfConverter.class`. - `PhysicalFonts` — глобальный и мутируемый → конвертации сериализуются монитором `WordPdfConverter.class` внутри ядра (общая `FopFactory` и сброс её image-кешей — под тем же монитором); приложение держит однопоточный воркер ради 503/timeout; `warmup()` идёт тем же потоком. - Страницы в валидаторе = `max(кэш docProps/app.xml, явные разрывы, lastRenderedPageBreak+1)`; правила StAX-подсчёта — `docs/agent/pipeline.md`. - Не чинить: `jc="distribute"`, `suff="tab"`/`lvlJc`, метрика «single», кернинг, `framePr`, `REF`/`SEQ`/`TOC`-кэш, руби-надстрочница, U+2188/U+218A — доказательства в `docs/agent/render-limitations.md`. diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java index c8176be..d78e3df 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java @@ -188,6 +188,11 @@ public final class BundledFonts { * em-dash на шрифте ранa (Carlito) вместо fallback-DejaVu. * Шрифты, встроенные в docx, регистрируются при {@code load()} — * если чистить до load(), они останутся в реестре. + *

Мутирует глобальный реестр {@code PhysicalFonts}: нельзя звать + * параллельно идущей {@code WordPdfConverter.convert()} — рендер + * начнёт терять шрифты. Внешний вызов рядом с идущей конвертацией + * обязан держать монитор {@code WordPdfConverter.class} — тот же, + * что сериализует конвертации. */ public static synchronized void restrictToBundled() { if (!inited) { @@ -232,10 +237,13 @@ public final class BundledFonts { /** * Зарегистрированный шрифт: семейство (lowercase) + начертание. + * Синхронизирован с {@link #init()}: {@code VARIANTS} — обычный + * {@code HashMap}, наполняемый в {@code init()} под тем же монитором + * класса; без замка внешний читатель мог бы увидеть недобранную карту. * * @return PhysicalFont или null (если init() не вызван или шрифта нет) */ - public static PhysicalFont font(String family, String variant) { + public static synchronized PhysicalFont font(String family, String variant) { Map m = VARIANTS.get(family); return m == null ? null : m.get(variant); } diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/GlyphFont.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/GlyphFont.java index 30a2b07..91215b0 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/GlyphFont.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/GlyphFont.java @@ -38,6 +38,12 @@ import java.util.Map; * каталога {@link BundledFonts#init()} — поэтому класс не зависит от * порядка шагов конвертации. TTF буферизуется в памяти и живёт до конца * JVM (шрифты бандла конечны, {@link TrueTypeFont} намеренно не закрываем). + * + * Потокобезопасен: {@link #of(String, String)} идёт под монитором класса + * (единый {@code CACHE}), {@code cmap} — {@code volatile} поле с + * идемпотентным пересчётом, а ленивые таблицы fontbox читаются под её + * внутренними замками ({@code TrueTypeFont.lockReadtable}, fontbox 3.x) — + * один экземпляр можно держать в нескольких потоках. */ public final class GlyphFont { diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/fonts/BundledFontsTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/fonts/BundledFontsTest.java index 39a2217..c7765ba 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/fonts/BundledFontsTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/fonts/BundledFontsTest.java @@ -11,6 +11,7 @@ import java.nio.file.Files; import java.nio.file.Path; import java.util.List; import java.util.Set; +import java.util.concurrent.atomic.AtomicReference; import java.util.stream.Collectors; import org.docx4j.fonts.PhysicalFonts; @@ -197,4 +198,37 @@ class BundledFontsTest { ctor.setAccessible(true); return ctor.newInstance(name, info, null); } + + /** + * Публичный font-API под конкурентным боем: font()/GlyphFont.of()/ + * canDisplay()/advance() из четырёх потоков обязаны не ронять и не + * подменять состояние (гарды: synchronized font(), монитор of(), + * внутренние замки fontbox). Регрессия — этот тест. + */ + @Test + void concurrentFontApi_callsAllSucceed() throws Exception { + AtomicReference boom = new AtomicReference<>(); + Thread[] ts = new Thread[4]; + for (int i = 0; i < 4; i++) { + ts[i] = new Thread(() -> { + try { + for (int k = 0; k < 50; k++) { + assertNotNull(BundledFonts.regular("carlito"), "regular null"); + GlyphFont f = GlyphFont.of("carlito", BundledFonts.V_REGULAR); + assertNotNull(f, "GlyphFont null"); + assertTrue(f.canDisplay('А'), "carlito обязан покрывать «А»"); + assertTrue(f.advance("Тест", 11.0) > 0, "нулевая ширина"); + assertEquals(9, BundledFonts.families().size(), "семейств бандла"); + } + } catch (Throwable t) { + boom.compareAndSet(null, t); + } + }); + ts[i].start(); + } + for (Thread t : ts) { + t.join(); + } + assertNull(boom.get(), "конкурентный font-API бросил: " + boom.get()); + } }