Apache MyFaces
Overview
Users Guide
Project Documentation
Available Modules
Foundation

myfaces-builder:make-converters

Maven goal to generate java source code for Converter classes.

It uses velocity to generate templates, and has the option to define custom templates.

The executed template has the following variables available to it:

  • utils : Returns an instance of org.apache.myfaces.buildtools.maven2.plugin.builder.utils.MyfacesUtils, it contains some useful methods.
  • converter : Returns the current instance of org.apache.myfaces.buildtools.maven2.plugin.builder.model.ConverterMeta

Mojo Attributes:

  • Requires a Maven 2.0 project to execute.
  • Requires dependency resolution of artifacts in scope: compile
  • Automatically executes within the lifecycle phase: generate-sources

Optional Parameters

Name Type Description
force boolean Log and continue execution when generating converter classes.

If this property is set to false (default), errors when a converter class is generated stops execution immediately.

generatedSourceDirectory File The directory where all generated files are created. This directory is added as a compile source root automatically like src/main/java is.
jsfVersion String Defines the jsf version (1.1 or 1.2), used to take the default templates for each version.

If version is 1.1, the default templateConverterName is 'converterClass11.vm' and if version is 1.2 the default templateConverterName is 'converterClass12.vm'.

mainSourceDirectory File This param is used to search in this folder if some file to be generated exists and avoid generation and duplicate exception.
mainSourceDirectory2 File This param is used to search in this folder if some file to be generated exists and avoid generation and duplicate exception.
metadataFile String Injected name of file generated by earlier run of BuildMetaDataMojo goal.
modelIds List Define the models that should be included when generate converter classes. If not set, the current model identified by the artifactId is used.

Each model built by build-metadata goal has a modelId, that by default is the artifactId of the project. Setting this property defines which objects tied in a specified modelId should be taken into account.

In this case, limit converter tag generation only to the components defined in the models identified by the modelId defined.

This is useful when you need to generate files that take information defined on other projects.

Example:

<modelIds>
<modelId>model1</modelId>
<modelId>model2</modelId>
</modelIds>
packageContains String Only generate tag classes that contains that package prefix
templateConverterName String The name of the template used to generate converter classes. According to the value on jsfVersion property the default if this property is not set could be converterClass11.vm (1.1) or converterClass12.vm (1.2)
templateSourceDirectory File The directory used to load templates into velocity environment.

Parameter Details

force

Log and continue execution when generating converter classes.

If this property is set to false (default), errors when a converter class is generated stops execution immediately.

  • Type: boolean
  • Required: No

generatedSourceDirectory

The directory where all generated files are created. This directory is added as a compile source root automatically like src/main/java is.

  • Type: java.io.File
  • Required: No
  • Expression: ${project.build.directory}/generated-sources/myfaces-builder-plugin

jsfVersion

Defines the jsf version (1.1 or 1.2), used to take the default templates for each version.

If version is 1.1, the default templateConverterName is 'converterClass11.vm' and if version is 1.2 the default templateConverterName is 'converterClass12.vm'.

  • Type: java.lang.String
  • Required: No

mainSourceDirectory

This param is used to search in this folder if some file to be generated exists and avoid generation and duplicate exception.

  • Type: java.io.File
  • Required: No
  • Expression: src/main/java

mainSourceDirectory2

This param is used to search in this folder if some file to be generated exists and avoid generation and duplicate exception.

  • Type: java.io.File
  • Required: No

metadataFile

Injected name of file generated by earlier run of BuildMetaDataMojo goal.

  • Type: java.lang.String
  • Required: No

modelIds

Define the models that should be included when generate converter classes. If not set, the current model identified by the artifactId is used.

Each model built by build-metadata goal has a modelId, that by default is the artifactId of the project. Setting this property defines which objects tied in a specified modelId should be taken into account.

In this case, limit converter tag generation only to the components defined in the models identified by the modelId defined.

This is useful when you need to generate files that take information defined on other projects.

Example:

<modelIds>
<modelId>model1</modelId>
<modelId>model2</modelId>
</modelIds>
  • Type: java.util.List
  • Required: No

packageContains

Only generate tag classes that contains that package prefix

  • Type: java.lang.String
  • Required: No

templateConverterName

The name of the template used to generate converter classes. According to the value on jsfVersion property the default if this property is not set could be converterClass11.vm (1.1) or converterClass12.vm (1.2)

  • Type: java.lang.String
  • Required: No

templateSourceDirectory

The directory used to load templates into velocity environment.

  • Type: java.io.File
  • Required: No
  • Expression: src/main/resources/META-INF