public interface Interner<E>
String.intern() for any immutable type. Common implementations
are available from the Interners class.
Note that String.intern() has some well-known performance limitations, and should
generally be avoided. Prefer Interners.newWeakInterner() or another Interner
implementation even for String interning.
| Modifier and Type | Method and Description |
|---|---|
E |
intern(E sample)
Chooses and returns the representative instance for any of a collection of instances that are
equal to each other.
|
E intern(E sample)
intern(a).equals(a) always holds,
and intern(a) == intern(b) if and only if a.equals(b). Note that intern(a) is permitted to return one instance now and a different instance later if the
original interned instance was garbage-collected.
Warning: do not use with mutable objects.
java.lang.NullPointerException - if sample is null