Interface for element that gives the service of DataStore. More...

Detailed Description

Interface for element that gives the service of DataStore.

Inheritance diagram for IDataStore:

Public Member Methods
virtual bool	OpenReadNode (PCChar8 nodeName, IMessageCollector *messages=NULL)=0
	Open a node for reading. More...

virtual void	OpenWriteNode (PCChar8 nodeName)=0
	Open a node for writing. More...

virtual void	CloseNode (PCChar8 nodeName)=0
	Close the opened node. More...

virtual bool	OpenReadTextNode (PCChar8 nodeName, IMessageCollector *messages=NULL)=0
	Open a node for reading in text mode. More...

virtual void	OpenWriteTextNode (PCChar8 nodeName)=0
	Open a node for writing in text mode. More...

virtual TextReaderNode &	GetTextReaderNode ()=0
	Get the textReaderNode after openning a node for reading in text mode. More...

virtual TextWriterNode &	GetTextWriterNode ()=0
	Get the textWriterNode after openning a node for writing in text mode. More...

virtual void	CloseTextNode (PCChar8 nodeName)=0
	Close a text node. More...

virtual void	ReadValue (PCChar8 valueName, BaseStaticString &value, PCChar8 defaultValue="", IMessageCollector *messages=NULL)=0
	Reads a value. More...

virtual void	ReadValue (PCChar8 valueName, IStringConvertible &value, const IStringConvertible defaultValue=NULL, IMessageCollector messages=NULL)=0
	Reads a value. More...

virtual void	ReadValue (PCChar8 valueName, bool &value, const bool &defaultValue=false, IMessageCollector *messages=NULL)=0
	Reads a value. More...

virtual void	ReadValue (PCChar8 valueName, UInt16 &value, const UInt16 &defaultValue=0, IMessageCollector *messages=NULL)=0
	Reads a value. More...

virtual void	ReadValue (PCChar8 valueName, Int16 &value, const Int16 &defaultValue=0, IMessageCollector *messages=NULL)=0
	Reads a value. More...

virtual void	ReadValue (PCChar8 valueName, Int32 &value, const Int32 &defaultValue=0, IMessageCollector *messages=NULL)=0
	Reads a value. More...

virtual void	ReadValue (PCChar8 valueName, UInt32 &value, const UInt32 &defaultValue=0, IMessageCollector *messages=NULL)=0
	Reads a value. More...

virtual void	ReadValue (PCChar8 valueName, Int64 &value, const Int64 &defaultValue=0, IMessageCollector *messages=NULL)=0
	Reads a value. More...

virtual void	ReadValue (PCChar8 valueName, UInt64 &value, const UInt64 &defaultValue=0, IMessageCollector *messages=NULL)=0
	Reads a value. More...

virtual void	ReadValue (PCChar8 valueName, Float32 &value, const Float32 &defaultValue=0.0, IMessageCollector *messages=NULL)=0
	Reads a value. More...

virtual void	ReadValue (PCChar8 valueName, Float64 &value, const Float64 &defaultValue=0.0, IMessageCollector *messages=NULL)=0
	Reads a value. More...

virtual void	ReadValue (PCChar8 valueName, ISerializable &value, IMessageCollector *messages=NULL)=0
	Reads a value. More...

virtual void	WriteValue (PCChar8 valueName, PCChar8 value)=0
	Writes a value. More...

virtual void	WriteValue (PCChar8 valueName, const IStringConvertible &value)=0
	Writes a value. More...

virtual void	WriteValue (PCChar8 valueName, Int16 value)=0
	Writes a value. More...

virtual void	WriteValue (PCChar8 valueName, UInt16 value)=0
	Writes a value. More...

virtual void	WriteValue (PCChar8 valueName, Int32 value)=0
	Writes a value. More...

virtual void	WriteValue (PCChar8 valueName, UInt32 value)=0
	Writes a value. More...

