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 |
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.
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