Formatter

In de Java-editor drukt u op Ctrl+Shift+F om de geselecteerde code in te delen. Als er geen selectie is gemaakt, wordt de volledige broncode ingedeeld. Enkele tips voor het werken met de formatter vindt u in de alinea's van dit hoofdstuk.

De voorkeuren voor de Java-formatter vindt u op de voorkeurenpagina Voorkeurenpagina openen voor de Java-formatter Java-formatter.

Formatter uitschakelen binnen secties

U kunt de formatter in- of uitschakelen in een of meer secties van de code, zoals in het onderstaande voorbeeld:

Voorbeeld van Java-formatter. Enige code met daarin tags voor in- en uitschakelen.

In de bovenstaande snippet worden standaard tagnamen gebruikt, maar deze tagnamen kunt u wijzigen op het tabblad Off/On-tags van de voorkeurenpagina voor de Java-formatter.

De buitenste methodeaanroepen laten teruglopen

Vanaf versie 3.6 probeert de Java-formatter eerst de buitenste methodeaanroepen terug te laten lopen voor een betere uitvoer bij het laten teruglopen van geneste methodeaanroepen.

Hieronder volgt een voorbeeld van een ingedeelde code waarbij de formatter de regel heeft laten teruglopen tussen de parameters van de buitenste berichtaanroep, zodat elke geneste methodeaanroep op een enkele regel staat:

Voorbeeld van Java-formatter. De eenvoudige snippet met de ingedeelde geneste methodeaanroepen.

Met een nieuwe voorkeur kunt u deze strategie uitschakelen, meestal als u uw code wilt indelen zoals hiervoor. Schakel vervolgens de voorkeur Voorkeur voor terugloop buitenste expressies uit op het tabblad Regelterugloop van de voorkeurenpagina Java-formatter.

Opmerking: Momenteel is de nieuwe strategie alleen van toepassing op geneste methodeaanroepen, maar dat kan worden uitgebreid naar andere geneste expressies in toekomstige versies.

Javadoc en blokcommentaar comprimeren

Gebruikers kunnen ingedeelde commentaar van meerdere regels indelen met minder regels zoals in het volgende voorbeeld:

Voorbeeld van Java-formatter. De eenvoudige snippet met de blok- en Javadoc-commentaar ingedeeld  met minder regels dan met het standaardprofiel.

Als u dit gedrag wilt activeren, schakelt u de voorkeur /* en */ op afzonderlijke regels uit. Deze voorkeur bevindt zich op de tab Commentaar van de Java Formatter-voorkeurenpagina.

Hetzelfde soort voorkeur is ook beschikbaar voor de Javadoc-commentaar.

Regeleinden van gebruiker bewaren

Gebruikers kunnen regeleinden bewaren door regels niet samen te voegen in code of commentaar.

Bijvoorbeeld, de regels die reeds teruglopen in de return-instructie in de volgende testcase:

Voorbeeld van in te delen code

wordt bewaard door de formatter wanneer de voorkeur Regels nooit samenvoegen wordt gebruikt, en geeft dus de volgende uitvoer na indeling:

Code ingedeeld met Regels nooit samenvoegen

Om dit gedrag te activeren, selecteert u de voorkeur Nooit regels samenvoegen op de tabs Regelterugloop en Commentaar van de voorkeurenpagina van de Java Formatter.

Verwante concepten

Java-editor
JDT (Java Development Tools)

Verwante onderwerpen

Menu Bewerken
Voorkeurenpagina Java - Editor
Voorkeuren formatter