net.jini.core.entry

Class UnusableEntryException

java.lang.Object

java.lang.Throwable

java.lang.Exception

net.jini.core.entry.UnusableEntryException

All Implemented Interfaces:

Serializable

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

Fields

Modifier and Type	Field and Description
Throwable[]	nestedExceptions Deprecated. this field will be made private, use getNestedExceptions()
Entry	partialEntry The partial entry.
String[]	unusableFields Deprecated. this field will be made private, use getUnusableFields()

Constructor Summary

Constructors

Constructor and Description
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

Modifier and Type	Method and Description
Throwable[]	getNestedExceptions() The exception that caused the failure for the corresponding field named in unusableFields.
String[]	getUnusableFields() The names of the unusable fields.
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

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, 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

Deprecated. this field will be made private, use getUnusableFields()

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

nestedExceptions

public Throwable[] nestedExceptions

Deprecated. this field will be made private, use getNestedExceptions()

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

getUnusableFields

public String[] getUnusableFields()

The names of the unusable fields.

Returns:

The names of the unusable fields or null if the entry was entirely unusable.

Since:

3.1.0

getNestedExceptions

public Throwable[] getNestedExceptions()

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.

Returns:

The exception that caused the failure for the corresponding field named in getUnusableFields.

Since:

3.1.0

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