Save Page As MHTML

content/browser/download/save_package.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.
 
 #ifndef CONTENT_BROWSER_DOWNLOAD_SAVE_PACKAGE_H_
 #define CONTENT_BROWSER_DOWNLOAD_SAVE_PACKAGE_H_
 #pragma once
 
 #include <queue>
 #include <string>
@@ skipping 17 matching lines @@
 class SaveItem;
 class SavePackage;
 struct SaveFileCreateInfo;
 
 namespace content {
 class DownloadManager;
 class WebContents;
 }
 
 // The SavePackage object manages the process of saving a page as only-html or
-// complete-html and providing the information for displaying saving status.
-// Saving page as only-html means means that we save web page to a single HTML
-// file regardless internal sub resources and sub frames.
-// Saving page as complete-html page means we save not only the main html file
-// the user told it to save but also a directory for the auxiliary files such
-// as all sub-frame html files, image files, css files and js files.
+// complete-html or MHTML and providing the information for displaying saving
+// status.  Saving page as only-html means means that we save web page to a
+// single HTML file regardless internal sub resources and sub frames.  Saving
+// page as complete-html page means we save not only the main html file the user
+// told it to save but also a directory for the auxiliary files such as all
+// sub-frame html files, image files, css files and js files.  Saving page as
+// MHTML means the same thing as complete-html, but it uses the MHTML format to
+// contain the html and all auxiliary files in a single text file.
 //
 // Each page saving job may include one or multiple files which need to be
 // saved. Each file is represented by a SaveItem, and all SaveItems are owned
 // by the SavePackage. SaveItems are created when a user initiates a page
 // saving job, and exist for the duration of one contents's life time.
 class CONTENT_EXPORT SavePackage
     : public base::RefCountedThreadSafe<SavePackage>,
       public content::WebContentsObserver,
       public content::DownloadItem::Observer,
       public base::SupportsWeakPtr<SavePackage> {
@@ skipping 57 matching lines @@
   content::SavePageType save_type() const { return save_type_; }
   int contents_id() const { return contents_id_; }
   int id() const { return unique_id_; }
   content::WebContents* web_contents() const;
 
   void GetSaveInfo();
 
  private:
   friend class base::RefCountedThreadSafe<SavePackage>;
 
+  // Callback for content::WebContents::GenerateMHTML().
+  void MHTMLGenerated(const FilePath& path, int64 size);

[cbentzel, 2012/04/17 14:45:34]

Perhaps prefix with On to make it clear that this is a callback handler. 

[benjhayden, 2012/04/17 17:14:36]

Done.

+
   // For testing only.
   SavePackage(content::WebContents* web_contents,
               const FilePath& file_full_path,
               const FilePath& directory_full_path);
 
   virtual ~SavePackage();
 
   // Notes from Init() above applies here as well.
   void InternalInit();
 
@@ skipping 176 matching lines @@
   bool wrote_to_failed_file_;
 
   friend class SavePackageTest;
   FRIEND_TEST_ALL_PREFIXES(SavePackageTest, TestSuggestedSaveNames);
   FRIEND_TEST_ALL_PREFIXES(SavePackageTest, TestLongSafePureFilename);
 
   DISALLOW_COPY_AND_ASSIGN(SavePackage);
 };
 
 #endif  // CONTENT_BROWSER_DOWNLOAD_SAVE_PACKAGE_H_