org.apache.maven.plugin.ide

Class IdeUtils

java.lang.Object

org.apache.maven.plugin.ide.IdeUtils

public class IdeUtils
extends java.lang.Object

Version:

$Id: IdeUtils.java 1174465 2011-09-23 00:35:53Z baerrach $

Field Summary

Fields

Modifier and Type	Field and Description
private static java.lang.String	ARTIFACT_MAVEN_COMPILER_PLUGIN compiler plugin id.
static java.lang.String	JAVA_1_1
static java.lang.String	JAVA_1_2
static java.lang.String	JAVA_1_3
static java.lang.String	JAVA_1_4
static java.lang.String	JAVA_5_0
static java.lang.String	JAVA_6_0
static java.lang.String	NOT_AVAILABLE_MARKER_FILE_SUFFIX The suffix used to mark a file as not available.
static java.lang.String	PROJECT_NAME_DEFAULT_TEMPLATE
static java.lang.String	PROJECT_NAME_WITH_GROUP_AND_VERSION_TEMPLATE
static java.lang.String	PROJECT_NAME_WITH_GROUP_TEMPLATE
static java.lang.String	PROJECT_NAME_WITH_VERSION_TEMPLATE
private static java.lang.String	PROPERTY_ENCODING 'encoding' property for maven-compiler-plugin.
private static java.lang.String	PROPERTY_SOURCE 'source' property for maven-compiler-plugin.
private static java.lang.String	PROPERTY_TARGET 'target' property for maven-compiler-plugin.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	IdeUtils()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	calculateProjectNameTemplate(java.lang.String projectNameTemplate, boolean addVersionToProjectName, boolean addGroupIdToProjectName, org.apache.maven.plugin.logging.Log log) Calculate the project name template from the specified value projectNameTemplate, addVersionToProjectName and addGroupIdToProjectName
static org.apache.maven.artifact.Artifact	createArtifactWithClassifier(java.lang.String groupId, java.lang.String artifactId, java.lang.String version, java.lang.String depClassifier, java.lang.String inClassifier, org.apache.maven.artifact.factory.ArtifactFactory artifactFactory) Wrap ArtifactFactory.createArtifactWithClassifier(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String) so that the type and classifier are set correctly for "sources" and "javadoc".
static void	delete(java.io.File f, org.apache.maven.plugin.logging.Log log) Delete a file, handling log messages and exceptions
private static java.lang.String	findCompilerPluginSettingInPlugins(java.util.List plugins, java.lang.String optionName) Returns a compiler plugin settings from a list of plugins .
static java.lang.String	fixSeparator(java.lang.String filename) Convert the provided filename from a Windows separator \\ to a unix/java separator /
static java.lang.String	fixWindowsDriveURI(java.lang.String input) NOTE: This is to account for the unfortunate fact that "file:" URIs differ between Windows and Unix.
static org.apache.maven.artifact.versioning.ArtifactVersion	getArtifactVersion(java.lang.String[] artifactIds, java.util.List dependencies)
static java.lang.String	getArtifactVersion(java.lang.String[] artifactIds, java.util.List dependencies, int len) Extracts the version of the first matching artifact in the given list.
static java.lang.String	getCanonicalPath(java.io.File file)
static java.lang.String	getCompilerPluginSetting(org.apache.maven.project.MavenProject project, java.lang.String optionName) Returns a compiler plugin settings, considering also settings altered in plugin executions .
static java.lang.String	getCompilerSourceEncoding(org.apache.maven.project.MavenProject project) Returns the source encoding configured for the compiler plugin.
static java.lang.String	getCompilerSourceVersion(org.apache.maven.project.MavenProject project) Returns the source version configured for the compiler plugin.
static java.lang.String	getCompilerTargetVersion(org.apache.maven.project.MavenProject project) Returns the target version configured for the compiler plugin.
static java.io.File	getNotAvailableMarkerFile(org.apache.maven.artifact.repository.ArtifactRepository localRepository, org.apache.maven.artifact.Artifact artifact)
static org.codehaus.plexus.util.xml.Xpp3Dom	getPluginConfigurationDom(org.apache.maven.project.MavenProject project, java.lang.String pluginId) Search for the configuration Xpp3 dom of an other plugin.
static org.codehaus.plexus.util.xml.Xpp3Dom[]	getPluginConfigurationDom(org.apache.maven.project.MavenProject project, java.lang.String artifactId, java.lang.String[] subConfiguration) Search for the configuration Xpp3 dom of an other plugin.
static java.lang.String	getPluginSetting(org.apache.maven.project.MavenProject project, java.lang.String pluginId, java.lang.String optionName, java.lang.String defaultValue) Search for a configuration setting of an other plugin for a configuration setting.
static java.lang.String	getProjectName(org.apache.maven.project.MavenProject project, boolean addVersionToProjectName)
static java.lang.String	getProjectName(java.lang.String template, org.apache.maven.artifact.Artifact artifact) Use the project name template to create an eclipse project.
protected static java.lang.String	getProjectName(java.lang.String template, IdeDependency dep) Use IdeDependency.getEclipseProjectName() instead.
static java.lang.String	getProjectName(java.lang.String template, org.apache.maven.project.MavenProject project)
private static java.lang.String	getProjectName(java.lang.String template, java.lang.String groupId, java.lang.String artifactId, java.lang.String version)
static org.apache.maven.artifact.Artifact	resolveArtifact(org.apache.maven.artifact.resolver.ArtifactResolver artifactResolver, org.apache.maven.artifact.Artifact artifact, java.util.List remoteRepos, org.apache.maven.artifact.repository.ArtifactRepository localRepository, org.apache.maven.plugin.logging.Log log) Wrapper around ArtifactResolver.resolve(Artifact, List, ArtifactRepository)
static java.lang.String	resolveJavaVersion(org.apache.maven.project.MavenProject project)
static java.lang.String	toRelativeAndFixSeparator(java.io.File basedir, java.io.File fileToAdd, boolean replaceSlashesWithDashes)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

