fix(core): сериализация конвертаций монитором класса WordPdfConverter
Публичный convert() теперь безопасен из нескольких потоков: секция после валидации (мост .doc + convertToStream) выполняется под монитором класса — общая FopFactory (per-render disableFontCache, имиджевые кеши) и её сброс в finally больше не могут пересечься с параллельным рендером. warmup() синхронизирован тем же монитором (реентельно). WordPdfValidator остаётся до монитора: stateless, вызывается параллельно HTTP-потоками. Регрессия — WordPdfConverterTest#concurrentConversions_twoThreadsBothSucceed. Комментарии ConversionService/AGENTS/repo-map приведены к новому контракту.
This commit is contained in:
@@ -23,13 +23,13 @@ import java.util.concurrent.TimeoutException;
|
||||
/**
|
||||
* Конвертация .docx-байтов в PDF-байты поверх {@code wordpdf-core}.
|
||||
*
|
||||
* <p>Конвертации СЕРИАЛИЗОВАНЫ однопоточным executor'ом — не «на всякий
|
||||
* случай»: каждая конвертация мутирует ГЛОБАЛЬНЫЙ реестр шрифтов docx4j
|
||||
* ({@code new BundledFontMapper()} заново добавляет системные шрифты
|
||||
* в {@code PhysicalFonts}, {@code BundledFonts.init()/restrictToBundled()}
|
||||
* их вычищают — WordPdfConverter.convertToStream, шаг 1 пайплайна). Параллельные конвертации
|
||||
* вырывают реестр друг у друга из-под рендера, ядро не потокобезопасно
|
||||
* by design. Регрессия — ConvertControllerTest#concurrentRequests_bothSucceed.</p>
|
||||
* <p>Конвертации СЕРИАЛИЗОВАНЫ однопоточным executor'ом: он держит очередь,
|
||||
* 503 при переполнении и timeout-семантику (backpressure). Само ядро при этом
|
||||
* сериализует конвертации внутренним монитором ({@code WordPdfConverter.class}:
|
||||
* глобальный реестр {@code PhysicalFonts}, общая FopFactory с имиджевыми
|
||||
* кешами и их сброс в finally мутируются под рендером), так что параллельные
|
||||
* вызовы ядра не приводят к порче вывода.
|
||||
* Регрессия — ConvertControllerTest#concurrentRequests_bothSucceed.</p>
|
||||
*
|
||||
* <p>Ошибки разделены по смыслу (требование к API): некорректный вход →
|
||||
* {@link ValidationException} (400), ошибка рендер-стадии →
|
||||
@@ -55,8 +55,9 @@ final class ConversionService {
|
||||
new ArrayBlockingQueue<>(QUEUE_CAPACITY));
|
||||
// Прогрев ядра — головой той же однопоточной очереди: первый реальный
|
||||
// запрос после деплоя становится за прогретым ядром (~50–300 мс вместо
|
||||
// 1,4–1,9 с) и гарантированно сериализован с конвертациями (ядро не
|
||||
// потокобезопасно). warmup() не бросает — Future никто не забирает;
|
||||
// 1,4–1,9 с); сериализация прогрева с конвертациями — тем же воркером
|
||||
// и монитором ядра (warmup() синхронизирован им же). warmup() не
|
||||
// бросает — Future никто не забирает;
|
||||
// запросы, пришедшие во время прогрева, ждут в очереди (штатная
|
||||
// семантика, лимит convert-timeout с запасом).
|
||||
this.workers.submit(WordPdfConverter::warmup);
|
||||
|
||||
Reference in New Issue
Block a user