Codestijlen bepalen hoe de gegenereerde methode werkt en welke klasse deze gebruikt. Er zijn verschillende codestijlen beschikbaar in de keuzelijst in het dialoogvenster van de generator:
return "FooClass [aFloat=" + aFloat + ", aString=" + aString + ", anInt=" + anInt + ", anObject=" + anObject + "]";Als de optie "Null-waarden overslaan" wordt ingeschakeld, is de code iets moeilijker te begrijpen:
return "FooClass [aFloat=" + aFloat + ", " + (aString != null ? "aString=" + aString + ", " : "") + "anInt=" + anInt + ", " + (anObject != null ? "anObject=" + anObject : "") + "]";
StringBuilder builder = new StringBuilder();
builder.append("FooClass [aFloat=");
builder.append(aFloat);
builder.append(", aString=");
builder.append(aString);
builder.append(", anInt=");
builder.append(anInt);
builder.append(", anObject=");
builder.append(anObject);
builder.append("]");
return builder.toString();
De optie "Null-waarden overslaan" maakt de code minder ondoorzichtelijk dan in het vorige voorbeeld:
StringBuilder builder = new StringBuilder();
builder.append("FooClass [aFloat=");
builder.append(aFloat);
builder.append(", ");
if (aString != null) {
builder.append("aString=");
builder.append(aString);
builder.append(", ");
}
builder.append("anInt=");
builder.append(anInt);
builder.append(", ");
if (anObject != null) {
builder.append("anObject=");
builder.append(anObject);
}
builder.append("]");
return builder.toString();
StringBuilder builder = new StringBuilder();
builder.append("FooClass [aFloat=").append(aFloat).append(", aString=").append(aString)
.append(", anInt=").append(anInt).append(", anObject=").append(anObject).append("]");
return builder.toString();
Als de optie "Null-waarden overslaan" is ingeschakeld, moet de keten worden verbroken:
StringBuilder builder = new StringBuilder();
builder.append("FooClass [aFloat=").append(aFloat).append(", ");
if (aString != null) {
builder.append("aString=").append(aString).append(", ");
}
builder.append("anInt=").append(anInt).append(", ");
if (anObject != null) {
builder.append("anObject=").append(anObject);
}
builder.append("]");
return builder.toString();
return String.format("FooClass [aFloat=%s, aString=%s, anInt=%s, anObject=%s]",
aFloat, aString, anInt, anObject);
Omdat JDK 1.4 en lagere versies geen String.format() kennen, wordt in plaats hiervan MessageFormat.format() gebruikt:
return MessageFormat.format("FooClass [aFloat={0}, aString={1}, anInt={2}, anObject={3}]",
new Object[] { new Float(aFloat), aString, new Integer(anInt), anObject });
Deze stijl gebruikt een externe klasse om een resultaatreeks te genereren. De klassen kunnen worden gebruikt om aan de volgende voorwaarden te voldoen:
Object als parameter heeft - hieraan wordt een object doorgegeven waarvoor de methode toString() wordt aangeroepen.Object en (optioneel) een String hebben (in willekeurige volgorde).String retourneert.Een aangepaste builder vereist extra configuratie om goed te kunnen werken. Alle noodzakelijke opties kunnen worden opgegeven in het venster dat wordt geopend als u op 'Configureren...' klikt. Deze opties zijn onder anderen:
String moet zijn) voorrang op methoden met één argument (verder is het String-argument bij voorkeur het eerste argument). Als er versies van de methode zijn die specifieke argumenttypen hebben, worden deze indien mogelijk ook gebruikt.Stel dat de builderklasse er als volgt uitziet:
package org.foo.ToStringBuilder2;
public class ToStringBuilder2 {
public ToStringBuilder2(Object o) {...}
public ToStringBuilder2 appendItem(String s, Object o) {...}
public ToStringBuilder2 appendItem(String s, float f) {...}
public String getString() {...}
}
In dit geval moet de builderklasse natuurlijk worden ingesteld op "org.foo.ToStringBuilder2", het builderlabel kan bijvoorbeeld "builder" zijn, de append-methode is "appendItem" en de resultaatmethode is "getString". Als ketenoproepen is geselecteerd, ziet de gegenereerde methode er als volgt uit:
ToStringBuilder2 builder = new ToStringBuilder2(this);
builder.append("aFloat", aFloat).append("aString", aString).append("anInt", new Integer(anInt))
.append("anObject", anObject);
return builder.getString();
Let erop dat de primitieve variabele anInt naar de builder is doorgevoerd met het wrapper-type. Dit gebeurt in projecten in JDK 1.4 en oudere versies (in latere JDK's doet het compileerprogramma dit automatisch). In het geval van aFloat stond er een specifieke methode in de builderklasse, waardoor wrapping niet noodzakelijk was.
Dialoogvenster toString() genereren
toString()-generator: Indelingssjablonen
toString()-generator: Contentlijsten