JAVA_1_1

public static final java.lang.String JAVA_1_1

See Also:

Constant Field Values

JAVA_1_2

public static final java.lang.String JAVA_1_2

See Also:

Constant Field Values

JAVA_1_3

public static final java.lang.String JAVA_1_3

See Also:

Constant Field Values

JAVA_1_4

public static final java.lang.String JAVA_1_4

See Also:

Constant Field Values

JAVA_5_0

public static final java.lang.String JAVA_5_0

See Also:

Constant Field Values

JAVA_6_0

public static final java.lang.String JAVA_6_0

See Also:

Constant Field Values

PROJECT_NAME_DEFAULT_TEMPLATE

public static final java.lang.String PROJECT_NAME_DEFAULT_TEMPLATE

See Also:

Constant Field Values

PROJECT_NAME_WITH_VERSION_TEMPLATE

public static final java.lang.String PROJECT_NAME_WITH_VERSION_TEMPLATE

See Also:

Constant Field Values

PROJECT_NAME_WITH_GROUP_TEMPLATE

public static final java.lang.String PROJECT_NAME_WITH_GROUP_TEMPLATE

See Also:

Constant Field Values

PROJECT_NAME_WITH_GROUP_AND_VERSION_TEMPLATE

public static final java.lang.String PROJECT_NAME_WITH_GROUP_AND_VERSION_TEMPLATE

See Also:

Constant Field Values

ARTIFACT_MAVEN_COMPILER_PLUGIN

private static final java.lang.String ARTIFACT_MAVEN_COMPILER_PLUGIN

compiler plugin id.

See Also:

Constant Field Values

PROPERTY_SOURCE

private static final java.lang.String PROPERTY_SOURCE

'source' property for maven-compiler-plugin.

See Also:

Constant Field Values

PROPERTY_ENCODING

private static final java.lang.String PROPERTY_ENCODING

'encoding' property for maven-compiler-plugin.

See Also:

Constant Field Values

PROPERTY_TARGET

private static final java.lang.String PROPERTY_TARGET

'target' property for maven-compiler-plugin.

See Also:

Constant Field Values

NOT_AVAILABLE_MARKER_FILE_SUFFIX

public static final java.lang.String NOT_AVAILABLE_MARKER_FILE_SUFFIX

The suffix used to mark a file as not available.

See Also:

Constant Field Values

Constructor Detail

IdeUtils

private IdeUtils()

Method Detail

delete

public static void delete(java.io.File f,
                          org.apache.maven.plugin.logging.Log log)
                   throws org.apache.maven.plugin.MojoExecutionException

Delete a file, handling log messages and exceptions

Parameters:

f - File to be deleted

Throws:

org.apache.maven.plugin.MojoExecutionException - only if a file exists and can't be deleted

getCanonicalPath

public static java.lang.String getCanonicalPath(java.io.File file)
                                         throws org.apache.maven.plugin.MojoExecutionException

Throws:

org.apache.maven.plugin.MojoExecutionException

getCompilerPluginSetting

public static java.lang.String getCompilerPluginSetting(org.apache.maven.project.MavenProject project,
                                                        java.lang.String optionName)

