grive2/libgrive/src/http/Agent.hh

/*
	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