| // Copyright 2014 The Chromium OS 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 LIBCHROMEOS_CHROMEOS_HTTP_HTTP_TRANSPORT_H_ |
| #define LIBCHROMEOS_CHROMEOS_HTTP_HTTP_TRANSPORT_H_ |
| |
| #include <memory> |
| #include <string> |
| #include <utility> |
| #include <vector> |
| |
| #include <base/callback_forward.h> |
| #include <base/macros.h> |
| #include <base/memory/scoped_ptr.h> |
| #include <chromeos/chromeos_export.h> |
| #include <chromeos/errors/error.h> |
| |
| namespace tracked_objects { |
| class Location; |
| } // namespace tracked_objects |
| |
| namespace chromeos { |
| namespace http { |
| |
| CHROMEOS_EXPORT extern const char kErrorDomain[]; |
| |
| class Request; |
| class Response; |
| class Connection; |
| |
| using HeaderList = std::vector<std::pair<std::string, std::string>>; |
| using SuccessCallback = base::Callback<void(scoped_ptr<Response>)>; |
| using ErrorCallback = base::Callback<void(const chromeos::Error*)>; |
| |
| /////////////////////////////////////////////////////////////////////////////// |
| // Transport is a base class for specific implementation of HTTP communication. |
| // This class (and its underlying implementation) is used by http::Request and |
| // http::Response classes to provide HTTP functionality to the clients. |
| /////////////////////////////////////////////////////////////////////////////// |
| class CHROMEOS_EXPORT Transport |
| : public std::enable_shared_from_this<Transport> { |
| public: |
| Transport() = default; |
| virtual ~Transport() = default; |
| |
| // Creates a connection object and initializes it with the specified data. |
| // |transport| is a shared pointer to this transport object instance, |
| // used to maintain the object alive as long as the connection exists. |
| virtual std::shared_ptr<Connection> CreateConnection( |
| const std::string& url, |
| const std::string& method, |
| const HeaderList& headers, |
| const std::string& user_agent, |
| const std::string& referer, |
| chromeos::ErrorPtr* error) = 0; |
| |
| // Runs |callback| on the task runner (message loop) associated with the |
| // transport. For transports that do not contain references to real message |
| // loops (e.g. a fake transport), calls the callback immediately. |
| virtual void RunCallbackAsync(const tracked_objects::Location& from_here, |
| const base::Closure& callback) = 0; |
| |
| // Initiates an asynchronous transfer on the given |connection|. |
| // The actual implementation of an async I/O is transport-specific. |
| virtual void StartAsyncTransfer( |
| Connection* connection, |
| const SuccessCallback& success_callback, |
| const ErrorCallback& error_callback) = 0; |
| |
| // Creates a default http::Transport (currently, using http::curl::Transport). |
| static std::shared_ptr<Transport> CreateDefault(); |
| |
| private: |
| DISALLOW_COPY_AND_ASSIGN(Transport); |
| }; |
| |
| } // namespace http |
| } // namespace chromeos |
| |
| #endif // LIBCHROMEOS_CHROMEOS_HTTP_HTTP_TRANSPORT_H_ |