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:
@@ -55,9 +55,13 @@ import java.util.zip.ZipOutputStream;
|
||||
* подменяются метрически совместимыми open-source аналогами
|
||||
* (см. {@link BundledFontMapper}).
|
||||
*
|
||||
* Класс stateless, все методы статические. Класс НЕ потокобезопасен:
|
||||
* конвертации из нескольких потоков необходимо сериализовать (глобальный
|
||||
* реестр {@code PhysicalFonts}, кэши шрифтов/покрытия).
|
||||
* Класс stateless, все методы статические. Публичные {@code convert()} можно
|
||||
* вызывать из нескольких потоков: сериализация обеспечена внутри ядра —
|
||||
* конвертации выполняются по одной под монитором класса (глобальный реестр
|
||||
* {@code PhysicalFonts}, общая FopFactory с имиджевыми кешами, сброс кеши в
|
||||
* finally). {@link #warmup()} синхронизирован тем же монитором.
|
||||
* {@link WordPdfValidator} stateless и выполняется до монитора — валидация
|
||||
* параллельна и не блокируется.
|
||||
*/
|
||||
public final class WordPdfConverter {
|
||||
|
||||
@@ -95,7 +99,8 @@ public final class WordPdfConverter {
|
||||
* файлы), поэтому кеш никогда не попадает и растёт на декодированный растр
|
||||
* каждого изображения (замер 2026-11: ~1,5 ГБ живых byte[] после 30
|
||||
* конвертаций с картинками). Поэтому каждая конвертация обязана вызвать
|
||||
* {@link #resetSharedImageCaches()} в finally.
|
||||
* {@link #resetSharedImageCaches()} в finally. Вызывается только под локом
|
||||
* конвертации (см. {@code convert}), сброс mid-render невозможен.
|
||||
* Регрессия — WordPdfConverterTest#sharedImageCaches_clearedAfterConversion.
|
||||
*/
|
||||
static FopFactory sharedFopFactory(final FOSettings foSettings) {
|
||||
@@ -121,6 +126,8 @@ public final class WordPdfConverter {
|
||||
* записи лежат в soft-ссылках, которые сборщик не трогает, пока свободная
|
||||
* куча велика (куча стенда фиксирована 2 ГБ). Сбросы публичные:
|
||||
* {@code ImageCache.clearCache()} и {@code ImageObjectCacheImpl.clearCache()}.
|
||||
* Вызывается исключительно из finally конвертации под локом (см.
|
||||
* {@code convert}) — параллельный рендер под сброс не попадает.
|
||||
* Регрессия — WordPdfConverterTest#sharedImageCaches_clearedAfterConversion.
|
||||
*/
|
||||
static void resetSharedImageCaches() {
|
||||
@@ -204,18 +211,26 @@ public final class WordPdfConverter {
|
||||
// .doc сбрасываются в кадре на этом же месте — детерминированно, до
|
||||
// рендера (точные liveness-карты HotSpot строит только для
|
||||
// скомпилированных кадров; отдельное присваивание null не нужно).
|
||||
docxBytes = WordPdfValidator.isBinaryDoc(docxBytes) ? DocToDocx.convert(docxBytes) : docxBytes;
|
||||
ByteArrayOutputStream bos = new ByteArrayOutputStream(Math.max(1 << 16, docxBytes.length));
|
||||
try {
|
||||
convertToStream(docxBytes, title, opts, bos);
|
||||
} catch (ConversionException e) {
|
||||
// ValidationException (отказ валидации входа) — подтип, уходит
|
||||
// вызывающему без обёртки
|
||||
throw e;
|
||||
} catch (Exception e) {
|
||||
throw new ConversionException("Не удалось конвертировать документ", e);
|
||||
// Единый лок ядра: реестр PhysicalFonts, общая FopFactory (per-render
|
||||
// disableFontCache, имиджевые кеши) и её сброс в finally мутируются под
|
||||
// рендером — параллельная конвертация обязана ждать, иначе чистит кеши
|
||||
// посреди чужого рендера. Монитор класса тот же, что у warmup()
|
||||
// (реентельно) и DCL в sharedFopFactory. Регрессия —
|
||||
// WordPdfConverterTest#concurrentConversions_twoThreadsBothSucceed.
|
||||
synchronized (WordPdfConverter.class) {
|
||||
docxBytes = WordPdfValidator.isBinaryDoc(docxBytes) ? DocToDocx.convert(docxBytes) : docxBytes;
|
||||
ByteArrayOutputStream bos = new ByteArrayOutputStream(Math.max(1 << 16, docxBytes.length));
|
||||
try {
|
||||
convertToStream(docxBytes, title, opts, bos);
|
||||
} catch (ConversionException e) {
|
||||
// ValidationException (отказ валидации входа) — подтип, уходит
|
||||
// вызывающему без обёртки
|
||||
throw e;
|
||||
} catch (Exception e) {
|
||||
throw new ConversionException("Не удалось конвертировать документ", e);
|
||||
}
|
||||
return bos.toByteArray();
|
||||
}
|
||||
return bos.toByteArray();
|
||||
}
|
||||
|
||||
/** Флаг «ядро прогрето»: повторные вызовы {@link #warmup()} — no-op. */
|
||||
@@ -228,9 +243,11 @@ public final class WordPdfConverter {
|
||||
* (JAXB/XSLT/FOP/классы), её платил первый запрос после деплоя. Прогоняет
|
||||
* пайплайн на минимальном docx, собранном в байтах (фикстуры тестов не
|
||||
* задействуются), и греет Java2D/PNG-энкодер для пре-рендера диаграмм.
|
||||
* Идемпотентен, никогда не бросает (провал — только warn); вызывать нужно
|
||||
* на том же потоке, на котором сериализованы конвертации (ядро не
|
||||
* потокобезопасно, см. {@code PhysicalFonts}). Артефакты (PDF, растр)
|
||||
* Идемпотентен, никогда не бросает (провал — только warn); метод
|
||||
* синхронизирован монитором класса — тем же, что сериализует конвертации
|
||||
* в {@code convert()}, так что прогрев гарантированно не пересекается с
|
||||
* рендером; приложение дополнительно держит warmup головой очереди.
|
||||
* Артефакты (PDF, растр)
|
||||
* отбрасываются. Ядро само {@code warmup()} не вызывает — момент прогрева
|
||||
* решает вызывающее приложение.
|
||||
*/
|
||||
|
||||
@@ -2792,4 +2792,42 @@ class WordPdfConverterTest {
|
||||
return ((Map<?, ?>) m.get(softCache)).size();
|
||||
}
|
||||
|
||||
/**
|
||||
* Две конвертации из разных потоков обязаны обе отработать корректно:
|
||||
* ядро сериализует их монитором класса (PhysicalFonts, общая FopFactory,
|
||||
* сброс image-кешей в finally). Регрессия — этот тест,
|
||||
* фикстуры samples/ru-plain.docx и samples/chart-types.docx.
|
||||
*/
|
||||
@Test
|
||||
void concurrentConversions_twoThreadsBothSucceed() throws Exception {
|
||||
byte[] plain = sampleBytes("ru-plain.docx");
|
||||
byte[] chart = sampleBytes("chart-types.docx");
|
||||
byte[][] out = new byte[2][];
|
||||
Runnable[] jobs = {
|
||||
() -> out[0] = WordPdfConverter.convert(plain, "ru-plain"),
|
||||
() -> out[1] = WordPdfConverter.convert(chart, "chart-types"),
|
||||
};
|
||||
Thread[] ts = new Thread[2];
|
||||
for (int i = 0; i < 2; i++) {
|
||||
ts[i] = new Thread(jobs[i]);
|
||||
ts[i].start();
|
||||
}
|
||||
for (Thread t : ts) {
|
||||
t.join();
|
||||
}
|
||||
assertTrue(out[0] != null && "%PDF".equals(new String(out[0], 0, 4, StandardCharsets.US_ASCII)),
|
||||
"поток 1 не вернул PDF");
|
||||
assertTrue(out[1] != null && "%PDF".equals(new String(out[1], 0, 4, StandardCharsets.US_ASCII)),
|
||||
"поток 2 не вернул PDF");
|
||||
assertTrue(norm(pdfTextBytes(out[0])).contains("Привет, мир!"), "поток 1: текст потерян");
|
||||
assertTrue(norm(pdfTextBytes(out[1])).contains("Типы диаграмм"), "поток 2: текст потерян");
|
||||
}
|
||||
|
||||
/** Текст PDF из байтов (PDFBox) — для результатов прямого convert(). */
|
||||
private static String pdfTextBytes(byte[] pdf) throws IOException {
|
||||
try (PDDocument doc = Loader.loadPDF(pdf)) {
|
||||
return new PDFTextStripper().getText(doc);
|
||||
}
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user