michael@0: // Copyright (c) 2006, Google Inc. michael@0: // All rights reserved. michael@0: // michael@0: // Redistribution and use in source and binary forms, with or without michael@0: // modification, are permitted provided that the following conditions are michael@0: // met: michael@0: // michael@0: // * Redistributions of source code must retain the above copyright michael@0: // notice, this list of conditions and the following disclaimer. michael@0: // * Redistributions in binary form must reproduce the above michael@0: // copyright notice, this list of conditions and the following disclaimer michael@0: // in the documentation and/or other materials provided with the michael@0: // distribution. michael@0: // * Neither the name of Google Inc. nor the names of its michael@0: // contributors may be used to endorse or promote products derived from michael@0: // this software without specific prior written permission. michael@0: // michael@0: // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS michael@0: // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT michael@0: // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR michael@0: // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT michael@0: // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, michael@0: // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT michael@0: // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, michael@0: // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY michael@0: // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT michael@0: // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE michael@0: // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. michael@0: michael@0: // HTTPUpload provides a "nice" API to send a multipart HTTP(S) POST michael@0: // request using wininet. It currently supports requests that contain michael@0: // a set of string parameters (key/value pairs), and a file to upload. michael@0: michael@0: #ifndef COMMON_WINDOWS_HTTP_UPLOAD_H__ michael@0: #define COMMON_WINDOWS_HTTP_UPLOAD_H__ michael@0: michael@0: #pragma warning( push ) michael@0: // Disable exception handler warnings. michael@0: #pragma warning( disable : 4530 ) michael@0: michael@0: #include michael@0: #include michael@0: michael@0: #include michael@0: #include michael@0: #include michael@0: michael@0: namespace google_breakpad { michael@0: michael@0: using std::string; michael@0: using std::wstring; michael@0: using std::map; michael@0: using std::vector; michael@0: michael@0: class HTTPUpload { michael@0: public: michael@0: // Sends the given set of parameters, along with the contents of michael@0: // upload_file, as a multipart POST request to the given URL. michael@0: // file_part_name contains the name of the file part of the request michael@0: // (i.e. it corresponds to the name= attribute on an . michael@0: // Parameter names must contain only printable ASCII characters, michael@0: // and may not contain a quote (") character. michael@0: // Only HTTP(S) URLs are currently supported. Returns true on success. michael@0: // If the request is successful and response_body is non-NULL, michael@0: // the response body will be returned in response_body. michael@0: // If response_code is non-NULL, it will be set to the HTTP response code michael@0: // received (or 0 if the request failed before getting an HTTP response). michael@0: static bool SendRequest(const wstring &url, michael@0: const map ¶meters, michael@0: const wstring &upload_file, michael@0: const wstring &file_part_name, michael@0: int *timeout, michael@0: wstring *response_body, michael@0: int *response_code); michael@0: michael@0: private: michael@0: class AutoInternetHandle; michael@0: michael@0: // Retrieves the HTTP response. If NULL is passed in for response, michael@0: // this merely checks (via the return value) that we were successfully michael@0: // able to retrieve exactly as many bytes of content in the response as michael@0: // were specified in the Content-Length header. michael@0: static bool HTTPUpload::ReadResponse(HINTERNET request, wstring* response); michael@0: michael@0: // Generates a new multipart boundary for a POST request michael@0: static wstring GenerateMultipartBoundary(); michael@0: michael@0: // Generates a HTTP request header for a multipart form submit. michael@0: static wstring GenerateRequestHeader(const wstring &boundary); michael@0: michael@0: // Given a set of parameters, an upload filename, and a file part name, michael@0: // generates a multipart request body string with these parameters michael@0: // and minidump contents. Returns true on success. michael@0: static bool GenerateRequestBody(const map ¶meters, michael@0: const wstring &upload_file, michael@0: const wstring &file_part_name, michael@0: const wstring &boundary, michael@0: string *request_body); michael@0: michael@0: // Fills the supplied vector with the contents of filename. michael@0: static bool GetFileContents(const wstring &filename, vector *contents); michael@0: michael@0: // Converts a UTF8 string to UTF16. michael@0: static wstring UTF8ToWide(const string &utf8); michael@0: michael@0: // Converts a UTF16 string to UTF8. michael@0: static string WideToUTF8(const wstring &wide); michael@0: michael@0: // Checks that the given list of parameters has only printable michael@0: // ASCII characters in the parameter name, and does not contain michael@0: // any quote (") characters. Returns true if so. michael@0: static bool CheckParameters(const map ¶meters); michael@0: michael@0: // No instances of this class should be created. michael@0: // Disallow all constructors, destructors, and operator=. michael@0: HTTPUpload(); michael@0: explicit HTTPUpload(const HTTPUpload &); michael@0: void operator=(const HTTPUpload &); michael@0: ~HTTPUpload(); michael@0: }; michael@0: michael@0: } // namespace google_breakpad michael@0: michael@0: #pragma warning( pop ) michael@0: michael@0: #endif // COMMON_WINDOWS_HTTP_UPLOAD_H__