blob: 1694ac9660e2aec55c4357597e5854f964c11a08 (
plain)
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
|
// Copyright 2015 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.concurrent;
import com.google.common.base.Preconditions;
/** A classifier for {@link Error}s and {@link Exception}s. Used by {@link AbstractQueueVisitor}. */
public abstract class ErrorClassifier {
/**
* Classification of an error thrown by an action.
*
* <p>N.B. - These enum values are ordered from least severe to most severe.
*/
public enum ErrorClassification {
/** Other running actions should be left alone.*/
NOT_CRITICAL,
/** All running actions should be stopped.*/
CRITICAL,
/** Same as {@link #CRITICAL}, but also log the error.*/
CRITICAL_AND_LOG,
/** Same as {@link #CRITICAL_AND_LOG}, but is even worse. */
AS_CRITICAL_AS_POSSIBLE
}
/** Always treat exceptions as {@code NOT_CRITICAL}. */
public static final ErrorClassifier DEFAULT =
new ErrorClassifier() {
@Override
protected ErrorClassification classifyException(Exception e) {
return ErrorClassification.NOT_CRITICAL;
}
};
/**
* Used by {@link #classify} to classify {@link Exception}s. (Note that {@link Error}s
* are always classified as {@code AS_CRITICAL_AS_POSSIBLE}.)
*
* @param e the exception object to check
*/
protected abstract ErrorClassification classifyException(Exception e);
/**
* Classify {@code e}. If {@code e} is an {@link Error}, it will be classified as
* {@code AS_CRITICAL_AS_POSSIBLE}. Otherwise, calls {@link #classifyException}.
*/
public final ErrorClassification classify(Throwable e) {
if (e instanceof Error) {
return ErrorClassification.AS_CRITICAL_AS_POSSIBLE;
}
Preconditions.checkArgument(e instanceof Exception, e);
return classifyException((Exception) e);
}
}
|
