[fsp] Add the getMetadata operation.

chrome/common/extensions/api/file_system_provider.idl

 // Copyright 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.
 
 // Use the <code>chrome.fileSystemProvider</code> API to create file systems,
 // that can be accessible from the file manager on Chrome OS.
 [platforms=("chromeos"),
  implemented_in="chrome/browser/chromeos/extensions/file_system_provider/file_system_provider_api.h"]
 namespace fileSystemProvider {
   // Error codes used by providing extensions in response to requests. For
@@ skipping 11 matching lines @@
     NOT_A_DIRECTORY,
     INVALID_OPERATION,
     SECURITY,
     ABORT,
     NOT_A_FILE,
     NOT_EMPTY,
     INVALID_URL,
     IO
   };
 
+  // Represents metadata of a file or a directory.
+  dictionary EntryMetadata {
+    // True if it is a directory.
+    boolean isDirectory;
+
+    // Name of this entry (not full path name).
+    DOMString name;
+
+    // File size in bytes.
+    double size;
+
+    // The last modified time of this entry.
+    [instanceOf=Date] object modificationTime;
+  };
+
   // Callback to receive the result of mount() function.
   // <code>fileSystemID</code> will be a unique ID for the file system just
   // mounted. The ID is used to distinguish multiple file systems mounted
   // from a single File System Provider.
   callback MountCallback = void(long fileSystemId,
                                 [nodoc, instanceOf=DOMError] object error);
 
 
   // Callback to receive the result of unmount() function with the <code>
   // fileSystemId</code> identifier.
   callback UnmountCallback = void(long fileSystemId,
                                   [nodoc, instanceOf=DOMError] object error);
 
   // Callback to be called by the providing extension in case of a success.
   callback ProviderSuccessCallback = void();
 
   // Callback to be called by the providing extension in case of an error.
   callback ProviderErrorCallback = void(ProviderError error);
 
   // Callback to handle an error raised from the browser.
   [nocompile] callback ErrorCallback = void([instanceOf=DOMError] object error);
 
+  // Success callback for the <code>onGetMetadataRequested</code> event.
+  callback MetadataCallback = void(EntryMetadata metadata);
+
   interface Functions {
     // Mounts a file system with the given <code>displayName</code>.
     // <code>displayName</code> will be shown in the left panel of
     // Files.app. <code>displayName</code> can contain any characters
     // including '/', but cannot be an empty string. <code>displayName</code>
     // should be descriptive but doesn't have to be unique. Duplicate display
     // names are uniquified by adding suffix like "(1)" in the Files.app UI.
     static void mount(DOMString displayName,
                       MountCallback successCallback,
                       [nocompile] ErrorCallback errorCallback);
 
     // Unmounts a file system with the given <code>fileSystemId</code>. It
     // should be called after <code>onUnmountRequested</code> is invoked. Also,
     // the providing extension can decide to perform unmounting if not requested
     // (eg. in case of lost connection, or a file error). If there is no file
     // system with the requested id, or unmounting fails, then the
     // <code>errorCallback</code> will be called.
     static void unmount(long fileSystemId,
                         UnmountCallback successCallback,
                         [nocompile] ErrorCallback errorCallback);
   };
 
   interface Events {
-    // Raised, when the user requests unmounting of the file system with the
-    // <code>fileSystemId</code> identifier in the Files.app UI. In response,
-    // the <code>unmount</code> API method should be called. If unmounting is
-    // not possible (eg. due to pending operation), then <code>errorCallback
-    // </code> should be called, and <code>unmount</code> should not be called.
+    // Raised when unmounting for the file system with the <code>fileSystemId
+    // </code> identifier is requested. In response, the <code>unmount</code>
+    // API method should be called together with <code>successCallback</code>.
+    // If unmounting is not possible (eg. due to a pending operation), then
+    // <code>errorCallback</code> must be called.
     [maxListeners=1] static void onUnmountRequested(
         long fileSystemId,
         ProviderSuccessCallback successCallback,
         ProviderErrorCallback errorCallback);
+
+    // Raised, when metada of a file or a directory at <code>entryPath</code>

[benwells, 2014/05/01 04:16:25]

Nit: metada?

[mtomasz, 2014/05/01 05:09:07]

Oops. Done.

+    // is requested. The metadata should be returned with the <code>
+    // successCallback</code> call. In case of an error, <code>errorCallback
+    // </code> must be called.
+    [maxListeners=1] static void onGetMetadataRequested(
+        long fileSystemId,
+        DOMString entryPath,
+        MetadataCallback successCallback,
+        ErrorCallback errorCallback);
   };
 };