PrerenderingLoader initial integration with PrerenderManager/PrerenderHandle

chrome/browser/android/offline_pages/prerender_adapter.h

+// Copyright 2016 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_ANDROID_OFFLINE_PAGES_PRERENDER_ADAPTER_H_
+#define CHROME_BROWSER_ANDROID_OFFLINE_PAGES_PRERENDER_ADAPTER_H_
+
+#include <memory>
+
+#include "chrome/browser/prerender/prerender_handle.h"
+
+class GURL;
+
+namespace content {
+class BrowserContext;
+class WebContents;
+class SessionStorageNamespace;
+}  // namespace content
+
+namespace gfx {
+class Size;
+}  // namespace gfx
+
+namespace offline_pages {
+
+// An adapter for managing a prerendering request for offlining. This handles
+// all calls into the prerender stack and tracks the active prerender handle.
+class PrerenderAdapter {
+ public:
+  PrerenderAdapter();
+  virtual ~PrerenderAdapter();
+
+  // Returns whether prerendering is enabled and configured.
+  virtual bool CanPrerender() const;
+
+  // Starts prerendering |url| for offlining. There must be no active
+  // prerender request when calling this. Returns whether it was able
+  // to start the prerendering operation.
+  virtual bool StartPrerender(
+      content::BrowserContext* browser_context,
+      const GURL& url,
+      content::SessionStorageNamespace* session_storage_namespace,
+      const gfx::Size& size,
+      prerender::PrerenderHandle::Observer* observer);
+
+  // Returns a pointer to the prerendered WebContents. This should only be
+  // called once prerendering observer events indicate content is loaded.
+  // It may be used for snapshotting the page. The caller does NOT get
+  // ownership on the contents and must call |DestroyActive()|
+  // to report when it no longer needs the web contents. The caller should
+  // have a PrerenderHandle::Observer and watch for |OnPrerenderStop()| to
+  // learn that the web contents should no longer be used.
+  virtual content::WebContents* GetWebContents() const;
+
+  // Returns the final status of prerendering.
+  virtual prerender::FinalStatus GetFinalStatus() const;
+
+  // Returns whether this adapter has an active prerender request. This
+  // adapter supports one request at a time. DestroyActive() may be used
+  // to clear an active request (which will allow StartPrerender() to be
+  // called to request a new one).
+  virtual bool IsActive() const;
+
+  // Returns whether there is an active prerendering associated with
+  // the |handle|. This may be used to confirm that an observed prerender
+  // event for |handle| applies to the active prerendering.
+  virtual bool HasHandle(prerender::PrerenderHandle* handle) const;
+
+  // Cancels any current prerendering operation and destroys its local handle.
+  virtual void DestroyActive();
+
+ private:
+  // At most one prerender request may be active for this adapter and this
+  // holds its handle if one is active.
+  std::unique_ptr<prerender::PrerenderHandle> active_handle_;
+
+  DISALLOW_COPY_AND_ASSIGN(PrerenderAdapter);
+};
+
+}  // namespace offline_pages
+
+#endif  // CHROME_BROWSER_ANDROID_OFFLINE_PAGES_PRERENDER_ADAPTER_H_