virtual void	WriteValue (PCChar8 valueName, Int64 value)=0
	Writes a value. More...

virtual void	WriteValue (PCChar8 valueName, UInt64 value)=0
	Writes a value. More...

virtual void	WriteValue (PCChar8 valueName, bool value)=0
	Writes a value. More...

virtual void	WriteValue (PCChar8 valueName, Float64 value)=0
	Writes a value. More...

virtual void	WriteValue (PCChar8 valueName, const ISerializable &value)=0
	Writes a value. More...

Methods Documentation

virtual void CloseNode ( PCChar8 nodeName )

pure virtual

Close the opened node.

Parameters

nodeName The node name to close.

Warning: Call order dependence : Must be called after OpenReadNode() or OpenWriteNode().

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, XmlDataStoreStream, and ConceptDataStore.

virtual void CloseTextNode ( PCChar8 nodeName )

pure virtual

Close a text node.

Parameters

nodeName The node name to close.

Warning: Call order dependence : Must be called after OpenReadTextNode() or OpenWriteTextNode().

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual TextReaderNode& GetTextReaderNode ( )

pure virtual

Get the textReaderNode after openning a node for reading in text mode.

Returns: the TextReaderNode. TextReaderNode should be disposed after usage !

Warning: Call order dependence : OpenReadTextNode() must be called before.

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual TextWriterNode& GetTextWriterNode ( )

pure virtual

Get the textWriterNode after openning a node for writing in text mode.

Returns: the TextWriterNode. TextWriterNode should be disposed after usage !

Warning: Call order dependence : OpenWriteTextNode() must be called before.

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual bool OpenReadNode	(	PCChar8	nodeName,
		IMessageCollector *	messages = `NULL`
	)

pure virtual

Open a node for reading.

Parameters

nodeName	The node name to read.
messages	[in,out] (optional) The messageCollector to collect warning or error messages. Default = NULL.

Returns: true if it succeeds, false if it fails.

Warning: Call order dependence : Must call CloseNode() at the end of opperation.

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, XmlDataStoreStream, and ConceptDataStore.

virtual bool OpenReadTextNode	(	PCChar8	nodeName,
		IMessageCollector *	messages = `NULL`
	)

pure virtual

Open a node for reading in text mode.

Parameters

nodeName	The node name to read.
messages	[in,out] (optional) The messageCollector to collect warning or error messages. Default = NULL.

Returns: true if it succeeds, false if it fails.

Warning: Call order dependence : CloseTextNode() must be called after this opening.

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual void OpenWriteNode ( PCChar8 nodeName )

pure virtual

Open a node for writing.

Parameters

nodeName The node name to write.

Warning: Call order dependence : Must call CloseNode() at the end of opperation.

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, XmlDataStoreStream, and ConceptDataStore.

virtual void OpenWriteTextNode ( PCChar8 nodeName )

pure virtual

Open a node for writing in text mode.

Parameters

nodeName The node name to write.

Warning: Call order dependence : CloseTextNode() must be called after this opening.

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual void ReadValue	(	PCChar8	valueName,
		BaseStaticString &	value,
		PCChar8	defaultValue = `""`,
		IMessageCollector *	messages = `NULL`
	)

pure virtual

Reads a value.

Parameters

valueName	The valueName name.
value	[in,out] The value.
defaultValue	(optional) The default value. Default = ""
messages	[in,out] (optional) The messageCollector to collect warning or error messages. Default = NULL.

Warning: Call order dependence : OpenReadNode() must be called first.

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual void ReadValue	(	PCChar8	valueName,
		IStringConvertible &	value,
		const IStringConvertible *	defaultValue = `NULL`,
		IMessageCollector *	messages = `NULL`
	)

pure virtual

Reads a value.

Parameters

valueName	The valueName name.
value	[in,out] The value.
defaultValue	(optional) The default value. Default = NULL
messages	[in,out] (optional) The messageCollector to collect warning or error messages. Default = NULL.

