toolkit/crashreporter/google-breakpad/src/common/linux/http_upload.h

changeset 0
6474c204b198
     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> &parameters,
    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> &parameters);
    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__

mercurial