fix(core): синхронизация чтения реестра начертаний BundledFonts.font
PR checks / web (pull_request) Successful in 38s
PR checks / java (pull_request) Successful in 1m20s
Main: tests, deploy, autotests / web (push) Successful in 36s
Main: tests, deploy, autotests / images-web (push) Successful in 35s
Main: tests, deploy, autotests / java (push) Successful in 1m25s
Main: tests, deploy, autotests / images-app (push) Successful in 41s
Main: tests, deploy, autotests / deploy (push) Successful in 1m42s
Main: tests, deploy, autotests / autotests (push) Successful in 44s
Main: tests, deploy, autotests / rollback (push) Has been skipped

Аудит потокобезопасности ядра: 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.
This commit was merged in pull request #98.
This commit is contained in:
Pjandro
2026-11-08 14:36:15 +00:00
parent 2116ec43a4
commit 8d2fa3dad9
4 changed files with 50 additions and 2 deletions
@@ -188,6 +188,11 @@ public final class BundledFonts {
* em-dash на шрифте ранa (Carlito) вместо fallback-DejaVu.
* Шрифты, встроенные в docx, регистрируются при {@code load()} —
* если чистить до load(), они останутся в реестре.
* <p>Мутирует глобальный реестр {@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<String, PhysicalFont> m = VARIANTS.get(family);
return m == null ? null : m.get(variant);
}
@@ -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 {
@@ -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<Throwable> 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());
}
}