TabContents -> WebContentsImpl, part 9.

content/browser/download/save_file_manager.h

 // Copyright (c) 2012 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.
 //
 // Objects that handle file operations for saving files, on the file thread.
 //
 // The SaveFileManager owns a set of SaveFile objects, each of which connects
 // with a SaveItem object which belongs to one SavePackage and runs on the file
 // thread for saving data in order to avoid disk activity on either network IO
 // thread or the UI thread. It coordinates the notifications from the network
@@ skipping 25 matching lines @@
 //                              |----> stats ---->|
 //                                              ui_thread (feedback for user)
 //
 //
 // Cancel operations perform the inverse order when triggered by a user action:
 // ui_thread (user click)
 //    |----> cancel command ---->|
 //    |           |      file_thread (close file)
 //    |           |---------------------> cancel command ---->|
 //    |                                               io_thread (stops net IO
-// ui_thread (user close tab)                                    for saving)
+// ui_thread (user close contents)                               for saving)
 //    |----> cancel command ---->|
 //                            Render process(stop serializing DOM and sending
 //                                           data)
 //
 //
-// The SaveFileManager tracks saving requests, mapping from a save ID
-// (unique integer created in the IO thread) to the SavePackage for the
-// tab where the saving job was initiated. In the event of a tab closure
-// during saving, the SavePackage will notice the SaveFileManage to
-// cancel all SaveFile job.
+// The SaveFileManager tracks saving requests, mapping from a save ID (unique
+// integer created in the IO thread) to the SavePackage for the contents where
+// the saving job was initiated. In the event of a contents closure during
+// saving, the SavePackage will notify the SaveFileManage to cancel all SaveFile
+// jobs.
 
 #ifndef CONTENT_BROWSER_DOWNLOAD_SAVE_FILE_MANAGER_H_
 #define CONTENT_BROWSER_DOWNLOAD_SAVE_FILE_MANAGER_H_
 #pragma once
 
 #include <string>
 
 #include "base/basictypes.h"
 #include "base/hash_tables.h"
 #include "base/memory/ref_counted.h"
@@ skipping 78 matching lines @@
   void RemoveSavedFileFromFileMap(const SaveIDList & save_ids);
 
  private:
   friend class base::RefCountedThreadSafe<SaveFileManager>;
 
   ~SaveFileManager();
 
   // A cleanup helper that runs on the file thread.
   void OnShutdown();
 
-  // Called only on UI thread to get the SavePackage for a tab's browser
+  // Called only on UI thread to get the SavePackage for a contents's browser
   // context.
   static SavePackage* GetSavePackageFromRenderIds(int render_process_id,
                                                   int review_view_id);
 
   // Register a starting request. Associate the save URL with a
   // SavePackage for further matching.
   void RegisterStartingRequest(const GURL& save_url,
                                SavePackage* save_package);
   // Unregister a start request according save URL, disassociate
   // the save URL and SavePackage.
   SavePackage* UnregisterStartingRequest(const GURL& save_url,
-                                         int tab_id);
+                                         int contents_id);
 
   // Look up the SavePackage according to save id.
   SavePackage* LookupPackage(int save_id);
 
   // Called only on the file thread.
   // Look up one in-progress saving item according to save id.
   SaveFile* LookupSaveFile(int save_id);
 
   // Help function for sending notification of canceling specific request.
   void SendCancelRequest(int save_id);
 
   // Notifications sent from the file thread and run on the UI thread.
 
-  // Lookup the SaveManager for this TabContents' saving browser context and
+  // Lookup the SaveManager for this WebContents' saving browser context and
   // inform it the saving job has been started.
   void OnStartSave(const SaveFileCreateInfo* info);
   // Update the SavePackage with the current state of a started saving job.
   // If the SavePackage for this saving job is gone, cancel the request.
   void OnUpdateSaveProgress(int save_id,
                             int64 bytes_so_far,
                             bool write_success);
   // Update the SavePackage with the finish state, and remove the request
   // tracking entries.
   void OnSaveFinished(int save_id, int64 bytes_so_far, bool is_success);
   // For those requests that do not have valid save id, use
   // map:(url, SavePackage) to find the request and remove it.
-  void OnErrorFinished(const GURL& save_url, int tab_id);
+  void OnErrorFinished(const GURL& save_url, int contents_id);
   // Notifies SavePackage that the whole page saving job is finished.
   void OnFinishSavePageJob(int render_process_id,
                            int render_view_id,
                            int save_package_id);
 
   // Notifications sent from the UI thread and run on the file thread.
 
   // Deletes a specified file on the file thread.
   void OnDeleteDirectoryOrFile(const FilePath& full_path, bool is_dir);
 
@@ skipping 22 matching lines @@
   // SavePackageMap maps save IDs to their SavePackage.
   typedef base::hash_map<int, SavePackage*> SavePackageMap;
   SavePackageMap packages_;
 
   // There is a gap between after calling SaveURL() and before calling
   // StartSave(). In this gap, each request does not have save id for tracking.
   // But sometimes users might want to stop saving job or ResourceDispatcherHost
   // calls SaveFinished with save id -1 for network error. We name the requests
   // as starting requests. For tracking those starting requests, we need to
   // have some data structure.
-  // First we use a hashmap to map the request URL to SavePackage, then we
-  // use a hashmap to map the tab id (we actually use render_process_id) to the
-  // hashmap since it is possible to save same URL in different tab at
+  // First we use a hashmap to map the request URL to SavePackage, then we use a
+  // hashmap to map the contents id (we actually use render_process_id) to the
+  // hashmap since it is possible to save the same URL in different contents at
   // same time.
   typedef base::hash_map<std::string, SavePackage*> StartingRequestsMap;
-  typedef base::hash_map<int, StartingRequestsMap> TabToStartingRequestsMap;
-  TabToStartingRequestsMap tab_starting_requests_;
+  typedef base::hash_map<int, StartingRequestsMap>
+      ContentsToStartingRequestsMap;
+  ContentsToStartingRequestsMap contents_starting_requests_;
 
   DISALLOW_COPY_AND_ASSIGN(SaveFileManager);
 };
 
 #endif  // CONTENT_BROWSER_DOWNLOAD_SAVE_FILE_MANAGER_H_