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.
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.
	XmlRpcClient (const char host, int port, const char uri=0)
virtual	~XmlRpcClient ()
	Destructor.
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 [] = "<methodCall><methodName>"
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 (std::string const &body)
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 ()
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 32 of file XmlRpcClient.cpp.

XmlRpcClient::~XmlRpcClient ( ) [virtual]

Destructor.

Definition at line 51 of file XmlRpcClient.cpp.

Member Function Documentation

void XmlRpcClient::close ( ) [virtual]

Close the connection.

Reimplemented from XmlRpc::XmlRpcSource.

Definition at line 58 of file XmlRpcClient.cpp.

bool XmlRpcClient::doConnect ( ) [protected, virtual]

Definition at line 218 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 80 of file XmlRpcClient.cpp.

bool XmlRpcClient::executeCheckDone ( XmlRpcValue & result )

Definition at line 145 of file XmlRpcClient.cpp.