javax.microedition.xml.rpc
Interface FaultDetailHandler


public interface FaultDetailHandler

The FaultDetailHandler interface is implemented by stubs that handle custom faults.

If the WSDL description of a service endpoint includes operations with custom faults (wsdl:fault), the generated stub must provide an implementation of the FaultDetailHandler interface. The implementation of this interface is used by the runtime to retrieve a description of the detail portion of the SOAP fault. When the stub creates an instance in the Operation class, it passes a reference to the FaultDetailHandler.

If the SOAP fault does not map to RemoteException, or one of its subclasses, and the stub has passed a FaultDetailHandler object reference to the runtime, the runtime must call the FaultDetailHandler method handleFault passing the QName of the child element of the SOAP fault detail element. The method handleFault returns an Element describing the SOAP fault detail.

See Operation, Element, QName.

Since:
BlackBerry API 4.3.0

Method Summary
 Element handleFault(QName detailName)
          Returns an Element describing the SOAP fault detail, or null if there is no mapping for the SOAP fault detail element.
 



Method Detail

handleFault

Element handleFault(QName detailName)
Returns an Element describing the SOAP fault detail, or null if there is no mapping for the SOAP fault detail element.

Parameters:
detailName - the QName of the SOAP fault detail.
Returns:
an Element object describing the SOAP fault detail.
Since:
BlackBerry API 4.3.0





Copyright 1999-2010 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.