Нормалізація розбору DOM з java - як це працює?

У цьому навчальному посібнику я побачив рядок у коді для аналізатора DOM .

doc.getDocumentElement().normalize();

Чому ми робимо цю нормалізацію?
Я читав документи, але не зміг зрозуміти жодного слова.

Вставляє всі текстові вузли на всю глибину під-дерева під цим Вузлом

Гаразд, тоді хтось може мені показати (бажано із зображенням), як виглядає це дерево?

Хтось може мені пояснити, для чого потрібна нормалізація?
Що станеться, якщо ми не нормалізуємось?

Решта речення:

де лише структура (наприклад, елементи, коментарі, інструкції з обробки, розділи CDATA та посилання на об'єкти) відокремлює текстові вузли, тобто немає ні суміжних текстових вузлів, ні порожніх текстових вузлів.

Це в основному означає, що наступний XML-елемент

<foo>hello 
wor
ld</foo>

може бути представлений так у денормалізованому вузлі:

Element foo
    Text node: ""
    Text node: "Hello "
    Text node: "wor"
    Text node: "ld"

Коли нормалізується, вузол буде виглядати приблизно так

Element foo
    Text node: "Hello world"

І те саме стосується атрибутів:, <foo bar="Hello world"/>коментарів тощо.

Простіше кажучи, нормалізація - це скорочення скорочень.
Приклади надлишків:
а) пробіли поза тегами кореня / документа ( ... <документ> </document> ... )
б) пробіли в тезі старту (< ... >) та кінцевого тега (</ ... >)
в) пробіли між атрибутами та їх значеннями (тобто пробіли між назвою ключа та = " )
г) зайві декларації простору імен;
e) розриви рядків / пробіли в текстах атрибутів і тегів
f) коментарі тощо ...

Як додаток до відповіді @ JBNizet для більш технічних користувачів, ось як виглядає реалізація org.w3c.dom.Nodeінтерфейсу com.sun.org.apache.xerces.internal.dom.ParentNode, дає вам уявлення про те, як він насправді працює.

public void normalize() {
    // No need to normalize if already normalized.
    if (isNormalized()) {
        return;
    }
    if (needsSyncChildren()) {
        synchronizeChildren();
    }
    ChildNode kid;
    for (kid = firstChild; kid != null; kid = kid.nextSibling) {
         kid.normalize();
    }
    isNormalized(true);
}

Він обходить усі вузли рекурсивно і викликає kid.normalize()
цей механізм в переосмисленніorg.apache.xerces.dom.ElementImpl

public void normalize() {
     // No need to normalize if already normalized.
     if (isNormalized()) {
         return;
     }
     if (needsSyncChildren()) {
         synchronizeChildren();
     }
     ChildNode kid, next;
     for (kid = firstChild; kid != null; kid = next) {
         next = kid.nextSibling;

         // If kid is a text node, we need to check for one of two
         // conditions:
         //   1) There is an adjacent text node
         //   2) There is no adjacent text node, but kid is
         //      an empty text node.
         if ( kid.getNodeType() == Node.TEXT_NODE )
         {
             // If an adjacent text node, merge it with kid
             if ( next!=null && next.getNodeType() == Node.TEXT_NODE )
             {
                 ((Text)kid).appendData(next.getNodeValue());
                 removeChild( next );
                 next = kid; // Don't advance; there might be another.
             }
             else
             {
                 // If kid is empty, remove it
                 if ( kid.getNodeValue() == null || kid.getNodeValue().length() == 0 ) {
                     removeChild( kid );
                 }
             }
         }

         // Otherwise it might be an Element, which is handled recursively
         else if (kid.getNodeType() == Node.ELEMENT_NODE) {
             kid.normalize();
         }
     }

     // We must also normalize all of the attributes
     if ( attributes!=null )
     {
         for( int i=0; i<attributes.getLength(); ++i )
         {
             Node attr = attributes.item(i);
             attr.normalize();
         }
     }

    // changed() will have occurred when the removeChild() was done,
    // so does not have to be reissued.

     isNormalized(true);
 } 

Сподіваюсь, це заощадить певний час.