file_system_util.h revision 1320f92c476a1ad9d19dba2a48c72b75566198e9
1// Copyright (c) 2012 The Chromium Authors. All rights reserved. 2// Use of this source code is governed by a BSD-style license that can be 3// found in the LICENSE file. 4 5#ifndef STORAGE_COMMON_FILEAPI_FILE_SYSTEM_UTIL_H_ 6#define STORAGE_COMMON_FILEAPI_FILE_SYSTEM_UTIL_H_ 7 8#include <string> 9#include <vector> 10 11#include "base/files/file.h" 12#include "base/files/file_path.h" 13#include "storage/common/fileapi/file_system_info.h" 14#include "storage/common/fileapi/file_system_types.h" 15#include "storage/common/quota/quota_types.h" 16#include "storage/common/storage_common_export.h" 17#include "third_party/WebKit/public/platform/WebFileError.h" 18#include "third_party/WebKit/public/platform/WebFileSystemType.h" 19 20class GURL; 21 22namespace storage { 23 24STORAGE_COMMON_EXPORT extern const char kPersistentDir[]; 25STORAGE_COMMON_EXPORT extern const char kTemporaryDir[]; 26STORAGE_COMMON_EXPORT extern const char kExternalDir[]; 27STORAGE_COMMON_EXPORT extern const char kIsolatedDir[]; 28STORAGE_COMMON_EXPORT extern const char kTestDir[]; 29 30class STORAGE_COMMON_EXPORT VirtualPath { 31 public: 32 static const base::FilePath::CharType kRoot[]; 33 static const base::FilePath::CharType kSeparator; 34 35 // Use this instead of base::FilePath::BaseName when operating on virtual 36 // paths. FilePath::BaseName will get confused by ':' on Windows when it 37 // looks like a drive letter separator; this will treat it as just another 38 // character. 39 static base::FilePath BaseName(const base::FilePath& virtual_path); 40 41 // Use this instead of base::FilePath::DirName when operating on virtual 42 // paths. 43 static base::FilePath DirName(const base::FilePath& virtual_path); 44 45 // Likewise, use this instead of base::FilePath::GetComponents when 46 // operating on virtual paths. 47 // Note that this assumes very clean input, with no leading slash, and 48 // it will not evaluate '..' components. 49 static void GetComponents( 50 const base::FilePath& path, 51 std::vector<base::FilePath::StringType>* components); 52 53 static void GetComponentsUTF8Unsafe( 54 const base::FilePath& path, std::vector<std::string>* components); 55 56 // Returns a path name ensuring that it begins with kRoot and all path 57 // separators are forward slashes /. 58 static base::FilePath::StringType GetNormalizedFilePath( 59 const base::FilePath& path); 60 61 // Returns true if the given path begins with kRoot. 62 static bool IsAbsolute(const base::FilePath::StringType& path); 63 64 // Returns true if the given path points to the root. 65 static bool IsRootPath(const base::FilePath& path); 66}; 67 68// Parses filesystem scheme |url| into uncracked file system URL components. 69// Example: For a URL 'filesystem:http://foo.com/temporary/foo/bar', 70// |origin_url| is set to 'http://foo.com', |type| is set to 71// kFileSystemTypeTemporary, and |virtual_path| is set to 'foo/bar'. 72STORAGE_COMMON_EXPORT bool ParseFileSystemSchemeURL( 73 const GURL& url, 74 GURL* origin_url, 75 FileSystemType* type, 76 base::FilePath* virtual_path); 77 78// Returns the root URI of the filesystem that can be specified by a pair of 79// |origin_url| and |type|. The returned URI can be used as a root path 80// of the filesystem (e.g. <returned_URI> + "/relative/path" will compose 81// a path pointing to the entry "/relative/path" in the filesystem). 82// 83// For Isolated filesystem this returns the 'common' root part, e.g. 84// returns URL without the filesystem ID. 85// 86// |type| needs to be public type as the returned URI is given to the renderer. 87STORAGE_COMMON_EXPORT GURL GetFileSystemRootURI(const GURL& origin_url, 88 FileSystemType type); 89 90// Returns the name for the filesystem that is specified by a pair of 91// |origin_url| and |type|. 92// (The name itself is neither really significant nor a formal identifier 93// but can be read as the .name field of the returned FileSystem object 94// as a user-friendly name in the javascript layer). 95// 96// |type| needs to be public type as the returned name is given to the renderer. 97// 98// Example: 99// The name for a TEMPORARY filesystem of "http://www.example.com:80/" 100// should look like: "http_www.example.host_80:temporary" 101STORAGE_COMMON_EXPORT std::string 102GetFileSystemName(const GURL& origin_url, FileSystemType type); 103 104// Converts FileSystemType |type| to/from the StorageType |storage_type| that 105// is used for the unified quota system. 106// (Basically this naively maps TEMPORARY storage type to TEMPORARY filesystem 107// type, PERSISTENT storage type to PERSISTENT filesystem type and vice versa.) 108STORAGE_COMMON_EXPORT FileSystemType 109 QuotaStorageTypeToFileSystemType(storage::StorageType storage_type); 110 111STORAGE_COMMON_EXPORT storage::StorageType 112 FileSystemTypeToQuotaStorageType(FileSystemType type); 113 114// Returns the string representation of the given filesystem |type|. 115// Returns an empty string if the |type| is invalid. 116STORAGE_COMMON_EXPORT std::string 117GetFileSystemTypeString(FileSystemType type); 118 119// Sets type to FileSystemType enum that corresponds to the string name. 120// Returns false if the |type_string| is invalid. 121STORAGE_COMMON_EXPORT bool GetFileSystemPublicType( 122 std::string type_string, 123 blink::WebFileSystemType* type); 124 125// Encodes |file_path| to a string. 126// Following conditions should be held: 127// - StringToFilePath(FilePathToString(path)) == path 128// - StringToFilePath(FilePathToString(path) + "/" + "SubDirectory") == 129// path.AppendASCII("SubDirectory"); 130// 131// TODO(tzik): Replace CreateFilePath and FilePathToString in 132// third_party/leveldatabase/env_chromium.cc with them. 133STORAGE_COMMON_EXPORT std::string FilePathToString( 134 const base::FilePath& file_path); 135 136// Decode a file path from |file_path_string|. 137STORAGE_COMMON_EXPORT base::FilePath StringToFilePath( 138 const std::string& file_path_string); 139 140// File error conversion 141STORAGE_COMMON_EXPORT blink::WebFileError 142FileErrorToWebFileError(base::File::Error error_code); 143 144// Generate a file system name for the given arguments. Should only be used by 145// platform apps. 146STORAGE_COMMON_EXPORT std::string GetIsolatedFileSystemName( 147 const GURL& origin_url, 148 const std::string& filesystem_id); 149 150// Find the file system id from |filesystem_name|. Should only be used by 151// platform apps. This function will return false if the file system name is 152// not of the form {origin}:Isolated_{id}, and will also check that there is an 153// origin and id present. It will not check that the origin or id are valid. 154STORAGE_COMMON_EXPORT bool CrackIsolatedFileSystemName( 155 const std::string& filesystem_name, 156 std::string* filesystem_id); 157 158// Validates the given isolated file system id. 159STORAGE_COMMON_EXPORT bool ValidateIsolatedFileSystemId( 160 const std::string& filesystem_id); 161 162// Returns the root URI for an isolated filesystem for origin |origin_url| 163// and |filesystem_id|. If the |optional_root_name| is given the resulting 164// root URI will point to the subfolder within the isolated filesystem. 165STORAGE_COMMON_EXPORT std::string GetIsolatedFileSystemRootURIString( 166 const GURL& origin_url, 167 const std::string& filesystem_id, 168 const std::string& optional_root_name); 169 170// Returns the root URI for an external filesystem for origin |origin_url| 171// and |mount_name|. 172STORAGE_COMMON_EXPORT std::string GetExternalFileSystemRootURIString( 173 const GURL& origin_url, 174 const std::string& mount_name); 175 176// Translates the net::Error to base::File::Error. 177STORAGE_COMMON_EXPORT base::File::Error 178NetErrorToFileError(int error); 179 180} // namespace storage 181 182#endif // STORAGE_COMMON_FILEAPI_FILE_SYSTEM_UTIL_H_ 183