src/Sockets/HttpPostSocket.h

   1 /** \file HttpPostSocket.h
   2  **     \date  2004-10-30
   3  **     \author grymse@alhem.net
   4 **/
   5 /*
   6 Copyright (C) 2004-2007  Anders Hedstrom
   7
   8 This library is made available under the terms of the GNU GPL.
   9
  10 If you would like to use this library in a closed-source application,
  11 a separate license agreement is available. For information about
  12 the closed-source license agreement for the C++ sockets library,
  13 please visit http://www.alhem.net/Sockets/license.html and/or
  14 email license@alhem.net.
  15
  16 This program is free software; you can redistribute it and/or
  17 modify it under the terms of the GNU General Public License
  18 as published by the Free Software Foundation; either version 2
  19 of the License, or (at your option) any later version.
  20
  21 This program is distributed in the hope that it will be useful,
  22 but WITHOUT ANY WARRANTY; without even the implied warranty of
  23 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  24 GNU General Public License for more details.
  25
  26 You should have received a copy of the GNU General Public License
  27 along with this program; if not, write to the Free Software
  28 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  29 */
  30 #ifndef _SOCKETS_HttpPostSocket_H
  31 #define _SOCKETS_HttpPostSocket_H
  32
  33 #include "sockets-config.h"
  34 #include "HttpClientSocket.h"
  35 #include "Mutex.h"
  36
  37 #ifdef SOCKETS_NAMESPACE
  38 namespace SOCKETS_NAMESPACE {
  39 #endif
  40
  41
  42 class ISocketHandler;
  43
  44 /** Generate a http post request, get response.
  45         \ingroup http */
  46 class HttpPostSocket : public HttpClientSocket
  47 {
  48 public:
  49         HttpPostSocket(ISocketHandler&);
  50         /* client constructor,
  51                 \param url_in = 'http://host:port/resource' */
  52         HttpPostSocket(ISocketHandler&,const std::string& url_in);
  53         ~HttpPostSocket();
  54
  55         // these must be specified before connecting / adding to handler
  56         /** Add field to post. */
  57         void AddField(const std::string& name,const std::string& value);
  58         /** Add multiline field to post. */
  59         void AddMultilineField(const std::string& name,std::list<std::string>& values);
  60         /** Add file to post. */
  61         void AddFile(const std::string& name,const std::string& filename,const std::string& type);
  62
  63         /** use this to post with content-type multipart/form-data.
  64         // when adding a file to the post, this is the default and only content-type */
  65         void SetMultipart();
  66
  67         /** connect to host:port derived from url in constructor */
  68         void Open();
  69
  70         /** http put client implemented in OnConnect */
  71         void OnConnect();
  72
  73 private:
  74         HttpPostSocket(const HttpPostSocket& s) : HttpClientSocket(s) {} // copy constructor
  75         HttpPostSocket& operator=(const HttpPostSocket& ) { return *this; } // assignment operator
  76         void DoMultipartPost();
  77         //
  78         std::map<std::string,std::list<std::string> > m_fields;
  79         std::map<std::string,std::string> m_files;
  80         std::string m_boundary;
  81         std::map<std::string,long> m_content_length;
  82         std::map<std::string,std::string> m_content_type;
  83         bool m_bMultipart;
  84 static  int m_boundary_count;
  85 static  Mutex m_boundary_mutex;
  86 };
  87
  88
  89 #ifdef SOCKETS_NAMESPACE
  90 }
  91 #endif
  92
  93 #endif // _SOCKETS_HttpPostSocket_H
  94