getLeases call. When unmarshalling an instance of MarshalledObject, one of the following checked exceptions is possible: an IOException can occur while deserializing the object from its internal representation; and a ClassNotFoundException can occur if, while deserializing the object from its internal representation, either the class file of the object cannot be found, or the class file of either an interface or a class referenced by the object being deserialized cannot be found. Typically, a ClassNotFoundException occurs when the codebase from which to retrieve the needed class file is not currently available.
This class provides a mechanism that clients of the lease renewal service may use for efficient handling of the exceptions that may occur when unmarshalling elements of a set of marshalled Lease objects. When elements in such a set are unmarshalled, the LeaseUnmarshalException class may be used to collect and report pertinent information generated when failure occurs while unmarshalling the elements of the set.
The information that may be of interest to entities that receive this exception class is contained in the following fields: a set of Lease objects in which each element is the result of a successful unmarshalling attempt, a set of marshalled Lease objects in which each element could not be successfully unmarshalled, and a set of exceptions (IOException, ClassNotFoundException, or some unchecked exception) in which each element corresponds to one of the unmarshalling failures.
Thus, when exceptional conditions occur while unmarshalling a set of marshalled Lease objects, this class can be used not only to indicate that an exceptional condition has occurred, but also to provide information that can be used to perform error handling activities such as: determining if it is feasible to continue with processing, reporting errors, attempting recovery, and debugging.
Note that this exception class should be used only to report exceptional conditions occurring when unmarshalling a set of marshalled Lease objects.
@author Sun Microsystems, Inc.
@see Lease
| |