Interface ClassContainer<T extends Archive<T>>

All Superinterfaces:

ResourceContainer<T>

All Known Subinterfaces:

JavaArchive, ServiceProviderContainer<T>, WebArchive

public interface ClassContainer<T extends Archive<T>>
extends ResourceContainer<T>

Defines the contract for a component capable of storing Java Classes.

The actual path to the Class resources within the Archive is up to the implementations/specifications.

Version:

$Revision: $

Author:

Aslak Knutsen

Method Summary

Modifier and Type	Method	Description
T	addClass(Class<?> clazz)	Adds the Class, and all member (inner) Classes to the Archive.
T	addClass(String fullyQualifiedClassName)	Adds the Class, and all member (inner) Classes, with the specified fully-qualified name, loaded by the Thread Context ClassLoader, to the Archive.
T	addClass(String fullyQualifiedClassName, ClassLoader cl)	Adds the Class, and all member (inner) @link{Class}es, with the specified fully-qualified name, loaded by the specified ClassLoader, to the Archive.
T	addClasses(Class<?>... classes)	Adds the Classes, and all member (inner) Classes to the Archive.
T	addDefaultPackage()	Adds all classes in the default Package to the Archive.
T	addPackage(Package pack)	Adds all classes in the specified Package to the Archive.
T	addPackage(String pack)	Adds all classes in the specified Package to the Archive.
T	addPackages(boolean recursive, Package... packages)	Adds all classes in the specified Packages to the Archive.
T	addPackages(boolean recursive, String... packages)	Adds all classes in the specified Packages to the Archive.
T	addPackages(boolean recursive, Filter<ArchivePath> filter, Package... packages)	Adds all classes accepted by the filter in the specified Packages to the Archive.
T	addPackages(boolean recursive, Filter<ArchivePath> filter, String... packages)	Adds all classes accepted by the filter in the specified Packages to the Archive.
T	deleteClass(Class<?> clazz)	Deletes the Class, and all member (inner) Classes from the Archive.
T	deleteClass(String fullyQualifiedClassName)	Deletes the Class, and all member (inner) Classes, with the specified fully-qualified name, loaded by the Thread Context ClassLoader, from the Archive.
T	deleteClasses(Class<?>... classes)	Deletes the Classes, and all member (inner) Classes from the Archive.
T	deleteDefaultPackage()	Deletes all classes in the default Package from the Archive.
T	deletePackage(Package pack)	Deletes all classes in the specified Package from the Archive.
T	deletePackage(String pack)	Deletes all classes in the specified Package from the Archive.
T	deletePackages(boolean recursive, Package... packages)	Deletes all classes in the specified Packages from the Archive.
T	deletePackages(boolean recursive, String... packages)	Delete all classes in the specified Packages from the Archive.
T	deletePackages(boolean recursive, Filter<ArchivePath> filter, Package... packages)	Deletes all classes accepted by the filter in the specified Packages from the Archive.
T	deletePackages(boolean recursive, Filter<ArchivePath> filter, String... packages)	Delete all classes accepted by the filter in the specified Packages from the Archive.

Methods inherited from interface ResourceContainer

addAsResource, addAsResource, addAsResource, addAsResource, addAsResource, addAsResource, addAsResource, addAsResource, addAsResource, addAsResource, addAsResource, addAsResource, addAsResource, addAsResource, addAsResources

Method Details

addClass

T addClass(Class<?> clazz)
    throws IllegalArgumentException

Adds the Class, and all member (inner) Classes to the Archive.

Parameters:

clazz - The class to add to the Archive

Returns:

This archive

Throws:

IllegalArgumentException - If no class were specified

addClass

T addClass(String fullyQualifiedClassName)
    throws IllegalArgumentException

Adds the Class, and all member (inner) Classes, with the specified fully-qualified name, loaded by the Thread Context ClassLoader, to the Archive.

Parameters:

fullyQualifiedClassName - The name of the Class to add

