GigaSpaces XAP 10.0.1 API

net.jini.core.entry
Class UnusableEntryException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by net.jini.core.entry.UnusableEntryException
All Implemented Interfaces:
Serializable
Direct Known Subclasses:
DetailedUnusableEntryException

public class UnusableEntryException
extends Exception

Thrown when one tries to get an Entry from a service, but the entry is unusable (due to serialization or other errors). Normally partialEntry points to an entry with as many fields as possible filled in, with the array unusableFields naming the fields that could not be deserialized and the array nestedExceptions having the corresponding exception.

If the serialized Entry was corrupt enough that no attempt could even be made to deserialize its fields, partialEntry and unusableFields will be null, and nestedExceptions will be an array with one element that is the offending exception. This will typically be because one or more of the classes of the Entry type itself cannot be loaded.

The names in unusableFields can be used together with the reflection mechanisms of java.lang.reflect to examine the full state of the object.

Since:
1.0
Author:
Sun Microsystems, Inc.
See Also:
Serialized Form

Field Summary
 Throwable[] nestedExceptions
          The exception that caused the failure for the corresponding field named in unusableFields.
 Entry partialEntry
          The partial entry.
 String[] unusableFields
          The names of the unusable fields.
 
Constructor Summary
UnusableEntryException(Entry partial, String[] badFields, Throwable[] exceptions)
          Create an exception for the given partial entry and vectors of bad field names/nested exception pairs.
UnusableEntryException(Throwable e)
          Create an exception for a nested exception that prevented even an attempt to build an entry.
 
Method Summary
 void printStackTrace()
          Calls printStackTrace(System.err).
 void printStackTrace(PrintStream s)
          Calls super.printStackTrace(s) and then calls printStackTrace(s) on each exception in nestedExceptions.
 void printStackTrace(PrintWriter s)
          Calls super.printStackTrace(s) and then calls printStackTrace(s) on each exception in nestedExceptions.
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, initCause, setStackTrace, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

partialEntry

public Entry partialEntry
The partial entry. Fields that could not be deserialized will be null.


unusableFields

public String[] unusableFields
The names of the unusable fields. If the entry was entirely unusable, unusableFields will be null.


nestedExceptions

public Throwable[] nestedExceptions
The exception that caused the failure for the corresponding field named in unusableFields. If the entry was entirely unusable, nestedExceptions will be an array with the one exception that prevented its use.

Constructor Detail

UnusableEntryException

public UnusableEntryException(Entry partial,
                              String[] badFields,
                              Throwable[] exceptions)
Create an exception for the given partial entry and vectors of bad field names/nested exception pairs.

Parameters:
partial - the Entry object on which the exception occurred
badFields - a String array containing the bad field names
exceptions - an array of Throwable objects associated with the bad field names
Throws:
IllegalArgumentException - if partial is null and badFields is not null or exceptions does not have exactly one element or if partial is non-null and badFields and exceptions are not the same length
NullPointerException - if partial is non-null and badFields or any element of badFields is null, or if exceptions or any element of exceptions is null

UnusableEntryException

public UnusableEntryException(Throwable e)
Create an exception for a nested exception that prevented even an attempt to build an entry.

Parameters:
e - a Throwable representing the nested exception
Throws:
NullPointerException - if e is null
Method Detail

printStackTrace

public void printStackTrace()
Calls printStackTrace(System.err).

Overrides:
printStackTrace in class Throwable

printStackTrace

public void printStackTrace(PrintStream s)
Calls super.printStackTrace(s) and then calls printStackTrace(s) on each exception in nestedExceptions.

Overrides:
printStackTrace in class Throwable

printStackTrace

public void printStackTrace(PrintWriter s)
Calls super.printStackTrace(s) and then calls printStackTrace(s) on each exception in nestedExceptions.

Overrides:
printStackTrace in class Throwable

GigaSpaces XAP 10.0.1 API

Copyright © GigaSpaces.