ArtifactRepositoryContainer (Gradle API 2.9)
Date: 2015-11-17

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>
  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
    Modifier and Type | Field and Description
    --- | ---
    `static String` | `DEFAULT_MAVEN_CENTRAL_REPO_NAME`
    `static String` | `DEFAULT_MAVEN_LOCAL_REPO_NAME`
    `static String` | `MAVEN_CENTRAL_URL`

  - ### Method Summary

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `boolean` | `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.
    `ArtifactRepository` | `getAt(String name)` Locates an object by name, failing if there is no such task.
    `ArtifactRepository` | `getByName(String name)` Locates an object by name, failing if there is no such object.
    `ArtifactRepository` | `getByName(String name, Closure configureClosure)` Locates an object by name, failing if there is no such object.

    - ### Methods inherited from interface org.gradle.api.NamedDomainObjectList

      `findAll, matching, matching, withType`

    - ### Methods inherited from interface org.gradle.api.NamedDomainObjectCollection

      `addAll, addRule, addRule, findByName, getAsMap, getNamer, getNames, getRules`

    - ### Methods inherited from interface org.gradle.api.DomainObjectCollection

      `all, all, whenObjectAdded, whenObjectAdded, whenObjectRemoved, whenObjectRemoved, withType, withType`

    - ### Methods inherited from interface java.util.Collection

      `clear, contains, containsAll, equals, hashCode, isEmpty, iterator, remove, removeAll, retainAll, size, toArray, toArray`

    - ### Methods inherited from interface java.util.List

      `add, addAll, addAll, clear, contains, containsAll, equals, get, hashCode, indexOf, isEmpty, iterator, lastIndexOf, listIterator, listIterator, remove, remove, removeAll, retainAll, set, size, subList, toArray, toArray`

    - ### Methods inherited from interface org.gradle.util.Configurable

      `configure`

- - ### Field Detail

    - #### DEFAULT_MAVEN_CENTRAL_REPO_NAME

          static final String DEFAULT_MAVEN_CENTRAL_REPO_NAME

      See Also:
        Constant Field Values

    - #### DEFAULT_MAVEN_LOCAL_REPO_NAME

          static final String DEFAULT_MAVEN_LOCAL_REPO_NAME

      See Also:
        Constant Field Values

    - #### MAVEN_CENTRAL_URL

          static final String MAVEN_CENTRAL_URL

      See Also:
        Constant Field Values

  - ### Method Detail

    - #### add

          boolean add(ArtifactRepository repository)

      Adds a repository to this container, at the end of the repository sequence.
      Specified by:
        `add` in interface `Collection<ArtifactRepository>`
      Specified by:
        `add` in interface `List<ArtifactRepository>`
      Specified by:
        `add` in interface `NamedDomainObjectCollection<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

          void addFirst(ArtifactRepository repository)

      Adds a repository to this container, at the start of the repository sequence.
      Parameters:
        `repository` - The repository to add.

    - #### addLast

          void addLast(ArtifactRepository repository)

      Adds a repository to this container, at the end of the repository sequence.
      Parameters:
        `repository` - The repository to add.

    - #### getByName

          ArtifactRepository getByName(String name)
                                       throws UnknownRepositoryException

      Locates an object by name, failing if there is no such object.
      Specified by:
        `getByName` in interface `NamedDomainObjectCollection<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 interface `NamedDomainObjectCollection<ArtifactRepository>`
      Parameters:
        `name` - The object name
        `configureClosure` - 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`

    - #### getAt

          ArtifactRepository getAt(String name)
                                   throws UnknownRepositoryException

      Locates an object by name, failing if there is no such task. This method is identical to `NamedDomainObjectCollection.getByName(String)`. You can call this method in your build script by using the groovy `[]` operator.
      Specified by:
        `getAt` in interface `NamedDomainObjectCollection<ArtifactRepository>`
      Parameters:
        `name` - The object name
      Returns:
        The object with the given name. Never returns null.
      Throws:
        `UnknownRepositoryException`