New FileSystemURL cracking

webkit/fileapi/mount_points.h

 // Copyright (c) 2013 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef WEBKIT_FILEAPI_MOUNT_POINTS_H_
 #define WEBKIT_FILEAPI_MOUNT_POINTS_H_
 
 #include <string>
 #include <vector>
 
 #include "base/basictypes.h"
 #include "base/file_path.h"
 #include "webkit/fileapi/file_system_util.h"
 #include "webkit/storage/webkit_storage_export.h"
 
 class GURL;
 
 namespace fileapi {
+class FileSystemURL;
+}
+
+namespace fileapi {
 
 // Represents a set of mount points for File API.
 class WEBKIT_STORAGE_EXPORT MountPoints {
  public:
   struct WEBKIT_STORAGE_EXPORT MountPointInfo {
     MountPointInfo();
     MountPointInfo(const std::string& name, const FilePath& path);
 
     // The name to be used to register the path. The registered file can
     // be referred by a virtual path /<filesystem_id>/<name>.
@@ skipping 10 matching lines @@
   };
 
   MountPoints() {}
   virtual ~MountPoints() {}
 
   // Revokes a mount point identified by |mount_name|.
   // Returns false if the |mount_name| is not (no longer) registered.
   // TODO(kinuko): Probably this should be rather named RevokeMountPoint.
   virtual bool RevokeFileSystem(const std::string& mount_name) = 0;
 
+  // Returns true if the given url is valid and MountPoints implementation can
+  // be used to crack FileSystemURLs with the url's type.
+  virtual bool CanHandleURL(const FileSystemURL& url) const = 0;
+
+  // Cracks a given FileSystemURL.
+  // If the the URL is not valid or does not belong to any of the mount points
+  // registered in this context, returns empty, invalid FileSystemURL.
+  virtual FileSystemURL CrackFileSystemURL(const FileSystemURL& url) const = 0;
+
+  // Same as CrackFileSystemURL, but cracks FileSystemURL created from |url|.
+  virtual FileSystemURL CrackURL(const GURL& url) const = 0;
+
+  // Same as CrackFileSystemURL, but cracks FileSystemURL created from
+  // method arguments.
+  virtual FileSystemURL CreateCrackedFileSystemURL(
+      const GURL& origin,
+      fileapi::FileSystemType type,
+      const FilePath& path) const = 0;
+
   // Returns the mount point root path registered for a given |mount_name|.
   // Returns false if the given |mount_name| is not valid.
   virtual bool GetRegisteredPath(const std::string& mount_name,
                                  FilePath* path) const = 0;
 
   // Cracks the given |virtual_path| (which is the path part of a filesystem URL
   // without '/external' or '/isolated' prefix part) and populates the
   // |mount_name|, |type|, and |path| if the <mount_name> part embedded in
   // the |virtual_path| (i.e. the first component of the |virtual_path|) is a
   // valid registered filesystem ID or mount name for an existing mount point.
   //
   // Returns false if the given virtual_path cannot be cracked.
   //
   // Note that |path| is set to empty paths if the filesystem type is isolated
   // and |virtual_path| has no <relative_path> part (i.e. pointing to the
   // virtual root).
   virtual bool CrackVirtualPath(const FilePath& virtual_path,
                                 std::string* mount_name,
                                 FileSystemType* type,
                                 FilePath* path) const = 0;
 
  private:
   DISALLOW_COPY_AND_ASSIGN(MountPoints);
 };
 
 }  // namespace fileapi
 
 #endif  // WEBKIT_FILEAPI_MOUNT_POINTS_H_