net.jini.entry

Class UnusableEntriesException

java.lang.Object

java.lang.Throwable

java.lang.Exception

net.jini.entry.UnusableEntriesException

All Implemented Interfaces:

Serializable

public class UnusableEntriesException
extends Exception

Thrown from methods that normally return a collection of Entry instances when one or more of the entries can't be unmarshalled. Contains copies of any entries that could be unmarshalled and an UnusableEntryException for each Entry that could not be.

Since:

2.1

See Also:

UnusableEntryException, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
private Collection	entries The entries that could be unmarshalled
private Collection	exceptions Exceptions detailing why certain entries could not be unmarshalled.
private static long	serialVersionUID

Constructor Summary

Constructors

Constructor and Description
UnusableEntriesException(String s, Collection entries, Collection exceptions) Constructs an UnusableEntriesException with the given message, Collection of entries that could be unmarshalled, and Collection of UnusableEntryExceptions, detailing for each unusable Entry why it could not be unmarshalled.

Method Summary

Methods

Modifier and Type	Method and Description
Collection	getEntries() Returns a Collection of the entries that could be unmarshalled by the operation.
Collection	getUnusableEntryExceptions() Returns a Collection of UnusableEntryExceptions with one element for each Entry that could not be unmarshalled by the operation.
private void	readObject(ObjectInputStream in)
private void	readObjectNoData()

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

serialVersionUID

private static final long serialVersionUID

See Also:

Constant Field Values

entries

private final Collection entries

The entries that could be unmarshalled

exceptions

private final Collection exceptions

Exceptions detailing why certain entries could not be unmarshalled.

Constructor Detail

UnusableEntriesException

public UnusableEntriesException(String s,
                        Collection entries,
                        Collection exceptions)

Constructs an UnusableEntriesException with the given message, Collection of entries that could be unmarshalled, and Collection of UnusableEntryExceptions, detailing for each unusable Entry why it could not be unmarshalled.

Parameters:

s - the detail message, may be null

entries - Collection of Entry instances that could be unmarshalled, may be empty or null. Note, if non-null, the passed instance will be returned by the getEntries() method

exceptions - Collection of UnusableEntryException instances. Note, the passed instance will be returned by the getUnusableEntryExceptions() method

Throws:

IllegalArgumentException - if entries contains an element that is not an Entry, if exceptions contains an element that is not an UnusableEntryException, or if exceptions is empty

NullPointerException - if exceptions is null, any element of exceptions is null, or any element of entries is null

Method Detail

readObject

private void readObject(ObjectInputStream in)
                 throws IOException,
                        ClassNotFoundException

Throws:

InvalidObjectException - if the entries field is null, or contains an element which is not an Entry. Also throws an InvalidObjectException if the exceptions field is null, empty, or contains an element which is not an UnusableEntryException

IOException

ClassNotFoundException

readObjectNoData

private void readObjectNoData()
                       throws InvalidObjectException

Throws:

InvalidObjectException - if called

getEntries

public Collection getEntries()

Returns a Collection of the entries that could be unmarshalled by the operation. If no entries could be unmarshalled, an empty Collection will be returned. Result may be immutable.

Returns:

a Collection of Entry instances that could be unmarshalled

getUnusableEntryExceptions

public Collection getUnusableEntryExceptions()

Returns a Collection of UnusableEntryExceptions with one element for each Entry that could not be unmarshalled by the operation. Will be non-null and non-empty. Result may be immutable.

Returns:

a Collection of UnusableEntryException instances with one element for each Entry that that could not be unmarshalled