You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@maven.apache.org by cs...@apache.org on 2022/09/14 17:58:32 UTC
[maven-resolver] branch remote-repository-filter updated (c8d6e6d1 -> a4bc9e9b)
This is an automated email from the ASF dual-hosted git repository.
cstamas pushed a change to branch remote-repository-filter
in repository https://gitbox.apache.org/repos/asf/maven-resolver.git
discard c8d6e6d1 WIP
discard 7a8aac64 Remote repository filtering (draft)
new a4bc9e9b Remote repository filtering (draft)
This update added new revisions after undoing existing revisions.
That is to say, some revisions that were in the old version of the
branch are not in the new version. This situation occurs
when a user --force pushes a change and generates a repository
containing something like this:
* -- * -- B -- O -- O -- O (c8d6e6d1)
\
N -- N -- N refs/heads/remote-repository-filter (a4bc9e9b)
You should already have received notification emails for all of the O
revisions, and so the following emails describe only the N revisions
from the common base, B.
Any revisions marked "omit" are not gone; other references still
refer to them. Any revisions marked "discard" are gone forever.
The 1 revisions listed above as "new" are entirely new to this
repository and will be described in separate emails. The revisions
listed as "add" were already present in the repository and have only
been added to this reference.
Summary of changes:
[maven-resolver] 01/01: Remote repository filtering (draft)
Posted by cs...@apache.org.
This is an automated email from the ASF dual-hosted git repository.
cstamas pushed a commit to branch remote-repository-filter
in repository https://gitbox.apache.org/repos/asf/maven-resolver.git
commit a4bc9e9b03567aa11414ae4b58d66650de46a50b
Author: Tamas Cservenak <ta...@cservenak.net>
AuthorDate: Tue Sep 13 20:24:24 2022 +0200
Remote repository filtering (draft)
Introduce new feature to be able to filter artifacts for
given remote repository instance, that would allow things
like "scoping" a remote repository for given groupId,
use prefixes published by repository etc.
---
.../eclipse/aether/impl/DefaultServiceLocator.java | 2 +
.../aether/impl/RemoteRepositoryFilterManager.java | 35 +++++
.../aether/impl/RemoteRepositoryManagedFilter.java | 57 +++++++
.../internal/impl/DefaultArtifactResolver.java | 101 ++++++++----
.../internal/impl/DefaultMetadataResolver.java | 27 +++-
.../impl/DefaultRepositoryConnectorProvider.java | 24 ++-
.../DefaultRemoteRepositoryFilterManager.java | 172 +++++++++++++++++++++
.../impl/filter/FilteringRepositoryConnector.java | 134 ++++++++++++++++
.../filter/StaticRemoteRepositoryFilterSource.java | 144 +++++++++++++++++
.../internal/impl/DefaultArtifactResolverTest.java | 6 +-
.../internal/impl/DefaultMetadataResolverTest.java | 3 +-
.../connector/filter/RemoteRepositoryFilter.java | 67 ++++++++
.../filter/RemoteRepositoryFilterSource.java | 45 ++++++
13 files changed, 780 insertions(+), 37 deletions(-)
diff --git a/maven-resolver-impl/src/main/java/org/eclipse/aether/impl/DefaultServiceLocator.java b/maven-resolver-impl/src/main/java/org/eclipse/aether/impl/DefaultServiceLocator.java
index 815c07cd..75aeff5d 100644
--- a/maven-resolver-impl/src/main/java/org/eclipse/aether/impl/DefaultServiceLocator.java
+++ b/maven-resolver-impl/src/main/java/org/eclipse/aether/impl/DefaultServiceLocator.java
@@ -56,6 +56,7 @@ import org.eclipse.aether.internal.impl.DefaultUpdatePolicyAnalyzer;
import org.eclipse.aether.internal.impl.EnhancedLocalRepositoryManagerFactory;
import org.eclipse.aether.internal.impl.Maven2RepositoryLayoutFactory;
import org.eclipse.aether.internal.impl.SimpleLocalRepositoryManagerFactory;
+import org.eclipse.aether.internal.impl.filter.DefaultRemoteRepositoryFilterManager;
import org.eclipse.aether.internal.impl.slf4j.Slf4jLoggerFactory;
import org.eclipse.aether.internal.impl.synccontext.DefaultSyncContextFactory;
import org.eclipse.aether.internal.impl.synccontext.named.NamedLockFactorySelector;
@@ -230,6 +231,7 @@ public final class DefaultServiceLocator
addService( NamedLockFactorySelector.class, SimpleNamedLockFactorySelector.class );
addService( ChecksumAlgorithmFactorySelector.class, DefaultChecksumAlgorithmFactorySelector.class );
addService( LocalPathComposer.class, DefaultLocalPathComposer.class );
+ addService( RemoteRepositoryFilterManager.class, DefaultRemoteRepositoryFilterManager.class );
}
private <T> Entry<T> getEntry( Class<T> type, boolean create )
diff --git a/maven-resolver-impl/src/main/java/org/eclipse/aether/impl/RemoteRepositoryFilterManager.java b/maven-resolver-impl/src/main/java/org/eclipse/aether/impl/RemoteRepositoryFilterManager.java
new file mode 100644
index 00000000..790b1456
--- /dev/null
+++ b/maven-resolver-impl/src/main/java/org/eclipse/aether/impl/RemoteRepositoryFilterManager.java
@@ -0,0 +1,35 @@
+package org.eclipse.aether.impl;
+
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+import org.eclipse.aether.RepositorySystemSession;
+
+/**
+ * Remote repository filter manager.
+ *
+ * @since TBD
+ */
+public interface RemoteRepositoryFilterManager
+{
+ /**
+ * Returns instance of remote repository filter, never {@code null}.
+ */
+ RemoteRepositoryManagedFilter getRemoteRepositoryFilter( RepositorySystemSession session );
+}
diff --git a/maven-resolver-impl/src/main/java/org/eclipse/aether/impl/RemoteRepositoryManagedFilter.java b/maven-resolver-impl/src/main/java/org/eclipse/aether/impl/RemoteRepositoryManagedFilter.java
new file mode 100644
index 00000000..053e99f0
--- /dev/null
+++ b/maven-resolver-impl/src/main/java/org/eclipse/aether/impl/RemoteRepositoryManagedFilter.java
@@ -0,0 +1,57 @@
+package org.eclipse.aether.impl;
+
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+import java.util.Map;
+
+import org.eclipse.aether.artifact.Artifact;
+import org.eclipse.aether.metadata.Metadata;
+import org.eclipse.aether.repository.RemoteRepository;
+import org.eclipse.aether.spi.connector.filter.RemoteRepositoryFilter;
+
+/**
+ * Enhanced/managed remote repository filter.
+ *
+ * @since TBD
+ */
+public interface RemoteRepositoryManagedFilter extends RemoteRepositoryFilter
+{
+ /**
+ * Managed result.
+ */
+ interface ManagedResult extends Result
+ {
+ /**
+ * The "votes" this managed result carries, never {@code null}.
+ */
+ Map<String, Result> getVotes();
+ }
+
+ /**
+ * Returns the participant of this managed filter.
+ */
+ Map<String, RemoteRepositoryFilter> getParticipants();
+
+ @Override
+ ManagedResult acceptArtifact( RemoteRepository remoteRepository, Artifact artifact );
+
+ @Override
+ ManagedResult acceptMetadata( RemoteRepository remoteRepository, Metadata metadata );
+}
diff --git a/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/DefaultArtifactResolver.java b/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/DefaultArtifactResolver.java
index 430ea381..4539b143 100644
--- a/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/DefaultArtifactResolver.java
+++ b/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/DefaultArtifactResolver.java
@@ -42,9 +42,11 @@ import org.eclipse.aether.artifact.Artifact;
import org.eclipse.aether.artifact.ArtifactProperties;
import org.eclipse.aether.impl.ArtifactResolver;
import org.eclipse.aether.impl.OfflineController;
+import org.eclipse.aether.impl.RemoteRepositoryFilterManager;
import org.eclipse.aether.impl.RemoteRepositoryManager;
import org.eclipse.aether.impl.RepositoryConnectorProvider;
import org.eclipse.aether.impl.RepositoryEventDispatcher;
+import org.eclipse.aether.spi.connector.filter.RemoteRepositoryFilter;
import org.eclipse.aether.spi.synccontext.SyncContextFactory;
import org.eclipse.aether.impl.UpdateCheck;
import org.eclipse.aether.impl.UpdateCheckManager;
@@ -106,6 +108,8 @@ public class DefaultArtifactResolver
private OfflineController offlineController;
+ private RemoteRepositoryFilterManager remoteRepositoryFilterManager;
+
public DefaultArtifactResolver()
{
// enables default constructor
@@ -117,7 +121,8 @@ public class DefaultArtifactResolver
VersionResolver versionResolver, UpdateCheckManager updateCheckManager,
RepositoryConnectorProvider repositoryConnectorProvider,
RemoteRepositoryManager remoteRepositoryManager, SyncContextFactory syncContextFactory,
- OfflineController offlineController )
+ OfflineController offlineController,
+ RemoteRepositoryFilterManager remoteRepositoryFilterManager )
{
setFileProcessor( fileProcessor );
setRepositoryEventDispatcher( repositoryEventDispatcher );
@@ -127,6 +132,7 @@ public class DefaultArtifactResolver
setRemoteRepositoryManager( remoteRepositoryManager );
setSyncContextFactory( syncContextFactory );
setOfflineController( offlineController );
+ setRemoteRepositoryFilterManager( remoteRepositoryFilterManager );
}
public void initService( ServiceLocator locator )
@@ -139,6 +145,7 @@ public class DefaultArtifactResolver
setRemoteRepositoryManager( locator.getService( RemoteRepositoryManager.class ) );
setSyncContextFactory( locator.getService( SyncContextFactory.class ) );
setOfflineController( locator.getService( OfflineController.class ) );
+ setRemoteRepositoryFilterManager( locator.getService( RemoteRepositoryFilterManager.class ) );
}
/**
@@ -203,6 +210,14 @@ public class DefaultArtifactResolver
return this;
}
+ public DefaultArtifactResolver setRemoteRepositoryFilterManager(
+ RemoteRepositoryFilterManager remoteRepositoryFilterManager )
+ {
+ this.remoteRepositoryFilterManager = requireNonNull( remoteRepositoryFilterManager,
+ "remote repository filter manager cannot be null" );
+ return this;
+ }
+
public ArtifactResult resolveArtifact( RepositorySystemSession session, ArtifactRequest request )
throws ArtifactResolutionException
{
@@ -244,6 +259,7 @@ public class DefaultArtifactResolver
List<ArtifactResult> results = new ArrayList<>( requests.size() );
boolean failures = false;
+ RemoteRepositoryFilter filter = remoteRepositoryFilterManager.getRemoteRepositoryFilter( session );
LocalRepositoryManager lrm = session.getLocalRepositoryManager();
WorkspaceReader workspace = session.getWorkspaceReader();
@@ -257,7 +273,6 @@ public class DefaultArtifactResolver
results.add( result );
Artifact artifact = request.getArtifact();
- List<RemoteRepository> repos = request.getRepositories();
artifactResolving( session, trace, artifact );
@@ -280,10 +295,30 @@ public class DefaultArtifactResolver
continue;
}
+ List<RemoteRepository> remoteRepositories = request.getRepositories();
+ List<RemoteRepository> filteredRemoteRepositories = new ArrayList<>( remoteRepositories.size() );
+ for ( RemoteRepository repository : remoteRepositories )
+ {
+ RemoteRepositoryFilter.Result filterResult = filter.acceptArtifact( repository, artifact );
+ if ( !filterResult.isAccepted() )
+ {
+ result.addException( new ArtifactNotFoundException( artifact, repository,
+ filterResult.reasoning() ) );
+ }
+ else
+ {
+ filteredRemoteRepositories.add( repository );
+ }
+ }
+ final boolean remoteConsidered = !remoteRepositories.isEmpty();
+ final boolean filteringApplied = remoteConsidered
+ && !remoteRepositories.equals( filteredRemoteRepositories );
+
VersionResult versionResult;
try
{
- VersionRequest versionRequest = new VersionRequest( artifact, repos, request.getRequestContext() );
+ VersionRequest versionRequest = new VersionRequest(
+ artifact, remoteRepositories, request.getRequestContext() );
versionRequest.setTrace( trace );
versionResult = versionResolver.resolveVersion( session, versionRequest );
}
@@ -299,11 +334,11 @@ public class DefaultArtifactResolver
{
if ( versionResult.getRepository() instanceof RemoteRepository )
{
- repos = Collections.singletonList( (RemoteRepository) versionResult.getRepository() );
+ remoteRepositories = Collections.singletonList( (RemoteRepository) versionResult.getRepository() );
}
else
{
- repos = Collections.emptyList();
+ remoteRepositories = Collections.emptyList();
}
}
@@ -320,49 +355,55 @@ public class DefaultArtifactResolver
}
}
- LocalArtifactResult local =
- lrm.find( session, new LocalArtifactRequest( artifact, repos, request.getRequestContext() ) );
+ LocalArtifactResult local = lrm.find(
+ session, new LocalArtifactRequest( artifact, remoteRepositories, request.getRequestContext() ) );
if ( isLocallyInstalled( local, versionResult ) )
{
+ boolean originAccepted = true;
if ( local.getRepository() != null )
{
result.setRepository( local.getRepository() );
+ originAccepted = !filteringApplied || filteredRemoteRepositories.contains( local.getRepository() );
}
else
{
result.setRepository( lrm.getRepository() );
}
- try
- {
- artifact = artifact.setFile( getFile( session, artifact, local.getFile() ) );
- result.setArtifact( artifact );
- artifactResolved( session, trace, artifact, result.getRepository(), null );
- }
- catch ( ArtifactTransferException e )
- {
- result.addException( e );
- }
- if ( !local.isAvailable() )
+
+ if ( originAccepted )
{
- /*
- * NOTE: Interop with simple local repository: An artifact installed by a simple local repo manager
- * will not show up in the repository tracking file of the enhanced local repository. If however the
- * maven-metadata-local.xml tells us the artifact was installed locally, we sync the repository
- * tracking file.
- */
- lrm.add( session, new LocalArtifactRegistration( artifact ) );
+ try
+ {
+ artifact = artifact.setFile( getFile( session, artifact, local.getFile() ) );
+ result.setArtifact( artifact );
+ artifactResolved( session, trace, artifact, result.getRepository(), null );
+ }
+ catch ( ArtifactTransferException e )
+ {
+ result.addException( e );
+ }
+ if ( !local.isAvailable() )
+ {
+ /*
+ * NOTE: Interop with simple local repository: An artifact installed by a simple local repo
+ * manager will not show up in the repository tracking file of the enhanced local repository.
+ * If however the maven-metadata-local.xml tells us the artifact was installed locally, we
+ * sync the repository tracking file.
+ */
+ lrm.add( session, new LocalArtifactRegistration( artifact ) );
+ }
+ continue;
}
- continue;
}
else if ( local.getFile() != null )
{
- LOGGER.debug( "Verifying availability of {} from {}", local.getFile(), repos );
+ LOGGER.debug( "Verifying availability of {} from {}", local.getFile(), remoteRepositories );
}
- LOGGER.debug( "Resolving artifact {} from {}", artifact, repos );
+ LOGGER.debug( "Resolving artifact {} from {}", artifact, remoteRepositories );
AtomicBoolean resolved = new AtomicBoolean( false );
Iterator<ResolutionGroup> groupIt = groups.iterator();
- for ( RemoteRepository repo : repos )
+ for ( RemoteRepository repo : remoteRepositories )
{
if ( !repo.getPolicy( artifact.isSnapshot() ).isEnabled() )
{
@@ -397,7 +438,7 @@ public class DefaultArtifactResolver
{
group = new ResolutionGroup( repo );
groups.add( group );
- groupIt = Collections.<ResolutionGroup>emptyList().iterator();
+ groupIt = Collections.emptyIterator();
}
group.items.add( new ResolutionItem( trace, artifact, resolved, result, local, repo ) );
}
diff --git a/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/DefaultMetadataResolver.java b/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/DefaultMetadataResolver.java
index f65f0c2f..cb7c0fe1 100644
--- a/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/DefaultMetadataResolver.java
+++ b/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/DefaultMetadataResolver.java
@@ -44,9 +44,11 @@ import org.eclipse.aether.RequestTrace;
import org.eclipse.aether.SyncContext;
import org.eclipse.aether.impl.MetadataResolver;
import org.eclipse.aether.impl.OfflineController;
+import org.eclipse.aether.impl.RemoteRepositoryFilterManager;
import org.eclipse.aether.impl.RemoteRepositoryManager;
import org.eclipse.aether.impl.RepositoryConnectorProvider;
import org.eclipse.aether.impl.RepositoryEventDispatcher;
+import org.eclipse.aether.spi.connector.filter.RemoteRepositoryFilter;
import org.eclipse.aether.spi.synccontext.SyncContextFactory;
import org.eclipse.aether.impl.UpdateCheck;
import org.eclipse.aether.impl.UpdateCheckManager;
@@ -95,6 +97,8 @@ public class DefaultMetadataResolver
private OfflineController offlineController;
+ private RemoteRepositoryFilterManager remoteRepositoryFilterManager;
+
public DefaultMetadataResolver()
{
// enables default constructor
@@ -105,7 +109,8 @@ public class DefaultMetadataResolver
UpdateCheckManager updateCheckManager,
RepositoryConnectorProvider repositoryConnectorProvider,
RemoteRepositoryManager remoteRepositoryManager, SyncContextFactory syncContextFactory,
- OfflineController offlineController )
+ OfflineController offlineController,
+ RemoteRepositoryFilterManager remoteRepositoryFilterManager )
{
setRepositoryEventDispatcher( repositoryEventDispatcher );
setUpdateCheckManager( updateCheckManager );
@@ -113,6 +118,7 @@ public class DefaultMetadataResolver
setRemoteRepositoryManager( remoteRepositoryManager );
setSyncContextFactory( syncContextFactory );
setOfflineController( offlineController );
+ setRemoteRepositoryFilterManager( remoteRepositoryFilterManager );
}
public void initService( ServiceLocator locator )
@@ -123,6 +129,7 @@ public class DefaultMetadataResolver
setRemoteRepositoryManager( locator.getService( RemoteRepositoryManager.class ) );
setSyncContextFactory( locator.getService( SyncContextFactory.class ) );
setOfflineController( locator.getService( OfflineController.class ) );
+ setRemoteRepositoryFilterManager( locator.getService( RemoteRepositoryFilterManager.class ) );
}
public DefaultMetadataResolver setRepositoryEventDispatcher( RepositoryEventDispatcher repositoryEventDispatcher )
@@ -165,6 +172,14 @@ public class DefaultMetadataResolver
return this;
}
+ public DefaultMetadataResolver setRemoteRepositoryFilterManager(
+ RemoteRepositoryFilterManager remoteRepositoryFilterManager )
+ {
+ this.remoteRepositoryFilterManager = requireNonNull( remoteRepositoryFilterManager,
+ "remote repository filter manager cannot be null" );
+ return this;
+ }
+
public List<MetadataResult> resolveMetadata( RepositorySystemSession session,
Collection<? extends MetadataRequest> requests )
{
@@ -194,6 +209,9 @@ public class DefaultMetadataResolver
Map<File, Long> localLastUpdates = new HashMap<>();
+ RemoteRepositoryFilter remoteRepositoryFilter = remoteRepositoryFilterManager
+ .getRemoteRepositoryFilter( session );
+
for ( MetadataRequest request : requests )
{
RequestTrace trace = RequestTrace.newChild( request.getTrace(), request );
@@ -226,6 +244,13 @@ public class DefaultMetadataResolver
continue;
}
+ RemoteRepositoryFilter.Result filterResult = remoteRepositoryFilter.acceptMetadata( repository, metadata );
+ if ( !filterResult.isAccepted() )
+ {
+ result.setException( new MetadataNotFoundException( metadata, repository, filterResult.reasoning() ) );
+ continue;
+ }
+
List<RemoteRepository> repositories = getEnabledSourceRepositories( repository, metadata.getNature() );
if ( repositories.isEmpty() )
diff --git a/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/DefaultRepositoryConnectorProvider.java b/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/DefaultRepositoryConnectorProvider.java
index e1f0b319..9b4fcac6 100644
--- a/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/DefaultRepositoryConnectorProvider.java
+++ b/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/DefaultRepositoryConnectorProvider.java
@@ -30,7 +30,9 @@ import javax.inject.Named;
import javax.inject.Singleton;
import org.eclipse.aether.RepositorySystemSession;
+import org.eclipse.aether.impl.RemoteRepositoryFilterManager;
import org.eclipse.aether.impl.RepositoryConnectorProvider;
+import org.eclipse.aether.internal.impl.filter.FilteringRepositoryConnector;
import org.eclipse.aether.repository.Authentication;
import org.eclipse.aether.repository.Proxy;
import org.eclipse.aether.repository.RemoteRepository;
@@ -54,20 +56,25 @@ public class DefaultRepositoryConnectorProvider
private Collection<RepositoryConnectorFactory> connectorFactories = new ArrayList<>();
+ private RemoteRepositoryFilterManager remoteRepositoryFilterManager;
+
public DefaultRepositoryConnectorProvider()
{
// enables default constructor
}
@Inject
- DefaultRepositoryConnectorProvider( Set<RepositoryConnectorFactory> connectorFactories )
+ DefaultRepositoryConnectorProvider( Set<RepositoryConnectorFactory> connectorFactories,
+ RemoteRepositoryFilterManager remoteRepositoryFilterManager )
{
setRepositoryConnectorFactories( connectorFactories );
+ setRemoteRepositoryFilterManager( remoteRepositoryFilterManager );
}
public void initService( ServiceLocator locator )
{
- connectorFactories = locator.getServices( RepositoryConnectorFactory.class );
+ setRepositoryConnectorFactories( locator.getServices( RepositoryConnectorFactory.class ) );
+ setRemoteRepositoryFilterManager( locator.getService( RemoteRepositoryFilterManager.class ) );
}
public DefaultRepositoryConnectorProvider addRepositoryConnectorFactory( RepositoryConnectorFactory factory )
@@ -90,6 +97,13 @@ public class DefaultRepositoryConnectorProvider
return this;
}
+ public DefaultRepositoryConnectorProvider setRemoteRepositoryFilterManager(
+ RemoteRepositoryFilterManager remoteRepositoryFilterManager )
+ {
+ this.remoteRepositoryFilterManager = requireNonNull( remoteRepositoryFilterManager );
+ return this;
+ }
+
public RepositoryConnector newRepositoryConnector( RepositorySystemSession session, RemoteRepository repository )
throws NoRepositoryConnectorException
{
@@ -137,7 +151,11 @@ public class DefaultRepositoryConnectorProvider
LOGGER.debug( buffer.toString() );
}
- return connector;
+ return new FilteringRepositoryConnector(
+ repository,
+ connector,
+ remoteRepositoryFilterManager.getRemoteRepositoryFilter( session )
+ );
}
catch ( NoRepositoryConnectorException e )
{
diff --git a/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/filter/DefaultRemoteRepositoryFilterManager.java b/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/filter/DefaultRemoteRepositoryFilterManager.java
new file mode 100644
index 00000000..d9eeb289
--- /dev/null
+++ b/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/filter/DefaultRemoteRepositoryFilterManager.java
@@ -0,0 +1,172 @@
+package org.eclipse.aether.internal.impl.filter;
+
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+import javax.inject.Inject;
+import javax.inject.Named;
+import javax.inject.Singleton;
+
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.stream.Collectors;
+
+import org.eclipse.aether.RepositorySystemSession;
+import org.eclipse.aether.artifact.Artifact;
+import org.eclipse.aether.impl.RemoteRepositoryFilterManager;
+import org.eclipse.aether.impl.RemoteRepositoryManagedFilter;
+import org.eclipse.aether.metadata.Metadata;
+import org.eclipse.aether.repository.RemoteRepository;
+import org.eclipse.aether.spi.connector.filter.RemoteRepositoryFilter;
+import org.eclipse.aether.spi.connector.filter.RemoteRepositoryFilterSource;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+import static java.util.Objects.requireNonNull;
+
+/**
+ * Default implementation of remote repository filter manager.
+ *
+ * @since TBD
+ */
+@Singleton
+@Named
+public final class DefaultRemoteRepositoryFilterManager
+ implements RemoteRepositoryFilterManager
+{
+ private static final String INSTANCE_KEY = "aether.remoteRepositoryFilter.instance";
+
+ private static final Logger LOGGER = LoggerFactory.getLogger( DefaultRemoteRepositoryFilterManager.class );
+
+ private final Map<String, RemoteRepositoryFilterSource> sources;
+
+ /**
+ * SL enabled ctor.
+ *
+ * @deprecated for SL and testing purposes only.
+ */
+ @Deprecated
+ public DefaultRemoteRepositoryFilterManager()
+ {
+ this.sources = new HashMap<>();
+ StaticRemoteRepositoryFilterSource staticSource = new StaticRemoteRepositoryFilterSource();
+ sources.put( staticSource.getId(), staticSource );
+ }
+
+ @Inject
+ public DefaultRemoteRepositoryFilterManager( Map<String, RemoteRepositoryFilterSource> sources )
+ {
+ this.sources = requireNonNull( sources );
+ LOGGER.debug( "Available filter sources: {}", sources.keySet() );
+ }
+
+ @Override
+ public RemoteRepositoryManagedFilter getRemoteRepositoryFilter( RepositorySystemSession session )
+ {
+ return (RemoteRepositoryManagedFilter) session.getData().computeIfAbsent( INSTANCE_KEY, () ->
+ {
+ LOGGER.debug( "Creating managed filter with participants={}", sources.keySet() );
+ return new RemoteRepositoryManagedFilterImpl(
+ sources.values().stream().collect(
+ Collectors.toMap(
+ RemoteRepositoryFilterSource::getId,
+ s -> s.getRemoteRepositoryFilter( session ) ) ) );
+ }
+ );
+ }
+
+ private static class RemoteRepositoryManagedFilterImpl implements RemoteRepositoryManagedFilter
+ {
+ private final Map<String, RemoteRepositoryFilter> participants;
+
+ RemoteRepositoryManagedFilterImpl( Map<String, RemoteRepositoryFilter> participants )
+ {
+ this.participants = Collections.unmodifiableMap( participants );
+ }
+
+ @Override
+ public Map<String, RemoteRepositoryFilter> getParticipants()
+ {
+ return participants;
+ }
+
+ @Override
+ public ManagedResult acceptArtifact( RemoteRepository remoteRepository, Artifact artifact )
+ {
+ return new Consensus( participants.entrySet().stream()
+ .collect( Collectors.toMap(
+ Map.Entry::getKey,
+ e -> e.getValue().acceptArtifact( remoteRepository, artifact ) ) ) );
+ }
+
+ @Override
+ public ManagedResult acceptMetadata( RemoteRepository remoteRepository, Metadata metadata )
+ {
+ return new Consensus( participants.entrySet().stream()
+ .collect( Collectors.toMap(
+ Map.Entry::getKey,
+ e -> e.getValue().acceptMetadata( remoteRepository, metadata ) ) ) );
+ }
+ }
+
+ private static class Consensus implements RemoteRepositoryManagedFilter.ManagedResult
+ {
+ private final Map<String, RemoteRepositoryFilter.Result> results;
+
+ private final boolean accepted;
+
+ private final String reasoning;
+
+ Consensus( Map<String, RemoteRepositoryFilter.Result> results )
+ {
+ this.results = Collections.unmodifiableMap( results );
+ if ( results.isEmpty() )
+ {
+ this.accepted = true;
+ this.reasoning = "No votes";
+ }
+ else
+ {
+ this.accepted = results.values().stream().allMatch( RemoteRepositoryFilter.Result::isAccepted );
+ this.reasoning = results.values().stream().filter( r -> !r.isAccepted() ).map(
+ RemoteRepositoryFilter.Result::reasoning ).collect(
+ Collectors.joining( "; " ) );
+ }
+ }
+
+ @Override
+ public Map<String, RemoteRepositoryFilter.Result> getVotes()
+ {
+ return results;
+ }
+
+ @Override
+ public boolean isAccepted()
+ {
+ return accepted;
+ }
+
+ @Override
+ public String reasoning()
+ {
+ return reasoning;
+ }
+ }
+}
diff --git a/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/filter/FilteringRepositoryConnector.java b/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/filter/FilteringRepositoryConnector.java
new file mode 100644
index 00000000..03773975
--- /dev/null
+++ b/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/filter/FilteringRepositoryConnector.java
@@ -0,0 +1,134 @@
+package org.eclipse.aether.internal.impl.filter;
+
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+import java.util.ArrayList;
+import java.util.Collection;
+import java.util.List;
+
+import org.eclipse.aether.repository.RemoteRepository;
+import org.eclipse.aether.spi.connector.ArtifactDownload;
+import org.eclipse.aether.spi.connector.ArtifactUpload;
+import org.eclipse.aether.spi.connector.MetadataDownload;
+import org.eclipse.aether.spi.connector.MetadataUpload;
+import org.eclipse.aether.spi.connector.RepositoryConnector;
+import org.eclipse.aether.spi.connector.filter.RemoteRepositoryFilter;
+import org.eclipse.aether.transfer.ArtifactNotFoundException;
+import org.eclipse.aether.transfer.MetadataNotFoundException;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+import static java.util.Objects.requireNonNull;
+
+/**
+ * A filtering connector that filter transfers using remote repository filter and delegates to another connector.
+ *
+ * @since TBD
+ */
+public final class FilteringRepositoryConnector
+ implements RepositoryConnector
+{
+ private static final Logger LOGGER = LoggerFactory.getLogger( FilteringRepositoryConnector.class );
+
+ private final RemoteRepository remoteRepository;
+
+ private final RepositoryConnector repositoryConnector;
+
+ private final RemoteRepositoryFilter remoteRepositoryFilter;
+
+ public FilteringRepositoryConnector( RemoteRepository remoteRepository,
+ RepositoryConnector repositoryConnector,
+ RemoteRepositoryFilter remoteRepositoryFilter )
+ {
+ this.remoteRepository = requireNonNull( remoteRepository );
+ this.repositoryConnector = requireNonNull( repositoryConnector );
+ this.remoteRepositoryFilter = requireNonNull( remoteRepositoryFilter );
+ }
+
+ @Override
+ public void close()
+ {
+ repositoryConnector.close();
+ }
+
+ @Override
+ public void get( Collection<? extends ArtifactDownload> artifactDownloads,
+ Collection<? extends MetadataDownload> metadataDownloads )
+ {
+ List<ArtifactDownload> filteredArtifactDownloads = null;
+ if ( artifactDownloads != null && !artifactDownloads.isEmpty() )
+ {
+ filteredArtifactDownloads = new ArrayList<>( artifactDownloads.size() );
+ for ( ArtifactDownload artifactDownload : artifactDownloads )
+ {
+ RemoteRepositoryFilter.Result result = remoteRepositoryFilter.acceptArtifact(
+ remoteRepository, artifactDownload.getArtifact() );
+ if ( result.isAccepted() )
+ {
+ filteredArtifactDownloads.add( artifactDownload );
+ }
+ else
+ {
+ String explain = result.reasoning();
+ LOGGER.debug( "Filtered out artifact {} from {}, reason: {}",
+ artifactDownload.getArtifact(), remoteRepository, explain );
+ artifactDownload.setException( new ArtifactNotFoundException( artifactDownload.getArtifact(),
+ remoteRepository, explain ) );
+ }
+ }
+ }
+ List<MetadataDownload> filteredMetadataDownloads = null;
+ if ( metadataDownloads != null && !metadataDownloads.isEmpty() )
+ {
+ filteredMetadataDownloads = new ArrayList<>( metadataDownloads.size() );
+ for ( MetadataDownload metadataDownload : metadataDownloads )
+ {
+ RemoteRepositoryFilter.Result result = remoteRepositoryFilter.acceptMetadata(
+ remoteRepository, metadataDownload.getMetadata() );
+ if ( result.isAccepted() )
+ {
+ filteredMetadataDownloads.add( metadataDownload );
+ }
+ else
+ {
+ String explain = result.reasoning();
+ LOGGER.debug( "Filtered out metadata {} from {}, reason: {}",
+ metadataDownload.getMetadata(), remoteRepository, explain );
+ metadataDownload.setException( new MetadataNotFoundException( metadataDownload.getMetadata(),
+ remoteRepository, explain ) );
+ }
+ }
+ }
+ repositoryConnector.get( filteredArtifactDownloads, filteredMetadataDownloads );
+ }
+
+ @Override
+ public void put( Collection<? extends ArtifactUpload> artifactUploads,
+ Collection<? extends MetadataUpload> metadataUploads )
+ {
+ repositoryConnector.put( artifactUploads, metadataUploads );
+ }
+
+ @Override
+ public String toString()
+ {
+ return "filtered(" + repositoryConnector.toString() + ")";
+ }
+}
diff --git a/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/filter/StaticRemoteRepositoryFilterSource.java b/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/filter/StaticRemoteRepositoryFilterSource.java
new file mode 100644
index 00000000..9cf67aa9
--- /dev/null
+++ b/maven-resolver-impl/src/main/java/org/eclipse/aether/internal/impl/filter/StaticRemoteRepositoryFilterSource.java
@@ -0,0 +1,144 @@
+package org.eclipse.aether.internal.impl.filter;
+
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+import javax.inject.Inject;
+import javax.inject.Named;
+import javax.inject.Singleton;
+
+import org.eclipse.aether.RepositorySystemSession;
+import org.eclipse.aether.artifact.Artifact;
+import org.eclipse.aether.metadata.Metadata;
+import org.eclipse.aether.repository.RemoteRepository;
+import org.eclipse.aether.spi.connector.filter.RemoteRepositoryFilter;
+import org.eclipse.aether.spi.connector.filter.RemoteRepositoryFilterSource;
+import org.eclipse.aether.util.ConfigUtils;
+
+import static java.util.Objects.requireNonNull;
+
+/**
+ * Static remote repository filter source, usable for testing and toying.
+ *
+ * @since TBD
+ */
+@Singleton
+@Named( StaticRemoteRepositoryFilterSource.NAME )
+public final class StaticRemoteRepositoryFilterSource
+ implements RemoteRepositoryFilterSource
+{
+ public static final String NAME = "static";
+
+ private static final String CONFIG_PROP_VALUE = "aether.remoteRepositoryFilter.static.value";
+
+ private static final RemoteRepositoryFilter.Result ACCEPTED = new RemoteRepositoryFilter.Result()
+ {
+ @Override
+ public boolean isAccepted()
+ {
+ return true;
+ }
+
+ @Override
+ public String reasoning()
+ {
+ return "Always accepted";
+ }
+ };
+
+ private static final RemoteRepositoryFilter.Result NOT_ACCEPTED = new RemoteRepositoryFilter.Result()
+ {
+ @Override
+ public boolean isAccepted()
+ {
+ return false;
+ }
+
+ @Override
+ public String reasoning()
+ {
+ return "Always rejected";
+ }
+ };
+
+ private static final RemoteRepositoryFilter ALWAYS_ACCEPT_ALL = new RemoteRepositoryFilter()
+ {
+ @Override
+ public Result acceptArtifact( RemoteRepository remoteRepository, Artifact artifact )
+ {
+ return ACCEPTED;
+ }
+
+ @Override
+ public Result acceptMetadata( RemoteRepository remoteRepository, Metadata metadata )
+ {
+ return ACCEPTED;
+ }
+ };
+
+ private static final RemoteRepositoryFilter NEVER_ACCEPT_ALL = new RemoteRepositoryFilter()
+ {
+ @Override
+ public Result acceptArtifact( RemoteRepository remoteRepository, Artifact artifact )
+ {
+ return NOT_ACCEPTED;
+ }
+
+ @Override
+ public Result acceptMetadata( RemoteRepository remoteRepository, Metadata metadata )
+ {
+ return NOT_ACCEPTED;
+ }
+ };
+
+ private final String id;
+
+ private final String description;
+
+ @Inject
+ public StaticRemoteRepositoryFilterSource()
+ {
+ this( NAME );
+ }
+
+ public StaticRemoteRepositoryFilterSource( final String id )
+ {
+ this.id = requireNonNull( id );
+ this.description = "static";
+ }
+
+ @Override
+ public String getId()
+ {
+ return id;
+ }
+
+ @Override
+ public String getDescription()
+ {
+ return description;
+ }
+
+ @Override
+ public RemoteRepositoryFilter getRemoteRepositoryFilter( RepositorySystemSession session )
+ {
+ return ConfigUtils.getBoolean( session, true, CONFIG_PROP_VALUE )
+ ? ALWAYS_ACCEPT_ALL : NEVER_ACCEPT_ALL;
+ }
+}
diff --git a/maven-resolver-impl/src/test/java/org/eclipse/aether/internal/impl/DefaultArtifactResolverTest.java b/maven-resolver-impl/src/test/java/org/eclipse/aether/internal/impl/DefaultArtifactResolverTest.java
index 65ad4880..a13bb8ac 100644
--- a/maven-resolver-impl/src/test/java/org/eclipse/aether/internal/impl/DefaultArtifactResolverTest.java
+++ b/maven-resolver-impl/src/test/java/org/eclipse/aether/internal/impl/DefaultArtifactResolverTest.java
@@ -38,6 +38,7 @@ import org.eclipse.aether.artifact.ArtifactProperties;
import org.eclipse.aether.artifact.DefaultArtifact;
import org.eclipse.aether.impl.UpdateCheckManager;
import org.eclipse.aether.impl.VersionResolver;
+import org.eclipse.aether.internal.impl.filter.DefaultRemoteRepositoryFilterManager;
import org.eclipse.aether.internal.test.util.TestFileProcessor;
import org.eclipse.aether.internal.test.util.TestFileUtils;
import org.eclipse.aether.internal.test.util.TestLocalRepositoryManager;
@@ -103,6 +104,7 @@ public class DefaultArtifactResolverTest
resolver.setRemoteRepositoryManager( new StubRemoteRepositoryManager() );
resolver.setSyncContextFactory( new StubSyncContextFactory() );
resolver.setOfflineController( new DefaultOfflineController() );
+ resolver.setRemoteRepositoryFilterManager( new DefaultRemoteRepositoryFilterManager() );
artifact = new DefaultArtifact( "gid", "aid", "", "ext", "ver" );
@@ -742,7 +744,7 @@ public class DefaultArtifactResolverTest
public LocalRepository getRepository()
{
- return null;
+ return new LocalRepository( new File("") );
}
public String getPathForRemoteMetadata( Metadata metadata, RemoteRepository repository, String context )
@@ -825,7 +827,7 @@ public class DefaultArtifactResolverTest
public LocalRepository getRepository()
{
- return null;
+ return new LocalRepository( new File( "" ) );
}
public String getPathForRemoteMetadata( Metadata metadata, RemoteRepository repository, String context )
diff --git a/maven-resolver-impl/src/test/java/org/eclipse/aether/internal/impl/DefaultMetadataResolverTest.java b/maven-resolver-impl/src/test/java/org/eclipse/aether/internal/impl/DefaultMetadataResolverTest.java
index 27fec64c..c8378b2e 100644
--- a/maven-resolver-impl/src/test/java/org/eclipse/aether/internal/impl/DefaultMetadataResolverTest.java
+++ b/maven-resolver-impl/src/test/java/org/eclipse/aether/internal/impl/DefaultMetadataResolverTest.java
@@ -30,7 +30,7 @@ import java.util.List;
import java.util.Set;
import org.eclipse.aether.DefaultRepositorySystemSession;
-import org.eclipse.aether.internal.impl.DefaultMetadataResolver;
+import org.eclipse.aether.internal.impl.filter.DefaultRemoteRepositoryFilterManager;
import org.eclipse.aether.internal.test.util.TestFileUtils;
import org.eclipse.aether.internal.test.util.TestLocalRepositoryManager;
import org.eclipse.aether.internal.test.util.TestUtils;
@@ -80,6 +80,7 @@ public class DefaultMetadataResolverTest
resolver.setRemoteRepositoryManager( new StubRemoteRepositoryManager() );
resolver.setSyncContextFactory( new StubSyncContextFactory() );
resolver.setOfflineController( new DefaultOfflineController() );
+ resolver.setRemoteRepositoryFilterManager( new DefaultRemoteRepositoryFilterManager() );
repository =
new RemoteRepository.Builder( "test-DMRT", "default",
TestFileUtils.createTempDir().toURI().toURL().toString() ).build();
diff --git a/maven-resolver-spi/src/main/java/org/eclipse/aether/spi/connector/filter/RemoteRepositoryFilter.java b/maven-resolver-spi/src/main/java/org/eclipse/aether/spi/connector/filter/RemoteRepositoryFilter.java
new file mode 100644
index 00000000..1c60e960
--- /dev/null
+++ b/maven-resolver-spi/src/main/java/org/eclipse/aether/spi/connector/filter/RemoteRepositoryFilter.java
@@ -0,0 +1,67 @@
+package org.eclipse.aether.spi.connector.filter;
+
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+import org.eclipse.aether.artifact.Artifact;
+import org.eclipse.aether.metadata.Metadata;
+import org.eclipse.aether.repository.RemoteRepository;
+
+/**
+ * Remote repository filter that decides should the given artifact or metadata be accepted (for further processing)
+ * from remote repository or not.
+ *
+ * @since TBD
+ */
+public interface RemoteRepositoryFilter
+{
+ /**
+ * The check result, is immutable.
+ */
+ interface Result
+ {
+ /**
+ * Returns {@code true} if accepted.
+ */
+ boolean isAccepted();
+
+ /**
+ * Returns string "reasoning" for {@link #isAccepted()} result, meant for human consumption, never {@code null}.
+ */
+ String reasoning();
+ }
+
+ /**
+ * Decides should artifact be accepted from given remote repository.
+ *
+ * @param remoteRepository The remote repository, not {@code null}.
+ * @param artifact The artifact, not {@code null}.
+ * @return the result, never {@code null}.
+ */
+ Result acceptArtifact( RemoteRepository remoteRepository, Artifact artifact );
+
+ /**
+ * Decides should metadata be accepted from given remote repository.
+ *
+ * @param remoteRepository The remote repository, not {@code null}.
+ * @param metadata The artifact, not {@code null}.
+ * @return the result, never {@code null}.
+ */
+ Result acceptMetadata( RemoteRepository remoteRepository, Metadata metadata );
+}
diff --git a/maven-resolver-spi/src/main/java/org/eclipse/aether/spi/connector/filter/RemoteRepositoryFilterSource.java b/maven-resolver-spi/src/main/java/org/eclipse/aether/spi/connector/filter/RemoteRepositoryFilterSource.java
new file mode 100644
index 00000000..163a9674
--- /dev/null
+++ b/maven-resolver-spi/src/main/java/org/eclipse/aether/spi/connector/filter/RemoteRepositoryFilterSource.java
@@ -0,0 +1,45 @@
+package org.eclipse.aether.spi.connector.filter;
+
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements. See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership. The ASF licenses this file
+ * to you under the Apache License, Version 2.0 (the
+ * "License"); you may not use this file except in compliance
+ * with the License. You may obtain a copy of the License at
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied. See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+import org.eclipse.aether.RepositorySystemSession;
+
+/**
+ * Remote repository filter source component.
+ *
+ * @since TBD
+ */
+public interface RemoteRepositoryFilterSource
+{
+ /**
+ * The filter configured id, never {@code null}.
+ */
+ String getId();
+
+ /**
+ * The filter description for human consumption, never {@code null}.
+ */
+ String getDescription();
+
+ /**
+ * Provides the filter instance, never {@code null}.
+ */
+ RemoteRepositoryFilter getRemoteRepositoryFilter( RepositorySystemSession session );
+}