cocos2dx 3.6源码分析之文件路径

cocos2dx中资源文件都放在Resources目录中，编译后会自动复制到exe所在的目录中。

核心类是FileUtils类，一个单例类。

三个重要的函数

void addSearchPath(const std::string & path, const bool front=false);
virtual void addSearchResolutionsOrder(const std::string &order,const bool front=false);
virtual std::string fullPathForFilename(const std::string &filename) const;

依次分析。

void FileUtils::addSearchPath(const std::string &searchpath,const bool front)
{
    std::string prefix;
    if (!isAbsolutePath(searchpath))
        prefix = _defaultResRootPath;

    std::string path = prefix + searchpath;
    if (path.length() > 0 && path[path.length()-1] != '/')
    {
        path += "/";
    }
    if (front) {
        _searchPathArray.insert(_searchPathArray.begin(), path);
    } else {
        _searchPathArray.push_back(path);
    }
}

核心数据成员_searchPathArray,首先判断是否是绝对路径，如果不是则通过平台相关的默认资源根路径得到前缀prefix。其次判断给定的字符串后有没有/，没有则加上。

第二个参数font代表搜索优先级，有优先级则插入到_searchPathArray的前端，否则放入后面。vector用Insert感觉还挺奇怪的。

void FileUtils::addSearchResolutionsOrder(const std::string &order,const bool front)
{
    std::string resOrder = order;
    if (!resOrder.empty() && resOrder[resOrder.length()-1] != '/')
        resOrder.append("/");
    
    if (front) {
        _searchResolutionsOrderArray.insert(_searchResolutionsOrderArray.begin(), resOrder);
    } else {
        _searchResolutionsOrderArray.push_back(resOrder);
    }
}

核心数据成员_searchResolutionsOrderArray,这里我理解为子目录，Resolutions这命名用在这里让我十分费解。同样如果传入字符串尾部没有/则加/。如果有优先级顺序则加入都头部，否则尾部。

下面就是重头戏了，查找路径的时候如何拼接目录和子目录为一个字符串。

std::string FileUtils::fullPathForFilename(const std::string &filename) const
{
    if (filename.empty())
    {
        return "";
    }
    
    if (isAbsolutePath(filename))
    {
        return filename;
    }

    // Already Cached ?
    auto cacheIter = _fullPathCache.find(filename);
    if(cacheIter != _fullPathCache.end())
    {
        return cacheIter->second;
    }
    
    // Get the new file name.
    const std::string newFilename( getNewFilename(filename) );
    
    std::string fullpath;
    
    for (const auto& searchIt : _searchPathArray)
    {
        for (const auto& resolutionIt : _searchResolutionsOrderArray)
        {
            fullpath = this->getPathForFilename(newFilename, resolutionIt, searchIt);
            
            if (fullpath.length() > 0)
            {
                // Using the filename passed in as key.
                _fullPathCache.insert(std::make_pair(filename, fullpath));
                return fullpath;
            }
            
        }
    }
    
    if(isPopupNotify()){
        CCLOG("cocos2d: fullPathForFilename: No file found at %s. Possible missing file.", filename.c_str());
    }

    // The file wasn't found, return empty string.
    return "";
}

这段代码思路，就是传入一个文件名，如何在资源路径中找到绝对路径的全名出来。这里就要用到之前的搜索路径和子路径了。

首先判断是否为空和是否为绝对路径，以"/"开头被认为是绝对路径则直接返回。然后再看有没有再文件缓存里面如果有则直接返回。

如果都没有则开始拼接一个新的绝对路径出来。这里就用到了前面添加的2个重要的数据成员_searchPathArray和_searchResolutionsOrderArray。

首先对_searchPathArray进行遍历，在每一个_searchPathArray成员中再对_searchResolutionsOrderArray进行遍历。

然后进入核心拼接函数。

std::string FileUtils::getPathForFilename(const std::string& filename, const std::string& resolutionDirectory, const std::string& searchPath) const
{
    std::string file = filename;
    std::string file_path = "";
    size_t pos = filename.find_last_of("/");
    if (pos != std::string::npos)
    {
        file_path = filename.substr(0, pos+1);
        file = filename.substr(pos+1);
    }
    
    // searchPath + file_path + resourceDirectory
    std::string path = searchPath;
    path += file_path;
    path += resolutionDirectory;
    
    path = getFullPathForDirectoryAndFilename(path, file);
    
    //CCLOG("getPathForFilename, fullPath = %s", path.c_str());
    return path;
}

找到最后一个"/"出现的位置，如果filename字符串中没有"/"，则Path = searchPath + resolutionDirectory,这里path只是文件夹路径，所以searchPath和resolutionDirectory也可以是多级目录路径。

getFullPathForDirectoryAndFilename会把目录路径和文件路径拼接起来。最后得到一个完整的path。