#ifndef RAGE_UTIL_FILEDB #define RAGE_UTIL_FILEDB #include #include #include "RageTimer.h" #include "RageThreads.h" #include "RageFileManager.h" struct FileSet; struct File { RString name; RString lname; void SetName( const RString &fn ) { name = fn; lname = name; lname.MakeLower(); } bool dir; int size; /* Modification time of the file. The contents of this is undefined, except that * when the file has been modified, this value will change. */ int hash; /* Private data, for RageFileDrivers. */ void *priv; /* If this is non-nullptr, and dir is true, this is a pointer to the FileSet containing * the directory contents. (This is a cache; it isn't always set.) */ const FileSet *dirp; File() { dir=false; dirp=nullptr; size=-1; hash=-1; priv=nullptr;} File( const RString &fn ) { SetName( fn ); dir=false; size=-1; hash=-1; priv=nullptr; dirp=nullptr; } bool operator< (const File &rhs) const { return lname files; RageTimer age; /* * If m_bFilled is false, this FileSet hasn't completed being filled in yet; it's * owned by the thread filling it in. Wait on FilenameDB::m_Mutex and retry until * it becomes true. */ bool m_bFilled; FileSet() { m_bFilled = true; } void GetFilesMatching( const RString &sBeginning, const RString &sContaining, const RString &sEnding, std::vector &asOut, bool bOnlyDirs ) const; void GetFilesEqualTo( const RString &pat, std::vector &out, bool bOnlyDirs ) const; RageFileManager::FileType GetFileType( const RString &sPath ) const; int GetFileSize( const RString &sPath ) const; int GetFileHash( const RString &sPath ) const; }; /** @brief A container for a file listing. */ class FilenameDB { public: FilenameDB(): m_Mutex("FilenameDB"), ExpireSeconds( -1 ) { } virtual ~FilenameDB() { FlushDirCache(); } void AddFile( const RString &sPath, int iSize, int iHash, void *pPriv=nullptr ); void DelFile( const RString &sPath ); void *GetFilePriv( const RString &sPath ); /* This handles at most two * wildcards. If we need anything more complicated, * we'll need to use fnmatch or regex. */ void GetFilesSimpleMatch( const RString &sDir, const RString &sFile, std::vector &asOut, bool bOnlyDirs ); /* Search for "path" case-insensitively and replace it with the correct * case. If only a portion of the path exists, resolve as much as possible. * Return true if the entire path was matched. */ bool ResolvePath( RString &sPath ); RageFileManager::FileType GetFileType( const RString &sPath ); int GetFileSize( const RString &sPath ); int GetFileHash( const RString &sFilePath ); void GetDirListing( const RString &sPath, std::vector &asAddTo, bool bOnlyDirs, bool bReturnPathToo ); void FlushDirCache( const RString &sDir = RString() ); void GetFileSetCopy( const RString &dir, FileSet &out ); /* Probably slow, so override it. */ virtual void CacheFile( const RString &sPath ); protected: RageEvent m_Mutex; const File *GetFile( const RString &sPath ); FileSet *GetFileSet( const RString &sDir, bool create=true ); /* Directories we have cached: */ std::map dirs; int ExpireSeconds; void GetFilesEqualTo( const RString &sDir, const RString &sName, std::vector &asOut, bool bOnlyDirs ); void GetFilesMatching( const RString &sDir, const RString &sBeginning, const RString &sContaining, const RString &sEnding, std::vector &asOut, bool bOnlyDirs ); void DelFileSet( std::map::iterator dir ); /* The given path wasn't cached. Cache it. */ virtual void PopulateFileSet( FileSet & /* fs */, const RString & /* sPath */ ) { } }; /* This FilenameDB must be populated in advance. */ class NullFilenameDB: public FilenameDB { public: NullFilenameDB() { ExpireSeconds = -1; } void CacheFile( const RString & /* sPath */ ) { } }; #endif /** * @file * @author Glenn Maynard (c) 2003-2004 * @section LICENSE * All rights reserved. * * Permission is hereby granted, free of charge, to any person obtaining a * copy of this software and associated documentation files (the * "Software"), to deal in the Software without restriction, including * without limitation the rights to use, copy, modify, merge, publish, * distribute, and/or sell copies of the Software, and to permit persons to * whom the Software is furnished to do so, provided that the above * copyright notice(s) and this permission notice appear in all copies of * the Software and that both the above copyright notice(s) and this * permission notice appear in supporting documentation. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF * THIRD PARTY RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR HOLDERS * INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL INDIRECT * OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS * OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR * OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR * PERFORMANCE OF THIS SOFTWARE. */