org.springframework.roo.project

Class AbstractProjectOperations

java.lang.Object

org.springframework.roo.project.AbstractProjectOperations

All Implemented Interfaces:

ProjectOperations

Direct Known Subclasses:

MavenOperationsImpl

@Reference(name="feature",
           strategy=EVENT,
           policy=DYNAMIC,
           referenceInterface=Feature.class,
           cardinality=OPTIONAL_MULTIPLE)
public abstract class AbstractProjectOperations
extends Object
implements ProjectOperations

Provides common project operations. Should be subclassed by a project-specific operations subclass.

Since:

1.0

Author:

Ben Alex, Adrian Colyer, Stefan Schmidt, Alan Stewart, Juan Carlos García, Paula Navarro

Field Summary

Fields

Modifier and Type	Field and Description
protected org.springframework.roo.process.manager.FileManager	fileManager
protected org.springframework.roo.metadata.MetadataService	metadataService
protected PathResolver	pathResolver
protected org.springframework.roo.project.PomManagementService	pomManagementService
protected org.springframework.roo.shell.Shell	shell

Constructor Summary

Constructors

Constructor and Description
AbstractProjectOperations()

Method Summary

Modifier and Type	Method and Description
void	addBuildPlugin(String moduleName, Plugin plugin) Attempts to add the specified build plugin.
void	addBuildPlugin(String moduleName, Plugin plugin, boolean addToPluginManagement) Attempts to add the specified build plugin.
void	addBuildPlugins(String moduleName, Collection<? extends Plugin> newPlugins) Attempts to add the specified plugins.
void	addBuildPlugins(String moduleName, Collection<? extends Plugin> newPlugins, boolean addToPluginManagement) Attempts to add the specified plugins.
List<Dependency>	addDependencies(String moduleName, Collection<? extends Dependency> newDependencies) Attempts to add the specified dependencies.
List<Dependency>	addDependencies(String moduleName, Collection<? extends Dependency> newDependencies, boolean addToDependencyManagement, boolean checkFullDependency) Attempts to add the specified dependencies.
Dependency	addDependency(String moduleName, Dependency dependency) Attempts to add the specified dependency.
Dependency	addDependency(String moduleName, Dependency dependency, boolean addToDependencyManagement) Attempts to add the specified dependency.
Dependency	addDependency(String moduleName, Dependency dependency, boolean addToDependencyManagement, boolean checkFullDependency) Attempts to add the specified dependency.
Dependency	addDependency(String moduleName, String groupId, String artifactId, String version) Allows addition of a JAR dependency to the POM.
Dependency	addDependency(String moduleName, String groupId, String artifactId, String version, boolean addToDependencyManagement) Allows addition of a JAR dependency to the POM.
Dependency	addDependency(String moduleName, String groupId, String artifactId, String version, DependencyScope scope) Allows addition of a JAR dependency to the POM.
Dependency	addDependency(String moduleName, String groupId, String artifactId, String version, DependencyScope scope, boolean addToDependencyManagement) Allows addition of a JAR dependency to the POM.
Dependency	addDependency(String moduleName, String groupId, String artifactId, String version, DependencyScope scope, String classifier) Allows addition of a JAR dependency to the POM.
Dependency	addDependency(String moduleName, String groupId, String artifactId, String version, DependencyScope scope, String classifier, boolean addToDependencyManagement) Allows addition of a JAR dependency to the POM.
void	addElementToPluginExecution(String moduleName, Plugin plugin, String executionId, String parentElementName, String elementName, Map<String,String> elementValues) Attempts to add the specified element into the specified plugin execution.
void	addElementToPluginExecution(String moduleName, Plugin plugin, String executionId, String parentElementName, String elementName, Map<String,String> elementValues, boolean addToPluginManagement) Attempts to add the specified element into the specified plugin execution.
void	addElementToPluginExecution(String moduleName, Plugin plugin, String executionId, String parentElementName, String elementName, String elementValue) Attempts to add the specified element into the specified plugin execution.
void	addElementToPluginExecution(String moduleName, Plugin plugin, String executionId, String parentElementName, String elementName, String elementValue, boolean addToPluginManagement) Attempts to add the specified element into the specified plugin execution.
void	addFilter(String moduleName, Filter filter) Attempts to add the specified filter.
void	addModuleDependency(String moduleToDependUpon) Adds the given module as a dependency of the currently focused module.
void	addModuleDependency(String moduleName, String moduleToDependUpon) Adds to the given module the dependency with a module.
void	addModuleDependency(String moduleName, String moduleToDependUpon, boolean testDependency) Adds to the given module the dependency with a module and with the possibility of adding it only with test scope and type.
void	addPackageToPluginExecution(String moduleName, Plugin plugin, String executionId, String packageName) Attempts to add the specified package into the specified plugin execution.
void	addPackageToPluginExecution(String moduleName, Plugin plugin, String executionId, String packageName, boolean addToPluginManagement) Attempts to add the specified package into the specified plugin execution.
void	addPluginRepositories(String moduleName, Collection<? extends Repository> repositories) Attempts to add the specified plugin repositories.
void	addPluginRepository(String moduleName, Repository repository) Attempts to add the specified plugin repository.
void	addProperty(String moduleName, Property property) Attempts to add the specified property.
void	addRepositories(String moduleName, Collection<? extends Repository> repositories) Attempts to add the specified repositories.
void	addRepository(String moduleName, Repository repository) Attempts to add the specified repository.
void	addResource(String moduleName, Resource resource) Attempts to add the specified resource.
protected void	bindFeature(Feature feature)
Pom	getFocusedModule() Returns the Pom of the currently focussed module, or if no module has the focus, the root Pom.
String	getFocusedModuleName() Returns the name of the currently focussed module.
ProjectMetadata	getFocusedProjectMetadata() Returns the metadata for the currently focussed module.
String	getFocusedProjectName()
org.springframework.roo.model.JavaPackage	getFocusedTopLevelPackage()
Pom	getModuleForFileIdentifier(String fileIdentifier) Returns the module to which the given file belongs
Collection<String>	getModuleNames() Returns the names of each module in the user's project
PathResolver	getPathResolver() Convenience method to return the PathResolver from the project's ProjectMetadata.
Pom	getPomFromModuleName(String moduleName) Returns the given module's Pom
Collection<Pom>	getPoms() Returns the Poms for all modules of the user's project
ProjectMetadata	getProjectMetadata(String moduleName) Returns the ProjectMetadata for the given module.
String	getProjectName(String moduleName)
org.springframework.roo.model.JavaPackage	getTopLevelPackage(String moduleName)
boolean	isFeatureInstalled(Pom module, String featureName) Indicates whether any of the supplied features are installed in the provided module.
boolean	isFeatureInstalled(String... featureNames) Indicates whether any of the supplied features are installed in any module of a project.
boolean	isFeatureInstalled(String featureName) Indicates whether the supplied feature is installed in any module of a project.
boolean	isFocusedProjectAvailable() Indicates whether the module whose name has the focus, if any, is available.
boolean	isModuleCreationAllowed() Indicates whether the user can create a new project module
boolean	isModuleFocusAllowed() Indicates whether the user can change the focused module
boolean	isMultimoduleProject() Indicates whether the project is multimodule
boolean	isProjectAvailable(String moduleName) Indicates whether a module with the given name is available.
void	removeBuildPlugin(String moduleName, Plugin plugin) Removes any plugins with the same groupId and artifactId as the given plugin.
void	removeBuildPluginImmediately(String moduleName, Plugin plugin) Removes any plugins with the same groupId and artifactId as the given plugin and immediately writes the pom to the file system.
void	removeBuildPlugins(String moduleName, Collection<? extends Plugin> plugins) Removes any plugins with the same groupId and artifactId as any of the given plugins.
void	removeDependencies(String moduleName, Collection<? extends Dependency> dependenciesToRemove) Attempts to remove the specified dependencies.
void	removeDependency(String moduleName, Dependency dependency) Attempts to remove the specified dependency.
void	removeDependency(String moduleName, String groupId, String artifactId, String version) Allows remove of an existing JAR dependency from the POM.
void	removeDependency(String moduleName, String groupId, String artifactId, String version, String classifier) Allows remove of an existing JAR dependency from the POM.
void	removeFilter(String moduleName, Filter filter) Attempts to remove the specified filter.
void	removePluginRepository(String moduleName, Repository repository) Attempts to remove the specified plugin repository.
void	removeProperty(String moduleName, Property property) Attempts to remove the specified property dependency.
void	removeRepository(String moduleName, Repository repository) Attempts to remove the specified repository.
void	removeResource(String moduleName, Resource resource) Attempts to remove the specified resource.
void	setModule(Pom module) Sets the currently focused module
protected void	unbindFeature(Feature feature)
void	updateBuildPlugin(String moduleName, Plugin plugin) Verifies if the specified build plugin is present.
void	updateDependencyScope(String moduleName, Dependency dependency, DependencyScope dependencyScope) Attempts to update the scope of the specified dependency.
void	updateProjectType(String moduleName, ProjectType projectType) Attempts to update the project packaging type as defined via ProjectType.

