BsBinarySerializer.cpp 33 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121
  1. #include "BsBinarySerializer.h"
  2. #include "BsException.h"
  3. #include "BsDebug.h"
  4. #include "BsIReflectable.h"
  5. #include "BsRTTIType.h"
  6. #include "BsRTTIField.h"
  7. #include "BsRTTIPlainField.h"
  8. #include "BsRTTIReflectableField.h"
  9. #include "BsRTTIReflectablePtrField.h"
  10. #include "BsRTTIManagedDataBlockField.h"
  11. #include <unordered_set>
  12. /**
  13. * @brief A macro that represents a block of code that gets used a lot inside
  14. * encodeInternal. It checks if the buffer has enough space, and if it does
  15. * it copies the data from the specified location and increments the needed
  16. * pointers and counters. If there is not enough space the buffer is flushed
  17. * (hopefully to make some space). If there is still not enough space the entire
  18. * encoding process ends.
  19. *
  20. * @param dataPtr Pointer to data which to copy.
  21. * @param size Size of the data to copy
  22. */
  23. #define COPY_TO_BUFFER(dataIter, size) \
  24. if((*bytesWritten + size##) > bufferLength) \
  25. { \
  26. mTotalBytesWritten += *bytesWritten; \
  27. buffer = flushBufferCallback(buffer - *bytesWritten, *bytesWritten, bufferLength); \
  28. if(buffer == nullptr || bufferLength < size##) return nullptr; \
  29. *bytesWritten = 0; \
  30. } \
  31. \
  32. memcpy(buffer, dataIter##, size##); \
  33. buffer += size##; \
  34. *bytesWritten += size##;
  35. namespace BansheeEngine
  36. {
  37. BinarySerializer::BinarySerializer()
  38. :mLastUsedObjectId(1)
  39. {
  40. }
  41. void BinarySerializer::encode(IReflectable* object, UINT8* buffer, UINT32 bufferLength, int* bytesWritten, std::function<UINT8*(UINT8*, int, UINT32&)> flushBufferCallback)
  42. {
  43. mObjectsToEncode.clear();
  44. mObjectAddrToId.clear();
  45. mLastUsedObjectId = 1;
  46. *bytesWritten = 0;
  47. mTotalBytesWritten = 0;
  48. UINT8* bufferStart = buffer;
  49. UINT32 objectId = findOrCreatePersistentId(object);
  50. // Encode primary object and its value types
  51. buffer = encodeInternal(object, objectId, buffer, bufferLength, bytesWritten, flushBufferCallback);
  52. if(buffer == nullptr)
  53. {
  54. BS_EXCEPT(InternalErrorException,
  55. "Destination buffer is null or not large enough.");
  56. }
  57. // Encode pointed to objects and their value types
  58. UnorderedSet<UINT32> serializedObjects;
  59. while(true)
  60. {
  61. auto iter = mObjectsToEncode.begin();
  62. bool foundObjectToProcess = false;
  63. for(iter; iter != mObjectsToEncode.end(); ++iter)
  64. {
  65. auto foundExisting = serializedObjects.find(iter->objectId);
  66. if(foundExisting != serializedObjects.end())
  67. continue; // Already processed
  68. std::shared_ptr<IReflectable> curObject = iter->object;
  69. UINT32 curObjectid = iter->objectId;
  70. serializedObjects.insert(curObjectid);
  71. mObjectsToEncode.erase(iter);
  72. buffer = encodeInternal(curObject.get(), curObjectid, buffer, bufferLength, bytesWritten, flushBufferCallback);
  73. if(buffer == nullptr)
  74. {
  75. BS_EXCEPT(InternalErrorException,
  76. "Destination buffer is null or not large enough.");
  77. }
  78. foundObjectToProcess = true;
  79. break; // Need to start over as mObjectsToSerialize was possibly modified
  80. }
  81. if(!foundObjectToProcess) // We're done
  82. break;
  83. }
  84. // Final flush
  85. if(*bytesWritten > 0)
  86. {
  87. mTotalBytesWritten += *bytesWritten;
  88. buffer = flushBufferCallback(buffer - *bytesWritten, *bytesWritten, bufferLength);
  89. }
  90. *bytesWritten = mTotalBytesWritten;
  91. mObjectsToEncode.clear();
  92. mObjectAddrToId.clear();
  93. }
  94. std::shared_ptr<IReflectable> BinarySerializer::decode(UINT8* data, UINT32 dataLength)
  95. {
  96. mObjectMap.clear();
  97. // Create empty instances of all ptr objects
  98. UINT32 bytesRead = 0;
  99. UINT8* dataIter = nullptr;
  100. std::shared_ptr<IReflectable> rootObject = nullptr;
  101. do
  102. {
  103. dataIter = data + bytesRead;
  104. if(sizeof(UINT32) > dataLength)
  105. {
  106. BS_EXCEPT(InternalErrorException,
  107. "Error decoding data.");
  108. }
  109. ObjectMetaData objectMetaData;
  110. objectMetaData.objectMeta = 0;
  111. objectMetaData.typeId = 0;
  112. memcpy(&objectMetaData, dataIter, sizeof(ObjectMetaData));
  113. UINT32 objectId = 0;
  114. UINT32 objectTypeId = 0;
  115. bool isBaseClass = false;
  116. decodeObjectMetaData(objectMetaData, objectId, objectTypeId, isBaseClass);
  117. if(isBaseClass)
  118. {
  119. BS_EXCEPT(InternalErrorException, "Encountered a base-class object while looking for a new object. " \
  120. "Base class objects are only supposed to be parts of a larger object.");
  121. }
  122. std::shared_ptr<IReflectable> object = IReflectable::createInstanceFromTypeId(objectTypeId);
  123. mObjectMap.insert(std::make_pair(objectId, ObjectToDecode(objectId, object, dataIter, bytesRead)));
  124. if(rootObject == nullptr)
  125. rootObject = object;
  126. } while (decodeInternal(nullptr, dataIter, dataLength, bytesRead));
  127. // Now go through all of the objects and actually decode them
  128. for(auto iter = mObjectMap.begin(); iter != mObjectMap.end(); ++iter)
  129. {
  130. ObjectToDecode& objToDecode = iter->second;
  131. if(objToDecode.isDecoded)
  132. continue;
  133. UINT32 objectBytesRead = objToDecode.locationInFile;
  134. decodeInternal(objToDecode.object, objToDecode.locationInBuffer, dataLength, objectBytesRead);
  135. }
  136. mObjectMap.clear();
  137. return rootObject;
  138. }
  139. UINT8* BinarySerializer::encodeInternal(IReflectable* object, UINT32 objectId, UINT8* buffer, UINT32& bufferLength,
  140. int* bytesWritten, std::function<UINT8*(UINT8*, int, UINT32&)> flushBufferCallback)
  141. {
  142. static const UINT32 META_SIZE = 4; // Meta field size
  143. static const UINT32 NUM_ELEM_FIELD_SIZE = 4; // Size of the field storing number of array elements
  144. static const UINT32 COMPLEX_TYPE_SIZE = 4; // Size of the field storing the size of a child complex type
  145. RTTITypeBase* si = object->getRTTI();
  146. bool isBaseClass = false;
  147. // If an object has base classes, we need to iterate through all of them
  148. do
  149. {
  150. si->onSerializationStarted(object);
  151. // Encode object ID & type
  152. ObjectMetaData objectMetaData = encodeObjectMetaData(objectId, si->getRTTIId(), isBaseClass);
  153. COPY_TO_BUFFER(&objectMetaData, sizeof(ObjectMetaData))
  154. int numFields = si->getNumFields();
  155. for(int i = 0; i < numFields; i++)
  156. {
  157. RTTIField* curGenericField = si->getField(i);
  158. // Copy field ID & other meta-data like field size and type
  159. int metaData = encodeFieldMetaData(curGenericField->mUniqueId, curGenericField->getTypeSize(),
  160. curGenericField->mIsVectorType, curGenericField->mType, curGenericField->hasDynamicSize());
  161. COPY_TO_BUFFER(&metaData, META_SIZE)
  162. if(curGenericField->mIsVectorType)
  163. {
  164. UINT32 arrayNumElems = curGenericField->getArraySize(object);
  165. // Copy num vector elements
  166. COPY_TO_BUFFER(&arrayNumElems, NUM_ELEM_FIELD_SIZE)
  167. switch(curGenericField->mType)
  168. {
  169. case SerializableFT_ReflectablePtr:
  170. {
  171. RTTIReflectablePtrFieldBase* curField = static_cast<RTTIReflectablePtrFieldBase*>(curGenericField);
  172. for(UINT32 arrIdx = 0; arrIdx < arrayNumElems; arrIdx++)
  173. {
  174. std::shared_ptr<IReflectable> childObject = curField->getArrayValue(object, arrIdx);
  175. UINT32 objId = registerObjectPtr(childObject);
  176. COPY_TO_BUFFER(&objId, sizeof(UINT32))
  177. }
  178. break;
  179. }
  180. case SerializableFT_Reflectable:
  181. {
  182. RTTIReflectableFieldBase* curField = static_cast<RTTIReflectableFieldBase*>(curGenericField);
  183. for(UINT32 arrIdx = 0; arrIdx < arrayNumElems; arrIdx++)
  184. {
  185. IReflectable& childObject = curField->getArrayValue(object, arrIdx);
  186. buffer = complexTypeToBuffer(&childObject, buffer, bufferLength, bytesWritten, flushBufferCallback);
  187. if(buffer == nullptr)
  188. {
  189. si->onSerializationEnded(object);
  190. return nullptr;
  191. }
  192. }
  193. break;
  194. }
  195. case SerializableFT_Plain:
  196. {
  197. RTTIPlainFieldBase* curField = static_cast<RTTIPlainFieldBase*>(curGenericField);
  198. for(UINT32 arrIdx = 0; arrIdx < arrayNumElems; arrIdx++)
  199. {
  200. UINT32 typeSize = 0;
  201. if(curField->hasDynamicSize())
  202. typeSize = curField->getArrayElemDynamicSize(object, arrIdx);
  203. else
  204. typeSize = curField->getTypeSize();
  205. if ((*bytesWritten + typeSize) > bufferLength)
  206. {
  207. UINT8* tempBuffer = (UINT8*)stackAlloc(typeSize);
  208. curField->arrayElemToBuffer(object, arrIdx, tempBuffer);
  209. buffer = dataBlockToBuffer(tempBuffer, typeSize, buffer, bufferLength, bytesWritten, flushBufferCallback);
  210. if (buffer == nullptr || bufferLength == 0)
  211. {
  212. stackDeallocLast(tempBuffer);
  213. si->onSerializationEnded(object);
  214. return nullptr;
  215. }
  216. stackDeallocLast(tempBuffer);
  217. }
  218. else
  219. {
  220. curField->arrayElemToBuffer(object, arrIdx, buffer);
  221. buffer += typeSize;
  222. *bytesWritten += typeSize;
  223. }
  224. }
  225. break;
  226. }
  227. default:
  228. BS_EXCEPT(InternalErrorException,
  229. "Error encoding data. Encountered a type I don't know how to encode. Type: " + toString(UINT32(curGenericField->mType)) +
  230. ", Is array: " + toString(curGenericField->mIsVectorType));
  231. }
  232. }
  233. else
  234. {
  235. switch(curGenericField->mType)
  236. {
  237. case SerializableFT_ReflectablePtr:
  238. {
  239. RTTIReflectablePtrFieldBase* curField = static_cast<RTTIReflectablePtrFieldBase*>(curGenericField);
  240. std::shared_ptr<IReflectable> childObject = curField->getValue(object);
  241. UINT32 objId = registerObjectPtr(childObject);
  242. COPY_TO_BUFFER(&objId, sizeof(UINT32))
  243. break;
  244. }
  245. case SerializableFT_Reflectable:
  246. {
  247. RTTIReflectableFieldBase* curField = static_cast<RTTIReflectableFieldBase*>(curGenericField);
  248. IReflectable& childObject = curField->getValue(object);
  249. buffer = complexTypeToBuffer(&childObject, buffer, bufferLength, bytesWritten, flushBufferCallback);
  250. if(buffer == nullptr)
  251. {
  252. si->onSerializationEnded(object);
  253. return nullptr;
  254. }
  255. break;
  256. }
  257. case SerializableFT_Plain:
  258. {
  259. RTTIPlainFieldBase* curField = static_cast<RTTIPlainFieldBase*>(curGenericField);
  260. UINT32 typeSize = 0;
  261. if(curField->hasDynamicSize())
  262. typeSize = curField->getDynamicSize(object);
  263. else
  264. typeSize = curField->getTypeSize();
  265. if ((*bytesWritten + typeSize) > bufferLength)
  266. {
  267. UINT8* tempBuffer = (UINT8*)stackAlloc(typeSize);
  268. curField->toBuffer(object, tempBuffer);
  269. buffer = dataBlockToBuffer(tempBuffer, typeSize, buffer, bufferLength, bytesWritten, flushBufferCallback);
  270. if (buffer == nullptr || bufferLength == 0)
  271. {
  272. stackDeallocLast(tempBuffer);
  273. si->onSerializationEnded(object);
  274. return nullptr;
  275. }
  276. stackDeallocLast(tempBuffer);
  277. }
  278. else
  279. {
  280. curField->toBuffer(object, buffer);
  281. buffer += typeSize;
  282. *bytesWritten += typeSize;
  283. }
  284. break;
  285. }
  286. case SerializableFT_DataBlock:
  287. {
  288. RTTIManagedDataBlockFieldBase* curField = static_cast<RTTIManagedDataBlockFieldBase*>(curGenericField);
  289. ManagedDataBlock value = curField->getValue(object);
  290. // Data block size
  291. UINT32 dataBlockSize = value.getSize();
  292. COPY_TO_BUFFER(&dataBlockSize, sizeof(UINT32))
  293. // Data block data
  294. UINT8* dataToStore = value.getData();
  295. buffer = dataBlockToBuffer(dataToStore, dataBlockSize, buffer, bufferLength, bytesWritten, flushBufferCallback);
  296. if (buffer == nullptr || bufferLength == 0)
  297. {
  298. si->onSerializationEnded(object);
  299. return nullptr;
  300. }
  301. break;
  302. }
  303. default:
  304. BS_EXCEPT(InternalErrorException,
  305. "Error encoding data. Encountered a type I don't know how to encode. Type: " + toString(UINT32(curGenericField->mType)) +
  306. ", Is array: " + toString(curGenericField->mIsVectorType));
  307. }
  308. }
  309. }
  310. si->onSerializationEnded(object);
  311. si = si->getBaseClass();
  312. isBaseClass = true;
  313. } while(si != nullptr); // Repeat until we reach the top of the inheritance hierarchy
  314. return buffer;
  315. }
  316. bool BinarySerializer::decodeInternal(std::shared_ptr<IReflectable> object, UINT8* data, UINT32 dataLength, UINT32& bytesRead)
  317. {
  318. static const int META_SIZE = 4; // Meta field size
  319. static const int NUM_ELEM_FIELD_SIZE = 4; // Size of the field storing number of array elements
  320. static const int COMPLEX_TYPE_FIELD_SIZE = 4; // Size of the field storing the size of a child complex type
  321. static const int DATA_BLOCK_TYPE_FIELD_SIZE = 4;
  322. bool moreObjectsToProcess = false;
  323. RTTITypeBase* si = nullptr;
  324. if(object != nullptr)
  325. {
  326. si = object->getRTTI();
  327. if(si != nullptr)
  328. si->onDeserializationStarted(object.get());
  329. }
  330. if((bytesRead + sizeof(ObjectMetaData)) > dataLength)
  331. {
  332. BS_EXCEPT(InternalErrorException,
  333. "Error decoding data.");
  334. }
  335. ObjectMetaData objectMetaData;
  336. objectMetaData.objectMeta = 0;
  337. objectMetaData.typeId = 0;
  338. memcpy(&objectMetaData, data, sizeof(ObjectMetaData));
  339. data += sizeof(ObjectMetaData);
  340. bytesRead += sizeof(ObjectMetaData);
  341. UINT32 objectId = 0;
  342. UINT32 objectTypeId = 0;
  343. bool objectIsBaseClass = false;
  344. decodeObjectMetaData(objectMetaData, objectId, objectTypeId, objectIsBaseClass);
  345. while(bytesRead < dataLength)
  346. {
  347. int metaData = -1;
  348. if((bytesRead + META_SIZE) > dataLength)
  349. {
  350. BS_EXCEPT(InternalErrorException,
  351. "Error decoding data.");
  352. }
  353. memcpy((void*)&metaData, data, META_SIZE);
  354. if(isObjectMetaData(metaData)) // We've reached a new object
  355. {
  356. if((bytesRead + sizeof(ObjectMetaData)) > dataLength)
  357. {
  358. BS_EXCEPT(InternalErrorException,
  359. "Error decoding data.");
  360. }
  361. ObjectMetaData objMetaData;
  362. objMetaData.objectMeta = 0;
  363. objMetaData.typeId = 0;
  364. memcpy(&objMetaData, data, sizeof(ObjectMetaData));
  365. UINT32 objId = 0;
  366. UINT32 objTypeId = 0;
  367. bool objIsBaseClass = false;
  368. decodeObjectMetaData(objMetaData, objId, objTypeId, objIsBaseClass);
  369. // If it's a base class, get base class RTTI and handle that
  370. if(objIsBaseClass)
  371. {
  372. if(si != nullptr)
  373. si = si->getBaseClass();
  374. // Saved and current base classes don't match, so just skip over all that data
  375. if(si == nullptr || si->getRTTIId() != objTypeId)
  376. {
  377. si = nullptr;
  378. }
  379. if(si != nullptr)
  380. {
  381. si->onDeserializationStarted(object.get());
  382. }
  383. data += sizeof(ObjectMetaData);
  384. bytesRead += sizeof(ObjectMetaData);
  385. continue;
  386. }
  387. else
  388. {
  389. if(objId != 0)
  390. {
  391. moreObjectsToProcess = true; // New object, break out of this method and begin processing it from scratch
  392. goto exit;
  393. }
  394. // Objects with ID == 0 represent complex types serialized by value, but they should only get serialized
  395. // if we encounter a field with one, not by just iterating through the file.
  396. BS_EXCEPT(InternalErrorException, "Object with ID 0 encountered. Cannot proceed with serialization.");
  397. }
  398. }
  399. data += META_SIZE;
  400. bytesRead += META_SIZE;
  401. bool isArray;
  402. SerializableFieldType fieldType;
  403. UINT16 fieldId;
  404. UINT8 fieldSize;
  405. bool hasDynamicSize;
  406. decodeFieldMetaData(metaData, fieldId, fieldSize, isArray, fieldType, hasDynamicSize);
  407. RTTIField* curGenericField = nullptr;
  408. if(si != nullptr)
  409. curGenericField = si->findField(fieldId);
  410. if(curGenericField != nullptr)
  411. {
  412. if(!hasDynamicSize && curGenericField->getTypeSize() != fieldSize)
  413. {
  414. BS_EXCEPT(InternalErrorException,
  415. "Data type mismatch. Type size stored in file and actual type size don't match. ("
  416. + toString(curGenericField->getTypeSize()) + " vs. " + toString(fieldSize) + ")");
  417. }
  418. if(curGenericField->mIsVectorType != isArray)
  419. {
  420. BS_EXCEPT(InternalErrorException,
  421. "Data type mismatch. One is array, other is a single type.");
  422. }
  423. if(curGenericField->mType != fieldType)
  424. {
  425. BS_EXCEPT(InternalErrorException,
  426. "Data type mismatch. Field types don't match. " + toString(UINT32(curGenericField->mType)) + " vs. " + toString(UINT32(fieldType)));
  427. }
  428. }
  429. int arrayNumElems = 1;
  430. if(isArray)
  431. {
  432. if((bytesRead + NUM_ELEM_FIELD_SIZE) > dataLength)
  433. {
  434. BS_EXCEPT(InternalErrorException,
  435. "Error decoding data.");
  436. }
  437. memcpy((void*)&arrayNumElems, data, NUM_ELEM_FIELD_SIZE);
  438. data += NUM_ELEM_FIELD_SIZE;
  439. bytesRead += NUM_ELEM_FIELD_SIZE;
  440. if(curGenericField != nullptr)
  441. curGenericField->setArraySize(object.get(), arrayNumElems);
  442. switch(fieldType)
  443. {
  444. case SerializableFT_ReflectablePtr:
  445. {
  446. RTTIReflectablePtrFieldBase* curField = static_cast<RTTIReflectablePtrFieldBase*>(curGenericField);
  447. for(int i = 0; i < arrayNumElems; i++)
  448. {
  449. if((bytesRead + COMPLEX_TYPE_FIELD_SIZE) > dataLength)
  450. {
  451. BS_EXCEPT(InternalErrorException,
  452. "Error decoding data.");
  453. }
  454. int objectId = 0;
  455. memcpy(&objectId, data, COMPLEX_TYPE_FIELD_SIZE);
  456. data += COMPLEX_TYPE_FIELD_SIZE;
  457. bytesRead += COMPLEX_TYPE_FIELD_SIZE;
  458. if(curField != nullptr)
  459. {
  460. auto findObj = mObjectMap.find(objectId);
  461. if(findObj == mObjectMap.end())
  462. {
  463. if(objectId != 0)
  464. LOGWRN("When deserializing, object ID: " + toString(objectId) + " was found but no such object was contained in the file.");
  465. curField->setArrayValue(object.get(), i, nullptr);
  466. }
  467. else
  468. {
  469. ObjectToDecode& objToDecode = findObj->second;
  470. bool needsDecoding = (curField->getFlags() & RTTI_Flag_WeakRef) == 0 && !objToDecode.isDecoded;
  471. if(needsDecoding)
  472. {
  473. UINT32 objectBytesRead = objToDecode.locationInFile;
  474. decodeInternal(objToDecode.object, objToDecode.locationInBuffer, dataLength, objectBytesRead);
  475. objToDecode.isDecoded = true;
  476. }
  477. curField->setArrayValue(object.get(), i, objToDecode.object);
  478. }
  479. }
  480. }
  481. break;
  482. }
  483. case SerializableFT_Reflectable:
  484. {
  485. RTTIReflectableFieldBase* curField = static_cast<RTTIReflectableFieldBase*>(curGenericField);
  486. for(int i = 0; i < arrayNumElems; i++)
  487. {
  488. if((bytesRead + COMPLEX_TYPE_FIELD_SIZE) > dataLength)
  489. {
  490. BS_EXCEPT(InternalErrorException,
  491. "Error decoding data.");
  492. }
  493. int complexTypeSize = 0;
  494. if(curField != nullptr)
  495. {
  496. std::shared_ptr<IReflectable> complexType = complexTypeFromBuffer(curField, data, &complexTypeSize);
  497. curField->setArrayValue(object.get(), i, *complexType);
  498. }
  499. else
  500. {
  501. memcpy(&complexTypeSize, data, COMPLEX_TYPE_FIELD_SIZE);
  502. complexTypeSize += COMPLEX_TYPE_FIELD_SIZE;
  503. }
  504. data += complexTypeSize;
  505. bytesRead += complexTypeSize;
  506. }
  507. break;
  508. }
  509. case SerializableFT_Plain:
  510. {
  511. RTTIPlainFieldBase* curField = static_cast<RTTIPlainFieldBase*>(curGenericField);
  512. for(int i = 0; i < arrayNumElems; i++)
  513. {
  514. UINT32 typeSize = fieldSize;
  515. if(hasDynamicSize)
  516. memcpy(&typeSize, data, sizeof(UINT32));
  517. if(curField != nullptr)
  518. curField->arrayElemFromBuffer(object.get(), i, data);
  519. data += typeSize;
  520. bytesRead += typeSize;
  521. }
  522. break;
  523. }
  524. default:
  525. BS_EXCEPT(InternalErrorException,
  526. "Error decoding data. Encountered a type I don't know how to decode. Type: " + toString(UINT32(fieldType)) +
  527. ", Is array: " + toString(isArray));
  528. }
  529. }
  530. else
  531. {
  532. switch(fieldType)
  533. {
  534. case SerializableFT_ReflectablePtr:
  535. {
  536. RTTIReflectablePtrFieldBase* curField = static_cast<RTTIReflectablePtrFieldBase*>(curGenericField);
  537. if((bytesRead + COMPLEX_TYPE_FIELD_SIZE) > dataLength)
  538. {
  539. BS_EXCEPT(InternalErrorException,
  540. "Error decoding data.");
  541. }
  542. int objectId = 0;
  543. memcpy(&objectId, data, COMPLEX_TYPE_FIELD_SIZE);
  544. data += COMPLEX_TYPE_FIELD_SIZE;
  545. bytesRead += COMPLEX_TYPE_FIELD_SIZE;
  546. if(curField != nullptr)
  547. {
  548. auto findObj = mObjectMap.find(objectId);
  549. if(findObj == mObjectMap.end())
  550. {
  551. if(objectId != 0)
  552. LOGWRN("When deserializing, object ID: " + toString(objectId) + " was found but no such object was contained in the file.");
  553. curField->setValue(object.get(), nullptr);
  554. }
  555. else
  556. {
  557. ObjectToDecode& objToDecode = findObj->second;
  558. bool needsDecoding = (curField->getFlags() & RTTI_Flag_WeakRef) == 0 && !objToDecode.isDecoded;
  559. if(needsDecoding)
  560. {
  561. UINT32 objectBytesRead = objToDecode.locationInFile;
  562. decodeInternal(objToDecode.object, objToDecode.locationInBuffer, dataLength, objectBytesRead);
  563. objToDecode.isDecoded = true;
  564. }
  565. curField->setValue(object.get(), objToDecode.object);
  566. }
  567. }
  568. break;
  569. }
  570. case SerializableFT_Reflectable:
  571. {
  572. RTTIReflectableFieldBase* curField = static_cast<RTTIReflectableFieldBase*>(curGenericField);
  573. if((bytesRead + COMPLEX_TYPE_FIELD_SIZE) > dataLength)
  574. {
  575. BS_EXCEPT(InternalErrorException,
  576. "Error decoding data.");
  577. }
  578. int complexTypeSize = 0;
  579. if(curField != nullptr)
  580. {
  581. std::shared_ptr<IReflectable> complexType = complexTypeFromBuffer(curField, data, &complexTypeSize);
  582. curField->setValue(object.get(), *complexType);
  583. }
  584. else
  585. {
  586. memcpy(&complexTypeSize, data, COMPLEX_TYPE_FIELD_SIZE);
  587. complexTypeSize += COMPLEX_TYPE_FIELD_SIZE;
  588. }
  589. data += complexTypeSize;
  590. bytesRead += complexTypeSize;
  591. break;
  592. }
  593. case SerializableFT_Plain:
  594. {
  595. RTTIPlainFieldBase* curField = static_cast<RTTIPlainFieldBase*>(curGenericField);
  596. UINT32 typeSize = fieldSize;
  597. if(hasDynamicSize)
  598. memcpy(&typeSize, data, sizeof(UINT32));
  599. if(curField != nullptr)
  600. curField->fromBuffer(object.get(), data);
  601. data += typeSize;
  602. bytesRead += typeSize;
  603. break;
  604. }
  605. case SerializableFT_DataBlock:
  606. {
  607. RTTIManagedDataBlockFieldBase* curField = static_cast<RTTIManagedDataBlockFieldBase*>(curGenericField);
  608. if((bytesRead + DATA_BLOCK_TYPE_FIELD_SIZE) > dataLength)
  609. {
  610. BS_EXCEPT(InternalErrorException,
  611. "Error decoding data.");
  612. }
  613. // Data block size
  614. UINT32 dataBlockSize = 0;
  615. memcpy(&dataBlockSize, data, DATA_BLOCK_TYPE_FIELD_SIZE);
  616. data += DATA_BLOCK_TYPE_FIELD_SIZE;
  617. bytesRead += DATA_BLOCK_TYPE_FIELD_SIZE;
  618. if((bytesRead + dataBlockSize) > dataLength)
  619. {
  620. BS_EXCEPT(InternalErrorException,
  621. "Error decoding data.");
  622. }
  623. // Data block data
  624. if(curField != nullptr)
  625. {
  626. UINT8* dataCopy = curField->allocate(object.get(), dataBlockSize); // TODO - Low priority. I need to read files better, so I
  627. memcpy(dataCopy, data, dataBlockSize); // can just pass the buffer pointer directly without copying (possibly large amounts of data)
  628. ManagedDataBlock value(dataCopy, dataBlockSize); // Not managed because I assume the owner class will decide whether to delete the data or keep it
  629. curField->setValue(object.get(), value);
  630. }
  631. data += dataBlockSize;
  632. bytesRead += dataBlockSize;
  633. break;
  634. }
  635. default:
  636. BS_EXCEPT(InternalErrorException,
  637. "Error decoding data. Encountered a type I don't know how to decode. Type: " + toString(UINT32(fieldType)) +
  638. ", Is array: " + toString(isArray));
  639. }
  640. }
  641. }
  642. moreObjectsToProcess = false;
  643. exit:
  644. // Finish serialization (in reverse order then it was started)
  645. if(object != nullptr)
  646. {
  647. Stack<RTTITypeBase*> typesToProcess;
  648. RTTITypeBase* currentType = object->getRTTI();
  649. while(currentType != nullptr)
  650. {
  651. typesToProcess.push(currentType);
  652. currentType = currentType->getBaseClass();
  653. }
  654. while(!typesToProcess.empty())
  655. {
  656. currentType = typesToProcess.top();
  657. typesToProcess.pop();
  658. currentType->onDeserializationEnded(object.get());
  659. }
  660. }
  661. return moreObjectsToProcess;
  662. }
  663. // TODO - This needs serious fixing, it doesn't account for all properties
  664. UINT32 BinarySerializer::getObjectSize(IReflectable* object)
  665. {
  666. if(object == nullptr)
  667. return 0;
  668. UINT32 objectSize = 0;
  669. RTTITypeBase* si = object->getRTTI();
  670. do
  671. {
  672. // Object ID + type data
  673. objectSize += sizeof(ObjectMetaData);
  674. int numFields = si->getNumFields();
  675. for(int i = 0; i < numFields; i++)
  676. {
  677. RTTIField* curGenericField = si->getField(i);
  678. // Field meta data
  679. objectSize += sizeof(UINT32);
  680. if(curGenericField->mIsVectorType)
  681. {
  682. UINT32 arrayNumElems = curGenericField->getArraySize(object);
  683. // Num array elems
  684. objectSize += sizeof(UINT32);
  685. switch(curGenericField->mType)
  686. {
  687. case SerializableFT_ReflectablePtr:
  688. {
  689. objectSize += sizeof(UINT32) * arrayNumElems;
  690. break;
  691. }
  692. case SerializableFT_Reflectable:
  693. {
  694. RTTIReflectableFieldBase* curField = static_cast<RTTIReflectableFieldBase*>(curGenericField);
  695. for(UINT32 arrIdx = 0; arrIdx < arrayNumElems; arrIdx++)
  696. {
  697. IReflectable& childObject = curField->getArrayValue(object, arrIdx);
  698. objectSize += sizeof(UINT32); // Complex type size
  699. objectSize += getObjectSize(&childObject);
  700. }
  701. break;
  702. }
  703. case SerializableFT_Plain:
  704. {
  705. RTTIPlainFieldBase* curField = static_cast<RTTIPlainFieldBase*>(curGenericField);
  706. for(UINT32 arrIdx = 0; arrIdx < arrayNumElems; arrIdx++)
  707. {
  708. UINT32 typeSize = 0;
  709. if(curField->hasDynamicSize())
  710. typeSize = curField->getArrayElemDynamicSize(object, arrIdx);
  711. else
  712. typeSize = curField->getTypeSize();
  713. objectSize += typeSize;
  714. }
  715. break;
  716. }
  717. default:
  718. BS_EXCEPT(InternalErrorException,
  719. "Error encoding data. Encountered a type I don't know how to encode. Type: " + toString(UINT32(curGenericField->mType)) +
  720. ", Is array: " + toString(curGenericField->mIsVectorType));
  721. }
  722. }
  723. else
  724. {
  725. switch(curGenericField->mType)
  726. {
  727. case SerializableFT_ReflectablePtr:
  728. {
  729. objectSize += sizeof(UINT32);
  730. break;
  731. }
  732. case SerializableFT_Reflectable:
  733. {
  734. RTTIReflectableFieldBase* curField = static_cast<RTTIReflectableFieldBase*>(curGenericField);
  735. IReflectable& childObject = curField->getValue(object);
  736. objectSize += sizeof(UINT32); // Complex type size
  737. objectSize += getObjectSize(&childObject);
  738. break;
  739. }
  740. case SerializableFT_Plain:
  741. {
  742. RTTIPlainFieldBase* curField = static_cast<RTTIPlainFieldBase*>(curGenericField);
  743. UINT32 typeSize = 0;
  744. if(curField->hasDynamicSize())
  745. typeSize = curField->getDynamicSize(object);
  746. else
  747. typeSize = curField->getTypeSize();
  748. objectSize += typeSize;
  749. break;
  750. }
  751. case SerializableFT_DataBlock:
  752. {
  753. RTTIManagedDataBlockFieldBase* curField = static_cast<RTTIManagedDataBlockFieldBase*>(curGenericField);
  754. ManagedDataBlock value = curField->getValue(object);
  755. // Data block size
  756. UINT32 dataBlockSize = value.getSize();
  757. objectSize += sizeof(UINT32) + dataBlockSize;
  758. break;
  759. }
  760. default:
  761. BS_EXCEPT(InternalErrorException,
  762. "Error encoding data. Encountered a type I don't know how to encode. Type: " + toString(UINT32(curGenericField->mType)) +
  763. ", Is array: " + toString(curGenericField->mIsVectorType));
  764. }
  765. }
  766. }
  767. si = si->getBaseClass();
  768. } while (si != nullptr);
  769. return objectSize;
  770. }
  771. UINT32 BinarySerializer::encodeFieldMetaData(UINT16 id, UINT8 size, bool array, SerializableFieldType type, bool hasDynamicSize)
  772. {
  773. // If O == 0 - Meta contains field information (Encoded using this method)
  774. //// Encoding: IIII IIII IIII IIII SSSS SSSS xxYP DCAO
  775. //// I - Id
  776. //// S - Size
  777. //// C - Complex
  778. //// A - Array
  779. //// D - Data block
  780. //// P - Complex ptr
  781. //// O - Object descriptor
  782. //// Y - Plain field has dynamic size
  783. return (id << 16 | size << 8 |
  784. (array ? 0x02 : 0) |
  785. ((type == SerializableFT_DataBlock) ? 0x04 : 0) |
  786. ((type == SerializableFT_Reflectable) ? 0x08 : 0) |
  787. ((type == SerializableFT_ReflectablePtr) ? 0x10 : 0) |
  788. (hasDynamicSize ? 0x20 : 0)); // TODO - Low priority. Technically I could encode this much more tightly, and use var-ints for ID
  789. }
  790. void BinarySerializer::decodeFieldMetaData(UINT32 encodedData, UINT16& id, UINT8& size, bool& array, SerializableFieldType& type, bool& hasDynamicSize)
  791. {
  792. if(isObjectMetaData(encodedData))
  793. {
  794. BS_EXCEPT(InternalErrorException,
  795. "Meta data represents an object description but is trying to be decoded as a field descriptor.");
  796. }
  797. hasDynamicSize = (encodedData & 0x20) != 0;
  798. if((encodedData & 0x10) != 0)
  799. type = SerializableFT_ReflectablePtr;
  800. else if((encodedData & 0x08) != 0)
  801. type = SerializableFT_Reflectable;
  802. else if((encodedData & 0x04) != 0)
  803. type = SerializableFT_DataBlock;
  804. else
  805. type = SerializableFT_Plain;
  806. array = (encodedData & 0x02) != 0;
  807. size = (UINT8)((encodedData >> 8) & 0xFF);
  808. id = (UINT16)((encodedData >> 16) & 0xFFFF);
  809. }
  810. BinarySerializer::ObjectMetaData BinarySerializer::encodeObjectMetaData(UINT32 objId, UINT32 objTypeId, bool isBaseClass)
  811. {
  812. // If O == 1 - Meta contains object instance information (Encoded using encodeObjectMetaData)
  813. //// Encoding: SSSS SSSS SSSS SSSS xxxx xxxx xxxx xxBO
  814. //// S - Size of the object identifier
  815. //// O - Object descriptor
  816. //// B - Base class indicator
  817. if(objId > 1073741823)
  818. {
  819. BS_EXCEPT(InvalidParametersException, "Object ID is larger than we can store (max 30 bits): " + toString(objId));
  820. }
  821. ObjectMetaData metaData;
  822. metaData.objectMeta = (objId << 2) | (isBaseClass ? 0x02 : 0) | 0x01;
  823. metaData.typeId = objTypeId;
  824. return metaData;
  825. }
  826. void BinarySerializer::decodeObjectMetaData(BinarySerializer::ObjectMetaData encodedData, UINT32& objId, UINT32& objTypeId, bool& isBaseClass)
  827. {
  828. if(!isObjectMetaData(encodedData.objectMeta))
  829. {
  830. BS_EXCEPT(InternalErrorException,
  831. "Meta data represents a field description but is trying to be decoded as an object descriptor.");
  832. }
  833. objId = (encodedData.objectMeta >> 2) & 0x3FFFFFFF;
  834. isBaseClass = (encodedData.objectMeta & 0x02) != 0;
  835. objTypeId = encodedData.typeId;
  836. }
  837. bool BinarySerializer::isObjectMetaData(UINT32 encodedData)
  838. {
  839. return ((encodedData & 0x01) != 0);
  840. }
  841. UINT8* BinarySerializer::complexTypeToBuffer(IReflectable* object, UINT8* buffer, UINT32& bufferLength,
  842. int* bytesWritten, std::function<UINT8*(UINT8*, int, UINT32&)> flushBufferCallback)
  843. {
  844. static const UINT32 COMPLEX_TYPE_FIELD_SIZE = 4; // Size of the field storing the size of a child complex type
  845. int complexTypeSize = 0;
  846. if(object != nullptr)
  847. complexTypeSize = getObjectSize(object);
  848. COPY_TO_BUFFER(&complexTypeSize, COMPLEX_TYPE_FIELD_SIZE)
  849. if(object != nullptr)
  850. return encodeInternal(object, 0, buffer, bufferLength, bytesWritten, flushBufferCallback);
  851. return buffer;
  852. }
  853. std::shared_ptr<IReflectable> BinarySerializer::complexTypeFromBuffer(RTTIReflectableFieldBase* field, UINT8* data, int* complexTypeSize)
  854. {
  855. static const int COMPLEX_TYPE_FIELD_SIZE = 4; // Size of the field storing the size of a child complex type
  856. memcpy(complexTypeSize, data, COMPLEX_TYPE_FIELD_SIZE);
  857. data += COMPLEX_TYPE_FIELD_SIZE;
  858. std::shared_ptr<IReflectable> emptyObject = nullptr;
  859. if(*complexTypeSize > 0)
  860. {
  861. emptyObject = field->newObject();
  862. UINT32 dummy = 0;
  863. decodeInternal(emptyObject, data, *complexTypeSize, dummy);
  864. }
  865. *complexTypeSize += COMPLEX_TYPE_FIELD_SIZE;
  866. return emptyObject;
  867. }
  868. UINT8* BinarySerializer::dataBlockToBuffer(UINT8* data, UINT32 size, UINT8* buffer, UINT32& bufferLength, int* bytesWritten,
  869. std::function<UINT8*(UINT8* buffer, int bytesWritten, UINT32& newBufferSize)> flushBufferCallback)
  870. {
  871. UINT32 remainingSize = size;
  872. while (remainingSize > 0)
  873. {
  874. UINT32 remainingSpaceInBuffer = bufferLength - *bytesWritten;
  875. if (remainingSize <= remainingSpaceInBuffer)
  876. {
  877. COPY_TO_BUFFER(data, remainingSize);
  878. remainingSize = 0;
  879. }
  880. else
  881. {
  882. memcpy(buffer, data, remainingSpaceInBuffer);
  883. buffer += remainingSpaceInBuffer;
  884. *bytesWritten += remainingSpaceInBuffer;
  885. data += remainingSpaceInBuffer;
  886. remainingSize -= remainingSpaceInBuffer;
  887. mTotalBytesWritten += *bytesWritten;
  888. buffer = flushBufferCallback(buffer - *bytesWritten, *bytesWritten, bufferLength);
  889. if (buffer == nullptr || bufferLength == 0)
  890. return nullptr;
  891. *bytesWritten = 0;
  892. }
  893. }
  894. return buffer;
  895. }
  896. UINT32 BinarySerializer::findOrCreatePersistentId(IReflectable* object)
  897. {
  898. void* ptrAddress = (void*)object;
  899. auto findIter = mObjectAddrToId.find(ptrAddress);
  900. if(findIter != mObjectAddrToId.end())
  901. return findIter->second;
  902. UINT32 objId = mLastUsedObjectId++;
  903. mObjectAddrToId.insert(std::make_pair(ptrAddress, objId));
  904. return objId;
  905. }
  906. UINT32 BinarySerializer::registerObjectPtr(std::shared_ptr<IReflectable> object)
  907. {
  908. if(object == nullptr)
  909. return 0;
  910. void* ptrAddress = (void*)object.get();
  911. auto iterFind = mObjectAddrToId.find(ptrAddress);
  912. if(iterFind == mObjectAddrToId.end())
  913. {
  914. UINT32 objId = findOrCreatePersistentId(object.get());
  915. mObjectsToEncode.push_back(ObjectToEncode(objId, object));
  916. mObjectAddrToId.insert(std::make_pair(ptrAddress, objId));
  917. return objId;
  918. }
  919. return iterFind->second;
  920. }
  921. }
  922. #undef COPY_TO_BUFFER