retrotranslator:translate-project

Full name:

org.codehaus.mojo:retrotranslator-maven-plugin:1.0-beta-1-SNAPSHOT:translate-project

Description:

Retrotranslates the artifact for the current project.

Attributes:

  • Requires a Maven 2.0 project to be executed.
  • Binds by default to the lifecycle phase: package.

Required Parameters

Name Type Since Description
baseName String - The base-name of the generated artifact.
outputDirectory File - Where to put the translated artifact.

Optional Parameters

Name Type Since Description
advanced boolean - Whether to use alternative implementations of Java 1.4 classes and methods for better Java 5 compatibility. Default value is: false.
attach boolean - Flag to enable/disable attaching retrotranslated artifacts. Default value is: true.
backport String - Informs the translator about user-defined backport packages. Package names should be separated by semicolons.
classifier String - The classifier used when attaching the retrotranslated project artifact. Default value is: jdk14.
destJar File - (no description)
embed String - The package name for a private copy of retrotranslator-runtime-n.n.n.jar and backport-util-concurrent-n.n.jar to be put with translated classes.
failonwarning boolean - Fails build when verification has failed. Default value is: true.
lazy boolean - Asks the translator to only transform classes compiled with a target greater than the current one. Default value is: false.
replace boolean - Replace the artifact with the retrotranslated artifact.
retainapi boolean - Asks the translator to modify classes for JVM 1.4 compatibility but keep use of Java 5 API. Default value is: false.
retainflags boolean - Asks the translator to keep Java 5 specific access modifiers. Default value is: false.
srcmask String - The wildcard pattern specifying files that should be translated (either bytecode or UTF-8 text), e.g. "*.class*.tld". There are three special characters: "*?". Default value is: *.class.
stripsign boolean - Asks the translator to strip signature (generics) information. Default value is: false.
target String - To make Java 6 classes compatible with Java 5 set this option to 1.5 and supply user-defined backport packages. Default value is: 1.4.
verbose boolean - Asks the translator for verbose output. Default value is: false.
verify boolean - Asks the translator to examine translated bytecode for references to classes, methods, or fields that cannot be found in the provided classpath. Default value is: false.
verifyClasspath List - The classpath for the verification including rt.jar, jce.jar, jsse.jar (from JRE 1.4). The retrotranslator-runtime-n.n.n.jar, and backport-util-concurrent-n.n.jar are included by default, they are not required to be defined here.

Parameter Details

advanced :

Whether to use alternative implementations of Java 1.4 classes and methods for better Java 5 compatibility.

  • Type: boolean
  • Required: No
  • Expression: ${advanced}
  • Default: false

attach :

Flag to enable/disable attaching retrotranslated artifacts.

  • Type: boolean
  • Required: No
  • Expression: ${attach}
  • Default: true

backport :

Informs the translator about user-defined backport packages. Package names should be separated by semicolons.

  • Type: java.lang.String
  • Required: No
  • Expression: ${backport}

baseName :

The base-name of the generated artifact.

  • Type: java.lang.String
  • Required: Yes
  • Expression: ${project.build.finalName}

classifier :

The classifier used when attaching the retrotranslated project artifact.

  • Type: java.lang.String
  • Required: No
  • Expression: ${classifier}
  • Default: jdk14

destJar :

(no description)

  • Type: java.io.File
  • Required: No
  • Expression: ${destJar}

embed :

The package name for a private copy of retrotranslator-runtime-n.n.n.jar and backport-util-concurrent-n.n.jar to be put with translated classes.

  • Type: java.lang.String
  • Required: No
  • Expression: ${embed}

failonwarning :

Fails build when verification has failed.

  • Type: boolean
  • Required: No
  • Expression: ${failonwarning}
  • Default: true

lazy :

Asks the translator to only transform classes compiled with a target greater than the current one.

  • Type: boolean
  • Required: No
  • Expression: ${lazy}
  • Default: false

outputDirectory :

Where to put the translated artifact.

  • Type: java.io.File
  • Required: Yes
  • Expression: ${project.build.directory}

replace :

Replace the artifact with the retrotranslated artifact.

  • Type: boolean
  • Required: No
  • Expression: ${replace}

retainapi :

Asks the translator to modify classes for JVM 1.4 compatibility but keep use of Java 5 API.

  • Type: boolean
  • Required: No
  • Expression: ${retainapi}
  • Default: false

retainflags :

Asks the translator to keep Java 5 specific access modifiers.

  • Type: boolean
  • Required: No
  • Expression: ${retainflags}
  • Default: false

srcmask :

The wildcard pattern specifying files that should be translated (either bytecode or UTF-8 text), e.g. "*.class*.tld". There are three special characters: "*?".

  • Type: java.lang.String
  • Required: No
  • Expression: ${srcmask}
  • Default: *.class

stripsign :

Asks the translator to strip signature (generics) information.

  • Type: boolean
  • Required: No
  • Expression: ${stripsign}
  • Default: false

target :

To make Java 6 classes compatible with Java 5 set this option to 1.5 and supply user-defined backport packages.

  • Type: java.lang.String
  • Required: No
  • Expression: ${target}
  • Default: 1.4

verbose :

Asks the translator for verbose output.

  • Type: boolean
  • Required: No
  • Expression: ${verbose}
  • Default: false

verify :

Asks the translator to examine translated bytecode for references to classes, methods, or fields that cannot be found in the provided classpath.

  • Type: boolean
  • Required: No
  • Expression: ${verify}
  • Default: false

verifyClasspath :

The classpath for the verification including rt.jar, jce.jar, jsse.jar (from JRE 1.4). The retrotranslator-runtime-n.n.n.jar, and backport-util-concurrent-n.n.jar are included by default, they are not required to be defined here.

  • Type: java.util.List
  • Required: No