Returns a compiler plugin settings, considering also settings altered in plugin executions .

Parameters:

project - maven project

Returns:

option value (may be null)

getCompilerSourceVersion

public static java.lang.String getCompilerSourceVersion(org.apache.maven.project.MavenProject project)

Returns the source version configured for the compiler plugin. Returns the minimum version required to compile both standard and test sources, if settings are different.

Parameters:

project - maven project

Returns:

java source version

getCompilerSourceEncoding

public static java.lang.String getCompilerSourceEncoding(org.apache.maven.project.MavenProject project)

Returns the source encoding configured for the compiler plugin. Returns the minimum version required to compile both standard and test sources, if settings are different.

Parameters:

project - maven project

Returns:

java source version

getCompilerTargetVersion

public static java.lang.String getCompilerTargetVersion(org.apache.maven.project.MavenProject project)

Returns the target version configured for the compiler plugin. Returns the minimum version required to compile both standard and test sources, if settings are different.

Parameters:

project - maven project

Returns:

java target version

getArtifactVersion

public static java.lang.String getArtifactVersion(java.lang.String[] artifactIds,
                                                  java.util.List dependencies,
                                                  int len)

Extracts the version of the first matching artifact in the given list.

The len parameter indicated what to to return:

• 1 indicated major version
• 3 indicated major dot minor version
• 5 and above indicates major dot minor dot incremental version

Parameters:

artifactIds - artifact names to compare against for extracting version

artifacts - Set of artifacts for our project

len - expected length of the version sub-string

Returns:

getArtifactVersion

public static org.apache.maven.artifact.versioning.ArtifactVersion getArtifactVersion(java.lang.String[] artifactIds,
                                                                                      java.util.List dependencies)

Parameters:

artifactIds - an array of artifactIds, should not be null

dependencies - a list of Dependency-objects, should not be null

Returns:

the resolved ArtifactVersion, otherwise null

getPluginSetting

public static java.lang.String getPluginSetting(org.apache.maven.project.MavenProject project,
                                                java.lang.String pluginId,
                                                java.lang.String optionName,
                                                java.lang.String defaultValue)

Search for a configuration setting of an other plugin for a configuration setting.

Parameters:

project - the current maven project to get the configuration from.

pluginId - the group id and artifact id of the plugin to search for

optionName - the option to get from the configuration

defaultValue - the default value if the configuration was not found

Returns:

the value of the option configured in the plugin configuration

getPluginConfigurationDom

public static org.codehaus.plexus.util.xml.Xpp3Dom getPluginConfigurationDom(org.apache.maven.project.MavenProject project,
                                                                             java.lang.String pluginId)

Search for the configuration Xpp3 dom of an other plugin.

Parameters:

project - the current maven project to get the configuration from.

pluginId - the group id and artifact id of the plugin to search for

Returns:

the value of the option configured in the plugin configuration

getPluginConfigurationDom

public static org.codehaus.plexus.util.xml.Xpp3Dom[] getPluginConfigurationDom(org.apache.maven.project.MavenProject project,
                                                                               java.lang.String artifactId,
                                                                               java.lang.String[] subConfiguration)

Search for the configuration Xpp3 dom of an other plugin.

Parameters:

project - the current maven project to get the configuration from.

artifactId - the artifact id of the plugin to search for

Returns:

the value of the option configured in the plugin configuration

calculateProjectNameTemplate

public static java.lang.String calculateProjectNameTemplate(java.lang.String projectNameTemplate,
                                                            boolean addVersionToProjectName,
                                                            boolean addGroupIdToProjectName,
                                                            org.apache.maven.plugin.logging.Log log)

Calculate the project name template from the specified value projectNameTemplate, addVersionToProjectName and addGroupIdToProjectName

Note: if projectNameTemplate is not null then that value will be used regardless of the values for addVersionToProjectName or addGroupIdToProjectName and a warning will be issued.

Parameters:

projectNameTemplate - the current projectNameTemplate, if available

addVersionToProjectName - whether to include Version in the project name

addGroupIdToProjectName - whether to include GroupId in the project name.

Returns:

the project name template.

getProjectName

protected static java.lang.String getProjectName(java.lang.String template,
                                                 IdeDependency dep)

Use IdeDependency.getEclipseProjectName() instead.

getProjectName

public static java.lang.String getProjectName(java.lang.String template,
                                              org.apache.maven.artifact.Artifact artifact)

Use the project name template to create an eclipse project.

Parameters:

template - Template for the project name

artifact - the artifact to create the project name for

Returns:

the created ide project name

