MDS/openide
1
0
Fork 0
mirror of https://gitflic.ru/project/openide/openide.git synced 2025-12-14 18:05:27 +07:00
Code Issues Packages Projects Releases Wiki Activity

add doc comment for several factory methods

Browse Source 
GitOrigin-RevId: f27bacf90209d9686204369bee91f85cf0440d12
This commit is contained in:
Max Medvedev
2024-05-14 13:15:59 +02:00
committed by intellij-monorepo-bot
parent 04185d7432
commit bc0a67dd04
1 changed files with 20 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
platform/util/base/src/com/intellij/util/containers/CollectionFactory.java
View File

@@ -14,26 +14,42 @@ import java.util.function.BiConsumer;
// ContainerUtil requires trove in classpath
public final class CollectionFactory {
/**
* Concurrent weak key:K -> strong value:V map.
*/
@Contract(value = " -> new", pure = true)
public static @NotNull <K, V> ConcurrentMap<@NotNull K, @NotNull V> createConcurrentWeakMap() {
return new ConcurrentWeakHashMap<>(0.75f);
}
/**
* Concurrent weak key:K -> strong value:V map.
*/
@Contract(value = "_, -> new", pure = true)
public static @NotNull <K, V> ConcurrentMap<@NotNull K, @NotNull V> createConcurrentWeakMap(@NotNull HashingStrategy<? super K> strategy) {
return new ConcurrentWeakHashMap<>(strategy);
}
/**
* Concurrent weak key:String -> strong value:V map with case-insensitive hashing strategy.
*/
@Contract(value = " -> new", pure = true)
public static @NotNull <V> ConcurrentMap<@NotNull String, @NotNull V> createConcurrentWeakCaseInsensitiveMap() {
return new ConcurrentWeakHashMap<>(HashingStrategy.caseInsensitive());
}
/**
* Concurrent strong key:K -> weak value:V map
*/
@Contract(value = " -> new", pure = true)
public static @NotNull <K, V> ConcurrentMap<@NotNull K, @NotNull V> createConcurrentWeakValueMap() {
return new ConcurrentWeakValueHashMap<>(null);
}
/**
* Concurrent strong key:K -> soft value:V map
*/
@Contract(value = " -> new", pure = true)
public static @NotNull <K, V> ConcurrentMap<@NotNull K, @NotNull V> createConcurrentSoftValueMap() {
return new ConcurrentSoftValueHashMap<>(null);
@@ -57,6 +73,9 @@ public final class CollectionFactory {
return new ConcurrentSoftValueHashMap<>(evictionListener);
}
/**
* Concurrent weak key:K -> strong value:V map with identity hashing strategy.
*/
@Contract(value = " -> new", pure = true)
public static @NotNull <K, V> ConcurrentMap<@NotNull K, @NotNull V> createConcurrentWeakIdentityMap() {
return new ConcurrentWeakHashMap<>(HashingStrategy.identity());
@@ -74,7 +93,7 @@ public final class CollectionFactory {
/**
* Weak keys hard values hash map.
* Null keys are NOT allowed
* Null values are allowed
* Null values ARE allowed
*/
@Contract(value = "_,_,_ -> new", pure = true)
public static @NotNull <K, V> Map<@NotNull K, V> createWeakMap(int initialCapacity, float loadFactor, @NotNull HashingStrategy<? super K> hashingStrategy) {