toString()-genereringsfunktion: Formatmallar

Formatmallar används av en enkel mekanism för att ändra format för genererade metoders utdatasträng: början, slutet, separator osv. De liknar JDT-kodmallar men påverkar inte den genererade koden direkt (Kodformat används till det). Tillgängliga mallvariabler:

${object.className}infogar klassnamnet som en enkel sträng
${object.getClassName}infogar ett anrop till this.getClass.getName()
${object.superToString}infogar ett anrop till super.toString()
${object.hashCode}infogar ett anrop till this.hashCode()
${object.identityHashCode}infogar ett anrop till System.identityHashCode(this)
${member.name}infogar första medlemmens namn
${member.name()}infogar första medlemmens namn följt av parentes om det är en metod
${member.value}infogar första medlemmens värde
${otherMembers}infogar återstående medlemmar. Mallfragmentet mellan den första och sista ${member.*}-variabeln utvärderas och bifogas resultatet för varje medlem. Tecknen mellan den sista ${member.*}-variabeln och ${otherMembers}-variabeln definierar separatorn som infogas mellan medlemmarna (${otherMembers} måste stå efter den sista ${member.*}-variabeln).

Om mallen ska fungera på rätt sätt måste variabeln ${otherMembers} användas exakt en gång i en mall och den kan inte följas av en ${member.*}-variabel. ${object.*}-variabler kan placeras på valfri plats i mallen men om en sådan variabel placeras i ett medlemsrelaterat fragment (mellan den första ${member.*}-variabeln och ${otherMembers}) upprepas den för varje medlem vilket förmodligen inte är en smart lösning.

Beskrivningen kan tyckas komplicerad men mallformatet är enkelt att använda. Följande exempel visar hur det fungerar.

Mallexempel

  1. Standardmallen är ett bra exempel:

    ${class.name} [${member.name()}=${member.value}, ${otherMembers}]

    Utdatasträngen för den här mallen ser ut på följande sätt:

    FooClass[aFloat=1.0, aString=hello, anInt=10, anObject=null, aCharMethod()=a]
  2. Flera radutdata är också tillgängliga:

    ${object.getClassName} {
    	${member.name}: ${member.value}
    	${otherMembers}
    }

    Exempelresultat:

    FooClass {
    	aFloat: 1.0
    	aString: hello
    	anInt: 10
    	anObject: null
    	aCharMethod: a
    }
  3. Om du omger en medlem med klammerparenteser måste du göra det även med ${otherMembers}-variabeln:

    {${member.name}=${member.value}},
    {${otherMembers}}

    Resultat:

    {aFloat=1.0},
    {aString=hello},
    {anInt=10},
    {anObject=null},
    {aCharMethod=a}
  4. ${object.*}-variabler kan användas i början och slutet av mallen:

    ${object.getClassName} (hashcode:${object.hashCode})
    	members: ${member.name} = ${member.value}; ${otherMembers}
    [super: ${object.superToString}]

    Resultatet av den här mallen blir:

    FooClass (hashCode:232198409832)
    	members: aFloat = 1.0; aString = hello; anInt = 10; anObject = null; aCharMethod = a
    [super: SuperFooClass[aField=null]]

Närliggande referens

Dialogrutan Generera toString()
toString()-genereringsfunktion: kodformat
toString()-genereringsfunktion: lista innehåll