// Created on: 2001-07-20
// Created by: Alexander GRIGORIEV
// Copyright (c) 2001-2014 OPEN CASCADE SAS
//
// This file is part of Open CASCADE Technology software library.
//
// This library is free software; you can redistribute it and/or modify it under
// the terms of the GNU Lesser General Public License version 2.1 as published
// by the Free Software Foundation, with special exception defined in the file
// OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
// distribution for complete text of the license and disclaimer of any warranty.
//
// Alternatively, this file may be used under the terms of Open CASCADE
// commercial license or contractual agreement.

// AGV 060302: Input from std::istream

#ifndef LDOMParser_HeaderFile
#define LDOMParser_HeaderFile

#include <LDOM_Document.hxx>
#include <LDOM_OSStream.hxx>

class LDOM_XmlReader;

// class std::istream;

//  Class LDOMParser
//

class LDOMParser
{
public:
  // ---------- PUBLIC METHODS ----------

  LDOMParser()
      : myReader(NULL),
        myCurrentData(16384)
  {
  }

  // Empty constructor

  virtual Standard_EXPORT ~LDOMParser();
  // Destructor

  Standard_EXPORT LDOM_Document getDocument();
  // Get the LDOM_Document

  Standard_EXPORT Standard_Boolean parse(const char* const aFileName);
  // Parse a file
  // Returns True if error occurred, then GetError() can be called

  Standard_EXPORT Standard_Boolean parse(std::istream&          anInput,
                                         const Standard_Boolean theTagPerStep  = Standard_False,
                                         const Standard_Boolean theWithoutRoot = Standard_False);
  // Parse a C++ stream
  // theTagPerStep - if true - extract characters from anInput until '>'
  //                           extracted character and parse only these characters.
  //                 if false - extract until eof
  // theWithoutRoot - if true - create fictive "document" element before parsing
  //                            and consider that document start element has been already read
  //                - if false - parse a document as usual (parse header, document tag and etc)
  // Returns True if error occurred, then GetError() can be called

  Standard_EXPORT const TCollection_AsciiString& GetError(TCollection_AsciiString& aData) const;
  // Return text describing a parsing error, or Empty if no error occurred

  // Returns the byte order mask defined at the start of a stream
  Standard_EXPORT LDOM_OSStream::BOMType GetBOM() const;

protected:
  // ---------- PROTECTED METHODS ----------

  Standard_EXPORT virtual Standard_Boolean startElement();
  // virtual hook on 'StartElement' event for descendant classes

  Standard_EXPORT virtual Standard_Boolean endElement();
  // virtual hook on 'EndElement' event for descendant classes

  Standard_EXPORT LDOM_Element getCurrentElement() const;
  // to be called from startElement() and endElement()

private:
  // ---------- PRIVATE METHODS ----------
  Standard_Boolean ParseDocument(Standard_IStream&      theIStream,
                                 const Standard_Boolean theWithoutRoot = Standard_False);

  Standard_Boolean ParseElement(Standard_IStream& theIStream, Standard_Boolean& theDocStart);

  // ---------- PRIVATE (PROHIBITED) METHODS ----------

  LDOMParser(const LDOMParser& theOther);
  // Copy constructor

  LDOMParser& operator=(const LDOMParser& theOther);
  // Assignment

private:
  // ---------- PRIVATE FIELDS ----------

  LDOM_XmlReader*         myReader;
  Handle(LDOM_MemManager) myDocument;
  LDOM_OSStream           myCurrentData;
  TCollection_AsciiString myError;
};

#endif