User Guide

170 Appendix A: Using NetServices and Connection Classes
The error object
When Flash Remoting receives a status event, Flash passes an error object that contains
information about the error to the status event handler. The error object has the following format:
Error-handling hierarchy
Flash Remoting supports the following hierarchy of error handling:
1. If you specify the responder in the getService() function call, one of the following happens:
a If the responder has a function with a name of the form functionName_Status(), where
functionName is the name of the service function that you called, Flash Remoting returns
the status information for the function to that method.
b If the default responder object specified in the getService() function call has a function
named
onStatus(), Flash Remoting returns the status to that function.
2. If you specify a responder object in the service function call, Flash Remoting returns the status
to that object’s
onStatus() method. When you use this technique, the responder object must
also have an
onResult() method to handle the result.
3. If there is a function called _root.onStatus(), Flash Remoting returns the status to that
function.
4. If there is a function called _global.System.onStatus(), Flash Remoting returns the status
to that function.
5. During development, Flash displays the status information in a message window if you have not
specified a responder or result handling functions.
This hierarchy allows you to define handlers for all otherwise unhandled status events on a given
level or in the entire application.
Key name Contents
code Currently, always SERVER.PROCESSING.
level Currently, always Error.
description A string that describes the error.
details A stack trace that indicates the processing state at the time of the exception.
type The error class name.
rootcause A nested error object that contains additional information on the cause of the
error. Provided only if a Java servletException is thrown.