GigaSpaces XAP 9.5 API

net.jini.entry
Class UnusableEntriesException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by 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

GigaSpaces XAP 9.5 API

Copyright © GigaSpaces.