Prompt user for file access permission before download starts

chrome/browser/download/download_target_determiner.h

 // 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.
 
 #ifndef CHROME_BROWSER_DOWNLOAD_DOWNLOAD_TARGET_DETERMINER_H_
 #define CHROME_BROWSER_DOWNLOAD_DOWNLOAD_TARGET_DETERMINER_H_
 
 #include "base/files/file_path.h"
 #include "base/memory/ref_counted.h"
 #include "base/memory/scoped_ptr.h"
 #include "base/memory/weak_ptr.h"
 #include "base/task/cancelable_task_tracker.h"
 #include "chrome/browser/download/download_path_reservation_tracker.h"
 #include "chrome/browser/download/download_target_determiner_delegate.h"
 #include "chrome/browser/download/download_target_info.h"
 #include "content/public/browser/download_danger_type.h"
 #include "content/public/browser/download_item.h"
 #include "content/public/browser/download_manager_delegate.h"
 
 class ChromeDownloadManagerDelegate;
 class Profile;
 class DownloadPrefs;
 
 namespace content {
 enum DownloadDangerType;
+#if defined(OS_ANDROID)
+class DownloadControllerAndroid;
+#endif
 }
 
 // Determines the target of the download.
 //
 // Terminology:
 //   Virtual Path: A path representing the target of the download that may or
 //     may not be a physical file path. E.g. if the target of the download is in
 //     cloud storage, then the virtual path may be relative to a logical mount
 //     point.
 //
@@ skipping 50 matching lines @@
   static bool IsAdobeReaderUpToDate();
 #endif
 
  private:
   // The main workflow is controlled via a set of state transitions. Each state
   // has an associated handler. The handler for STATE_FOO is DoFoo. Each handler
   // performs work, determines the next state to transition to and returns a
   // Result indicating how the workflow should proceed. The loop ends when a
   // handler returns COMPLETE.
   enum State {
+    STATE_PROMPT_USER_FOR_PERMISSION,
     STATE_GENERATE_TARGET_PATH,
     STATE_NOTIFY_EXTENSIONS,
     STATE_RESERVE_VIRTUAL_PATH,
     STATE_PROMPT_USER_FOR_DOWNLOAD_PATH,
     STATE_DETERMINE_LOCAL_PATH,
     STATE_DETERMINE_MIME_TYPE,
     STATE_DETERMINE_IF_HANDLED_SAFELY_BY_BROWSER,
     STATE_DETERMINE_IF_ADOBE_READER_UP_TO_DATE,
     STATE_CHECK_DOWNLOAD_URL,
     STATE_CHECK_VISITED_REFERRER_BEFORE,
@@ skipping 35 matching lines @@
 
   ~DownloadTargetDeterminer() override;
 
   // Invoke each successive handler until a handler returns QUIT_DOLOOP or
   // COMPLETE. Note that as a result, this object might be deleted. So |this|
   // should not be accessed after calling DoLoop().
   void DoLoop();
 
   // === Main workflow ===
 
+  // Prompts user for file access if necessary.
+  // Next state:
+  // - STATE_GENERATE_TARGET_PATH.
+  Result DoPromptUserForPermission();
+
+  // Callback invoked after the file access prompt completes. Cancels the
+  // download if the user doesn't grant file access.
+  void PromptUserForPermissionDone(bool granted);
+
   // Generates an initial target path. This target is based only on the state of
   // the download item.
   // Next state:
   // - STATE_NONE : If the download is not in progress, returns COMPLETE.
   // - STATE_NOTIFY_EXTENSIONS : All other downloads.
   Result DoGenerateTargetPath();
 
   // Notifies downloads extensions. If any extension wishes to override the
   // download filename, it will respond to the OnDeterminingFilename()
   // notification.
@@ skipping 150 matching lines @@
   std::string mime_type_;
   bool is_filetype_handled_safely_;
 
   content::DownloadItem* download_;
   const bool is_resumption_;
   DownloadPrefs* download_prefs_;
   DownloadTargetDeterminerDelegate* delegate_;
   CompletionCallback completion_callback_;
   base::CancelableTaskTracker history_tracker_;
 
+#if defined(OS_ANDROID)
+  // Download controller for file access prompt.
+  content::DownloadControllerAndroid* download_controller_;
+#endif
   base::WeakPtrFactory<DownloadTargetDeterminer> weak_ptr_factory_;
 
   DISALLOW_COPY_AND_ASSIGN(DownloadTargetDeterminer);
 };
 
 #endif  // CHROME_BROWSER_DOWNLOAD_DOWNLOAD_TARGET_DETERMINER_H_