CmResources.cpp 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389
  1. #include "CmResources.h"
  2. #include "CmResource.h"
  3. #include "CmException.h"
  4. #include "CmFileSerializer.h"
  5. #include "CmFileSystem.h"
  6. #include "CmUUID.h"
  7. #include "CmPath.h"
  8. #include "CmDebug.h"
  9. #include "CmResourcesRTTI.h"
  10. namespace CamelotEngine
  11. {
  12. bool Resources::ResourceRequestHandler::canHandleRequest(const WorkQueue::Request* req, const WorkQueue* srcQ)
  13. {
  14. return true;
  15. }
  16. WorkQueue::Response* Resources::ResourceRequestHandler::handleRequest(const WorkQueue::Request* req, const WorkQueue* srcQ)
  17. {
  18. ResourceLoadRequestPtr resRequest = boost::any_cast<ResourceLoadRequestPtr>(req->getData());
  19. ResourceLoadResponsePtr resResponse = ResourceLoadResponsePtr(new Resources::ResourceLoadResponse());
  20. resResponse->rawResource = gResources().loadFromDiskAndDeserialize(resRequest->filePath);
  21. return new WorkQueue::Response(req, true, resResponse);
  22. }
  23. bool Resources::ResourceResponseHandler::canHandleResponse(const WorkQueue::Response* res, const WorkQueue* srcQ)
  24. {
  25. return true;
  26. }
  27. void Resources::ResourceResponseHandler::handleResponse(const WorkQueue::Response* res, const WorkQueue* srcQ)
  28. {
  29. ResourceLoadRequestPtr resRequest = boost::any_cast<ResourceLoadRequestPtr>(res->getRequest()->getData());
  30. auto iterFind = gResources().mInProgressResources.find(resRequest->filePath);
  31. gResources().mInProgressResources.erase(iterFind);
  32. if(res->getRequest()->getAborted())
  33. return;
  34. if(res->succeeded())
  35. {
  36. ResourceLoadResponsePtr resResponse = boost::any_cast<ResourceLoadResponsePtr>(res->getData());
  37. resResponse->rawResource->init();
  38. resRequest->resource.resolve(resResponse->rawResource);
  39. if(!gResources().metaExists_UUID(resResponse->rawResource->getUUID()))
  40. {
  41. gDebug().logWarning("Loading a resource that doesn't have meta-data. Creating meta-data automatically. Resource path: " + resRequest->filePath);
  42. gResources().addMetaData(resResponse->rawResource->getUUID(), resRequest->filePath);
  43. }
  44. gResources().mLoadedResources[resRequest->filePath] = resRequest->resource;
  45. }
  46. else
  47. {
  48. gDebug().logWarning("Resource load request failed.");
  49. }
  50. }
  51. Resources::Resources(const String& metaDataFolder)
  52. :mRequestHandler(nullptr), mResponseHandler(nullptr)
  53. {
  54. mMetaDataFolderPath = metaDataFolder;
  55. if(!FileSystem::dirExists(mMetaDataFolderPath))
  56. {
  57. FileSystem::createDir(mMetaDataFolderPath);
  58. }
  59. loadMetaData();
  60. mWorkQueue = WorkQueuePtr(new WorkQueue());
  61. mWorkQueueChannel = mWorkQueue->getChannel("Resources");
  62. mRequestHandler = new ResourceRequestHandler();
  63. mResponseHandler = new ResourceResponseHandler();
  64. mWorkQueue->addRequestHandler(mWorkQueueChannel, mRequestHandler);
  65. mWorkQueue->addResponseHandler(mWorkQueueChannel, mResponseHandler);
  66. // TODO Low priority - I might want to make this more global so other classes can use it
  67. #if CM_THREAD_SUPPORT
  68. mWorkQueue->setWorkerThreadCount(CM_THREAD_HARDWARE_CONCURRENCY);
  69. #endif
  70. mWorkQueue->startup();
  71. }
  72. Resources::~Resources()
  73. {
  74. if(mWorkQueue)
  75. {
  76. if(mRequestHandler != nullptr)
  77. mWorkQueue->removeRequestHandler(mWorkQueueChannel, mRequestHandler);
  78. if(mResponseHandler != nullptr)
  79. mWorkQueue->removeResponseHandler(mWorkQueueChannel, mResponseHandler);
  80. mWorkQueue->shutdown();
  81. }
  82. if(mRequestHandler != nullptr)
  83. delete mRequestHandler;
  84. if(mResponseHandler != nullptr)
  85. delete mResponseHandler;
  86. }
  87. void Resources::update()
  88. {
  89. mWorkQueue->processResponses();
  90. }
  91. BaseResourceRef Resources::load(const String& filePath)
  92. {
  93. return loadInternal(filePath, true);
  94. }
  95. BaseResourceRef Resources::loadAsync(const String& filePath)
  96. {
  97. return loadInternal(filePath, false);
  98. }
  99. BaseResourceRef Resources::loadFromUUID(const String& uuid)
  100. {
  101. if(!metaExists_UUID(uuid))
  102. {
  103. gDebug().logWarning("Cannot load resource. Resource with UUID '" + uuid + "' doesn't exist.");
  104. return nullptr;
  105. }
  106. ResourceMetaDataPtr metaEntry = mResourceMetaData[uuid];
  107. return load(metaEntry->mPath);
  108. }
  109. BaseResourceRef Resources::loadFromUUIDAsync(const String& uuid)
  110. {
  111. if(!metaExists_UUID(uuid))
  112. {
  113. gDebug().logWarning("Cannot load resource. Resource with UUID '" + uuid + "' doesn't exist.");
  114. return nullptr;
  115. }
  116. ResourceMetaDataPtr metaEntry = mResourceMetaData[uuid];
  117. return loadAsync(metaEntry->mPath);
  118. }
  119. BaseResourceRef Resources::loadInternal(const String& filePath, bool synchronous)
  120. {
  121. auto iterFind = mLoadedResources.find(filePath);
  122. if(iterFind != mLoadedResources.end()) // Resource is already loaded
  123. {
  124. return iterFind->second;
  125. }
  126. auto iterFind2 = mInProgressResources.find(filePath);
  127. if(iterFind2 != mInProgressResources.end()) // We're already loading this resource
  128. {
  129. ResourceAsyncOp& asyncOp = iterFind2->second;
  130. if(!synchronous)
  131. return asyncOp.resource;
  132. else
  133. {
  134. // It's already being loaded asynchronously but we want it right away,
  135. // so abort the async operation and load it right away.
  136. mWorkQueue->abortRequest(asyncOp.requestID);
  137. }
  138. }
  139. if(!FileSystem::fileExists(filePath))
  140. {
  141. gDebug().logWarning("Specified file: " + filePath + " doesn't exist.");
  142. return nullptr;
  143. }
  144. // TODO Low priority - Right now I don't allow loading of resources that don't have meta-data, because I need to know resources UUID
  145. // at this point. And I can't do that without having meta-data. Other option is to partially load the resource to read the UUID but due to the
  146. // nature of the serializer it could complicate things. (But possible if this approach proves troublesome)
  147. // The reason I need the UUID is that when resource is loaded Async, the returned ResourceRef needs to have a valid UUID, in case I assign that
  148. // ResourceRef to something and then save that something. If I didn't assign it, the saved ResourceRef would have a blank (i.e. invalid) UUID.
  149. if(!metaExists_Path(filePath))
  150. {
  151. CM_EXCEPT(InternalErrorException, "Cannot load resource that isn't registered in the meta database. Call Resources::create first.");
  152. }
  153. String uuid = getUUIDFromPath(filePath);
  154. BaseResourceRef newResource;
  155. newResource.setUUID(uuid); // UUID needs to be set immediately if the resource gets loaded async
  156. ResourceLoadRequestPtr resRequest = ResourceLoadRequestPtr(new Resources::ResourceLoadRequest());
  157. resRequest->filePath = filePath;
  158. resRequest->resource = newResource;
  159. WorkQueue::RequestID requestId = mWorkQueue->peekNextFreeRequestId();
  160. ResourceAsyncOp newAsyncOp;
  161. newAsyncOp.resource = newResource;
  162. newAsyncOp.requestID = requestId;
  163. mInProgressResources[filePath] = newAsyncOp;
  164. mWorkQueue->addRequest(mWorkQueueChannel, resRequest, 0, synchronous);
  165. return newResource;
  166. }
  167. ResourcePtr Resources::loadFromDiskAndDeserialize(const String& filePath)
  168. {
  169. FileSerializer fs;
  170. std::shared_ptr<IReflectable> loadedData = fs.decode(filePath);
  171. if(loadedData == nullptr)
  172. CM_EXCEPT(InternalErrorException, "Unable to load resource.");
  173. if(!loadedData->isDerivedFrom(Resource::getRTTIStatic()))
  174. CM_EXCEPT(InternalErrorException, "Loaded class doesn't derive from Resource.");
  175. ResourcePtr resource = std::static_pointer_cast<Resource>(loadedData);
  176. return resource;
  177. }
  178. void Resources::create(BaseResourceRef resource, const String& filePath, bool overwrite)
  179. {
  180. assert(resource.get() != nullptr);
  181. if(metaExists_UUID(resource->getUUID()))
  182. CM_EXCEPT(InvalidParametersException, "Specified resource already exists.");
  183. bool fileExists = FileSystem::fileExists(filePath);
  184. const String& existingUUID = getUUIDFromPath(filePath);
  185. bool metaExists = metaExists_UUID(existingUUID);
  186. if(fileExists)
  187. {
  188. if(overwrite)
  189. FileSystem::remove(filePath);
  190. else
  191. CM_EXCEPT(InvalidParametersException, "Another file exists at the specified location.");
  192. }
  193. if(metaExists)
  194. removeMetaData(existingUUID);
  195. addMetaData(resource->getUUID(), filePath);
  196. save(resource);
  197. }
  198. void Resources::save(BaseResourceRef resource)
  199. {
  200. assert(resource.get() != nullptr);
  201. if(!metaExists_UUID(resource->getUUID()))
  202. CM_EXCEPT(InvalidParametersException, "Cannot find resource meta-data. Please call Resources::create before trying to save the resource.");
  203. const String& filePath = getPathFromUUID(resource->getUUID());
  204. FileSerializer fs;
  205. fs.encode(resource.get(), filePath);
  206. }
  207. void Resources::loadMetaData()
  208. {
  209. vector<String>::type allFiles = FileSystem::getFiles(mMetaDataFolderPath);
  210. for(auto iter = allFiles.begin(); iter != allFiles.end(); ++iter)
  211. {
  212. String& path = *iter;
  213. if(Path::hasExtension(path, "resmeta"))
  214. {
  215. FileSerializer fs;
  216. std::shared_ptr<IReflectable> loadedData = fs.decode(path);
  217. ResourceMetaDataPtr metaData = std::static_pointer_cast<ResourceMetaData>(loadedData);
  218. mResourceMetaData[metaData->mUUID] = metaData;
  219. mResourceMetaData_FilePath[metaData->mPath] = metaData;
  220. }
  221. }
  222. }
  223. void Resources::saveMetaData(const ResourceMetaDataPtr metaData)
  224. {
  225. String fullPath = Path::combine(mMetaDataFolderPath, metaData->mUUID + ".resmeta");
  226. FileSerializer fs;
  227. fs.encode(metaData.get(), fullPath);
  228. }
  229. void Resources::removeMetaData(const String& uuid)
  230. {
  231. String fullPath = Path::combine(mMetaDataFolderPath, uuid + ".resmeta");
  232. FileSystem::remove(fullPath);
  233. auto iter = mResourceMetaData.find(uuid);
  234. if(iter != mResourceMetaData.end())
  235. {
  236. mResourceMetaData.erase(iter);
  237. mResourceMetaData_FilePath.erase(iter->second->mPath);
  238. }
  239. else
  240. gDebug().logWarning("Trying to remove meta data that doesn't exist.");
  241. }
  242. void Resources::addMetaData(const String& uuid, const String& filePath)
  243. {
  244. if(metaExists_Path(filePath))
  245. CM_EXCEPT(InvalidParametersException, "Resource with the path '" + filePath + "' already exists.");
  246. if(metaExists_UUID(uuid))
  247. CM_EXCEPT(InternalErrorException, "Resource with the same UUID already exists. UUID: " + uuid);
  248. ResourceMetaDataPtr dbEntry(new ResourceMetaData());
  249. dbEntry->mPath = filePath;
  250. dbEntry->mUUID = uuid;
  251. mResourceMetaData[uuid] = dbEntry;
  252. mResourceMetaData_FilePath[filePath] = dbEntry;
  253. saveMetaData(dbEntry);
  254. }
  255. void Resources::updateMetaData(const String& uuid, const String& newFilePath)
  256. {
  257. if(!metaExists_UUID(uuid))
  258. {
  259. CM_EXCEPT(InvalidParametersException, "Cannot update a resource that doesn't exist. UUID: " + uuid + ". File path: " + newFilePath);
  260. }
  261. ResourceMetaDataPtr dbEntry = mResourceMetaData[uuid];
  262. dbEntry->mPath = newFilePath;
  263. saveMetaData(dbEntry);
  264. }
  265. const String& Resources::getPathFromUUID(const String& uuid) const
  266. {
  267. auto findIter = mResourceMetaData.find(uuid);
  268. if(findIter != mResourceMetaData.end())
  269. return findIter->second->mPath;
  270. else
  271. return StringUtil::BLANK;
  272. }
  273. const String& Resources::getUUIDFromPath(const String& path) const
  274. {
  275. auto findIter = mResourceMetaData_FilePath.find(path);
  276. if(findIter != mResourceMetaData_FilePath.end())
  277. return findIter->second->mUUID;
  278. else
  279. return StringUtil::BLANK;
  280. }
  281. bool Resources::metaExists_UUID(const String& uuid) const
  282. {
  283. auto findIter = mResourceMetaData.find(uuid);
  284. return findIter != mResourceMetaData.end();
  285. }
  286. bool Resources::metaExists_Path(const String& path) const
  287. {
  288. auto findIter = mResourceMetaData_FilePath.find(path);
  289. return findIter != mResourceMetaData_FilePath.end();
  290. }
  291. CM_EXPORT Resources& gResources()
  292. {
  293. return Resources::instance();
  294. }
  295. /************************************************************************/
  296. /* SERIALIZATION */
  297. /************************************************************************/
  298. RTTITypeBase* Resources::ResourceMetaData::getRTTIStatic()
  299. {
  300. return ResourceMetaDataRTTI::instance();
  301. }
  302. RTTITypeBase* Resources::ResourceMetaData::getRTTI() const
  303. {
  304. return Resources::ResourceMetaData::getRTTIStatic();
  305. }
  306. }