Methods inherited from class java.lang.Object

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

Field Detail

fileManager

@Reference(policy=DYNAMIC)
protected org.springframework.roo.process.manager.FileManager fileManager

metadataService

@Reference(policy=DYNAMIC)
protected org.springframework.roo.metadata.MetadataService metadataService

pathResolver

@Reference(policy=DYNAMIC)
protected PathResolver pathResolver

pomManagementService

@Reference(policy=DYNAMIC)
protected org.springframework.roo.project.PomManagementService pomManagementService

shell

@Reference(policy=DYNAMIC)
protected org.springframework.roo.shell.Shell shell

Constructor Detail

AbstractProjectOperations

public AbstractProjectOperations()

Method Detail

addBuildPlugin

public void addBuildPlugin(String moduleName,
                           Plugin plugin)

Description copied from interface: ProjectOperations

Attempts to add the specified build plugin. If the plugin already exists according to ProjectMetadata#isBuildPluginRegistered(org.springframework.roo.project.Plugin) , the method silently returns. Otherwise the plugin is added.

By default, includes the provided plugin into pluginManagement element.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

addBuildPlugin in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

plugin - the plugin to add (required)

addBuildPlugin

public void addBuildPlugin(String moduleName,
                           Plugin plugin,
                           boolean addToPluginManagement)

