org.apache.xmlrpc.parser

Class XmlRpcResponseParser

java.lang.Object

org.apache.xmlrpc.parser.TypeParserImpl

org.apache.xmlrpc.parser.RecursiveTypeParserImpl

org.apache.xmlrpc.parser.XmlRpcResponseParser

All Implemented Interfaces:

TypeParser, org.xml.sax.ContentHandler

public class XmlRpcResponseParser
extends RecursiveTypeParserImpl

A SAX parser for an XmlRpcServer's response.

Field Summary

Fields inherited from class org.apache.xmlrpc.parser.RecursiveTypeParserImpl

cfg

Constructor Summary

Constructors

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

Method Summary

Methods

Modifier and Type	Method and 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, org.xml.sax.Attributes pAttrs)

Methods inherited from class org.apache.xmlrpc.parser.RecursiveTypeParserImpl

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

Methods inherited from class org.apache.xmlrpc.parser.TypeParserImpl

endDocument, getDocumentLocator, getResult, isEmpty, setDocumentLocator, setResult

Methods inherited from class java.lang.Object

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

Constructor Detail

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 Detail

addResult

protected void addResult(Object pResult)
                  throws org.xml.sax.SAXException

Specified by:

addResult in class RecursiveTypeParserImpl

Throws:

org.xml.sax.SAXException

startDocument

public void startDocument()
                   throws org.xml.sax.SAXException

Specified by:

startDocument in interface org.xml.sax.ContentHandler

Overrides:

startDocument in class RecursiveTypeParserImpl

Throws:

org.xml.sax.SAXException

startElement

public void startElement(String pURI,
                String pLocalName,
                String pQName,
                org.xml.sax.Attributes pAttrs)
                  throws org.xml.sax.SAXException

Specified by:

startElement in interface org.xml.sax.ContentHandler

Overrides:

startElement in class RecursiveTypeParserImpl

Throws:

org.xml.sax.SAXException

endElement

public void endElement(String pURI,
              String pLocalName,
              String pQName)
                throws org.xml.sax.SAXException

Specified by:

endElement in interface org.xml.sax.ContentHandler

Overrides:

endElement in class RecursiveTypeParserImpl

Throws:

org.xml.sax.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.