Вводящая в заблуждение документация Java String.intern()? ⇐ JAVA

[Anonymous]

Меня смущает документация по методу Java String.intern(). В официальной документации указано:

Возвращает каноническое представление строкового объекта. Пул
строк, изначально пустой, поддерживается частным образом классом String.
При вызове метода intern, если пул уже содержит строку,
равную этому объекту String, как определено методquals(Object)
, то возвращается строка из пула. В противном случае этот объект
String добавляется в пул и возвращается ссылка на этот объект String
.

Но когда мы создайте строку, используя new, разве строковый литерал уже не добавлен в пул строк? Например:

Код: Выделить всё

String s1 = new String("Java");  // Creates 2 objects

Итак, когда именно intern() фактически добавляет новую строку в пул? Документация кажется вводящей в заблуждение, или я что-то упускаю?

Подробнее здесь: https://stackoverflow.com/questions/791 ... umentation