i18n:parserJava

Nom complet :

org.nuiton.i18n:i18n-maven-plugin:4.1:parserJava

Description :

To parse java files to detect new i18n keys. Note: this goal must always be invoked before the process-resources phase, otherwise all files will be considered as uptodate.

Attributs :

  • Exige un projet Maven pour être exécuté.
  • The goal is not marked as thread-safe and thus does not support parallel builds.
  • Depuis la version : 3.3.
  • S'associe par défaut dans la phase du cycle de vie : generate-resources.

Paramètres requis

Nom Type Depuis Description
<bundles> String 3.3 Locales to treate, separated by comma. Example :
fr_FR,en_GB

Valeur par défaut : fr_FR,en_GB.
Propriété utilisateur : i18n.bundles.
<defaultIncludes> String 3.3 Default included files to process (ant-like expression). Note: default value is **\/*.java
Valeur par défaut : **/*.java.
Propriété utilisateur : i18n.defaultIncludes.
<encoding> String 3.3 Encoding used to load and store properties.
Valeur par défaut : ${project.build.sourceEncoding}.
Propriété utilisateur : i18n.encoding.
<out> File 3.3 Directory where to generate i18n files.
Valeur par défaut : ${basedir}/target/generated-sources/i18n.
Propriété utilisateur : i18n.out.
<src> File 3.3 Directory where to find project i18n files.
Valeur par défaut : ${basedir}/src/main/resources/i18n.
Propriété utilisateur : i18n.src.

Paramètres optionnels

Nom Type Depuis Description
<acceptKeyFormat> String 2.5 A regex pattern to accept incoming keys. Only incoming keys which match the pattern will be kept.
Propriété utilisateur : i18n.acceptKeyFormat.
<backupGetter> boolean 1.0.2 Flag to save previous getter in a backup before doing parsing. Note: by default, do not perform backup (but it was here originaly so let it possible...)
Valeur par défaut : false.
Propriété utilisateur : i18n.backupGetter.
<cp> File 3.3 Build directory (used to know if files in sources are up-to-date).
Valeur par défaut : ${basedir}/target/classes.
Propriété utilisateur : i18n.cp.
<defaultBasedir> File 3.3 Root directory of the default entry.
Valeur par défaut : ${basedir}/src/main/java.
Propriété utilisateur : i18n.defaultBasedir.
<entries> I18nSourceEntry[] 3.3 Source entries (src+includes+excludes) to process.
Propriété utilisateur : i18n.entries.
<force> boolean 1.2 To force reparse of all sources.
Valeur par défaut : false.
Propriété utilisateur : i18n.force.
<outputGetter> String 2.0 Defines the file name of the getter where to put detected i18n keys while getter phase.
Valeur par défaut : java.getter.
Propriété utilisateur : i18n.outputGetter.
<showTouchedFiles> boolean 0.9 Flag to display touched files while parsing. Note: the value will be always true if verbose is set at true.
Valeur par défaut : ${maven.verbose}.
Propriété utilisateur : i18n.showTouchedFiles.
<silent> boolean 1.0.0-rc-5 Silent flag to see only errors in console.
Valeur par défaut : false.
Propriété utilisateur : i18n.silent.
<strictMode> boolean 3.3 Strict mode to only keep in user i18n detected i18n keys and remove obsolete keys. Note : By default not active. Use this with care since it can delete keys. Moreover if this flag is activated, then all files will be parsed.
Valeur par défaut : false.
Propriété utilisateur : i18n.strictMode.
<treateDefaultEntry> boolean 3.3 To treat default entry offered by the mojo.
Valeur par défaut : true.
Propriété utilisateur : i18n.treateDefaultEntry.
<verbose> boolean 3.3 Verbose flag. Note : if not setted, we used the maven.verbose property.
Valeur par défaut : ${maven.verbose}.
Propriété utilisateur : i18n.verbose.

Détails des paramètres

<acceptKeyFormat>

A regex pattern to accept incoming keys. Only incoming keys which match the pattern will be kept.
  • Type : java.lang.String
  • Depuis : 2.5
  • Exigé : Non
  • Propriété utilisateur : i18n.acceptKeyFormat

