A class for aggregating exceptions thrown by JSAP's parsing process. This
class is necessary as it is desirable to have information regarding ALL of
the reasons for a failed parse rather than just the FIRST reason.
Adds the specified exception to the exception map. Exceptions are
keyed by the ID of the parameters with which they are associated.
"General" exceptions not associated with a particular parameter have a
null key.
Parameters:
id - the unique ID of the parameter with which the specified values
are associated.
exception - the exception to associate with the specified key.
Returns the first exception associated with the specified parameter ID.
"General" exceptions can be retrieved with a null id. If no exceptions
are associated with the specified parameter ID, null is returned.
Parameters:
id - the unique ID of the parameter for which the first exception
is requested
Returns:
the first exception associated with the specified ID, or null if
no exceptions are associated with the specified ID.
Returns an array of ALL exceptions associated with the specified
parameter ID. If no exceptions are associated with the specified
parameter ID, an empty (zero-length) array is returned.
Parameters:
id - the unique ID of the parameter for which the exceptions are
requested.
Returns:
an array of ALL exceptions associated with the specified
parameter ID,
or an empty (zero-length) array if no exceptions are associated with the
specified parameter ID.