This is an automated email from the ASF dual-hosted git repository.
cstamas pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/maven-resolver.git
The following commit(s) were added to refs/heads/master by this push:
new e48e42a4 [MRESOLVER-587] Memory usage improvements (#537)
e48e42a4 is described below
commit e48e42a4483cdd31fec78470a30a85d39b922671
Author: Tamas Cservenak <ta...@cservenak.net>
AuthorDate: Fri Aug 2 14:02:49 2024 +0200
[MRESOLVER-587] Memory usage improvements (#537)
Do not use `Object` as descriptor key, use dedicated type. And intern the
`List<Dependency>` on artifact descriptors. Also introduce "intern"-ing of
ArtifactDescriptor dependencies and managedDependencies that is configurable
(speed vs memory).
---
https://issues.apache.org/jira/browse/MRESOLVER-587
---
.../aether/internal/impl/collect/DataPool.java | 124 +++++++++++++-
.../impl/collect/DependencyCollectorDelegate.java | 2 +-
.../aether/internal/impl/collect/DataPoolTest.java | 2 +-
src/site/markdown/configuration.md | 183 +++++++++++----------
4 files changed, 210 insertions(+), 101 deletions(-)
diff --git
a/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/collect/DataPool.java
b/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/collect/DataPool.java
index adee925f..49abfd3f 100644
---
a/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/collect/DataPool.java
+++
b/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/collect/DataPool.java
@@ -90,12 +90,49 @@ public final class DataPool {
*/
public static final String CONFIG_PROP_COLLECTOR_POOL_DESCRIPTOR =
CONFIG_PROPS_PREFIX + "descriptor";
+ /**
+ * Flag controlling interning data pool type used by dependency lists
collector for ArtifactDescriptor (POM) instances,
+ * matters for heap consumption. By default, uses “weak” references
(consume less heap). Using “hard” will make it
+ * much more memory aggressive and possibly faster (system and Java
dependent). Supported values: "hard", "weak".
+ *
+ * @since 1.9.22
+ * @configurationSource {@link
RepositorySystemSession#getConfigProperties()}
+ * @configurationType {@link java.lang.String}
+ * @configurationDefaultValue {@link #HARD}
+ */
+ public static final String CONFIG_PROP_COLLECTOR_POOL_DEPENDENCY_LISTS =
+ "aether.dependencyCollector.pool.dependencyLists";
+
+ /**
+ * Flag controlling interning artifact descriptor dependencies.
+ *
+ * @since 1.9.22
+ * @configurationSource {@link
RepositorySystemSession#getConfigProperties()}
+ * @configurationType {@link java.lang.Boolean}
+ * @configurationDefaultValue false
+ */
+ public static final String
CONFIG_PROP_COLLECTOR_POOL_INTERN_ARTIFACT_DESCRIPTOR_DEPENDENCIES =
+
"aether.dependencyCollector.pool.internArtifactDescriptorDependencies";
+
+ /**
+ * Flag controlling interning artifact descriptor managed dependencies.
+ *
+ * @since 1.9.22
+ * @configurationSource {@link
RepositorySystemSession#getConfigProperties()}
+ * @configurationType {@link java.lang.Boolean}
+ * @configurationDefaultValue true
+ */
+ public static final String
CONFIG_PROP_COLLECTOR_POOL_INTERN_ARTIFACT_DESCRIPTOR_MANAGED_DEPENDENCIES =
+
"aether.dependencyCollector.pool.internArtifactDescriptorManagedDependencies";
+
private static final String ARTIFACT_POOL = DataPool.class.getName() +
"$Artifact";
private static final String DEPENDENCY_POOL = DataPool.class.getName() +
"$Dependency";
private static final String DESCRIPTORS = DataPool.class.getName() +
"$Descriptors";
+ private static final String DEPENDENCY_LISTS_POOL =
DataPool.class.getName() + "$DependencyLists";
+
public static final ArtifactDescriptorResult NO_DESCRIPTOR =
new ArtifactDescriptorResult(new ArtifactDescriptorRequest());
@@ -112,7 +149,12 @@ public final class DataPool {
/**
* Descriptor interning pool, lives across session (if session carries
non-null {@link RepositoryCache}).
*/
- private final InternPool<Object, Descriptor> descriptors;
+ private final InternPool<DescriptorKey, Descriptor> descriptors;
+
+ /**
+ * {@link Dependency} list interning pool, lives across session (if
session carries non-null {@link RepositoryCache}).
+ */
+ private final InternPool<List<Dependency>, List<Dependency>>
dependencyLists;
/**
* Constraint cache, lives during single collection invocation (same as
this DataPool instance).
@@ -124,17 +166,29 @@ public final class DataPool {
*/
private final ConcurrentHashMap<Object, List<DependencyNode>> nodes;
+ private final boolean internArtifactDescriptorDependencies;
+
+ private final boolean internArtifactDescriptorManagedDependencies;
+
@SuppressWarnings("unchecked")
public DataPool(RepositorySystemSession session) {
final RepositoryCache cache = session.getCache();
+ internArtifactDescriptorDependencies = ConfigUtils.getBoolean(
+ session, false,
CONFIG_PROP_COLLECTOR_POOL_INTERN_ARTIFACT_DESCRIPTOR_DEPENDENCIES);
+ internArtifactDescriptorManagedDependencies = ConfigUtils.getBoolean(
+ session, true,
CONFIG_PROP_COLLECTOR_POOL_INTERN_ARTIFACT_DESCRIPTOR_MANAGED_DEPENDENCIES);
+
InternPool<Artifact, Artifact> artifactsPool = null;
InternPool<Dependency, Dependency> dependenciesPool = null;
- InternPool<Object, Descriptor> descriptorsPool = null;
+ InternPool<DescriptorKey, Descriptor> descriptorsPool = null;
+ InternPool<List<Dependency>, List<Dependency>> dependencyListsPool =
null;
if (cache != null) {
artifactsPool = (InternPool<Artifact, Artifact>)
cache.get(session, ARTIFACT_POOL);
dependenciesPool = (InternPool<Dependency, Dependency>)
cache.get(session, DEPENDENCY_POOL);
- descriptorsPool = (InternPool<Object, Descriptor>)
cache.get(session, DESCRIPTORS);
+ descriptorsPool = (InternPool<DescriptorKey, Descriptor>)
cache.get(session, DESCRIPTORS);
+ dependencyListsPool =
+ (InternPool<List<Dependency>, List<Dependency>>)
cache.get(session, DEPENDENCY_LISTS_POOL);
}
if (artifactsPool == null) {
@@ -164,9 +218,20 @@ public final class DataPool {
}
}
+ if (dependencyListsPool == null) {
+ String dependencyListsPoolType =
+ ConfigUtils.getString(session, HARD,
CONFIG_PROP_COLLECTOR_POOL_DEPENDENCY_LISTS);
+
+ dependencyListsPool = createPool(dependencyListsPoolType);
+ if (cache != null) {
+ cache.put(session, DEPENDENCY_LISTS_POOL, dependencyListsPool);
+ }
+ }
+
this.artifacts = artifactsPool;
this.dependencies = dependenciesPool;
this.descriptors = descriptorsPool;
+ this.dependencyLists = dependencyListsPool;
this.constraints = new ConcurrentHashMap<>(256);
this.nodes = new ConcurrentHashMap<>(256);
@@ -180,11 +245,11 @@ public final class DataPool {
return dependencies.intern(dependency, dependency);
}
- public Object toKey(ArtifactDescriptorRequest request) {
- return request.getArtifact();
+ public DescriptorKey toKey(ArtifactDescriptorRequest request) {
+ return new DescriptorKey(request.getArtifact());
}
- public ArtifactDescriptorResult getDescriptor(Object key,
ArtifactDescriptorRequest request) {
+ public ArtifactDescriptorResult getDescriptor(DescriptorKey key,
ArtifactDescriptorRequest request) {
Descriptor descriptor = descriptors.get(key);
if (descriptor != null) {
return descriptor.toResult(request);
@@ -192,14 +257,24 @@ public final class DataPool {
return null;
}
- public void putDescriptor(Object key, ArtifactDescriptorResult result) {
+ public void putDescriptor(DescriptorKey key, ArtifactDescriptorResult
result) {
+ if (internArtifactDescriptorDependencies) {
+ result.setDependencies(intern(result.getDependencies()));
+ }
+ if (internArtifactDescriptorManagedDependencies) {
+
result.setManagedDependencies(intern(result.getManagedDependencies()));
+ }
descriptors.intern(key, new GoodDescriptor(result));
}
- public void putDescriptor(Object key, ArtifactDescriptorException e) {
+ public void putDescriptor(DescriptorKey key, ArtifactDescriptorException
e) {
descriptors.intern(key, BadDescriptor.INSTANCE);
}
+ private List<Dependency> intern(List<Dependency> dependencies) {
+ return dependencyLists.intern(dependencies, dependencies);
+ }
+
public Object toKey(VersionRangeRequest request) {
return new ConstraintKey(request);
}
@@ -234,8 +309,39 @@ public final class DataPool {
nodes.put(key, children);
}
- abstract static class Descriptor {
+ public static final class DescriptorKey {
+ private final Artifact artifact;
+ private final int hashCode;
+
+ private DescriptorKey(Artifact artifact) {
+ this.artifact = artifact;
+ this.hashCode = Objects.hashCode(artifact);
+ }
+ @Override
+ public boolean equals(Object o) {
+ if (this == o) {
+ return true;
+ }
+ if (o == null || getClass() != o.getClass()) {
+ return false;
+ }
+ DescriptorKey that = (DescriptorKey) o;
+ return Objects.equals(artifact, that.artifact);
+ }
+
+ @Override
+ public int hashCode() {
+ return hashCode;
+ }
+
+ @Override
+ public String toString() {
+ return getClass().getSimpleName() + "{" + "artifact='" + artifact
+ '\'' + '}';
+ }
+ }
+
+ abstract static class Descriptor {
public abstract ArtifactDescriptorResult
toResult(ArtifactDescriptorRequest request);
}
diff --git
a/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/collect/DependencyCollectorDelegate.java
b/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/collect/DependencyCollectorDelegate.java
index 60030c0d..31a5dd91 100644
---
a/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/collect/DependencyCollectorDelegate.java
+++
b/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/collect/DependencyCollectorDelegate.java
@@ -477,7 +477,7 @@ public abstract class DependencyCollectorDelegate
implements DependencyCollector
Dependency d,
Results results,
List<DependencyNode> nodes) {
- Object key = pool.toKey(descriptorRequest);
+ DataPool.DescriptorKey key = pool.toKey(descriptorRequest);
ArtifactDescriptorResult descriptorResult = pool.getDescriptor(key,
descriptorRequest);
if (descriptorResult == null) {
try {
diff --git
a/maven-resolver-impl/src/test/java/org/eclipse/aether/internal/impl/collect/DataPoolTest.java
b/maven-resolver-impl/src/test/java/org/eclipse/aether/internal/impl/collect/DataPoolTest.java
index be39ea0c..bd735c8b 100644
---
a/maven-resolver-impl/src/test/java/org/eclipse/aether/internal/impl/collect/DataPoolTest.java
+++
b/maven-resolver-impl/src/test/java/org/eclipse/aether/internal/impl/collect/DataPoolTest.java
@@ -50,7 +50,7 @@ public class DataPoolTest {
result.addAlias(new DefaultArtifact("gid:alias:4"));
DataPool pool = newDataPool();
- Object key = pool.toKey(request);
+ DataPool.DescriptorKey key = pool.toKey(request);
pool.putDescriptor(key, result);
ArtifactDescriptorResult cached = pool.getDescriptor(key, request);
assertNotNull(cached);
diff --git a/src/site/markdown/configuration.md
b/src/site/markdown/configuration.md
index 7abd373b..c0581584 100644
--- a/src/site/markdown/configuration.md
+++ b/src/site/markdown/configuration.md
@@ -48,96 +48,99 @@ under the License.
| 21. | `"aether.dependencyCollector.maxExceptions"` | `Integer` | Only
exceptions up to the number given in this configuration property are emitted.
Exceptions which exceed that number are swallowed. | `50` | 1.8.0 | No |
Session Configuration |
| 22. | `"aether.dependencyCollector.pool.artifact"` | `String` | Flag
controlling interning data pool type used by dependency collector for Artifact
instances, matters for heap consumption. By default, uses “weak” references
(consume less heap). Using “hard” will make it much more memory aggressive and
possibly faster (system and Java dependent). Supported values: "hard", "weak".
| `"weak"` | 1.9.5 | No | Session Configuration |
| 23. | `"aether.dependencyCollector.pool.dependency"` | `String` | Flag
controlling interning data pool type used by dependency collector for
Dependency instances, matters for heap consumption. By default, uses “weak”
references (consume less heap). Using “hard” will make it much more memory
aggressive and possibly faster (system and Java dependent). Supported values:
"hard", "weak". | `"weak"` | 1.9.5 | No | Session Configuration |
-| 24. | `"aether.dependencyCollector.pool.descriptor"` | `String` | Flag
controlling interning data pool type used by dependency collector for
ArtifactDescriptor (POM) instances, matters for heap consumption. By default,
uses “weak” references (consume less heap). Using “hard” will make it much more
memory aggressive and possibly faster (system and Java dependent). Supported
values: "hard", "weak". | `"hard"` | 1.9.5 | No | Session Configuration |
-| 25. | `"aether.dependencyManager.verbose"` | `Boolean` | The key in the
repository session's used to store a flag controlling the verbose mode for
dependency management. If enabled, the original attributes of a dependency
before its update due to dependency management will be recorded * in the node's
when building a dependency graph. | `false` | | No | Session
Configuration |
-| 26. | `"aether.generator.gpg.agentSocketLocations"` | `String` | The GnuPG
agent socket(s) to try. Comma separated list of socket paths. If relative, will
be resolved from user home directory. | `".gnupg/S.gpg-agent"` | 2.0.0 | No
| Session Configuration |
-| 27. | `"aether.generator.gpg.enabled"` | `Boolean` | Whether GnuPG signer is
enabled. | `false` | 2.0.0 | No | Session Configuration |
-| 28. | `"aether.generator.gpg.keyFilePath"` | `String` | The path to the
OpenPGP transferable secret key file. If relative, is resolved from local
repository root. | `"maven-signing-key.key"` | 2.0.0 | No | Session
Configuration |
-| 29. | `"aether.generator.gpg.keyFingerprint"` | `String` | The PGP Key
fingerprint as hex string (40 characters long), optional. If not set, first
secret key found will be used. | - | 2.0.0 | No | Session Configuration |
-| 30. | `"aether.generator.gpg.useAgent"` | `Boolean` | Whether GnuPG agent
should be used. | `true` | 2.0.0 | No | Session Configuration |
-| 31. | `"aether.interactive"` | `Boolean` | A flag indicating whether
interaction with the user is allowed. | `false` | | No | Session
Configuration |
-| 32. | `"aether.layout.maven2.checksumAlgorithms"` | `String` |
Comma-separated list of checksum algorithms with which checksums are validated
(downloaded) and generated (uploaded) with this layout. Resolver by default
supports following algorithms: MD5, SHA-1, SHA-256 and SHA-512. New algorithms
can be added by implementing ChecksumAlgorithmFactory component. |
`"SHA-1,MD5"` | 1.8.0 | Yes | Session Configuration |
-| 33. | `"aether.lrm.enhanced.localPrefix"` | `String` | The prefix to use for
locally installed artifacts. | `"installed"` | 1.8.1 | No | Session
Configuration |
-| 34. | `"aether.lrm.enhanced.releasesPrefix"` | `String` | The prefix to use
for release artifacts. | `"releases"` | 1.8.1 | No | Session Configuration |
-| 35. | `"aether.lrm.enhanced.remotePrefix"` | `String` | The prefix to use
for remotely cached artifacts. | `"cached"` | 1.8.1 | No | Session
Configuration |
-| 36. | `"aether.lrm.enhanced.snapshotsPrefix"` | `String` | The prefix to use
for snapshot artifacts. | `"snapshots"` | 1.8.1 | No | Session
Configuration |
-| 37. | `"aether.lrm.enhanced.split"` | `Boolean` | Whether LRM should split
local and remote artifacts. | `false` | 1.8.1 | No | Session Configuration |
-| 38. | `"aether.lrm.enhanced.splitLocal"` | `Boolean` | Whether locally
installed artifacts should be split by version (release/snapshot). | `false`
| 1.8.1 | No | Session Configuration |
-| 39. | `"aether.lrm.enhanced.splitRemote"` | `Boolean` | Whether cached
artifacts should be split by version (release/snapshot). | `false` | 1.8.1 |
No | Session Configuration |
-| 40. | `"aether.lrm.enhanced.splitRemoteRepository"` | `Boolean` | Whether
cached artifacts should be split by origin repository (repository ID). |
`false` | 1.8.1 | No | Session Configuration |
-| 41. | `"aether.lrm.enhanced.splitRemoteRepositoryLast"` | `Boolean` | For
cached artifacts, if both splitRemote and splitRemoteRepository are set to true
sets the splitting order: by default it is repositoryId/version (false) or
version/repositoryId (true) | `false` | 1.8.1 | No | Session Configuration |
-| 42. | `"aether.lrm.enhanced.trackingFilename"` | `String` | Filename of the
file in which to track the remote repositories. | `"_remote.repositories"` |
| No | Session Configuration |
-| 43. | `"aether.metadataResolver.threads"` | `Integer` | Number of threads to
use in parallel for resolving metadata. | `4` | 0.9.0.M4 | No | Session
Configuration |
-| 44. | `"aether.named.diagnostic.enabled"` | `Boolean` | System property key
to enable locking diagnostic collection. | `false` | 1.9.11 | No | Java
System Properties |
-| 45. | `"aether.named.file-lock.attempts"` | `Integer` | Tweak: on Windows,
the presence of <em>StandardOpenOption#DELETE_ON_CLOSE</em> causes concurrency
issues. This flag allows to implement similar fix as referenced JDK bug report:
retry and hope the best. Default value is 5 attempts (will retry 4 times). |
`5` | 1.7.3 | No | Java System Properties |
-| 46. | `"aether.named.file-lock.deleteLockFiles"` | `Boolean` | Tweak: on
Windows, the presence of <em>StandardOpenOption#DELETE_ON_CLOSE</em> causes
concurrency issues. This flag allows to have it removed from effective flags,
at the cost that lockfile directory becomes crowded with 0 byte sized lock
files that are never cleaned up. Default value is on non-Windows OS. See <a
href="https://bugs.openjdk.org/browse/JDK-8252883";>JDK-8252883</a> for Windows
related bug. Users on Windows ca [...]
-| 47. | `"aether.named.file-lock.sleepMillis"` | `Long` | Tweak: When used,
the amount of milliseconds to sleep between subsequent retries. Default value
is 50 milliseconds. | `50` | 1.7.3 | No | Java System Properties |
-| 48. | `"aether.named.ipc.debug"` | `Boolean` | Should the IPC server log
debug messages? (i.e. for testing purposes) | `false` | 2.0.1 | No | Java
System Properties |
-| 49. | `"aether.named.ipc.family"` | `String` | IPC socket family to use. |
`"unix"` | 2.0.1 | No | Java System Properties |
-| 50. | `"aether.named.ipc.idleTimeout"` | `Integer` | IPC idle timeout in
seconds. If there is no IPC request during idle time, it will stop. | `60` |
2.0.1 | No | Java System Properties |
-| 51. | `"aether.named.ipc.nativeName"` | `String` | The name if the IPC
server native executable (without file extension like ".exe") | `"ipc-sync"`
| 2.0.1 | No | Java System Properties |
-| 52. | `"aether.named.ipc.nofork"` | `Boolean` | Should the IPC server not
fork? (i.e. for testing purposes) | `false` | 2.0.1 | No | Java System
Properties |
-| 53. | `"aether.named.ipc.nonative"` | `Boolean` | Should the IPC server not
use native executable? | `true` | 2.0.1 | No | Java System Properties |
-| 54. | `"aether.offline.hosts"` | `String` | Comma-separated list of hosts
which are supposed to be resolved offline. | - | | No | Session
Configuration |
-| 55. | `"aether.offline.protocols"` | `String` | Comma-separated list of
protocols which are supposed to be resolved offline. | - | | No | Session
Configuration |
-| 56. | `"aether.priority.cached"` | `Boolean` | A flag indicating whether the
created ordered components should be cached in session. | `true` | 2.0.0 |
No | Session Configuration |
-| 57. | `"aether.priority.implicit"` | `Boolean` | A flag indicating whether
the priorities of pluggable extensions are implicitly given by their iteration
order such that the first extension has the highest priority. If set, an
extension's built-in priority as well as any corresponding configuration
properties are ignored when searching for a suitable implementation among the
available extensions. This priority mode is meant for cases where the
application will present/inject extension [...]
-| 58. | `"aether.remoteRepositoryFilter.groupId"` | `Boolean` | Is filter
enabled? | `false` | 1.9.0 | No | Session Configuration |
-| 59. | `"aether.remoteRepositoryFilter.groupId.basedir"` | `String` | The
basedir where to store filter files. If path is relative, it is resolved from
local repository root. | `".remoteRepositoryFilters"` | 1.9.0 | No |
Session Configuration |
-| 60. | `"aether.remoteRepositoryFilter.groupId.record"` | `Boolean` | Should
filter go into "record" mode (and collect encountered artifacts)? | `false` |
1.9.0 | No | Session Configuration |
-| 61. | `"aether.remoteRepositoryFilter.prefixes"` | `Boolean` | Is filter
enabled? | `false` | 1.9.0 | No | Session Configuration |
-| 62. | `"aether.remoteRepositoryFilter.prefixes.basedir"` | `String` | The
basedir where to store filter files. If path is relative, it is resolved from
local repository root. | `".remoteRepositoryFilters"` | 1.9.0 | No |
Session Configuration |
-| 63. | `"aether.snapshotFilter"` | `Boolean` | The key in the repository
session's used to store a flag whether this filter should be forced to ban
snapshots. By default, snapshots are only filtered if the root artifact is not
a snapshot. | `false` | | No | Session Configuration |
-| 64. | `"aether.syncContext.named.basedir.locksDir"` | `String` | The
location of the directory toi use for locks. If relative path, it is resolved
from the local repository root. | `".locks"` | 1.9.0 | No | Session
Configuration |
-| 65. | `"aether.syncContext.named.discriminating.discriminator"` | `String` |
Configuration property to pass in discriminator, if needed. If not present, it
is auto-calculated. | - | 1.7.0 | No | Session Configuration |
-| 66. | `"aether.syncContext.named.discriminating.hostname"` | `String` |
Configuration property to pass in hostname, if needed. If not present, hostname
as reported by system will be used. | - | 1.7.0 | No | Session
Configuration |
-| 67. | `"aether.syncContext.named.factory"` | `String` | Name of the lock
factory to use in session. | `"file-lock"` | 1.9.1 | No | Session
Configuration |
-| 68. | `"aether.syncContext.named.hashing.depth"` | `Integer` | The depth how
many levels should adapter create. Acceptable values are 0-4 (inclusive). |
`2` | 1.9.0 | No | Session Configuration |
-| 69. | `"aether.syncContext.named.nameMapper"` | `String` | Name of the name
mapper to use in session. Out of the box supported ones are "static", "gav",
"file-gav", "file-hgav", "file-static" and "discriminating". | `"file-gav"` |
1.9.1 | No | Session Configuration |
-| 70. | `"aether.syncContext.named.redisson.address"` | `String` | Address of
the Redis instance. Optional. | `"redis://localhost:6379"` | 2.0.0 | No |
Java System Properties |
-| 71. | `"aether.syncContext.named.redisson.configFile"` | `String` | Path to
a Redisson configuration file in YAML format. Read official documentation for
details. | - | 1.7.0 | No | Java System Properties |
-| 72. | `"aether.syncContext.named.retry"` | `Integer` | The amount of retries
on time-out. | `1` | 1.7.0 | No | Session Configuration |
-| 73. | `"aether.syncContext.named.retry.wait"` | `Long` | The amount of
milliseconds to wait between retries on time-out. | `200l` | 1.7.0 | No |
Session Configuration |
-| 74. | `"aether.syncContext.named.time"` | `Long` | The maximum of time
amount to be blocked to obtain lock. | `30l` | 1.7.0 | No | Session
Configuration |
-| 75. | `"aether.syncContext.named.time.unit"` | `String` | The unit of
maximum time amount to be blocked to obtain lock. Use TimeUnit enum names. |
`"SECONDS"` | 1.7.0 | No | Session Configuration |
-| 76. | `"aether.system.dependencyVisitor"` | `String` | A flag indicating
which visitor should be used to "flatten" the dependency graph into list.
Default is same as in older resolver versions "preOrder", while it can accept
values like "postOrder" and "levelOrder". | `"preOrder"` | 2.0.0 | No |
Session Configuration |
-| 77. | `"aether.transport.apache.https.cipherSuites"` | `String` |
Comma-separated list of <a
href="https://docs.oracle.com/javase/7/docs/technotes/guides/security/StandardNames.html#ciphersuites";>Cipher
Suites</a> which are enabled for HTTPS connections. | - | 2.0.0 | No |
Session Configuration |
-| 78. | `"aether.transport.apache.https.protocols"` | `String` |
Comma-separated list of <a
href="https://docs.oracle.com/javase/7/docs/technotes/guides/security/StandardNames.html#jssenames";>Protocols
</a> which are enabled for HTTPS connections. | - | 2.0.0 | No | Session
Configuration |
-| 79. | `"aether.transport.apache.retryHandler.name"` | `String` | The name of
retryHandler, supported values are “standard”, that obeys RFC-2616, regarding
idempotent methods, and “default” that considers requests w/o payload as
idempotent. | `"standard"` | 2.0.0 | Yes | Session Configuration |
-| 80. | `"aether.transport.apache.retryHandler.requestSentEnabled"` |
`Boolean` | Set to true if it is acceptable to retry non-idempotent requests,
that have been sent. | `false` | 2.0.0 | Yes | Session Configuration |
-| 81. | `"aether.transport.apache.useSystemProperties"` | `Boolean` | If
enabled, underlying Apache HttpClient will use system properties as well to
configure itself (typically used to set up HTTP Proxy via Java system
properties). See HttpClientBuilder for used properties. This mode is not
recommended, better use documented ways of configuration instead. | `false` |
2.0.0 | Yes | Session Configuration |
-| 82. | `"aether.transport.classpath.loader"` | `ClassLoader` | The key in the
repository session's used to store a from which resources should be
retrieved. If unspecified, the of the current thread will be used. | - | |
No | Session Configuration |
-| 83. | `"aether.transport.http.connectTimeout"` | `Integer` | The maximum
amount of time (in milliseconds) to wait for a successful connection to a
remote server. Non-positive values indicate no timeout. | `10000` | | Yes
| Session Configuration |
-| 84. | `"aether.transport.http.connectionMaxTtl"` | `Integer` | Total time to
live in seconds for an HTTP connection, after that time, the connection will be
dropped (no matter for how long it was idle). | `300` | 1.9.8 | Yes |
Session Configuration |
-| 85. | `"aether.transport.http.credentialEncoding"` | `String` | The
encoding/charset to use when exchanging credentials with HTTP servers. Besides
this general key, clients may also specify the encoding for a specific remote
repository by appending the suffix to this key when storing the charset name.
| `"ISO-8859-1"` | | Yes | Session Configuration |
-| 86. | `"aether.transport.http.expectContinue"` | `Boolean` | Boolean flag
should the HTTP transport use expect-continue handshake for PUT requests. Not
all transport support this option. This option may be needed for some broken
HTTP servers. Default value corresponds to given transport default one
(resolver does not override those), but if configuration IS given, it will
replace given transport own default value. | - | 1.9.17 | Yes | Session
Configuration |
-| 87. | `"aether.transport.http.headers"` | `java.util.Map` | The request
headers to use for HTTP-based repository connectors. The headers are specified
using a , mapping a header name to its value. Besides this general key, clients
may also specify headers for a specific remote repository by appending the
suffix to this key when storing the headers map. The repository-specific
headers map is supposed to be complete, i.e. is not merged with the general
headers map. | - | | Yes | Se [...]
-| 88. | `"aether.transport.http.localAddress"` | `String` | The local address
(interface) to use with HTTP transport. Not all transport supports this option.
| - | 2.0.0 | Yes | Session Configuration |
-| 89. | `"aether.transport.http.maxConnectionsPerRoute"` | `Integer` | The
maximum concurrent connections per route HTTP client is allowed to use. | `50`
| 1.9.8 | Yes | Session Configuration |
-| 90. | `"aether.transport.http.preemptiveAuth"` | `Boolean` | Should HTTP
client use preemptive-authentication for all HTTP verbs (works only w/ BASIC).
By default, is disabled, as it is considered less secure. | `false` | 1.9.6 |
Yes | Session Configuration |
-| 91. | `"aether.transport.http.preemptivePutAuth"` | `Boolean` | Boolean flag
should the HTTP transport use preemptive-auth for PUT requests. Not all
transport support this option. | `true` | 2.0.0 (moved out from
maven-resolver-transport-http). | Yes | Session Configuration |
-| 92. | `"aether.transport.http.requestTimeout"` | `Integer` | The maximum
amount of time (in milliseconds) to wait for remaining data to arrive from a
remote server. Note that this timeout does not restrict the overall duration of
a request, it only restricts the duration of inactivity between consecutive
data packets. Non-positive values indicate no timeout. | `1800000` | | Yes
| Session Configuration |
-| 93. | `"aether.transport.http.retryHandler.count"` | `Integer` | The maximum
number of times a request to a remote server should be retried in case of an
error. | `3` | 1.9.6 | Yes | Session Configuration |
-| 94. | `"aether.transport.http.retryHandler.interval"` | `Long` | The initial
retry interval in millis of request to a remote server should be waited in case
of "too many requests" (HTTP codes 429 and 503). Accepts long as milliseconds.
This value is used if remote server does not use header, in which case Server
value is obeyed. | `5000l` | 1.9.16 | Yes | Session Configuration |
-| 95. | `"aether.transport.http.retryHandler.intervalMax"` | `Long` | The
maximum retry interval in millis of request to a remote server above which the
request should be aborted instead. In theory, a malicious server could tell
Maven "come back after 100 years" that would stall the build for some. Using
this parameter Maven will fail the request instead, if interval is above this
value. | `300000l` | 1.9.16 | Yes | Session Configuration |
-| 96. | `"aether.transport.http.retryHandler.serviceUnavailable"` | `String` |
The HTTP codes of remote server responses that should be handled as "too many
requests" (examples: HTTP codes 429 and 503). Accepts comma separated list of
HTTP response codes. | `"429,503"` | 1.9.16 | Yes | Session Configuration |
-| 97. | `"aether.transport.http.reuseConnections"` | `Boolean` | Should HTTP
client reuse connections (in other words, pool connections) or not? | `true`
| 1.9.8 | Yes | Session Configuration |
-| 98. | `"aether.transport.http.supportWebDav"` | `Boolean` | Boolean flag
should the HTTP transport support WebDAV remote. Not all transport support this
option. | `false` | 2.0.0 (moved out from maven-resolver-transport-http). |
Yes | Session Configuration |
-| 99. | `"aether.transport.http.userAgent"` | `String` | The user agent that
repository connectors should report to servers. | `"Aether"` | | No |
Session Configuration |
-| 100. | `"aether.transport.https.securityMode"` | `String` | The mode that
sets HTTPS transport "security mode": to ignore any SSL errors (certificate
validity checks, hostname verification). The default value is . | `"default"`
| 1.9.6 | Yes | Session Configuration |
-| 101. | `"aether.transport.jdk.httpVersion"` | `String` | Use string
representation of HttpClient version enum "HTTP_2" or "HTTP_1_1" to set default
HTTP protocol to use. | `"HTTP_2"` | 2.0.0 | Yes | Session Configuration |
-| 102. | `"aether.transport.jdk.maxConcurrentRequests"` | `Integer` | The hard
limit of maximum concurrent requests JDK transport can do. This is a workaround
for the fact, that in HTTP/2 mode, JDK HttpClient initializes this value to
Integer.MAX_VALUE (!) and lowers it on first response from the remote server
(but it may be too late). See JDK bug <a
href="https://bugs.openjdk.org/browse/JDK-8225647";>JDK-8225647</a> for details.
| `100` | 2.0.0 | Yes | Session Configuration |
-| 103. | `"aether.transport.wagon.config"` | `Object` | The configuration to
use for the Wagon provider. | - | | Yes | Session Configuration |
-| 104. | `"aether.transport.wagon.perms.dirMode"` | `String` | Octal numerical
notation of permissions to set for newly created directories. Only considered
by certain Wagon providers. | - | | Yes | Session Configuration |
-| 105. | `"aether.transport.wagon.perms.fileMode"` | `String` | Octal
numerical notation of permissions to set for newly created files. Only
considered by certain Wagon providers. | - | | Yes | Session Configuration
|
-| 106. | `"aether.transport.wagon.perms.group"` | `String` | Group which
should own newly created directories/files. Only considered by certain Wagon
providers. | - | | Yes | Session Configuration |
-| 107. | `"aether.trustedChecksumsSource.sparseDirectory"` | `Boolean` | Is
checksum source enabled? | `false` | 1.9.0 | No | Session Configuration |
-| 108. | `"aether.trustedChecksumsSource.sparseDirectory.basedir"` | `String`
| The basedir where checksums are. If relative, is resolved from local
repository root. | `".checksums"` | 1.9.0 | No | Session Configuration |
-| 109. | `"aether.trustedChecksumsSource.sparseDirectory.originAware"` |
`Boolean` | Is source origin aware? | `true` | 1.9.0 | No | Session
Configuration |
-| 110. | `"aether.trustedChecksumsSource.summaryFile"` | `Boolean` | Is
checksum source enabled? | `false` | 1.9.0 | No | Session Configuration |
-| 111. | `"aether.trustedChecksumsSource.summaryFile.basedir"` | `String` |
The basedir where checksums are. If relative, is resolved from local repository
root. | `".checksums"` | 1.9.0 | No | Session Configuration |
-| 112. | `"aether.trustedChecksumsSource.summaryFile.originAware"` | `Boolean`
| Is source origin aware? | `true` | 1.9.0 | No | Session Configuration |
-| 113. | `"aether.updateCheckManager.sessionState"` | `String` | Manages the
session state, i.e. influences if the same download requests to
artifacts/metadata will happen multiple times within the same
RepositorySystemSession. If "enabled" will enable the session state. If
"bypass" will enable bypassing (i.e. store all artifact ids/metadata ids which
have been updates but not evaluating those). All other values lead to disabling
the session state completely. | `"enabled"` | | No | [...]
+| 24. | `"aether.dependencyCollector.pool.dependencyLists"` | `String` | Flag
controlling interning data pool type used by dependency lists collector for
ArtifactDescriptor (POM) instances, matters for heap consumption. By default,
uses “weak” references (consume less heap). Using “hard” will make it much more
memory aggressive and possibly faster (system and Java dependent). Supported
values: "hard", "weak". | `"hard"` | 1.9.22 | No | Session Configuration |
+| 25. | `"aether.dependencyCollector.pool.descriptor"` | `String` | Flag
controlling interning data pool type used by dependency collector for
ArtifactDescriptor (POM) instances, matters for heap consumption. By default,
uses “weak” references (consume less heap). Using “hard” will make it much more
memory aggressive and possibly faster (system and Java dependent). Supported
values: "hard", "weak". | `"hard"` | 1.9.5 | No | Session Configuration |
+| 26. |
`"aether.dependencyCollector.pool.internArtifactDescriptorDependencies"` |
`Boolean` | Flag controlling interning artifact descriptor dependencies. |
`false` | 1.9.22 | No | Session Configuration |
+| 27. |
`"aether.dependencyCollector.pool.internArtifactDescriptorManagedDependencies"`
| `Boolean` | Flag controlling interning artifact descriptor managed
dependencies. | `false` | 1.9.22 | No | Session Configuration |
+| 28. | `"aether.dependencyManager.verbose"` | `Boolean` | The key in the
repository session's used to store a flag controlling the verbose mode for
dependency management. If enabled, the original attributes of a dependency
before its update due to dependency management will be recorded * in the node's
when building a dependency graph. | `false` | | No | Session
Configuration |
+| 29. | `"aether.generator.gpg.agentSocketLocations"` | `String` | The GnuPG
agent socket(s) to try. Comma separated list of socket paths. If relative, will
be resolved from user home directory. | `".gnupg/S.gpg-agent"` | 2.0.0 | No
| Session Configuration |
+| 30. | `"aether.generator.gpg.enabled"` | `Boolean` | Whether GnuPG signer is
enabled. | `false` | 2.0.0 | No | Session Configuration |
+| 31. | `"aether.generator.gpg.keyFilePath"` | `String` | The path to the
OpenPGP transferable secret key file. If relative, is resolved from local
repository root. | `"maven-signing-key.key"` | 2.0.0 | No | Session
Configuration |
+| 32. | `"aether.generator.gpg.keyFingerprint"` | `String` | The PGP Key
fingerprint as hex string (40 characters long), optional. If not set, first
secret key found will be used. | - | 2.0.0 | No | Session Configuration |
+| 33. | `"aether.generator.gpg.useAgent"` | `Boolean` | Whether GnuPG agent
should be used. | `true` | 2.0.0 | No | Session Configuration |
+| 34. | `"aether.interactive"` | `Boolean` | A flag indicating whether
interaction with the user is allowed. | `false` | | No | Session
Configuration |
+| 35. | `"aether.layout.maven2.checksumAlgorithms"` | `String` |
Comma-separated list of checksum algorithms with which checksums are validated
(downloaded) and generated (uploaded) with this layout. Resolver by default
supports following algorithms: MD5, SHA-1, SHA-256 and SHA-512. New algorithms
can be added by implementing ChecksumAlgorithmFactory component. |
`"SHA-1,MD5"` | 1.8.0 | Yes | Session Configuration |
+| 36. | `"aether.lrm.enhanced.localPrefix"` | `String` | The prefix to use for
locally installed artifacts. | `"installed"` | 1.8.1 | No | Session
Configuration |
+| 37. | `"aether.lrm.enhanced.releasesPrefix"` | `String` | The prefix to use
for release artifacts. | `"releases"` | 1.8.1 | No | Session Configuration |
+| 38. | `"aether.lrm.enhanced.remotePrefix"` | `String` | The prefix to use
for remotely cached artifacts. | `"cached"` | 1.8.1 | No | Session
Configuration |
+| 39. | `"aether.lrm.enhanced.snapshotsPrefix"` | `String` | The prefix to use
for snapshot artifacts. | `"snapshots"` | 1.8.1 | No | Session
Configuration |
+| 40. | `"aether.lrm.enhanced.split"` | `Boolean` | Whether LRM should split
local and remote artifacts. | `false` | 1.8.1 | No | Session Configuration |
+| 41. | `"aether.lrm.enhanced.splitLocal"` | `Boolean` | Whether locally
installed artifacts should be split by version (release/snapshot). | `false`
| 1.8.1 | No | Session Configuration |
+| 42. | `"aether.lrm.enhanced.splitRemote"` | `Boolean` | Whether cached
artifacts should be split by version (release/snapshot). | `false` | 1.8.1 |
No | Session Configuration |
+| 43. | `"aether.lrm.enhanced.splitRemoteRepository"` | `Boolean` | Whether
cached artifacts should be split by origin repository (repository ID). |
`false` | 1.8.1 | No | Session Configuration |
+| 44. | `"aether.lrm.enhanced.splitRemoteRepositoryLast"` | `Boolean` | For
cached artifacts, if both splitRemote and splitRemoteRepository are set to true
sets the splitting order: by default it is repositoryId/version (false) or
version/repositoryId (true) | `false` | 1.8.1 | No | Session Configuration |
+| 45. | `"aether.lrm.enhanced.trackingFilename"` | `String` | Filename of the
file in which to track the remote repositories. | `"_remote.repositories"` |
| No | Session Configuration |
+| 46. | `"aether.metadataResolver.threads"` | `Integer` | Number of threads to
use in parallel for resolving metadata. | `4` | 0.9.0.M4 | No | Session
Configuration |
+| 47. | `"aether.named.diagnostic.enabled"` | `Boolean` | System property key
to enable locking diagnostic collection. | `false` | 1.9.11 | No | Java
System Properties |
+| 48. | `"aether.named.file-lock.attempts"` | `Integer` | Tweak: on Windows,
the presence of <em>StandardOpenOption#DELETE_ON_CLOSE</em> causes concurrency
issues. This flag allows to implement similar fix as referenced JDK bug report:
retry and hope the best. Default value is 5 attempts (will retry 4 times). |
`5` | 1.7.3 | No | Java System Properties |
+| 49. | `"aether.named.file-lock.deleteLockFiles"` | `Boolean` | Tweak: on
Windows, the presence of <em>StandardOpenOption#DELETE_ON_CLOSE</em> causes
concurrency issues. This flag allows to have it removed from effective flags,
at the cost that lockfile directory becomes crowded with 0 byte sized lock
files that are never cleaned up. Default value is on non-Windows OS. See <a
href="https://bugs.openjdk.org/browse/JDK-8252883";>JDK-8252883</a> for Windows
related bug. Users on Windows ca [...]
+| 50. | `"aether.named.file-lock.sleepMillis"` | `Long` | Tweak: When used,
the amount of milliseconds to sleep between subsequent retries. Default value
is 50 milliseconds. | `50` | 1.7.3 | No | Java System Properties |
+| 51. | `"aether.named.ipc.debug"` | `Boolean` | Should the IPC server log
debug messages? (i.e. for testing purposes) | `false` | 2.0.1 | No | Java
System Properties |
+| 52. | `"aether.named.ipc.family"` | `String` | IPC socket family to use. |
`"unix"` | 2.0.1 | No | Java System Properties |
+| 53. | `"aether.named.ipc.idleTimeout"` | `Integer` | IPC idle timeout in
seconds. If there is no IPC request during idle time, it will stop. | `60` |
2.0.1 | No | Java System Properties |
+| 54. | `"aether.named.ipc.nativeName"` | `String` | The name if the IPC
server native executable (without file extension like ".exe") | `"ipc-sync"`
| 2.0.1 | No | Java System Properties |
+| 55. | `"aether.named.ipc.nofork"` | `Boolean` | Should the IPC server not
fork? (i.e. for testing purposes) | `false` | 2.0.1 | No | Java System
Properties |
+| 56. | `"aether.named.ipc.nonative"` | `Boolean` | Should the IPC server not
use native executable? | `true` | 2.0.1 | No | Java System Properties |
+| 57. | `"aether.offline.hosts"` | `String` | Comma-separated list of hosts
which are supposed to be resolved offline. | - | | No | Session
Configuration |
+| 58. | `"aether.offline.protocols"` | `String` | Comma-separated list of
protocols which are supposed to be resolved offline. | - | | No | Session
Configuration |
+| 59. | `"aether.priority.cached"` | `Boolean` | A flag indicating whether the
created ordered components should be cached in session. | `true` | 2.0.0 |
No | Session Configuration |
+| 60. | `"aether.priority.implicit"` | `Boolean` | A flag indicating whether
the priorities of pluggable extensions are implicitly given by their iteration
order such that the first extension has the highest priority. If set, an
extension's built-in priority as well as any corresponding configuration
properties are ignored when searching for a suitable implementation among the
available extensions. This priority mode is meant for cases where the
application will present/inject extension [...]
+| 61. | `"aether.remoteRepositoryFilter.groupId"` | `Boolean` | Is filter
enabled? | `false` | 1.9.0 | No | Session Configuration |
+| 62. | `"aether.remoteRepositoryFilter.groupId.basedir"` | `String` | The
basedir where to store filter files. If path is relative, it is resolved from
local repository root. | `".remoteRepositoryFilters"` | 1.9.0 | No |
Session Configuration |
+| 63. | `"aether.remoteRepositoryFilter.groupId.record"` | `Boolean` | Should
filter go into "record" mode (and collect encountered artifacts)? | `false` |
1.9.0 | No | Session Configuration |
+| 64. | `"aether.remoteRepositoryFilter.prefixes"` | `Boolean` | Is filter
enabled? | `false` | 1.9.0 | No | Session Configuration |
+| 65. | `"aether.remoteRepositoryFilter.prefixes.basedir"` | `String` | The
basedir where to store filter files. If path is relative, it is resolved from
local repository root. | `".remoteRepositoryFilters"` | 1.9.0 | No |
Session Configuration |
+| 66. | `"aether.snapshotFilter"` | `Boolean` | The key in the repository
session's used to store a flag whether this filter should be forced to ban
snapshots. By default, snapshots are only filtered if the root artifact is not
a snapshot. | `false` | | No | Session Configuration |
+| 67. | `"aether.syncContext.named.basedir.locksDir"` | `String` | The
location of the directory toi use for locks. If relative path, it is resolved
from the local repository root. | `".locks"` | 1.9.0 | No | Session
Configuration |
+| 68. | `"aether.syncContext.named.discriminating.discriminator"` | `String` |
Configuration property to pass in discriminator, if needed. If not present, it
is auto-calculated. | - | 1.7.0 | No | Session Configuration |
+| 69. | `"aether.syncContext.named.discriminating.hostname"` | `String` |
Configuration property to pass in hostname, if needed. If not present, hostname
as reported by system will be used. | - | 1.7.0 | No | Session
Configuration |
+| 70. | `"aether.syncContext.named.factory"` | `String` | Name of the lock
factory to use in session. | `"file-lock"` | 1.9.1 | No | Session
Configuration |
+| 71. | `"aether.syncContext.named.hashing.depth"` | `Integer` | The depth how
many levels should adapter create. Acceptable values are 0-4 (inclusive). |
`2` | 1.9.0 | No | Session Configuration |
+| 72. | `"aether.syncContext.named.nameMapper"` | `String` | Name of the name
mapper to use in session. Out of the box supported ones are "static", "gav",
"file-gav", "file-hgav", "file-static" and "discriminating". | `"file-gav"` |
1.9.1 | No | Session Configuration |
+| 73. | `"aether.syncContext.named.redisson.address"` | `String` | Address of
the Redis instance. Optional. | `"redis://localhost:6379"` | 2.0.0 | No |
Java System Properties |
+| 74. | `"aether.syncContext.named.redisson.configFile"` | `String` | Path to
a Redisson configuration file in YAML format. Read official documentation for
details. | - | 1.7.0 | No | Java System Properties |
+| 75. | `"aether.syncContext.named.retry"` | `Integer` | The amount of retries
on time-out. | `1` | 1.7.0 | No | Session Configuration |
+| 76. | `"aether.syncContext.named.retry.wait"` | `Long` | The amount of
milliseconds to wait between retries on time-out. | `200l` | 1.7.0 | No |
Session Configuration |
+| 77. | `"aether.syncContext.named.time"` | `Long` | The maximum of time
amount to be blocked to obtain lock. | `30l` | 1.7.0 | No | Session
Configuration |
+| 78. | `"aether.syncContext.named.time.unit"` | `String` | The unit of
maximum time amount to be blocked to obtain lock. Use TimeUnit enum names. |
`"SECONDS"` | 1.7.0 | No | Session Configuration |
+| 79. | `"aether.system.dependencyVisitor"` | `String` | A flag indicating
which visitor should be used to "flatten" the dependency graph into list.
Default is same as in older resolver versions "preOrder", while it can accept
values like "postOrder" and "levelOrder". | `"preOrder"` | 2.0.0 | No |
Session Configuration |
+| 80. | `"aether.transport.apache.https.cipherSuites"` | `String` |
Comma-separated list of <a
href="https://docs.oracle.com/javase/7/docs/technotes/guides/security/StandardNames.html#ciphersuites";>Cipher
Suites</a> which are enabled for HTTPS connections. | - | 2.0.0 | No |
Session Configuration |
+| 81. | `"aether.transport.apache.https.protocols"` | `String` |
Comma-separated list of <a
href="https://docs.oracle.com/javase/7/docs/technotes/guides/security/StandardNames.html#jssenames";>Protocols
</a> which are enabled for HTTPS connections. | - | 2.0.0 | No | Session
Configuration |
+| 82. | `"aether.transport.apache.retryHandler.name"` | `String` | The name of
retryHandler, supported values are “standard”, that obeys RFC-2616, regarding
idempotent methods, and “default” that considers requests w/o payload as
idempotent. | `"standard"` | 2.0.0 | Yes | Session Configuration |
+| 83. | `"aether.transport.apache.retryHandler.requestSentEnabled"` |
`Boolean` | Set to true if it is acceptable to retry non-idempotent requests,
that have been sent. | `false` | 2.0.0 | Yes | Session Configuration |
+| 84. | `"aether.transport.apache.useSystemProperties"` | `Boolean` | If
enabled, underlying Apache HttpClient will use system properties as well to
configure itself (typically used to set up HTTP Proxy via Java system
properties). See HttpClientBuilder for used properties. This mode is not
recommended, better use documented ways of configuration instead. | `false` |
2.0.0 | Yes | Session Configuration |
+| 85. | `"aether.transport.classpath.loader"` | `ClassLoader` | The key in the
repository session's used to store a from which resources should be
retrieved. If unspecified, the of the current thread will be used. | - | |
No | Session Configuration |
+| 86. | `"aether.transport.http.connectTimeout"` | `Integer` | The maximum
amount of time (in milliseconds) to wait for a successful connection to a
remote server. Non-positive values indicate no timeout. | `10000` | | Yes
| Session Configuration |
+| 87. | `"aether.transport.http.connectionMaxTtl"` | `Integer` | Total time to
live in seconds for an HTTP connection, after that time, the connection will be
dropped (no matter for how long it was idle). | `300` | 1.9.8 | Yes |
Session Configuration |
+| 88. | `"aether.transport.http.credentialEncoding"` | `String` | The
encoding/charset to use when exchanging credentials with HTTP servers. Besides
this general key, clients may also specify the encoding for a specific remote
repository by appending the suffix to this key when storing the charset name.
| `"ISO-8859-1"` | | Yes | Session Configuration |
+| 89. | `"aether.transport.http.expectContinue"` | `Boolean` | Boolean flag
should the HTTP transport use expect-continue handshake for PUT requests. Not
all transport support this option. This option may be needed for some broken
HTTP servers. Default value corresponds to given transport default one
(resolver does not override those), but if configuration IS given, it will
replace given transport own default value. | - | 1.9.17 | Yes | Session
Configuration |
+| 90. | `"aether.transport.http.headers"` | `java.util.Map` | The request
headers to use for HTTP-based repository connectors. The headers are specified
using a , mapping a header name to its value. Besides this general key, clients
may also specify headers for a specific remote repository by appending the
suffix to this key when storing the headers map. The repository-specific
headers map is supposed to be complete, i.e. is not merged with the general
headers map. | - | | Yes | Se [...]
+| 91. | `"aether.transport.http.localAddress"` | `String` | The local address
(interface) to use with HTTP transport. Not all transport supports this option.
| - | 2.0.0 | Yes | Session Configuration |
+| 92. | `"aether.transport.http.maxConnectionsPerRoute"` | `Integer` | The
maximum concurrent connections per route HTTP client is allowed to use. | `50`
| 1.9.8 | Yes | Session Configuration |
+| 93. | `"aether.transport.http.preemptiveAuth"` | `Boolean` | Should HTTP
client use preemptive-authentication for all HTTP verbs (works only w/ BASIC).
By default, is disabled, as it is considered less secure. | `false` | 1.9.6 |
Yes | Session Configuration |
+| 94. | `"aether.transport.http.preemptivePutAuth"` | `Boolean` | Boolean flag
should the HTTP transport use preemptive-auth for PUT requests. Not all
transport support this option. | `true` | 2.0.0 (moved out from
maven-resolver-transport-http). | Yes | Session Configuration |
+| 95. | `"aether.transport.http.requestTimeout"` | `Integer` | The maximum
amount of time (in milliseconds) to wait for remaining data to arrive from a
remote server. Note that this timeout does not restrict the overall duration of
a request, it only restricts the duration of inactivity between consecutive
data packets. Non-positive values indicate no timeout. | `1800000` | | Yes
| Session Configuration |
+| 96. | `"aether.transport.http.retryHandler.count"` | `Integer` | The maximum
number of times a request to a remote server should be retried in case of an
error. | `3` | 1.9.6 | Yes | Session Configuration |
+| 97. | `"aether.transport.http.retryHandler.interval"` | `Long` | The initial
retry interval in millis of request to a remote server should be waited in case
of "too many requests" (HTTP codes 429 and 503). Accepts long as milliseconds.
This value is used if remote server does not use header, in which case Server
value is obeyed. | `5000l` | 1.9.16 | Yes | Session Configuration |
+| 98. | `"aether.transport.http.retryHandler.intervalMax"` | `Long` | The
maximum retry interval in millis of request to a remote server above which the
request should be aborted instead. In theory, a malicious server could tell
Maven "come back after 100 years" that would stall the build for some. Using
this parameter Maven will fail the request instead, if interval is above this
value. | `300000l` | 1.9.16 | Yes | Session Configuration |
+| 99. | `"aether.transport.http.retryHandler.serviceUnavailable"` | `String` |
The HTTP codes of remote server responses that should be handled as "too many
requests" (examples: HTTP codes 429 and 503). Accepts comma separated list of
HTTP response codes. | `"429,503"` | 1.9.16 | Yes | Session Configuration |
+| 100. | `"aether.transport.http.reuseConnections"` | `Boolean` | Should HTTP
client reuse connections (in other words, pool connections) or not? | `true`
| 1.9.8 | Yes | Session Configuration |
+| 101. | `"aether.transport.http.supportWebDav"` | `Boolean` | Boolean flag
should the HTTP transport support WebDAV remote. Not all transport support this
option. | `false` | 2.0.0 (moved out from maven-resolver-transport-http). |
Yes | Session Configuration |
+| 102. | `"aether.transport.http.userAgent"` | `String` | The user agent that
repository connectors should report to servers. | `"Aether"` | | No |
Session Configuration |
+| 103. | `"aether.transport.https.securityMode"` | `String` | The mode that
sets HTTPS transport "security mode": to ignore any SSL errors (certificate
validity checks, hostname verification). The default value is . | `"default"`
| 1.9.6 | Yes | Session Configuration |
+| 104. | `"aether.transport.jdk.httpVersion"` | `String` | Use string
representation of HttpClient version enum "HTTP_2" or "HTTP_1_1" to set default
HTTP protocol to use. | `"HTTP_2"` | 2.0.0 | Yes | Session Configuration |
+| 105. | `"aether.transport.jdk.maxConcurrentRequests"` | `Integer` | The hard
limit of maximum concurrent requests JDK transport can do. This is a workaround
for the fact, that in HTTP/2 mode, JDK HttpClient initializes this value to
Integer.MAX_VALUE (!) and lowers it on first response from the remote server
(but it may be too late). See JDK bug <a
href="https://bugs.openjdk.org/browse/JDK-8225647";>JDK-8225647</a> for details.
| `100` | 2.0.0 | Yes | Session Configuration |
+| 106. | `"aether.transport.wagon.config"` | `Object` | The configuration to
use for the Wagon provider. | - | | Yes | Session Configuration |
+| 107. | `"aether.transport.wagon.perms.dirMode"` | `String` | Octal numerical
notation of permissions to set for newly created directories. Only considered
by certain Wagon providers. | - | | Yes | Session Configuration |
+| 108. | `"aether.transport.wagon.perms.fileMode"` | `String` | Octal
numerical notation of permissions to set for newly created files. Only
considered by certain Wagon providers. | - | | Yes | Session Configuration
|
+| 109. | `"aether.transport.wagon.perms.group"` | `String` | Group which
should own newly created directories/files. Only considered by certain Wagon
providers. | - | | Yes | Session Configuration |
+| 110. | `"aether.trustedChecksumsSource.sparseDirectory"` | `Boolean` | Is
checksum source enabled? | `false` | 1.9.0 | No | Session Configuration |
+| 111. | `"aether.trustedChecksumsSource.sparseDirectory.basedir"` | `String`
| The basedir where checksums are. If relative, is resolved from local
repository root. | `".checksums"` | 1.9.0 | No | Session Configuration |
+| 112. | `"aether.trustedChecksumsSource.sparseDirectory.originAware"` |
`Boolean` | Is source origin aware? | `true` | 1.9.0 | No | Session
Configuration |
+| 113. | `"aether.trustedChecksumsSource.summaryFile"` | `Boolean` | Is
checksum source enabled? | `false` | 1.9.0 | No | Session Configuration |
+| 114. | `"aether.trustedChecksumsSource.summaryFile.basedir"` | `String` |
The basedir where checksums are. If relative, is resolved from local repository
root. | `".checksums"` | 1.9.0 | No | Session Configuration |
+| 115. | `"aether.trustedChecksumsSource.summaryFile.originAware"` | `Boolean`
| Is source origin aware? | `true` | 1.9.0 | No | Session Configuration |
+| 116. | `"aether.updateCheckManager.sessionState"` | `String` | Manages the
session state, i.e. influences if the same download requests to
artifacts/metadata will happen multiple times within the same
RepositorySystemSession. If "enabled" will enable the session state. If
"bypass" will enable bypassing (i.e. store all artifact ids/metadata ids which
have been updates but not evaluating those). All other values lead to disabling
the session state completely. | `"enabled"` | | No | [...]
All properties which have `yes` in the column `Supports Repo ID Suffix` can be
optionally configured specifically for a repository id. In that case the
configuration property needs to be suffixed with a period followed by the
repository id of the repository to configure, e.g.
`aether.connector.http.headers.central` for repository with id `central`.
