001    /*
002      GRANITE DATA SERVICES
003      Copyright (C) 2011 GRANITE DATA SERVICES S.A.S.
004    
005      This file is part of Granite Data Services.
006    
007      Granite Data Services is free software; you can redistribute it and/or modify
008      it under the terms of the GNU Library General Public License as published by
009      the Free Software Foundation; either version 2 of the License, or (at your
010      option) any later version.
011    
012      Granite Data Services is distributed in the hope that it will be useful, but
013      WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
014      FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License
015      for more details.
016    
017      You should have received a copy of the GNU Library General Public License
018      along with this library; if not, see <http://www.gnu.org/licenses/>.
019    */
020    
021    package org.granite.util;
022    
023    import java.io.IOException;
024    import java.io.InputStream;
025    import java.io.OutputStream;
026    import java.util.List;
027    
028    import org.w3c.dom.Document;
029    import org.w3c.dom.Element;
030    import org.w3c.dom.Node;
031    import org.xml.sax.EntityResolver;
032    import org.xml.sax.ErrorHandler;
033    import org.xml.sax.SAXException;
034    
035    /**
036     * @author Franck WOLFF
037     */
038    public interface XMLUtil {
039    
040            public Document newDocument();
041            
042            public Document newDocument(String root);
043            
044            public Document getDocument(Node node);
045    
046            public Element newElement(Node parent, String name);
047    
048            public Element newElement(Node parent, String name, String value);
049            
050            public String getNormalizedValue(Node node);
051            
052            public String setValue(Node node, String value);
053            
054        public Document buildDocument(String xml);
055        
056            public Document loadDocument(InputStream input) throws IOException, SAXException;
057            
058            public Document loadDocument(InputStream input, EntityResolver resolver, ErrorHandler errorHandler) throws IOException, SAXException;
059        
060            public void saveDocument(Document document, OutputStream output);
061            
062        public String toString(Document doc);
063        
064            public String toNodeString(Node node);
065            
066            public Node selectSingleNode(Object context, String expression);
067            
068            public List<Node> selectNodeSet(Object context, String expression);
069    
070    }