chromium/chrome/browser/ash/fileapi/external_file_url_util.h

// Copyright 2014 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef CHROME_BROWSER_ASH_FILEAPI_EXTERNAL_FILE_URL_UTIL_H_
#define CHROME_BROWSER_ASH_FILEAPI_EXTERNAL_FILE_URL_UTIL_H_

#include "base/time/time.h"
#include "storage/common/file_system/file_system_types.h"

class GURL;

namespace base {
class FilePath;
}

namespace content {
class BrowserContext;
}

namespace storage {
class FileSystemURL;
}

namespace ash {

// Returns whether the external file URL is provided for the |type| or not.
// TODO(b/119597913): Remove |force| from all functions in this file
// once ARC++ can access FUSE-mounted filesystems directly.
bool IsExternalFileURLType(storage::FileSystemType type, bool force = false);

// Obtains the external file url formatted as "externalfile:<path>" from file
// path. Returns empty URL if the file system does not provide the external file
// URL.
GURL FileSystemURLToExternalFileURL(
    const storage::FileSystemURL& file_system_url,
    bool force = false);

// Converts a externalfile: URL back to a virtual path of FileSystemURL.
base::FilePath ExternalFileURLToVirtualPath(const GURL& url);

// Converts a virtual path of FileSystemURL to an externalfile: URL.
GURL VirtualPathToExternalFileURL(const base::FilePath& virtual_path);

// Obtains external file URL (e.g. external:drive/root/sample.txt) from file
// path (e.g. /special/drive-xxx/root/sample.txt), if the |path| points an
// external location (drive, MTP, or FSP). Otherwise, it returns empty URL.
GURL CreateExternalFileURLFromPath(content::BrowserContext* browser_context,
                                   const base::FilePath& path,
                                   bool force = false);

// Registers a Fusebox moniker (with the given read_only and lifetime) for an
// "externalfile://etc/foo/bar.txt" URL and returns the corresponding
// "file://etc/fusebox/etc/moniker/1234etc.txt" URL. It returns an empty GURL
// on failure (e.g. there is no global Fusebox server instance).
//
// The returned GURL will have the same filename extension as the input GURL:
// it will end with "moniker/1234etc.txt", where "1234etc" is the moniker's
// randomly generated identifier (as hexadecimal digits).
//
// See fusebox_moniker.h comments for more details about Fusebox monikers.
GURL ExternalFileURLToFuseboxMonikerFileURL(
    content::BrowserContext* browser_context,
    const GURL& url,
    bool read_only,
    base::TimeDelta lifetime);

}  // namespace ash

#endif  // CHROME_BROWSER_ASH_FILEAPI_EXTERNAL_FILE_URL_UTIL_H_