grive2/libgrive/src/http/HTTP.hh

85 lines
2.2 KiB
C++

/*
grive: an GPL program to sync a local directory with Google Drive
Copyright (C) 2012 Wan Wai Ho
This program is free software; you can redistribute it and/or
modify it under the terms of the GNU General Public License
as published by the Free Software Foundation version 2
of the License.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
*/
#pragma once
#include <memory>
#include <string>
#include <vector>
namespace gr { namespace http {
typedef std::vector<std::string> Headers ;
class Receivable ;
/*! \class Agent
\brief class to provide HTTP access
This class provides functions to send HTTP request in many methods (e.g. get, post and put).
Normally the HTTP response is returned in a Receivable.
*/
class Agent
{
public :
Agent() ;
~Agent() ;
// TODO: implement put from file, or some callback interface to pull data
long Put(
const std::string& url,
const std::string& data,
Receivable *dest,
const http::Headers& hdr = http::Headers() ) ;
long Get(
const std::string& url,
Receivable *dest,
const http::Headers& hdr = http::Headers() ) ;
long Post(
const std::string& url,
const std::string& data,
Receivable *dest,
const http::Headers& hdr = http::Headers() ) ;
long Custom(
const std::string& method,
const std::string& url,
Receivable *dest,
const http::Headers& hdr = http::Headers() ) ;
std::string RedirLocation() const ;
std::string Escape( const std::string& str ) ;
std::string Unescape( const std::string& str ) ;
private :
static std::size_t HeaderCallback( void *ptr, size_t size, size_t nmemb, Agent *pthis ) ;
static std::size_t Receive( void* ptr, size_t size, size_t nmemb, Receivable *recv ) ;
void SetHeader( const http::Headers& hdr ) ;
private :
struct Impl ;
std::auto_ptr<Impl> m_pimpl ;
} ;
} } // end of namespace