A class to send XML RPC requests to a server and return the results. More...

#include <XmlRpcClient.h>

Inheritance diagram for XmlRpc::XmlRpcClient:

Public Member Functions
virtual void	close ()
	Close the connection. More...

bool	execute (const char *method, XmlRpcValue const &params, XmlRpcValue &result)

bool	executeCheckDone (XmlRpcValue &result)

bool	executeNonBlock (const char *method, XmlRpcValue const &params)

const std::string &	getHost ()

int	getPort () const

const std::string &	getUri ()

virtual unsigned	handleEvent (unsigned eventType)

bool	isFault () const
	Returns true if the result of the last execute() was a fault response. More...

	XmlRpcClient (const char host, int port, const char uri=0)

virtual	~XmlRpcClient ()
	Destructor. More...

Public Member Functions inherited from XmlRpc::XmlRpcSource
int	getfd () const
	Return the file descriptor being monitored. More...

bool	getKeepOpen () const
	Return whether the file descriptor should be kept open if it is no longer monitored. More...

void	setfd (int fd)
	Specify the file descriptor to monitor. More...

void	setKeepOpen (bool b=true)
	Specify whether the file descriptor should be kept open if it is no longer monitored. More...

	XmlRpcSource (int fd=-1, bool deleteOnClose=false)

virtual	~XmlRpcSource ()
	Destructor. More...

Public Attributes
int	_bytesWritten

int	_contentLength

XmlRpcDispatch	_disp

bool	_eof

bool	_executing

std::string	_header

bool	_isFault

std::string	_request

std::string	_response

int	_sendAttempts

Static Public Attributes
static const char	FAULT_TAG [] = "<fault>"

static const char	METHODRESPONSE_TAG [] = "<methodResponse>"

static const char	PARAM_ETAG [] = "</param>"

static const char	PARAM_TAG [] = "<param>"

static const char	PARAMS_ETAG [] = "</params>"

static const char	PARAMS_TAG [] = "<params>"

static const char	REQUEST_BEGIN []

static const char	REQUEST_END [] = "</methodCall>\r\n"

static const char	REQUEST_END_METHODNAME [] = "</methodName>\r\n"

Protected Types
enum	ClientConnectionState { NO_CONNECTION, CONNECTING, WRITE_REQUEST, READ_HEADER, READ_RESPONSE, IDLE }

Protected Member Functions
virtual bool	doConnect ()

virtual std::string	generateHeader (size_t length) const

virtual bool	generateRequest (const char *method, XmlRpcValue const &params)

virtual bool	parseResponse (XmlRpcValue &result)

virtual bool	readHeader ()

virtual bool	readResponse ()

virtual bool	setupConnection ()

virtual bool	writeRequest ()

Static Protected Member Functions
static const char *	connectionStateStr (ClientConnectionState state)

Protected Attributes
ClientConnectionState	_connectionState

std::string	_host

int	_port

std::string	_uri

Detailed Description

A class to send XML RPC requests to a server and return the results.

Definition at line 26 of file XmlRpcClient.h.

Member Enumeration Documentation

enum XmlRpc::XmlRpcClient::ClientConnectionState

protected

Enumerator
NO_CONNECTION
CONNECTING
WRITE_REQUEST
READ_HEADER
READ_RESPONSE
IDLE

Definition at line 90 of file XmlRpcClient.h.

Constructor & Destructor Documentation

XmlRpcClient::XmlRpcClient	(	const char *	host,
		int	port,
		const char *	uri = `0`
	)

Construct a client to connect to the server at the specified host:port address

Parameters

host	The name of the remote machine hosting the server
port	The port on the remote machine where the server is listening
uri	An optional string to be sent as the URI in the HTTP GET header

Definition at line 51 of file XmlRpcClient.cpp.

XmlRpcClient::~XmlRpcClient ( )

virtual

Destructor.

Definition at line 74 of file XmlRpcClient.cpp.

Member Function Documentation

void XmlRpcClient::close ( )

virtual

Close the connection.

Reimplemented from XmlRpc::XmlRpcSource.

Definition at line 81 of file XmlRpcClient.cpp.

const char * XmlRpcClient::connectionStateStr ( ClientConnectionState state )

staticprotected

Definition at line 32 of file XmlRpcClient.cpp.

bool XmlRpcClient::doConnect ( )

protectedvirtual

Definition at line 250 of file XmlRpcClient.cpp.

bool XmlRpcClient::execute	(	const char *	method,
		XmlRpcValue const &	params,
		XmlRpcValue &	result
	)

Execute the named procedure on the remote server.

Parameters

method	The name of the remote procedure to execute
params	An array of the arguments for the method
result	The result value to be returned to the client

Returns: true if the request was sent and a result received (although the result might be a fault).

Currently this is a synchronous (blocking) implementation (execute does not return until it receives a response or an error). Use isFault() to determine whether the result is a fault response.

Definition at line 103 of file XmlRpcClient.cpp.

bool XmlRpcClient::executeCheckDone ( XmlRpcValue & result )

Definition at line 168 of file XmlRpcClient.cpp.

bool XmlRpcClient::executeNonBlock	(	const char *	method,
		XmlRpcValue const &	params
	)

