ResourceResolver.h

Go to the documentation of this file.

#pragma once
#include "DLLInfo.h"
#include <NDEVR/SoftwareService.h>
#include <NDEVR/Buffer.h>
#include <NDEVR/String.h>
namespace NDEVR
{
    /**--------------------------------------------------------------------------------------------------
    \brief This class resolves resources data identified by a string. The data absolute path is then passed
        on to an on_finished function. 
        
    Resources may be online, in a packed file, or in a spot not easily accessable. static Class stores any 
        number of resolvers who take in a resource, and try to find it.
 
    Author: Tyler Parke
 
    Date: 2024-11-15
    **/
    class NDEVR_BASE_API ResourceResolver : public SoftwareServiceManager, public SoftwareService
    {
    public:
        /**--------------------------------------------------------------------------------------------------
        \brief Attempts to resolved a resource. Resource could be in an online or offline database, inside a resource
            or rcc file, or in a local file. Funciton is ascynchronous and resource may not be resolved on return.
            on_finished is used as a callback for when the resource is resolved, or fails to resolve
 
        Parameters:
        \param[in] resource -  The resource to be resolved.
        \param[in] on_finished - The callback which will be called, likely asyncronously, when the resource is resolved.
                    The first parameter is a bool representing success, the second is a string with the absolute
                    resource location.
        \param[in] ensure_unzipped - If true, the resource will be unzipped and placed in a path where it can be instantly
                    accessed. If true, the second parameter will be a file path.
 
        \return true if the resource MAY be resolved, false if it will certainly not be resolved.
        Date: 2024-11-15
        **/
        static bool ResolveResource(const String& resource, const std::function<void(bool, const String&)>& on_finished = nullptr, bool ensure_unzipped = false);
 
        /**--------------------------------------------------------------------------------------------------
        \brief Same as ResolveResource(xx,xx, true)
 
        \param[in] resource -  The resource to be resolved.
        \param[in] on_finished - The callback which will be called, likely asyncronously, when the resource is resolved.
                    The first parameter is a bool representing success, the second is a string with the absolute
                    resource location.
 
        \return true if the resource MAY be resolved, false if it will certainly not be resolved.
        Date: 2024-11-15
        **/
        static bool CheckAndUnzipResource(const String& resource, const std::function<void(bool, const String&)>& on_finished = nullptr);
        static void AddResolver(ResourceResolver* resolver);
    protected:
        virtual bool resolveResource(const String& resource, const std::function<void(bool, const String&)>& on_finished = nullptr, bool ensure_unzipped = false) = 0;
    protected:
        static Buffer<ResourceResolver*> s_resolvers;
    };
}