From 1f00512a6649f07798c5593bc348997b45210963 Mon Sep 17 00:00:00 2001 From: Pjandro Date: Tue, 3 Nov 2026 20:23:59 +0000 Subject: [PATCH] =?UTF-8?q?perf(core):=20WordPdfConverter.warmup()=20?= =?UTF-8?q?=E2=80=94=20=D0=BF=D1=80=D0=BE=D0=B3=D1=80=D0=B5=D0=B2=20=D1=8F?= =?UTF-8?q?=D0=B4=D1=80=D0=B0=20=D0=BC=D0=B8=D0=BD=D0=B8=D0=BC=D0=B0=D0=BB?= =?UTF-8?q?=D1=8C=D0=BD=D1=8B=D0=BC=20docx?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Первая конвертация после старта JVM стоит 1,3–1,7 с (JAXB/XSLT/FOP/классы), её платил первый запрос после деплоя. warmup() прогоняет весь пайплайн на минимальном docx, собранном в байтах (фикстуры не задействованы), и греет Java2D/PNG-энкодер для пре-рендера диаграмм. Идемпотентен (volatile флаг), не бросает (провал — warn в JUL), артефакты отбрасываются. Ядро само себя не прогревает — момент прогрева решает приложение. Прогретая первая конвертация ru-plain.docx: 100 мс против ~1,4 с холодную. --- .../ru/pjandro/wordpdf/WordPdfConverter.java | 111 ++++++++++++++++++ .../pjandro/wordpdf/WordPdfConverterTest.java | 8 ++ 2 files changed, 119 insertions(+) diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java index fd09cbc..5dc60b3 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java @@ -11,6 +11,7 @@ import org.docx4j.convert.out.fo.renderers.FORendererApacheFOP; import org.docx4j.openpackaging.packages.WordprocessingMLPackage; import ru.pjandro.wordpdf.fonts.BundledFontMapper; import ru.pjandro.wordpdf.fonts.BundledFonts; +import ru.pjandro.wordpdf.fonts.GlyphFont; import ru.pjandro.wordpdf.internal.chart.ChartImageHandler; import ru.pjandro.wordpdf.internal.chart.DrawingPreRenderer; import ru.pjandro.wordpdf.internal.DependencyGuard; @@ -21,13 +22,23 @@ import ru.pjandro.wordpdf.internal.OleObjectNormalizer; import ru.pjandro.wordpdf.internal.FopFallbackFonts; import ru.pjandro.wordpdf.internal.LayoutPostRenderer; +import java.awt.Graphics2D; +import java.awt.RenderingHints; +import java.awt.geom.Ellipse2D; +import java.awt.image.BufferedImage; import java.io.ByteArrayInputStream; import java.io.ByteArrayOutputStream; +import java.io.IOException; import javax.xml.transform.Templates; import javax.xml.transform.stream.StreamSource; +import javax.imageio.ImageIO; import java.io.InputStream; import java.io.OutputStream; +import java.nio.charset.StandardCharsets; import java.util.List; +import java.util.logging.Logger; +import java.util.zip.ZipEntry; +import java.util.zip.ZipOutputStream; /** * Конвертер docx -> PDF на базе docx4j + Apache FOP @@ -155,6 +166,106 @@ public final class WordPdfConverter { return bos.toByteArray(); } + /** Флаг «ядро прогрето»: повторные вызовы {@link #warmup()} — no-op. */ + private static volatile boolean warmedUp; + + private static final Logger LOG = Logger.getLogger(WordPdfConverter.class.getName()); + + /** + * Прогрев ядра: первая конвертация после старта JVM стоит 1,3–1,7 с + * (JAXB/XSLT/FOP/классы), её платил первый запрос после деплоя. Прогоняет + * пайплайн на минимальном docx, собранном в байтах (фикстуры тестов не + * задействуются), и греет Java2D/PNG-энкодер для пре-рендера диаграмм. + * Идемпотентен, никогда не бросает (провал — только warn); вызывать нужно + * на том же потоке, на котором сериализованы конвертации (ядро не + * потокобезопасно, см. {@code PhysicalFonts}). Артефакты (PDF, растр) + * отбрасываются. Ядро само {@code warmup()} не вызывает — момент прогрева + * решает вызывающее приложение. + */ + public static synchronized void warmup() { + if (warmedUp) { + return; + } + try { + convert(warmupDocx(), "warmup"); + warmRaster(); + warmedUp = true; + } catch (Throwable t) { + // Провал прогрева не должен валить старт приложения: в худшем + // случае первый запрос заплатит холодный путь, как платил до + // появления warmup(). + LOG.warning("Прогрев ядра не выполнен: " + t); + } + } + + /** Минимальный docx прогрева: три обязательные части, собранные в zip. */ + private static byte[] warmupDocx() throws IOException { + ByteArrayOutputStream bos = new ByteArrayOutputStream(1 << 10); + try (ZipOutputStream zip = new ZipOutputStream(bos, StandardCharsets.UTF_8)) { + putWarmupEntry(zip, "[Content_Types].xml", WARMUP_CONTENT_TYPES); + putWarmupEntry(zip, "_rels/.rels", WARMUP_ROOT_RELS); + putWarmupEntry(zip, "word/document.xml", WARMUP_DOCUMENT); + } + return bos.toByteArray(); + } + + private static void putWarmupEntry(ZipOutputStream zip, String name, String xml) + throws IOException { + zip.putNextEntry(new ZipEntry(name)); + zip.write(xml.getBytes(StandardCharsets.UTF_8)); + zip.closeEntry(); + } + + /** Маркер {@code wordprocessingml.document} — требование WordPdfValidator. */ + private static final String WARMUP_CONTENT_TYPES = """ + \ + \ + \ + \ + \ + """; + + private static final String WARMUP_ROOT_RELS = """ + \ + \ + \ + """; + + /** + * Текст ранa: алиас Calibri→Carlito прогревает маппер и embed-подмножество + * Carlito; em dash (U+2014) — обычный глиф Carlito, а fallback-путь для + * U+2000–U+2EFF декларируется {@code FopFallbackFonts.declare} на каждом + * конверте и прогревается самим прогоном. + */ + private static final String WARMUP_DOCUMENT = """ + \ + \ + \ + Warmup text with em dash — for font subsetting.\ + \ + """; + + /** + * Прогрев Java2D/PNG-энкодера: первый «чартный» документ после старта + * иначе платит ещё ~200 мс холодного растрового пути (пре-рендер + * диаграмм — raster + {@link GlyphFont}). Растер headless-безопасен, + * fontconfig не нужен (глифы — fontbox, см. javadoc {@link GlyphFont}). + */ + private static void warmRaster() throws IOException { + BufferedImage img = new BufferedImage(64, 64, BufferedImage.TYPE_INT_ARGB); + Graphics2D g = img.createGraphics(); + g.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON); + g.fill(new Ellipse2D.Double(4, 4, 32, 32)); + GlyphFont.of(BundledFonts.FALLBACK_FAMILY, BundledFonts.V_REGULAR) + .draw(g, "Warmup", 2, 30, 12); + g.dispose(); + ImageIO.write(img, "png", new ByteArrayOutputStream()); + } + /** * Ядро конвертации: docx -> XSL-FO -> FOP -> PDF в поток. Шаг 0 — проверка * совместимости commons-compress в classpath потребителя (DependencyGuard): diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java index f3810ee..01f58b0 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/WordPdfConverterTest.java @@ -533,6 +533,14 @@ class WordPdfConverterTest { assertTrue(text.contains("quick brown fox"), fixture + ": нет «quick brown fox»: " + text); } + @Test + void warmup_idempotentAndPipelineIntact() throws Exception { + WordPdfConverter.warmup(); + WordPdfConverter.warmup(); // повторный вызов — no-op, не бросает + // прогрев не сломал штатный путь: конвертация прогретым ядром + assertEnglishText("en-plain.docx"); + } + @Test void mixed_headingListTable() throws Exception { assertHeadingListTable("ru-en-mixed.docx");