| // Copyright 2014 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 COMPONENTS_SYNC_ENGINE_ATTACHMENTS_ATTACHMENT_DOWNLOADER_H_ |
| #define COMPONENTS_SYNC_ENGINE_ATTACHMENTS_ATTACHMENT_DOWNLOADER_H_ |
| |
| #include <memory> |
| #include <string> |
| |
| #include "base/callback.h" |
| #include "components/sync/base/model_type.h" |
| #include "components/sync/model/attachments/attachment.h" |
| #include "google_apis/gaia/oauth2_token_service_request.h" |
| |
| namespace net { |
| class URLRequestContextGetter; |
| } // namespace net |
| |
| namespace syncer { |
| |
| // AttachmentDownloader is responsible for downloading attachments from server. |
| class AttachmentDownloader { |
| public: |
| // The result of a DownloadAttachment operation. |
| enum DownloadResult { |
| DOWNLOAD_SUCCESS, // No error, attachment was downloaded |
| // successfully. |
| DOWNLOAD_TRANSIENT_ERROR, // A transient error occurred, try again later. |
| DOWNLOAD_UNSPECIFIED_ERROR, // An unspecified error occurred. |
| }; |
| |
| using DownloadCallback = |
| base::Callback<void(const DownloadResult&, std::unique_ptr<Attachment>)>; |
| |
| virtual ~AttachmentDownloader(); |
| |
| // Download attachment referred by |attachment_id| and invoke |callback| when |
| // done. |
| // |
| // |callback| will receive a DownloadResult code and an Attachment object. If |
| // DownloadResult is not DOWNLOAD_SUCCESS then attachment pointer is null. |
| virtual void DownloadAttachment(const AttachmentId& attachment_id, |
| const DownloadCallback& callback) = 0; |
| |
| // Create an instance of AttachmentDownloader. |
| // |
| // |sync_service_url| is the URL of the sync service. |
| // |
| // |url_request_context_getter| provides a URLRequestContext. |
| // |
| // |account_id| is the account id to use for downloads. |
| // |
| // |scopes| is the set of scopes to use for downloads. |
| // |
| // |token_service_provider| provides an OAuth2 token service. |
| // |
| // |store_birthday| is the raw, sync store birthday. |
| // |
| // |model_type| is the model type this downloader is used with. |
| static std::unique_ptr<AttachmentDownloader> Create( |
| const GURL& sync_service_url, |
| const scoped_refptr<net::URLRequestContextGetter>& |
| url_request_context_getter, |
| const std::string& account_id, |
| const OAuth2TokenService::ScopeSet scopes, |
| const scoped_refptr<OAuth2TokenServiceRequest::TokenServiceProvider>& |
| token_service_provider, |
| const std::string& store_birthday, |
| ModelType model_type); |
| }; |
| |
| } // namespace syncer |
| |
| #endif // COMPONENTS_SYNC_ENGINE_ATTACHMENTS_ATTACHMENT_DOWNLOADER_H_ |