Definition at line 142 of file XmlRpcClient.cpp.

std::string XmlRpcClient::generateHeader ( size_t length ) const

protectedvirtual

Definition at line 320 of file XmlRpcClient.cpp.

bool XmlRpcClient::generateRequest	(	const char *	method,
		XmlRpcValue const &	params
	)

protectedvirtual

Definition at line 282 of file XmlRpcClient.cpp.

const std::string& XmlRpc::XmlRpcClient::getHost ( )

inline

Definition at line 100 of file XmlRpcClient.h.

int XmlRpc::XmlRpcClient::getPort ( ) const

inline

Definition at line 102 of file XmlRpcClient.h.

const std::string& XmlRpc::XmlRpcClient::getUri ( )

inline

Definition at line 101 of file XmlRpcClient.h.

unsigned XmlRpcClient::handleEvent ( unsigned eventType )

virtual

Handle server responses. Called by the event dispatcher during execute.

Parameters

eventType The type of event that occurred.

See also: XmlRpcDispatch::EventType

Implements XmlRpc::XmlRpcSource.

Definition at line 194 of file XmlRpcClient.cpp.

bool XmlRpc::XmlRpcClient::isFault ( ) const

inline

Returns true if the result of the last execute() was a fault response.

Definition at line 65 of file XmlRpcClient.h.

bool XmlRpcClient::parseResponse ( XmlRpcValue & result )

protectedvirtual

Definition at line 492 of file XmlRpcClient.cpp.

bool XmlRpcClient::readHeader ( )

protectedvirtual

Definition at line 373 of file XmlRpcClient.cpp.

bool XmlRpcClient::readResponse ( )

protectedvirtual

Definition at line 453 of file XmlRpcClient.cpp.

bool XmlRpcClient::setupConnection ( )

protectedvirtual

Definition at line 225 of file XmlRpcClient.cpp.

bool XmlRpcClient::writeRequest ( )

protectedvirtual

Definition at line 341 of file XmlRpcClient.cpp.

Member Data Documentation

int XmlRpc::XmlRpcClient::_bytesWritten

Definition at line 115 of file XmlRpcClient.h.

ClientConnectionState XmlRpc::XmlRpcClient::_connectionState

protected

Definition at line 91 of file XmlRpcClient.h.

int XmlRpc::XmlRpcClient::_contentLength

Definition at line 128 of file XmlRpcClient.h.

XmlRpcDispatch XmlRpc::XmlRpcClient::_disp

Definition at line 131 of file XmlRpcClient.h.

bool XmlRpc::XmlRpcClient::_eof

Definition at line 122 of file XmlRpcClient.h.

bool XmlRpc::XmlRpcClient::_executing

Definition at line 119 of file XmlRpcClient.h.

std::string XmlRpc::XmlRpcClient::_header

Definition at line 106 of file XmlRpcClient.h.

std::string XmlRpc::XmlRpcClient::_host

protected

Definition at line 96 of file XmlRpcClient.h.

bool XmlRpc::XmlRpcClient::_isFault

Definition at line 125 of file XmlRpcClient.h.

int XmlRpc::XmlRpcClient::_port

protected

Definition at line 98 of file XmlRpcClient.h.

std::string XmlRpc::XmlRpcClient::_request

Definition at line 105 of file XmlRpcClient.h.

std::string XmlRpc::XmlRpcClient::_response

Definition at line 107 of file XmlRpcClient.h.

int XmlRpc::XmlRpcClient::_sendAttempts

Definition at line 110 of file XmlRpcClient.h.

std::string XmlRpc::XmlRpcClient::_uri

protected

Definition at line 97 of file XmlRpcClient.h.

const char XmlRpcClient::FAULT_TAG = "<fault>"

static

Definition at line 38 of file XmlRpcClient.h.

const char XmlRpcClient::METHODRESPONSE_TAG = "<methodResponse>"

static

Definition at line 37 of file XmlRpcClient.h.

const char XmlRpcClient::PARAM_ETAG = "</param>"

static

Definition at line 34 of file XmlRpcClient.h.

const char XmlRpcClient::PARAM_TAG = "<param>"

static

Definition at line 33 of file XmlRpcClient.h.

const char XmlRpcClient::PARAMS_ETAG = "</params>"

static

Definition at line 32 of file XmlRpcClient.h.

const char XmlRpcClient::PARAMS_TAG = "<params>"

static

Definition at line 31 of file XmlRpcClient.h.

const char XmlRpcClient::REQUEST_BEGIN

static

Initial value:

= 
  "<?xml version=\"1.0\"?>\r\n"
  "<methodCall><methodName>"

Definition at line 29 of file XmlRpcClient.h.

const char XmlRpcClient::REQUEST_END = "</methodCall>\r\n"

static

Definition at line 35 of file XmlRpcClient.h.

const char XmlRpcClient::REQUEST_END_METHODNAME = "</methodName>\r\n"

static

Definition at line 30 of file XmlRpcClient.h.

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

Public Member Functions

Public Attributes

Static Public Attributes

Protected Types

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Detailed Description

Member Enumeration Documentation

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation