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
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:
@@ -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`.
|
- Единственный 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.
|
- `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`, иначе первый со шрифтами.
|
- 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()` идёт тем же потоком.
|
- `PhysicalFonts` — глобальный и мутируемый → конвертации сериализуются монитором `WordPdfConverter.class` внутри ядра (общая `FopFactory` и сброс её image-кешей — под тем же монитором); приложение держит однопоточный воркер ради 503/timeout; `warmup()` идёт тем же потоком.
|
||||||
- Страницы в валидаторе = `max(кэш docProps/app.xml, явные разрывы, lastRenderedPageBreak+1)`; правила StAX-подсчёта — `docs/agent/pipeline.md`.
|
- Страницы в валидаторе = `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`.
|
- Не чинить: `jc="distribute"`, `suff="tab"`/`lvlJc`, метрика «single», кернинг, `framePr`, `REF`/`SEQ`/`TOC`-кэш, руби-надстрочница, U+2188/U+218A — доказательства в `docs/agent/render-limitations.md`.
|
||||||
|
|||||||
@@ -188,6 +188,11 @@ public final class BundledFonts {
|
|||||||
* em-dash на шрифте ранa (Carlito) вместо fallback-DejaVu.
|
* em-dash на шрифте ранa (Carlito) вместо fallback-DejaVu.
|
||||||
* Шрифты, встроенные в docx, регистрируются при {@code load()} —
|
* Шрифты, встроенные в docx, регистрируются при {@code load()} —
|
||||||
* если чистить до load(), они останутся в реестре.
|
* если чистить до load(), они останутся в реестре.
|
||||||
|
* <p>Мутирует глобальный реестр {@code PhysicalFonts}: нельзя звать
|
||||||
|
* параллельно идущей {@code WordPdfConverter.convert()} — рендер
|
||||||
|
* начнёт терять шрифты. Внешний вызов рядом с идущей конвертацией
|
||||||
|
* обязан держать монитор {@code WordPdfConverter.class} — тот же,
|
||||||
|
* что сериализует конвертации.
|
||||||
*/
|
*/
|
||||||
public static synchronized void restrictToBundled() {
|
public static synchronized void restrictToBundled() {
|
||||||
if (!inited) {
|
if (!inited) {
|
||||||
@@ -232,10 +237,13 @@ public final class BundledFonts {
|
|||||||
|
|
||||||
/**
|
/**
|
||||||
* Зарегистрированный шрифт: семейство (lowercase) + начертание.
|
* Зарегистрированный шрифт: семейство (lowercase) + начертание.
|
||||||
|
* Синхронизирован с {@link #init()}: {@code VARIANTS} — обычный
|
||||||
|
* {@code HashMap}, наполняемый в {@code init()} под тем же монитором
|
||||||
|
* класса; без замка внешний читатель мог бы увидеть недобранную карту.
|
||||||
*
|
*
|
||||||
* @return PhysicalFont или null (если 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);
|
Map<String, PhysicalFont> m = VARIANTS.get(family);
|
||||||
return m == null ? null : m.get(variant);
|
return m == null ? null : m.get(variant);
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -38,6 +38,12 @@ import java.util.Map;
|
|||||||
* каталога {@link BundledFonts#init()} — поэтому класс не зависит от
|
* каталога {@link BundledFonts#init()} — поэтому класс не зависит от
|
||||||
* порядка шагов конвертации. TTF буферизуется в памяти и живёт до конца
|
* порядка шагов конвертации. TTF буферизуется в памяти и живёт до конца
|
||||||
* JVM (шрифты бандла конечны, {@link TrueTypeFont} намеренно не закрываем).
|
* JVM (шрифты бандла конечны, {@link TrueTypeFont} намеренно не закрываем).
|
||||||
|
*
|
||||||
|
* Потокобезопасен: {@link #of(String, String)} идёт под монитором класса
|
||||||
|
* (единый {@code CACHE}), {@code cmap} — {@code volatile} поле с
|
||||||
|
* идемпотентным пересчётом, а ленивые таблицы fontbox читаются под её
|
||||||
|
* внутренними замками ({@code TrueTypeFont.lockReadtable}, fontbox 3.x) —
|
||||||
|
* один экземпляр можно держать в нескольких потоках.
|
||||||
*/
|
*/
|
||||||
public final class GlyphFont {
|
public final class GlyphFont {
|
||||||
|
|
||||||
|
|||||||
@@ -11,6 +11,7 @@ import java.nio.file.Files;
|
|||||||
import java.nio.file.Path;
|
import java.nio.file.Path;
|
||||||
import java.util.List;
|
import java.util.List;
|
||||||
import java.util.Set;
|
import java.util.Set;
|
||||||
|
import java.util.concurrent.atomic.AtomicReference;
|
||||||
import java.util.stream.Collectors;
|
import java.util.stream.Collectors;
|
||||||
|
|
||||||
import org.docx4j.fonts.PhysicalFonts;
|
import org.docx4j.fonts.PhysicalFonts;
|
||||||
@@ -197,4 +198,37 @@ class BundledFontsTest {
|
|||||||
ctor.setAccessible(true);
|
ctor.setAccessible(true);
|
||||||
return ctor.newInstance(name, info, null);
|
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());
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
Reference in New Issue
Block a user