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 <string>
#include "ResponseLog.hh"
#include "util/Types.hh"
#include "util/ProgressBar.hh"

namespace gr {

class SeekStream ;
class File ;

namespace http {

class Header ;

class Agent
{
protected:
	unsigned mMaxUpload, mMaxDownload ;

public :
	Agent() ;
	virtual ~Agent() {}

	virtual ResponseLog* GetLog() const = 0 ;
	virtual void SetLog( ResponseLog* ) = 0 ;

	virtual long Put(
		const std::string&	url,
		const std::string&	data,
		DataStream			*dest,
		const Header&		hdr ) ;

	virtual long Put(
		const std::string&	url,
		File				*file,
		DataStream			*dest,
		const Header&		hdr ) ;
		
	virtual long Get(
		const std::string& 	url,
		DataStream			*dest,
		const Header&		hdr,
		const long			downloadFileBytes = 0 ) ;
	
	virtual long Post(
		const std::string& 	url,
		const std::string&	data,
		DataStream			*dest,
		const Header&		hdr ) ;
	
	virtual long Request(
		const std::string&	method,
		const std::string&	url,
		SeekStream			*in,
		DataStream			*dest,
		const Header&		hdr,
		const long			downloadFileBytes = 0 ) = 0 ;
	
	virtual void SetUploadSpeed( unsigned kbytes ) ;
	virtual void SetDownloadSpeed( unsigned kbytes ) ;
	
	virtual std::string LastError() const = 0 ;
	virtual std::string LastErrorHeaders() const = 0 ;
	
	virtual std::string RedirLocation() const = 0 ;
	
	virtual std::string Escape( const std::string& str ) = 0 ;
	virtual std::string Unescape( const std::string& str ) = 0 ;

	virtual void SetProgressBar( ProgressBar* ) = 0;
} ;

} } // end of namespace