ToString()-muodostustoiminto: sisältöluettelo

Tässä aiheessa esitellään, miten toString()-muodostustoiminto muodostaa luetteloja taulukoiden sisällöstä ja rajoittaa kokoelmissa ja vastaavuusmäärityksissä lueteltavien objektien määrää. Käytettävä metodi vaihtelee jäsenlajin ja projektin valitun JDK-yhteensopivuustason mukaan.

Luetteloiden muodostus taulukoiden sisällöstä

Luettelojen rajoitetun sisällön luettelointi

Kaikissa JDK-versioissa on käytössä sama ratkaisu: aList.subList(0, Math.min(aList.size(), maxLen))

Kokoelmien rajoitetun sisällön luettelointi (apumetodi)

Kokoelma ei voi muuttaa luetteloksi kopioimatta kokoelman sisältöä (ellei kokoelma ole jo valmiiksi luettelo), joten ensimmäiset maxLen-elementit iteroidaan apumetodin avulla ja niistä kootaan merkkijono:

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();
}
HUOMAUTUKSIA:

Vastaavuusmääritysten rajoitetun sisällön luettelointi

Vastaavuusmääritysten yhteydessä käytetään samaa apumetodia kuin kokoelmien yhteydessä. Erona on, että metodiin välitetään map.entrySet()-metodi.

Tiivistelmä

Seuraavassa taulukossa on tiivistelmä eri tilanteissa käytettävistä metodeista:

java.util.List java.util.Collection java.util.Map Alkeistyyppejä sisältävä taulukko Muita kuin alkeistyyppejä sisältävä taulukko
JDK 1.4 - - - apumetodi arrayToString(array, len) Arrays.asList(array)
JDK 1.4/1.5, elementtirajoitus member.subList() apumetodi toSting(collection, maxLen) apumetodi toString(collection, maxLen) ja map.entrySet() apumetodi arrayToString(array, len, maxLen) Arrays.asList(array).subList()
JDK 1.5 - - - Arrays.toString() Arrays.asList(array)
JDK 1.6 - - - Arrays.toString() Arrays.toString()
JDK 1.6, elementtirajoitus member.subList() apumetodi toString(Collection) apumetodi toString(Collection) ja map.entrySet() Arrays.toString(Arrays.copyOf(member, ...)) Arrays.asList(array).subList()

Lisähuomautuksia

Aiheeseen liittyviä ohjeita

Luo metodi toString() -valintaikkuna
ToString()-muodostustoiminto: muotomallipohjat
ToString()-muodostustoiminto: koodityylit