//////////////////////////////////////////////////////////////////////////////
//////////////////////////////////////////////////////////////////////////////
//
// copyright            : (C) 2008 by Eran Ifrah
// file name            : xmlutils.h
//
// -------------------------------------------------------------------------
// A
//              _____           _      _     _ _
//             /  __ \         | |    | |   (_) |
//             | /  \/ ___   __| | ___| |    _| |_ ___
//             | |    / _ \ / _  |/ _ \ |   | | __/ _ )
//             | \__/\ (_) | (_| |  __/ |___| | ||  __/
//              \____/\___/ \__,_|\___\_____/_|\__\___|
//
//                                                  F i l e
//
//    This program is free software; you can redistribute it and/or modify
//    it under the terms of the GNU General Public License as published by
//    the Free Software Foundation; either version 2 of the License, or
//    (at your option) any later version.
//
//////////////////////////////////////////////////////////////////////////////
//////////////////////////////////////////////////////////////////////////////
#ifndef XMLUTILS_H
#define XMLUTILS_H

#include "wx/xml/xml.h"
#include "serialized_object.h"

/// A collection of XML utils
class XmlUtils {
public:
	/// Find a child node by name by iterating the parent children. NULL if no childs exist
	/// \param parent  the parent node whom to be searched
	/// \param tagName the element tag name
	/// \param name	   the element 'Name' property value to search
	static wxXmlNode *FindNodeByName(const wxXmlNode *parent, const wxString &tagName, const wxString &name);

	/// Find the last child node of parent with a given name. NULL if no childs exist
	/// \param parent  the parent node whom to be searched
	/// \param name	   the element's tag name
	static wxXmlNode *FindLastByTagName(const wxXmlNode *parent, const wxString &tagName);


	/**
	 * update node property. If multiple properties with the same name exist, this function updates
     * the first occurance
	 * \param node
	 * \param name property name
	 * \param value new value to set
	 */
	static void UpdateProperty(wxXmlNode *node, const wxString &name, const wxString &value);

	/**
	 * Find the first child node of parent with a given name. NULL if no childs exist
	 * \param the parent node whom to be searched
	 * \param the element's tag name
	 */
	static wxXmlNode *FindFirstByTagName(const wxXmlNode *parent, const wxString &tagName);


	/**
	 * Set the content of node. This function replaces any existing content of node
	 * \param node
	 * \param text content
	 */
	static void SetNodeContent(wxXmlNode *node, const wxString &text);

	/**
	 * Set the content of node. This function replaces any existing content of node
	 * \param node
	 * \param text content
	 */
	static void SetCDATANodeContent(wxXmlNode *node, const wxString &text);

	/**
	 * Read string property from the given node
	 * \param propName the property name
	 * \param defaultValue default value to return if no property exist
	 */
	static wxString ReadString(wxXmlNode *node, const wxString &propName, const wxString &defaultValue = wxEmptyString);

	/**
	 * Read long property from the given node
	 * \param propName the property name
	 * \param defaultValue default value to return if no property exist
	 */
	static long ReadLong(wxXmlNode *node, const wxString &propName, long defaultValue = -1);
	
	/**
	 * Try to read long property from the given node
	 * If it doesn't exist, don't provide a default value.
	 * \param propName the property name
	 * \param answer will contain the result if found
	 * \return true if answer is valid, false if not found
	 */
	static bool ReadLongIfExists(wxXmlNode *node, const wxString &propName, long& answer);

	/**
	 * Read a boolean property from the given node
	 * \param propName the property name
	 * \param defaultValue default value to return if no property exist
	 */
	static bool ReadBool(wxXmlNode *node, const wxString &propName, bool defaultValue = false);

	/**
	 * Try to read a boolean property from the given node.
	 * If it doesn't exist, don't provide a default value.
	 * \param propName the property name
	 * \param value will contain the result if found
	 * \return true if answer is valid, false if not found
	 */
	static bool ReadStringIfExists(wxXmlNode* node, const wxString& propName, wxString& value);

	/**
	 * Try to read a boolean property from the given node.
	 * If it doesn't exist, don't provide a default value.
	 * \param propName the property name
	 * \param answer will contain the result if found
	 * \return true if answer is valid, false if not found
	 */
	static bool ReadBoolIfExists(wxXmlNode* node, const wxString& propName, bool& answer);

	/**
	 * Remove all children of xml node
	 * \param node xml node
	 */
	static void RemoveChildren(wxXmlNode *node);
	
	/**
	 * @brief read serialized object with version support
	 * @param root
	 * @param name
	 * @param obj
	 * @return 
	 */
	static bool StaticReadObject (wxXmlNode *root, const wxString &name, SerializedObject *obj);
	/**
	 * @brief write serialized object with version support
	 * @param root
	 * @param name
	 * @param obj
	 * @return 
	 */
	static bool StaticWriteObject(wxXmlNode *root, const wxString &name, SerializedObject *obj);
};

#endif // XMLUTILS_H
