Start implementing an auth flow for platform apps to be able to do auth

chrome/browser/extensions/api/identity/extension_auth_flow.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 CHROME_BROWSER_EXTENSIONS_API_IDENTITY_EXTENSION_AUTH_FLOW_H_
+#define CHROME_BROWSER_EXTENSIONS_API_IDENTITY_EXTENSION_AUTH_FLOW_H_
+#pragma once
+
+#include <string>
+
+#include "base/memory/scoped_ptr.h"
+#include "content/public/browser/web_contents.h"
+#include "content/public/browser/web_contents_delegate.h"
+#include "googleurl/src/gurl.h"
+#include "ui/views/controls/webview/webview.h"
+#include "ui/views/widget/widget.h"
+#include "ui/views/widget/widget_delegate.h"
+
+namespace content {
+class BrowserContext;
+}
+
+namespace extensions {
+
+// Controller class to perform an auth flow with a provider.
+// This is the class to start the auth flow and it takes care of all the
+// details. It behaves the following way:
+// Given a provider URL, load the URL and perform usual web protocol steps
+// until the redirect back to the given URL happens. The provider can show
+// a web page to the user if needed before redirecting it to an appropriate
+// URL.
+class ExtensionAuthFlow
+    : public content::WebContentsDelegate,
+      public views::WidgetDelegate {
+ public:
+  class Delegate {
+   public:
+    // Called when the auth flow is completely (with success or failure).
+    // |redirect_url| is the full URL the provider redirected to at the end
+    // of the flow.
+    virtual void OnAuthFlowCompleted(const std::string& redirect_url) = 0;
+  };
+
+  // Creates an instance with the given parameters.
+  ExtensionAuthFlow(Delegate* delegate,
+                    content::BrowserContext* browser_context,
+                    const std::string& extension_id,
+                    const GURL& provider_url);
+
+  // Starts the flow.
+  // Delegate will be called with callbacks.
+  void Start();
+
+ private:
+  // WebContentsDelegate implementation.
+  virtual void LoadingStateChanged(content::WebContents* source) OVERRIDE;
+
+  // WidgetDelegate implementation.
+  virtual views::View* GetContentsView() OVERRIDE;
+  virtual views::Widget* GetWidget() OVERRIDE;
+  virtual const views::Widget* GetWidget() const OVERRIDE;
+  virtual void WindowClosing() OVERRIDE;
+
+  void OnProviderUrlLoaded();
+  // Reports the results back to the delegate.
+  void ReportResult();
+
+  Delegate* delegate_;
+  content::BrowserContext* browser_context_;
+  GURL provider_url_;
+  std::string extension_id_;
+  GURL result_;
+
+  scoped_ptr<content::WebContents> contents_;
+  scoped_ptr<views::WebView> web_view_;

[sky, 2012/04/27 18:27:38]

Views are normally owned by their parent. So, as long as you only create this
when showing in a widget you don't need a scoped_ptr. Alternatively you can use
a scoped_ptr but invoke set_parent_owned(false).

+  scoped_ptr<views::Widget> widget_;

[sky, 2012/04/27 18:27:38]

If you want to own the widget like this you need to create it with the InitParam
WIDGET_OWNS_NATIVE_WIDGET.

+
+  DISALLOW_COPY_AND_ASSIGN(ExtensionAuthFlow);
+};
+
+}  // namespace extensions
+
+#endif CHROME_BROWSER_EXTENSIONS_API_IDENTITY_EXTENSION_AUTH_FLOW_H_