common: Add external annotations to Guava Cache and LoadingCache

getIfPresent() should return a @Nullable V. Elsewhere it should
follow the declaration type.

Some other methods (asMap() etc.) are known to really return a
possibly empty map, so those can be marked @NonNull.

Change-Id: I5466151977ee639535b1f818ef9e3c14ba122f7e
Signed-off-by: Alexandre Montplaisir <alexmonthy@efficios.com>
Reviewed-on: https://git.eclipse.org/r/85082
Tested-by: Genevieve Bastien <gbastien+lttng@versatic.net>
Reviewed-by: Hudson CI

diff --git a/common/org.eclipse.tracecompass.common.core/annotations/com/google/common/cache/Cache.eea b/common/org.eclipse.tracecompass.common.core/annotations/com/google/common/cache/Cache.eea
new file mode 100644 (file)
index 0000000..dab3ef8
--- /dev/null
+++ b/common/org.eclipse.tracecompass.common.core/annotations/com/google/common/cache/Cache.eea
@@ -0,0 +1,16 @@
+class com/google/common/cache/Cache
+asMap
+ ()Ljava/util/concurrent/ConcurrentMap<TK;TV;>;
+ ()L1java/util/concurrent/ConcurrentMap<TK;TV;>;
+get
+ (TK;Ljava/util/concurrent/Callable<+TV;>;)TV;
+ (TK;Ljava/util/concurrent/Callable<+1TV;>;)T1V;
+getAllPresent
+ (Ljava/lang/Iterable<*>;)Lcom/google/common/collect/ImmutableMap<TK;TV;>;
+ (Ljava/lang/Iterable<*>;)L1com/google/common/collect/ImmutableMap<TK;TV;>;
+getIfPresent
+ (Ljava/lang/Object;)TV;
+ (Ljava/lang/Object;)T0V;
+putAll
+ (Ljava/util/Map<+TK;+TV;>;)V
+ (L1java/util/Map<+TK;+TV;>;)V

diff --git a/common/org.eclipse.tracecompass.common.core/annotations/com/google/common/cache/LoadingCache.eea b/common/org.eclipse.tracecompass.common.core/annotations/com/google/common/cache/LoadingCache.eea
new file mode 100644 (file)
index 0000000..0207dc5
--- /dev/null
+++ b/common/org.eclipse.tracecompass.common.core/annotations/com/google/common/cache/LoadingCache.eea
@@ -0,0 +1,7 @@
+class com/google/common/cache/LoadingCache
+asMap
+ ()Ljava/util/concurrent/ConcurrentMap<TK;TV;>;
+ ()L1java/util/concurrent/ConcurrentMap<TK;TV;>;
+getAll
+ (Ljava/lang/Iterable<+TK;>;)Lcom/google/common/collect/ImmutableMap<TK;TV;>;
+ (Ljava/lang/Iterable<+TK;>;)L1com/google/common/collect/ImmutableMap<TK;TV;>;