OAuth2 sign-in flow for ChromeOS

chrome/browser/chromeos/login/oauth2_token_fetcher.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_CHROMEOS_LOGIN_OAUTH2_TOKEN_FETCHER_H_
+#define CHROME_BROWSER_CHROMEOS_LOGIN_OAUTH2_TOKEN_FETCHER_H_
+
+#include <string>
+
+#include "base/basictypes.h"
+#include "base/callback.h"

[xiyuan, 2013/01/07 23:07:55]

callback.h is probably not needed.

[zel, 2013/01/08 02:05:41]

Done.

+#include "base/compiler_specific.h"
+#include "base/memory/weak_ptr.h"
+#include "google_apis/gaia/gaia_auth_consumer.h"
+#include "google_apis/gaia/gaia_auth_fetcher.h"
+
+class Profile;
+
+namespace chromeos {
+
+// OAuth2TokenFetcher is used to convert authenticated cookie jar from the
+// authentication profile into OAuth2 tokens and GAIA credentials that will be
+// used to kick off other token retrieval tasks (i.e. TokenService).

[xiyuan, 2013/01/07 23:07:55]

Update the comments here.

[zel, 2013/01/08 02:05:41]

This is exactly what this class is used for.

+class OAuth2TokenFetcher : public base::SupportsWeakPtr<OAuth2TokenFetcher>,
+                           public GaiaAuthConsumer {
+ public:
+  class Delegate {
+   public:
+    virtual ~Delegate() {}
+    virtual void OnOAuth2TokenAvailable(
+        const GaiaAuthConsumer::ClientLoginResult& gaia_credentials,
+        const GaiaAuthConsumer::ClientOAuthResult& oauth2_tokens) = 0;
+    virtual void OnOAuth2TokenFetchFailed() = 0;
+  };
+
+  OAuth2TokenFetcher(OAuth2TokenFetcher::Delegate* delegate,
+                     Profile* auth_profile);
+  virtual ~OAuth2TokenFetcher();
+
+  void Start();
+
+ private:
+  // Starts OAuthLogin call.
+  void StartOAuthLogin();
+  // Decides how to proceed on GAIA |error|. If the error looks temporary,
+  // retries |task| until max retry count is reached.
+  // If retry count runs out, or error condition is unrecoverable, it calls
+  // Delegate::OnOAuth2TokenFetchFailed().
+  void RetryOnError(const GoogleServiceAuthError& error,
+                    const base::Closure& task);
+
+  // GaiaAuthConsumer overrides.
+  virtual void OnClientOAuthSuccess(
+      const GaiaAuthConsumer::ClientOAuthResult& result) OVERRIDE;
+  virtual void OnClientOAuthFailure(
+      const GoogleServiceAuthError& error) OVERRIDE;
+  virtual void OnClientLoginSuccess(
+      const GaiaAuthConsumer::ClientLoginResult& credentials) OVERRIDE;
+    virtual void OnClientLoginFailure(
+      const GoogleServiceAuthError& error) OVERRIDE;
+
+  OAuth2TokenFetcher::Delegate* delegate_;
+  Profile* auth_profile_;
+  GaiaAuthConsumer::ClientOAuthResult oauth_tokens_;
+  GaiaAuthFetcher auth_fetcher_;
+
+  // The retry counter. Increment this only when failure happened.
+  int retry_count_;
+
+  DISALLOW_COPY_AND_ASSIGN(OAuth2TokenFetcher);
+};
+
+}  // namespace chromeos
+
+#endif  // CHROME_BROWSER_CHROMEOS_LOGIN_OAUTH2_TOKEN_FETCHER_H_