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
|
package org.bukkit.metadata;
import java.lang.ref.SoftReference;
import java.util.concurrent.Callable;
import org.apache.commons.lang.Validate;
import org.bukkit.plugin.Plugin;
/**
* The LazyMetadataValue class implements a type of metadata that is not computed until another plugin asks for it.
* By making metadata values lazy, no computation is done by the providing plugin until absolutely necessary (if ever).
* Additionally, LazyMetadataValue objects cache their values internally unless overridden by a {@link CacheStrategy}
* or invalidated at the individual or plugin level. Once invalidated, the LazyMetadataValue will recompute its value
* when asked.
*/
public class LazyMetadataValue extends MetadataValueAdapter implements MetadataValue {
private Callable<Object> lazyValue;
private CacheStrategy cacheStrategy;
private SoftReference<Object> internalValue;
private static final Object ACTUALLY_NULL = new Object();
/**
* Initialized a LazyMetadataValue object with the default CACHE_AFTER_FIRST_EVAL cache strategy.
*
* @param owningPlugin the {@link Plugin} that created this metadata value.
* @param lazyValue the lazy value assigned to this metadata value.
*/
public LazyMetadataValue(Plugin owningPlugin, Callable<Object> lazyValue) {
this(owningPlugin, CacheStrategy.CACHE_AFTER_FIRST_EVAL, lazyValue);
}
/**
* Initializes a LazyMetadataValue object with a specific cache strategy.
*
* @param owningPlugin the {@link Plugin} that created this metadata value.
* @param cacheStrategy determines the rules for caching this metadata value.
* @param lazyValue the lazy value assigned to this metadata value.
*/
public LazyMetadataValue(Plugin owningPlugin, CacheStrategy cacheStrategy, Callable<Object> lazyValue) {
super(owningPlugin);
Validate.notNull(cacheStrategy, "cacheStrategy cannot be null");
Validate.notNull(lazyValue, "lazyValue cannot be null");
this.internalValue = new SoftReference<Object>(null);
this.lazyValue = lazyValue;
this.cacheStrategy = cacheStrategy;
}
/** Protected special constructor used by FixedMetadataValue to bypass standard setup. */
protected LazyMetadataValue(Plugin owningPlugin) {
super(owningPlugin);
}
public Object value() {
eval();
Object value = internalValue.get();
if (value == ACTUALLY_NULL) {
return null;
}
return value;
}
/**
* Lazily evaluates the value of this metadata item.
*
* @throws MetadataEvaluationException if computing the metadata value fails.
*/
private synchronized void eval() throws MetadataEvaluationException {
if (cacheStrategy == CacheStrategy.NEVER_CACHE || internalValue.get() == null) {
try {
Object value = lazyValue.call();
if (value == null) {
value = ACTUALLY_NULL;
}
internalValue = new SoftReference<Object>(value);
} catch (Exception e) {
throw new MetadataEvaluationException(e);
}
}
}
public synchronized void invalidate() {
if (cacheStrategy != CacheStrategy.CACHE_ETERNALLY) {
internalValue.clear();
}
}
/**
* Describes possible caching strategies for metadata.
*/
public enum CacheStrategy {
/**
* Once the metadata value has been evaluated, do not re-evaluate the value until it is manually invalidated.
*/
CACHE_AFTER_FIRST_EVAL,
/**
* Re-evaluate the metadata item every time it is requested
*/
NEVER_CACHE,
/**
* Once the metadata value has been evaluated, do not re-evaluate the value in spite of manual invalidation.
*/
CACHE_ETERNALLY
}
}
|