perf: warmup ядра + отключение мёртвых сканов шрифтов docx4j #92

Merged
pjandro merged 4 commits from perf/warmup-font-discovery-off into main 2026-11-03 23:44:48 +03:00
Collaborator
No description provided.
ai added 4 commits 2026-11-03 23:39:26 +03:00
BestMatchingMapper (static) при первом касании сканирует системные шрифты
и все jar'ы classpath'а (~100–140 мс на JVM плюс память реестра), а
BundledFonts.restrictToBundled() перед каждой конвертацией всё найденное
выбрасывает. Гейт-свойства discoverPhysicalFonts/discoverJarFonts ставим
в false в static-блоке WordPdfConverter (инициализация класса
предшествует первому new BundledFontMapper()). discoverJarFonts("fonts-symbol")
свойством не гейтится — символ-шрифт регистрируется и снимается restrict'ом
как раньше; живой реестр (Panose-путь) после restrict идентичен, всё
незамапленное — финальный fallback DejaVu Sans (прежняя стратегия).
Первая конвертация после старта JVM стоит 1,3–1,7 с (JAXB/XSLT/FOP/классы),
её платил первый запрос после деплоя. warmup() прогоняет весь пайплайн на
минимальном docx, собранном в байтах (фикстуры не задействованы), и греет
Java2D/PNG-энкодер для пре-рендера диаграмм. Идемпотентен (volatile флаг),
не бросает (провал — warn в JUL), артефакты отбрасываются. Ядро само себя
не прогревает — момент прогрева решает приложение.

Прогретая первая конвертация ru-plain.docx: 100 мс против ~1,4 с холодную.
ConversionService в конструкторе ставит WordPdfConverter.warmup() головой
той же однопоточной очереди: первый реальный запрос после деплоя — за
прогретым ядром (~50–300 мс вместо 1,4–1,9 с) и сериализован с
конвертациями. Тесту сатурации нужен сентинел после конструктора: прогрев
занимает слот воркера головой очереди.
docs: warmup + отключение discovery в инвариантах, pipeline и счётчиках
PR checks / web (pull_request) Successful in 45s
PR checks / java (pull_request) Successful in 1m53s
Main: tests, deploy, autotests / web (push) Successful in 34s
Main: tests, deploy, autotests / java (push) Successful in 1m7s
Main: tests, deploy, autotests / images-web (push) Successful in 31s
Main: tests, deploy, autotests / images-app (push) Successful in 51s
Main: tests, deploy, autotests / deploy (push) Successful in 2m30s
Main: tests, deploy, autotests / autotests (push) Successful in 1m48s
Main: tests, deploy, autotests / rollback (push) Has been skipped
1ecaa9e959
- инвариант: гейт-свойства discoverPhysicalFonts/discoverJarFonts в
  static-блоке WordPdfConverter (замер реестра 114 → 0+7 symbol);
- pipeline.md: шаг 1 (constructor больше не сканирует систему/jar'ы) +
  раздел warmup() с A/B-числами (0,13 с против 1,74 с);
- очередь app: warmup головой очереди;
- счётчики тестов: 59/891 (core 53/848, WordPdfConverterTest 77).

Покрытие (JaCoCo)

Модуль Строки Ветви Порог строк
wordpdf-core 94.9% 85.4% 90%
wordpdf-app 93.9% 86.2% 90%
<!-- jacoco-coverage --> ## Покрытие (JaCoCo) | Модуль | Строки | Ветви | Порог строк | |---|---|---|---| | wordpdf-core | 94.9% | 85.4% | 90% | | wordpdf-app | 93.9% | 86.2% | 90% |
pjandro merged commit 1ecaa9e959 into main 2026-11-03 23:44:48 +03:00
pjandro deleted branch perf/warmup-font-discovery-off 2026-11-03 23:44:48 +03:00
Sign in to join this conversation.
No Reviewers
No Label
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: pjandro/java-word-pdf#92