perf(core): срез декода растра, стримовый OLE-детект; heap -Xms2g -Xmx2g #98

Merged
pjandro merged 4 commits from perf/core-memory into main 2026-11-08 17:52:05 +03:00
Collaborator
No description provided.
ai added 1 commit 2026-11-08 16:21:08 +03:00
perf(core): срез декода растра, стримовый OLE-детект; heap -Xms2g -Xmx2g
PR checks / web (pull_request) Successful in 48s
PR checks / java (pull_request) Successful in 1m44s
8061a2fbe7
ChartImageHandler: для не-JPEG без кропа с ppi <= threshold (или без
размера в макете) PictureCompression.compress всегда возвращает null,
но сначала декодирует полный растр ImageIO — решение принимается по
26 байтам заголовка (PNG/GIF/BMP), растр не декодируется вовсе; JPEG
остаётся на штатном пути CR-029 (перекодировка «для размера» сохранена).

OleObjectNormalizer: детект <w:object — потоковым поиском окном 8 KiB
с перекрытием, без readAllBytes()+new String на каждую word/*.xml.

Heap: ENTRYPOINT -Xms2g -Xmx2g (вместо -XX:MaxRAMPercentage=70),
mem_limit 2g -> 3g (compose.yml, compose.dev.yml, прод-heredoc
main.yml) — фиксированный heap + запас под metaspace/native.

Отменённая ветка: переиспользование общей FopFactory между прогонами
копит шрифтовые данные форка FOP на каждый render (замер 2026-11:
после 30 конвертаций ~1,4 ГБ живых byte[] против 17 МБ при
per-conversion сборке, рост live-кучи, Full GC) — фабрика остаётся
per-conversion, инвариант зафиксирован комментарием.

GC-замер (java -jar, -Xms2g -Xmx2g, 30 конвертаций фикстур): young
5 против 7 на main, паузы 12,2 мс против 18,7 мс, Full GC нет на обоих.

Тесты: ChartImageHandlerTest +5 (PNG/GIF/BMP/JPEG/выше порога),
OleObjectNormalizerTest +1 (маркер через границу окна).

Покрытие (JaCoCo)

Модуль Строки Ветви Порог строк
wordpdf-core 95.0% 85.3% 90%
wordpdf-app 94.0% 86.2% 90%
<!-- jacoco-coverage --> ## Покрытие (JaCoCo) | Модуль | Строки | Ветви | Порог строк | |---|---|---|---| | wordpdf-core | 95.0% | 85.3% | 90% | | wordpdf-app | 94.0% | 86.2% | 90% |
ai added 1 commit 2026-11-08 17:06:32 +03:00
perf(core): общая FopFactory на JVM со сбросом имиджевых кешей
PR checks / web (pull_request) Successful in 39s
PR checks / java (pull_request) Successful in 1m31s
bc98a12421
Переиспользование FopFactory между конвертациями раньше запрещалось:
форк FOP копит на фабрике image-кеши (xmlgraphics-commons ImageCache:
imageInfos/images и ImageObjectCacheImpl), ключи записей — временные
файлы file:/tmp/<uuid>… с уникальным на конвертацию именем, попадания
не бывает никогда, а soft-ссылки не освобождаются при свободной куче
(2 ГБ фиксированная): после 30 конвертаций ~1,5 ГБ живых byte[]
против 17 МБ, рост live-кучи, Full GC.

Теперь фабрика одна на JVM, а каждая конвертация в finally вызывает
resetSharedImageCaches() — публичные clearCache() у ImageCache и
ImageObjectCacheImpl. Разбор шрифтов форка (GPOS, ~140k объектов)
теперь один раз на JVM. Замер после фикса: 16,8 МБ живых byte[],
heap used 89 МБ после 30 конвертаций, Full GC от нагрузки — 0.

Регрессии — WordPdfConverterTest#fopFactorySharedAcrossConversions,
#sharedImageCaches_clearedAfterConversion.
ai added 1 commit 2026-11-08 17:22:59 +03:00
fix(core): сериализация конвертаций монитором класса WordPdfConverter
PR checks / web (pull_request) Successful in 35s
PR checks / java (pull_request) Successful in 1m19s
2116ec43a4
Публичный convert() теперь безопасен из нескольких потоков: секция после
валидации (мост .doc + convertToStream) выполняется под монитором класса —
общая FopFactory (per-render disableFontCache, имиджевые кеши) и её сброс в
finally больше не могут пересечься с параллельным рендером. warmup()
синхронизирован тем же монитором (реентельно). WordPdfValidator остаётся
до монитора: stateless, вызывается параллельно HTTP-потоками.
Регрессия — WordPdfConverterTest#concurrentConversions_twoThreadsBothSucceed.
Комментарии ConversionService/AGENTS/repo-map приведены к новому контракту.
ai added 1 commit 2026-11-08 17:36:19 +03:00
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
8d2fa3dad9
Аудит потокобезопасности ядра: 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.
pjandro merged commit 8d2fa3dad9 into main 2026-11-08 17:52:05 +03:00
pjandro deleted branch perf/core-memory 2026-11-08 17:52:05 +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#98