[MPLUGIN-323] create @Requirement annotation to replace @Component (should be deprecated)

• Type: Wish
• Status: Closed
• Priority: Major
• Resolution: Won't Fix
• Affects Version/s: 3.5
• Component/s: maven-plugin-annotations, maven-plugin-tools-javadoc
• Assignee: Robert Scholte
• Reporter: Herve Boutemy
• Created: 18/Feb/17 13:43
• Updated: 19/Nov/21 17:26
• Resolved: 19/Nov/21 17:26

Description

injecting a Plexus component into a mojo is currently marked through @Component annotation (or @component javadoc tag)

This "component" term is misleading for 2 reasons:
1. in plugin descriptor, it creates a <requirement> XML element: http://maven.apache.org/ref/3-LATEST/maven-plugin-api/plugin.html#class_requirement

2. in Plexus, injecting is marked with @Requirement annotation, when @Component is used to define a component: http://codehaus-plexus.github.io/plexus-containers/plexus-component-annotations/

This annotation creates great confusion for years, then even if Plexus is being dropped for javax.inject, fixing this misleading terms would be beneficial IMHO