1.1 --- /dev/null Thu Jan 01 00:00:00 1970 +0000
1.2 +++ b/toolkit/crashreporter/google-breakpad/src/common/windows/http_upload.h Wed Dec 31 06:09:35 2014 +0100
1.3 @@ -0,0 +1,126 @@
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 wininet. 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_WINDOWS_HTTP_UPLOAD_H__
1.38 +#define COMMON_WINDOWS_HTTP_UPLOAD_H__
1.39 +
1.40 +#pragma warning( push )
1.41 +// Disable exception handler warnings.
1.42 +#pragma warning( disable : 4530 )
1.43 +
1.44 +#include <Windows.h>
1.45 +#include <WinInet.h>
1.46 +
1.47 +#include <map>
1.48 +#include <string>
1.49 +#include <vector>
1.50 +
1.51 +namespace google_breakpad {
1.52 +
1.53 +using std::string;
1.54 +using std::wstring;
1.55 +using std::map;
1.56 +using std::vector;
1.57 +
1.58 +class HTTPUpload {
1.59 + public:
1.60 + // Sends the given set of parameters, along with the contents of
1.61 + // upload_file, as a multipart POST request to the given URL.
1.62 + // file_part_name contains the name of the file part of the request
1.63 + // (i.e. it corresponds to the name= attribute on an <input type="file">.
1.64 + // Parameter names must contain only printable ASCII characters,
1.65 + // and may not contain a quote (") character.
1.66 + // Only HTTP(S) URLs are currently supported. Returns true on success.
1.67 + // If the request is successful and response_body is non-NULL,
1.68 + // the response body will be returned in response_body.
1.69 + // If response_code is non-NULL, it will be set to the HTTP response code
1.70 + // received (or 0 if the request failed before getting an HTTP response).
1.71 + static bool SendRequest(const wstring &url,
1.72 + const map<wstring, wstring> ¶meters,
1.73 + const wstring &upload_file,
1.74 + const wstring &file_part_name,
1.75 + int *timeout,
1.76 + wstring *response_body,
1.77 + int *response_code);
1.78 +
1.79 + private:
1.80 + class AutoInternetHandle;
1.81 +
1.82 + // Retrieves the HTTP response. If NULL is passed in for response,
1.83 + // this merely checks (via the return value) that we were successfully
1.84 + // able to retrieve exactly as many bytes of content in the response as
1.85 + // were specified in the Content-Length header.
1.86 + static bool HTTPUpload::ReadResponse(HINTERNET request, wstring* response);
1.87 +
1.88 + // Generates a new multipart boundary for a POST request
1.89 + static wstring GenerateMultipartBoundary();
1.90 +
1.91 + // Generates a HTTP request header for a multipart form submit.
1.92 + static wstring GenerateRequestHeader(const wstring &boundary);
1.93 +
1.94 + // Given a set of parameters, an upload filename, and a file part name,
1.95 + // generates a multipart request body string with these parameters
1.96 + // and minidump contents. Returns true on success.
1.97 + static bool GenerateRequestBody(const map<wstring, wstring> ¶meters,
1.98 + const wstring &upload_file,
1.99 + const wstring &file_part_name,
1.100 + const wstring &boundary,
1.101 + string *request_body);
1.102 +
1.103 + // Fills the supplied vector with the contents of filename.
1.104 + static bool GetFileContents(const wstring &filename, vector<char> *contents);
1.105 +
1.106 + // Converts a UTF8 string to UTF16.
1.107 + static wstring UTF8ToWide(const string &utf8);
1.108 +
1.109 + // Converts a UTF16 string to UTF8.
1.110 + static string WideToUTF8(const wstring &wide);
1.111 +
1.112 + // Checks that the given list of parameters has only printable
1.113 + // ASCII characters in the parameter name, and does not contain
1.114 + // any quote (") characters. Returns true if so.
1.115 + static bool CheckParameters(const map<wstring, wstring> ¶meters);
1.116 +
1.117 + // No instances of this class should be created.
1.118 + // Disallow all constructors, destructors, and operator=.
1.119 + HTTPUpload();
1.120 + explicit HTTPUpload(const HTTPUpload &);
1.121 + void operator=(const HTTPUpload &);
1.122 + ~HTTPUpload();
1.123 +};
1.124 +
1.125 +} // namespace google_breakpad
1.126 +
1.127 +#pragma warning( pop )
1.128 +
1.129 +#endif // COMMON_WINDOWS_HTTP_UPLOAD_H__
