Package io.github.fastclasspathscanner

Class ResourceList

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<E>

java.util.ArrayList<Resource>

io.github.fastclasspathscanner.ResourceList

All Implemented Interfaces:

Serializable, AutoCloseable, Cloneable, Iterable<Resource>, Collection<Resource>, List<Resource>, RandomAccess

public class ResourceList
extends ArrayList<Resource>
implements AutoCloseable

An AutoCloseable list of AutoCloseable Resource objects.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	ResourceList.ByteArrayConsumer	A FunctionalInterface for consuming the contents of a Resource as a byte array.
static interface	ResourceList.ByteBufferConsumer	A FunctionalInterface for consuming the contents of a Resource as a ByteBuffer.
static interface	ResourceList.InputStreamConsumer	A FunctionalInterface for consuming the contents of a Resource as an InputStream.
static interface	ResourceList.ResourceFilter	Filter a ResourceList using a predicate mapping a Resource object to a boolean, producing another ResourceList for all items in the list for which the predicate is true.

Field Summary

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Constructor	Description
ResourceList()
ResourceList(int sizeHint)
ResourceList(Collection<Resource> collection)

Method Summary

Modifier and Type	Method	Description
void	close()	Close all the Resource objects in this ResourceList.
ResourceList	filter(ResourceList.ResourceFilter filter)	Find the subset of the Resource objects in this list for which the given filter predicate is true.
void	forEachByteArray(ResourceList.ByteArrayConsumer byteArrayConsumer)	Fetch the content of each Resource in this ResourceList as a byte array, pass the byte array to the given ResourceList.ByteArrayConsumer, then close the underlying InputStream or release the underlying ByteBuffer by calling Resource.close().
void	forEachByteArray(ResourceList.ByteArrayConsumer byteArrayConsumer, boolean ignoreIOExceptions)	Fetch the content of each Resource in this ResourceList as a byte array, pass the byte array to the given ResourceList.ByteArrayConsumer, then close the underlying InputStream or release the underlying ByteBuffer by calling Resource.close().
void	forEachByteBuffer(ResourceList.ByteBufferConsumer byteBufferConsumer)	Read each Resource in this ResourceList as a ByteBuffer, pass the ByteBuffer to the given ResourceList.InputStreamConsumer, then release the ByteBuffer after the ResourceList.ByteBufferConsumer returns, by calling Resource.close().
void	forEachByteBuffer(ResourceList.ByteBufferConsumer byteBufferConsumer, boolean ignoreIOExceptions)	Read each Resource in this ResourceList as a ByteBuffer, pass the ByteBuffer to the given ResourceList.InputStreamConsumer, then release the ByteBuffer after the ResourceList.ByteBufferConsumer returns, by calling Resource.close().
void	forEachInputStream(ResourceList.InputStreamConsumer inputStreamConsumer)	Fetch an InputStream for each Resource in this ResourceList, pass the InputStream to the given ResourceList.InputStreamConsumer, then close the InputStream after the ResourceList.InputStreamConsumer returns, by calling Resource.close().
void	forEachInputStream(ResourceList.InputStreamConsumer inputStreamConsumer, boolean ignoreIOExceptions)	Fetch an InputStream for each Resource in this ResourceList, pass the InputStream to the given ResourceList.InputStreamConsumer, then close the InputStream after the ResourceList.InputStreamConsumer returns, by calling Resource.close().
List<String>	getPaths()	Returns a list containing the path of each Resource in this list, relative to the package root within its respective classpath element.
List<URL>	getURLs()	Returns a list of the URLs of each Resource in this list.
String	toString()

Methods inherited from class java.util.AbstractCollection

containsAll

Methods inherited from class java.util.AbstractList

equals, hashCode

Methods inherited from class java.util.ArrayList

add, add, addAll, addAll, clear, clone, contains, ensureCapacity, forEach, get, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, removeIf, removeRange, replaceAll, retainAll, set, size, sort, spliterator, subList, toArray, toArray, trimToSize

Methods inherited from interface java.util.Collection

parallelStream, stream

Methods inherited from interface java.util.List

containsAll, equals, hashCode

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ResourceList

public ResourceList()

ResourceList

public ResourceList(int sizeHint)

ResourceList

public ResourceList(Collection<Resource> collection)

Method Detail

getPaths

