Убрать все @SuppressWarnings: loadPackage без зануления, VARIANTS package-private, типобезопасные тесты
PR checks / web (pull_request) Successful in 32s
PR checks / java (pull_request) Successful in 1m25s
Main: tests, deploy, autotests / web (push) Successful in 31s
Main: tests, deploy, autotests / java (push) Successful in 1m4s
Main: tests, deploy, autotests / images-web (push) Successful in 29s
Main: tests, deploy, autotests / images-app (push) Successful in 42s
Main: tests, deploy, autotests / deploy (push) Successful in 3m20s
Main: tests, deploy, autotests / autotests (push) Successful in 43s
Main: tests, deploy, autotests / rollback (push) Has been skipped
PR checks / web (pull_request) Successful in 32s
PR checks / java (pull_request) Successful in 1m25s
Main: tests, deploy, autotests / web (push) Successful in 31s
Main: tests, deploy, autotests / java (push) Successful in 1m4s
Main: tests, deploy, autotests / images-web (push) Successful in 29s
Main: tests, deploy, autotests / images-app (push) Successful in 42s
Main: tests, deploy, autotests / deploy (push) Successful in 3m20s
Main: tests, deploy, autotests / autotests (push) Successful in 43s
Main: tests, deploy, autotests / rollback (push) Has been skipped
This commit was merged in pull request #84.
This commit is contained in:
@@ -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-частей (внутри части порядок рерайтов
|
||||
|
||||
@@ -108,8 +108,11 @@ public final class BundledFonts {
|
||||
new Entry("NotoSansArmenian-Regular.ttf", "noto sans armenian", V_REGULAR)
|
||||
);
|
||||
|
||||
/** Ключ семейства (lowercase) -> начертание -> зарегистрированный PhysicalFont. */
|
||||
private static final Map<String, Map<String, PhysicalFont>> VARIANTS = new HashMap<>();
|
||||
/** Ключ семейства (lowercase) -> начертание -> зарегистрированный PhysicalFont.
|
||||
* Package-private: тесты одного пакета забирают снимок и чистят карту
|
||||
* напрямую ({@code BundledFontMapperTest}); тест чужого пакета лезет в неё
|
||||
* через reflection ({@code FopFallbackFontsTest}). */
|
||||
static final Map<String, Map<String, PhysicalFont>> VARIANTS = new HashMap<>();
|
||||
|
||||
/** Каталог, куда выгружены TTF (после init()). */
|
||||
private static Path extractDir;
|
||||
|
||||
@@ -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<String, Map<String, PhysicalFont>> variants =
|
||||
(Map<String, Map<String, PhysicalFont>>) variantsField.get(null);
|
||||
Map<String, Map<String, PhysicalFont>> savedVariants = new HashMap<>(variants);
|
||||
// VARIANTS package-private (тот же пакет) — снимок/очистка напрямую,
|
||||
// типизированно, без reflection-каста.
|
||||
Map<String, Map<String, PhysicalFont>> 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);
|
||||
}
|
||||
}
|
||||
|
||||
@@ -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<String, Map<String, PhysicalFont>> variants =
|
||||
(Map<String, Map<String, PhysicalFont>>) variantsField.get(null);
|
||||
Map<String, Map<String, PhysicalFont>> saved =
|
||||
new java.util.HashMap<>(variants);
|
||||
// Поле final — ссылка не подменяется (Field.set на final запрещён с
|
||||
// JDK 15), карта чистится и наполняется обратно. Кастов нет: доступ
|
||||
// через reifiable Map<?,?>, обратный putAll — рефлектив вызовом Map.putAll.
|
||||
Map<?, ?> variants = (Map<?, ?>) variantsField.get(null);
|
||||
Map<Object, Object> 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);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -281,16 +281,16 @@ class DrawMlColorTest {
|
||||
return c;
|
||||
}
|
||||
|
||||
private static CTColor srgbWith(String kind, Object value) {
|
||||
private static <T> CTColor srgbWith(String kind, Class<T> 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<Object>) value.getClass(), value));
|
||||
/** Класс значения — явным параметром (как в {@link #transform}),
|
||||
* JAXBElement параметризован без unchecked-каста {@code value.getClass()}. */
|
||||
private static <T> void srgbWith(CTColor c, String kind, Class<T> 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));
|
||||
}
|
||||
|
||||
|
||||
Reference in New Issue
Block a user