Class GroupIdRemoteRepositoryFilterSource

java.lang.Object
org.eclipse.aether.internal.impl.filter.RemoteRepositoryFilterSourceSupport
org.eclipse.aether.internal.impl.filter.GroupIdRemoteRepositoryFilterSource
All Implemented Interfaces:
org.eclipse.aether.spi.connector.filter.RemoteRepositoryFilterSource, org.eclipse.aether.spi.resolution.ArtifactResolverPostProcessor
@Singleton @Named("groupId") public final class GroupIdRemoteRepositoryFilterSource extends RemoteRepositoryFilterSourceSupport implements org.eclipse.aether.spi.resolution.ArtifactResolverPostProcessor
Remote repository filter source filtering on G coordinate. It is backed by a file that is parsed into GroupTree.

The file can be authored manually. The file can also be pre-populated by "record" functionality of this filter. When "recording", this filter will not filter out anything, but will instead populate the file with all encountered groupIds recorded as =groupId. The recorded file should be authored afterward to fine tune it, as there is no optimization in place (ie to look for smallest common parent groupId and alike).

The groupId file is expected on path "${basedir}/groupId-${repository.id}.txt".

The groupId file once loaded are cached in component, so in-flight groupId file change during component existence are NOT noticed.

Since:
1.9.0
See Also:

  • Field Details

    • NAME

      public static final String NAME
      See Also:

    • CONFIG_PROP_ENABLED

      public static final String CONFIG_PROP_ENABLED
      Configuration to enable the GroupId filter (enabled by default). Can be fine-tuned per repository using repository ID suffixes. Important: For this filter to take effect, you must provide configuration files. Without configuration files, the enabled filter remains dormant and does not interfere with resolution. Configuration Files:
      • Location: Directory specified by CONFIG_PROP_BASEDIR (defaults to $LOCAL_REPO/.remoteRepositoryFilters)
      • Naming: groupId-$(repository.id).txt
      • Content: One groupId per line to allow/block from the repository
      Recommended Setup (Per-Project): Use project-specific configuration to avoid repository ID clashes. Add to .mvn/maven.config: 
      -Daether.remoteRepositoryFilter.groupId=true
-Daether.remoteRepositoryFilter.groupId.basedir=${session.rootDirectory}/.mvn/rrf/
      Then create groupId-myrepoId.txt files in the .mvn/rrf/ directory and commit them to version control.
      See Also:

    • DEFAULT_ENABLED

      public static final boolean DEFAULT_ENABLED
      See Also:

    • CONFIG_PROP_BASEDIR

      public static final String CONFIG_PROP_BASEDIR
      The basedir where to store filter files. If path is relative, it is resolved from local repository root.
      See Also:

    • LOCAL_REPO_PREFIX_DIR

      public static final String LOCAL_REPO_PREFIX_DIR
      See Also:

    • CONFIG_PROP_RECORD

      public static final String CONFIG_PROP_RECORD
      Should filter go into "record" mode (and collect encountered artifacts)?
      See Also:

  • Constructor Details

  • Method Details

    • isEnabled

      protected boolean isEnabled(org.eclipse.aether.RepositorySystemSession session)
      Description copied from class: RemoteRepositoryFilterSourceSupport
      Returns true if session configuration contains this name set to true.

      Default is true.

      Specified by:
      isEnabled in class RemoteRepositoryFilterSourceSupport

    • getRemoteRepositoryFilter

      public org.eclipse.aether.spi.connector.filter.RemoteRepositoryFilter getRemoteRepositoryFilter(org.eclipse.aether.RepositorySystemSession session)
      Specified by:
      getRemoteRepositoryFilter in interface org.eclipse.aether.spi.connector.filter.RemoteRepositoryFilterSource

    • postProcess

      public void postProcess(org.eclipse.aether.RepositorySystemSession session, List<org.eclipse.aether.resolution.ArtifactResult> artifactResults)
      Specified by:
      postProcess in interface org.eclipse.aether.spi.resolution.ArtifactResolverPostProcessor