Returns:

This archive

Throws:

IllegalArgumentException - If no class name was specified

IllegalArgumentException - If the Class could not be loaded

addClass

T addClass(String fullyQualifiedClassName,
 ClassLoader cl)
    throws IllegalArgumentException

Adds the Class, and all member (inner) @link{Class}es, with the specified fully-qualified name, loaded by the specified ClassLoader, to the Archive.

Parameters:

fullyQualifiedClassName - The name of the Class to add

cl - The ClassLoader used to load the Class

Returns:

This archive

Throws:

IllegalArgumentException - If no class name was specified

IllegalArgumentException - If no ClassLoader was specified

IllegalArgumentException - If the Class could not be loaded by the target ClassLoader

addClasses

T addClasses(Class<?>... classes)
      throws IllegalArgumentException

Adds the Classes, and all member (inner) Classes to the Archive.

Parameters:

classes - The classes to add to the Archive

Returns:

This archive

Throws:

IllegalArgumentException - If no classes were specified

addPackage

T addPackage(Package pack)
      throws IllegalArgumentException

Adds all classes in the specified Package to the Archive.
SubPackages are excluded.

Parameters:

pack - The Package to add

Returns:

This virtual archive

Throws:

IllegalArgumentException - If no package were specified

See Also:

• addPackages(boolean, Package...)

addDefaultPackage

T addDefaultPackage()

Adds all classes in the default Package to the Archive.
SubPackages are excluded.

Returns:

This virtual archive

addPackages

T addPackages(boolean recursive,
 Package... packages)
       throws IllegalArgumentException

Adds all classes in the specified Packages to the Archive.

Parameters:

recursive - Should the sub packages be added

packages - All the packages to add

Returns:

This virtual archive

Throws:

IllegalArgumentException - If no packages were specified

See Also:

• addPackages(boolean, Filter, Package...)

addPackages

T addPackages(boolean recursive,
 Filter<ArchivePath> filter,
 Package... packages)
       throws IllegalArgumentException

Adds all classes accepted by the filter in the specified Packages to the Archive.
The ArchivePath returned to the filter is the ArchivePath of the class, not the final location.
package.MyClass = /package/MyClass.class
not: package.MyClass = /WEB-INF/classes/package/MyClass.class

Parameters:

recursive - Should the sub packages be added

filter - filter out specific classes

packages - All the packages to add

Returns:

This virtual archive

Throws:

IllegalArgumentException - If no packages were specified

addPackage

T addPackage(String pack)
      throws IllegalArgumentException

Adds all classes in the specified Package to the Archive.
SubPackages are excluded.

Parameters:

pack - Package to add represented by a String ("my/package")

Returns:

This virtual archive

Throws:

IllegalArgumentException - If no package were specified

See Also:

• addPackages(boolean, Package...)

addPackages

T addPackages(boolean recursive,
 String... packages)
       throws IllegalArgumentException

Adds all classes in the specified Packages to the Archive.

Parameters:

recursive - Should the sub packages be added

packages - All the packages to add represented by a String ("my/package")

Returns:

This virtual archive

Throws:

IllegalArgumentException - If no packages were specified

See Also:

• addPackages(boolean, Filter, Package...)

addPackages

T addPackages(boolean recursive,
 Filter<ArchivePath> filter,
 String... packages)
       throws IllegalArgumentException

Adds all classes accepted by the filter in the specified Packages to the Archive.
The ArchivePath returned to the filter is the ArchivePath of the class, not the final location.
package.MyClass = /package/MyClass.class
not: package.MyClass = /WEB-INF/classes/package/MyClass.class

Parameters:

recursive - Should the sub packages be added

filter - filter out specific classes

packages - All the packages to add represented by a String ("my/package")

Returns:

This virtual archive

Throws:

IllegalArgumentException - If no packages were specified

deleteClass

T deleteClass(Class<?> clazz)
       throws IllegalArgumentException

