An abstraction to Lib Curl functions. More...

#include <CurlWrapper.h>

Classes
class	CurlGlobalScope
	RAII class to init curl. More...

Public Member Functions
	CurlWrapper ()

	CurlWrapper (CurlWrapper &&other)

virtual void	customRequest (const te::core::URI &uri, const std::string &request, const std::string &body=std::string(""), const ::std::string &header=std::string(""))
	Method to make a custom request, useful for performing a HTTP DELETE request. More...

virtual void	downloadFile (const std::string &url, const std::string &filePath, te::common::TaskProgress *taskProgress=0)
	Method to download a file retrieved from given URL and save into the specified file path. More...

virtual void	downloadFile (const std::string &url, std::FILE file, te::common::TaskProgress taskProgress=0)
	Method to download a file retrieved from given URL and save into the specified File. More...

virtual void	get (const te::core::URI &uri, std::string &buffer)
	Method to make a GET request. More...

virtual AuthenticationMethod	getAuthenticationMethod () const
	Gets current AuthenticationMethod. More...

virtual std::string	getTaskMessage () const
	This method gets the message that will be used on Progress Bar when this object is downloading some file. More...

virtual std::string	getUsername () const
	Gets the user name that will be used when an athentication method is set. More...

virtual std::vector< std::string >	listFiles (const te::core::URI &uri)
	Method to list files in a URI. More...

virtual void	post (const te::core::URI &uri, const std::string &postFields, const ::std::string &header)
	Method to request a post in a determined URI. More...

virtual void	putFile (const te::core::URI &uri, const std::string &filePath, const ::std::string &header, te::common::TaskProgress *taskProgress=0)
	Method to request a put with a file in a determined URI. More...

virtual void	putFile (const te::core::URI &uri, FILE file, const ::std::string &header, te::common::TaskProgress taskProgress=0, const long &fileSize=0L)
	Method to request a put a file in a determined URI. More...

virtual const std::string &	response () const
	Returns the last operation response if the protocol allows it. More...

virtual const long	responseCode () const
	Returns the last operation response code. More...

virtual void	setAuthenticationMethod (const AuthenticationMethod &method)
	Sets the authentication method that will be used on the requests. More...

virtual void	setPassword (const std::string &password)
	Sets the password that will be used when an athentication method is set. More...

virtual void	setTaskMessage (const std::string &taskMessage)
	This method sets the message that will be used on Progress Bar when this object is downloading some file. More...

virtual void	setUsername (const std::string &username)
	Sets the user name that will be used when an athentication method is set. More...

virtual void	verifyURL (std::string url, uint32_t timeout) const
	Verify if the URI is reacheble. More...

virtual	~CurlWrapper ()

Protected Member Functions
virtual void	addAuthParameters ()
	Adds HTTP Authentication parameters according to the current AuthenticationMethod. More...

virtual void	clean ()
	Reset the curl handle and the class members. More...

virtual void	downloadFile_ (const std::string &url, std::FILE file, te::common::TaskProgress taskProgress=0)
	Private unsafe method to download a file retrieved from given URL and save into the specified File. More...

std::unique_lock< std::mutex >	getLock ()

virtual std::vector< std::string >	listFiles_ (const te::core::URI &uri)
	Private unsafe method to list files in a URI. More...

void	setOption (int option, std::string value)

void	setOption (int option, char *value)

void	setOption (int option, int value)

Private Attributes
std::unique_ptr< Impl >	m_pimpl

Static Private Attributes
static CurlGlobalScope	curlScope_

Detailed Description

An abstraction to Lib Curl functions.

Definition at line 61 of file CurlWrapper.h.

Constructor & Destructor Documentation

te::ws::core::CurlWrapper::CurlWrapper ( )

te::ws::core::CurlWrapper::CurlWrapper ( CurlWrapper && other )

virtual te::ws::core::CurlWrapper::~CurlWrapper ( )

virtual

Member Function Documentation

virtual void te::ws::core::CurlWrapper::addAuthParameters ( )

protectedvirtual

Adds HTTP Authentication parameters according to the current AuthenticationMethod.

virtual void te::ws::core::CurlWrapper::clean ( )

protectedvirtual

Reset the curl handle and the class members.

virtual void te::ws::core::CurlWrapper::customRequest	(	const te::core::URI &	uri,
		const std::string &	request,
		const std::string &	body = `std::string("")`,
		const ::std::string &	header = `std::string("")`
	)

virtual

Method to make a custom request, useful for performing a HTTP DELETE request.

Parameters

uri	The URI with the address information
request	The custom request

virtual void te::ws::core::CurlWrapper::downloadFile	(	const std::string &	url,
		const std::string &	filePath,
		te::common::TaskProgress *	taskProgress = `0`
	)

virtual

Method to download a file retrieved from given URL and save into the specified file path.

Parameters

url	URL that the file will be downloaded.
filePath	file path where downloaded file will be saved.

virtual void te::ws::core::CurlWrapper::downloadFile	(	const std::string &	url,
		std::FILE *	file,
		te::common::TaskProgress *	taskProgress = `0`
	)

virtual