Description copied from interface: ProjectOperations

Attempts to add the specified build plugin. If the plugin already exists according to ProjectMetadata#isBuildPluginRegistered(org.springframework.roo.project.Plugin) , the method silently returns. Otherwise the plugin is added.

If addToPluginManagement parameter has true value, the new plugin will be included into pluginManagement element. If false, the provided plugin will be included only as plugin.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

addBuildPlugin in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

plugin - the plugin to add (required)

addToPluginManagement - boolean that indicates if the new Plugin should be included into pluginManagement element or not.

addBuildPlugins

public void addBuildPlugins(String moduleName,
                            Collection<? extends Plugin> newPlugins)

Description copied from interface: ProjectOperations

Attempts to add the specified plugins. If all the plugins already exist according to ProjectMetadata#isAllPluginRegistered(Plugin), the method silently returns. Otherwise each new dependency is added.

By default, includes the provided plugin into pluginManagement element.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

addBuildPlugins in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

newPlugins - the plugins to add (required)

addBuildPlugins

public void addBuildPlugins(String moduleName,
                            Collection<? extends Plugin> newPlugins,
                            boolean addToPluginManagement)

Description copied from interface: ProjectOperations

Attempts to add the specified plugins. If all the plugins already exist according to ProjectMetadata#isAllPluginRegistered(Plugin), the method silently returns. Otherwise each new dependency is added.

If addToPluginManagement parameter has true value, the new plugin will be included into pluginManagement element. If false, the provided plugin will be included only as plugin.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

addBuildPlugins in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

newPlugins - the plugins to add (required)

addToPluginManagement - boolean that indicates if the new Plugin should be included into pluginManagement element or not.

addDependencies

public List<Dependency> addDependencies(String moduleName,
                                        Collection<? extends Dependency> newDependencies)

Description copied from interface: ProjectOperations

Attempts to add the specified dependencies. If all the dependencies already exist according to ProjectMetadata#isAllDependencyRegistered(Dependency), the method silently returns. Otherwise each new dependency is added.

By default, includes the provided dependencies into dependencyManagement element.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

addDependencies in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

newDependencies - the dependencies to add (required)

Returns:

List of dependencies added on current operation

addDependencies

public List<Dependency> addDependencies(String moduleName,
                                        Collection<? extends Dependency> newDependencies,
                                        boolean addToDependencyManagement,
                                        boolean checkFullDependency)

Description copied from interface: ProjectOperations

Attempts to add the specified dependencies. If all the dependencies already exist according to ProjectMetadata#isAllDependencyRegistered(Dependency), the method silently returns. Otherwise each new dependency is added.

If addToDependencyManagement parameter has true value, the new dependency will be included into dependencyManagement element. If false, the provided dependency will be included only as dependency.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

addDependencies in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

newDependencies - the dependencies to add (required)

addToDependencyManagement - boolean that indicates if the new Dependency should be included into dependencyManagement element or not.

checkFullDependency - whether should check the existence with full dependency element or only compare 'artifactId' and 'groupId'.

Returns:

List of dependencies added on current operation

addDependency

public Dependency addDependency(String moduleName,
                                Dependency dependency)

Description copied from interface: ProjectOperations

Attempts to add the specified dependency. If the dependency already exists according to to ProjectMetadata#isDependencyRegistered(org.springframework.roo.project.Dependency) , the method silently returns. Otherwise the dependency is added.

By default, includes the provided dependency into dependencyManagement element.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

addDependency in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

dependency - the dependency to add (required)

Returns:

added dependency

addDependency

public Dependency addDependency(String moduleName,
                                Dependency dependency,
                                boolean addToDependencyManagement)

Description copied from interface: ProjectOperations

Attempts to add the specified dependency. If the dependency already exists according to to ProjectMetadata#isDependencyRegistered(org.springframework.roo.project.Dependency) , the method silently returns. Otherwise the dependency is added.

If addToDependencyManagement parameter has true value, the new dependency will be included into dependencyManagement element. If false, the provided dependency will be included only as dependency.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

addDependency in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

dependency - the dependency to add (required)

addToDependencyManagement - boolean that indicates if the new Dependency should be included into dependencyManagement element or not.

Returns:

added dependency

addDependency

public Dependency addDependency(String moduleName,
                                Dependency dependency,
                                boolean addToDependencyManagement,
                                boolean checkFullDependency)

Description copied from interface: ProjectOperations

Attempts to add the specified dependency. If the dependency already exists according to to ProjectMetadata#isDependencyRegistered(org.springframework.roo.project.Dependency) , the method silently returns. Otherwise the dependency is added.

