Class JarGenerator

java.lang.Object

org.jdrupes.builder.core.AbstractProvider

org.jdrupes.builder.core.AbstractGenerator

org.jdrupes.builder.java.JarGenerator

All Implemented Interfaces:

Generator, Renamable, 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...).

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
protected void	adaptManifest(Manifest manifest)	Allows derived classes to adapt the manifest before writing the jar.
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 ResourceProviderSpi.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 ResourceProviderSpi.provide(ResourceRequest).
JarGenerator	name(String name)	Set the new name.
protected void	resolveDuplicates(Map<Path, Resources<IOResource>> entries)	Resolve duplicates.

Methods inherited from class AbstractGenerator

cleanup, newResource, project, toString

Methods inherited from class AbstractProvider

context, name, of, rename, vavrStream

Methods inherited from class Object

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

Methods inherited from interface ResourceProvider

context, name, of, of, resources

Constructor Details

JarGenerator

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

Initializes a new library generator.

Parameters:

project - the project

jarType - the type of jar that the generator generates

Method Details

name

public JarGenerator name(String name)

Description copied from interface: Renamable

Set the new name.

Specified by:

name in interface Renamable

Overrides:

name in class AbstractGenerator

Parameters:

name - the name

Returns:

the renamable

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 ResourceProviderSpi.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

adaptManifest

protected void adaptManifest(Manifest manifest)

Allows derived classes to adapt the manifest before writing the jar.

Parameters:

manifest - the manifest

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 ResourceProviderSpi.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