Niniejszy temat przedstawia sposób, w jaki generator metody toString() wyświetla zawartość tablic i ogranicza liczbę elementów przedstawianych w kolekcjach i odwzorowaniach. Używana metoda jest zależna nie tylko od typu składowego, ale także od wybranej zgodności projektu z pakietem JDK.
Arrays.toString(). Ponieważ ta metoda jest niedostępna w pakiecie JDK 1.4, w tym przypadku zamiast niej używana jest metoda Arrays.asList(), ale tylko dla tablic typu innego niż podstawowy. Tablice typu podstawowego są obsługiwane przy użyciu metody pomocniczej, którą przedstawiono poniżej.Arrays.asList() w połączeniu z metodą List.subList(). Na przykład dla składowej o nazwie anArray wygenerowany kod ma następującą postać: Arrays.asList(anArray).subList(0, Math.min(anArray.length, maxLen))Arrays.asList(), przez co w pakiecie JDK 1.5 lub starszym używana jest metoda pomocnicza. W pakiecie JDK 1.6 dostępne jest inne rozwiązanie: Arrays.toString(Arrays.copyOf(anArray, Math.min(anArray.length, maxLen)). Choć kopiowanie tablicy nie jest optymalnym rozwiązaniem, kopiowana część jest zwykle mała, dzięki czemu nie ma wpływu na wydajność. Zaletą jest możliwość uniknięcia użycia metody pomocniczej.[1, 2, 3]. Metoda wykonuje iterację tablicy i używa instrukcji instanceof w celu określenia jej typu obejmującego. Aby skrócić kod, sprawdzane są tylko typy, które można przekazać do tej instrukcji.
private String arrayToString(Object array, int len, int maxLen) {
StringBuffer stringBuffer = new StringBuffer();
len = Math.min(len, maxLen);
stringBuffer.append("[");
for (int i = 0; i < len; i++) {
if (i > 0)
stringBuffer.append(", ");
if (array instanceof float[])
stringBuffer.append(((float[]) array)[i]);
if (array instanceof int[])
stringBuffer.append(((int[]) array)[i]);
if (array instanceof Object[])
stringBuffer.append(((Object[]) array)[i]);
}
stringBuffer.append("]");
return stringBuffer.toString();
}
UWAGI:maxLen i nie używa metody Math.min().listTo samo rozwiązanie jest używane dla wszystkich wersji pakietu JDK: aList.subList(0, Math.min(aList.size(), maxLen))
kolekcji (metoda pomocnicza)Kolekcji nie można przekształcić w listę bez kopiowania jej zawartości (zakładając, że nie jest to już lista). Z tego powodu najpierw używana jest metoda pomocnicza w celu iteracji pierwszych elementów argumentu maxLen i zbudowania z nich łańcucha:
private String toString(Collection collection, int maxLen) {
StringBuffer stringBuffer = new StringBuffer();
stringBuffer.append("[");
int i = 0;
for (Iterator iterator = collection.iterator(); iterator.hasNext() && i < maxLen; i++) {
if (i > 0)
stringBuffer.append(", ");
stringBuffer.append(iterator.next());
}
stringBuffer.append("]");
return stringBuffer.toString();
}
UWAGI:odwzorowaniaW przypadku odwzorowań używana jest ta sama metoda pomocnicza co w przypadku kolekcji, ale przekazywana jest do niej metoda map.entrySet().
Poniższa tabela stanowi podsumowanie metod używanych w różnych warunkach:
java.util.List |
java.util.Collection |
java.util.Map |
Tablica typu podstawowego | Tablica typu innego niż podstawowy | |
|---|---|---|---|---|---|
| jdk 1.4 | - | - | - | Metoda pomocnicza arrayToString(array, len) |
Arrays.asList(array) |
| Pakiet JDK 1.4/1.5, ograniczone elementy | member.subList() |
Metoda pomocnicza toSting(collection, maxLen) |
Metoda pomocnicza toString(collection, maxLen) z metodą map.entrySet() |
Metoda pomocnicza arrayToString(array, len, maxLen) |
Arrays.asList(array).subList() |
| Pakiet JDK 1.5 | - | - | - | Arrays.toString() |
Arrays.asList(array) |
| Pakiet JDK 1.6 | - | - | - | Arrays.toString() |
Arrays.toString() |
| Pakiet JDK 1.6, ograniczone elementy | member.subList() |
Metoda pomocnicza toString(Collection) |
Metoda pomocnicza toString(Collection) z metodą map.entrySet() |
Arrays.toString(Arrays.copyOf(member, ...)) |
Arrays.asList(array).subList() |
lista jest zwykle obsługiwana przy użyciu metody subList(), ale jeśli istnieje inna składowa typu kolekcja (a nie lista) i generowana jest metoda toString(collection), zostaną do niej przekazane również listy. Ten sposób kodowania jest krótszy i bardziej spójny.array != null ? Arrays.asList(array) : null"[]") zamiast metod opisanych powyżej.
Okno dialogowe Generowanie metody toString()
Generator metody toString(): szablony formatu
Generator metody toString(): style kodu