refactor(core): интерфейс DocxNormalizer + конвейер списком #39

Merged
pjandro merged 2 commits from normalizer-interface into main 2026-10-25 03:22:25 +03:00
7 changed files with 24 additions and 6 deletions
Showing only changes of commit 4a0cd6a9b3 - Show all commits
@@ -195,23 +195,23 @@ public final class WordPdfConverter {
return List.of( return List.of(
// strict-OOXML -> transitional: проценты строками и w:start/w:end // strict-OOXML -> transitional: проценты строками и w:start/w:end
// ломают int-биндинги JAXB (StrictOoxmlNormalizer) // ломают int-биндинги JAXB (StrictOoxmlNormalizer)
StrictOoxmlNormalizer::normalize, StrictOoxmlNormalizer.STEP,
// w:val="off"/"on" -> "false"/"true": docx4j теряет on/off // w:val="off"/"on" -> "false"/"true": docx4j теряет on/off
// при JAXB-разборе (DocxOnOffNormalizer) // при JAXB-разборе (DocxOnOffNormalizer)
DocxOnOffNormalizer::normalize, DocxOnOffNormalizer.STEP,
// Symbol/Wingdings PUA -> Unicode + DejaVu Sans, иначе «#» // Symbol/Wingdings PUA -> Unicode + DejaVu Sans, иначе «#»
// (SymbolFontNormalizer) // (SymbolFontNormalizer)
SymbolFontNormalizer::normalize, SymbolFontNormalizer.STEP,
// поля PAGE/NUMPAGES fldChar -> w:fldSimple, иначе печатается // поля PAGE/NUMPAGES fldChar -> w:fldSimple, иначе печатается
// кэш docx (FieldNormalizer) // кэш docx (FieldNormalizer)
FieldNormalizer::normalize, FieldNormalizer.STEP,
// невидимые символы (U+0085/U+2028/U+2029, U+2060/U+FEFF, // невидимые символы (U+0085/U+2028/U+2029, U+2060/U+FEFF,
// bidi-метки): FOP делает из них переносы, Arimo/Tinos — боксы // bidi-метки): FOP делает из них переносы, Arimo/Tinos — боксы
// (InvisibleCharNormalizer) // (InvisibleCharNormalizer)
InvisibleCharNormalizer::normalize, InvisibleCharNormalizer.STEP,
// раны со знаками вне покрытия их шрифта: режем ран, иначе // раны со знаками вне покрытия их шрифта: режем ран, иначе
// FOP рисует «#» (GlyphCoverageNormalizer) // FOP рисует «#» (GlyphCoverageNormalizer)
GlyphCoverageNormalizer::normalize, GlyphCoverageNormalizer.STEP,
// OLE-объекты: при выключенном errorOnOle тихо удаляем // OLE-объекты: при выключенном errorOnOle тихо удаляем
// (часть/rels/w:object), при включённом — DrawingFoundException // (часть/rels/w:object), при включённом — DrawingFoundException
// (OleObjectNormalizer) // (OleObjectNormalizer)
@@ -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).
* *