-
Notifications
You must be signed in to change notification settings - Fork 4.6k
/
ArtifactView.java
100 lines (90 loc) · 3.83 KB
/
ArtifactView.java
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
/*
* Copyright 2017 the original author or authors.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.gradle.api.artifacts;
import org.gradle.api.Incubating;
import org.gradle.api.artifacts.component.ComponentIdentifier;
import org.gradle.api.attributes.HasAttributes;
import org.gradle.api.attributes.HasConfigurableAttributes;
import org.gradle.api.file.FileCollection;
import org.gradle.api.specs.Spec;
/**
* A view over the artifacts resolved for this set of dependencies.
*
* By default, the view returns all files and artifacts, but this can be restricted by component identifier or by attributes.
*
* @since 3.4
*/
public interface ArtifactView extends HasAttributes {
/**
* Returns the collection of artifacts matching the requested attributes that are sourced from Components matching the specified filter.
*/
ArtifactCollection getArtifacts();
/**
* Returns the collection of artifact files matching the requested attributes that are sourced from Components matching the specified filter.
*/
FileCollection getFiles();
/**
* Configuration for a defined artifact view.
*
* @since 4.0
*/
interface ViewConfiguration extends HasConfigurableAttributes<ViewConfiguration> {
/**
* Specify a filter for the components that should be included in this view.
* Only artifacts from components matching the supplied filter will be returned by {@link #getFiles()} or {@link #getArtifacts()}.
*
* This method cannot be called a multiple times for a view.
*/
ViewConfiguration componentFilter(Spec<? super ComponentIdentifier> componentFilter);
/**
* Determines whether the view should be resolved in a 'lenient' fashion.
*
* When set to <code>true</code>, this view will resolve as many artifacts and/or files as possible
* collecting any failures.
*
* When set to <code>false</code>, any failures will be propagated as exceptions when the view is resolved.
*/
boolean isLenient();
/**
* Specify if the view should be resolved in a 'lenient' fashion.
*
* When set to <code>true</code>, this view will resolve as many artifacts and/or files as possible
* collecting any failures.
*
* When set to <code>false</code>, any failures will be propagated as exceptions when the view is resolved.
*/
void setLenient(boolean lenient);
/**
* Specify if the view should be resolved in a 'lenient' fashion.
*
* When set to <code>true</code>, this view will resolve as many artifacts and/or files as possible
* collecting any failures.
*
* When set to <code>false</code>, any failures will be propagated as exceptions when the view is resolved.
*/
ViewConfiguration lenient(boolean lenient);
/**
* When invoked, this view will disregard existing attributes of its parent configuration and re-resolve the artifacts
* using only the attributes in the view's attribute container.
*
* <p>This behavior cannot be unset on a particular view once this method is invoked.
*
* @since 7.5
*/
@Incubating
ViewConfiguration withVariantReselection();
}
}