1*9712c20fSFrederick Mayle // Copyright 2006 Google LLC 2*9712c20fSFrederick Mayle // 3*9712c20fSFrederick Mayle // Redistribution and use in source and binary forms, with or without 4*9712c20fSFrederick Mayle // modification, are permitted provided that the following conditions are 5*9712c20fSFrederick Mayle // met: 6*9712c20fSFrederick Mayle // 7*9712c20fSFrederick Mayle // * Redistributions of source code must retain the above copyright 8*9712c20fSFrederick Mayle // notice, this list of conditions and the following disclaimer. 9*9712c20fSFrederick Mayle // * Redistributions in binary form must reproduce the above 10*9712c20fSFrederick Mayle // copyright notice, this list of conditions and the following disclaimer 11*9712c20fSFrederick Mayle // in the documentation and/or other materials provided with the 12*9712c20fSFrederick Mayle // distribution. 13*9712c20fSFrederick Mayle // * Neither the name of Google LLC nor the names of its 14*9712c20fSFrederick Mayle // contributors may be used to endorse or promote products derived from 15*9712c20fSFrederick Mayle // this software without specific prior written permission. 16*9712c20fSFrederick Mayle // 17*9712c20fSFrederick Mayle // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 18*9712c20fSFrederick Mayle // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT 19*9712c20fSFrederick Mayle // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR 20*9712c20fSFrederick Mayle // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT 21*9712c20fSFrederick Mayle // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, 22*9712c20fSFrederick Mayle // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT 23*9712c20fSFrederick Mayle // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, 24*9712c20fSFrederick Mayle // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY 25*9712c20fSFrederick Mayle // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 26*9712c20fSFrederick Mayle // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 27*9712c20fSFrederick Mayle // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 28*9712c20fSFrederick Mayle 29*9712c20fSFrederick Mayle #import <Foundation/Foundation.h> 30*9712c20fSFrederick Mayle 31*9712c20fSFrederick Mayle #import "HTTPRequest.h" 32*9712c20fSFrederick Mayle /** 33*9712c20fSFrederick Mayle Represents a multipart/form-data HTTP upload (POST request). 34*9712c20fSFrederick Mayle Each parameter pair is sent as a boundary. 35*9712c20fSFrederick Mayle Each file is sent with a name field in addition to the filename and data. 36*9712c20fSFrederick Mayle */ 37*9712c20fSFrederick Mayle @interface HTTPMultipartUpload : HTTPRequest { 38*9712c20fSFrederick Mayle @protected 39*9712c20fSFrederick Mayle NSDictionary* parameters_; // The key/value pairs for sending data (STRONG) 40*9712c20fSFrederick Mayle NSMutableDictionary* files_; // Dictionary of name/file-path (STRONG) 41*9712c20fSFrederick Mayle NSString* boundary_; // The boundary string (STRONG) 42*9712c20fSFrederick Mayle } 43*9712c20fSFrederick Mayle 44*9712c20fSFrederick Mayle /** 45*9712c20fSFrederick Mayle Sets the parameters that will be sent in the multipart POST request. 46*9712c20fSFrederick Mayle */ 47*9712c20fSFrederick Mayle - (void)setParameters:(NSDictionary*)parameters; 48*9712c20fSFrederick Mayle - (NSDictionary*)parameters; 49*9712c20fSFrederick Mayle 50*9712c20fSFrederick Mayle /** 51*9712c20fSFrederick Mayle Adds a file to be uploaded in the multipart POST request, by its file path. 52*9712c20fSFrederick Mayle */ 53*9712c20fSFrederick Mayle - (void)addFileAtPath:(NSString*)path name:(NSString*)name; 54*9712c20fSFrederick Mayle 55*9712c20fSFrederick Mayle /** 56*9712c20fSFrederick Mayle Adds a file to be uploaded in the multipart POST request, by its name and 57*9712c20fSFrederick Mayle contents. 58*9712c20fSFrederick Mayle */ 59*9712c20fSFrederick Mayle - (void)addFileContents:(NSData*)data name:(NSString*)name; 60*9712c20fSFrederick Mayle - (NSDictionary*)files; 61*9712c20fSFrederick Mayle 62*9712c20fSFrederick Mayle @end 63