xesj.xml
Tartalomjegyzék
alapok
-
A xesj.xml package XML fájlok olvasását, és írását biztosítja egyszerű módon.
-
Az XML állományok kezelését a Tree és Line osztályok valósítják meg.
Ezek segítségével lehetséges XML beolvasása (vagy új XML készítése), módosítása, írása.
-
A Tree osztály konstruktoraival lehet már meglévő XML-ből felépíteni a memóriában a fát(tree),
és a hozzátartozó ágakat(lines), illetve teljesen új fát is létrehozhatunk. Ezek után a fa teljesen független lesz
a forrás XML document-től, node-októl stb. Az XML DOM-ként lesz feldolgozva, és a memóriában tárolva,
ezt figyelembe kell venni az óriási méretű XML dokumentumoknál.
-
A Line osztály egy példánya az XML egy ágának felel meg, illetve jelölhet egy nem valós ágat is
ami az XML-ben nem létezik.
-
A fán tetszőlegesen mozoghatunk a root(), parent(), child(), children(),
jump() metódusokkal, melyek sosem adnak null-t, legfeljebb nem valós ágra juthatunk.
A nem valós ágnak a szülő ága és gyerek ága is önmaga.
-
Ha egy adott ágon állunk akkor a mark() metódusával ezt az ágat meg lehet jelölni.
Ide később visszajuthatunk a fa jump() metódusával.
-
Ha a fán módosítani akarunk, akkor egy ág insertChild(), insertAfter(), update(),
delete() metódusait használjuk.
-
A kész fát kiírhatjuk a write() metódusával többféle kimenetre, és valóban csak ekkor áll elő mögötte az
XML documentum, node-ok stb.
-
Fontos szabály hogy egy ágnak nem lehet egyszerre text-je, és gyerek ága. Bár XML-ben lehet ilyen,
a xesj.xml package ezt direkt nem kezeli.
Ilyen helyzetben a gyerek ág léte az erősebb, és text-nek null van beírva.
Ha gyerek ágat készítünk az insertChild() metódussal, akkor törlődik a szülő text-je.
Text nem állítható be olyan ágra, melynek létezik gyereke.
-
A Tree osztály check() metódusával ellenőrizhető a fa(XML) struktúrájának megfelelősége.
A megfelelőségi szabályok a LineRule osztály segítségével állíthatók be.
Ha a fastruktúra nem felel meg a szabályoknak, akkor TreeCheckException kivétel váltódik ki.
példák
-
1. példa
data.xml fájl:
data.xml olvasása:
data.xml <b></b> ágának módosítása: <ujb x="7">újbelső</ujb> -re,
a módosított fa kiírása data2.xml fájlba:
-
2. példa
Új xml fájl létrehozása autók adataival:
a létrejött cars.xml: