Class JarGenerator

java.lang.Object

org.jdrupes.builder.core.AbstractProvider

org.jdrupes.builder.core.AbstractGenerator

org.jdrupes.builder.java.JarGenerator

All Implemented Interfaces:

Generator, ResourceProvider

Direct Known Subclasses:

JavadocJarGenerator, LibraryGenerator, SourcesJarGenerator

public class JarGenerator
extends AbstractGenerator

A general purpose generator for jars. All contents must be added explicitly using add(Entry...) or add(FileTree...).

Field Summary

Fields inherited from class AbstractProvider

log

Constructor Summary

Constructors

Constructor	Description
JarGenerator(Project project, ResourceType<? extends JarFile> jarType)	Instantiates a new library generator.

Method Summary

Modifier and Type	Method	Description
JarGenerator	add(Map.Entry<Path, ? extends IOResource>... entries)	Convenience method for adding a single entry, see addEntries(Stream).
JarGenerator	add(FileTree<?>... trees)	Convenience method for adding entries, see addTrees(Stream).
JarGenerator	addEntries(Stream<? extends Map.Entry<Path, ? extends IOResource>> entries)	Adds single resources to the jar.
JarGenerator	addTrees(Stream<? extends FileTree<?>> trees)	Adds the given FileTrees.
final JarGenerator	attributes(Map.Entry<Attributes.Name, String>... attributes)	Add the given attributes to the manifest.
JarGenerator	attributes(Stream<Map.Entry<Attributes.Name, String>> attributes)	Add the given attributes to the manifest.
protected void	buildJar(JarFile jarResource)	Builds the jar.
protected void	collect(Map<Path, Resources<IOResource>> collected, FileTree<?> fileTree)	Adds the resources from the given file tree to the given contents.
protected void	collectContents(Map<Path, Resources<IOResource>> contents)	Add the contents from the added streams as preliminary jar entries.
Path	destination()	Returns the destination directory.
JarGenerator	destination(Path destination)	Sets the destination directory.
JarGenerator	destination(Supplier<Path> destination)	Sets the destination directory.
protected <T extends Resource> Stream<T>	doProvide(ResourceRequest<T> requested)	Invoked by AbstractProvider.provide(ResourceRequest) after checking if the invocation is allowed.
String	jarName()	Returns the name of the generated jar file.
JarGenerator	jarName(String jarName)	Sets the name of the generated jar file.
JarGenerator	jarName(Supplier<String> jarName)	Sets the supplier for obtaining the name of the generated jar file in AbstractProvider.provide(ResourceRequest).
protected void	resolveDuplicates(Map<Path, Resources<IOResource>> entries)	Resolve duplicates.

Methods inherited from class AbstractGenerator

cleanup, name, name, newResource, project, toString

Methods inherited from class AbstractProvider

provide

Methods inherited from class Object

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

Methods inherited from interface ResourceProvider

provide

Constructor Details

JarGenerator

public JarGenerator(Project project,
 ResourceType<? extends JarFile> jarType)

Instantiates a new library generator.

Parameters:

project - the project

jarType - the type of jar that the generator generates

Method Details

destination

public Path destination()

Returns the destination directory. Defaults to sub directory libs in the project's build directory (see Project.buildDirectory()).

Returns:

the destination

destination

public JarGenerator destination(Path destination)

Sets the destination directory. The Path is resolved against the project's build directory (see Project.buildDirectory()).

Parameters:

destination - the new destination

Returns:

the jar generator

destination

public JarGenerator destination(Supplier<Path> destination)

Sets the destination directory.

Parameters:

destination - the new destination

Returns:

the jar generator

jarName

public String jarName()

Returns the name of the generated jar file. Defaults to the project's name followed by its version and .jar.

Returns:

the string

jarName

public JarGenerator jarName(Supplier<String> jarName)

Sets the supplier for obtaining the name of the generated jar file in AbstractProvider.provide(ResourceRequest).

Parameters:

jarName - the jar name

Returns:

the jar generator

jarName

public JarGenerator jarName(String jarName)

Sets the name of the generated jar file.

Parameters:

jarName - the jar name

Returns:

the jar generator

attributes

public JarGenerator attributes(Stream<Map.Entry<Attributes.Name, String>> attributes)

Add the given attributes to the manifest.

Parameters:

attributes - the attributes

Returns:

the library generator

attributes

@SafeVarargs
public final JarGenerator attributes(Map.Entry<Attributes.Name, String>... attributes)

Add the given attributes to the manifest.

Parameters:

attributes - the attributes

Returns:

the library generator

addEntries

public JarGenerator addEntries(Stream<? extends Map.Entry<Path, ? extends IOResource>> entries)

Adds single resources to the jar. Each entry is added to the jar as entry with the name passed in the key attribute of the Map.Entry with the content from the IOResource in the value attribute.

Parameters:

entries - the entries

Returns:

the jar generator

addTrees

public JarGenerator addTrees(Stream<? extends FileTree<?>> trees)

Adds the given FileTrees. Each file in the tree will be added as an entry using its relative path in the tree as name.

Parameters:

trees - the trees

Returns:

the jar generator

add

public JarGenerator add(FileTree<?>... trees)

Convenience method for adding entries, see addTrees(Stream).

Parameters:

trees - the trees

Returns:

the jar generator

add

public JarGenerator add(Map.Entry<Path, ? extends IOResource>... entries)

Convenience method for adding a single entry, see addEntries(Stream).

Parameters:

entries - the entry

Returns:

the jar generator

buildJar

protected void buildJar(JarFile jarResource)

Builds the jar.

Parameters:

jarResource - the jar resource

collectContents

protected void collectContents(Map<Path, Resources<IOResource>> contents)

Add the contents from the added streams as preliminary jar entries. Must be overridden by derived classes that define additional ways to provide contents. The overriding method must invoke super.collectEntries(...).

Parameters:

contents - the preliminary contents

collect

protected void collect(Map<Path, Resources<IOResource>> collected,
 FileTree<?> fileTree)

Adds the resources from the given file tree to the given contents. May be used by derived classes while collecting contents for the jar.

Parameters:

collected - the preliminary contents

fileTree - the file tree

resolveDuplicates

protected void resolveDuplicates(Map<Path, Resources<IOResource>> entries)

Resolve duplicates. The default implementation outputs a warning and skips the duplicate entry.

Parameters:

entries - the entries

doProvide

protected <T extends Resource> Stream<T> doProvide(ResourceRequest<T> requested)

Description copied from class: AbstractProvider

Invoked by AbstractProvider.provide(ResourceRequest) after checking if the invocation is allowed.

Specified by:

doProvide in class AbstractProvider

Type Parameters:

T - the generic type

Parameters:

requested - the requested

Returns:

the stream