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