retrotranslator:translate

Full name:

org.codehaus.mojo:retrotranslator-maven-plugin:1.0-alpha-4:translate

Description:

Retrotranslates jars and classes.

Attributes:

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

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.
backport String - Informs the translator about user-defined backport packages. Package names should be separated by semicolons.
destdir File - The directory to place translated classes.
destjar File - The JAR file to place translated classes.
dirsets FileSet[] - Directories to include in the translation.
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.
filesets FileSet[] - Files to include in the translation.
jarfilesets FileSet[] - Jar files to include in the translation.
lazy boolean - Asks the translator to only transform classes compiled with a target greater than the current one. Default value is: false.
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

backport :

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

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

destdir :

The directory to place translated classes.

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

destjar :

The JAR file to place translated classes.

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

dirsets :

Directories to include in the translation.

  • Type: org.apache.maven.shared.model.fileset.FileSet[]
  • Required: No

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

filesets :

Files to include in the translation.

  • Type: org.apache.maven.shared.model.fileset.FileSet[]
  • Required: No

jarfilesets :

Jar files to include in the translation.

  • Type: org.apache.maven.shared.model.fileset.FileSet[]
  • Required: No

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

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