Deletes the Class, and all member (inner) Classes from the Archive.

Parameters:

clazz - The class to be deleted from the Archive

Returns:

This archive

Throws:

IllegalArgumentException - If no class was specified

deleteClass

T deleteClass(String fullyQualifiedClassName)
       throws IllegalArgumentException

Deletes the Class, and all member (inner) Classes, with the specified fully-qualified name, loaded by the Thread Context ClassLoader, from the Archive.

Parameters:

fullyQualifiedClassName - The name of the Class to be deleted

Returns:

This archive

Throws:

IllegalArgumentException - If no class name was specified

IllegalArgumentException - If the Class could not be loaded

deleteClasses

T deleteClasses(Class<?>... classes)
         throws IllegalArgumentException

Deletes the Classes, and all member (inner) Classes from the Archive.

Parameters:

classes - The classes to be removed from the Archive

Returns:

This archive

Throws:

IllegalArgumentException - If no classes were specified

deletePackage

T deletePackage(Package pack)
         throws IllegalArgumentException

Deletes all classes in the specified Package from the Archive.
SubPackages are excluded.

Parameters:

pack - The Package to be deleted

Returns:

This archive

Throws:

IllegalArgumentException - If no package was specified

See Also:

• deletePackages(boolean, Package...)

deletePackage

T deletePackage(String pack)
         throws IllegalArgumentException

Deletes all classes in the specified Package from the Archive.
SubPackages are excluded.

Parameters:

pack - Package to be deleted represented by a String ("my/package")

Returns:

This archive

Throws:

IllegalArgumentException - If no package was specified

See Also:

• deletePackages(boolean, Package...)

deleteDefaultPackage

T deleteDefaultPackage()

Deletes all classes in the default Package from the Archive.
SubPackages are excluded.

Returns:

This archive

deletePackages

T deletePackages(boolean recursive,
 Package... packages)
          throws IllegalArgumentException

Deletes all classes in the specified Packages from the Archive.

Parameters:

recursive - Should the sub packages be deleted?

packages - All the packages to be deleted

Returns:

This archive

Throws:

IllegalArgumentException - If no packages were specified

See Also:

• deletePackages(boolean, Filter, Package...)

deletePackages

T deletePackages(boolean recursive,
 String... packages)
          throws IllegalArgumentException

Delete all classes in the specified Packages from the Archive.

Parameters:

recursive - Should the sub packages be deleted?

packages - All the packages to be deleted represented by a String ("my/package")

Returns:

This archive

Throws:

IllegalArgumentException - If no packages were specified

See Also:

• deletePackages(boolean, Filter, Package...)

deletePackages

T deletePackages(boolean recursive,
 Filter<ArchivePath> filter,
 Package... packages)
          throws IllegalArgumentException

Deletes all classes accepted by the filter in the specified Packages from the Archive.
The ArchivePath returned to the filter is the ArchivePath of the class, not the final location.
package.MyClass = /package/MyClass.class
not: package.MyClass = /WEB-INF/classes/package/MyClass.class

Parameters:

recursive - Should the sub packages be deleted?

filter - filter out specific classes

packages - All the packages to be deleted

Returns:

This archive

Throws:

IllegalArgumentException - If no packages were specified or if no filter was specified

deletePackages

T deletePackages(boolean recursive,
 Filter<ArchivePath> filter,
 String... packages)
          throws IllegalArgumentException

Delete all classes accepted by the filter in the specified Packages from the Archive.
The ArchivePath returned to the filter is the ArchivePath of the class, not the final location.
package.MyClass = /package/MyClass.class
not: package.MyClass = /WEB-INF/classes/package/MyClass.class

Parameters:

recursive - Should the sub packages be deleted?

filter - filter out specific classes

packages - All the packages to be deleted represented by a String ("my/package")

Returns:

This archive

Throws:

IllegalArgumentException - If no packages were specified or if no filter was specified