Interface TaskContainer
-
- All Superinterfaces:
java.util.Collection<Task>,Configurable<NamedDomainObjectContainer<Task>>,DomainObjectCollection<Task>,DomainObjectSet<Task>,java.lang.Iterable<Task>,NamedDomainObjectCollection<Task>,NamedDomainObjectContainer<Task>,NamedDomainObjectSet<Task>,PolymorphicDomainObjectContainer<Task>,java.util.Set<Task>,TaskCollection<Task>
public interface TaskContainer extends TaskCollection<Task>, PolymorphicDomainObjectContainer<Task>
A
TaskContaineris responsible for managing a set ofTaskinstances.You can obtain a
TaskContainerinstance by callingProject.getTasks(), or using thetasksproperty in your build script.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description Taskcreate(java.lang.String name)Creates aTaskwith the given name and adds it to this container.Taskcreate(java.lang.String name, Closure configureClosure)Creates aTaskwith the given name adds it to this container.<T extends Task>
Tcreate(java.lang.String name, java.lang.Class<T> type)Creates aTaskwith the given name and type, and adds it to this container.<T extends Task>
Tcreate(java.lang.String name, java.lang.Class<T> type, java.lang.Object... constructorArgs)Creates aTaskwith the given name and type, passing the given arguments to the@Inject-annotated constructor, and adds it to this container.<T extends Task>
Tcreate(java.lang.String name, java.lang.Class<T> type, Action<? super T> configuration)Creates aTaskwith the given name and type, configures it with the given action, and adds it to this container.Taskcreate(java.util.Map<java.lang.String,?> options)Creates aTaskand adds it to this container.Taskcreate(java.util.Map<java.lang.String,?> options, Closure configureClosure)Creates aTaskadds it to this container.TaskfindByPath(java.lang.String path)Locates a task by path.TaskgetByPath(java.lang.String path)Locates a task by path.TaskProvider<Task>register(java.lang.String name)Defines a new task, which will be created when it is required.<T extends Task>
TaskProvider<T>register(java.lang.String name, java.lang.Class<T> type)Defines a new task, which will be created when it is required.<T extends Task>
TaskProvider<T>register(java.lang.String name, java.lang.Class<T> type, java.lang.Object... constructorArgs)Defines a new task, which will be created when it is required passing the given arguments to the@Inject-annotated constructor.<T extends Task>
TaskProvider<T>register(java.lang.String name, java.lang.Class<T> type, Action<? super T> configurationAction)Defines a new task, which will be created and configured when it is required.TaskProvider<Task>register(java.lang.String name, Action<? super Task> configurationAction)Defines a new task, which will be created and configured when it is required.Taskreplace(java.lang.String name)Creates aTaskwith the given name and adds it to this container, replacing any existing task with the same name.<T extends Task>
Treplace(java.lang.String name, java.lang.Class<T> type)Creates aTaskwith the given name and type, and adds it to this container, replacing any existing task of the same name.-
Methods inherited from interface org.gradle.api.DomainObjectCollection
addAllLater, addLater, all, all, configureEach, whenObjectAdded, whenObjectAdded, whenObjectRemoved, whenObjectRemoved, withType, withType
-
Methods inherited from interface org.gradle.api.NamedDomainObjectCollection
add, addAll, addRule, addRule, addRule, findByName, getAsMap, getByName, getCollectionSchema, getNamer, getNames, getRules
-
Methods inherited from interface org.gradle.api.NamedDomainObjectContainer
configure, create, maybeCreate
-
Methods inherited from interface org.gradle.api.NamedDomainObjectSet
findAll
-
Methods inherited from interface org.gradle.api.PolymorphicDomainObjectContainer
containerWithType, maybeCreate
-
Methods inherited from interface java.util.Set
add, addAll, clear, contains, containsAll, equals, hashCode, isEmpty, iterator, remove, removeAll, retainAll, size, spliterator, toArray, toArray
-
Methods inherited from interface org.gradle.api.tasks.TaskCollection
getAt, getByName, getByName, matching, matching, named, named, named, named, named, whenTaskAdded, whenTaskAdded, withType
-
-
-
-
Method Detail
-
findByPath
@Nullable Task findByPath(java.lang.String path)
Locates a task by path. You can supply a task name, a relative path, or an absolute path. Relative paths are interpreted relative to the project for this container. This method returns null if no task with the given path exists.
- Parameters:
path- the path of the task to be returned- Returns:
- The task. Returns null if so such task exists.
-
getByPath
Task getByPath(java.lang.String path) throws UnknownTaskException
Locates a task by path. You can supply a task name, a relative path, or an absolute path. Relative paths are interpreted relative to the project for this container. This method throws an exception if no task with the given path exists.
- Parameters:
path- the path of the task to be returned- Returns:
- The task. Never returns null
- Throws:
UnknownTaskException- If no task with the given path exists.
-
create
Task create(java.util.Map<java.lang.String,?> options) throws InvalidUserDataException
Creates a
Taskand adds it to this container. A map of creation options can be passed to this method to control how the task is created. The following options are available:Option Description Default Value "name"The name of the task to create. None. Must be specified. "type"The class of the task to create. DefaultTask"action"The closure or Actionto execute when the task executes. SeeTask.doFirst(Action).null"overwrite"Replace an existing task? false"dependsOn"The dependencies of the task. See here for more details. []"group"The group of the task. null"description"The description of the task. null"constructorArgs"The arguments to pass to the task class constructor. nullAfter the task is added, it is made available as a property of the project, so that you can reference the task by name in your build file.
If a task with the given name already exists in this container and the
"overwrite"option is not set to true, an exception is thrown.- Parameters:
options- The task creation options.- Returns:
- The newly created task object
- Throws:
InvalidUserDataException- If a task with the given name already exists in this project.java.lang.NullPointerException- If any of the values in"constructorArgs"is null.- See Also:
More information about how tasks are exposed by name in build scripts
-
create
Task create(java.util.Map<java.lang.String,?> options, Closure configureClosure) throws InvalidUserDataException
Creates a
Taskadds it to this container. A map of creation options can be passed to this method to control how the task is created. Seecreate(java.util.Map)for the list of options available. The given closure is used to configure the task before it is returned by this method.After the task is added, it is made available as a property of the project, so that you can reference the task by name in your build file.
- Parameters:
options- The task creation options.configureClosure- The closure to use to configure the task.- Returns:
- The newly created task object
- Throws:
InvalidUserDataException- If a task with the given name already exists in this project.- See Also:
More information about how tasks are exposed by name in build scripts
-
create
Task create(java.lang.String name, Closure configureClosure) throws InvalidUserDataException
Creates a
Taskwith the given name adds it to this container. The given closure is used to configure the task before it is returned by this method.After the task is added, it is made available as a property of the project, so that you can reference the task by name in your build file.
- Specified by:
createin interfaceNamedDomainObjectContainer<Task>- Parameters:
name- The name of the task to be createdconfigureClosure- The closure to use to configure the task.- Returns:
- The newly created task object
- Throws:
InvalidUserDataException- If a task with the given name already exists in this project.- See Also:
More information about how tasks are exposed by name in build scripts
-
create
Task create(java.lang.String name) throws InvalidUserDataException
Creates a
Taskwith the given name and adds it to this container.After the task is added, it is made available as a property of the project, so that you can reference the task by name in your build file.
- Specified by:
createin interfaceNamedDomainObjectContainer<Task>- Parameters:
name- The name of the task to be created- Returns:
- The newly created task object
- Throws:
InvalidUserDataException- If a task with the given name already exists in this project.- See Also:
More information about how tasks are exposed by name in build scripts
-
create
<T extends Task> T create(java.lang.String name, java.lang.Class<T> type) throws InvalidUserDataException
Creates a
Taskwith the given name and type, and adds it to this container.After the task is added, it is made available as a property of the project, so that you can reference the task by name in your build file.
- Specified by:
createin interfacePolymorphicDomainObjectContainer<Task>- Type Parameters:
T- the type of the domain object to be created- Parameters:
name- The name of the task to be created.type- The type of task to create.- Returns:
- The newly created task object
- Throws:
InvalidUserDataException- If a task with the given name already exists in this project.- See Also:
More information about how tasks are exposed by name in build scripts
-
create
<T extends Task> T create(java.lang.String name, java.lang.Class<T> type, java.lang.Object... constructorArgs) throws InvalidUserDataException
Creates a
Taskwith the given name and type, passing the given arguments to the@Inject-annotated constructor, and adds it to this container. All values passed to the task constructor must be non-null; otherwise aNullPointerExceptionwill be thrownAfter the task is added, it is made available as a property of the project, so that you can reference the task by name in your build file.
- Parameters:
name- The name of the task to be created.type- The type of task to create.constructorArgs- The arguments to pass to the task constructor- Returns:
- The newly created task object
- Throws:
InvalidUserDataException- If a task with the given name already exists in this project.java.lang.NullPointerException- If any of the values inconstructorArgsis null.- Since:
- 4.7
- See Also:
More information about how tasks are exposed by name in build scripts
-
create
<T extends Task> T create(java.lang.String name, java.lang.Class<T> type, Action<? super T> configuration) throws InvalidUserDataException
Creates a
Taskwith the given name and type, configures it with the given action, and adds it to this container.After the task is added, it is made available as a property of the project, so that you can reference the task by name in your build file.
- Specified by:
createin interfacePolymorphicDomainObjectContainer<Task>- Type Parameters:
T- the type of the domain object to be created- Parameters:
name- The name of the task to be created.type- The type of task to create.configuration- The action to configure the task with.- Returns:
- The newly created task object.
- Throws:
InvalidUserDataException- If a task with the given name already exists in this project.- See Also:
More information about how tasks are exposed by name in build scripts
-
register
TaskProvider<Task> register(java.lang.String name, Action<? super Task> configurationAction) throws InvalidUserDataException
Defines a new task, which will be created and configured when it is required. A task is 'required' when the task is located using query methods such asTaskCollection.getByName(java.lang.String), when the task is added to the task graph for execution or whenProvider.get()is called on the return value of this method.It is generally more efficient to use this method instead of
NamedDomainObjectContainer.create(java.lang.String, org.gradle.api.Action)orcreate(java.lang.String), as those methods will eagerly create and configure the task, regardless of whether that task is required for the current build or not. This method, on the other hand, will defer creation and configuration until required.- Specified by:
registerin interfaceNamedDomainObjectContainer<Task>- Parameters:
name- The name of the task.configurationAction- The action to run to configure the task. This action runs when the task is required.- Returns:
- A
Providerwhose value will be the task, when queried. - Throws:
InvalidUserDataException- If a task with the given name already exists in this project.- Since:
- 4.9
-
register
<T extends Task> TaskProvider<T> register(java.lang.String name, java.lang.Class<T> type, Action<? super T> configurationAction) throws InvalidUserDataException
Defines a new task, which will be created and configured when it is required. A task is 'required' when the task is located using query methods such asTaskCollection.getByName(java.lang.String), when the task is added to the task graph for execution or whenProvider.get()is called on the return value of this method.It is generally more efficient to use this method instead of
create(java.lang.String, java.lang.Class, org.gradle.api.Action)orcreate(java.lang.String, java.lang.Class), as those methods will eagerly create and configure the task, regardless of whether that task is required for the current build or not. This method, on the other hand, will defer creation and configuration until required.- Specified by:
registerin interfacePolymorphicDomainObjectContainer<Task>- Type Parameters:
T- The task type- Parameters:
name- The name of the task.type- The task type.configurationAction- The action to run to configure the task. This action runs when the task is required.- Returns:
- A
Providerwhose value will be the task, when queried. - Throws:
InvalidUserDataException- If a task with the given name already exists in this project.- Since:
- 4.9
-
register
<T extends Task> TaskProvider<T> register(java.lang.String name, java.lang.Class<T> type) throws InvalidUserDataException
Defines a new task, which will be created when it is required. A task is 'required' when the task is located using query methods such asTaskCollection.getByName(java.lang.String), when the task is added to the task graph for execution or whenProvider.get()is called on the return value of this method.It is generally more efficient to use this method instead of
create(java.lang.String, java.lang.Class, org.gradle.api.Action)orcreate(java.lang.String, java.lang.Class), as those methods will eagerly create and configure the task, regardless of whether that task is required for the current build or not. This method, on the other hand, will defer creation until required.- Specified by:
registerin interfacePolymorphicDomainObjectContainer<Task>- Type Parameters:
T- The task type- Parameters:
name- The name of the task.type- The task type.- Returns:
- A
Providerwhose value will be the task, when queried. - Throws:
InvalidUserDataException- If a task with the given name already exists in this project.- Since:
- 4.9
-
register
<T extends Task> TaskProvider<T> register(java.lang.String name, java.lang.Class<T> type, java.lang.Object... constructorArgs) throws InvalidUserDataException
Defines a new task, which will be created when it is required passing the given arguments to the@Inject-annotated constructor. A task is 'required' when the task is located using query methods such asTaskCollection.getByName(java.lang.String), when the task is added to the task graph for execution or whenProvider.get()is called on the return value of this method. All values passed to the task constructor must be non-null; otherwise aNullPointerExceptionwill be thrownIt is generally more efficient to use this method instead of
create(java.lang.String, java.lang.Class, org.gradle.api.Action)orcreate(java.lang.String, java.lang.Class), as those methods will eagerly create and configure the task, regardless of whether that task is required for the current build or not. This method, on the other hand, will defer creation until required.- Type Parameters:
T- The task type- Parameters:
name- The name of the task.type- The task type.constructorArgs- The arguments to pass to the task constructor- Returns:
- A
Providerwhose value will be the task, when queried. - Throws:
java.lang.NullPointerException- If any of the values inconstructorArgsis null.InvalidUserDataException- Since:
- 4.9
-
register
TaskProvider<Task> register(java.lang.String name) throws InvalidUserDataException
Defines a new task, which will be created when it is required. A task is 'required' when the task is located using query methods such asTaskCollection.getByName(java.lang.String), when the task is added to the task graph for execution or whenProvider.get()is called on the return value of this method.It is generally more efficient to use this method instead of
create(java.lang.String), as that method will eagerly create the task, regardless of whether that task is required for the current build or not. This method, on the other hand, will defer creation until required.- Specified by:
registerin interfaceNamedDomainObjectContainer<Task>- Parameters:
name- The name of the task.- Returns:
- A
Providerwhose value will be the task, when queried. - Throws:
InvalidUserDataException- If a task with the given name already exists in this project.- Since:
- 4.9
-
replace
Task replace(java.lang.String name)
Creates a
Taskwith the given name and adds it to this container, replacing any existing task with the same name.After the task is added, it is made available as a property of the project, so that you can reference the task by name in your build file.
- Parameters:
name- The name of the task to be created- Returns:
- The newly created task object
- See Also:
More information about how tasks are exposed by name in build scripts
-
replace
<T extends Task> T replace(java.lang.String name, java.lang.Class<T> type)
Creates a
Taskwith the given name and type, and adds it to this container, replacing any existing task of the same name.After the task is added, it is made available as a property of the project, so that you can reference the task by name in your build file.
- Parameters:
name- The name of the task to be created.type- The type of task to create.- Returns:
- The newly created task object
- See Also:
More information about how tasks are exposed by name in build scripts
-
-