Method to download a file retrieved from given URL and save into the specified File.

Parameters

url	URL that the file will be downloaded.
file	File where downloaded file will be write.

virtual void te::ws::core::CurlWrapper::downloadFile_	(	const std::string &	url,
		std::FILE *	file,
		te::common::TaskProgress *	taskProgress = `0`
	)

protectedvirtual

Private unsafe method to download a file retrieved from given URL and save into the specified File.

Warning: NOT thread safe, call getLock() to acquire lock before using.; NOT CURL safe, call clean() before using

Parameters

url	URL that the file will be downloaded.
file	File where downloaded file will be write.

virtual void te::ws::core::CurlWrapper::get	(	const te::core::URI &	uri,
		std::string &	buffer
	)

virtual

Method to make a GET request.

Parameters

uri	The URI with the address information
buffer	Where the server answer will be write.

virtual AuthenticationMethod te::ws::core::CurlWrapper::getAuthenticationMethod ( ) const

virtual

Gets current AuthenticationMethod.

Returns: current AuthenticationMethod.

std::unique_lock<std::mutex> te::ws::core::CurlWrapper::getLock ( )

protected

virtual std::string te::ws::core::CurlWrapper::getTaskMessage ( ) const

virtual

This method gets the message that will be used on Progress Bar when this object is downloading some file.

virtual std::string te::ws::core::CurlWrapper::getUsername ( ) const

virtual

Gets the user name that will be used when an athentication method is set.

Returns: username

virtual std::vector<std::string> te::ws::core::CurlWrapper::listFiles ( const te::core::URI & uri )

virtual

Method to list files in a URI.

Parameters

url	URL that the files will be listed.

virtual std::vector<std::string> te::ws::core::CurlWrapper::listFiles_ ( const te::core::URI & uri )

protectedvirtual

Private unsafe method to list files in a URI.

Warning: NOT thread safe, call getLock() to acquire lock before using.; NOT CURL safe, call clean() before using

Parameters

url	URL that the files will be listed.

virtual void te::ws::core::CurlWrapper::post	(	const te::core::URI &	uri,
		const std::string &	postFields,
		const ::std::string &	header
	)

virtual

Method to request a post in a determined URI.

Parameters

uri	The URI with the address information to post
postFields	The parameters and values to post
header	A header to the post request

virtual void te::ws::core::CurlWrapper::putFile	(	const te::core::URI &	uri,
		const std::string &	filePath,
		const ::std::string &	header,
		te::common::TaskProgress *	taskProgress = `0`
	)

virtual

Method to request a put with a file in a determined URI.

Parameters

uri	The URI with the address information
file	Path The full path of the file to put
header	A header to the put request

virtual void te::ws::core::CurlWrapper::putFile	(	const te::core::URI &	uri,
		FILE *	file,
		const ::std::string &	header,
		te::common::TaskProgress *	taskProgress = `0`,
		const long &	fileSize = `0L`
	)

virtual

Method to request a put a file in a determined URI.

Parameters

uri	The URI with the address information
file	Contains the file opened by the fstream
header	A header to the put request

virtual const std::string& te::ws::core::CurlWrapper::response ( ) const

virtual

Returns the last operation response if the protocol allows it.

Returns: The response

virtual const long te::ws::core::CurlWrapper::responseCode ( ) const

virtual

Returns the last operation response code.

Returns: The response code

virtual void te::ws::core::CurlWrapper::setAuthenticationMethod ( const AuthenticationMethod & method )

virtual

Sets the authentication method that will be used on the requests.

Parameters

method (e. g.: Basic or Digest)

void te::ws::core::CurlWrapper::setOption	(	int	option,
		std::string	value
	)

protected

void te::ws::core::CurlWrapper::setOption	(	int	option,
		char *	value
	)

protected

void te::ws::core::CurlWrapper::setOption	(	int	option,
		int	value
	)

protected

virtual void te::ws::core::CurlWrapper::setPassword ( const std::string & password )

virtual

Sets the password that will be used when an athentication method is set.

Parameters

password

virtual void te::ws::core::CurlWrapper::setTaskMessage ( const std::string & taskMessage )

virtual

This method sets the message that will be used on Progress Bar when this object is downloading some file.

Parameters

taskMessage new message.

virtual void te::ws::core::CurlWrapper::setUsername ( const std::string & username )

virtual

Sets the user name that will be used when an athentication method is set.

Parameters

username

virtual void te::ws::core::CurlWrapper::verifyURL	(	std::string	url,
		uint32_t	timeout
	)		const

virtual

Verify if the URI is reacheble.

Exceptions

te::ws::core::Exception Rise if the URI cannot be reached.

Member Data Documentation

CurlGlobalScope te::ws::core::CurlWrapper::curlScope_

staticprivate

Definition at line 259 of file CurlWrapper.h.

std::unique_ptr<Impl> te::ws::core::CurlWrapper::m_pimpl

private

Definition at line 238 of file CurlWrapper.h.

The documentation for this class was generated from the following file:

/home/castejon/castejon_files/develop/terralib5/git_master/src/terralib/ws/core/CurlWrapper.h

Classes

Public Member Functions

Protected Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation