org.apache.xmlrpc

Class XmlRpcException

Known Direct Subclasses:
TimingOutCallback.TimeoutException, XmlRpcClientException, XmlRpcExtensionException, XmlRpcInvocationException, XmlRpcLoadException, XmlRpcNoSuchHandlerException, XmlRpcNotAuthorizedException

public class XmlRpcException
extends Exception

This exception is thrown by the XmlRpcClient, if an invocation of the remote method failed. Failure may have two reasons: The invocation failed on the remote side (for example, an exception was thrown within the server) or the communication with the server failed. The latter is indicated by throwing an instance of XmlRpcClientException.

Field Summary

int
code
The fault code of the exception.
Throwable
linkedException
If the transport was able to catch a remote exception (as is the case, if the local transport is used or if extensions are enabled and the server returned a serialized exception), then this field contains the trapped exception.

Constructor Summary

XmlRpcException(String pMessage)
Creates a new instance with the given error message and error code 0.
XmlRpcException(String pMessage, Throwable pLinkedException)
Creates a new instance with the given error message and cause.
XmlRpcException(int pCode, String pMessage)
Creates a new instance with the given error code and error message.
XmlRpcException(int pCode, String pMessage, Throwable pLinkedException)
Creates a new instance with the given error code, error message and cause.

Method Summary

Throwable
getCause()
void
printStackTrace(PrintStream pStream)
void
printStackTrace(PrintWriter pWriter)

Field Details

code

public final int code
The fault code of the exception. For servers based on this library, this will always be 0. (If there are predefined error codes, they should be in the XML-RPC spec.)

linkedException

public final Throwable linkedException
If the transport was able to catch a remote exception (as is the case, if the local transport is used or if extensions are enabled and the server returned a serialized exception), then this field contains the trapped exception.

Constructor Details

XmlRpcException

public XmlRpcException(String pMessage)
Creates a new instance with the given error message and error code 0.
Parameters:
pMessage - Detail message.

XmlRpcException

public XmlRpcException(String pMessage,
                       Throwable pLinkedException)
Creates a new instance with the given error message and cause.
Parameters:
pMessage - Detail message.
pLinkedException - The errors cause.

XmlRpcException

public XmlRpcException(int pCode,
                       String pMessage)
Creates a new instance with the given error code and error message.
Parameters:
pCode - Error code.
pMessage - Detail message.

XmlRpcException

public XmlRpcException(int pCode,
                       String pMessage,
                       Throwable pLinkedException)
Creates a new instance with the given error code, error message and cause.
Parameters:
pCode - Error code.
pMessage - Detail message.
pLinkedException - The errors cause.

Method Details

getCause

public Throwable getCause()

printStackTrace

public void printStackTrace(PrintStream pStream)

printStackTrace

public void printStackTrace(PrintWriter pWriter)

Copyright © 2001-2007 Apache Software Foundation. All Rights Reserved.