UnrealEngineUWP/Engine/Source/Runtime/Serialization/Public/StructDeserializer.h

// Copyright 1998-2015 Epic Games, Inc. All Rights Reserved.

#pragma once


// forward declarations
class IStructDeserializerBackend;
class UStruct;


/**
 * Enumerates policies for various errors during de-serialization.
 */
enum class EStructDeserializerErrorPolicies
{
	/** Fail the de-serialization. */
	Error,
		
	/** Ignore the error (default). */
	Ignore,
		
	/** Print a warning to the log. */
	Warning,
};


/**
 * Structure for UStruct serialization policies.
 */
struct FStructDeserializerPolicies
{
	/** Holds the policy for handling missing fields. */
	EStructDeserializerErrorPolicies MissingFields;

	/** Default constructor. */
	FStructDeserializerPolicies()
		: MissingFields(EStructDeserializerErrorPolicies::Ignore)
	{ }
};


/**
 * Implements a static class that can deserialize UStruct based types.
 *
 * This class implements the basic functionality for the serialization of UStructs, such as
 * iterating a structure's properties and writing property values. The actual reading of
 * serialized input data is performed by de-serialization backends, which allows this
 * class to remain serialization format agnostic.
 */
class FStructDeserializer
{
public:

	/**
	 * Deserializes a data structure from an archive using the specified policy.
	 *
	 * @param OutStruct A pointer to the data structure to deserialize into.
	 * @param TypeInfo The data structure's type information.
	 * @param Backend The de-serialization backend to use.
	 * @param Policies The de-serialization policies to use.
	 * @return true if deserialization was successful, false otherwise.
	 */
	SERIALIZATION_API static bool Deserialize( void* OutStruct, UStruct& TypeInfo, IStructDeserializerBackend& Backend, const FStructDeserializerPolicies& Policies );

	/**
	 * Deserializes a data structure from an archive using the default policy.
	 *
	 * @param OutStruct A pointer to the data structure to deserialize into.
	 * @param TypeInfo The data structure's type information.
	 * @param Backend The de-serialization backend to use.
	 * @return true if deserialization was successful, false otherwise.
	 */
	static bool Deserialize( void* OutStruct, UStruct& TypeInfo, IStructDeserializerBackend& Backend )
	{
		return Deserialize(OutStruct, TypeInfo, Backend, FStructDeserializerPolicies());
	}

public:

	/**
	 * Deserializes a data structure from an archive using the default policy.
	 *
	 * @param OutStruct The struct to deserialize into.
	 * @param Backend The de-serialization backend to use.
	 * @return true if deserialization was successful, false otherwise.
	 */
	template<typename StructType>
	static bool Deserialize( StructType& OutStruct, IStructDeserializerBackend& Backend )
	{
		return Deserialize(&OutStruct, *StructType::StaticStruct(), Backend);
	}

	/**
	 * Deserializes a data structure from an archive using the specified policy.
	 *
	 * @param OutStruct The struct to deserialize into.
	 * @param Backend The de-serialization backend to use.
	 * @param Policies The de-serialization policies to use.
	 * @return true if deserialization was successful, false otherwise.
	 */
	template<typename StructType>
	static bool Deserialize( StructType& OutStruct, IStructDeserializerBackend& Backend, const FStructDeserializerPolicies& Policies )
	{
		return Deserialize(&OutStruct, *StructType::StaticStruct(), Backend, Policies);
	}
};