grive2/libgrive/src/http/Agent.hh

92 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 "Header.hh"
#include <memory>
#include <string>
#include <vector>
namespace gr { namespace http {
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() ;
void SetLogFile( const std::string& prefix ) ;
long Put(
const std::string& url,
const std::string& data,
Receivable *dest,
const Header& hdr = Header() ) ;
long Get(
const std::string& url,
Receivable *dest,
const Header& hdr = Header() ) ;
long Post(
const std::string& url,
const std::string& data,
Receivable *dest,
const Header& hdr = Header() ) ;
long Custom(
const std::string& method,
const std::string& url,
Receivable *dest,
const Header& hdr = Header() ) ;
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 Header& hdr ) ;
long ExecCurl(
const std::string& url,
Receivable *dest,
const Header& hdr ) ;
void Init() ;
private :
struct Impl ;
std::auto_ptr<Impl> m_pimpl ;
} ;
} } // end of namespace