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
|
/*
* Copyright 2023 Code Intelligence GmbH
*
* 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.code_intelligence.jazzer.mutation.api;
import static com.code_intelligence.jazzer.mutation.support.Preconditions.require;
import static com.code_intelligence.jazzer.mutation.support.TypeSupport.asAnnotatedType;
import static java.lang.String.format;
import com.google.errorprone.annotations.CheckReturnValue;
import java.lang.reflect.AnnotatedType;
import java.util.Optional;
/**
* Instances of this class are not required to be thread safe, but are generally lightweight and can
* thus be created as needed.
*/
public abstract class MutatorFactory {
public final boolean canMutate(AnnotatedType type) {
return tryCreate(type).isPresent();
}
public final <T> SerializingMutator<T> createOrThrow(Class<T> clazz) {
return (SerializingMutator<T>) createOrThrow(asAnnotatedType(clazz));
}
public final SerializingMutator<?> createOrThrow(AnnotatedType type) {
Optional<SerializingMutator<?>> maybeMutator = tryCreate(type);
require(maybeMutator.isPresent(), "Failed to create mutator for " + type);
return maybeMutator.get();
}
public final SerializingInPlaceMutator<?> createInPlaceOrThrow(AnnotatedType type) {
Optional<SerializingInPlaceMutator<?>> maybeMutator = tryCreateInPlace(type);
require(maybeMutator.isPresent(), "Failed to create mutator for " + type);
return maybeMutator.get();
}
/**
* Tries to create a mutator for {@code type} and, if successful, asserts that it is an instance
* of {@link SerializingInPlaceMutator}.
*/
public final Optional<SerializingInPlaceMutator<?>> tryCreateInPlace(AnnotatedType type) {
return tryCreate(type).map(mutator -> {
require(mutator instanceof InPlaceMutator<?>,
format("Mutator for %s is not in-place: %s", type, mutator.getClass()));
return (SerializingInPlaceMutator<?>) mutator;
});
}
@CheckReturnValue
public final Optional<SerializingMutator<?>> tryCreate(AnnotatedType type) {
return tryCreate(type, this);
}
/**
* Attempt to create a {@link SerializingMutator} for the given type.
*
* @param type the type to mutate
* @param factory the factory to use when creating submutators
* @return a {@link SerializingMutator} for the given {@code type}, or {@link Optional#empty()}
* if this factory can't create such mutators
*/
@CheckReturnValue
public abstract Optional<SerializingMutator<?>> tryCreate(
AnnotatedType type, MutatorFactory factory);
}
|
