org.jboss.shrinkwrap.api.importer

Interface StreamImporter<I extends StreamImporter<I>>

Type Parameters:

I - Concrete type used in covariant return

All Superinterfaces:

Assignable

All Known Subinterfaces:

TarBz2Importer, TarGzImporter, TarImporter, ZipImporter

public interface StreamImporter<I extends StreamImporter<I>>
extends Assignable

Generic importer capable of representing an Assignable as an entity capable of reading from an InputStream, or file type.

Author:

ALR

Method Summary

Modifier and Type	Method and Description
I	importFrom(File file) Imports provided File as a Archive.
I	importFrom(File file, Filter<ArchivePath> filter) Imports provided File as a Archive.
I	importFrom(InputStream stream) Imports provided stream as a Archive.
I	importFrom(InputStream stream, Filter<ArchivePath> filter) Imports provided stream as a Archive.

Methods inherited from interface org.jboss.shrinkwrap.api.Assignable

as

Method Detail

importFrom

I importFrom(InputStream stream)
      throws ArchiveImportException

Imports provided stream as a Archive. It remains the responsibility of the caller to close the stream.

Parameters:

stream - the stream to import; should be a raw type, not wrapped in any implementation-specific encoding (i.e. FileInputStream is appropriate, but ZipInputStream or GZIPInputStream is not).

Returns:

Archive of the imported stream

Throws:

ArchiveImportException - If an error occurred during the import process

IllegalArgumentException - If no stream is specified

importFrom

I importFrom(InputStream stream,
             Filter<ArchivePath> filter)
      throws ArchiveImportException

Imports provided stream as a Archive. It remains the responsibility of the caller to close the stream.

Parameters:

stream - the stream to import; should be a raw type, not wrapped in any implementation-specific encoding (i.e. FileInputStream is appropriate, but ZipInputStream or GZIPInputStream is not).

filter - Filter to match result

Returns:

Archive of the imported stream

Throws:

ArchiveImportException - If an error occurred during the import process

IllegalArgumentException - If no stream is specified

importFrom

I importFrom(File file)
      throws ArchiveImportException

Imports provided File as a Archive.

Parameters:

file - the file to import

Returns:

Archive of the imported file

Throws:

ArchiveImportException - If an error occurred during the import process

IllegalArgumentException - If no file is specified or if the file is a directory

importFrom

I importFrom(File file,
             Filter<ArchivePath> filter)
      throws ArchiveImportException

Imports provided File as a Archive.

Parameters:

file - the file to import

filter - Filter to match result

Returns:

Archive of the imported file

Throws:

ArchiveImportException - If an error occurred during the import process

IllegalArgumentException - If no file is specified or if the file is a directory