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
|
// Copyright 2017 Yahoo Holdings. Licensed under the terms of the Apache 2.0 license. See LICENSE in the project root.
package com.yahoo.config.provision;
import java.util.Optional;
/**
* A capacity request.
*
* @author Ulf Lilleengen
* @author bratseth
*/
public final class Capacity {
private final int nodeCount;
private final boolean required;
private final boolean canFail;
private final Optional<NodeResources> nodeResources;
private final NodeType type;
private Capacity(int nodeCount, Optional<NodeResources> nodeResources, boolean required, boolean canFail, NodeType type) {
this.nodeCount = nodeCount;
this.required = required;
this.canFail = canFail;
this.nodeResources = nodeResources;
this.type = type;
}
/** Returns the number of nodes requested */
public int nodeCount() { return nodeCount; }
/**
* The node flavor requested, or empty if no legacy flavor name has been used.
* This may be satisfied by the requested flavor or a suitable replacement.
*
* @deprecated use nodeResources instead
*/
@Deprecated
public Optional<String> flavor() {
if (nodeResources().isEmpty()) return Optional.empty();
return nodeResources.get().legacyName();
}
/** Returns the resources requested for each node, or empty to leave this decision to provisioning */
public Optional<NodeResources> nodeResources() { return nodeResources; }
/** Returns whether the requested number of nodes must be met exactly for a request for this to succeed */
public boolean isRequired() { return required; }
/**
* Returns true if an exception should be thrown if the specified capacity can not be satisfied
* (to whatever policies are applied and taking required true/false into account).
* Returns false if it is preferable to still succeed with partially satisfied capacity.
*/
public boolean canFail() { return canFail; }
/**
* Returns the node type (role) requested. This is tenant nodes by default.
* If some other type is requested the node count and flavor may be ignored
* and all nodes of the requested type returned instead.
*/
public NodeType type() { return type; }
@Override
public String toString() {
return nodeCount + " nodes " + (nodeResources.isPresent() ? "of flavor " + nodeResources.get() : "(default flavor)" );
}
/** Creates this from a desired node count: The request may be satisfied with a smaller number of nodes. */
public static Capacity fromNodeCount(int capacity) {
return fromNodeCount(capacity, Optional.empty(), false, true);
}
/** Create a non-required, failable capacity request */
public static Capacity fromCount(int nodeCount, NodeResources resources) {
return fromCount(nodeCount, resources, false, true);
}
public static Capacity fromCount(int nodeCount, NodeResources resources, boolean required, boolean canFail) {
return new Capacity(nodeCount, Optional.of(resources), required, canFail, NodeType.tenant);
}
public static Capacity fromCount(int nodeCount, Optional<NodeResources> resources, boolean required, boolean canFail) {
return new Capacity(nodeCount, resources, required, canFail, NodeType.tenant);
}
public static Capacity fromNodeCount(int nodeCount, Optional<String> flavor, boolean required, boolean canFail) {
return new Capacity(nodeCount, flavor.map(NodeResources::fromLegacyName), required, canFail, NodeType.tenant);
}
/** Creates this from a node type */
public static Capacity fromRequiredNodeType(NodeType type) {
return new Capacity(0, Optional.empty(), true, false, type);
}
}
|