[MRESOLVER-440] Clean up transport names, configuration properties and documentation

• Type: Task
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Fix Version/s: 2.0.0-alpha-3, 2.0.0
• Component/s: Resolver
• Assignee: Tamas Cservenak
• Reporter: Tamas Cservenak
• Created: 20/Nov/23 17:38
• Updated: 28/Nov/23 14:24
• Resolved: 26/Nov/23 15:04

Description

Currently ApacheHC transport is called "http" while JDK transport is called "jdk" and JettyHC is "jetty". Also, historically all transports were connectors, and later was "basic" connector added and transports introduced, but many transport related configuration properties remained as "connector".

Proposed changes:

• Rename ApacheHC to "apache" transport, to "free" the "http" config key. There will be no "http" transport anymore, it is reserved for "shared HTTP related config" that is shared among multiple HTTP transports (apache, jdk, jetty...).
• Rename transport specific configurations from "aether.connector.apache..." and "aether.connector.jdk..." to their proper names "aether.transport..."
• keep "aether.transport.http..." for generic HTTP protocol related configuration (that may be used by all HTTP using transports).
• align many other (for historical reason) badly keyed property to "proper place".
• sort out documentation for these, ideally the page should be generated

As part of this work along with source changes (mostly javadoc) a "tool" has been made that auto-generates this page https://maven.apache.org/resolver/configuration.html

Issue Links

• links to: GitHub Pull Request #375
• links to: GitHub Pull Request #382