If addToDependencyManagement parameter has true value, the new dependency will be included into dependencyManagement element. If false, the provided dependency will be included only as dependency.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

addDependency in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

dependency - the dependency to add (required)

addToDependencyManagement - boolean that indicates if the new Dependency should be included into dependencyManagement element or not.

checkFullDependency - whether should check the existence with full dependency element or only compare 'artifactId' and 'groupId'.

Returns:

added dependency

addDependency

public final Dependency addDependency(String moduleName,
                                      String groupId,
                                      String artifactId,
                                      String version)

Description copied from interface: ProjectOperations

Allows addition of a JAR dependency to the POM.

Provides a convenient way for third parties to instruct end users how to use the CLI to add support for their projects without requiring the user to manually edit a pom.xml or write an add-on.

By default, includes the provided dependency into dependencyManagement element.

Specified by:

addDependency in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

groupId - the group id of the dependency (required)

artifactId - the artifact id of the dependency (required)

version - the version of the dependency (required)

Returns:

added dependency

addDependency

public final Dependency addDependency(String moduleName,
                                      String groupId,
                                      String artifactId,
                                      String version,
                                      boolean addToDependencyManagement)

Description copied from interface: ProjectOperations

Allows addition of a JAR dependency to the POM.

Provides a convenient way for third parties to instruct end users how to use the CLI to add support for their projects without requiring the user to manually edit a pom.xml or write an add-on.

If addToDependencyManagement parameter has true value, the new dependency will be included into dependencyManagement element. If false, the provided dependency will be included only as dependency.

Specified by:

addDependency in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

groupId - the group id of the dependency (required)

artifactId - the artifact id of the dependency (required)

version - the version of the dependency (required)

addToDependencyManagement - boolean that indicates if the new Dependency should be included into dependencyManagement element or not.

Returns:

added dependency

addDependency

public final Dependency addDependency(String moduleName,
                                      String groupId,
                                      String artifactId,
                                      String version,
                                      DependencyScope scope)

Description copied from interface: ProjectOperations

Allows addition of a JAR dependency to the POM.

Provides a convenient way for third parties to instruct end users how to use the CLI to add support for their projects without requiring the user to manually edit a pom.xml or write an add-on.

By default, includes the provided dependency into dependencyManagement element.

Specified by:

addDependency in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

groupId - the group id of the dependency (required)

artifactId - the artifact id of the dependency (required)

version - the version of the dependency (required)

scope - the scope of the dependency

Returns:

added dependency

addDependency

public final Dependency addDependency(String moduleName,
                                      String groupId,
                                      String artifactId,
                                      String version,
                                      DependencyScope scope,
                                      boolean addToDependencyManagement)

Description copied from interface: ProjectOperations

Allows addition of a JAR dependency to the POM.

Provides a convenient way for third parties to instruct end users how to use the CLI to add support for their projects without requiring the user to manually edit a pom.xml or write an add-on.

If addToDependencyManagement parameter has true value, the new dependency will be included into dependencyManagement element. If false, the provided dependency will be included only as dependency.

Specified by:

addDependency in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

groupId - the group id of the dependency (required)

artifactId - the artifact id of the dependency (required)

version - the version of the dependency (required)

scope - the scope of the dependency

addToDependencyManagement - boolean that indicates if the new Dependency should be included into dependencyManagement element or not.

Returns:

added dependency

addDependency

public final Dependency addDependency(String moduleName,
                                      String groupId,
                                      String artifactId,
                                      String version,
                                      DependencyScope scope,
                                      String classifier)

Description copied from interface: ProjectOperations

Allows addition of a JAR dependency to the POM.

Provides a convenient way for third parties to instruct end users how to use the CLI to add support for their projects without requiring the user to manually edit a pom.xml or write an add-on.

By default, includes the provided dependency into dependencyManagement element.

Specified by:

addDependency in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

groupId - the group id of the dependency (required)

artifactId - the artifact id of the dependency (required)

version - the version of the dependency (required)

scope - the scope of the dependency

classifier - the classifier of the dependency

Returns:

added dependency

addDependency

public final Dependency addDependency(String moduleName,
                                      String groupId,
                                      String artifactId,
                                      String version,
                                      DependencyScope scope,
                                      String classifier,
                                      boolean addToDependencyManagement)

Description copied from interface: ProjectOperations

Allows addition of a JAR dependency to the POM.

Provides a convenient way for third parties to instruct end users how to use the CLI to add support for their projects without requiring the user to manually edit a pom.xml or write an add-on.

If addToDependencyManagement parameter has true value, the new dependency will be included into dependencyManagement element. If false, the provided dependency will be included only as dependency.

Specified by:

addDependency in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

groupId - the group id of the dependency (required)

artifactId - the artifact id of the dependency (required)

version - the version of the dependency (required)

scope - the scope of the dependency

classifier - the classifier of the dependency

addToDependencyManagement - boolean that indicates if the new Dependency should be included into dependencyManagement element or not.

Returns:

added dependency

addFilter

