CmBinarySerializer.cpp 27 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887
  1. #include "CmBinarySerializer.h"
  2. #include "CmException.h"
  3. #include "CmIReflectable.h"
  4. #include "CmRTTIType.h"
  5. #include "CmRTTIField.h"
  6. #include "CmRTTIPlainField.h"
  7. #include "CmRTTIReflectableField.h"
  8. #include "CmRTTIReflectablePtrField.h"
  9. #include "CmRTTIManagedDataBlockField.h"
  10. #include <unordered_set>
  11. /**
  12. * @brief A macro that represents a block of code that gets used a lot inside
  13. * encodeInternal. It checks if the buffer has enough space, and if it does
  14. * it copies the data from the specified location and increments the needed
  15. * pointers and counters. If there is not enough space the buffer is flushed
  16. * (hopefully to make some space). If there is still not enough space the entire
  17. * encoding process ends.
  18. *
  19. * @param dataPtr Pointer to data which to copy.
  20. * @param size Size of the data to copy
  21. */
  22. #define COPY_TO_BUFFER(dataPtr, size) \
  23. if((*bytesWritten + size##) > bufferLength) \
  24. { \
  25. mTotalBytesWritten += *bytesWritten; \
  26. buffer = flushBufferCallback(buffer - *bytesWritten, *bytesWritten, bufferLength); \
  27. if(buffer == nullptr || bufferLength < size##) return nullptr; \
  28. *bytesWritten = 0; \
  29. } \
  30. \
  31. memcpy(buffer, dataPtr##, size##); \
  32. buffer += size##; \
  33. *bytesWritten += size##;
  34. namespace CamelotEngine
  35. {
  36. BinarySerializer::BinarySerializer()
  37. :mLastUsedObjectId(1)
  38. {
  39. }
  40. void BinarySerializer::encode(IReflectable* object, UINT8* buffer, UINT32 bufferLength, int* bytesWritten, boost::function<UINT8*(UINT8*, int, UINT32&)> flushBufferCallback)
  41. {
  42. mObjectsToEncode.clear();
  43. mObjectAddrToId.clear();
  44. mLastUsedObjectId = 1;
  45. *bytesWritten = 0;
  46. mTotalBytesWritten = 0;
  47. UINT8* bufferStart = buffer;
  48. UINT32 objectId = findOrCreatePersistentId(object);
  49. // Encode primary object and its value types
  50. buffer = encodeInternal(object, objectId, buffer, bufferLength, bytesWritten, flushBufferCallback);
  51. if(buffer == nullptr)
  52. {
  53. CM_EXCEPT(InternalErrorException,
  54. "Destination buffer is null or not large enough.");
  55. }
  56. // Encode pointed to objects and their value types
  57. std::unordered_set<UINT32> serializedObjects;
  58. while(true)
  59. {
  60. auto iter = mObjectsToEncode.begin();
  61. bool foundObjectToProcess = false;
  62. for(iter; iter != mObjectsToEncode.end(); ++iter)
  63. {
  64. auto foundExisting = serializedObjects.find(iter->objectId);
  65. if(foundExisting != serializedObjects.end())
  66. continue; // Already processed
  67. IReflectable* curObject = iter->object;
  68. buffer = encodeInternal(curObject, iter->objectId, buffer, bufferLength, bytesWritten, flushBufferCallback);
  69. if(buffer == nullptr)
  70. {
  71. CM_EXCEPT(InternalErrorException,
  72. "Destination buffer is null or not large enough.");
  73. }
  74. serializedObjects.insert(iter->objectId);
  75. mObjectsToEncode.erase(iter);
  76. foundObjectToProcess = true;
  77. break; // Need to start over as mObjectsToSerialize was possibly modified
  78. }
  79. if(!foundObjectToProcess) // We're done
  80. break;
  81. }
  82. // Final flush
  83. if(*bytesWritten > 0)
  84. {
  85. mTotalBytesWritten += *bytesWritten;
  86. buffer = flushBufferCallback(buffer - *bytesWritten, *bytesWritten, bufferLength);
  87. }
  88. *bytesWritten = mTotalBytesWritten;
  89. }
  90. void BinarySerializer::decode(IReflectable* object, UINT8* data, UINT32 dataLength)
  91. {
  92. mPtrsToResolve.clear();
  93. mDecodedObjects.clear();
  94. // Create initial object + all other objects that are being referenced.
  95. // Use fields to find the type of referenced object.
  96. UINT32 bytesRead = 0;
  97. while(decodeInternal(object, data, dataLength, bytesRead))
  98. {
  99. data += bytesRead;
  100. UINT8* localDataPtr = data;
  101. UINT32 localBytesRead = bytesRead;
  102. if((bytesRead + sizeof(UINT32)) > dataLength)
  103. {
  104. CM_EXCEPT(InternalErrorException,
  105. "Error decoding data.");
  106. }
  107. UINT32 objectMetaData = 0;
  108. memcpy(&objectMetaData, localDataPtr, sizeof(UINT32));
  109. localDataPtr += sizeof(UINT32);
  110. localBytesRead += sizeof(UINT32);
  111. UINT32 objectId = 0;
  112. decodeObjectMetaData(objectMetaData, objectId);
  113. object = nullptr;
  114. if(objectId != 0)
  115. {
  116. auto iterFind = std::find_if(mPtrsToResolve.begin(), mPtrsToResolve.end(), [objectId](PtrToResolve x) { return x.id == objectId; });
  117. if(iterFind != mPtrsToResolve.end())
  118. object = iterFind->field->newObject();
  119. }
  120. }
  121. for(auto iter = mPtrsToResolve.begin(); iter != mPtrsToResolve.end(); ++iter)
  122. {
  123. IReflectable* resolvedObject = nullptr;
  124. PtrToResolve curPtr = *iter;
  125. if(curPtr.id != 0)
  126. {
  127. auto iterFind = mDecodedObjects.find(curPtr.id);
  128. if(iterFind != mDecodedObjects.end())
  129. resolvedObject = iterFind->second;
  130. }
  131. if(curPtr.field->mIsVectorType)
  132. curPtr.field->setArrayValue(curPtr.object, curPtr.arrIdx, resolvedObject);
  133. else
  134. curPtr.field->setValue(curPtr.object, resolvedObject);
  135. }
  136. }
  137. UINT8* BinarySerializer::encodeInternal(IReflectable* object, UINT32 objectId, UINT8* buffer, UINT32& bufferLength, int* bytesWritten, boost::function<UINT8*(UINT8*, int, UINT32&)> flushBufferCallback)
  138. {
  139. static const UINT32 META_SIZE = 4; // Meta field size
  140. static const UINT32 NUM_ELEM_FIELD_SIZE = 4; // Size of the field storing number of array elements
  141. static const UINT32 COMPLEX_TYPE_SIZE = 4; // Size of the field storing the size of a child complex type
  142. RTTITypeBase* si = object->getRTTI();
  143. // Encode object ID if it has one
  144. UINT32 objectMetaData = encodeObjectMetaData(objectId);
  145. COPY_TO_BUFFER(&objectMetaData, sizeof(UINT32))
  146. int numFields = si->getNumFields();
  147. for(int i = 0; i < numFields; i++)
  148. {
  149. RTTIField* curGenericField = si->getField(i);
  150. // Copy field ID & other meta-data like field size and type
  151. int metaData = encodeFieldMetaData(curGenericField->mUniqueId, curGenericField->getTypeSize(),
  152. curGenericField->mIsVectorType, curGenericField->mType, curGenericField->hasDynamicSize());
  153. COPY_TO_BUFFER(&metaData, META_SIZE)
  154. if(curGenericField->mIsVectorType)
  155. {
  156. UINT32 arrayNumElems = curGenericField->getArraySize(object);
  157. // Copy num vector elements
  158. COPY_TO_BUFFER(&arrayNumElems, NUM_ELEM_FIELD_SIZE)
  159. switch(curGenericField->mType)
  160. {
  161. case SerializableFT_ReflectablePtr:
  162. {
  163. RTTIReflectablePtrFieldBase* curField = static_cast<RTTIReflectablePtrFieldBase*>(curGenericField);
  164. for(UINT32 arrIdx = 0; arrIdx < arrayNumElems; arrIdx++)
  165. {
  166. IReflectable* childObject = curField->getArrayValue(object, arrIdx);
  167. UINT32 objId = registerObjectPtr(childObject);
  168. COPY_TO_BUFFER(&objId, sizeof(UINT32))
  169. }
  170. break;
  171. }
  172. case SerializableFT_Reflectable:
  173. {
  174. RTTIReflectableFieldBase* curField = static_cast<RTTIReflectableFieldBase*>(curGenericField);
  175. for(UINT32 arrIdx = 0; arrIdx < arrayNumElems; arrIdx++)
  176. {
  177. IReflectable& childObject = curField->getArrayValue(object, arrIdx);
  178. buffer = complexTypeToBuffer(&childObject, buffer, bufferLength, bytesWritten, flushBufferCallback);
  179. if(buffer == nullptr)
  180. return nullptr;
  181. }
  182. break;
  183. }
  184. case SerializableFT_Plain:
  185. {
  186. RTTIPlainFieldBase* curField = static_cast<RTTIPlainFieldBase*>(curGenericField);
  187. for(UINT32 arrIdx = 0; arrIdx < arrayNumElems; arrIdx++)
  188. {
  189. UINT32 typeSize = 0;
  190. if(curField->hasDynamicSize())
  191. typeSize = curField->getArrayElemDynamicSize(object, arrIdx);
  192. else
  193. typeSize = curField->getTypeSize();
  194. if((*bytesWritten + typeSize) > bufferLength)
  195. {
  196. mTotalBytesWritten += *bytesWritten;
  197. buffer = flushBufferCallback(buffer - *bytesWritten, *bytesWritten, bufferLength);
  198. if(buffer == nullptr || bufferLength < typeSize) return nullptr;
  199. *bytesWritten = 0;
  200. }
  201. curField->arrayElemToBuffer(object, arrIdx, buffer);
  202. buffer += typeSize;
  203. *bytesWritten += typeSize;
  204. }
  205. break;
  206. }
  207. default:
  208. CM_EXCEPT(InternalErrorException,
  209. "Error encoding data. Encountered a type I don't know how to encode. Type: " + toString(UINT32(curGenericField->mType)) +
  210. ", Is array: " + toString(curGenericField->mIsVectorType));
  211. }
  212. }
  213. else
  214. {
  215. switch(curGenericField->mType)
  216. {
  217. case SerializableFT_ReflectablePtr:
  218. {
  219. RTTIReflectablePtrFieldBase* curField = static_cast<RTTIReflectablePtrFieldBase*>(curGenericField);
  220. IReflectable* childObject = curField->getValue(object);
  221. UINT32 objId = registerObjectPtr(childObject);
  222. COPY_TO_BUFFER(&objId, sizeof(UINT32))
  223. break;
  224. }
  225. case SerializableFT_Reflectable:
  226. {
  227. RTTIReflectableFieldBase* curField = static_cast<RTTIReflectableFieldBase*>(curGenericField);
  228. IReflectable& childObject = curField->getValue(object);
  229. buffer = complexTypeToBuffer(&childObject, buffer, bufferLength, bytesWritten, flushBufferCallback);
  230. if(buffer == nullptr)
  231. return nullptr;
  232. break;
  233. }
  234. case SerializableFT_Plain:
  235. {
  236. RTTIPlainFieldBase* curField = static_cast<RTTIPlainFieldBase*>(curGenericField);
  237. UINT32 typeSize = 0;
  238. if(curField->hasDynamicSize())
  239. typeSize = curField->getDynamicSize(object);
  240. else
  241. typeSize = curField->getTypeSize();
  242. if((*bytesWritten + typeSize) > bufferLength)
  243. {
  244. mTotalBytesWritten += *bytesWritten;
  245. buffer = flushBufferCallback(buffer - *bytesWritten, *bytesWritten, bufferLength);
  246. if(buffer == nullptr || bufferLength < typeSize) return nullptr;
  247. *bytesWritten = 0;
  248. }
  249. curField->toBuffer(object, buffer);
  250. buffer += typeSize;
  251. *bytesWritten += typeSize;
  252. break;
  253. }
  254. case SerializableFT_DataBlock:
  255. {
  256. RTTIManagedDataBlockFieldBase* curField = static_cast<RTTIManagedDataBlockFieldBase*>(curGenericField);
  257. ManagedDataBlock value = curField->getValue(object);
  258. // Data block size
  259. UINT32 dataBlockSize = value.getSize();
  260. COPY_TO_BUFFER(&dataBlockSize, sizeof(UINT32))
  261. // Data block data
  262. UINT8* dataToStore = value.getData();
  263. UINT32 remainingSize = dataBlockSize;
  264. while(remainingSize > 0)
  265. {
  266. UINT32 remainingSpaceInBuffer = bufferLength - *bytesWritten;
  267. if(remainingSize <= remainingSpaceInBuffer)
  268. {
  269. COPY_TO_BUFFER(dataToStore, remainingSize);
  270. remainingSize = 0;
  271. }
  272. else
  273. {
  274. memcpy(buffer, dataToStore, remainingSpaceInBuffer);
  275. buffer += remainingSpaceInBuffer;
  276. *bytesWritten += remainingSpaceInBuffer;
  277. dataToStore += remainingSpaceInBuffer;
  278. remainingSize -= remainingSpaceInBuffer;
  279. mTotalBytesWritten += *bytesWritten;
  280. buffer = flushBufferCallback(buffer - *bytesWritten, *bytesWritten, bufferLength);
  281. if(buffer == nullptr || bufferLength == 0) return nullptr;
  282. *bytesWritten = 0;
  283. }
  284. }
  285. break;
  286. }
  287. default:
  288. CM_EXCEPT(InternalErrorException,
  289. "Error encoding data. Encountered a type I don't know how to encode. Type: " + toString(UINT32(curGenericField->mType)) +
  290. ", Is array: " + toString(curGenericField->mIsVectorType));
  291. }
  292. }
  293. }
  294. return buffer;
  295. }
  296. bool BinarySerializer::decodeInternal(IReflectable* object, UINT8* data, UINT32 dataLength, UINT32& bytesRead)
  297. {
  298. static const int META_SIZE = 4; // Meta field size
  299. static const int NUM_ELEM_FIELD_SIZE = 4; // Size of the field storing number of array elements
  300. static const int COMPLEX_TYPE_FIELD_SIZE = 4; // Size of the field storing the size of a child complex type
  301. static const int DATA_BLOCK_TYPE_FIELD_SIZE = 4;
  302. RTTITypeBase* si = nullptr;
  303. if(object != nullptr)
  304. si = object->getRTTI();
  305. if((bytesRead + sizeof(UINT32)) > dataLength)
  306. {
  307. CM_EXCEPT(InternalErrorException,
  308. "Error decoding data.");
  309. }
  310. UINT32 objectMetaData = 0;
  311. memcpy(&objectMetaData, data, sizeof(UINT32));
  312. data += sizeof(UINT32);
  313. bytesRead += sizeof(UINT32);
  314. UINT32 objectId = 0;
  315. decodeObjectMetaData(objectMetaData, objectId);
  316. if(object != nullptr && objectId != 0)
  317. mDecodedObjects.insert(std::make_pair(objectId, object));
  318. while(bytesRead < dataLength)
  319. {
  320. int metaData = -1;
  321. if((bytesRead + META_SIZE) > dataLength)
  322. {
  323. CM_EXCEPT(InternalErrorException,
  324. "Error decoding data.");
  325. }
  326. memcpy((void*)&metaData, data, META_SIZE);
  327. if(isObjectMetaData(metaData)) // We've reached a new object
  328. {
  329. UINT32 objId = 0;
  330. decodeObjectMetaData(metaData, objId);
  331. if(objId != 0) // Objects with 0 ID represent complex types serialized by value, in which case we just decode them on the spot
  332. return true;
  333. }
  334. data += META_SIZE;
  335. bytesRead += META_SIZE;
  336. bool isArray;
  337. SerializableFieldType fieldType;
  338. UINT16 fieldId;
  339. UINT8 fieldSize;
  340. bool hasDynamicSize;
  341. decodeFieldMetaData(metaData, fieldId, fieldSize, isArray, fieldType, hasDynamicSize);
  342. RTTIField* curGenericField = nullptr;
  343. if(si != nullptr)
  344. curGenericField = si->findField(fieldId);
  345. if(curGenericField != nullptr)
  346. {
  347. if(curGenericField->getTypeSize() != fieldSize)
  348. {
  349. CM_EXCEPT(InternalErrorException,
  350. "Data type mismatch. Type size stored in file and actual type size don't match. ("
  351. + toString(curGenericField->getTypeSize()) + " vs. " + toString(fieldSize) + ")");
  352. }
  353. if(curGenericField->mIsVectorType != isArray)
  354. {
  355. CM_EXCEPT(InternalErrorException,
  356. "Data type mismatch. One is array, other is a single type.");
  357. }
  358. if(curGenericField->mType != fieldType)
  359. {
  360. CM_EXCEPT(InternalErrorException,
  361. "Data type mismatch. Field types don't match. " + toString(UINT32(curGenericField->mType)) + " vs. " + toString(UINT32(fieldType)));
  362. }
  363. }
  364. int arrayNumElems = 1;
  365. if(isArray)
  366. {
  367. if((bytesRead + NUM_ELEM_FIELD_SIZE) > dataLength)
  368. {
  369. CM_EXCEPT(InternalErrorException,
  370. "Error decoding data.");
  371. }
  372. memcpy((void*)&arrayNumElems, data, NUM_ELEM_FIELD_SIZE);
  373. data += NUM_ELEM_FIELD_SIZE;
  374. bytesRead += NUM_ELEM_FIELD_SIZE;
  375. if(curGenericField != nullptr)
  376. curGenericField->setArraySize(object, arrayNumElems);
  377. switch(fieldType)
  378. {
  379. case SerializableFT_ReflectablePtr:
  380. {
  381. RTTIReflectablePtrFieldBase* curField = static_cast<RTTIReflectablePtrFieldBase*>(curGenericField);
  382. for(int i = 0; i < arrayNumElems; i++)
  383. {
  384. if((bytesRead + COMPLEX_TYPE_FIELD_SIZE) > dataLength)
  385. {
  386. CM_EXCEPT(InternalErrorException,
  387. "Error decoding data.");
  388. }
  389. int objectId = 0;
  390. memcpy(&objectId, data, COMPLEX_TYPE_FIELD_SIZE);
  391. data += COMPLEX_TYPE_FIELD_SIZE;
  392. bytesRead += COMPLEX_TYPE_FIELD_SIZE;
  393. if(curField != nullptr)
  394. mPtrsToResolve.push_back(PtrToResolve(curField, object, objectId, i));
  395. }
  396. break;
  397. }
  398. case SerializableFT_Reflectable:
  399. {
  400. RTTIReflectableFieldBase* curField = static_cast<RTTIReflectableFieldBase*>(curGenericField);
  401. for(int i = 0; i < arrayNumElems; i++)
  402. {
  403. if((bytesRead + COMPLEX_TYPE_FIELD_SIZE) > dataLength)
  404. {
  405. CM_EXCEPT(InternalErrorException,
  406. "Error decoding data.");
  407. }
  408. int complexTypeSize = COMPLEX_TYPE_FIELD_SIZE;
  409. if(curField != nullptr)
  410. {
  411. IReflectable* complexType = complexTypeFromBuffer(curField, data, &complexTypeSize);
  412. curField->setArrayValue(object, i, *complexType);
  413. delete complexType;
  414. }
  415. data += complexTypeSize;
  416. bytesRead += complexTypeSize;
  417. }
  418. break;
  419. }
  420. case SerializableFT_Plain:
  421. {
  422. RTTIPlainFieldBase* curField = static_cast<RTTIPlainFieldBase*>(curGenericField);
  423. for(int i = 0; i < arrayNumElems; i++)
  424. {
  425. UINT32 typeSize = fieldSize;
  426. if(hasDynamicSize)
  427. memcpy(&typeSize, data, sizeof(UINT32));
  428. if(curField != nullptr)
  429. curField->arrayElemFromBuffer(object, i, data);
  430. data += typeSize;
  431. bytesRead += typeSize;
  432. }
  433. break;
  434. }
  435. default:
  436. CM_EXCEPT(InternalErrorException,
  437. "Error decoding data. Encountered a type I don't know how to decode. Type: " + toString(UINT32(fieldType)) +
  438. ", Is array: " + toString(isArray));
  439. }
  440. }
  441. else
  442. {
  443. switch(fieldType)
  444. {
  445. case SerializableFT_ReflectablePtr:
  446. {
  447. RTTIReflectablePtrFieldBase* curField = static_cast<RTTIReflectablePtrFieldBase*>(curGenericField);
  448. if((bytesRead + COMPLEX_TYPE_FIELD_SIZE) > dataLength)
  449. {
  450. CM_EXCEPT(InternalErrorException,
  451. "Error decoding data.");
  452. }
  453. int objectId = 0;
  454. memcpy(&objectId, data, COMPLEX_TYPE_FIELD_SIZE);
  455. data += COMPLEX_TYPE_FIELD_SIZE;
  456. bytesRead += COMPLEX_TYPE_FIELD_SIZE;
  457. if(curField != nullptr)
  458. mPtrsToResolve.push_back(PtrToResolve(curField, object, objectId));
  459. break;
  460. }
  461. case SerializableFT_Reflectable:
  462. {
  463. RTTIReflectableFieldBase* curField = static_cast<RTTIReflectableFieldBase*>(curGenericField);
  464. if((bytesRead + COMPLEX_TYPE_FIELD_SIZE) > dataLength)
  465. {
  466. CM_EXCEPT(InternalErrorException,
  467. "Error decoding data.");
  468. }
  469. int complexTypeSize = COMPLEX_TYPE_FIELD_SIZE;
  470. if(curField != nullptr)
  471. {
  472. IReflectable* complexType = complexTypeFromBuffer(curField, data, &complexTypeSize);
  473. curField->setValue(object, *complexType);
  474. delete complexType;
  475. }
  476. data += complexTypeSize;
  477. bytesRead += complexTypeSize;
  478. break;
  479. }
  480. case SerializableFT_Plain:
  481. {
  482. RTTIPlainFieldBase* curField = static_cast<RTTIPlainFieldBase*>(curGenericField);
  483. UINT32 typeSize = fieldSize;
  484. if(hasDynamicSize)
  485. memcpy(&typeSize, data, sizeof(UINT32));
  486. if(curField != nullptr)
  487. curField->fromBuffer(object, data);
  488. data += typeSize;
  489. bytesRead += typeSize;
  490. break;
  491. }
  492. case SerializableFT_DataBlock:
  493. {
  494. RTTIManagedDataBlockFieldBase* curField = static_cast<RTTIManagedDataBlockFieldBase*>(curGenericField);
  495. if((bytesRead + DATA_BLOCK_TYPE_FIELD_SIZE) > dataLength)
  496. {
  497. CM_EXCEPT(InternalErrorException,
  498. "Error decoding data.");
  499. }
  500. // Data block size
  501. UINT32 dataBlockSize = 0;
  502. memcpy(&dataBlockSize, data, DATA_BLOCK_TYPE_FIELD_SIZE);
  503. data += DATA_BLOCK_TYPE_FIELD_SIZE;
  504. bytesRead += DATA_BLOCK_TYPE_FIELD_SIZE;
  505. if((bytesRead + dataBlockSize) > dataLength)
  506. {
  507. CM_EXCEPT(InternalErrorException,
  508. "Error decoding data.");
  509. }
  510. // Data block data
  511. if(curField != nullptr)
  512. {
  513. UINT8* dataCopy = new UINT8[dataBlockSize]; // TODO - Low priority. I need to read files better, so I
  514. memcpy(dataCopy, data, dataBlockSize); // can just pass the buffer pointer directly without copying (possibly large amounts of data)
  515. ManagedDataBlock value(dataCopy, dataBlockSize, false); // Not managed because I assume the owner class will decide whether to delete the data or keep it
  516. curField->setValue(object, value);
  517. }
  518. data += dataBlockSize;
  519. bytesRead += dataBlockSize;
  520. break;
  521. }
  522. default:
  523. CM_EXCEPT(InternalErrorException,
  524. "Error decoding data. Encountered a type I don't know how to decode. Type: " + toString(UINT32(fieldType)) +
  525. ", Is array: " + toString(isArray));
  526. }
  527. }
  528. }
  529. return false;
  530. }
  531. UINT32 BinarySerializer::getObjectSize(IReflectable* object)
  532. {
  533. if(object == nullptr)
  534. return 0;
  535. UINT32 objectSize = 0;
  536. RTTITypeBase* si = object->getRTTI();
  537. // Object ID
  538. objectSize += sizeof(UINT32);
  539. int numFields = si->getNumFields();
  540. for(int i = 0; i < numFields; i++)
  541. {
  542. RTTIField* curGenericField = si->getField(i);
  543. // Field meta data
  544. objectSize += sizeof(UINT32);
  545. if(curGenericField->mIsVectorType)
  546. {
  547. UINT32 arrayNumElems = curGenericField->getArraySize(object);
  548. // Num array elems
  549. objectSize += sizeof(UINT32);
  550. switch(curGenericField->mType)
  551. {
  552. case SerializableFT_ReflectablePtr:
  553. {
  554. objectSize += sizeof(UINT32) * arrayNumElems;
  555. break;
  556. }
  557. case SerializableFT_Reflectable:
  558. {
  559. RTTIReflectableFieldBase* curField = static_cast<RTTIReflectableFieldBase*>(curGenericField);
  560. for(UINT32 arrIdx = 0; arrIdx < arrayNumElems; arrIdx++)
  561. {
  562. IReflectable& childObject = curField->getArrayValue(object, arrIdx);
  563. objectSize += getObjectSize(&childObject);
  564. }
  565. break;
  566. }
  567. case SerializableFT_Plain:
  568. {
  569. RTTIPlainFieldBase* curField = static_cast<RTTIPlainFieldBase*>(curGenericField);
  570. objectSize += arrayNumElems * curField->getTypeSize();
  571. break;
  572. }
  573. default:
  574. CM_EXCEPT(InternalErrorException,
  575. "Error encoding data. Encountered a type I don't know how to encode. Type: " + toString(UINT32(curGenericField->mType)) +
  576. ", Is array: " + toString(curGenericField->mIsVectorType));
  577. }
  578. }
  579. else
  580. {
  581. switch(curGenericField->mType)
  582. {
  583. case SerializableFT_ReflectablePtr:
  584. {
  585. objectSize += sizeof(UINT32);
  586. break;
  587. }
  588. case SerializableFT_Reflectable:
  589. {
  590. RTTIReflectableFieldBase* curField = static_cast<RTTIReflectableFieldBase*>(curGenericField);
  591. IReflectable& childObject = curField->getValue(object);
  592. objectSize += getObjectSize(&childObject);
  593. break;
  594. }
  595. case SerializableFT_Plain:
  596. {
  597. RTTIPlainFieldBase* curField = static_cast<RTTIPlainFieldBase*>(curGenericField);
  598. objectSize += curField->getTypeSize();
  599. break;
  600. }
  601. case SerializableFT_DataBlock:
  602. {
  603. RTTIManagedDataBlockFieldBase* curField = static_cast<RTTIManagedDataBlockFieldBase*>(curGenericField);
  604. ManagedDataBlock value = curField->getValue(object);
  605. // Data block size
  606. UINT32 dataBlockSize = value.getSize();
  607. objectSize += sizeof(UINT32) + dataBlockSize;
  608. break;
  609. }
  610. default:
  611. CM_EXCEPT(InternalErrorException,
  612. "Error encoding data. Encountered a type I don't know how to encode. Type: " + toString(UINT32(curGenericField->mType)) +
  613. ", Is array: " + toString(curGenericField->mIsVectorType));
  614. }
  615. }
  616. }
  617. return objectSize;
  618. }
  619. UINT32 BinarySerializer::encodeFieldMetaData(UINT16 id, UINT8 size, bool array, SerializableFieldType type, bool hasDynamicSize)
  620. {
  621. // If O == 0 - Meta contains field information (Encoded using this method)
  622. //// Encoding: IIII IIII IIII IIII SSSS SSSS xxYP DCAO
  623. //// I - Id
  624. //// S - Size
  625. //// C - Complex
  626. //// A - Array
  627. //// D - Data block
  628. //// P - Complex ptr
  629. //// O - Object descriptor
  630. //// Y - Simple field has dynamic size
  631. return (id << 16 | size << 8 |
  632. (array ? 0x02 : 0) |
  633. ((type == SerializableFT_DataBlock) ? 0x04 : 0) |
  634. ((type == SerializableFT_Reflectable) ? 0x08 : 0) |
  635. ((type == SerializableFT_ReflectablePtr) ? 0x10 : 0) |
  636. (hasDynamicSize ? 0x20 : 0)); // TODO - Low priority. Technically I could encode this much more tightly, and use var-ints for ID
  637. }
  638. void BinarySerializer::decodeFieldMetaData(UINT32 encodedData, UINT16& id, UINT8& size, bool& array, SerializableFieldType& type, bool& hasDynamicSize)
  639. {
  640. if(isObjectMetaData(encodedData))
  641. {
  642. CM_EXCEPT(InternalErrorException,
  643. "Meta data represents an object description but is trying to be decoded as a field descriptor.");
  644. }
  645. hasDynamicSize = (encodedData & 0x20) != 0;
  646. if((encodedData & 0x10) != 0)
  647. type = SerializableFT_ReflectablePtr;
  648. else if((encodedData & 0x08) != 0)
  649. type = SerializableFT_Reflectable;
  650. else if((encodedData & 0x04) != 0)
  651. type = SerializableFT_DataBlock;
  652. else
  653. type = SerializableFT_Plain;
  654. array = (encodedData & 0x02) != 0;
  655. size = (UINT8)((encodedData >> 8) & 0xFF);
  656. id = (UINT16)((encodedData >> 16) & 0xFFFF);
  657. }
  658. UINT32 BinarySerializer::encodeObjectMetaData(UINT32 objId)
  659. {
  660. // If O == 1 - Meta contains object instance information (Encoded using encodeObjectMetaData)
  661. //// Encoding: SSSS SSSS SSSS SSSS xxxx xxxx xxxx xxxO
  662. //// S - Size of the object identifier
  663. //// O - Object descriptor
  664. return (objId << 1) | 0x01;
  665. }
  666. void BinarySerializer::decodeObjectMetaData(UINT32 encodedData, UINT32& objId)
  667. {
  668. if(!isObjectMetaData(encodedData))
  669. {
  670. CM_EXCEPT(InternalErrorException,
  671. "Meta data represents a field description but is trying to be decoded as an object descriptor.");
  672. }
  673. objId = (encodedData >> 1) & 0x7FFFFFFF;
  674. }
  675. bool BinarySerializer::isObjectMetaData(UINT32 encodedData)
  676. {
  677. return ((encodedData & 0x01) != 0);
  678. }
  679. UINT8* BinarySerializer::complexTypeToBuffer(IReflectable* object, UINT8* buffer, UINT32& bufferLength, int* bytesWritten, boost::function<UINT8*(UINT8*, int, UINT32&)> flushBufferCallback)
  680. {
  681. static const UINT32 COMPLEX_TYPE_FIELD_SIZE = 4; // Size of the field storing the size of a child complex type
  682. int complexTypeSize = 0;
  683. if(object != nullptr)
  684. complexTypeSize = getObjectSize(object);
  685. COPY_TO_BUFFER(&complexTypeSize, COMPLEX_TYPE_FIELD_SIZE)
  686. if(object != nullptr)
  687. return encodeInternal(object, 0, buffer, bufferLength, bytesWritten, flushBufferCallback);
  688. return buffer;
  689. }
  690. IReflectable* BinarySerializer::complexTypeFromBuffer(RTTIReflectableFieldBase* field, UINT8* data, int* complexTypeSize)
  691. {
  692. static const int COMPLEX_TYPE_FIELD_SIZE = 4; // Size of the field storing the size of a child complex type
  693. memcpy(complexTypeSize, data, COMPLEX_TYPE_FIELD_SIZE);
  694. data += COMPLEX_TYPE_FIELD_SIZE;
  695. IReflectable* emptyObject = nullptr;
  696. if(*complexTypeSize > 0)
  697. {
  698. emptyObject = field->newObject();
  699. UINT32 dummy = 0;
  700. decodeInternal(emptyObject, data, *complexTypeSize, dummy);
  701. }
  702. *complexTypeSize += COMPLEX_TYPE_FIELD_SIZE;
  703. return emptyObject;
  704. }
  705. UINT32 BinarySerializer::findOrCreatePersistentId(IReflectable* object)
  706. {
  707. UINT32 ptrAddress = (UINT32)object;
  708. auto findIter = mObjectAddrToId.find(ptrAddress);
  709. if(findIter != mObjectAddrToId.end())
  710. return findIter->second;
  711. UINT32 objId = mLastUsedObjectId++;
  712. mObjectAddrToId.insert(std::make_pair(ptrAddress, objId));
  713. return objId;
  714. }
  715. UINT32 BinarySerializer::registerObjectPtr(IReflectable* object)
  716. {
  717. if(object == nullptr)
  718. return 0;
  719. UINT32 ptrAddress = (UINT32)object;
  720. auto iterFind = mObjectAddrToId.find(ptrAddress);
  721. if(iterFind == mObjectAddrToId.end())
  722. {
  723. UINT32 objId = findOrCreatePersistentId(object);
  724. mObjectsToEncode.push_back(ObjectToEncode(objId, object));
  725. mObjectAddrToId.insert(std::make_pair(ptrAddress, objId));
  726. return objId;
  727. }
  728. return iterFind->second;
  729. }
  730. }
  731. #undef COPY_TO_BUFFER