ejson/ejson/Document.hpp

94 lines
2.7 KiB
C++

/** @file
* @author Edouard DUPIN
* @copyright 2011, Edouard DUPIN, all right reserved
* @license APACHE v2.0 (see license file)
*/
#pragma once
#include <ejson/Value.hpp>
#include <vector>
#include <etk/types.hpp>
#include <ejson/String.hpp>
#include <ejson/Array.hpp>
#include <ejson/Object.hpp>
namespace ejson {
/**
* @brief ejson Document interface (acces with the file and stream).
*/
class Document : public ejson::Object {
public:
/**
* @brief Constructor
* @param[in] _internalValue Internal Value to set data
*/
Document(ememory::SharedPtr<ejson::internal::Value> _internalValue);
/**
* @brief Copy constructor
* @param[in] _obj Object to copy
*/
Document(const ejson::Document& _obj);
/**
* @brief Constructor
*/
Document();
/**
* @brief Copy constructor
* @param[in] _obj Object to copy
* @return Local reference on this object
*/
ejson::Document& operator= (const ejson::Document& _obj);
/**
* @brief parse a string that contain an Json
* @param[in] _data Data to parse
* @return false : An error occured
* @return true : Parsing is OK
*/
bool parse(const std::string& _data);
/**
* @brief generate a string that contain the created Json
* @param[out] _data Data where the Json is stored
* @return false : An error occured
* @return true : Parsing is OK
*/
bool generate(std::string& _data);
/**
* @brief Load the file that might contain the Json
* @param[in] _file Filename of the Json (compatible with etk FSNode naming)
* @return false : An error occured
* @return true : Parsing is OK
*/
bool load(const std::string& _file);
/**
* @brief Store the Json in the file
* @param[in] _file Filename of the Json (compatible with etk FSNode naming)
* @return false : An error occured
* @return true : Parsing is OK
*/
bool store(const std::string& _file);
/**
* @brief Store the Json in the file (safe mode mean that the file is store in a second file xxx.tmp and moved in the file xxx (only one mode to be really safe with filesystem ...)
* @param[in] _file Filename of the Json (compatible with etk FSNode naming)
* @return false : An error occured
* @return true : Parsing is OK
*/
bool storeSafe(const std::string& _file);
/**
* @brief Set the display of the error when detected.
* @param[in] _value true: display error, false not display error (get it at end)
*/
void setDisplayError(bool _value);
/**
* @brief Get the display of the error status.
* @return true Display error
* @return false Does not display error (get it at end)
*/
bool getDisplayError();
/**
* @brief Display error detected.
*/
void displayError();
};
}