/*
* All or portions of this file Copyright (c) Amazon.com, Inc. or its affiliates or
* its licensors.
*
* For complete copyright and license terms please see the LICENSE at the root of this
* distribution (the "License"). All use of this software is governed by the License,
* or, if provided, by the license below or the license accompanying this file. Do not
* remove or modify any license notices. This file is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
*
*/
// Original file Copyright Crytek GMBH or its affiliates, used under license.

#ifndef CRYINCLUDE_CRYSYSTEM_XML_XMLUTILS_H
#define CRYINCLUDE_CRYSYSTEM_XML_XMLUTILS_H
#pragma once

#include "ISystem.h"

#ifdef _RELEASE
#define CHECK_STATS_THREAD_OWNERSHIP()
#else
#define CHECK_STATS_THREAD_OWNERSHIP() if (m_statsThreadOwner != CryGetCurrentThreadId()) {__debugbreak(); }
#endif

class CXmlNodePool;
class CXMLPatcher;

//////////////////////////////////////////////////////////////////////////
// Implements IXmlUtils interface.
//////////////////////////////////////////////////////////////////////////
class CXmlUtils
    : public IXmlUtils
    , public ISystemEventListener
{
public:
    CXmlUtils(ISystem* pSystem);
    virtual ~CXmlUtils();

    //////////////////////////////////////////////////////////////////////////
    // IXmlUtils
    //////////////////////////////////////////////////////////////////////////

    virtual IXmlParser* CreateXmlParser();

    // Load xml from file, returns 0 if load failed.
    virtual XmlNodeRef LoadXmlFromFile(const char* sFilename, bool bReuseStrings = false, bool bEnablePatching = true);
    // Load xml from memory buffer, returns 0 if load failed.
    virtual XmlNodeRef LoadXmlFromBuffer(const char* buffer, size_t size, bool bReuseStrings = false, bool bSuppressWarnings = false);

    // create an MD5 hash of an XML file
    virtual const char* HashXml(XmlNodeRef node);

    // Get an object that can read a xml into a IReadXMLSink
    // and write a xml from a IWriteXMLSource
    virtual IReadWriteXMLSink* GetIReadWriteXMLSink();

    virtual IXmlSerializer* CreateXmlSerializer();

    virtual bool SaveBinaryXmlFile(const char* sFilename, XmlNodeRef root);
    virtual XmlNodeRef LoadBinaryXmlFile(const char* sFilename, bool bEnablePatching = true);

    virtual bool EnableBinaryXmlLoading(bool bEnable);

    // Create XML Table reader.
    virtual IXmlTableReader* CreateXmlTableReader();
    //////////////////////////////////////////////////////////////////////////

    //////////////////////////////////////////////////////////////////////////
    // ISystemEventListener
    //////////////////////////////////////////////////////////////////////////
    virtual void OnSystemEvent(ESystemEvent event, UINT_PTR wparam, UINT_PTR lparam);
    //////////////////////////////////////////////////////////////////////////

    //////////////////////////////////////////////////////////////////////////
    virtual void GetMemoryUsage(ICrySizer* pSizer);

    //////////////////////////////////////////////////////////////////////////
    //////////////////////////////////////////////////////////////////////////
    // Init xml stats nodes pool
    virtual void InitStatsXmlNodePool(uint32 nPoolSize = 1024*1024);

    // Create new xml node for statistics
    virtual XmlNodeRef CreateStatsXmlNode(const char* sNodeName = "");

    // Set owner thread
    virtual void SetStatsOwnerThread(threadID threadId);

    // Free memory if stats xml node pool is empty
    virtual void FlushStatsXmlNodePool();

    // Set the XML Patcher. This is an XML object that modifies named XML files as they are loaded
    // EXCEPT for xml files loaded from a buffer, for which names aren't passed in
    virtual void SetXMLPatcher(XmlNodeRef* pPatcher);

private:
    ISystem* m_pSystem;
    IReadWriteXMLSink*    m_pReadWriteXMLSink;
    CXmlNodePool*                   m_pStatsXmlNodePool;
    CXMLPatcher*                    m_pXMLPatcher;              //If set, applies data patches to any XML file that is loaded by this class
#ifndef _RELEASE
    threadID m_statsThreadOwner;
#endif
};

#endif // CRYINCLUDE_CRYSYSTEM_XML_XMLUTILS_H