#include <StdDeserializer.h>

Inheritance diagram for CStdDeserializer:

Collaboration diagram for CStdDeserializer:

Public Member Functions
	CStdDeserializer (ScriptInterface &scriptInterface, std::istream &stream)

virtual	~CStdDeserializer ()

virtual void	ScriptVal (const char *name, JS::MutableHandleValue out)
	Deserialize a jsval, replacing 'out'. More...

virtual void	ScriptObjectAppend (const char *name, JS::HandleValue objVal)
	Deserialize an object value, appending properties to object 'objVal'. More...

virtual void	ScriptString (const char *name, JS::MutableHandleString out)
	Deserialize a JSString. More...

virtual std::istream &	GetStream ()
	Returns a stream which can be used to deserialize data directly. More...

virtual void	RequireBytesInStream (size_t numBytes)
	Throws an exception if the stream definitely cannot provide the required number of bytes. More...

virtual void	SetSerializablePrototypes (std::map< std::wstring, JS::Heap< JSObject * > > &prototypes)

void	TraceMember (JSTracer *trc)

Public Member Functions inherited from IDeserializer
virtual	~IDeserializer ()

virtual void	NumberU8 (const char *name, uint8_t &out, uint8_t lower, uint8_t upper)

virtual void	NumberI8 (const char *name, int8_t &out, int8_t lower, int8_t upper)

virtual void	NumberU16 (const char *name, uint16_t &out, uint16_t lower, uint16_t upper)

virtual void	NumberI16 (const char *name, int16_t &out, int16_t lower, int16_t upper)

virtual void	NumberU32 (const char *name, uint32_t &out, uint32_t lower, uint32_t upper)

virtual void	NumberI32 (const char *name, int32_t &out, int32_t lower, int32_t upper)

virtual void	NumberU8_Unbounded (const char *name, uint8_t &out)

virtual void	NumberI8_Unbounded (const char *name, int8_t &out)

virtual void	NumberU16_Unbounded (const char *name, uint16_t &out)

virtual void	NumberI16_Unbounded (const char *name, int16_t &out)

virtual void	NumberU32_Unbounded (const char *name, uint32_t &out)

virtual void	NumberI32_Unbounded (const char *name, int32_t &out)

virtual void	NumberFloat_Unbounded (const char *name, float &out)

virtual void	NumberDouble_Unbounded (const char *name, double &out)

virtual void	NumberFixed_Unbounded (const char *name, fixed &out)

virtual void	Bool (const char *name, bool &out)

virtual void	StringASCII (const char *name, std::string &out, uint32_t minlength, uint32_t maxlength)

virtual void	String (const char *name, std::wstring &out, uint32_t minlength, uint32_t maxlength)

virtual void	RawBytes (const char name, u8 data, size_t len)

virtual int	GetVersion () const

Static Public Member Functions
static void	Trace (JSTracer trc, void data)

Protected Member Functions
virtual void	Get (const char name, u8 data, size_t len)

Private Member Functions
	NONCOPYABLE (CStdDeserializer)

jsval	ReadScriptVal (const char *name, JS::HandleObject appendParent)

void	ReadStringLatin1 (const char *name, std::vector< JS::Latin1Char > &str)

void	ReadStringUTF16 (const char *name, utf16string &str)

virtual void	AddScriptBackref (JS::HandleObject obj)

virtual void	GetScriptBackref (u32 tag, JS::MutableHandleObject ret)

bool	IsSerializablePrototype (const std::wstring &name)

void	GetSerializablePrototype (const std::wstring &name, JS::MutableHandleObject ret)

Private Attributes
std::vector< JS::Heap< JSObject * > >	m_ScriptBackrefs

JS::PersistentRooted< JSObject * >	m_dummyObject

ScriptInterface &	m_ScriptInterface

std::istream &	m_Stream

std::map< std::wstring, JS::Heap< JSObject * > >	m_SerializablePrototypes

Constructor & Destructor Documentation

CStdDeserializer::CStdDeserializer	(	ScriptInterface &	scriptInterface,
		std::istream &	stream
	)

CStdDeserializer::~CStdDeserializer ( )

virtual

Member Function Documentation

void CStdDeserializer::AddScriptBackref ( JS::HandleObject obj )

privatevirtual

void CStdDeserializer::Get	(	const char *	name,
		u8 *	data,
		size_t	len
	)

protectedvirtual

Implements IDeserializer.

void CStdDeserializer::GetScriptBackref	(	u32	tag,
		JS::MutableHandleObject	ret
	)

privatevirtual

void CStdDeserializer::GetSerializablePrototype	(	const std::wstring &	name,
		JS::MutableHandleObject	ret
	)

private

std::istream & CStdDeserializer::GetStream ( )

virtual

Returns a stream which can be used to deserialize data directly.

(This is particularly useful for chaining multiple deserializers together.)

Implements IDeserializer.

bool CStdDeserializer::IsSerializablePrototype ( const std::wstring & name )

private

CStdDeserializer::NONCOPYABLE ( CStdDeserializer )

private

jsval CStdDeserializer::ReadScriptVal	(	const char *	name,
		JS::HandleObject	appendParent
	)

private

void CStdDeserializer::ReadStringLatin1	(	const char *	name,
		std::vector< JS::Latin1Char > &	str
	)

private

void CStdDeserializer::ReadStringUTF16	(	const char *	name,
		utf16string &	str
	)

private

void CStdDeserializer::RequireBytesInStream ( size_t numBytes )

virtual

Throws an exception if the stream definitely cannot provide the required number of bytes.

(It might be conservative and not throw an exception in some cases where the stream actually can't provide the required bytes.) (This should be used when allocating memory based on data in the stream, e.g. reading strings, to avoid dangerously large allocations when the data is invalid.)

Implements IDeserializer.

void CStdDeserializer::ScriptObjectAppend	(	const char *	name,
		JS::HandleValue	objVal
	)

virtual

Deserialize an object value, appending properties to object 'objVal'.

Implements IDeserializer.

void CStdDeserializer::ScriptString	(	const char *	name,
		JS::MutableHandleString	out
	)

virtual

Deserialize a JSString.

Implements IDeserializer.

void CStdDeserializer::ScriptVal	(	const char *	name,
		JS::MutableHandleValue	out
	)

virtual

Deserialize a jsval, replacing 'out'.

Implements IDeserializer.

void CStdDeserializer::SetSerializablePrototypes ( std::map< std::wstring, JS::Heap< JSObject * > > & prototypes )

virtual

void CStdDeserializer::Trace	(	JSTracer *	trc,
		void *	data
	)

static

void CStdDeserializer::TraceMember ( JSTracer * trc )

Member Data Documentation

JS::PersistentRooted<JSObject*> CStdDeserializer::m_dummyObject

private

std::vector<JS::Heap<JSObject*> > CStdDeserializer::m_ScriptBackrefs

private

ScriptInterface& CStdDeserializer::m_ScriptInterface

private

std::map<std::wstring, JS::Heap<JSObject*> > CStdDeserializer::m_SerializablePrototypes

private

std::istream& CStdDeserializer::m_Stream

private

The documentation for this class was generated from the following files:

/var/svn/checkout/source/simulation2/serialization/StdDeserializer.h
/var/svn/checkout/source/simulation2/serialization/StdDeserializer.cpp

Public Member Functions

Static Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation