perf: warmup ядра + отключение мёртвых сканов шрифтов docx4j #92
@@ -11,6 +11,7 @@ import org.docx4j.convert.out.fo.renderers.FORendererApacheFOP;
|
|||||||
import org.docx4j.openpackaging.packages.WordprocessingMLPackage;
|
import org.docx4j.openpackaging.packages.WordprocessingMLPackage;
|
||||||
import ru.pjandro.wordpdf.fonts.BundledFontMapper;
|
import ru.pjandro.wordpdf.fonts.BundledFontMapper;
|
||||||
import ru.pjandro.wordpdf.fonts.BundledFonts;
|
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.ChartImageHandler;
|
||||||
import ru.pjandro.wordpdf.internal.chart.DrawingPreRenderer;
|
import ru.pjandro.wordpdf.internal.chart.DrawingPreRenderer;
|
||||||
import ru.pjandro.wordpdf.internal.DependencyGuard;
|
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.FopFallbackFonts;
|
||||||
import ru.pjandro.wordpdf.internal.LayoutPostRenderer;
|
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.ByteArrayInputStream;
|
||||||
import java.io.ByteArrayOutputStream;
|
import java.io.ByteArrayOutputStream;
|
||||||
|
import java.io.IOException;
|
||||||
import javax.xml.transform.Templates;
|
import javax.xml.transform.Templates;
|
||||||
import javax.xml.transform.stream.StreamSource;
|
import javax.xml.transform.stream.StreamSource;
|
||||||
|
import javax.imageio.ImageIO;
|
||||||
import java.io.InputStream;
|
import java.io.InputStream;
|
||||||
import java.io.OutputStream;
|
import java.io.OutputStream;
|
||||||
|
import java.nio.charset.StandardCharsets;
|
||||||
import java.util.List;
|
import java.util.List;
|
||||||
|
import java.util.logging.Logger;
|
||||||
|
import java.util.zip.ZipEntry;
|
||||||
|
import java.util.zip.ZipOutputStream;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Конвертер docx -> PDF на базе docx4j + Apache FOP
|
* Конвертер docx -> PDF на базе docx4j + Apache FOP
|
||||||
@@ -155,6 +166,106 @@ public final class WordPdfConverter {
|
|||||||
return bos.toByteArray();
|
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 = """
|
||||||
|
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\
|
||||||
|
<Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types">\
|
||||||
|
<Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/>\
|
||||||
|
<Default Extension="xml" ContentType="application/xml"/>\
|
||||||
|
<Override PartName="/word/document.xml" \
|
||||||
|
ContentType="application/vnd.openxmlformats-officedocument.wordprocessingml.document.main+xml"/>\
|
||||||
|
</Types>""";
|
||||||
|
|
||||||
|
private static final String WARMUP_ROOT_RELS = """
|
||||||
|
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\
|
||||||
|
<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">\
|
||||||
|
<Relationship Id="rId1" \
|
||||||
|
Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" \
|
||||||
|
Target="word/document.xml"/>\
|
||||||
|
</Relationships>""";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Текст ранa: алиас Calibri→Carlito прогревает маппер и embed-подмножество
|
||||||
|
* Carlito; em dash (U+2014) — обычный глиф Carlito, а fallback-путь для
|
||||||
|
* U+2000–U+2EFF декларируется {@code FopFallbackFonts.declare} на каждом
|
||||||
|
* конверте и прогревается самим прогоном.
|
||||||
|
*/
|
||||||
|
private static final String WARMUP_DOCUMENT = """
|
||||||
|
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>\
|
||||||
|
<w:document xmlns:w="http://schemas.openxmlformats.org/wordprocessingml/2006/main">\
|
||||||
|
<w:body><w:p><w:r><w:rPr><w:rFonts w:ascii="Calibri" w:hAnsi="Calibri"/></w:rPr>\
|
||||||
|
<w:t>Warmup text with em dash — for font subsetting.</w:t></w:r></w:p>\
|
||||||
|
<w:sectPr><w:pgSz w:w="11906" w:h="16838"/>\
|
||||||
|
<w:pgMar w:top="1440" w:right="1440" w:bottom="1440" w:left="1440" \
|
||||||
|
w:header="720" w:footer="720" w:gutter="0"/></w:sectPr></w:body></w:document>""";
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Прогрев 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 — проверка
|
* Ядро конвертации: docx -> XSL-FO -> FOP -> PDF в поток. Шаг 0 — проверка
|
||||||
* совместимости commons-compress в classpath потребителя (DependencyGuard):
|
* совместимости commons-compress в classpath потребителя (DependencyGuard):
|
||||||
|
|||||||
@@ -533,6 +533,14 @@ class WordPdfConverterTest {
|
|||||||
assertTrue(text.contains("quick brown fox"), fixture + ": нет «quick brown fox»: " + text);
|
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
|
@Test
|
||||||
void mixed_headingListTable() throws Exception {
|
void mixed_headingListTable() throws Exception {
|
||||||
assertHeadingListTable("ru-en-mixed.docx");
|
assertHeadingListTable("ru-en-mixed.docx");
|
||||||
|
|||||||
Reference in New Issue
Block a user