org.jboss.shrinkwrap.api

Class ArchiveFactory

java.lang.Object

org.jboss.shrinkwrap.api.ArchiveFactory

public final class ArchiveFactory
extends java.lang.Object

Responsible for creating Archives, which may be presented to the caller in a designated Assignable view.

Version:

$Revision: $

Field Summary

Fields

Modifier and Type	Field and Description
private static java.lang.String	ARCHIVE_IMPL Implementation class name backing Archives to be created
private Configuration	configuration Configuration for all archives created from this factory

Constructor Summary

Constructors

Constructor and Description
ArchiveFactory(Configuration configuration) Creates a new ArchiveFactory which will use the supplied Configuration for each new Archive it creates.

Method Summary

Modifier and Type	Method and Description
<T extends Assignable> T	create(java.lang.Class<T> type) Creates a new archive of the specified type.
<T extends Assignable> T	create(java.lang.Class<T> type, java.lang.String archiveName) Creates a new archive of the specified type.
<T extends Assignable> T	createFromZipFile(java.lang.Class<T> type, java.io.File archiveFile) Creates a new archive of the specified type as imported from the specified File.

Methods inherited from class java.lang.Object

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

Field Detail

ARCHIVE_IMPL

private static final java.lang.String ARCHIVE_IMPL

Implementation class name backing Archives to be created

See Also:

Constant Field Values

configuration

private final Configuration configuration

Configuration for all archives created from this factory

Constructor Detail

ArchiveFactory

ArchiveFactory(Configuration configuration)
        throws java.lang.IllegalArgumentException

Creates a new ArchiveFactory which will use the supplied Configuration for each new Archive it creates.

Parameters:

configuration - the Configuration to use

Throws:

java.lang.IllegalArgumentException - if configuration is not supplied

Method Detail

create

public <T extends Assignable> T create(java.lang.Class<T> type)
                                throws java.lang.IllegalArgumentException,
                                       UnknownExtensionTypeException

Creates a new archive of the specified type. The archive will be be backed by the Configuration specific to this ArchiveFactory. Generates a random name for the archive and adds proper extension based on the service descriptor properties file if extension property is present (e.g. shrinkwrap/impl-base/src/main/resources/META-INF/services/org.jboss.shrinkwrap.api.spec.JavaArchive)

Parameters:

type - The type of the archive e.g. WebArchive

Returns:

An Assignable archive base

Throws:

java.lang.IllegalArgumentException - if type is not specified

UnknownExtensionTypeException - If no extension mapping is found for the specified type

create

public <T extends Assignable> T create(java.lang.Class<T> type,
                                       java.lang.String archiveName)
                                throws java.lang.IllegalArgumentException

Creates a new archive of the specified type. The archive will be be backed by the Configuration specific to this ArchiveFactory.

Parameters:

type - The type of the archive e.g. WebArchive

archiveName - the archiveName to use

Returns:

An Assignable view

Throws:

java.lang.IllegalArgumentException - either argument is not supplied

createFromZipFile

public <T extends Assignable> T createFromZipFile(java.lang.Class<T> type,
                                                  java.io.File archiveFile)
                                           throws java.lang.IllegalArgumentException,
                                                  ArchiveImportException

Creates a new archive of the specified type as imported from the specified File. The file is expected to be encoded as ZIP (ie. JAR/WAR/EAR). The name of the archive will be set to File.getName(). The archive will be be backed by the Configuration specific to this ArchiveFactory.

Parameters:

type - The type of the archive e.g. WebArchive

archiveFile - the archiveFile to use

Returns:

An Assignable view

Throws:

java.lang.IllegalArgumentException - If either argument is not supplied, if the specified File does not exist, or is not a valid ZIP file

ArchiveImportException - If an error occurred during the import process