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