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.
Arrays.toString(). Kyseinen metodi ei ole käytettävissä JDK-versiossa 1.4, joten sen sijasta käytetään metodia Arrays.asList(). Kyseistä metodia käytetään kuitenkin vain muiden kuin alkeistyyppitaulukoiden yhteydessä. Alkeistyyppitaulukoita käsitellään jäljempänä esiteltävän apumetodin avulla.Arrays.asList() ja List.subList(). Esimerkiksi jäsenen nimeltä anArray muodostettu koodi olisi seuraava: Arrays.asList(anArray).subList(0, Math.min(anArray.length, maxLen))Arrays.asList() ei voi käyttää, joten JDK-versiossa 1.5 tai sitä aiemmassa versiossa käytetään apumetodia. JDK-versiossa 1.6 on toinen ratkaisu: Arrays.toString(Arrays.copyOf(anArray, Math.min(anArray.length, maxLen)). Vaikka taulukon kopiointi ei ole paras mahdollinen ratkaisu, kopioitu osa on tavallisesti melko pienikokoinen, eikä tehokkuus kärsi. Ratkaisun etuna on, että apumetodia ei tarvitse käyttää.[1, 2, 3]. Metodi iteroi taulukon ja selvittää sen sisällytystyypin instanceof-lauseen avulla. Koodia on lyhennetty määrittämällä lause tarkistamaan vain tyypit, jotka voidaan tosiasiassa välittää lauseeseen.
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();
}
HUOMAUTUKSIA:maxLen-argumenttia eikä metodia Math.min().Luettelojen rajoitetun sisällön luettelointiKaikissa 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 luettelointiVastaavuusmääritysten yhteydessä käytetään samaa apumetodia kuin kokoelmien yhteydessä. Erona on, että metodiin välitetään map.entrySet()-metodi.
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() |
subList()-metodia käytetään tavallisesti luettelojen käsittelyyn, mutta jos käytössä on toinen jäsen (muu kuin luettelo), jonka laji on kokoelma, ja toString(collection)-metodi muodostetaan, myös luettelot välitetään kyseiseen metodiin. Tällä tavalla koodista tulee lyhyempää ja yhtenäisempää.array != null ? Arrays.asList(array) : null[]) edellä kuvattujen metodien sijasta.
Luo metodi toString() -valintaikkuna
ToString()-muodostustoiminto: muotomallipohjat
ToString()-muodostustoiminto: koodityylit