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

Constructor Summary

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

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.

Methods inherited from class java.lang.Throwable

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

Methods inherited from class java.lang.Object

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

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

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