refactor(core): интерфейс DocxNormalizer + конвейер списком #39
@@ -11,6 +11,7 @@ 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.internal.chart.DrawingPreRenderer;
|
import ru.pjandro.wordpdf.internal.chart.DrawingPreRenderer;
|
||||||
|
import ru.pjandro.wordpdf.internal.DocxNormalizer;
|
||||||
import ru.pjandro.wordpdf.internal.DocxOnOffNormalizer;
|
import ru.pjandro.wordpdf.internal.DocxOnOffNormalizer;
|
||||||
import ru.pjandro.wordpdf.internal.FieldNormalizer;
|
import ru.pjandro.wordpdf.internal.FieldNormalizer;
|
||||||
import ru.pjandro.wordpdf.internal.GlyphCoverageNormalizer;
|
import ru.pjandro.wordpdf.internal.GlyphCoverageNormalizer;
|
||||||
@@ -23,6 +24,7 @@ import ru.pjandro.wordpdf.internal.SymbolFontNormalizer;
|
|||||||
import java.io.ByteArrayInputStream;
|
import java.io.ByteArrayInputStream;
|
||||||
import java.io.ByteArrayOutputStream;
|
import java.io.ByteArrayOutputStream;
|
||||||
import java.io.OutputStream;
|
import java.io.OutputStream;
|
||||||
|
import java.util.List;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Конвертер docx -> PDF на базе docx4j + Apache FOP
|
* Конвертер docx -> PDF на базе docx4j + Apache FOP
|
||||||
@@ -128,34 +130,13 @@ public final class WordPdfConverter {
|
|||||||
// em-dash (U+2000–U+2EFF) остаётся на шрифте ранa вместо fallback.
|
// em-dash (U+2000–U+2EFF) остаётся на шрифте ранa вместо fallback.
|
||||||
BundledFonts.restrictToBundled();
|
BundledFonts.restrictToBundled();
|
||||||
|
|
||||||
// 2. Загрузка документа. Первым strict-OOXML: Word в strict пишет
|
// 2. Загрузка документа: байтовый конвейер нормализаторов в фиксированном
|
||||||
// проценты строками ("130%") и w:start/w:end вместо w:left/
|
// порядке (см. normalizers) — дальше лежит transitional-байт, готовый
|
||||||
// w:right — JAXB падает на int-биндингах (см. StrictOoxmlNormalizer);
|
// для JAXB/docx4j.
|
||||||
// дальше по конвейеру лежит уже transitional-байт.
|
byte[] docxBytes = rawDocxBytes;
|
||||||
byte[] docxBytes = StrictOoxmlNormalizer.normalize(rawDocxBytes);
|
for (DocxNormalizer normalizer : normalizers(options)) {
|
||||||
// ...затем w:val="off"/"on" в "false"/"true": docx4j 11.x теряет
|
docxBytes = normalizer.normalize(docxBytes);
|
||||||
// атрибуты "off"/"on" при JAXB-разборе (см. DocxOnOffNormalizer).
|
}
|
||||||
docxBytes = DocxOnOffNormalizer.normalize(docxBytes);
|
|
||||||
// ...и символьные шрифты Symbol/Wingdings: их коды из PUA экспорт
|
|
||||||
// в FO не понимает и рисует «#» (см. SymbolFontNormalizer).
|
|
||||||
docxBytes = SymbolFontNormalizer.normalize(docxBytes);
|
|
||||||
// ...и поля PAGE/NUMPAGES из fldChar делаем w:fldSimple, иначе
|
|
||||||
// в колонтитулах печатается кэш docx (см. FieldNormalizer).
|
|
||||||
docxBytes = FieldNormalizer.normalize(docxBytes);
|
|
||||||
// ...и невидимые символы (U+0085/U+2028/U+2029, U+2060/U+FEFF,
|
|
||||||
// bidi-метки): FOP превращает первые три в принудительные переносы
|
|
||||||
// — пустые строки, а Arimo/Tinos рисуют для них видимые боксы;
|
|
||||||
// в Word они невидимы (см. InvisibleCharNormalizer).
|
|
||||||
docxBytes = InvisibleCharNormalizer.normalize(docxBytes);
|
|
||||||
// ...и раны со знаками, которых нет в их шрифте: без этого
|
|
||||||
// FOP рисует «#» (docx4j проверяет покрытие не для всех знаков
|
|
||||||
// и кэширует фолбэк на группу Юникода, см. GlyphCoverageNormalizer).
|
|
||||||
docxBytes = GlyphCoverageNormalizer.normalize(docxBytes);
|
|
||||||
// ...и OLE-объекты (внедрённые бинарные .bin-части): docx4j падает и на
|
|
||||||
// ложном XML-типе bin-части в [Content_Types], и на сериализации VML
|
|
||||||
// w:object. При выключенном errorOnOle объекты тихо удаляются (часть,
|
|
||||||
// rels, w:object), при включённом — отказ (см. OleObjectNormalizer).
|
|
||||||
docxBytes = OleObjectNormalizer.normalize(docxBytes, options.errorOnOle());
|
|
||||||
WordprocessingMLPackage pkg = WordprocessingMLPackage.load(
|
WordprocessingMLPackage pkg = WordprocessingMLPackage.load(
|
||||||
new ByteArrayInputStream(docxBytes));
|
new ByteArrayInputStream(docxBytes));
|
||||||
try {
|
try {
|
||||||
@@ -202,4 +183,38 @@ public final class WordPdfConverter {
|
|||||||
// пакет загружается в память и ничего не закрывает.
|
// пакет загружается в память и ничего не закрывает.
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Конвейер байтовой нормализации docx. Порядок фиксирован:
|
||||||
|
* StrictOoxml первым (дальше по конвейеру лежит transitional-байт),
|
||||||
|
* GlyphCoverage после SymbolFont/InvisibleChar (покрытие считается по
|
||||||
|
* финальному тексту/шрифтам рана), OleObject последним (меняет части,
|
||||||
|
* а не XML ранов). Регрессии каждого шага — в javadoc нормализатора.
|
||||||
|
*/
|
||||||
|
private static List<DocxNormalizer> normalizers(ConvertOptions options) {
|
||||||
|
return List.of(
|
||||||
|
// strict-OOXML -> transitional: проценты строками и w:start/w:end
|
||||||
|
// ломают int-биндинги JAXB (StrictOoxmlNormalizer)
|
||||||
|
StrictOoxmlNormalizer.STEP,
|
||||||
|
// w:val="off"/"on" -> "false"/"true": docx4j теряет on/off
|
||||||
|
// при JAXB-разборе (DocxOnOffNormalizer)
|
||||||
|
DocxOnOffNormalizer.STEP,
|
||||||
|
// Symbol/Wingdings PUA -> Unicode + DejaVu Sans, иначе «#»
|
||||||
|
// (SymbolFontNormalizer)
|
||||||
|
SymbolFontNormalizer.STEP,
|
||||||
|
// поля PAGE/NUMPAGES fldChar -> w:fldSimple, иначе печатается
|
||||||
|
// кэш docx (FieldNormalizer)
|
||||||
|
FieldNormalizer.STEP,
|
||||||
|
// невидимые символы (U+0085/U+2028/U+2029, U+2060/U+FEFF,
|
||||||
|
// bidi-метки): FOP делает из них переносы, Arimo/Tinos — боксы
|
||||||
|
// (InvisibleCharNormalizer)
|
||||||
|
InvisibleCharNormalizer.STEP,
|
||||||
|
// раны со знаками вне покрытия их шрифта: режем ран, иначе
|
||||||
|
// FOP рисует «#» (GlyphCoverageNormalizer)
|
||||||
|
GlyphCoverageNormalizer.STEP,
|
||||||
|
// OLE-объекты: при выключенном errorOnOle тихо удаляем
|
||||||
|
// (часть/rels/w:object), при включённом — DrawingFoundException
|
||||||
|
// (OleObjectNormalizer)
|
||||||
|
bytes -> OleObjectNormalizer.normalize(bytes, options.errorOnOle()));
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -0,0 +1,16 @@
|
|||||||
|
package ru.pjandro.wordpdf.internal;
|
||||||
|
|
||||||
|
import java.io.IOException;
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Шаг байтового конвейера нормализации docx перед WordprocessingMLPackage.load():
|
||||||
|
* принимает байты .docx (zip), возвращает те же байты, если менять нечего,
|
||||||
|
* иначе переупакованный zip (контракт assertSame — см. тесты нормализаторов).
|
||||||
|
* Порядок шагов задаёт единственный конвейер — WordPdfConverter#normalizers;
|
||||||
|
* перестановка шагов ломает конвертацию (см. javadoc каждого нормализатора).
|
||||||
|
*/
|
||||||
|
@FunctionalInterface
|
||||||
|
public interface DocxNormalizer {
|
||||||
|
|
||||||
|
byte[] normalize(byte[] docx) throws IOException;
|
||||||
|
}
|
||||||
@@ -32,6 +32,9 @@ public final class DocxOnOffNormalizer {
|
|||||||
private DocxOnOffNormalizer() {
|
private DocxOnOffNormalizer() {
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/** Шаг конвейера WordPdfConverter#normalizers: этот нормализатор как DocxNormalizer. */
|
||||||
|
public static final DocxNormalizer STEP = DocxOnOffNormalizer::normalize;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Заменяет в XML-частях docx (word/*.xml) w:val="off"/"on"
|
* Заменяет в XML-частях docx (word/*.xml) w:val="off"/"on"
|
||||||
* на "false"/"true".
|
* на "false"/"true".
|
||||||
|
|||||||
@@ -44,6 +44,9 @@ public final class FieldNormalizer {
|
|||||||
private FieldNormalizer() {
|
private FieldNormalizer() {
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/** Шаг конвейера WordPdfConverter#normalizers: этот нормализатор как DocxNormalizer. */
|
||||||
|
public static final DocxNormalizer STEP = FieldNormalizer::normalize;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Переписывает поддерживаемые поля во всех word/*.xml частях docx.
|
* Переписывает поддерживаемые поля во всех word/*.xml частях docx.
|
||||||
*
|
*
|
||||||
|
|||||||
@@ -81,6 +81,9 @@ public final class GlyphCoverageNormalizer {
|
|||||||
private GlyphCoverageNormalizer() {
|
private GlyphCoverageNormalizer() {
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/** Шаг конвейера WordPdfConverter#normalizers: этот нормализатор как DocxNormalizer. */
|
||||||
|
public static final DocxNormalizer STEP = GlyphCoverageNormalizer::normalize;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Разрезает раны с непокрытыми глифами в XML-частях docx (word/*.xml).
|
* Разрезает раны с непокрытыми глифами в XML-частях docx (word/*.xml).
|
||||||
*
|
*
|
||||||
|
|||||||
@@ -86,6 +86,9 @@ public final class InvisibleCharNormalizer {
|
|||||||
private InvisibleCharNormalizer() {
|
private InvisibleCharNormalizer() {
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/** Шаг конвейера WordPdfConverter#normalizers: этот нормализатор как DocxNormalizer. */
|
||||||
|
public static final DocxNormalizer STEP = InvisibleCharNormalizer::normalize;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Вырезает невидимые символы из текстовых узлов XML-частей docx
|
* Вырезает невидимые символы из текстовых узлов XML-частей docx
|
||||||
* (word/*.xml).
|
* (word/*.xml).
|
||||||
|
|||||||
@@ -78,6 +78,9 @@ public final class StrictOoxmlNormalizer {
|
|||||||
private StrictOoxmlNormalizer() {
|
private StrictOoxmlNormalizer() {
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/** Шаг конвейера WordPdfConverter#normalizers: этот нормализатор как DocxNormalizer. */
|
||||||
|
public static final DocxNormalizer STEP = StrictOoxmlNormalizer::normalize;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Приводит strict-OOXML в XML-частях docx (word/*.xml) к виду, который
|
* Приводит strict-OOXML в XML-частях docx (word/*.xml) к виду, который
|
||||||
* разбирает JAXB-модель transitional (детали — в javadoc класса).
|
* разбирает JAXB-модель transitional (детали — в javadoc класса).
|
||||||
|
|||||||
@@ -70,6 +70,9 @@ public final class SymbolFontNormalizer {
|
|||||||
private SymbolFontNormalizer() {
|
private SymbolFontNormalizer() {
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/** Шаг конвейера WordPdfConverter#normalizers: этот нормализатор как DocxNormalizer. */
|
||||||
|
public static final DocxNormalizer STEP = SymbolFontNormalizer::normalize;
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Заменяет символьные шрифты в XML-частях docx (word/*.xml).
|
* Заменяет символьные шрифты в XML-частях docx (word/*.xml).
|
||||||
*
|
*
|
||||||
|
|||||||
Reference in New Issue
Block a user