Warning: Call order dependence : OpenReadNode() must be called first.

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual void ReadValue	(	PCChar8	valueName,
		bool &	value,
		const bool &	defaultValue = `false`,
		IMessageCollector *	messages = `NULL`
	)

pure virtual

Reads a value.

Parameters

valueName	The valueName name.
value	[in,out] The value.
defaultValue	(optional) The default value. Default = false
messages	[in,out] (optional) The messageCollector to collect warning or error messages. Default = NULL.

Warning: Call order dependence : OpenReadNode() must be called first.

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual void ReadValue	(	PCChar8	valueName,
		UInt16 &	value,
		const UInt16 &	defaultValue = `0`,
		IMessageCollector *	messages = `NULL`
	)

pure virtual

Reads a value.

Parameters

valueName	The valueName name.
value	[in,out] The value.
defaultValue	(optional) The default value. Default = 0
messages	[in,out] (optional) The messageCollector to collect warning or error messages. Default = NULL.

Warning: Call order dependence : OpenReadNode() must be called first.

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual void ReadValue	(	PCChar8	valueName,
		Int16 &	value,
		const Int16 &	defaultValue = `0`,
		IMessageCollector *	messages = `NULL`
	)

pure virtual

Reads a value.

Parameters

valueName	The valueName name.
value	[in,out] The value.
defaultValue	(optional) The default value. Default = 0
messages	[in,out] (optional) The messageCollector to collect warning or error messages. Default = NULL.

Warning: Call order dependence : OpenReadNode() must be called first.

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual void ReadValue	(	PCChar8	valueName,
		Int32 &	value,
		const Int32 &	defaultValue = `0`,
		IMessageCollector *	messages = `NULL`
	)

pure virtual

Reads a value.

Parameters

valueName	The valueName name.
value	[in,out] The value.
defaultValue	(optional) The default value. Default = 0
messages	[in,out] (optional) The messageCollector to collect warning or error messages. Default = NULL.

Warning: Call order dependence : OpenReadNode() must be called first.

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual void ReadValue	(	PCChar8	valueName,
		UInt32 &	value,
		const UInt32 &	defaultValue = `0`,
		IMessageCollector *	messages = `NULL`
	)

pure virtual

Reads a value.

Parameters

valueName	The valueName name.
value	[in,out] The value.
defaultValue	(optional) The default value. Default = 0
messages	[in,out] (optional) The messageCollector to collect warning or error messages. Default = NULL.

Warning: Call order dependence : OpenReadNode() must be called first.

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual void ReadValue	(	PCChar8	valueName,
		Int64 &	value,
		const Int64 &	defaultValue = `0`,
		IMessageCollector *	messages = `NULL`
	)

pure virtual

Reads a value.

Parameters

valueName	The valueName name.
value	[in,out] The value.
defaultValue	(optional) The default value. Default = 0
messages	[in,out] (optional) The messageCollector to collect warning or error messages. Default = NULL.

Warning: Call order dependence : OpenReadNode() must be called first.

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual void ReadValue	(	PCChar8	valueName,
		UInt64 &	value,
		const UInt64 &	defaultValue = `0`,
		IMessageCollector *	messages = `NULL`
	)

pure virtual

Reads a value.

Parameters

valueName	The valueName name.
value	[in,out] The value.
defaultValue	(optional) The default value. Default = 0
messages	[in,out] (optional) The messageCollector to collect warning or error messages. Default = NULL.

Warning: Call order dependence : OpenReadNode() must be called first.

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual void ReadValue	(	PCChar8	valueName,
		Float32 &	value,
		const Float32 &	defaultValue = `0.0`,
		IMessageCollector *	messages = `NULL`
	)

pure virtual

Reads a value.

Parameters

valueName	The valueName name.
value	[in,out] The value.
defaultValue	(optional) The default value. Default = 0
messages	[in,out] (optional) The messageCollector to collect warning or error messages. Default = NULL.

