org.gradle.api.artifacts
Interface ConfigurationContainer

All Superinterfaces:

DomainObjectCollection<Configuration>, Iterable<Configuration>, NamedDomainObjectCollection<Configuration>, NamedDomainObjectContainer<Configuration>

public interface ConfigurationContainer
extends NamedDomainObjectContainer<Configuration>, NamedDomainObjectCollection<Configuration>

A ConfigurationContainer is responsible for managing a set of Configuration instances.

You can obtain a ConfigurationContainer instance by calling Project.getConfigurations(), or using the configurations property in your build script.

The configurations in a container are accessable as read-only properties of the container, using the name of the configuration as the property name. For example:

 configurations.add('myConfiguration')
 configurations.myConfiguration.transitive = false
 

A dynamic method is added for each configuration which takes a configuration closure. This is equivalent to calling getByName(String, groovy.lang.Closure). For example:

 configurations.add('myConfiguration')
 configurations.myConfiguration {
     transitive = false
 }
 

Method Summary

Configuration	add(String name) Adds a configuration with the given name.
Configuration	add(String name, Closure configureClosure) Adds a configuration with the given name.
Configuration	detachedConfiguration(Dependency... dependencies) Creates a configuration, but does not add it to this container.
Configuration	getAt(String name) Locates an object by name, failing if there is no such task.
Configuration	getByName(String name) Locates an object by name, failing if there is no such object.
Configuration	getByName(String name, Closure configureClosure) Locates an object by name, failing if there is no such object.

Methods inherited from interface org.gradle.api.NamedDomainObjectContainer

addRule, addRule, getRules

Methods inherited from interface org.gradle.api.NamedDomainObjectCollection

findByName, getAsMap, matching, matching, withType

Methods inherited from interface org.gradle.api.DomainObjectCollection

all, all, allObjects, allObjects, findAll, getAll, whenObjectAdded, whenObjectAdded, whenObjectRemoved, withType, withType

Methods inherited from interface java.lang.Iterable

iterator

Method Detail

getByName

Configuration getByName(String name)
                        throws UnknownConfigurationException

Locates an object by name, failing if there is no such object.

Specified by:

getByName in interface NamedDomainObjectCollection<Configuration>

Parameters:

name - The object name

Returns:

The object with the given name. Never returns null.

Throws:

UnknownConfigurationException

getAt

Configuration getAt(String name)
                    throws UnknownConfigurationException

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<Configuration>

Parameters:

name - The object name

Returns:

The object with the given name. Never returns null.

Throws:

UnknownConfigurationException

getByName

Configuration getByName(String name,
                        Closure configureClosure)
                        throws UnknownConfigurationException

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 it's delegate.

Specified by:

getByName in interface NamedDomainObjectCollection<Configuration>

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:

UnknownConfigurationException

add

Configuration add(String name)
                  throws InvalidUserDataException

Adds a configuration with the given name.

Parameters:

name - The name of the new configuration.

Returns:

The newly added configuration.

Throws:

InvalidUserDataException - when a configuration with the given name already exists in this container.

add

Configuration add(String name,
                  Closure configureClosure)
                  throws InvalidUserDataException

Adds a configuration with the given name. The given configuration closure is executed against the configuration before it is returned from this method.

Parameters:

name - The name of the new configuration.

configureClosure - The closure to use to configure the configuration.

Returns:

The newly added configuration.

Throws:

InvalidUserDataException - when a configuration with the given name already exists in this container.

detachedConfiguration

Configuration detachedConfiguration(Dependency... dependencies)

Creates a configuration, but does not add it to this container.

Parameters:

dependencies - The dependencies of the configuration.

Returns:

The configuration.