Class JavaExecutor

java.lang.Object

org.jdrupes.builder.core.AbstractProvider

org.jdrupes.builder.java.JavaExecutor

All Implemented Interfaces:

Renamable, RequiredResourceSupport, ResourceProvider, ResourceRetriever

public class JavaExecutor
extends AbstractProvider
implements ResourceRetriever, Renamable, RequiredResourceSupport

A provider for execution resultss from invoking a JVM.

The working directory is the project directory.

JPMS support

When module is set, execution uses --module instead of -cp. Modular classpath elements are placed on the --module-path and the main class is specified as module/class. Non-modular elements remain on the classpath (-cp).

Constructor Summary

Constructors

Constructor	Description
JavaExecutor(Project project)	Initializes a new java executor.

Method Summary

Modifier and Type	Method	Description
JavaExecutor	addFrom(Stream<ResourceProvider> providers)	Additionally uses the given providers for obtaining required resources.
JavaExecutor	addFrom(ResourceProvider... providers)	Additionally uses the given providers for obtaining required resources.
JavaExecutor	args(String... args)	Add the given arguments.
protected <T extends Resource> Collection<T>	doProvide(ResourceRequest<T> requested)	Invoked by ResourceProviderSpi.provide(ResourceRequest) after checking if the invocation is allowed.
String	mainClass()	Returns the main class.
JavaExecutor	mainClass(String mainClass)	Sets the main class.
String	module()	Returns the module name for module-path execution.
JavaExecutor	module(String module)	Sets the module name for module-path execution.
JavaExecutor	name(String name)	Set the new name.
JavaExecutor	required(Path root)	Convenience method that adds a FileResource to the required resources.
JavaExecutor	required(Path root, String pattern)	Convenience method that adds a FileTree to the required resources.
JavaExecutor	required(Stream<? extends Resource> resources)	Adds the given Stream of resources to the required resources.
String	toString()	To string.

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, resources

Constructor Details

JavaExecutor

public JavaExecutor(Project project)

Initializes a new java executor.

Parameters:

project - the project

Method Details

name

public JavaExecutor name(String name)

Description copied from interface: Renamable

Set the new name.

Specified by:

name in interface Renamable

Parameters:

name - the name

Returns:

the renamable

required

public JavaExecutor required(Stream<? extends Resource> resources)

Description copied from interface: RequiredResourceSupport

Adds the given Stream of resources to the required resources.

Specified by:

required in interface RequiredResourceSupport

Parameters:

resources - the resources

Returns:

the provider

required

public JavaExecutor required(Path root,
 String pattern)

Description copied from interface: RequiredResourceSupport

Convenience method that adds a FileTree to the required resources. If root is relative, it is resolved against the project's directory.

Specified by:

required in interface RequiredResourceSupport

Parameters:

root - the root

pattern - the pattern

Returns:

the provider

required

public JavaExecutor required(Path root)

Description copied from interface: RequiredResourceSupport

Convenience method that adds a FileResource to the required resources. If path is relative, it is resolved against the project's directory.

Specified by:

required in interface RequiredResourceSupport

Parameters:

root - the file

Returns:

the provider

addFrom

public JavaExecutor addFrom(ResourceProvider... providers)

Additionally uses the given providers for obtaining required resources.

Specified by:

addFrom in interface ResourceRetriever

Parameters:

providers - the providers

Returns:

the java executor

addFrom

public JavaExecutor addFrom(Stream<ResourceProvider> providers)

Additionally uses the given providers for obtaining required resources.

Specified by:

addFrom in interface ResourceRetriever

Parameters:

providers - the providers

Returns:

the java executor

mainClass

public String mainClass()

Returns the main class.

Returns:

the main class

mainClass

public JavaExecutor mainClass(String mainClass)

Sets the main class.

Parameters:

mainClass - the new main class

Returns:

the jar generator for method chaining

module

public String module()

Returns the module name for module-path execution.

Returns:

the module name

module

public JavaExecutor module(String module)

Sets the module name for module-path execution. When set, the executor uses --module module/class instead of -cp ... class. Modular code contributions are placed on --module-path.

Parameters:

module - the module name

Returns:

this executor

args

public JavaExecutor args(String... args)

Add the given arguments.

Parameters:

args - the arguments

Returns:

the java executor

doProvide

protected <T extends Resource> Collection<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 request for resources

Returns:

the stream

toString

public String toString()

To string.

Overrides:

toString in class AbstractProvider

Returns:

the string