public void addFilter(String moduleName,
                      Filter filter)

Description copied from interface: ProjectOperations

Attempts to add the specified filter. If the filter already exists according to ProjectMetadata#isFilterRegistered(org.springframework.roo.project.Filter) , the method silently returns. Otherwise the filter is added.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

addFilter in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

filter - the filter to add (required)

addPackageToPluginExecution

public void addPackageToPluginExecution(String moduleName,
                                        Plugin plugin,
                                        String executionId,
                                        String packageName)

Description copied from interface: ProjectOperations

Attempts to add the specified package into the specified plugin execution. If the package already exists or the execution does not exist in the specified plugin, the method silently returns. Otherwise the package is added.

By default, includes the provided package into pluginManagement element.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

addPackageToPluginExecution in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

plugin - the plugin where add the package (required)

executionId - the id of the plugin execution where add the package (required)

packageName - the package to add (required)

addPackageToPluginExecution

public void addPackageToPluginExecution(String moduleName,
                                        Plugin plugin,
                                        String executionId,
                                        String packageName,
                                        boolean addToPluginManagement)

Description copied from interface: ProjectOperations

Attempts to add the specified package into the specified plugin execution. If the package already exists or the execution does not exist in the specified plugin, the method silently returns. Otherwise the package is added.

If addToPluginManagement parameter has true value, the new plugin will be included into pluginManagement element. If false, the provided plugin will be included only as plugin.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

addPackageToPluginExecution in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

plugin - the plugin where add the package (required)

executionId - the id of the plugin execution where add the package (required)

packageName - the package to add (required)

addToPluginManagement - boolean that indicates if the new Plugin should be included into pluginManagement element or not.

addElementToPluginExecution

public void addElementToPluginExecution(String moduleName,
                                        Plugin plugin,
                                        String executionId,
                                        String parentElementName,
                                        String elementName,
                                        String elementValue)

Description copied from interface: ProjectOperations

Attempts to add the specified element into the specified plugin execution. If the element already exists or the execution does not exist in the specified plugin, the method silently returns. Otherwise the element is added.

By default, includes the provided element into pluginManagement element.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

addElementToPluginExecution in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

plugin - the plugin where add the package (required)

executionId - the id of the plugin execution where add the package (required)

parentElementName - the parentElement name that should be included inside configuration element

elementName - the element name that should be included inside the parentElementName provided before

elementValue - the value to add (required)

addElementToPluginExecution

public void addElementToPluginExecution(String moduleName,
                                        Plugin plugin,
                                        String executionId,
                                        String parentElementName,
                                        String elementName,
                                        String elementValue,
                                        boolean addToPluginManagement)

Description copied from interface: ProjectOperations

Attempts to add the specified element into the specified plugin execution. If the element already exists or the execution does not exist in the specified plugin, the method silently returns. Otherwise the element is added.

By default, includes the provided element into pluginManagement element.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

addElementToPluginExecution in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

plugin - the plugin where add the package (required)

executionId - the id of the plugin execution where add the package (required)

parentElementName - the parentElement name that should be included inside configuration element

elementName - the element name that should be included inside the parentElementName provided before

elementValue - the value to add (required)

addToPluginManagement - boolean that indicates if the new element should be included into pluginManagement element or not.

addElementToPluginExecution

public void addElementToPluginExecution(String moduleName,
                                        Plugin plugin,
                                        String executionId,
                                        String parentElementName,
                                        String elementName,
                                        Map<String,String> elementValues)

Description copied from interface: ProjectOperations

Attempts to add the specified element into the specified plugin execution. If the element already exists or the execution does not exist in the specified plugin, the method silently returns. Otherwise the element is added.

By default, includes the provided element into pluginManagement element.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

addElementToPluginExecution in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

plugin - the plugin where add the package (required)

executionId - the id of the plugin execution where add the package (required)

parentElementName - the parentElement name that should be included inside configuration element

elementName - the element name that should be included inside the parentElementName provided before

elementValues - the values to add (required)

addElementToPluginExecution

public void addElementToPluginExecution(String moduleName,
                                        Plugin plugin,
                                        String executionId,
                                        String parentElementName,
                                        String elementName,
                                        Map<String,String> elementValues,
                                        boolean addToPluginManagement)

Description copied from interface: ProjectOperations

Attempts to add the specified element into the specified plugin execution. If the element already exists or the execution does not exist in the specified plugin, the method silently returns. Otherwise the element is added.

By default, includes the provided element into pluginManagement element.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

addElementToPluginExecution in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

plugin - the plugin where add the package (required)

executionId - the id of the plugin execution where add the package (required)

parentElementName - the parentElement name that should be included inside configuration element

elementName - the element name that should be included inside the parentElementName provided before

elementValues - the values to add (required)

addToPluginManagement - boolean that indicates if the new element should be included into pluginManagement element or not.

addModuleDependency

public void addModuleDependency(String moduleToDependUpon)

Description copied from interface: ProjectOperations

Adds the given module as a dependency of the currently focused module.

Specified by:

addModuleDependency in interface ProjectOperations