Warning: Call order dependence : OpenReadNode() must be called first.

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual void ReadValue	(	PCChar8	valueName,
		Float64 &	value,
		const Float64 &	defaultValue = `0.0`,
		IMessageCollector *	messages = `NULL`
	)

pure virtual

Reads a value.

Parameters

valueName	The valueName name.
value	[in,out] The value.
defaultValue	(optional) The default value. Default = 0
messages	[in,out] (optional) The messageCollector to collect warning or error messages. Default = NULL.

Warning: Call order dependence : OpenReadNode() must be called first.

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual void ReadValue	(	PCChar8	valueName,
		ISerializable &	value,
		IMessageCollector *	messages = `NULL`
	)

pure virtual

Reads a value.

Parameters

valueName	The valueName name.
value	[in,out] The value.
messages	[in,out] (optional) The messageCollector to collect warning or error messages. Default = NULL.

Warning: Call order dependence : OpenReadNode() must be called first.

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual void WriteValue	(	PCChar8	valueName,
		PCChar8	value
	)

pure virtual

Writes a value.

Parameters

valueName	The valueName.
value	The value.

Warning: Call order dependence : OpenWriteNode() must be called first.

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual void WriteValue	(	PCChar8	valueName,
		const IStringConvertible &	value
	)

pure virtual

Writes a value.

Parameters

valueName	The valueName.
value	The value.

Warning: Call order dependence : OpenWriteNode() must be called first.

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual void WriteValue	(	PCChar8	valueName,
		Int16	value
	)

pure virtual

Writes a value.

Parameters

valueName	The valueName.
value	The value.

Warning: Call order dependence : OpenWriteNode() must be called first.

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual void WriteValue	(	PCChar8	valueName,
		UInt16	value
	)

pure virtual

Writes a value.

Parameters

valueName	The valueName.
value	The value.

Warning: Call order dependence : OpenWriteNode() must be called first.

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual void WriteValue	(	PCChar8	valueName,
		Int32	value
	)

pure virtual

Writes a value.

Parameters

valueName	The valueName.
value	The value.

Warning: Call order dependence : OpenWriteNode() must be called first.

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual void WriteValue	(	PCChar8	valueName,
		UInt32	value
	)

pure virtual

Writes a value.

Parameters

valueName	The valueName.
value	The value.

Warning: Call order dependence : OpenWriteNode() must be called first.

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual void WriteValue	(	PCChar8	valueName,
		Int64	value
	)

pure virtual

Writes a value.

Parameters

valueName	The valueName.
value	The value.

Warning: Call order dependence : OpenWriteNode() must be called first.

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual void WriteValue	(	PCChar8	valueName,
		UInt64	value
	)

pure virtual

Writes a value.

Parameters

valueName	The valueName.
value	The value.

Warning: Call order dependence : OpenWriteNode() must be called first.

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual void WriteValue	(	PCChar8	valueName,
		bool	value
	)

pure virtual

Writes a value.

Parameters

valueName	The valueName.
value	The value.

Warning: Call order dependence : OpenWriteNode() must be called first.

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual void WriteValue	(	PCChar8	valueName,
		Float64	value
	)

pure virtual

Writes a value.

Parameters

valueName	The valueName.
value	The value.

Warning: Call order dependence : OpenWriteNode() must be called first.

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

virtual void WriteValue	(	PCChar8	valueName,
		const ISerializable &	value
	)

pure virtual

Writes a value.

Parameters

valueName	The valueName.
value	The value.

Warning: Call order dependence : OpenWriteNode() must be called first.

RT Exceptions:: RT_ERROR_BAD_CALL_ORDER

Implemented in XmlDataStoreWriter, XmlDataStoreDocument, XmlDataStoreReader, and ConceptDataStore.

Detailed Description

Public Member Methods

Methods Documentation