com.threecrickets.sincerity.packaging

Class Packages

java.lang.Object

java.util.AbstractCollection<E>

java.util.AbstractList<E>

java.util.ArrayList<Package>

com.threecrickets.sincerity.packaging.Packages

All Implemented Interfaces:

Serializable, Cloneable, Iterable<Package>, Collection<Package>, List<Package>, RandomAccess

public class Packages
extends ArrayList<Package>

Manages the packages defined in a classpath.

This class works by scanning the entire classpath for packages defined in the JVM resources manifests, and parsing them. See Package for more information.

Author:

Tal Liron

See Also:

Manifest, Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static String	MANIFEST

Fields inherited from class java.util.AbstractList

modCount

Constructor Summary

Constructors

Constructor and Description
Packages(PackagingContext packagingContext) Initializes all packages in the container's classpath.

Method Summary

Modifier and Type	Method and Description
Package	getPackage(File file) Finds a package based on its package file (a Jar).
Package	getPackageForArtifact(File file) Finds the package that contains the artifact.
void	install(ArtifactManager managedArtifacts, String filter, boolean overwrite, boolean verify) Unpacks all artifacts and runs package installers.
void	uninstall() Runs all package uninstallers.

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 class java.util.AbstractList

equals, hashCode

Methods inherited from class java.util.AbstractCollection

containsAll, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface java.util.List

containsAll, equals, hashCode

Methods inherited from interface java.util.Collection

parallelStream, stream

Field Detail

MANIFEST

public static final String MANIFEST

See Also:

Constant Field Values

Constructor Detail

Packages

public Packages(PackagingContext packagingContext)
         throws SincerityException

Initializes all packages in the container's classpath.

Parameters:

packagingContext - The packaging context

Throws:

SincerityException - In case of an error

Method Detail

getPackage

public Package getPackage(File file)

Finds a package based on its package file (a Jar).

Parameters:

file - The package file

Returns:

The package or null

getPackageForArtifact

public Package getPackageForArtifact(File file)

Finds the package that contains the artifact.

Parameters:

file - The artifact file

Returns:

The package or null

install

public void install(ArtifactManager managedArtifacts,
                    String filter,
                    boolean overwrite,
                    boolean verify)
             throws SincerityException

Unpacks all artifacts and runs package installers.

Parameters:

managedArtifacts - The managed artifacts

filter - Filter artifacts (currently unused)

overwrite - True to force overwriting of modified artifacts

verify - Whether to verify the unpacking

Throws:

SincerityException - In case of an error

See Also:

Package.unpack(String, ArtifactManager, boolean, boolean)

uninstall

public void uninstall()
               throws SincerityException

Runs all package uninstallers.

Does not prune previously installed artifacts.

Throws:

SincerityException - In case of an error