/*
* Copyright (C) 2009 eXo Platform SAS.
*
* This is free software; you can redistribute it and/or modify it
* under the terms of the GNU Lesser General Public License as
* published by the Free Software Foundation; either version 2.1 of
* the License, or (at your option) any later version.
*
* This software is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this software; if not, write to the Free
* Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
* 02110-1301 USA, or see the FSF site: http://www.fsf.org.
*/
package org.exoplatform.services.jcr.impl.xml.importing;
import org.exoplatform.services.jcr.dataflow.PlainChangesLog;
import java.util.Map;
import javax.jcr.RepositoryException;
/**
* @author <a href="mailto:Sergey.Kabashnyuk@gmail.com">Sergey Kabashnyuk</a>
* @version $Id: ContentImporter.java 13888 2008-05-05 13:47:27Z ksm $
*/
public interface ContentImporter
{
/**
*
*/
public String RESPECT_PROPERTY_DEFINITIONS_CONSTRAINTS = "respectPropertyDefinitionsConstraints";
public final String LIST_OF_IMPORTED_VERSION_HISTORIES = "importedSubversions";
/**
* Receive notification of character data.
*
* @param ch
* @param start
* @param length
* @throws RepositoryException
*/
public void characters(char[] ch, int start, int length) throws RepositoryException;
/**
* Receive notification of the end of an element.
* <p>
* The parser will invoke this method at the end of every element in the XML document; there will
* be a corresponding startElement event for every endElement event (even when the element is
* empty).
* </p>
* <p>
* For information on the names, see startElement.
* </p>
*
* @param uri
* the Namespace URI, or the empty string if the element has no Namespace URI or if
* Namespace processing is not being performed
* @param localName
* the local name (without prefix), or the empty string if Namespace processing is not
* being performed
* @param qName
* the qualified XML name (with prefix), or the empty string if qualified names are not
* available
*/
public void endElement(String uri, String localName, String qName) throws RepositoryException;
/**
* @param prefix
* @param uri
*/
public void registerNamespace(String prefix, String uri);
/**
*
*/
// public void save() throws RepositoryException;
public PlainChangesLog getChanges();
/**
* Receive notification of the beginning of an element.
* <p>
* The Parser will invoke this method at the beginning of every element in the XML document; there
* will be a corresponding {@link #endElement endElement} event for every startElement event (even
* when the element is empty). All of the element's content will be reported, in order, before the
* corresponding endElement event.
* </p>
*
* @param namespaceURI
* the Namespace URI, or the empty string if the element has no Namespace URI or if
* Namespace processing is not being performed
* @param localName
* the local name (without prefix), or the empty string if Namespace processing is not
* being performed
* @param qName
* the qualified name (with prefix), or the empty string if qualified names are not
* available
* @param atts
* the attributes attached to the element. If there are no attributes, it shall be an
* empty object. The value of this object after startElement returns is undefined
* @throws RepositoryException
* @see #endElement
* @see org.xml.sax.Attributes
* @see org.xml.sax.helpers.AttributesImpl
*/
public void startElement(String namespaceURI, String localName, String qName, Map<String, String> atts)
throws RepositoryException;
}