Class XmlRpcResponseParser

java.lang.Object

org.apache.xmlrpc.parser.TypeParserImpl

org.apache.xmlrpc.parser.RecursiveTypeParserImpl

org.apache.xmlrpc.parser.XmlRpcResponseParser

All Implemented Interfaces:

TypeParser, ContentHandler

public class XmlRpcResponseParser
extends RecursiveTypeParserImpl

A SAX parser for an XmlRpcServer's response.

Field Summary

Fields

Modifier and Type	Field	Description
private Throwable	errorCause
private int	errorCode
private String	errorMessage
private boolean	isSuccess
private int	level

Fields inherited from class RecursiveTypeParserImpl

cfg

Constructor Summary

Constructors

Constructor	Description
XmlRpcResponseParser(XmlRpcStreamRequestConfig pConfig, TypeFactory pTypeFactory)	Creates a new instance.

Method Summary

Modifier and Type	Method	Description
protected void	addResult(Object pResult)
void	endElement(String pURI, String pLocalName, String pQName)
Throwable	getErrorCause()	If the response contained a fault, returns the (optional) exception.
int	getErrorCode()	If the response contained a fault, returns the error code.
String	getErrorMessage()	If the response contained a fault, returns the error message.
boolean	isSuccess()	Returns whether the response returned success.
void	startDocument()
void	startElement(String pURI, String pLocalName, String pQName, Attributes pAttrs)

Methods inherited from class RecursiveTypeParserImpl

characters, endPrefixMapping, endValueTag, ignorableWhitespace, processingInstruction, skippedEntity, startPrefixMapping, startValueTag

Methods inherited from class TypeParserImpl

endDocument, getDocumentLocator, getResult, isEmpty, setDocumentLocator, setResult

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

level

private int level

isSuccess

private boolean isSuccess

errorCode

private int errorCode

errorMessage

private String errorMessage

errorCause

private Throwable errorCause

Constructor Details

XmlRpcResponseParser

public XmlRpcResponseParser(XmlRpcStreamRequestConfig pConfig,
 TypeFactory pTypeFactory)

Creates a new instance.

Parameters:

pConfig - The response configuration.

pTypeFactory - The type factory for creating instances of TypeParser.

Method Details

addResult

protected void addResult(Object pResult)
                  throws SAXException

Specified by:

addResult in class RecursiveTypeParserImpl

Throws:

SAXException

startDocument

public void startDocument()
                   throws SAXException

Specified by:

startDocument in interface ContentHandler

Overrides:

startDocument in class RecursiveTypeParserImpl

Throws:

SAXException

startElement

public void startElement(String pURI,
 String pLocalName,
 String pQName,
 Attributes pAttrs)
                  throws SAXException

Specified by:

startElement in interface ContentHandler

Overrides:

startElement in class RecursiveTypeParserImpl

Throws:

SAXException

endElement

public void endElement(String pURI,
 String pLocalName,
 String pQName)
                throws SAXException

Specified by:

endElement in interface ContentHandler

Overrides:

endElement in class RecursiveTypeParserImpl

Throws:

SAXException

isSuccess

public boolean isSuccess()

Returns whether the response returned success. If so, the result object may be fetched using TypeParserImpl.getResult(). Otherwise, you may use the methods getErrorCode() and getErrorMessage() to check for error reasons.

Returns:

True, if the response indicated success, false otherwise.

getErrorCode

public int getErrorCode()

If the response contained a fault, returns the error code.

Returns:

The numeric error code.

getErrorMessage

public String getErrorMessage()

If the response contained a fault, returns the error message.

Returns:

The error message.

getErrorCause

public Throwable getErrorCause()

If the response contained a fault, returns the (optional) exception.