Package org.apache.maven.cling.invoker.mvnup.goals

package org.apache.maven.cling.invoker.mvnup.goals

Maven Upgrade Tool Goals and Strategies.

This package contains the implementation of the Maven upgrade tool (mvnup) that helps upgrade Maven projects to be compatible with Maven 4. The tool is organized around a goal-based architecture with pluggable upgrade strategies.

Architecture Overview

Goals

• Check - Analyzes projects and reports needed upgrades
• Apply - Applies upgrades to project files
• Help - Displays usage information

Upgrade Strategies

The tool uses a strategy pattern to handle different types of upgrades:

• ModelUpgradeStrategy - Upgrades POM model versions (4.0.0 → 4.1.0)
• PluginUpgradeStrategy - Upgrades plugin versions for Maven 4 compatibility
• InferenceStrategy - Applies Maven 4.1.0+ inference optimizations
• CompatibilityFixStrategy - Fixes Maven 4 compatibility issues

Utility Classes

• StrategyOrchestrator - Coordinates strategy execution
• PomDiscovery - Discovers POM files in multi-module projects
• DomUtils - XML manipulation utilities

Usage Examples

Check for Available Upgrades

mvnup check

Apply All Upgrades

mvnup apply --all

Upgrade to Maven 4.1.0 with Inference

mvnup apply --model 4.1.0 --infer

Extension Points

To add new upgrade strategies:

1. Implement UpgradeStrategy
2. Optionally extend AbstractUpgradeStrategy
3. Annotate with @Named and @Singleton
4. Use @Priority to control execution order

Since:

4.0.0

Related Packages

Package	Description
org.apache.maven.cling.invoker.mvnup	Implementation of the Maven Upgrade tool (mvnup).

Class	Description
AbstractUpgradeGoal	Base class for upgrade goals containing shared functionality.
AbstractUpgradeStrategy	Abstract base class for upgrade strategies that provides common functionality and reduces code duplication across strategy implementations.
Apply	The "apply" goal implementation.
Check	The "check" goal implementation.
CompatibilityFixStrategy	Strategy for applying Maven 4 compatibility fixes to POM files.
DeduplicateDependenciesStrategy	Strategy for deduplicating dependency and plugin declarations in POM files.
DomUtils	Utility class for XML operations on Maven POM files.
DuplicateElementStrategy	Strategy for removing duplicate XML elements in POM files.
EnforcerVersionRangeStrategy	Strategy for widening requireMavenVersion ranges in the maven-enforcer-plugin to allow Maven 4.
Help	The "help" goal implementation.
InferenceStrategy	Strategy for applying Maven inference optimizations.
ModelUpgradeStrategy	Strategy for upgrading Maven model versions (e.g., 4.0.0 → 4.1.0).
ModelVersionUtils	Utility class for handling Maven model version operations during upgrades.
ModuleNameFixStrategy	Strategy for fixing invalid Automatic-Module-Name manifest entries in POM files.
NashornCompatibilityStrategy	Strategy for injecting the standalone OpenJDK Nashorn engine as a plugin dependency when maven-antrun-plugin uses inline JavaScript via <script language="javascript">.
PluginMigration	Plugin migration configuration for Maven 4 compatibility.
PluginUpgrade	Plugin upgrade configuration for Maven 4 compatibility.
PluginUpgradeStrategy	Strategy for upgrading Maven plugins to recommended versions.
PluginUpgradeStrategy.PluginUpgradeInfo	Holds plugin upgrade information for Maven 4 compatibility.
PomDiscovery	Discovers and loads Maven POM files in a Maven project hierarchy.
RepositoryHttpsUpgradeStrategy	Strategy for upgrading HTTP repository URLs to HTTPS in POM files.
ResourceFilteringStrategy	Strategy for adding binary file extension exclusions to the maven-resources-plugin when resource filtering is enabled.
SourceStrategy	Strategy for migrating legacy source configuration to Maven 4.1.0+ <source> elements.
StrategyOrchestrator	domtrip-based orchestrator for executing different upgrade strategies.
ToolchainPluginStrategy	Strategy for adding the maven-toolchains-plugin with the select-jdk-toolchain goal when the project's declared --source/--release level has been retired by a newer JDK (per JEP 182).
UpgradeResult	Result of an upgrade strategy application.
UpgradeStrategy	Strategy interface for different types of upgrade operations.