Parameters:

moduleToDependUpon - the name of the module to act upon (required)

addModuleDependency

public void addModuleDependency(String moduleName,
                                String moduleToDependUpon)

Description copied from interface: ProjectOperations

Adds to the given module the dependency with a module.

Specified by:

addModuleDependency in interface ProjectOperations

Parameters:

moduleName - the name of the module where to install the dependency (required)

moduleToDependUpon - the name of the module to act upon (required)

addModuleDependency

public void addModuleDependency(String moduleName,
                                String moduleToDependUpon,
                                boolean testDependency)

Description copied from interface: ProjectOperations

Adds to the given module the dependency with a module and with the possibility of adding it only with test scope and type.

Specified by:

addModuleDependency in interface ProjectOperations

Parameters:

moduleName - the name of the module where to install the dependency (required)

moduleToDependUpon - the name of the module to act upon (required)

testDependency - whether the module dependency should be added with test scope and as test type dependency.

addPluginRepositories

public void addPluginRepositories(String moduleName,
                                  Collection<? extends Repository> repositories)

Description copied from interface: ProjectOperations

Attempts to add the specified plugin repositories. If all the repositories already exists according to ProjectMetadata#isPluginRepositoryRegistered(Repository), the method silently returns. Otherwise each new repository is added.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

addPluginRepositories in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

repositories - a list of plugin repositories to add (required)

addPluginRepository

public void addPluginRepository(String moduleName,
                                Repository repository)

Description copied from interface: ProjectOperations

Attempts to add the specified plugin repository. If the plugin repository already exists according to ProjectMetadata#isPluginRepositoryRegistered(Repository), the method silently returns. Otherwise the repository is added.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

addPluginRepository in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

repository - the plugin repository to add (required)

addProperty

public void addProperty(String moduleName,
                        Property property)

Description copied from interface: ProjectOperations

Attempts to add the specified property. If the property already exists according to ProjectMetadata#isPropertyRegistered(org.springframework.roo.project.Property) , the method silently returns. Otherwise the property is added.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

addProperty in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

property - the property to add (required)

addRepositories

public void addRepositories(String moduleName,
                            Collection<? extends Repository> repositories)

Description copied from interface: ProjectOperations

Attempts to add the specified repositories. If all the repositories already exists according to ProjectMetadata#isRepositoryRegistered(Repository), the method silently returns. Otherwise each new repository is added.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

addRepositories in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

repositories - a list of repositories to add (required)

addRepository

public void addRepository(String moduleName,
                          Repository repository)

Description copied from interface: ProjectOperations

Attempts to add the specified repository. If the repository already exists according to ProjectMetadata#isRepositoryRegistered(Repository), the method silently returns. Otherwise the repository is added.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

addRepository in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

repository - the repository to add (required)

addResource

public void addResource(String moduleName,
                        Resource resource)

Description copied from interface: ProjectOperations

Attempts to add the specified resource. If the resource already exists according to ProjectMetadata#isResourceRegistered(Resource), the method silently returns. Otherwise the resource is added.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

addResource in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

resource - the resource to add (required)

bindFeature

protected void bindFeature(Feature feature)

getFocusedModule

public Pom getFocusedModule()

Description copied from interface: ProjectOperations

Returns the Pom of the currently focussed module, or if no module has the focus, the root Pom.

Specified by:

getFocusedModule in interface ProjectOperations

Returns:

null if none of the above descriptors exist

getFocusedModuleName

public String getFocusedModuleName()

Description copied from interface: ProjectOperations

Returns the name of the currently focussed module.

Specified by:

getFocusedModuleName in interface ProjectOperations

Returns:

an empty string if no module has the focus, otherwise a fully-qualified name separated by File.separator

getFocusedProjectMetadata

public ProjectMetadata getFocusedProjectMetadata()

Description copied from interface: ProjectOperations

Returns the metadata for the currently focussed module.

Specified by:

getFocusedProjectMetadata in interface ProjectOperations

Returns:

null if no project metadata is available

getFocusedProjectName

public String getFocusedProjectName()

Specified by:

getFocusedProjectName in interface ProjectOperations

Returns:

getFocusedTopLevelPackage

public org.springframework.roo.model.JavaPackage getFocusedTopLevelPackage()

Specified by:

getFocusedTopLevelPackage in interface ProjectOperations

Returns:

getModuleForFileIdentifier

public Pom getModuleForFileIdentifier(String fileIdentifier)

Description copied from interface: ProjectOperations

Returns the module to which the given file belongs

Specified by:

getModuleForFileIdentifier in interface ProjectOperations

Parameters:

fileIdentifier - the canonical path to look up

Returns:

see above

getModuleNames

public Collection<String> getModuleNames()

Description copied from interface: ProjectOperations

Returns the names of each module in the user's project

Specified by:

getModuleNames in interface ProjectOperations

Returns:

a non-null list

getPathResolver

public PathResolver getPathResolver()

Description copied from interface: ProjectOperations

Convenience method to return the PathResolver from the project's ProjectMetadata.

