idea:module

Full name:

org.apache.maven.plugins:maven-idea-plugin:2.2:module

Description:

Creates the module files (*.iml) for IntelliJ IDEA.

Attributes:

  • Requires a Maven 2.0 project to be executed.
  • Invokes the execution of the lifecycle phase generate-sources prior to executing itself.

Optional Parameters

Name Type Since Description
dependenciesAsLibraries boolean - Causes the module libraries to use a short name for all dependencies. This is very convenient but has been reported to cause problems with IDEA. Default value is: false.
deploymentDescriptorFile String - Specify the location of the deployment descriptor file, if one is provided.
downloadJavadocs boolean - Enables/disables the downloading of javadoc attachments. Default value is: false.
downloadSources boolean - Enables/disables the downloading of source attachments. Default value is: false.
exclude String - A comma-separated list of directories that should be excluded. These directories are in addition to those already excluded, such as target.
ideaPlugin boolean - Tell IntelliJ IDEA that this module is an IntelliJ IDEA Plugin. Default value is: false.
ideaVersion String - Specify the version of IDEA to target. This is needed to identify the default formatting of project-jdk-name used by IDEA. Currently supports 4.x and 5.x.

This will only be used when parameter jdkName is not set. Default value is: 5.x.
javadocClassifier String - Sets the classifier string attached to an artifact javadoc archive name. Default value is: javadoc.
libraries Library[] - An optional set of Library objects that allow you to specify a comma separated list of source dirs, class dirs, or to indicate that the library should be excluded from the module. For example: 

<libraries>
<library>
<name>webwork</name>
<sources>file://$webwork$/src/java</sources>
<!--
<classes>...</classes>
<exclude>true</exclude>
-->
</library>
</libraries>
linkModules boolean - Whether to link the reactor projects as dependency modules or as libraries. Default value is: true.
overwrite boolean - Whether to update the existing project files or overwrite them. Default value is: false.
sourceClassifier String - Sets the classifier string attached to an artifact source archive name. Default value is: sources.
useFullNames boolean - Whether to use full artifact names when referencing libraries. Default value is: false.

Parameter Details

dependenciesAsLibraries:

Causes the module libraries to use a short name for all dependencies. This is very convenient but has been reported to cause problems with IDEA.
  • Type: boolean
  • Required: No
  • Default: false

deploymentDescriptorFile:

Specify the location of the deployment descriptor file, if one is provided.
  • Type: java.lang.String
  • Required: No
  • Expression: ${deploymentDescriptorFile}

downloadJavadocs:

Enables/disables the downloading of javadoc attachments.
  • Type: boolean
  • Required: No
  • Expression: ${downloadJavadocs}
  • Default: false

downloadSources:

Enables/disables the downloading of source attachments.
  • Type: boolean
  • Required: No
  • Expression: ${downloadSources}
  • Default: false

exclude:

A comma-separated list of directories that should be excluded. These directories are in addition to those already excluded, such as target.
  • Type: java.lang.String
  • Required: No

ideaPlugin:

Tell IntelliJ IDEA that this module is an IntelliJ IDEA Plugin.
  • Type: boolean
  • Required: No
  • Default: false

ideaVersion:

Specify the version of IDEA to target. This is needed to identify the default formatting of project-jdk-name used by IDEA. Currently supports 4.x and 5.x.

This will only be used when parameter jdkName is not set.
  • Type: java.lang.String
  • Required: No
  • Expression: ${ideaVersion}
  • Default: 5.x

javadocClassifier:

Sets the classifier string attached to an artifact javadoc archive name.
  • Type: java.lang.String
  • Required: No
  • Expression: ${javadocClassifier}
  • Default: javadoc

libraries:

An optional set of Library objects that allow you to specify a comma separated list of source dirs, class dirs, or to indicate that the library should be excluded from the module. For example: 

<libraries>
<library>
<name>webwork</name>
<sources>file://$webwork$/src/java</sources>
<!--
<classes>...</classes>
<exclude>true</exclude>
-->
</library>
</libraries>
  • Type: org.apache.maven.plugin.idea.Library[]
  • Required: No

linkModules:

Whether to link the reactor projects as dependency modules or as libraries.
  • Type: boolean
  • Required: No
  • Expression: ${linkModules}
  • Default: true

overwrite:

Whether to update the existing project files or overwrite them.
  • Type: boolean
  • Required: No
  • Expression: ${overwrite}
  • Default: false

sourceClassifier:

Sets the classifier string attached to an artifact source archive name.
  • Type: java.lang.String
  • Required: No
  • Expression: ${sourceClassifier}
  • Default: sources

useFullNames:

Whether to use full artifact names when referencing libraries.
  • Type: boolean
  • Required: No
  • Expression: ${useFullNames}
  • Default: false