<backupGetter>

Flag to save previous getter in a backup before doing parsing. Note: by default, do not perform backup (but it was here originaly so let it possible...)
  • Type : boolean
  • Depuis : 1.0.2
  • Exigé : Non
  • Propriété utilisateur : i18n.backupGetter
  • Défaut : false

<bundles>

Locales to treate, separated by comma. Example :
fr_FR,en_GB
  • Type : java.lang.String
  • Depuis : 3.3
  • Exigé : Oui
  • Propriété utilisateur : i18n.bundles
  • Défaut : fr_FR,en_GB

<cp>

Build directory (used to know if files in sources are up-to-date).
  • Type : java.io.File
  • Depuis : 3.3
  • Exigé : Non
  • Propriété utilisateur : i18n.cp
  • Défaut : ${basedir}/target/classes

<defaultBasedir>

Root directory of the default entry.
  • Type : java.io.File
  • Depuis : 3.3
  • Exigé : Non
  • Propriété utilisateur : i18n.defaultBasedir
  • Défaut : ${basedir}/src/main/java

<defaultIncludes>

Default included files to process (ant-like expression). Note: default value is **\/*.java
  • Type : java.lang.String
  • Depuis : 3.3
  • Exigé : Oui
  • Propriété utilisateur : i18n.defaultIncludes
  • Défaut : **/*.java

<encoding>

Encoding used to load and store properties.
  • Type : java.lang.String
  • Depuis : 3.3
  • Exigé : Oui
  • Propriété utilisateur : i18n.encoding
  • Défaut : ${project.build.sourceEncoding}

<entries>

Source entries (src+includes+excludes) to process.
  • Type : org.nuiton.i18n.plugin.parser.I18nSourceEntry[]
  • Depuis : 3.3
  • Exigé : Non
  • Propriété utilisateur : i18n.entries

<force>

To force reparse of all sources.
  • Type : boolean
  • Depuis : 1.2
  • Exigé : Non
  • Propriété utilisateur : i18n.force
  • Défaut : false

<out>

Directory where to generate i18n files.
  • Type : java.io.File
  • Depuis : 3.3
  • Exigé : Oui
  • Propriété utilisateur : i18n.out
  • Défaut : ${basedir}/target/generated-sources/i18n

<outputGetter>

Defines the file name of the getter where to put detected i18n keys while getter phase.
  • Type : java.lang.String
  • Depuis : 2.0
  • Exigé : Non
  • Propriété utilisateur : i18n.outputGetter
  • Défaut : java.getter

<showTouchedFiles>

Flag to display touched files while parsing. Note: the value will be always true if verbose is set at true.
  • Type : boolean
  • Depuis : 0.9
  • Exigé : Non
  • Propriété utilisateur : i18n.showTouchedFiles
  • Défaut : ${maven.verbose}

<silent>

Silent flag to see only errors in console.
  • Type : boolean
  • Depuis : 1.0.0-rc-5
  • Exigé : Non
  • Propriété utilisateur : i18n.silent
  • Défaut : false

<src>

Directory where to find project i18n files.
  • Type : java.io.File
  • Depuis : 3.3
  • Exigé : Oui
  • Propriété utilisateur : i18n.src
  • Défaut : ${basedir}/src/main/resources/i18n

<strictMode>

Strict mode to only keep in user i18n detected i18n keys and remove obsolete keys. Note : By default not active. Use this with care since it can delete keys. Moreover if this flag is activated, then all files will be parsed.
  • Type : boolean
  • Depuis : 3.3
  • Exigé : Non
  • Propriété utilisateur : i18n.strictMode
  • Défaut : false

<treateDefaultEntry>

To treat default entry offered by the mojo.
  • Type : boolean
  • Depuis : 3.3
  • Exigé : Non
  • Propriété utilisateur : i18n.treateDefaultEntry
  • Défaut : true

<verbose>

Verbose flag. Note : if not setted, we used the maven.verbose property.
  • Type : boolean
  • Depuis : 3.3
  • Exigé : Non
  • Propriété utilisateur : i18n.verbose
  • Défaut : ${maven.verbose}