Specified by:

getPathResolver in interface ProjectOperations

Returns:

the PathResolver, or null if the project is unavailable

getPomFromModuleName

public final Pom getPomFromModuleName(String moduleName)

Description copied from interface: ProjectOperations

Returns the given module's Pom

Specified by:

getPomFromModuleName in interface ProjectOperations

Parameters:

moduleName - the fully-qualified name of the module (required)

Returns:

getPoms

public Collection<Pom> getPoms()

Description copied from interface: ProjectOperations

Returns the Poms for all modules of the user's project

Specified by:

getPoms in interface ProjectOperations

Returns:

a non-null collection

getProjectMetadata

public final ProjectMetadata getProjectMetadata(String moduleName)

Description copied from interface: ProjectOperations

Returns the ProjectMetadata for the given module.

Specified by:

getProjectMetadata in interface ProjectOperations

Parameters:

moduleName - the module whose metadata is being requested (can be empty to signify the root or only module)

Returns:

null if the metadata is not available

getProjectName

public String getProjectName(String moduleName)

Specified by:

getProjectName in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

Returns:

getTopLevelPackage

public org.springframework.roo.model.JavaPackage getTopLevelPackage(String moduleName)

Specified by:

getTopLevelPackage in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

Returns:

isFeatureInstalled

public boolean isFeatureInstalled(String featureName)

Description copied from interface: ProjectOperations

Indicates whether the supplied feature is installed in any module of a project.

Specified by:

isFeatureInstalled in interface ProjectOperations

Parameters:

featureName - the name of the feature (see FeatureNames for available features)

Returns:

true if the feature is installed in any module, otherwise false

isFeatureInstalled

public boolean isFeatureInstalled(String... featureNames)

Description copied from interface: ProjectOperations

Indicates whether any of the supplied features are installed in any module of a project.

Specified by:

isFeatureInstalled in interface ProjectOperations

Parameters:

featureNames - the names of the features (see FeatureNames for available features)

Returns:

true if any of the supplied features are installed in the focused module, otherwise false

isFeatureInstalled

public boolean isFeatureInstalled(Pom module,
                                  String featureName)

Description copied from interface: ProjectOperations

Indicates whether any of the supplied features are installed in the provided module.

Specified by:

isFeatureInstalled in interface ProjectOperations

Parameters:

module - the Pom where to search the feature.

featureName - the names of the feature (see FeatureNames for available features)

Returns:

`true` if the supplied feature is installed in the provided module, otherwise `false`.

isFocusedProjectAvailable

public boolean isFocusedProjectAvailable()

Description copied from interface: ProjectOperations

Indicates whether the module whose name has the focus, if any, is available.

Specified by:

isFocusedProjectAvailable in interface ProjectOperations

Returns:

see above

isModuleCreationAllowed

public boolean isModuleCreationAllowed()

Description copied from interface: ProjectOperations

Indicates whether the user can create a new project module

Specified by:

isModuleCreationAllowed in interface ProjectOperations

Returns:

see above

isModuleFocusAllowed

public boolean isModuleFocusAllowed()

Description copied from interface: ProjectOperations

Indicates whether the user can change the focused module

Specified by:

isModuleFocusAllowed in interface ProjectOperations

Returns:

see above

isMultimoduleProject

public boolean isMultimoduleProject()

Description copied from interface: ProjectOperations

Indicates whether the project is multimodule

Specified by:

isMultimoduleProject in interface ProjectOperations

Returns:

see above

isProjectAvailable

public final boolean isProjectAvailable(String moduleName)

Description copied from interface: ProjectOperations

Indicates whether a module with the given name is available.

Specified by:

isProjectAvailable in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (can be blank)

Returns:

see above

removeBuildPlugin

public void removeBuildPlugin(String moduleName,
                              Plugin plugin)

Description copied from interface: ProjectOperations

Removes any plugins with the same groupId and artifactId as the given plugin.

Specified by:

removeBuildPlugin in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

plugin - the plugin to remove (can be null)

removeBuildPluginImmediately

public void removeBuildPluginImmediately(String moduleName,
                                         Plugin plugin)

Description copied from interface: ProjectOperations

Removes any plugins with the same groupId and artifactId as the given plugin and immediately writes the pom to the file system.

Specified by:

removeBuildPluginImmediately in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

plugin - the plugin to remove (can be null)

removeBuildPlugins

public void removeBuildPlugins(String moduleName,
                               Collection<? extends Plugin> plugins)

Description copied from interface: ProjectOperations

Removes any plugins with the same groupId and artifactId as any of the given plugins.

Specified by:

removeBuildPlugins in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

plugins - the plugins to remove; can be null, any null elements will be quietly ignored

removeDependencies

public void removeDependencies(String moduleName,
                               Collection<? extends Dependency> dependenciesToRemove)

Description copied from interface: ProjectOperations

Attempts to remove the specified dependencies. If all the dependencies do not exist according to ProjectMetadata#isDependencyRegistered(Dependency), the method silently returns. Otherwise each located dependency is removed.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

