Class Fault

Summary

Fully Qualified Name: Zend\XmlRpc\Server\Fault
Extends: Fault

Description

XMLRPC Server Faults

Encapsulates an exception for use as an XMLRPC fault response. Valid exception classes that may be used for generating the fault code and fault string can be attached using {@link attachFaultException()}; all others use a generic '404 Unknown error' response.

You may also attach fault observers, which would allow you to monitor particular fault cases; this is done via {@link attachObserver()}. Observers need only implement a static 'observe' method.

To allow method chaining, you may use the {@link getInstance()} factory to instantiate a Zend\XmlRpc\Server\Fault.

Methods

Name Description Defined By
__construct() Constructor Fault
attachFaultException() Attach valid exceptions that can be used to define xmlrpc faults Fault
attachObserver() Attach an observer class Fault
detachFaultException() Detach fault exception classes Fault
detachObserver() Detach an observer Fault
getException() Retrieve the exception Fault
getInstance() Return Zend\XmlRpc\Server\Fault instance Fault

Method Details

__construct()

Constructor

Parameter Name Type Description
$e \Exception

Returns: \Fault

attachFaultException()

Attach valid exceptions that can be used to define xmlrpc faults

Parameter Name Type Description
$classes string|array Class

Returns: void

attachObserver()

Attach an observer class

Allows observation of xmlrpc server faults, thus allowing logging or mail notification of fault responses on the xmlrpc server.

Expects a valid class name; that class must have a public static method 'observe' that accepts an exception as its sole argument.

Parameter Name Type Description
$class string

Returns: bool

detachFaultException()

Detach fault exception classes

Parameter Name Type Description
$classes string|array Class

Returns: void

detachObserver()

Detach an observer

Parameter Name Type Description
$class string

Returns: bool

getException()

Retrieve the exception

Returns: \Exception

getInstance()

Return Zend\XmlRpc\Server\Fault instance

Parameter Name Type Description
$e \Exception

Returns: \Fault

Top