source: ether_megapoli/trunk/service/implementation/com/medias/integration/lecture_ecriture/XMLParser.java @ 482

/**
 * Created on 24 Janvier. 2006
 *  @author 
 */
package integration.lecture_ecriture;


import org.jdom.*;
import org.jdom.input.SAXBuilder;
import org.jdom.output.XMLOutputter;
import integration.exceptions.*;

import java.io.*;

/**
 * 
 * Classe permettant de lire, écrire ou modifier des fichiers XML.
 */

public class XMLParser {

    /** Document JDOM représentant le fichier XML manipulé. **/
    private Document doc;


    /**
     * Ajoute un élément é une racine.
     * @param root Elément racine.
     * @param name Nom de l'élément.
     * @param value Valeur de l'élément.
     */
    public void createXMLRepresentation(Element root, String name, String value) {
        Element element = new Element(name);
        element.setText(value);
        root.addContent(element);
    }

    /**
     * Ajoute un élément é une racine.
     * @param root Elément racine.
     * @param element Elément é ajouter.
     */
    public void createXMLRepresentation(Element root, Element element) {
        root.addContent(element);
    }

    /**
     * Renvoie l'élément enfant d'un élément enfant de la racine du document.
     * @param parent Nom de l'élément parent de l'élément é renvoyer.
     * @param child Nom de l'élément é renvoyer.
     * @return L'élément recherché.
     */
    public Element getRootElement(String parent, String child) {
        Element el = doc.getRootElement();
        return el.getChild(parent).getChild(child);
    }

    /**
     * Ecrit un document JDOM dans un fichier XML.
     * @param xmlFilename Nom du fichier XML é créer.
     */
    public void writeXml(String xmlFilename) {
        try {
            XMLOutputter outputter = new XMLOutputter();
            FileOutputStream output = new FileOutputStream(xmlFilename);
            outputter.output(doc, output);
            output.close();
        } catch (IOException ex) {
            ex.printStackTrace();
            EcritureLog.ecrire("Le fichier XML n'a pas pu étre créé.","err");
        }
    }

    /**
     * Ecrit un document JDOM dans un fichier XML.
     * @param xmlFilename Nom du fichier XML é créer.
     * @param codage Codage é utiliser.
     */
    public void writeXml(String xmlFilename, String codage) {
        try {
            XMLOutputter outputter = new XMLOutputter();
            FileOutputStream output = new FileOutputStream(xmlFilename);
            outputter.getFormat().setEncoding(codage);
            outputter.output(doc, output);
            output.close();
        } catch (IOException ex) {
            ex.printStackTrace();
            EcritureLog.ecrire("Le fichier XML n'a pas pu étre créé.","err");
        }
    }

    /**
     * Renvoie un document é partir d'un fichier XML.
     * @param xmlFilename Nom du fichier XML.
     */
    public void readXml(String xmlFilename) throws XMLException {
        SAXBuilder builder = new SAXBuilder();
        try {
                FileInputStream fic = new FileInputStream(xmlFilename);
            doc = builder.build(fic);
            fic.close();
        } catch (Exception e) {
            throw new XMLException(e);
        }
    }

    /**
     * Crée un élément JDOM.
     * @param name Nom de l'élément.
     * @return Elément créé.
     */
    public Element createElement(String name) {
        return new Element(name);
    }

    /**
     * Met é jour le document JDOM courant du builder.
     * @param doc Nouveau document.
     */
    public void setDocument(Document doc) {
        this.doc = doc;
    }

    /**
     * Renvoie l'élément root du document courant.
     * @return Element root.
     */
    public Element getRoot() {
        return doc.getRootElement();
    }

}