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 d6722b5..bc7743c 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/WordPdfConverter.java @@ -114,11 +114,6 @@ public final class WordPdfConverter { * документ длиннее {@code options.maxPages()} страниц * @throws ConversionException прочие ошибки (битый .docx, ошибка рендера) */ - // PMD.UnusedAssignment глушится намеренно: зануление docxBytes ниже — - // не «мёртвое присваивание», а детерминированное освобождение массива до - // моста/рендера (точные liveness-карты HotSpot строит только для - // скомпилированных кадров). - @SuppressWarnings("PMD.UnusedAssignment") public static byte[] convert(byte[] docxBytes, String title, ConvertOptions options) throws ConversionException { ConvertOptions opts = options == null ? ConvertOptions.defaults() : options; // Полная проверка входа — одна на оба формата: размер до @@ -126,19 +121,17 @@ public final class WordPdfConverter { // лимита), затем для .docx — zip/контейнер/страницы, для .doc — // страницы по чистому бинарному документу (до конвертации). WordPdfValidator.validate(docxBytes, opts); - boolean fromDoc = WordPdfValidator.isBinaryDoc(docxBytes); // Бинарный .doc (Word 97–2003): мост internal.doc. Сгенерированный // .docx — собственный артефакт, его штатной валидацией входа не - // проверяем (вход уже проверен по байтам .doc). - byte[] docx = fromDoc ? DocToDocx.convert(docxBytes) : docxBytes; - // Сырой вход (.doc до конвертации в docx тоже был в куче) больше не - // читается — обнуляем явно: точные liveness-карты HotSpot строит - // только для скомпилированных кадров, без этого ссылка доживала бы до - // конца метода, пережив и мост, и FOP-рендер. - docxBytes = null; - ByteArrayOutputStream bos = new ByteArrayOutputStream(Math.max(1 << 16, docx.length)); + // проверяем (вход уже проверен по байтам .doc). Переиспользование слота + // docxBytes: результат моста становится в тот же слот, и сырые байты + // .doc сбрасываются в кадре на этом же месте — детерминированно, до + // рендера (точные liveness-карты HotSpot строит только для + // скомпилированных кадров; отдельное присваивание null не нужно). + docxBytes = WordPdfValidator.isBinaryDoc(docxBytes) ? DocToDocx.convert(docxBytes) : docxBytes; + ByteArrayOutputStream bos = new ByteArrayOutputStream(Math.max(1 << 16, docxBytes.length)); try { - convertToStream(docx, title, opts, bos); + convertToStream(docxBytes, title, opts, bos); } catch (ConversionException e) { // ValidationException (отказ валидации входа) — подтип, уходит // вызывающему без обёртки @@ -154,10 +147,6 @@ public final class WordPdfConverter { * совместимости commons-compress в classpath потребителя (DependencyGuard): * без неё старая версия библиотеки дала бы мутный NoSuchMethodError внутри docx4j. */ - // PMD.UnusedAssignment глушится намеренно: зануление rawDocxBytes/docxBytes - // — детерминированное освобождение байтов входа до load()/рендера, а не - // «мёртвое присваивание» (см. javadoc convert). - @SuppressWarnings("PMD.UnusedAssignment") private static void convertToStream(byte[] rawDocxBytes, String title, ConvertOptions options, OutputStream os) throws Exception { // 0. Совместимость commons-compress: docx4j требует ковариантный @@ -176,20 +165,12 @@ public final class WordPdfConverter { // 2. Загрузка документа: один zip-проход переписывания XML-частей // (DocxRewritePipeline) + условная OLE-вычистка (OleObjectNormalizer) - // — дальше лежит transitional-байт, готовый для JAXB/docx4j. - byte[] docxBytes = rawDocxBytes; - for (DocxNormalizer normalizer : normalizers(options)) { - docxBytes = normalizer.normalize(docxBytes); - } - // Исходные байты до нормализации больше не читаются — освобождаем явно - // (без них при .doc-входе в куче жили бы и .doc, и нормализованный .docx). - rawDocxBytes = null; - WordprocessingMLPackage pkg = WordprocessingMLPackage.load( - new ByteArrayInputStream(docxBytes)); - // ZipPartStore при load() копирует распакованные байты каждой записи в - // свой реестр, нормализованный zip дальше не читается — освобождаем до - // FOP-рендера (пик: JAXB-модель + FOP + PDF-буфер). - docxBytes = null; + // и load transitional-байтов в пакет — внутри loadPackage(). Её кадр + // умирает сразу после load(), ZipPartStore держит распакованные + // записи в своём реестре — поэтому ни промежуточные, ни финальный + // нормализованный zip-массивы не доживают до FOP-рендера (пик: + // JAXB-модель + FOP + PDF-буфер), притом без зануления ссылок. + WordprocessingMLPackage pkg = loadPackage(rawDocxBytes, options); try { // 3. Привязка маппера: docx4j сопоставляет шрифты документа // с физическими TTF (учитывая и шрифты, встроенные в docx) @@ -239,6 +220,22 @@ public final class WordPdfConverter { } } + /** + * Нормализация входных байтов (цепочка {@link #normalizers}: правила 1–8 + * одним zip-проходом {@code DocxRewritePipeline} + условная OLE-вычистка) + * и {@code WordprocessingMLPackage.load} полученного transitional-байта. + * Нормализация переиспользует слот {@code bytes}: каждая замена массива + * сбрасывает предыдущий (без неё при .doc-входе в куче жили бы и .doc, + * и нормализованный .docx); кадр метода умирает сразу после load(), + * освобождая финальный массив. + */ + private static WordprocessingMLPackage loadPackage(byte[] bytes, ConvertOptions options) throws Exception { + for (DocxNormalizer normalizer : normalizers(options)) { + bytes = normalizer.normalize(bytes); + } + return WordprocessingMLPackage.load(new ByteArrayInputStream(bytes)); + } + /** * Конвейер байтовой нормализации docx. Порядок фиксирован: сначала один * zip-проход переписывания XML-частей (внутри части порядок рерайтов diff --git a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java index c6506d7..c8176be 100644 --- a/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java +++ b/wordpdf-core/src/main/java/ru/pjandro/wordpdf/fonts/BundledFonts.java @@ -108,8 +108,11 @@ public final class BundledFonts { new Entry("NotoSansArmenian-Regular.ttf", "noto sans armenian", V_REGULAR) ); - /** Ключ семейства (lowercase) -> начертание -> зарегистрированный PhysicalFont. */ - private static final Map> VARIANTS = new HashMap<>(); + /** Ключ семейства (lowercase) -> начертание -> зарегистрированный PhysicalFont. + * Package-private: тесты одного пакета забирают снимок и чистят карту + * напрямую ({@code BundledFontMapperTest}); тест чужого пакета лезет в неё + * через reflection ({@code FopFallbackFontsTest}). */ + static final Map> VARIANTS = new HashMap<>(); /** Каталог, куда выгружены TTF (после init()). */ private static Path extractDir; diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/fonts/BundledFontMapperTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/fonts/BundledFontMapperTest.java index 7e25e31..7c8e63f 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/fonts/BundledFontMapperTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/fonts/BundledFontMapperTest.java @@ -27,22 +27,19 @@ class BundledFontMapperTest { /** Выполнить body в состоянии «шрифты бандла не зарегистрированы», затем восстановить. */ private static void withoutBundledInit(TestBody body) throws Exception { - Field variantsField = BundledFonts.class.getDeclaredField("VARIANTS"); - variantsField.setAccessible(true); Field initedField = BundledFonts.class.getDeclaredField("inited"); initedField.setAccessible(true); - @SuppressWarnings("unchecked") - Map> variants = - (Map>) variantsField.get(null); - Map> savedVariants = new HashMap<>(variants); + // VARIANTS package-private (тот же пакет) — снимок/очистка напрямую, + // типизированно, без reflection-каста. + Map> savedVariants = new HashMap<>(BundledFonts.VARIANTS); boolean savedInited = initedField.getBoolean(null); - variants.clear(); + BundledFonts.VARIANTS.clear(); initedField.setBoolean(null, false); try { body.run(); } finally { - variants.clear(); - variants.putAll(savedVariants); + BundledFonts.VARIANTS.clear(); + BundledFonts.VARIANTS.putAll(savedVariants); initedField.setBoolean(null, savedInited); } } diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/FopFallbackFontsTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/FopFallbackFontsTest.java index 4e08a6c..ae999e0 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/FopFallbackFontsTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/FopFallbackFontsTest.java @@ -4,7 +4,6 @@ import org.docx4j.convert.out.FOSettings; import org.docx4j.convert.out.fopconf.Fop; import org.docx4j.convert.out.fopconf.Fonts; import org.docx4j.convert.out.fopconf.ObjectFactory; -import org.docx4j.fonts.PhysicalFont; import org.junit.jupiter.api.Test; import ru.pjandro.wordpdf.fonts.BundledFonts; @@ -111,11 +110,11 @@ class FopFallbackFontsTest { void declareWithoutInitDeclaresNothing() throws Exception { Field variantsField = BundledFonts.class.getDeclaredField("VARIANTS"); variantsField.setAccessible(true); - @SuppressWarnings("unchecked") - Map> variants = - (Map>) variantsField.get(null); - Map> saved = - new java.util.HashMap<>(variants); + // Поле final — ссылка не подменяется (Field.set на final запрещён с + // JDK 15), карта чистится и наполняется обратно. Кастов нет: доступ + // через reifiable Map, обратный putAll — рефлектив вызовом Map.putAll. + Map variants = (Map) variantsField.get(null); + Map savedVariants = new java.util.HashMap<>(variants); variants.clear(); Fonts pdfFonts = new ObjectFactory().createFonts(); try { @@ -124,7 +123,7 @@ class FopFallbackFontsTest { "без init() декларировать нечего"); } finally { variants.clear(); - variants.putAll(saved); + Map.class.getMethod("putAll", Map.class).invoke(variants, savedVariants); } } } diff --git a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawMlColorTest.java b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawMlColorTest.java index 0759626..5f56dbe 100644 --- a/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawMlColorTest.java +++ b/wordpdf-core/src/test/java/ru/pjandro/wordpdf/internal/chart/DrawMlColorTest.java @@ -281,16 +281,16 @@ class DrawMlColorTest { return c; } - private static CTColor srgbWith(String kind, Object value) { + private static CTColor srgbWith(String kind, Class cls, T value) { CTColor c = srgb("00FF00"); - srgbWith(c, kind, value); + srgbWith(c, kind, cls, value); return c; } - @SuppressWarnings("unchecked") - private static void srgbWith(CTColor c, String kind, Object value) { - c.getSrgbClr().getEGColorTransform().add( - new JAXBElement<>(new QName(DML_NS, kind), (Class) value.getClass(), value)); + /** Класс значения — явным параметром (как в {@link #transform}), + * JAXBElement параметризован без unchecked-каста {@code value.getClass()}. */ + private static void srgbWith(CTColor c, String kind, Class cls, T value) { + c.getSrgbClr().getEGColorTransform().add(transform(kind, cls, value)); } /** §20.1.2.3.30: каналы scrgbClr — проценты линейной гаммы, 50% -> BC (пример спеки). */ @@ -349,7 +349,7 @@ class DrawMlColorTest { @Test void alphaModScalesOpacity() { DrawMlColor colors = new DrawMlColor(null); - Color resolved = colors.resolve(srgbWith("alphaMod", fixedPct(50000))); + Color resolved = colors.resolve(srgbWith("alphaMod", CTPositiveFixedPercentage.class, fixedPct(50000))); assertEquals(128, resolved.getAlpha()); } @@ -371,25 +371,25 @@ class DrawMlColorTest { DrawMlColor colors = new DrawMlColor(null); CTAngle hue = new CTAngle(); hue.setVal(14400000); - assertEquals(Color.BLUE, colors.resolve(srgbWith("hue", hue))); + assertEquals(Color.BLUE, colors.resolve(srgbWith("hue", CTAngle.class, hue))); // спека для sat 50% даёт 40C040 (floor), у нас округление — 191 - assertEquals(new Color(64, 191, 64), colors.resolve(srgbWith("sat", fixed(50000)))); - assertEquals(new Color(0, 102, 0), colors.resolve(srgbWith("lum", fixed(20000)))); + assertEquals(new Color(64, 191, 64), colors.resolve(srgbWith("sat", CTFixedPercentage.class, fixed(50000)))); + assertEquals(new Color(0, 102, 0), colors.resolve(srgbWith("lum", CTFixedPercentage.class, fixed(20000)))); } /** §20.1.2.3.23-25/.10-12/.4-6: red/green/blue и их Mod/Off. */ @Test void channelSettersModsOffsets() { DrawMlColor colors = new DrawMlColor(null); - assertEquals(new Color(0, 255, 255), colors.resolve(srgbWith("blue", fixed(100000)))); + assertEquals(new Color(0, 255, 255), colors.resolve(srgbWith("blue", CTFixedPercentage.class, fixed(100000)))); CTColor blueMod = srgb("0000FF"); - srgbWith(blueMod, "blueMod", fixed(50000)); + srgbWith(blueMod, "blueMod", CTFixedPercentage.class, fixed(50000)); assertEquals(new Color(0, 0, 128), colors.resolve(blueMod)); CTColor redOff = srgb("FF0000"); - srgbWith(redOff, "redOff", fixed(-20000)); + srgbWith(redOff, "redOff", CTFixedPercentage.class, fixed(-20000)); assertEquals(new Color(204, 0, 0), colors.resolve(redOff)); CTColor greenMod = srgb("008000"); - srgbWith(greenMod, "greenMod", fixed(200000)); + srgbWith(greenMod, "greenMod", CTFixedPercentage.class, fixed(200000)); assertEquals(new Color(0, 255, 0), colors.resolve(greenMod)); }