Package org.gradle.api.artifacts
Interface ArtifactRepositoryContainer
- All Superinterfaces:
Collection<ArtifactRepository>
,org.gradle.util.Configurable<ArtifactRepositoryContainer>
,DomainObjectCollection<ArtifactRepository>
,Iterable<ArtifactRepository>
,List<ArtifactRepository>
,NamedDomainObjectCollection<ArtifactRepository>
,NamedDomainObjectList<ArtifactRepository>
,SequencedCollection<ArtifactRepository>
- All Known Subinterfaces:
RepositoryHandler
public interface ArtifactRepositoryContainer
extends NamedDomainObjectList<ArtifactRepository>, org.gradle.util.Configurable<ArtifactRepositoryContainer>
A ResolverContainer
is responsible for managing a set of ArtifactRepository
instances. Repositories are arranged in a sequence.
You can obtain a ResolverContainer
instance by calling Project.getRepositories()
or
using the repositories
property in your build script.
The resolvers in a container are accessible as read-only properties of the container, using the name of the resolver as the property name. For example:
repositories.maven { name 'myResolver' } repositories.myResolver.url = 'some-url'
A dynamic method is added for each resolver which takes a configuration closure. This is equivalent to calling
getByName(String, groovy.lang.Closure)
. For example:
repositories.maven { name 'myResolver' } repositories.myResolver { url 'some-url' }
-
Field Summary
Fields -
Method Summary
Modifier and TypeMethodDescriptionboolean
add
(ArtifactRepository repository) Adds a repository to this container, at the end of the repository sequence.void
addFirst
(ArtifactRepository repository) Adds a repository to this container, at the start of the repository sequence.void
addLast
(ArtifactRepository repository) Adds a repository to this container, at the end of the repository sequence.Locates an object by name, failing if there is no such task.Locates an object by name, failing if there is no such object.Locates an object by name, failing if there is no such object.getByName
(String name, Action<? super ArtifactRepository> configureAction) Locates an object by name, failing if there is no such object.Methods inherited from interface java.util.Collection
parallelStream, removeIf, stream, toArray
Methods inherited from interface org.gradle.util.Configurable
configure
Methods inherited from interface org.gradle.api.DomainObjectCollection
all, all, whenObjectAdded, whenObjectAdded, whenObjectRemoved, whenObjectRemoved, withType, withType
Methods inherited from interface java.util.List
add, addAll, addAll, clear, contains, containsAll, equals, get, getFirst, getLast, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, removeFirst, removeLast, replaceAll, retainAll, reversed, set, size, sort, spliterator, subList, toArray, toArray
Methods inherited from interface org.gradle.api.NamedDomainObjectCollection
addAll, addRule, addRule, addRule, findByName, getAsMap, getNamer, getNames, getRules
Methods inherited from interface org.gradle.api.NamedDomainObjectList
findAll, matching, matching, withType
-
Field Details
-
DEFAULT_MAVEN_CENTRAL_REPO_NAME
- See Also:
-
DEFAULT_MAVEN_LOCAL_REPO_NAME
- See Also:
-
MAVEN_CENTRAL_URL
- See Also:
-
GOOGLE_URL
- See Also:
-
-
Method Details
-
add
Adds a repository to this container, at the end of the repository sequence.- Specified by:
add
in interfaceCollection<ArtifactRepository>
- Specified by:
add
in interfaceList<ArtifactRepository>
- Specified by:
add
in interfaceNamedDomainObjectCollection<ArtifactRepository>
- Parameters:
repository
- The repository to add.- Returns:
true
if the item was added, or false if an item with the same name already exists.
-
addFirst
Adds a repository to this container, at the start of the repository sequence.- Specified by:
addFirst
in interfaceList<ArtifactRepository>
- Specified by:
addFirst
in interfaceSequencedCollection<ArtifactRepository>
- Parameters:
repository
- The repository to add.
-
addLast
Adds a repository to this container, at the end of the repository sequence.- Specified by:
addLast
in interfaceList<ArtifactRepository>
- Specified by:
addLast
in interfaceSequencedCollection<ArtifactRepository>
- Parameters:
repository
- The repository to add.
-
getByName
Locates an object by name, failing if there is no such object.- Specified by:
getByName
in interfaceNamedDomainObjectCollection<ArtifactRepository>
- Parameters:
name
- The object name- Returns:
- The object with the given name. Never returns null.
- Throws:
UnknownRepositoryException
-
getByName
ArtifactRepository getByName(String name, Closure configureClosure) throws UnknownRepositoryException Locates an object by name, failing if there is no such object. The given configure closure is executed against the object before it is returned from this method. The object is passed to the closure as its delegate.- Specified by:
getByName
in interfaceNamedDomainObjectCollection<ArtifactRepository>
- Parameters:
name
- The object nameconfigureClosure
- The closure to use to configure the object.- Returns:
- The object with the given name, after the configure closure has been applied to it. Never returns null.
- Throws:
UnknownRepositoryException
-
getByName
ArtifactRepository getByName(String name, Action<? super ArtifactRepository> configureAction) throws UnknownRepositoryException Locates an object by name, failing if there is no such object. The given configure action is executed against the object before it is returned from this method.- Specified by:
getByName
in interfaceNamedDomainObjectCollection<ArtifactRepository>
- Parameters:
name
- The object nameconfigureAction
- The action to use to configure the object.- Returns:
- The object with the given name, after the configure action has been applied to it. Never returns null.
- Throws:
UnknownRepositoryException
-
getAt
Locates an object by name, failing if there is no such task. This method is identical toNamedDomainObjectCollection.getByName(String)
. You can call this method in your build script by using the groovy[]
operator.- Specified by:
getAt
in interfaceNamedDomainObjectCollection<ArtifactRepository>
- Parameters:
name
- The object name- Returns:
- The object with the given name. Never returns null.
- Throws:
UnknownRepositoryException
-