public List<String> getPaths()

Returns a list containing the path of each Resource in this list, relative to the package root within its respective classpath element.

getURLs

public List<URL> getURLs()

Returns a list of the URLs of each Resource in this list.

filter

public ResourceList filter(ResourceList.ResourceFilter filter)

Find the subset of the Resource objects in this list for which the given filter predicate is true.

Parameters:

filter - The ResourceList.ResourceFilter to apply.

Returns:

The subset of the Resource objects in this list for which the given filter predicate is true.

forEachByteArray

public void forEachByteArray(ResourceList.ByteArrayConsumer byteArrayConsumer,
                             boolean ignoreIOExceptions)

Fetch the content of each Resource in this ResourceList as a byte array, pass the byte array to the given ResourceList.ByteArrayConsumer, then close the underlying InputStream or release the underlying ByteBuffer by calling Resource.close().

Parameters:

byteArrayConsumer - The ResourceList.ByteArrayConsumer.

ignoreIOExceptions - if true, any IOException thrown while trying to load any of the resources will be silently ignored.

Throws:

IllegalArgumentException - if ignoreExceptions is false, and an IOException is thrown while trying to load any of the resources.

forEachByteArray

public void forEachByteArray(ResourceList.ByteArrayConsumer byteArrayConsumer)

Fetch the content of each Resource in this ResourceList as a byte array, pass the byte array to the given ResourceList.ByteArrayConsumer, then close the underlying InputStream or release the underlying ByteBuffer by calling Resource.close().

Parameters:

byteArrayConsumer - The ResourceList.ByteArrayConsumer.

Throws:

IllegalArgumentException - if trying to load any of the resources results in an IOException being thrown.

forEachInputStream

public void forEachInputStream(ResourceList.InputStreamConsumer inputStreamConsumer,
                               boolean ignoreIOExceptions)

Fetch an InputStream for each Resource in this ResourceList, pass the InputStream to the given ResourceList.InputStreamConsumer, then close the InputStream after the ResourceList.InputStreamConsumer returns, by calling Resource.close().

Parameters:

inputStreamConsumer - The ResourceList.InputStreamConsumer.

ignoreIOExceptions - if true, any IOException thrown while trying to load any of the resources will be silently ignored.

Throws:

IllegalArgumentException - if ignoreExceptions is false, and an IOException is thrown while trying to open any of the resources.

forEachInputStream

public void forEachInputStream(ResourceList.InputStreamConsumer inputStreamConsumer)

Fetch an InputStream for each Resource in this ResourceList, pass the InputStream to the given ResourceList.InputStreamConsumer, then close the InputStream after the ResourceList.InputStreamConsumer returns, by calling Resource.close().

Parameters:

inputStreamConsumer - The ResourceList.InputStreamConsumer.

Throws:

IllegalArgumentException - if trying to open any of the resources results in an IOException being thrown.

forEachByteBuffer

public void forEachByteBuffer(ResourceList.ByteBufferConsumer byteBufferConsumer,
                              boolean ignoreIOExceptions)

Read each Resource in this ResourceList as a ByteBuffer, pass the ByteBuffer to the given ResourceList.InputStreamConsumer, then release the ByteBuffer after the ResourceList.ByteBufferConsumer returns, by calling Resource.close().

Parameters:

byteBufferConsumer - The ResourceList.ByteBufferConsumer.

ignoreIOExceptions - if true, any IOException thrown while trying to load any of the resources will be silently ignored.

Throws:

IllegalArgumentException - if ignoreExceptions is false, and an IOException is thrown while trying to load any of the resources.

forEachByteBuffer

public void forEachByteBuffer(ResourceList.ByteBufferConsumer byteBufferConsumer)

Read each Resource in this ResourceList as a ByteBuffer, pass the ByteBuffer to the given ResourceList.InputStreamConsumer, then release the ByteBuffer after the ResourceList.ByteBufferConsumer returns, by calling Resource.close().

Parameters:

byteBufferConsumer - The ResourceList.ByteBufferConsumer.

Throws:

IllegalArgumentException - if trying to load any of the resources results in an IOException being thrown.

toString

public String toString()

Overrides:

toString in class AbstractCollection<Resource>

close

public void close()

Close all the Resource objects in this ResourceList.

Specified by:

close in interface AutoCloseable