tentackle:analyze

Full name:

org.tentackle:tentackle-maven-plugin:21.16.1.0:analyze

Description:

Generates code and meta-information prior to wurbeling and compiling the sources.

Processes all annotations annotated with @Analyze, such as @Service.
Processing results are either written to files in analyzeDir or placed on heap for being picked up by wurblets, depending on the handler implementation for each annotation.

Attributes:

  • Requires a Maven project to be executed.
  • Requires dependency resolution of artifacts in scope: compile.
  • The goal is not marked as thread-safe and thus does not support parallel builds.
  • Binds by default to the lifecycle phase: generate-sources.

Required Parameters

Name Type Since Description
<analyzeDir> File - Directory for the analyze-results.
Default: ${project.build.directory}/analyze
User Property: wurbel.analyzeDir
<servicesDir> File - Directory for the generated services.
Default: ${project.build.directory}/generated-resources/services
User Property: tentackle.serviceDir
<sourceDir> File - Directory holding the sources to be processed.
Defaults to all java sources of the current project. If this is not desired, filesets must be used.
Default: ${project.build.sourceDirectory}
User Property: wurbel.sourceDir

Optional Parameters

Name Type Since Description
<charset> String - The encoding to read and write files.
Default: ${project.build.sourceEncoding}
<compilerArgs> List<String> - Arguments to be passed to the compiler.
(see maven-compiler-plugin)
<compilerArgument> String - Sets the unformatted single argument string to be passed to the compiler.
(see maven-compiler-plugin)
<encoding> String - Source file encode.
Default: ${project.build.sourceEncoding}
<filesets> List<FileSet> - The list of file sets.
If set the source directory is ignored.
<index> String - Optional generated index holding the generated services.
Example: <index>META-INF/RESOURCE-INDEX.LIST</index>
<jdkToolchain> Map<String,String> - Toolchain for invocation of external tools.
Explicitly specifies the "jdk" toolchain for this plugin only. Overrides the toolchain selected by the maven-toolchain-plugin, if any.

Example:

  <jdkToolchain>
    <version>14</version>
  </jdkToolchain>
To deselect the toolchain configured by the maven-toolchain-plugin:
  <jdkToolchain></jdkToolchain>
<minLogLevel> String - The minimum logging java.util.logging.Level to redirect java.util logging to the maven logger.
Default: WARNING
<showCompileOutput> boolean - Show compile output.
Default: ${tentackle.showCompileOutput}
<skip> Boolean - Skips processing.
Defaults to true if packaging is "pom".
<verbosity> String - The verbosity.
One of "default", "info" or "debug". Debug is also turned on (if not set explicitly) by Maven's global debug flag (see command line switch -X).
Default: ${tentackle.verbosity}

Parameter Details

<analyzeDir>

Directory for the analyze-results.
  • Type: java.io.File
  • Required: Yes
  • User Property: wurbel.analyzeDir
  • Default: ${project.build.directory}/analyze

<charset>

The encoding to read and write files.
  • Type: java.lang.String
  • Required: No
  • Default: ${project.build.sourceEncoding}

<compilerArgs>

Arguments to be passed to the compiler.
(see maven-compiler-plugin)
  • Type: java.util.List<java.lang.String>
  • Required: No

<compilerArgument>

Sets the unformatted single argument string to be passed to the compiler.
(see maven-compiler-plugin)
  • Type: java.lang.String
  • Required: No

<encoding>

Source file encode.
  • Type: java.lang.String
  • Required: No
  • Default: ${project.build.sourceEncoding}

<filesets>

The list of file sets.
If set the source directory is ignored.
  • Type: java.util.List<org.apache.maven.shared.model.fileset.FileSet>
  • Required: No

<index>

Optional generated index holding the generated services.
Example: <index>META-INF/RESOURCE-INDEX.LIST</index>
  • Type: java.lang.String
  • Required: No

<jdkToolchain>

Toolchain for invocation of external tools.
Explicitly specifies the "jdk" toolchain for this plugin only. Overrides the toolchain selected by the maven-toolchain-plugin, if any.

Example:

  <jdkToolchain>
    <version>14</version>
  </jdkToolchain>
To deselect the toolchain configured by the maven-toolchain-plugin:
  <jdkToolchain></jdkToolchain>
  • Type: java.util.Map<java.lang.String, java.lang.String>
  • Required: No

<minLogLevel>

The minimum logging java.util.logging.Level to redirect java.util logging to the maven logger.
  • Type: java.lang.String
  • Required: No
  • Default: WARNING

<servicesDir>

Directory for the generated services.
  • Type: java.io.File
  • Required: Yes
  • User Property: tentackle.serviceDir
  • Default: ${project.build.directory}/generated-resources/services

<showCompileOutput>

Show compile output.
  • Type: boolean
  • Required: No
  • Default: ${tentackle.showCompileOutput}

<skip>

Skips processing.
Defaults to true if packaging is "pom".
  • Type: java.lang.Boolean
  • Required: No

<sourceDir>

Directory holding the sources to be processed.
Defaults to all java sources of the current project. If this is not desired, filesets must be used.
  • Type: java.io.File
  • Required: Yes
  • User Property: wurbel.sourceDir
  • Default: ${project.build.sourceDirectory}

<verbosity>

The verbosity.
One of "default", "info" or "debug". Debug is also turned on (if not set explicitly) by Maven's global debug flag (see command line switch -X).
  • Type: java.lang.String
  • Required: No
  • Default: ${tentackle.verbosity}