CKTIS / Java
String.valueOf(Object): преобразуване на обект или null в текст
При референция `null` методът връща текста `"null"`, а иначе връща резултата от `toString()` на обекта. Това правило важи за варианта с параметър `Object`.
Версия: Java SE 21
Синтаксис
public static String valueOf(Object obj)String.valueOf(Object) е статичен метод на класа java.lang.String. Ако аргументът е референция null, методът връща низа от четири знака "null", а не референция null. В противен случай извиква реализацията на toString() за обекта и връща резултата без промяна.
Така можеш да покажеш candidate или wrong в диагностично съобщение, без да извикваш метод на обект чрез референция null. Това не е сериализация или проверка за липсваща стойност: референцията null и низът "null" дават един и същ текст. Ако разликата е важна, провери аргумента преди преобразуването. Ако toString() върне null или хвърли изключение, valueOf(Object) не заменя този резултат с низа "null".
Компилаторът избира кой от претоварените варианти да извика според типа на аргумента, известен при компилация. String.valueOf(null) избира по-специфичния вариант String.valueOf(char[]) и хвърля NullPointerException. Използвай String.valueOf((Object) null) или подай променлива от тип Object, за да избереш варианта за обекти. Когато char[] не е null, вариантът за масиви копира знаците в низ. Ако подадеш същия масив като Object, вместо това се извиква неговият toString().
Примери
public class Main {
record Candidate(int score) {
@Override
public String toString() {
return "score=" + score;
}
}
public static void main(String[] args) {
Object candidate = new Candidate(7);
Object wrong = null;
System.out.println("candidate=" + String.valueOf(candidate));
String wrongText = String.valueOf(wrong);
System.out.println("wrong is the text null: " + "null".equals(wrongText));
System.out.println("chars=" + String.valueOf(new char[] {'o', 'k'}));
try {
String.valueOf(null);
} catch (NullPointerException e) {
System.out.println("bare null: NullPointerException");
}
}
}Резултат
candidate=score=7 wrong is the text null: true chars=ok bare null: NullPointerException
`candidate` използва своята реализация на `toString()`, а сравнението потвърждава, че `wrong` дава текста `"null"`. Масивът от знаци дава `ok`. Последният ред се отпечатва от блока `catch` след извикването с литерала `null` без явно преобразуване на типа.
Свързани уроци
- Java · Урок 58 · Начално · Версия: 2
- Java · Урок 37 · Средно · Версия: 2