net.jini.core.entry
Class UnusableEntryException

java.lang.Object
  |
  +--java.lang.Throwable
        |
        +--java.lang.Exception
              |
              +--net.jini.core.entry.UnusableEntryException

public class UnusableEntryException
extends java.lang.Exception

Thrown when one tries to get an Entry from a service, but the entry is unusuable (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.

See Also:
Serialized Form

Field Summary
 java.lang.Throwable[] nestedExceptions
          The exception that caused the failure for the corresponding field named in unusableFields.
 Entry partialEntry
          The partial entry.
 java.lang.String[] unusableFields
          The names of the unusable fields.
 
Constructor Summary
UnusableEntryException(Entry partial, java.lang.String[] badFields, java.lang.Throwable[] exceptions)
          Create an exception for the given partial entry and vectors of bad field names/nested exception pairs.
UnusableEntryException(java.lang.Throwable e)
          Create an exception for a nested exception that prevented even an attempt to build an entry.
 
Methods inherited from class java.lang.Throwable
fillInStackTrace, getLocalizedMessage, getMessage, printStackTrace, printStackTrace, printStackTrace, 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 java.lang.String[] unusableFields
The names of the unusable fields. If the entry was entirely unusable, unusableFields will be null.

nestedExceptions

public java.lang.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,
                              java.lang.String[] badFields,
                              java.lang.Throwable[] exceptions)
Create an exception for the given partial entry and vectors of bad field names/nested exception pairs.

UnusableEntryException

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


Copyright © 1999 Sun Microsystems, Inc. All rights reserved