blob: 3f33e703111ca32796de4a2d8b01dfe5b1f4cb5d [file] [log] [blame]
// 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 GOOGLE_APIS_GAIA_OAUTH2_ACCESS_TOKEN_FETCHER_H_
#define GOOGLE_APIS_GAIA_OAUTH2_ACCESS_TOKEN_FETCHER_H_
#include <string>
#include <vector>
#include "base/macros.h"
#include "google_apis/gaia/oauth2_access_token_consumer.h"
#include "net/url_request/url_fetcher_delegate.h"
// Interface of a OAuth2 access token fetcher.
//
// Usage:
// * Create an instance with a consumer.
// * Call Start()
// * The consumer passed in the constructor will be called on the same
// thread Start was called with the results.
//
// This class can handle one request at a time. To parallelize requests,
// create multiple instances.
class OAuth2AccessTokenFetcher {
public:
explicit OAuth2AccessTokenFetcher(OAuth2AccessTokenConsumer* consumer);
virtual ~OAuth2AccessTokenFetcher();
// Starts the flow with the given parameters.
// |scopes| can be empty. If it is empty then the access token will have the
// same scope as the refresh token. If not empty, then access token will have
// the scopes specified. In this case, the access token will successfully be
// generated only if refresh token has login scope of a list of scopes that is
// a super-set of the specified scopes.
virtual void Start(const std::string& client_id,
const std::string& client_secret,
const std::vector<std::string>& scopes) = 0;
// Cancels the current request and informs the consumer.
virtual void CancelRequest() = 0;
protected:
// Fires |OnGetTokenSuccess| on |consumer_|.
void FireOnGetTokenSuccess(
const OAuth2AccessTokenConsumer::TokenResponse& token_response);
// Fires |OnGetTokenFailure| on |consumer_|.
void FireOnGetTokenFailure(const GoogleServiceAuthError& error);
private:
OAuth2AccessTokenConsumer* const consumer_;
DISALLOW_COPY_AND_ASSIGN(OAuth2AccessTokenFetcher);
};
#endif // GOOGLE_APIS_GAIA_OAUTH2_ACCESS_TOKEN_FETCHER_H_