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