org.codehaus.plexus.components.io.resources

Interface PlexusIoResourceCollection

All Superinterfaces:

Iterable<PlexusIoResource>

All Known Subinterfaces:

PlexusIoArchivedResourceCollection

All Known Implementing Classes:

AbstractPlexusIoArchiveResourceCollection, AbstractPlexusIoResourceCollection, AbstractPlexusIoResourceCollectionWithAttributes, PlexusIoCompressedFileResourceCollection, PlexusIoFileResourceCollection, PlexusIoProxyResourceCollection

public interface PlexusIoResourceCollection
extends Iterable<PlexusIoResource>

A resource collection is a set of PlexusIoResource instances.

Field Summary

Fields

Modifier and Type	Field and Description
static String	DEFAULT_ROLE_HINT Role hint of the default resource collection, which is a set of files in a base directory.
static String	ROLE Role of the ResourceCollection component.

Method Summary

Methods

Modifier and Type	Method and Description
InputStream	getInputStream(PlexusIoResource resource) Returns an input stream for the provided resource, with stream transformers applied
long	getLastModified() Returns the collections last modification time.
String	getName(PlexusIoResource resource) Returns the resources suggested name.
Iterator<PlexusIoResource>	getResources() Returns an iterator over the resources in the collection.
PlexusIoResource	resolve(PlexusIoResource resource) Resolves the supplide resource into a "real" resource.
Stream	stream() Returns the resources as a stream.

Methods inherited from interface java.lang.Iterable

iterator

Field Detail

ROLE

static final String ROLE

Role of the ResourceCollection component.

DEFAULT_ROLE_HINT

static final String DEFAULT_ROLE_HINT

Role hint of the default resource collection, which is a set of files in a base directory.

See Also:

Constant Field Values

Method Detail

getResources

Iterator<PlexusIoResource> getResources()
                                        throws IOException

Returns an iterator over the resources in the collection.

Returns:

An iterator

Throws:

IOException - .

stream

Stream stream()

Returns the resources as a stream.

Returns:

A stream for functional iteration

getName

String getName(PlexusIoResource resource)

Returns the resources suggested name. This is used for integrating file mappers.

Parameters:

resource - A resource, which has been obtained by calling getResources().

Returns:

The resource name. If it is a file, it should be normalized to platform separators

getLastModified

long getLastModified()
                     throws IOException

Returns the collections last modification time. For a collection of files, this might be the last modification time of the file, which has been modified at last. For an archive file, this might be the modification time of the archive file.

Returns:

PlexusIoResource.UNKNOWN_MODIFICATION_DATE, if the collections last modification time is unknown, otherwise the last modification time in milliseconds.

Throws:

IOException - .

getInputStream

InputStream getInputStream(PlexusIoResource resource)
                           throws IOException

Returns an input stream for the provided resource, with stream transformers applied

Parameters:

resource - The resources

Returns:

A possibly transformed resource

Throws:

IOException - when something goes bad

resolve

PlexusIoResource resolve(PlexusIoResource resource)
                         throws IOException

Resolves the supplide resource into a "real" resource. Resolving means applying input transformations Returns an input stream for the provided resource, with stream transformers applied

Parameters:

resource - The resources

Returns:

A possibly transformed resource

Throws:

IOException - when something goes bad