Save-Page-As-Complete-Html: Each frame links to a distinct local file.

third_party/WebKit/public/web/WebFrameSerializer.h

 /*
  * Copyright (C) 2009 Google Inc. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are
  * met:
  *
  *     * Redistributions of source code must retain the above copyright
  * notice, this list of conditions and the following disclaimer.
  *     * Redistributions in binary form must reproduce the above
@@ skipping 20 matching lines @@
 #ifndef WebFrameSerializer_h
 #define WebFrameSerializer_h
 
 #include "../platform/WebCString.h"
 #include "../platform/WebCommon.h"
 #include "../platform/WebData.h"
 #include "../platform/WebString.h"
 #include "../platform/WebURL.h"
 #include "../platform/WebVector.h"
 
-#include <utility>
-
 namespace blink {
 
 class WebFrameSerializerClient;
 class WebFrame;
 class WebLocalFrame;
 template <typename T> class WebVector;
 
 // Serialization of frame contents into html or mhtml.
 class WebFrameSerializer {
 public:
@@ skipping 37 matching lines @@
     //
     // Same |boundary| needs to used for all generateMHTMLHeader and
     // generateMHTMLParts and generateMHTMLFooter calls that belong to the same
     // MHTML document (see also rfc1341, section 7.2.1, "boundary" description).
     BLINK_EXPORT static WebData generateMHTMLFooter(const WebString& boundary);
 
     // IMPORTANT:
     // The API below is an older implementation of frame serialization that
     // will be removed soon.
 
+    class LinkRewritingDelegate {
+    public:
+        // Method allowing the delegate control which URLs are written into the
+        // generated html document.
+        //
+        // When URL of the given frame needs to be rewritten, this method should
+        // return true and populate |rewrittenLink| with a desired value of the
+        // html attribute value to be used in place of the original link (i.e.
+        // in place of the original iframe.src or object.data attribute value).
+        //
+        // If no link rewriting is desired, this method should return false.
+        virtual bool rewriteLink(const WebFrame&, WebString* rewrittenLink) = 0;

[dcheng, 2016/01/12 00:10:47]

Let's distinguish the method names: how about rewriteFrameSource() and
rewriteLink()?

[Łukasz Anforowicz, 2016/01/13 22:32:23]

Done.

+
+        // Method allowing the delegate control which URLs are written into the
+        // generated html document.
+        //
+        // When the given URL needs to be rewritten, this method should
+        // return true and populate |rewrittenLink| with a desired value of the
+        // html attribute value to be used in place of the original link (i.e.
+        // in place of the original img.src or blockquote.cite attribute value).
+        //
+        // If no link rewriting is desired, this method should return false.
+        virtual bool rewriteLink(const WebURL&, WebString* rewrittenLink) = 0;
+    };
+
     // This function will serialize the specified frame to HTML data.
     // We have a data buffer to temporary saving generated html data. We will
     // sequentially call WebFrameSerializerClient once the data buffer is full.
     //
-    // Return false means if no data has been serialized (i.e. because
+    // False is returned if no data has been serialized (i.e. because
     // the target frame didn't have a valid url).
-    //
-    // The parameter frame specifies which frame need to be serialized.
-    // The parameter client specifies the pointer of interface
-    // WebFrameSerializerClient providing a sink interface to receive the
-    // individual chunks of data to be saved.
-    // The parameter urlsToLocalPaths contains a mapping between original URLs
-    // of saved resources and corresponding local file paths.
     BLINK_EXPORT static bool serialize(
         WebLocalFrame*,
         WebFrameSerializerClient*,
-        const WebVector<std::pair<WebURL, WebString>>& urlsToLocalPaths);
+        LinkRewritingDelegate*);
 
     // FIXME: The following are here for unit testing purposes. Consider
     // changing the unit tests instead.
 
     // Generate the META for charset declaration.
     BLINK_EXPORT static WebString generateMetaCharsetDeclaration(const WebString& charset);
     // Generate the MOTW declaration.
     BLINK_EXPORT static WebString generateMarkOfTheWebDeclaration(const WebURL&);
     // Generate the default base tag declaration.
     BLINK_EXPORT static WebString generateBaseTagDeclaration(const WebString& baseTarget);
 };
 
 } // namespace blink
 
 #endif