org.apache.maven.shared.utils.cli.javatool
Interface JavaTool<Request extends JavaToolRequest>

All Known Implementing Classes:

AbstractJavaTool

public interface JavaTool<Request extends JavaToolRequest>

Describes a java tool, means a executable available in the jdk.

The name of the tool (getJavaToolName()) reflects the name of the executable that should exists as an executable in the jdk, like jarsigner, keytool, javadoc, ....

An abstract implementation of the JavaTool named AbstractJavaTool use the command line API to execute any user requests of this tool.

Since:

0.5

Author:

Tony Chemit

getJavaToolName

String getJavaToolName()

Return the name of the java tool. This is exactly the name (without his extension) of the executable to find in the jdk/bin directory.

For example: jarsigner, keytool, javadoc, ...

Returns:

the name of the java tool.

setToolchain

void setToolchain(org.apache.maven.toolchain.Toolchain toolchain)

Set an optional tool chain to find out the java tool executable location.

Parameters:

toolchain - optional tool chain to find out the java tool executable location.

execute

JavaToolResult execute(Request request)
                       throws JavaToolException

Execute the input request and then returns the result of the execution.

If could not create the java tool invocation, a JavaToolException will be thrown.

If execution fails, then the result will have a none-zero JavaToolResult.getExitCode() and his JavaToolResult.getExecutionException() will be filled with the error, otherwise the exist code will be zero.

Parameters:

request - the request to perform

Returns:

the result of the tool execution

Throws:

JavaToolException - if could not create the java tool invocation