mirror of
https://github.com/chromium/crashpad.git
synced 2025-03-10 06:36:02 +00:00
1aa478d161
This change was partially scripted and partially done manually with vim regex + manually placing the deleted constructors. The script change looked for destructors in the public: section of a class, if that existed the deleted constructors would go before the destructor. For manual placement I looked for any constructor in the public: section of the corresponding class. If there wasn't one, then it would ideally have gone as the first entry except below enums, classes and typedefs. This may not have been perfect, but is hopefully good enough. Fingers crossed. #include "base/macros.h" is removed from files that don't use ignore_result, which is the only other thing defined in base/macros.h. Bug: chromium:1010217 Change-Id: I099526255a40b1ac1264904b4ece2f3f503c9418 Reviewed-on: https://chromium-review.googlesource.com/c/crashpad/crashpad/+/3171034 Reviewed-by: Mark Mentovai <mark@chromium.org> Commit-Queue: Peter Boström <pbos@chromium.org>
122 lines
4.2 KiB
C++
122 lines
4.2 KiB
C++
// Copyright 2014 The Crashpad Authors. All rights reserved.
|
|
//
|
|
// Licensed under the Apache License, Version 2.0 (the "License");
|
|
// you may not use this file except in compliance with the License.
|
|
// You may obtain a copy of the License at
|
|
//
|
|
// http://www.apache.org/licenses/LICENSE-2.0
|
|
//
|
|
// Unless required by applicable law or agreed to in writing, software
|
|
// distributed under the License is distributed on an "AS IS" BASIS,
|
|
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
// See the License for the specific language governing permissions and
|
|
// limitations under the License.
|
|
|
|
#ifndef CRASHPAD_UTIL_NET_HTTP_TRANSPORT_H_
|
|
#define CRASHPAD_UTIL_NET_HTTP_TRANSPORT_H_
|
|
|
|
#include <memory>
|
|
#include <string>
|
|
|
|
#include "base/files/file_path.h"
|
|
#include "util/net/http_headers.h"
|
|
|
|
namespace crashpad {
|
|
|
|
class HTTPBodyStream;
|
|
|
|
//! \brief HTTPTransport executes a HTTP request using the specified URL, HTTP
|
|
//! method, headers, and body. This class can only issue a synchronous
|
|
//! HTTP request.
|
|
//!
|
|
//! This class cannot be instantiated directly. A concrete subclass must be
|
|
//! instantiated instead, which provides an implementation to execute the
|
|
//! request that is appropriate for the host operating system.
|
|
class HTTPTransport {
|
|
public:
|
|
HTTPTransport(const HTTPTransport&) = delete;
|
|
HTTPTransport& operator=(const HTTPTransport&) = delete;
|
|
|
|
virtual ~HTTPTransport();
|
|
|
|
//! \brief Instantiates a concrete HTTPTransport class for the current
|
|
//! operating system.
|
|
//!
|
|
//! \return A new caller-owned HTTPTransport object.
|
|
static std::unique_ptr<HTTPTransport> Create();
|
|
|
|
//! \brief Sets URL to which the request will be made.
|
|
//!
|
|
//! \param[in] url The request URL.
|
|
void SetURL(const std::string& url);
|
|
|
|
//! \brief Sets the HTTP method to execute. E.g., GET, POST, etc. The default
|
|
//! method is `"POST"`.
|
|
//!
|
|
//! \param[in] http_method The HTTP method.
|
|
void SetMethod(const std::string& http_method);
|
|
|
|
//! \brief Sets a HTTP header-value pair.
|
|
//!
|
|
//! \param[in] header The HTTP header name. Any previous value set at this
|
|
//! name will be overwritten.
|
|
//! \param[in] value The value to set for the header.
|
|
void SetHeader(const std::string& header, const std::string& value);
|
|
|
|
//! \brief Sets the stream object from which to generate the HTTP body.
|
|
//!
|
|
//! \param[in] stream A HTTPBodyStream, of which this class will take
|
|
//! ownership.
|
|
void SetBodyStream(std::unique_ptr<HTTPBodyStream> stream);
|
|
|
|
//! \brief Sets the timeout for the HTTP request. The default is 15 seconds.
|
|
//!
|
|
//! \param[in] timeout The request timeout, in seconds.
|
|
void SetTimeout(double timeout);
|
|
|
|
//! \brief Sets a certificate file to be used in lieu of the system CA cert
|
|
//! bundle.
|
|
//!
|
|
//! This is exposed primarily for testing with a self-signed certificate, and
|
|
//! it isn't necessary to set it in normal use.
|
|
//!
|
|
//! \param[in] cert The filename of a file in PEM format containing the CA
|
|
//! cert to be used for TLS connections.
|
|
void SetRootCACertificatePath(const base::FilePath& cert);
|
|
|
|
//! \brief Performs the HTTP request with the configured parameters and waits
|
|
//! for the execution to complete.
|
|
//!
|
|
//! \param[out] response_body On success, this will be set to the HTTP
|
|
//! response body. This parameter is optional and may be set to `nullptr`
|
|
//! if the response body is not required.
|
|
//!
|
|
//! \return Whether or not the request was successful, defined as returning
|
|
//! a HTTP status code in the range 200-203 (inclusive).
|
|
virtual bool ExecuteSynchronously(std::string* response_body) = 0;
|
|
|
|
protected:
|
|
HTTPTransport();
|
|
|
|
const std::string& url() const { return url_; }
|
|
const std::string& method() const { return method_; }
|
|
const HTTPHeaders& headers() const { return headers_; }
|
|
HTTPBodyStream* body_stream() const { return body_stream_.get(); }
|
|
double timeout() const { return timeout_; }
|
|
const base::FilePath& root_ca_certificate_path() const {
|
|
return root_ca_certificate_path_;
|
|
}
|
|
|
|
private:
|
|
std::string url_;
|
|
std::string method_;
|
|
base::FilePath root_ca_certificate_path_;
|
|
HTTPHeaders headers_;
|
|
std::unique_ptr<HTTPBodyStream> body_stream_;
|
|
double timeout_;
|
|
};
|
|
|
|
} // namespace crashpad
|
|
|
|
#endif // CRASHPAD_UTIL_NET_HTTP_TRANSPORT_H_
|