EasyXML
Class FileXML

java.lang.Object
  EasyXML.NodoXML
      EasyXML.FileXML

public class FileXML
extends NodoXML

La classe FileXML è stata progettata per rappresentare un qualunque file XML nella sua interezza. Nel momento della chiamata del costrutture la classe istanzierà tutta la struttura dei dati contenuta nel file e la renderà accessibile per la lettura e la scrittura. Il suo uso standard è crearla all'avvio dell'applicazione e, mediante il metodo "salva()", salvare i dati sul file (sul disco) quando occorre. La classe FileXML, oltre che rappresentare un file XML, simboleggia il suo nodo radice. Pertanto è possibile chiamare su di essa, con lo stesso effetto, gli stessi metodi di accesso che sono nella classe NodoXML.

I metodi di accesso di NodoXML appartengono, virtualmente, a due categorie differenti: i metodi che lavorano sulla struttura e i metodi che modificano la struttura XML. I primi (ch, get, set) permettono ad un utilizzatore di navigare, leggere e modificare i valori dei dati presenti nella struttura ad albero dell'XML. I secondi (addCh, addAttr, rmCh, rmAttr) permettono ad un utilizzatore di cambiare la struttura dell'albero XML. E' fortemente consigliato distinguere i due ruoli tra gli utilizzatori per evitare errori.

La classe, al suo interno, fa uso del package JDom.

Esempio di utilizzo dei metodi che lavorano sulla struttura:

        FileXML dati=new FileXML("dati.xml");
        ...
        dati.ch("Ezio").ch("capelli").set("colore","castani");
        dati.ch("Ezio").set("altezza","180");
        dati.ch("Ezio").set("peso","83");
        dati.ch("Ezio").ch("computer").set("stato","guasto");
        ...
        dati.ch("Ezio").get("peso");
 

Esempio di utilizzo dei metodi che modificano la struttura dell'albero XML:

        FileXML dati=new FileXML("dati.xml");

        dati.addCh("Ezio");
        dati.ch("Ezio").addCh("capelli");
        dati.ch("Ezio").addCh("computer");

        dati.ch("Ezio").addAttr("altezza");
        dati.ch("Ezio").addAttr("peso");
        dati.ch("Ezio").ch("capelli").addAttr("colore");
        dati.ch("Ezio").ch("computer").addAttr("stato");
 

See Also:

NodoXML

FileXML

public FileXML(java.lang.String nomefile)

L'unico costrutture della classe FileXML.

Parameters:

nomefile - Il nome del file che si intende leggere o scrivere. Il nome del file può essere comprensivo di percorso assoluto o relativo.

salva

public void salva()

Il metodo che scrive fisicamente su file. Tutte le funzioni di modifica non hanno effetto, su file, fino a quando non viene invocato questo metodo.