| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017101810191020102110221023102410251026102710281029103010311032103310341035103610371038103910401041104210431044104510461047104810491050105110521053105410551056105710581059106010611062106310641065106610671068106910701071107210731074107510761077107810791080108110821083108410851086108710881089109010911092109310941095109610971098109911001101110211031104110511061107110811091110111111121113111411151116111711181119112011211122112311241125112611271128112911301131113211331134113511361137113811391140114111421143114411451146114711481149115011511152115311541155115611571158115911601161116211631164116511661167116811691170117111721173117411751176117711781179118011811182118311841185118611871188118911901191119211931194119511961197119811991200120112021203120412051206120712081209121012111212121312141215121612171218121912201221122212231224122512261227122812291230123112321233123412351236123712381239124012411242124312441245124612471248124912501251125212531254125512561257125812591260126112621263126412651266126712681269127012711272127312741275127612771278127912801281128212831284128512861287128812891290129112921293129412951296129712981299130013011302130313041305130613071308130913101311131213131314131513161317131813191320132113221323132413251326132713281329133013311332133313341335133613371338133913401341134213431344 |
- #include "BsBinarySerializer.h"
- #include "BsException.h"
- #include "BsDebug.h"
- #include "BsIReflectable.h"
- #include "BsRTTIType.h"
- #include "BsRTTIField.h"
- #include "BsRTTIPlainField.h"
- #include "BsRTTIReflectableField.h"
- #include "BsRTTIReflectablePtrField.h"
- #include "BsRTTIManagedDataBlockField.h"
- #include <unordered_set>
- /**
- * @brief A macro that represents a block of code that gets used a lot inside
- * encodeInternal. It checks if the buffer has enough space, and if it does
- * it copies the data from the specified location and increments the needed
- * pointers and counters. If there is not enough space the buffer is flushed
- * (hopefully to make some space). If there is still not enough space the entire
- * encoding process ends.
- *
- * @param dataPtr Pointer to data which to copy.
- * @param size Size of the data to copy
- */
- #define COPY_TO_BUFFER(dataIter, size) \
- if((*bytesWritten + size##) > bufferLength) \
- { \
- mTotalBytesWritten += *bytesWritten; \
- buffer = flushBufferCallback(buffer - *bytesWritten, *bytesWritten, bufferLength); \
- if(buffer == nullptr || bufferLength < size##) return nullptr; \
- *bytesWritten = 0; \
- } \
- \
- memcpy(buffer, dataIter##, size##); \
- buffer += size##; \
- *bytesWritten += size##;
- namespace BansheeEngine
- {
- BinarySerializer::BinarySerializer()
- :mLastUsedObjectId(1)
- {
- }
- void BinarySerializer::encode(IReflectable* object, UINT8* buffer, UINT32 bufferLength,
- UINT32* bytesWritten, std::function<UINT8*(UINT8*, UINT32, UINT32&)> flushBufferCallback, bool shallow)
- {
- mObjectsToEncode.clear();
- mObjectAddrToId.clear();
- mLastUsedObjectId = 1;
- *bytesWritten = 0;
- mTotalBytesWritten = 0;
- UINT8* bufferStart = buffer;
- Vector<std::shared_ptr<IReflectable>> encodedObjects;
- UINT32 objectId = findOrCreatePersistentId(object);
-
- // Encode primary object and its value types
- buffer = encodeInternal(object, objectId, buffer, bufferLength, bytesWritten, flushBufferCallback, shallow);
- if(buffer == nullptr)
- {
- BS_EXCEPT(InternalErrorException,
- "Destination buffer is null or not large enough.");
- }
- // Encode pointed to objects and their value types
- UnorderedSet<UINT32> serializedObjects;
- while(true)
- {
- auto iter = mObjectsToEncode.begin();
- bool foundObjectToProcess = false;
- for(iter; iter != mObjectsToEncode.end(); ++iter)
- {
- auto foundExisting = serializedObjects.find(iter->objectId);
- if(foundExisting != serializedObjects.end())
- continue; // Already processed
- std::shared_ptr<IReflectable> curObject = iter->object;
- UINT32 curObjectid = iter->objectId;
- serializedObjects.insert(curObjectid);
- mObjectsToEncode.erase(iter);
- buffer = encodeInternal(curObject.get(), curObjectid, buffer,
- bufferLength, bytesWritten, flushBufferCallback, shallow);
- if(buffer == nullptr)
- {
- BS_EXCEPT(InternalErrorException,
- "Destination buffer is null or not large enough.");
- }
- foundObjectToProcess = true;
- // Ensure we keep a reference to the object so it isn't released.
- // The system assigns unique IDs to IReflectable objects based on pointer
- // addresses but if objects get released then same address could be assigned twice.
- // Note: To get around this I could assign unique IDs to IReflectable objects
- encodedObjects.push_back(curObject);
- break; // Need to start over as mObjectsToSerialize was possibly modified
- }
- if(!foundObjectToProcess) // We're done
- break;
- }
- // Final flush
- if(*bytesWritten > 0)
- {
- mTotalBytesWritten += *bytesWritten;
- buffer = flushBufferCallback(buffer - *bytesWritten, *bytesWritten, bufferLength);
- }
- *bytesWritten = mTotalBytesWritten;
- encodedObjects.clear();
- mObjectsToEncode.clear();
- mObjectAddrToId.clear();
- }
- std::shared_ptr<IReflectable> BinarySerializer::decode(UINT8* data, UINT32 dataLength)
- {
- UINT32 dummy = 0;
- SPtr<SerializedObject> intermediateObject = _decodeIntermediate(data, dataLength, dummy);
- if (intermediateObject == nullptr)
- return nullptr;
- return _decodeIntermediate(intermediateObject);
- }
- SPtr<IReflectable> BinarySerializer::_decodeIntermediate(const SPtr<SerializedObject>& serializedObject)
- {
- mObjectMap.clear();
- SPtr<IReflectable> output;
- RTTITypeBase* type = IReflectable::_getRTTIfromTypeId(serializedObject->getRootTypeId());
- if (type != nullptr)
- {
- output = type->newRTTIObject();
- auto iterNewObj = mObjectMap.insert(std::make_pair(serializedObject, ObjectToDecode(output, serializedObject)));
- decodeInternal(output, serializedObject);
- iterNewObj.first->second.isDecoded = true;
- }
- // Go through the remaining objects (should be only ones with weak refs)
- for (auto iter = mObjectMap.begin(); iter != mObjectMap.end(); ++iter)
- {
- ObjectToDecode& objToDecode = iter->second;
- if (objToDecode.isDecoded)
- continue;
- decodeInternal(objToDecode.object, objToDecode.serializedObject);
- objToDecode.isDecoded = true;
- }
- mObjectMap.clear();
- return output;
- }
- UINT8* BinarySerializer::encodeInternal(IReflectable* object, UINT32 objectId, UINT8* buffer, UINT32& bufferLength,
- UINT32* bytesWritten, std::function<UINT8*(UINT8*, UINT32, UINT32&)> flushBufferCallback, bool shallow)
- {
- RTTITypeBase* si = object->getRTTI();
- bool isBaseClass = false;
- // If an object has base classes, we need to iterate through all of them
- do
- {
- si->onSerializationStarted(object);
- // Encode object ID & type
- ObjectMetaData objectMetaData = encodeObjectMetaData(objectId, si->getRTTIId(), isBaseClass);
- COPY_TO_BUFFER(&objectMetaData, sizeof(ObjectMetaData))
- int numFields = si->getNumFields();
- for(int i = 0; i < numFields; i++)
- {
- RTTIField* curGenericField = si->getField(i);
- // Copy field ID & other meta-data like field size and type
- int metaData = encodeFieldMetaData(curGenericField->mUniqueId, curGenericField->getTypeSize(),
- curGenericField->mIsVectorType, curGenericField->mType, curGenericField->hasDynamicSize());
- COPY_TO_BUFFER(&metaData, META_SIZE)
- if(curGenericField->mIsVectorType)
- {
- UINT32 arrayNumElems = curGenericField->getArraySize(object);
- // Copy num vector elements
- COPY_TO_BUFFER(&arrayNumElems, NUM_ELEM_FIELD_SIZE)
- switch(curGenericField->mType)
- {
- case SerializableFT_ReflectablePtr:
- {
- RTTIReflectablePtrFieldBase* curField = static_cast<RTTIReflectablePtrFieldBase*>(curGenericField);
- for(UINT32 arrIdx = 0; arrIdx < arrayNumElems; arrIdx++)
- {
- std::shared_ptr<IReflectable> childObject;
-
- if (!shallow)
- childObject = curField->getArrayValue(object, arrIdx);
- UINT32 objId = registerObjectPtr(childObject);
- COPY_TO_BUFFER(&objId, sizeof(UINT32))
- }
- break;
- }
- case SerializableFT_Reflectable:
- {
- RTTIReflectableFieldBase* curField = static_cast<RTTIReflectableFieldBase*>(curGenericField);
- for(UINT32 arrIdx = 0; arrIdx < arrayNumElems; arrIdx++)
- {
- IReflectable& childObject = curField->getArrayValue(object, arrIdx);
- buffer = complexTypeToBuffer(&childObject, buffer, bufferLength,
- bytesWritten, flushBufferCallback, shallow);
- if(buffer == nullptr)
- {
- si->onSerializationEnded(object);
- return nullptr;
- }
- }
- break;
- }
- case SerializableFT_Plain:
- {
- RTTIPlainFieldBase* curField = static_cast<RTTIPlainFieldBase*>(curGenericField);
- for(UINT32 arrIdx = 0; arrIdx < arrayNumElems; arrIdx++)
- {
- UINT32 typeSize = 0;
- if(curField->hasDynamicSize())
- typeSize = curField->getArrayElemDynamicSize(object, arrIdx);
- else
- typeSize = curField->getTypeSize();
- if ((*bytesWritten + typeSize) > bufferLength)
- {
- UINT8* tempBuffer = (UINT8*)stackAlloc(typeSize);
- curField->arrayElemToBuffer(object, arrIdx, tempBuffer);
- buffer = dataBlockToBuffer(tempBuffer, typeSize, buffer, bufferLength, bytesWritten, flushBufferCallback);
- if (buffer == nullptr || bufferLength == 0)
- {
- stackDeallocLast(tempBuffer);
- si->onSerializationEnded(object);
- return nullptr;
- }
- stackDeallocLast(tempBuffer);
- }
- else
- {
- curField->arrayElemToBuffer(object, arrIdx, buffer);
- buffer += typeSize;
- *bytesWritten += typeSize;
- }
- }
- break;
- }
- default:
- BS_EXCEPT(InternalErrorException,
- "Error encoding data. Encountered a type I don't know how to encode. Type: " + toString(UINT32(curGenericField->mType)) +
- ", Is array: " + toString(curGenericField->mIsVectorType));
- }
- }
- else
- {
- switch(curGenericField->mType)
- {
- case SerializableFT_ReflectablePtr:
- {
- RTTIReflectablePtrFieldBase* curField = static_cast<RTTIReflectablePtrFieldBase*>(curGenericField);
- std::shared_ptr<IReflectable> childObject;
-
- if (!shallow)
- childObject = curField->getValue(object);
- UINT32 objId = registerObjectPtr(childObject);
- COPY_TO_BUFFER(&objId, sizeof(UINT32))
- break;
- }
- case SerializableFT_Reflectable:
- {
- RTTIReflectableFieldBase* curField = static_cast<RTTIReflectableFieldBase*>(curGenericField);
- IReflectable& childObject = curField->getValue(object);
- buffer = complexTypeToBuffer(&childObject, buffer, bufferLength,
- bytesWritten, flushBufferCallback, shallow);
- if(buffer == nullptr)
- {
- si->onSerializationEnded(object);
- return nullptr;
- }
- break;
- }
- case SerializableFT_Plain:
- {
- RTTIPlainFieldBase* curField = static_cast<RTTIPlainFieldBase*>(curGenericField);
- UINT32 typeSize = 0;
- if(curField->hasDynamicSize())
- typeSize = curField->getDynamicSize(object);
- else
- typeSize = curField->getTypeSize();
- if ((*bytesWritten + typeSize) > bufferLength)
- {
- UINT8* tempBuffer = (UINT8*)stackAlloc(typeSize);
- curField->toBuffer(object, tempBuffer);
-
- buffer = dataBlockToBuffer(tempBuffer, typeSize, buffer, bufferLength, bytesWritten, flushBufferCallback);
- if (buffer == nullptr || bufferLength == 0)
- {
- stackDeallocLast(tempBuffer);
- si->onSerializationEnded(object);
- return nullptr;
- }
- stackDeallocLast(tempBuffer);
- }
- else
- {
- curField->toBuffer(object, buffer);
- buffer += typeSize;
- *bytesWritten += typeSize;
- }
- break;
- }
- case SerializableFT_DataBlock:
- {
- RTTIManagedDataBlockFieldBase* curField = static_cast<RTTIManagedDataBlockFieldBase*>(curGenericField);
- ManagedDataBlock value = curField->getValue(object);
- // Data block size
- UINT32 dataBlockSize = value.getSize();
- COPY_TO_BUFFER(&dataBlockSize, sizeof(UINT32))
- // Data block data
- UINT8* dataToStore = value.getData();
- buffer = dataBlockToBuffer(dataToStore, dataBlockSize, buffer, bufferLength, bytesWritten, flushBufferCallback);
- if (buffer == nullptr || bufferLength == 0)
- {
- si->onSerializationEnded(object);
- return nullptr;
- }
- break;
- }
- default:
- BS_EXCEPT(InternalErrorException,
- "Error encoding data. Encountered a type I don't know how to encode. Type: " + toString(UINT32(curGenericField->mType)) +
- ", Is array: " + toString(curGenericField->mIsVectorType));
- }
- }
- }
- si->onSerializationEnded(object);
- si = si->getBaseClass();
- isBaseClass = true;
- } while(si != nullptr); // Repeat until we reach the top of the inheritance hierarchy
- return buffer;
- }
- SPtr<SerializedObject> BinarySerializer::_decodeIntermediate(UINT8* data, UINT32 dataLength, UINT32& bytesRead)
- {
- mInterimObjectMap.clear();
- SPtr<SerializedObject> rootObj;
- bool hasMore = decodeIntermediateInternal(data, dataLength, bytesRead, rootObj);
- while (hasMore)
- {
- UINT8* dataPtr = data + bytesRead;
- SPtr<SerializedObject> dummyObj;
- hasMore = decodeIntermediateInternal(dataPtr, dataLength, bytesRead, dummyObj);
- }
- return rootObj;
- }
- bool BinarySerializer::decodeIntermediateInternal(UINT8* data, UINT32 dataLength, UINT32& bytesRead, SPtr<SerializedObject>& output)
- {
- if ((bytesRead + sizeof(ObjectMetaData)) > dataLength)
- {
- BS_EXCEPT(InternalErrorException,
- "Error decoding data.");
- }
- ObjectMetaData objectMetaData;
- objectMetaData.objectMeta = 0;
- objectMetaData.typeId = 0;
- memcpy(&objectMetaData, data, sizeof(ObjectMetaData));
- data += sizeof(ObjectMetaData);
- bytesRead += sizeof(ObjectMetaData);
- UINT32 objectId = 0;
- UINT32 objectTypeId = 0;
- bool objectIsBaseClass = false;
- decodeObjectMetaData(objectMetaData, objectId, objectTypeId, objectIsBaseClass);
- if (objectIsBaseClass)
- {
- BS_EXCEPT(InternalErrorException, "Encountered a base-class object while looking for a new object. " \
- "Base class objects are only supposed to be parts of a larger object.");
- }
- RTTITypeBase* rtti = IReflectable::_getRTTIfromTypeId(objectTypeId);
- SerializedSubObject* serializedSubObject = nullptr;
-
- if (rtti != nullptr)
- {
- if (objectId > 0)
- {
- auto iterFind = mInterimObjectMap.find(objectId);
- if (iterFind == mInterimObjectMap.end())
- {
- output = bs_shared_ptr<SerializedObject>();
- mInterimObjectMap.insert(std::make_pair(objectId, output));
- }
- else
- output = iterFind->second;
- }
- else // Not a reflectable ptr referenced object
- output = bs_shared_ptr<SerializedObject>();
- output->subObjects.push_back(SerializedSubObject());
- serializedSubObject = &output->subObjects.back();
- serializedSubObject->typeId = objectTypeId;
- }
- while (bytesRead < dataLength)
- {
- int metaData = -1;
- if ((bytesRead + META_SIZE) > dataLength)
- {
- BS_EXCEPT(InternalErrorException,
- "Error decoding data.");
- }
- memcpy((void*)&metaData, data, META_SIZE);
- if (isObjectMetaData(metaData)) // We've reached a new object
- {
- if ((bytesRead + sizeof(ObjectMetaData)) > dataLength)
- {
- BS_EXCEPT(InternalErrorException,
- "Error decoding data.");
- }
- ObjectMetaData objMetaData;
- objMetaData.objectMeta = 0;
- objMetaData.typeId = 0;
- memcpy(&objMetaData, data, sizeof(ObjectMetaData));
- UINT32 objId = 0;
- UINT32 objTypeId = 0;
- bool objIsBaseClass = false;
- decodeObjectMetaData(objMetaData, objId, objTypeId, objIsBaseClass);
- // If it's a base class, get base class RTTI and handle that
- if (objIsBaseClass)
- {
- if (rtti != nullptr)
- rtti = rtti->getBaseClass();
- // Saved and current base classes don't match, so just skip over all that data
- if (rtti == nullptr || rtti->getRTTIId() != objTypeId)
- {
- rtti = nullptr;
- }
- if (rtti != nullptr)
- {
- output->subObjects.push_back(SerializedSubObject());
- serializedSubObject = &output->subObjects.back();
- serializedSubObject->typeId = objTypeId;
- }
- data += sizeof(ObjectMetaData);
- bytesRead += sizeof(ObjectMetaData);
- continue;
- }
- else
- {
- if (objId != 0)
- return true;
- // Objects with ID == 0 represent complex types serialized by value, but they should only get serialized
- // if we encounter a field with one, not by just iterating through the file.
- BS_EXCEPT(InternalErrorException, "Object with ID 0 encountered. Cannot proceed with serialization.");
- }
- }
- data += META_SIZE;
- bytesRead += META_SIZE;
- bool isArray;
- SerializableFieldType fieldType;
- UINT16 fieldId;
- UINT8 fieldSize;
- bool hasDynamicSize;
- decodeFieldMetaData(metaData, fieldId, fieldSize, isArray, fieldType, hasDynamicSize);
- RTTIField* curGenericField = nullptr;
- if (rtti != nullptr)
- curGenericField = rtti->findField(fieldId);
- if (curGenericField != nullptr)
- {
- if (!hasDynamicSize && curGenericField->getTypeSize() != fieldSize)
- {
- BS_EXCEPT(InternalErrorException,
- "Data type mismatch. Type size stored in file and actual type size don't match. ("
- + toString(curGenericField->getTypeSize()) + " vs. " + toString(fieldSize) + ")");
- }
- if (curGenericField->mIsVectorType != isArray)
- {
- BS_EXCEPT(InternalErrorException,
- "Data type mismatch. One is array, other is a single type.");
- }
- if (curGenericField->mType != fieldType)
- {
- BS_EXCEPT(InternalErrorException,
- "Data type mismatch. Field types don't match. " + toString(UINT32(curGenericField->mType)) + " vs. " + toString(UINT32(fieldType)));
- }
- }
- SPtr<SerializedInstance> serializedEntry;
- bool hasModification = false;
- int arrayNumElems = 1;
- if (isArray)
- {
- if ((bytesRead + NUM_ELEM_FIELD_SIZE) > dataLength)
- {
- BS_EXCEPT(InternalErrorException,
- "Error decoding data.");
- }
- memcpy((void*)&arrayNumElems, data, NUM_ELEM_FIELD_SIZE);
- data += NUM_ELEM_FIELD_SIZE;
- bytesRead += NUM_ELEM_FIELD_SIZE;
- SPtr<SerializedArray> serializedArray;
- if (curGenericField != nullptr)
- {
- serializedArray = bs_shared_ptr<SerializedArray>();
- serializedArray->numElements = arrayNumElems;
- serializedEntry = serializedArray;
- hasModification = true;
- }
- switch (fieldType)
- {
- case SerializableFT_ReflectablePtr:
- {
- RTTIReflectablePtrFieldBase* curField = static_cast<RTTIReflectablePtrFieldBase*>(curGenericField);
- for (int i = 0; i < arrayNumElems; i++)
- {
- if ((bytesRead + COMPLEX_TYPE_FIELD_SIZE) > dataLength)
- {
- BS_EXCEPT(InternalErrorException,
- "Error decoding data.");
- }
- int childObjectId = 0;
- memcpy(&childObjectId, data, COMPLEX_TYPE_FIELD_SIZE);
- data += COMPLEX_TYPE_FIELD_SIZE;
- bytesRead += COMPLEX_TYPE_FIELD_SIZE;
- if (curField != nullptr)
- {
- SPtr<SerializedObject> serializedArrayEntry = nullptr;
-
- if (childObjectId > 0)
- {
- auto findObj = mInterimObjectMap.find(childObjectId);
- if (findObj == mInterimObjectMap.end())
- {
- serializedArrayEntry = bs_shared_ptr<SerializedObject>();
- mInterimObjectMap.insert(std::make_pair(childObjectId, serializedArrayEntry));
- }
- else
- serializedArrayEntry = findObj->second;
- }
- SerializedArrayEntry arrayEntry;
- arrayEntry.serialized = serializedArrayEntry;
- arrayEntry.index = i;
- serializedArray->entries[i] = arrayEntry;
- }
- }
- break;
- }
- case SerializableFT_Reflectable:
- {
- RTTIReflectableFieldBase* curField = static_cast<RTTIReflectableFieldBase*>(curGenericField);
- for (int i = 0; i < arrayNumElems; i++)
- {
- if ((bytesRead + COMPLEX_TYPE_FIELD_SIZE) > dataLength)
- {
- BS_EXCEPT(InternalErrorException,
- "Error decoding data.");
- }
- UINT32 complexTypeSize = 0;
- memcpy(&complexTypeSize, data, COMPLEX_TYPE_FIELD_SIZE);
- data += COMPLEX_TYPE_FIELD_SIZE;
- bytesRead += COMPLEX_TYPE_FIELD_SIZE;
- if (curField != nullptr && complexTypeSize > 0)
- {
- UINT32 dummy = 0;
- SPtr<SerializedObject> serializedArrayEntry;
- decodeIntermediateInternal(data, complexTypeSize, dummy, serializedArrayEntry);
- SerializedArrayEntry arrayEntry;
- arrayEntry.serialized = serializedArrayEntry;
- arrayEntry.index = i;
- serializedArray->entries[i] = arrayEntry;
- }
- data += complexTypeSize;
- bytesRead += complexTypeSize;
- }
- break;
- }
- case SerializableFT_Plain:
- {
- RTTIPlainFieldBase* curField = static_cast<RTTIPlainFieldBase*>(curGenericField);
- for (int i = 0; i < arrayNumElems; i++)
- {
- UINT32 typeSize = fieldSize;
- if (hasDynamicSize)
- memcpy(&typeSize, data, sizeof(UINT32));
- if (curField != nullptr)
- {
- SPtr<SerializedField> serializedField = bs_shared_ptr<SerializedField>();
- serializedField->value = data;
- serializedField->size = typeSize;
- SerializedArrayEntry arrayEntry;
- arrayEntry.serialized = serializedField;
- arrayEntry.index = i;
- serializedArray->entries[i] = arrayEntry;
- }
- data += typeSize;
- bytesRead += typeSize;
- }
- break;
- }
- default:
- BS_EXCEPT(InternalErrorException,
- "Error decoding data. Encountered a type I don't know how to decode. Type: " + toString(UINT32(fieldType)) +
- ", Is array: " + toString(isArray));
- }
- }
- else
- {
- switch (fieldType)
- {
- case SerializableFT_ReflectablePtr:
- {
- RTTIReflectablePtrFieldBase* curField = static_cast<RTTIReflectablePtrFieldBase*>(curGenericField);
- if ((bytesRead + COMPLEX_TYPE_FIELD_SIZE) > dataLength)
- {
- BS_EXCEPT(InternalErrorException,
- "Error decoding data.");
- }
- int childObjectId = 0;
- memcpy(&childObjectId, data, COMPLEX_TYPE_FIELD_SIZE);
- data += COMPLEX_TYPE_FIELD_SIZE;
- bytesRead += COMPLEX_TYPE_FIELD_SIZE;
- if (curField != nullptr)
- {
- SPtr<SerializedObject> serializedField = nullptr;
- if (childObjectId > 0)
- {
- auto findObj = mInterimObjectMap.find(childObjectId);
- if (findObj == mInterimObjectMap.end())
- {
- serializedField = bs_shared_ptr<SerializedObject>();
- mInterimObjectMap.insert(std::make_pair(childObjectId, serializedField));
- }
- else
- serializedField = findObj->second;
- }
- serializedEntry = serializedField;
- hasModification = true;
- }
- break;
- }
- case SerializableFT_Reflectable:
- {
- RTTIReflectableFieldBase* curField = static_cast<RTTIReflectableFieldBase*>(curGenericField);
- if ((bytesRead + COMPLEX_TYPE_FIELD_SIZE) > dataLength)
- {
- BS_EXCEPT(InternalErrorException,
- "Error decoding data.");
- }
- UINT32 complexTypeSize = 0;
- memcpy(&complexTypeSize, data, COMPLEX_TYPE_FIELD_SIZE);
- data += COMPLEX_TYPE_FIELD_SIZE;
- bytesRead += COMPLEX_TYPE_FIELD_SIZE;
- if (curField != nullptr && complexTypeSize > 0)
- {
- UINT32 dummy = 0;
- SPtr<SerializedObject> serializedChildObj;
- decodeIntermediateInternal(data, complexTypeSize, dummy, serializedChildObj);
- serializedEntry = serializedChildObj;
- hasModification = true;
- }
- data += complexTypeSize;
- bytesRead += complexTypeSize;
- break;
- }
- case SerializableFT_Plain:
- {
- RTTIPlainFieldBase* curField = static_cast<RTTIPlainFieldBase*>(curGenericField);
- UINT32 typeSize = fieldSize;
- if (hasDynamicSize)
- memcpy(&typeSize, data, sizeof(UINT32));
- if (curField != nullptr)
- {
- SPtr<SerializedField> serializedField = bs_shared_ptr<SerializedField>();
- serializedField->value = data;
- serializedField->size = typeSize;
- serializedEntry = serializedField;
- hasModification = true;
- }
- data += typeSize;
- bytesRead += typeSize;
- break;
- }
- case SerializableFT_DataBlock:
- {
- RTTIManagedDataBlockFieldBase* curField = static_cast<RTTIManagedDataBlockFieldBase*>(curGenericField);
- if ((bytesRead + DATA_BLOCK_TYPE_FIELD_SIZE) > dataLength)
- {
- BS_EXCEPT(InternalErrorException,
- "Error decoding data.");
- }
- // Data block size
- UINT32 dataBlockSize = 0;
- memcpy(&dataBlockSize, data, DATA_BLOCK_TYPE_FIELD_SIZE);
- data += DATA_BLOCK_TYPE_FIELD_SIZE;
- bytesRead += DATA_BLOCK_TYPE_FIELD_SIZE;
- if ((bytesRead + dataBlockSize) > dataLength)
- {
- BS_EXCEPT(InternalErrorException,
- "Error decoding data.");
- }
- // Data block data
- if (curField != nullptr)
- {
- SPtr<SerializedField> serializedField = bs_shared_ptr<SerializedField>();
- serializedField->value = data;
- serializedField->size = dataBlockSize;
- serializedEntry = serializedField;
- hasModification = true;
- }
- data += dataBlockSize;
- bytesRead += dataBlockSize;
- break;
- }
- default:
- BS_EXCEPT(InternalErrorException,
- "Error decoding data. Encountered a type I don't know how to decode. Type: " + toString(UINT32(fieldType)) +
- ", Is array: " + toString(isArray));
- }
- }
- if (hasModification)
- {
- SerializedEntry entry;
- entry.fieldId = curGenericField->mUniqueId;
- entry.serialized = serializedEntry;
- serializedSubObject->entries.insert(std::make_pair(curGenericField->mUniqueId, entry));
- }
- }
- return false;
- }
- void BinarySerializer::decodeInternal(const SPtr<IReflectable>& object, const SPtr<SerializedObject>& serializableObject)
- {
- UINT32 numSubObjects = (UINT32)serializableObject->subObjects.size();
- Vector<RTTITypeBase*> rttiTypes;
- for (UINT32 subObjectIdx = 0; subObjectIdx < numSubObjects; subObjectIdx++)
- {
- const SerializedSubObject& subObject = serializableObject->subObjects[subObjectIdx];
- RTTITypeBase* rtti = IReflectable::_getRTTIfromTypeId(subObject.typeId);
- if (rtti == nullptr)
- continue;
- rtti->onDeserializationStarted(object.get());
- rttiTypes.push_back(rtti);
- UINT32 numFields = rtti->getNumFields();
- for (UINT32 fieldIdx = 0; fieldIdx < numFields; fieldIdx++)
- {
- RTTIField* curGenericField = rtti->getField(fieldIdx);
- auto iterFindFieldData = subObject.entries.find(curGenericField->mUniqueId);
- if (iterFindFieldData == subObject.entries.end())
- continue;
- SPtr<SerializedInstance> entryData = iterFindFieldData->second.serialized;
- if (curGenericField->isArray())
- {
- SPtr<SerializedArray> arrayData = std::static_pointer_cast<SerializedArray>(entryData);
- UINT32 arrayNumElems = (UINT32)arrayData->numElements;
- curGenericField->setArraySize(object.get(), arrayNumElems);
- switch (curGenericField->mType)
- {
- case SerializableFT_ReflectablePtr:
- {
- RTTIReflectablePtrFieldBase* curField = static_cast<RTTIReflectablePtrFieldBase*>(curGenericField);
- for (auto& arrayElem : arrayData->entries)
- {
- SPtr<SerializedObject> arrayElemData = std::static_pointer_cast<SerializedObject>(arrayElem.second.serialized);
- RTTITypeBase* childRtti = nullptr;
-
- if (arrayElemData != nullptr)
- childRtti = IReflectable::_getRTTIfromTypeId(arrayElemData->getRootTypeId());
- if (childRtti != nullptr)
- {
- auto findObj = mObjectMap.find(arrayElemData);
- if (findObj == mObjectMap.end())
- {
- SPtr<IReflectable> newObject = childRtti->newRTTIObject();
- findObj = mObjectMap.insert(std::make_pair(arrayElemData, ObjectToDecode(newObject, arrayElemData))).first;
- }
- ObjectToDecode& objToDecode = findObj->second;
- bool needsDecoding = (curField->getFlags() & RTTI_Flag_WeakRef) == 0 && !objToDecode.isDecoded;
- if (needsDecoding)
- {
- decodeInternal(objToDecode.object, objToDecode.serializedObject);
- objToDecode.isDecoded = true;
- }
- curField->setArrayValue(object.get(), arrayElem.first, objToDecode.object);
- }
- else
- {
- curField->setArrayValue(object.get(), arrayElem.first, nullptr);
- }
- }
- }
- break;
- case SerializableFT_Reflectable:
- {
- RTTIReflectableFieldBase* curField = static_cast<RTTIReflectableFieldBase*>(curGenericField);
- for (auto& arrayElem : arrayData->entries)
- {
- SPtr<SerializedObject> arrayElemData = std::static_pointer_cast<SerializedObject>(arrayElem.second.serialized);
- RTTITypeBase* childRtti = nullptr;
- if (arrayElemData != nullptr)
- childRtti = IReflectable::_getRTTIfromTypeId(arrayElemData->getRootTypeId());
- if (childRtti != nullptr)
- {
- SPtr<IReflectable> newObject = childRtti->newRTTIObject();
- decodeInternal(newObject, arrayElemData);
- curField->setArrayValue(object.get(), arrayElem.first, *newObject);
- }
- }
- break;
- }
- case SerializableFT_Plain:
- {
- RTTIPlainFieldBase* curField = static_cast<RTTIPlainFieldBase*>(curGenericField);
- for (auto& arrayElem : arrayData->entries)
- {
- SPtr<SerializedField> fieldData = std::static_pointer_cast<SerializedField>(arrayElem.second.serialized);
- if (fieldData != nullptr)
- {
- curField->arrayElemFromBuffer(object.get(), arrayElem.first, fieldData->value);
- }
- }
- }
- break;
- }
- }
- else
- {
- switch (curGenericField->mType)
- {
- case SerializableFT_ReflectablePtr:
- {
- RTTIReflectablePtrFieldBase* curField = static_cast<RTTIReflectablePtrFieldBase*>(curGenericField);
- SPtr<SerializedObject> fieldObjectData = std::static_pointer_cast<SerializedObject>(entryData);
- RTTITypeBase* childRtti = nullptr;
- if (fieldObjectData != nullptr)
- childRtti = IReflectable::_getRTTIfromTypeId(fieldObjectData->getRootTypeId());
- if (childRtti != nullptr)
- {
- auto findObj = mObjectMap.find(fieldObjectData);
- if (findObj == mObjectMap.end())
- {
- SPtr<IReflectable> newObject = childRtti->newRTTIObject();
- findObj = mObjectMap.insert(std::make_pair(fieldObjectData, ObjectToDecode(newObject, fieldObjectData))).first;
- }
- ObjectToDecode& objToDecode = findObj->second;
- bool needsDecoding = (curField->getFlags() & RTTI_Flag_WeakRef) == 0 && !objToDecode.isDecoded;
- if (needsDecoding)
- {
- decodeInternal(objToDecode.object, objToDecode.serializedObject);
- objToDecode.isDecoded = true;
- }
- curField->setValue(object.get(), objToDecode.object);
- }
- else
- {
- curField->setValue(object.get(), nullptr);
- }
- }
- break;
- case SerializableFT_Reflectable:
- {
- RTTIReflectableFieldBase* curField = static_cast<RTTIReflectableFieldBase*>(curGenericField);
- SPtr<SerializedObject> fieldObjectData = std::static_pointer_cast<SerializedObject>(entryData);
- RTTITypeBase* childRtti = nullptr;
- if (fieldObjectData != nullptr)
- childRtti = IReflectable::_getRTTIfromTypeId(fieldObjectData->getRootTypeId());
- if (childRtti != nullptr)
- {
- SPtr<IReflectable> newObject = childRtti->newRTTIObject();
- decodeInternal(newObject, fieldObjectData);
- curField->setValue(object.get(), *newObject);
- }
- break;
- }
- case SerializableFT_Plain:
- {
- RTTIPlainFieldBase* curField = static_cast<RTTIPlainFieldBase*>(curGenericField);
- SPtr<SerializedField> fieldData = std::static_pointer_cast<SerializedField>(entryData);
- if (fieldData != nullptr)
- {
- curField->fromBuffer(object.get(), fieldData->value);
- }
- }
- break;
- case SerializableFT_DataBlock:
- {
- RTTIManagedDataBlockFieldBase* curField = static_cast<RTTIManagedDataBlockFieldBase*>(curGenericField);
- SPtr<SerializedField> fieldData = std::static_pointer_cast<SerializedField>(entryData);
- if (fieldData != nullptr)
- {
- UINT8* dataCopy = curField->allocate(object.get(), fieldData->size); // TODO - Low priority. I need to read files better, so I
- memcpy(dataCopy, fieldData->value, fieldData->size); // can just pass the buffer pointer directly without copying (possibly large amounts of data)
- ManagedDataBlock value(dataCopy, fieldData->size); // Not managed because I assume the owner class will decide whether to delete the data or keep it
- curField->setValue(object.get(), value);
- }
- break;
- }
- }
- }
- }
- }
- for (auto iterFind = rttiTypes.rbegin(); iterFind != rttiTypes.rend(); ++iterFind)
- {
- (*iterFind)->onDeserializationEnded(object.get());
- }
- }
- // TODO - This needs serious fixing, it doesn't account for all properties
- UINT32 BinarySerializer::getObjectSize(IReflectable* object)
- {
- if(object == nullptr)
- return 0;
- UINT32 objectSize = 0;
- RTTITypeBase* si = object->getRTTI();
- do
- {
- // Object ID + type data
- objectSize += sizeof(ObjectMetaData);
- int numFields = si->getNumFields();
- for(int i = 0; i < numFields; i++)
- {
- RTTIField* curGenericField = si->getField(i);
- // Field meta data
- objectSize += sizeof(UINT32);
- if(curGenericField->mIsVectorType)
- {
- UINT32 arrayNumElems = curGenericField->getArraySize(object);
- // Num array elems
- objectSize += sizeof(UINT32);
- switch(curGenericField->mType)
- {
- case SerializableFT_ReflectablePtr:
- {
- objectSize += sizeof(UINT32) * arrayNumElems;
- break;
- }
- case SerializableFT_Reflectable:
- {
- RTTIReflectableFieldBase* curField = static_cast<RTTIReflectableFieldBase*>(curGenericField);
- for(UINT32 arrIdx = 0; arrIdx < arrayNumElems; arrIdx++)
- {
- IReflectable& childObject = curField->getArrayValue(object, arrIdx);
- objectSize += sizeof(UINT32); // Complex type size
- objectSize += getObjectSize(&childObject);
- }
- break;
- }
- case SerializableFT_Plain:
- {
- RTTIPlainFieldBase* curField = static_cast<RTTIPlainFieldBase*>(curGenericField);
- for(UINT32 arrIdx = 0; arrIdx < arrayNumElems; arrIdx++)
- {
- UINT32 typeSize = 0;
- if(curField->hasDynamicSize())
- typeSize = curField->getArrayElemDynamicSize(object, arrIdx);
- else
- typeSize = curField->getTypeSize();
- objectSize += typeSize;
- }
- break;
- }
- default:
- BS_EXCEPT(InternalErrorException,
- "Error encoding data. Encountered a type I don't know how to encode. Type: " + toString(UINT32(curGenericField->mType)) +
- ", Is array: " + toString(curGenericField->mIsVectorType));
- }
- }
- else
- {
- switch(curGenericField->mType)
- {
- case SerializableFT_ReflectablePtr:
- {
- objectSize += sizeof(UINT32);
- break;
- }
- case SerializableFT_Reflectable:
- {
- RTTIReflectableFieldBase* curField = static_cast<RTTIReflectableFieldBase*>(curGenericField);
- IReflectable& childObject = curField->getValue(object);
- objectSize += sizeof(UINT32); // Complex type size
- objectSize += getObjectSize(&childObject);
- break;
- }
- case SerializableFT_Plain:
- {
- RTTIPlainFieldBase* curField = static_cast<RTTIPlainFieldBase*>(curGenericField);
- UINT32 typeSize = 0;
- if(curField->hasDynamicSize())
- typeSize = curField->getDynamicSize(object);
- else
- typeSize = curField->getTypeSize();
- objectSize += typeSize;
- break;
- }
- case SerializableFT_DataBlock:
- {
- RTTIManagedDataBlockFieldBase* curField = static_cast<RTTIManagedDataBlockFieldBase*>(curGenericField);
- ManagedDataBlock value = curField->getValue(object);
- // Data block size
- UINT32 dataBlockSize = value.getSize();
- objectSize += sizeof(UINT32) + dataBlockSize;
- break;
- }
- default:
- BS_EXCEPT(InternalErrorException,
- "Error encoding data. Encountered a type I don't know how to encode. Type: " + toString(UINT32(curGenericField->mType)) +
- ", Is array: " + toString(curGenericField->mIsVectorType));
- }
- }
- }
- si = si->getBaseClass();
- } while (si != nullptr);
- return objectSize;
- }
- UINT32 BinarySerializer::encodeFieldMetaData(UINT16 id, UINT8 size, bool array, SerializableFieldType type, bool hasDynamicSize)
- {
- // If O == 0 - Meta contains field information (Encoded using this method)
- //// Encoding: IIII IIII IIII IIII SSSS SSSS xxYP DCAO
- //// I - Id
- //// S - Size
- //// C - Complex
- //// A - Array
- //// D - Data block
- //// P - Complex ptr
- //// O - Object descriptor
- //// Y - Plain field has dynamic size
- return (id << 16 | size << 8 |
- (array ? 0x02 : 0) |
- ((type == SerializableFT_DataBlock) ? 0x04 : 0) |
- ((type == SerializableFT_Reflectable) ? 0x08 : 0) |
- ((type == SerializableFT_ReflectablePtr) ? 0x10 : 0) |
- (hasDynamicSize ? 0x20 : 0)); // TODO - Low priority. Technically I could encode this much more tightly, and use var-ints for ID
- }
- void BinarySerializer::decodeFieldMetaData(UINT32 encodedData, UINT16& id, UINT8& size, bool& array, SerializableFieldType& type, bool& hasDynamicSize)
- {
- if(isObjectMetaData(encodedData))
- {
- BS_EXCEPT(InternalErrorException,
- "Meta data represents an object description but is trying to be decoded as a field descriptor.");
- }
- hasDynamicSize = (encodedData & 0x20) != 0;
- if((encodedData & 0x10) != 0)
- type = SerializableFT_ReflectablePtr;
- else if((encodedData & 0x08) != 0)
- type = SerializableFT_Reflectable;
- else if((encodedData & 0x04) != 0)
- type = SerializableFT_DataBlock;
- else
- type = SerializableFT_Plain;
- array = (encodedData & 0x02) != 0;
- size = (UINT8)((encodedData >> 8) & 0xFF);
- id = (UINT16)((encodedData >> 16) & 0xFFFF);
- }
- BinarySerializer::ObjectMetaData BinarySerializer::encodeObjectMetaData(UINT32 objId, UINT32 objTypeId, bool isBaseClass)
- {
- // If O == 1 - Meta contains object instance information (Encoded using encodeObjectMetaData)
- //// Encoding: SSSS SSSS SSSS SSSS xxxx xxxx xxxx xxBO
- //// S - Size of the object identifier
- //// O - Object descriptor
- //// B - Base class indicator
-
- if(objId > 1073741823)
- {
- BS_EXCEPT(InvalidParametersException, "Object ID is larger than we can store (max 30 bits): " + toString(objId));
- }
- ObjectMetaData metaData;
- metaData.objectMeta = (objId << 2) | (isBaseClass ? 0x02 : 0) | 0x01;
- metaData.typeId = objTypeId;
- return metaData;
- }
- void BinarySerializer::decodeObjectMetaData(BinarySerializer::ObjectMetaData encodedData, UINT32& objId, UINT32& objTypeId, bool& isBaseClass)
- {
- if(!isObjectMetaData(encodedData.objectMeta))
- {
- BS_EXCEPT(InternalErrorException,
- "Meta data represents a field description but is trying to be decoded as an object descriptor.");
- }
- objId = (encodedData.objectMeta >> 2) & 0x3FFFFFFF;
- isBaseClass = (encodedData.objectMeta & 0x02) != 0;
- objTypeId = encodedData.typeId;
- }
- bool BinarySerializer::isObjectMetaData(UINT32 encodedData)
- {
- return ((encodedData & 0x01) != 0);
- }
- UINT8* BinarySerializer::complexTypeToBuffer(IReflectable* object, UINT8* buffer, UINT32& bufferLength,
- UINT32* bytesWritten, std::function<UINT8*(UINT8*, UINT32, UINT32&)> flushBufferCallback, bool shallow)
- {
- int complexTypeSize = 0;
- if(object != nullptr)
- complexTypeSize = getObjectSize(object);
- COPY_TO_BUFFER(&complexTypeSize, COMPLEX_TYPE_FIELD_SIZE)
- if(object != nullptr)
- return encodeInternal(object, 0, buffer, bufferLength, bytesWritten, flushBufferCallback, shallow);
- return buffer;
- }
- UINT8* BinarySerializer::dataBlockToBuffer(UINT8* data, UINT32 size, UINT8* buffer, UINT32& bufferLength, UINT32* bytesWritten,
- std::function<UINT8*(UINT8* buffer, UINT32 bytesWritten, UINT32& newBufferSize)> flushBufferCallback)
- {
- UINT32 remainingSize = size;
- while (remainingSize > 0)
- {
- UINT32 remainingSpaceInBuffer = bufferLength - *bytesWritten;
- if (remainingSize <= remainingSpaceInBuffer)
- {
- COPY_TO_BUFFER(data, remainingSize);
- remainingSize = 0;
- }
- else
- {
- memcpy(buffer, data, remainingSpaceInBuffer);
- buffer += remainingSpaceInBuffer;
- *bytesWritten += remainingSpaceInBuffer;
- data += remainingSpaceInBuffer;
- remainingSize -= remainingSpaceInBuffer;
- mTotalBytesWritten += *bytesWritten;
- buffer = flushBufferCallback(buffer - *bytesWritten, *bytesWritten, bufferLength);
- if (buffer == nullptr || bufferLength == 0)
- return nullptr;
- *bytesWritten = 0;
- }
- }
- return buffer;
- }
- UINT32 BinarySerializer::findOrCreatePersistentId(IReflectable* object)
- {
- void* ptrAddress = (void*)object;
- auto findIter = mObjectAddrToId.find(ptrAddress);
- if(findIter != mObjectAddrToId.end())
- return findIter->second;
- UINT32 objId = mLastUsedObjectId++;
- mObjectAddrToId.insert(std::make_pair(ptrAddress, objId));
- return objId;
- }
- UINT32 BinarySerializer::registerObjectPtr(std::shared_ptr<IReflectable> object)
- {
- if(object == nullptr)
- return 0;
- void* ptrAddress = (void*)object.get();
- auto iterFind = mObjectAddrToId.find(ptrAddress);
- if(iterFind == mObjectAddrToId.end())
- {
- UINT32 objId = findOrCreatePersistentId(object.get());
- mObjectsToEncode.push_back(ObjectToEncode(objId, object));
- mObjectAddrToId.insert(std::make_pair(ptrAddress, objId));
- return objId;
- }
- return iterFind->second;
- }
- }
- #undef COPY_TO_BUFFER
|