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
101
102
103
104
105
106
107
108
109
|
// Copyright 2014 Google Inc. All rights reserved.
//
// 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 com.google.devtools.build.lib.actions;
import com.google.common.base.Preconditions;
import com.google.devtools.build.lib.actions.Artifact.MiddlemanExpander;
import com.google.devtools.build.lib.actions.cache.MetadataHandler;
import com.google.devtools.build.lib.util.io.FileOutErr;
import com.google.devtools.build.skyframe.SkyFunction;
import com.google.devtools.build.skyframe.SkyFunction.Environment;
import javax.annotation.Nullable;
/**
* A class that groups services in the scope of the action. Like the FileOutErr object.
*/
public class ActionExecutionContext {
private final Executor executor;
private final ActionInputFileCache actionInputFileCache;
private final MetadataHandler metadataHandler;
private final FileOutErr fileOutErr;
private final MiddlemanExpander middlemanExpander;
@Nullable
private final Environment env;
private ActionExecutionContext(Executor executor, ActionInputFileCache actionInputFileCache,
MetadataHandler metadataHandler, FileOutErr fileOutErr,
@Nullable MiddlemanExpander middlemanExpander,
@Nullable SkyFunction.Environment env) {
this.actionInputFileCache = actionInputFileCache;
this.metadataHandler = metadataHandler;
this.fileOutErr = fileOutErr;
this.executor = executor;
this.middlemanExpander = middlemanExpander;
this.env = env;
}
public ActionExecutionContext(Executor executor, ActionInputFileCache actionInputFileCache,
MetadataHandler metadataHandler, FileOutErr fileOutErr, MiddlemanExpander middlemanExpander) {
this(executor, actionInputFileCache, metadataHandler, fileOutErr, middlemanExpander, null);
}
public static ActionExecutionContext normal(Executor executor,
ActionInputFileCache actionInputFileCache, MetadataHandler metadataHandler,
FileOutErr fileOutErr, MiddlemanExpander middlemanExpander) {
return new ActionExecutionContext(executor, actionInputFileCache, metadataHandler, fileOutErr,
middlemanExpander, null);
}
public static ActionExecutionContext forInputDiscovery(Executor executor,
ActionInputFileCache actionInputFileCache, MetadataHandler metadataHandler,
FileOutErr fileOutErr, Environment env) {
return new ActionExecutionContext(executor, actionInputFileCache, metadataHandler, fileOutErr,
null, env);
}
public ActionInputFileCache getActionInputFileCache() {
return actionInputFileCache;
}
public MetadataHandler getMetadataHandler() {
return metadataHandler;
}
public Executor getExecutor() {
return executor;
}
public MiddlemanExpander getMiddlemanExpander() {
return middlemanExpander;
}
/**
* Provide that {@code FileOutErr} that the action should use for redirecting the output and error
* stream.
*/
public FileOutErr getFileOutErr() {
return fileOutErr;
}
/**
* Provides a mechanism for the action to request values from Skyframe while it discovers inputs.
*/
public Environment getEnvironmentForDiscoveringInputs() {
return Preconditions.checkNotNull(env);
}
/**
* Allows us to create a new context that overrides the FileOutErr with another one. This is
* useful for muting the output for example.
*/
public ActionExecutionContext withFileOutErr(FileOutErr fileOutErr) {
return new ActionExecutionContext(executor, actionInputFileCache, metadataHandler, fileOutErr,
middlemanExpander, env);
}
}
|
