Prerendering: Add MatchComplete PPLT

chrome/browser/prerender/prerender_contents.h

 // Copyright (c) 2011 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_PRERENDER_PRERENDER_CONTENTS_H_
 #define CHROME_BROWSER_PRERENDER_PRERENDER_CONTENTS_H_
 #pragma once
 
 #include <list>
 #include <string>
@@ skipping 64 matching lines @@
     PendingPrerenderData(Origin origin, const GURL& url, const GURL& referrer);
 
     Origin origin;
     GURL url;
     GURL referrer;
   };
   typedef std::list<PendingPrerenderData> PendingPrerenderList;
 
   virtual ~PrerenderContents();
 
+  // Initializes the prerendering.  This can fail if the URL to be prerendered
+  // was recently visited. If false is returned, the caller should
+  // destroy the PrerenderContents object.
   bool Init();
 
   static Factory* CreateFactory();
 
   // |source_render_view_host| is the RenderViewHost that initiated
   // prerendering.
   virtual void StartPrerendering(
       const RenderViewHost* source_render_view_host,
       SessionStorageNamespace* session_storage_namespace);
 
   // Verifies that the prerendering is not using too many resources, and kills
   // it if not.
   void DestroyWhenUsingTooManyResources();
 
   RenderViewHost* render_view_host_mutable();
   const RenderViewHost* render_view_host() const;
 
   ViewHostMsg_FrameNavigate_Params* navigate_params() {
     return navigate_params_.get();
   }
   string16 title() const { return title_; }
   int32 page_id() const { return page_id_; }
   GURL icon_url() const { return icon_url_; }
   const GURL& prerender_url() const { return prerender_url_; }
+  const GURL& referrer() const { return referrer_; }
   bool has_stopped_loading() const { return has_stopped_loading_; }
   bool prerendering_has_started() const { return prerendering_has_started_; }
 
   // Sets the parameter to the value of the associated RenderViewHost's child id
   // and returns a boolean indicating the validity of that id.
   virtual bool GetChildId(int* child_id) const;
 
   // Sets the parameter to the value of the associated RenderViewHost's route id
   // and returns a boolean indicating the validity of that id.
   virtual bool GetRouteId(int* route_id) const;
 
   // Set the final status for how the PrerenderContents was used. This
   // should only be called once, and should be called before the prerender
   // contents are destroyed.
   void set_final_status(FinalStatus final_status);
   FinalStatus final_status() const { return final_status_; }
 
   Origin origin() const { return origin_; }
+  uint8 experiment_id() const { return experiment_id_; }
 
   base::TimeTicks load_start_time() const { return load_start_time_; }
 
   // Indicates whether this prerendered page can be used for the provided
   // URL, i.e. whether there is a match. |matching_url| is optional and will be
   // set to the URL that is found as a match if it is provided.
   bool MatchesURL(const GURL& url, GURL* matching_url) const;
 
   void OnJSOutOfMemory();
   bool ShouldSuppressDialogs();
 
   // TabContentsObserver implementation.
   virtual void DidStopLoading() OVERRIDE;
   virtual void DidStartProvisionalLoadForFrame(
       int64 frame_id,
       bool is_main_frame,
       const GURL& validated_url,
       bool is_error_page,
       RenderViewHost* render_view_host) OVERRIDE;
   virtual void RenderViewGone() OVERRIDE;
 
   // content::NotificationObserver
   virtual void Observe(int type,
                        const content::NotificationSource& source,
                        const content::NotificationDetails& details) OVERRIDE;
 
   // Adds an alias URL, for one of the many redirections. If the URL can not
   // be prerendered - for example, it's an ftp URL - |this| will be destroyed
   // and false is returned. Otherwise, true is returned and the alias is
-  // remembered.
-  virtual bool AddAliasURL(const GURL& url);
+  // remembered. If destroy_on_failure is set to false, no actual destruction
+  // will happen, but the caller will have to take care of deleting the object
+  // himself.
+  virtual bool AddAliasURL(const GURL& url, bool destroy_on_failure);

[dominich, 2011/11/11 20:02:09]

I've been through the CL but I don't understand why this new bool is needed. I'm
very nervous about any changes to who is responsible for deleting these.

 
   // The preview TabContents (may be null).
   TabContentsWrapper* prerender_contents() const {
     return prerender_contents_.get();
   }
 
   TabContentsWrapper* ReleasePrerenderContents();
 
   // Sets the final status, calls OnDestroy and adds |this| to the
   // PrerenderManager's pending deletes list.
@@ skipping 142 matching lines @@
 
   // Offset by which to offset prerendered pages
   static const int32 kPrerenderPageIdOffset = 10;
 
   DISALLOW_COPY_AND_ASSIGN(PrerenderContents);
 };
 
 }  // namespace prerender
 
 #endif  // CHROME_BROWSER_PRERENDER_PRERENDER_CONTENTS_H_