Шрифты: restrictToBundled() чистит реестр PhysicalFonts от системных перед load()

Конструктор BundledFontMapper каждый раз заново обнаруживает системные
шрифты; на Windows найденный Calibri покрывает U+2000-U+2EFF, и
RunFontSelector оставляет em-dash на Carlito вместо fallback-DejaVu
(красный ruPlain_emDashEmbeddedNotHelvetica). Очистка реестра после
init() и до load() делает вывод одинаковым на любой ОС; шрифты,
встроенные в docx, регистрируются при load() и остаются в реестре.
This commit is contained in:
Pjandro
2026-10-02 19:51:24 +00:00
parent fe5c7c48b0
commit 2d446d783c
3 changed files with 32 additions and 1 deletions
+1 -1
View File
@@ -27,7 +27,7 @@
## Архитектура (неочевидное) ## Архитектура (неочевидное)
- Пайплайн: байты docx → `DocxOnOffNormalizer` → docx4j → XSL-FO (XSLT) → FOP → PDF. - Пайплайн: байты docx → `DocxOnOffNormalizer` → docx4j → XSL-FO (XSLT) → FOP → PDF.
- Порядок инициализации в `WordPdfConverter.convertToStream` важен: сначала `new BundledFontMapper()`, потом `BundledFonts.init()` (бандл-шрифты регистрируются поверх системных). Не менять местами. - Порядок инициализации в `WordPdfConverter.convertToStream` важен: сначала `new BundledFontMapper()`, потом `BundledFonts.init()` (бандл-шрифты регистрируются поверх системных), затем `BundledFonts.restrictToBundled()` (чистит реестр `PhysicalFonts` от системных шрифтов до `load()`; конструктор маппера каждый раз заново добавляет их, и `GlyphCheck` на Windows находит системный Calibri — em-dash остаётся на Carlito, красный `ruPlain_emDashEmbeddedNotHelvetica`). Не менять местами.
- docx4j 11.x теряет атрибуты `w:val="off"/"on"` при JAXB-разборе — поэтому нужна нормализация байтов до загрузки (регрессионный тест `ruPlain_regularRunsUseRegularFont`). - docx4j 11.x теряет атрибуты `w:val="off"/"on"` при JAXB-разборе — поэтому нужна нормализация байтов до загрузки (регрессионный тест `ruPlain_regularRunsUseRegularFont`).
- Не убирать shade-фильтры `META-INF/*.SF|*.DSA|*.RSA` — подписанные jar-файлы зависимостей ломают fat-jar. - Не убирать shade-фильтры `META-INF/*.SF|*.DSA|*.RSA` — подписанные jar-файлы зависимостей ломают fat-jar.
@@ -86,6 +86,10 @@ public final class WordPdfConverter {
// регистрируются поверх них (имеют приоритет). // регистрируются поверх них (имеют приоритет).
BundledFontMapper mapper = new BundledFontMapper(); BundledFontMapper mapper = new BundledFontMapper();
BundledFonts.init(); BundledFonts.init();
// Реестр чистим от системных шрифтов до load(): иначе на системах
// с установленным Calibri GlyphCheck находит системный шрифт и
// em-dash (U+2000–U+2EFF) остаётся на шрифте ранa вместо fallback.
BundledFonts.restrictToBundled();
// 2. Загрузка документа. Предварительно нормализуем w:val="off"/"on" // 2. Загрузка документа. Предварительно нормализуем w:val="off"/"on"
// в "false"/"true": docx4j 11.x теряет атрибуты "off"/"on" // в "false"/"true": docx4j 11.x теряет атрибуты "off"/"on"
@@ -159,6 +159,33 @@ public final class BundledFonts {
inited = true; inited = true;
} }
/**
* Удаляет из реестра docx4j все шрифты вне бандла (системные, которые
* обнаружил конструктор {@link BundledFontMapper}). Вызывать при каждом
* конвертировании после {@link #init()} и до загрузки docx: конструктор
* маппера запускает обнаружение системных шрифтов заново, а
* {@code GlyphCheck}/{@code BestMatchingMapper} читают именно реестр.
* Без очистки конвертация зависит от системы: на Windows установленный
* Calibri находится в реестре, {@code RunFontSelector} оставляет
* em-dash на шрифте ранa (Carlito) вместо fallback-DejaVu.
* Шрифты, встроенные в docx, регистрируются при {@code load()} —
* если чистить до load(), они останутся в реестре.
*/
public static synchronized void restrictToBundled() {
if (!inited) {
return;
}
String bundlePrefix = extractDir.toUri().toString();
java.util.Iterator<Map.Entry<String, PhysicalFont>> it =
PhysicalFonts.getPhysicalFonts().entrySet().iterator();
while (it.hasNext()) {
java.net.URI uri = it.next().getValue().getEmbeddedURI();
if (uri == null || !uri.toString().startsWith(bundlePrefix)) {
it.remove();
}
}
}
/** Находит в реестре docx4j шрифт по имени файла (embeddedURI). */ /** Находит в реестре docx4j шрифт по имени файла (embeddedURI). */
private static PhysicalFont findByFile(String filename) { private static PhysicalFont findByFile(String filename) {
for (PhysicalFont pf : PhysicalFonts.getPhysicalFonts().values()) { for (PhysicalFont pf : PhysicalFonts.getPhysicalFonts().values()) {