removeDependencies in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

dependenciesToRemove - the dependencies to remove (required)

removeDependency

public void removeDependency(String moduleName,
                             Dependency dependency)

Description copied from interface: ProjectOperations

Attempts to remove the specified dependency. If the dependency does not exist according to ProjectMetadata#isDependencyRegistered(Dependency), the method silently returns. Otherwise the located dependency is removed.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

removeDependency in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

dependency - the dependency to remove (required)

removeDependency

public final void removeDependency(String moduleName,
                                   String groupId,
                                   String artifactId,
                                   String version)

Description copied from interface: ProjectOperations

Allows remove of an existing JAR dependency from the POM.

Provides a convenient way for third parties to instruct end users how to use the CLI to remove an unwanted dependency from their projects without requiring the user to manually edit a pom.xml or write an add-on.

Specified by:

removeDependency in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

groupId - the group id of the dependency (required)

artifactId - the artifact id of the dependency (required)

version - the version of the dependency (required)

removeDependency

public final void removeDependency(String moduleName,
                                   String groupId,
                                   String artifactId,
                                   String version,
                                   String classifier)

Description copied from interface: ProjectOperations

Allows remove of an existing JAR dependency from the POM.

Provides a convenient way for third parties to instruct end users how to use the CLI to remove an unwanted dependency from their projects without requiring the user to manually edit a pom.xml or write an add-on.

Specified by:

removeDependency in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

groupId - the group id of the dependency (required)

artifactId - the artifact id of the dependency (required)

version - the version of the dependency (required)

classifier - the classifier of the dependency

removeFilter

public void removeFilter(String moduleName,
                         Filter filter)

Description copied from interface: ProjectOperations

Attempts to remove the specified filter. If the filter does not exist according to ProjectMetadata#isFilterRegistered(org.springframework.roo.project.Filter) , the method silently returns. Otherwise the located filter is removed.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

removeFilter in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

filter - the filter to remove (required)

removePluginRepository

public void removePluginRepository(String moduleName,
                                   Repository repository)

Description copied from interface: ProjectOperations

Attempts to remove the specified plugin repository. If the plugin repository does not exist according to ProjectMetadata#isPluginRepositoryRegistered(Repository), the method silently returns. Otherwise the located plugin repository is removed.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

removePluginRepository in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

repository - the plugin repository to remove (required)

removeProperty

public void removeProperty(String moduleName,
                           Property property)

Description copied from interface: ProjectOperations

Attempts to remove the specified property dependency. If the dependency does not exist according to ProjectMetadata#isPropertyRegistered(Property), the method silently returns. Otherwise the located dependency is removed.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

removeProperty in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

property - the property to remove (required)

removeRepository

public void removeRepository(String moduleName,
                             Repository repository)

Description copied from interface: ProjectOperations

Attempts to remove the specified repository. If the repository does not exist according to ProjectMetadata#isRepositoryRegistered(Repository), the method silently returns. Otherwise the located repository is removed.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

removeRepository in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

repository - the repository to remove (required)

removeResource

public void removeResource(String moduleName,
                           Resource resource)

Description copied from interface: ProjectOperations

Attempts to remove the specified resource. If the resource does not exist according to ProjectMetadata#isResourceRegistered(Resource), the method silently returns. Otherwise the located resource is removed.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

removeResource in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

resource - the resource to remove (required)

setModule

public void setModule(Pom module)

Description copied from interface: ProjectOperations

Sets the currently focused module

Specified by:

setModule in interface ProjectOperations

Parameters:

module - the module to focus upon (required)

unbindFeature

protected void unbindFeature(Feature feature)

updateBuildPlugin

public void updateBuildPlugin(String moduleName,
                              Plugin plugin)

Description copied from interface: ProjectOperations

Verifies if the specified build plugin is present. If it is present, silently returns. If it is not present, removes any build plugin which matches ProjectMetadata#getBuildPluginsExcludingVersion(Plugin). Always adds the presented plugin.

Specified by:

updateBuildPlugin in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

plugin - the build plugin to update (required)

updateDependencyScope

public void updateDependencyScope(String moduleName,
                                  Dependency dependency,
                                  DependencyScope dependencyScope)

Description copied from interface: ProjectOperations

Attempts to update the scope of the specified dependency. If the dependency does not exist according to ProjectMetadata#isDependencyRegistered(Dependency), the method silently returns. Otherwise the located dependency is updated.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

updateDependencyScope in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

dependency - the dependency to update (required)

dependencyScope - the dependency scope. May be null, in which case the element will be removed

updateProjectType

public void updateProjectType(String moduleName,
                              ProjectType projectType)

Description copied from interface: ProjectOperations

Attempts to update the project packaging type as defined via ProjectType. If the project packaging is not defined it will create a new definition.

An exception is thrown if this method is called before there is ProjectMetadata available, or if the on-disk representation cannot be modified for any reason.

Specified by:

updateProjectType in interface ProjectOperations

Parameters:

moduleName - the name of the module to act upon (required)

projectType - the project type to update (required)