getProjectName

public static java.lang.String getProjectName(java.lang.String template,
                                              org.apache.maven.project.MavenProject project)

getProjectName

public static java.lang.String getProjectName(org.apache.maven.project.MavenProject project,
                                              boolean addVersionToProjectName)

getNotAvailableMarkerFile

public static java.io.File getNotAvailableMarkerFile(org.apache.maven.artifact.repository.ArtifactRepository localRepository,
                                                     org.apache.maven.artifact.Artifact artifact)

Parameters:

artifact - the artifact

Returns:

the not-available marker file for the specified artifact

resolveArtifact

public static org.apache.maven.artifact.Artifact resolveArtifact(org.apache.maven.artifact.resolver.ArtifactResolver artifactResolver,
                                                                 org.apache.maven.artifact.Artifact artifact,
                                                                 java.util.List remoteRepos,
                                                                 org.apache.maven.artifact.repository.ArtifactRepository localRepository,
                                                                 org.apache.maven.plugin.logging.Log log)

Wrapper around ArtifactResolver.resolve(Artifact, List, ArtifactRepository)

Parameters:

artifactResolver - see ArtifactResolver.resolve(Artifact, List, ArtifactRepository)

artifact - see ArtifactResolver.resolve(Artifact, List, ArtifactRepository)

remoteRepos - see ArtifactResolver.resolve(Artifact, List, ArtifactRepository)

localRepository - see ArtifactResolver.resolve(Artifact, List, ArtifactRepository)

log - Logger

Returns:

the artifact, resolved if possible.

createArtifactWithClassifier

public static org.apache.maven.artifact.Artifact createArtifactWithClassifier(java.lang.String groupId,
                                                                              java.lang.String artifactId,
                                                                              java.lang.String version,
                                                                              java.lang.String depClassifier,
                                                                              java.lang.String inClassifier,
                                                                              org.apache.maven.artifact.factory.ArtifactFactory artifactFactory)

Wrap ArtifactFactory.createArtifactWithClassifier(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String) so that the type and classifier are set correctly for "sources" and "javadoc".

Parameters:

groupId - see ArtifactFactory.createArtifactWithClassifier(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String)

artifactId - see ArtifactFactory.createArtifactWithClassifier(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String)

version - see ArtifactFactory.createArtifactWithClassifier(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String)

depClassifier - see ArtifactFactory.createArtifactWithClassifier(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String)

inClassifier - either "sources" of "javadoc"

artifactFactory - see ArtifactFactory.createArtifactWithClassifier(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String)

Returns:

see ArtifactFactory.createArtifactWithClassifier(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String)

See Also:

ArtifactFactory.createArtifactWithClassifier(java.lang.String, java.lang.String, java.lang.String, java.lang.String, java.lang.String)

resolveJavaVersion

public static java.lang.String resolveJavaVersion(org.apache.maven.project.MavenProject project)

toRelativeAndFixSeparator

public static java.lang.String toRelativeAndFixSeparator(java.io.File basedir,
                                                         java.io.File fileToAdd,
                                                         boolean replaceSlashesWithDashes)
                                                  throws org.apache.maven.plugin.MojoExecutionException

Throws:

org.apache.maven.plugin.MojoExecutionException

fixSeparator

public static java.lang.String fixSeparator(java.lang.String filename)

Convert the provided filename from a Windows separator \\ to a unix/java separator /

Parameters:

filename - file name to fix separator

Returns:

filename with all \\ replaced with /

fixWindowsDriveURI

public static java.lang.String fixWindowsDriveURI(java.lang.String input)

NOTE: This is to account for the unfortunate fact that "file:" URIs differ between Windows and Unix. On a Windows box, the path "C:\dir" is mapped to "file:/C:/dir". On a Unix box, the path "/home/dir" is mapped to "file:/home/dir". So, in the first case the slash after "file:" is not part of the corresponding filesystem path while in the later case it is. This discrepancy makes verifying the javadoc attachments in ".classpath" a little tricky.

Parameters:

input - string input that may contain a windows URI

Returns:

all windows URI convert "file:C:/dir" to "file:/C:/dir"

findCompilerPluginSettingInPlugins

private static java.lang.String findCompilerPluginSettingInPlugins(java.util.List plugins,
                                                                   java.lang.String optionName)

Returns a compiler plugin settings from a list of plugins .

Parameters:

project - maven project

Returns:

option value (may be null)

getProjectName

private static java.lang.String getProjectName(java.lang.String template,
                                               java.lang.String groupId,
                                               java.lang.String artifactId,
                                               java.lang.String version)