CKTIS / Java
String.intern() w Javie: pula kanoniczna, tożsamość i treść
Zobacz, dlaczego dwa napisy o tej samej treści mogą być różnymi obiektami, jak działa pula `intern()` i co naprawdę mierzy `length()`.
Wersja: Java SE 21
Składnia
Java SE 21 — java.lang.String
Primary API signature:
public String intern()
Supporting API signatures:
public String(String original)
public int length()
public boolean equals(Object anObject)
Usage (s and t are non-null String references):
String copy = new String(s);
String canonical = copy.intern();
int units = copy.length();
boolean sameContent = s.equals(t);
boolean sameObject = s == t;
boolean sameCanonicalObject = s.intern() == t.intern();W Java SE 21 wyrażenie new String(s) wywołuje konstruktor String(String) klasy java.lang.String i tworzy nowy obiekt o tej samej treści co s. Ponieważ napisy są niemutowalne, zwykle wystarczy przypisać istniejącą referencję. Przekazanie null do tego przeciążenia powoduje NullPointerException.
length() liczy jednostki kodowe UTF-16 (char), a nie punkty kodowe ani znaki postrzegane przez użytkownika. Ta sama długość nie oznacza tej samej treści. Dla niepustej referencji s wywołanie s.equals(t) zwraca true tylko wtedy, gdy t jest obiektem String o identycznej sekwencji jednostek kodowych, z uwzględnieniem wielkości liter; dla argumentu null zwraca false. Wywołanie metody na referencji null powoduje NullPointerException. Operator == porównuje referencje: daje true dla tego samego obiektu lub dwóch wartości null.
String.intern() jest metodą instancji. Jeśli w puli jest już napis równy według equals(Object), metoda zwraca referencję do niego; w przeciwnym razie dodaje obiekt, na którym ją wywołano, i zwraca jego referencję. Literały napisowe i wartości wyrażeń stałych typu String trafiają do puli automatycznie. Dla referencji s i t różnych od null warunek s.intern() == t.intern() jest prawdziwy dokładnie wtedy, gdy s.equals(t) jest prawdziwe. Użyj zwróconej referencji: wywołanie nie zmienia napisu ani referencji zapisanej w zmiennej.
Do zwykłego porównywania treści używaj equals(Object), a nie ==. Internowanie nie gwarantuje oszczędności pamięci ani przyspieszenia. Nie zakładaj określonego czasu przechowywania wpisów w puli; przed zastosowaniem tej techniki jako optymalizacji zmierz jej koszt i korzyści przy rzeczywistym obciążeniu.
Przykłady
public class Main {
public static void main(String[] args) {
String literal = "A\uD83D\uDE00";
String copy = new String(literal);
System.out.println("length: " + copy.length());
System.out.println("same contents: " + copy.equals(literal));
System.out.println("same object: " + (copy == literal));
String canonical = copy.intern();
System.out.println("canonical is literal: " + (canonical == literal));
System.out.println("copy is canonical: " + (copy == canonical));
}
}
Wynik
length: 3 same contents: true same object: false canonical is literal: true copy is canonical: false
`length: 3` oznacza jedną jednostkę UTF-16 dla `A` i dwie dla emoji. Kopia ma tę samą treść, lecz inną tożsamość. `intern()` zwraca referencję do istniejącego literału, a `copy` nadal wskazuje nowy obiekt.
Powiązane lekcje
- Java · Lekcja 49 · Zaawansowany · Wersja: 2
Źródła
- Java SE 21 API — String(String original)
- Java SE 21 API — String.intern()
- Java SE 21 API — String.length()
- Java SE 21 API — String.equals(Object)
- Java Language Specification, Java SE 21 — §3.10.5 String Literals
- Java Language Specification, Java SE 21 — §15.21.3 Reference Equality Operators == and !=
- JDK 21 — The java Command: Using Source-File Mode to Launch Single-File Source-Code Programs