T
- The base report type for reports of this container.public interface ReportContainer<T extends Report> extends NamedDomainObjectSet<T>, org.gradle.util.Configurable<ReportContainer<T>>
Report
objects, that represent potential reports.
Things that produce reports (typically tasks) expose a report container that contains Report
objects for each
possible report that they can produce. Each report object can be configured individually, including whether or not it should
be produced by way of its enabled
property.
ReportContainer
implementations are immutable in that standard collection methods such as add()
, remove()
and clear()
will throw an ReportContainer.ImmutableViolationException
. However, implementations may provide new methods that allow
the addition of new report object and/or the removal of existing report objects.
Modifier and Type | Interface and Description |
---|---|
static class |
ReportContainer.ImmutableViolationException
The exception thrown when any of this container's mutation methods are called.
|
Modifier and Type | Method and Description |
---|---|
SortedMap<String,T> |
getAsMap()
Returns the objects in this collection, as a map from object name to object instance.
|
NamedDomainObjectSet<T> |
getEnabled()
Returns an immutable collection of all the enabled
Report objects in this container. |
Map<String,T> |
getEnabledReports()
Returns the enabled reports, keyed by report name.
|
Namer<T> |
getNamer()
An object that represents the naming strategy used to name objects of this collection.
|
SortedSet<String> |
getNames()
Returns the names of the objects in this collection as a Set of Strings.
|
List<Rule> |
getRules()
Returns the rules used by this collection.
|
boolean |
isEmpty() |
findAll, matching, matching, withType
add, addAll, addRule, addRule, addRule, findByName, getAt, getByName, getByName, getByName, getCollectionSchema, named
addLater, all, all, configureEach, whenObjectAdded, whenObjectAdded, whenObjectRemoved, whenObjectRemoved, withType, withType
clear, contains, containsAll, equals, hashCode, iterator, parallelStream, remove, removeAll, removeIf, retainAll, size, spliterator, stream, toArray, toArray
@Internal NamedDomainObjectSet<T> getEnabled()
Report
objects in this container.
The returned collection is live. That is, as reports are enabled/disabled the returned collection always reflects the current set of enabled reports.
@Internal Namer<T> getNamer()
NamedDomainObjectCollection
getNamer
in interface NamedDomainObjectCollection<T extends Report>
@Internal SortedMap<String,T> getAsMap()
NamedDomainObjectCollection
Returns the objects in this collection, as a map from object name to object instance.
The map is ordered by the natural ordering of the object names (i.e. keys).
getAsMap
in interface NamedDomainObjectCollection<T extends Report>
@Internal SortedSet<String> getNames()
NamedDomainObjectCollection
Returns the names of the objects in this collection as a Set of Strings.
The set of names is in natural ordering.
getNames
in interface NamedDomainObjectCollection<T extends Report>
@Internal List<Rule> getRules()
NamedDomainObjectCollection
getRules
in interface NamedDomainObjectCollection<T extends Report>
@Internal boolean isEmpty()
@Incubating Map<String,T> getEnabledReports()