1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000 1.2 +++ b/toolkit/crashreporter/google-breakpad/src/common/linux/http_upload.h Wed Dec 31 06:09:35 2014 +0100 1.3 @@ -0,0 +1,88 @@ 1.4 +// Copyright (c) 2006, Google Inc. 1.5 +// All rights reserved. 1.6 +// 1.7 +// Redistribution and use in source and binary forms, with or without 1.8 +// modification, are permitted provided that the following conditions are 1.9 +// met: 1.10 +// 1.11 +// * Redistributions of source code must retain the above copyright 1.12 +// notice, this list of conditions and the following disclaimer. 1.13 +// * Redistributions in binary form must reproduce the above 1.14 +// copyright notice, this list of conditions and the following disclaimer 1.15 +// in the documentation and/or other materials provided with the 1.16 +// distribution. 1.17 +// * Neither the name of Google Inc. nor the names of its 1.18 +// contributors may be used to endorse or promote products derived from 1.19 +// this software without specific prior written permission. 1.20 +// 1.21 +// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 1.22 +// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 1.23 +// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 1.24 +// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 1.25 +// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 1.26 +// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 1.27 +// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 1.28 +// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 1.29 +// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 1.30 +// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 1.31 +// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 1.32 + 1.33 +// HTTPUpload provides a "nice" API to send a multipart HTTP(S) POST 1.34 +// request using libcurl. It currently supports requests that contain 1.35 +// a set of string parameters (key/value pairs), and a file to upload. 1.36 + 1.37 +#ifndef COMMON_LINUX_HTTP_UPLOAD_H__ 1.38 +#define COMMON_LINUX_HTTP_UPLOAD_H__ 1.39 + 1.40 +#include <map> 1.41 +#include <string> 1.42 + 1.43 +#include "common/using_std_string.h" 1.44 + 1.45 +namespace google_breakpad { 1.46 + 1.47 +using std::map; 1.48 + 1.49 +class HTTPUpload { 1.50 + public: 1.51 + // Sends the given set of parameters, along with the contents of 1.52 + // upload_file, as a multipart POST request to the given URL. 1.53 + // file_part_name contains the name of the file part of the request 1.54 + // (i.e. it corresponds to the name= attribute on an <input type="file">. 1.55 + // Parameter names must contain only printable ASCII characters, 1.56 + // and may not contain a quote (") character. 1.57 + // Only HTTP(S) URLs are currently supported. Returns true on success. 1.58 + // If the request is successful and response_body is non-NULL, 1.59 + // the response body will be returned in response_body. 1.60 + // If response_code is non-NULL, it will be set to the HTTP response code 1.61 + // received (or 0 if the request failed before getting an HTTP response). 1.62 + // If the send fails, a description of the error will be 1.63 + // returned in error_description. 1.64 + static bool SendRequest(const string &url, 1.65 + const map<string, string> ¶meters, 1.66 + const string &upload_file, 1.67 + const string &file_part_name, 1.68 + const string &proxy, 1.69 + const string &proxy_user_pwd, 1.70 + const string &ca_certificate_file, 1.71 + string *response_body, 1.72 + long *response_code, 1.73 + string *error_description); 1.74 + 1.75 + private: 1.76 + // Checks that the given list of parameters has only printable 1.77 + // ASCII characters in the parameter name, and does not contain 1.78 + // any quote (") characters. Returns true if so. 1.79 + static bool CheckParameters(const map<string, string> ¶meters); 1.80 + 1.81 + // No instances of this class should be created. 1.82 + // Disallow all constructors, destructors, and operator=. 1.83 + HTTPUpload(); 1.84 + explicit HTTPUpload(const HTTPUpload &); 1.85 + void operator=(const HTTPUpload &); 1.86 + ~HTTPUpload(); 1.87 +}; 1.88 + 1.89 +} // namespace google_breakpad 1.90 + 1.91 +#endif // COMMON_LINUX_HTTP_UPLOAD_H__