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
021package org.granite.util;
022
023import java.io.IOException;
024import java.io.InputStream;
025import java.io.OutputStream;
026import java.util.List;
027
028import org.w3c.dom.Document;
029import org.w3c.dom.Element;
030import org.w3c.dom.Node;
031import org.xml.sax.EntityResolver;
032import org.xml.sax.ErrorHandler;
033import org.xml.sax.SAXException;
034
035/**
036 * @author Franck WOLFF
037 */
038public 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}