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
110
111
112
|
// Copyright 2014 The Bazel Authors. 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.collect.ImmutableList;
import com.google.devtools.build.lib.causes.Cause;
import com.google.devtools.build.lib.concurrent.ThreadSafety.ThreadSafe;
import com.google.devtools.build.lib.util.ExitCode;
import javax.annotation.Nullable;
/**
* This exception gets thrown if there were errors during the execution phase of
* the build.
*
* <p>The argument to the constructor may be null if the thrower has already
* printed an error message; in this case, no error message should be printed by
* the catcher. (Typically, this happens when the builder is unsuccessful and
* {@code --keep_going} was specified. This error corresponds to one or more
* actions failing, but since those actions' failures will be reported
* separately, the exception carries no message and is just used for control
* flow.)
*
* <p>This exception typically leads to Bazel termination with exit code
* {@link ExitCode#BUILD_FAILURE}. However, if a more specific exit code is
* appropriate, it can be propagated by specifying the exit code to the
* constructor.
*/
@ThreadSafe
public class BuildFailedException extends Exception {
private final boolean catastrophic;
private final Action action;
private final Iterable<Cause> rootCauses;
private final boolean errorAlreadyShown;
@Nullable private final ExitCode exitCode;
public BuildFailedException() {
this(null);
}
public BuildFailedException(String message) {
this(message, false, null, ImmutableList.<Cause>of());
}
public BuildFailedException(String message, ExitCode exitCode) {
this(message, false, null, ImmutableList.<Cause>of(), false, exitCode);
}
public BuildFailedException(String message, boolean catastrophic) {
this(message, catastrophic, null, ImmutableList.<Cause>of());
}
public BuildFailedException(
String message, boolean catastrophic, Action action, Iterable<Cause> rootCauses) {
this(message, catastrophic, action, rootCauses, false);
}
public BuildFailedException(
String message,
boolean catastrophic,
Action action,
Iterable<Cause> rootCauses,
boolean errorAlreadyShown) {
this(message, catastrophic, action, rootCauses, errorAlreadyShown, null);
}
public BuildFailedException(
String message,
boolean catastrophic,
Action action,
Iterable<Cause> rootCauses,
boolean errorAlreadyShown,
ExitCode exitCode) {
super(message);
this.catastrophic = catastrophic;
this.rootCauses = ImmutableList.copyOf(rootCauses);
this.action = action;
this.errorAlreadyShown = errorAlreadyShown;
this.exitCode = exitCode;
}
public boolean isCatastrophic() {
return catastrophic;
}
public Action getAction() {
return action;
}
public Iterable<Cause> getRootCauses() {
return rootCauses;
}
public boolean isErrorAlreadyShown() {
return errorAlreadyShown || getMessage() == null;
}
@Nullable public ExitCode getExitCode() {
return exitCode;
}
}
|
