Eclipse permet de formater le code source, menu « Source/Format » ou touche « Ctrl + Shfit + F« . Cella permet homogénéiser le code source et aussi de voir s’il ne contient pas d’erreur (le formatage ne se fait pas, ou ne correspond pas à ce que l’on attend).
Mais il peut arriver que vous ne souhaitiez pas de formatage localement dans votre source.
Par exemple sur le code source suivant :
public class TestFormatageJava {
public String toJsonObject(String key, String value) {
StringBuilder sb = new StringBuilder();
sb.append("{\"")
.append(key)
.append("\":\"")
.append(value)
.append("\"}");
return sb.toString();
}
}Une fois formaté avec Eclipse, le source devient :
public class TestFormatageJava {
public String toJsonObject(String key, String value) {
StringBuilder sb = new StringBuilder();
sb.append("{\"").append(key).append("\":\"").append(value).append("\"}");
return sb.toString();
}
}C’est moins lisible, mais plus compacte !
Pour indiquer à Eclipse de ne pas changer le formatage d’origine il faut :
- éditer les préférences : menu « Windows/Preferences«
- aller dans « JavaCode Style/Formater«
- cliquer sur « Edit » (sur la droite)
- aller sur l’onglet « Off/On Tags » (dernier onglet)
- puis cliquer sur « Enable Off/On Tags »

- puis dans votre source, devant l’emplacement ou le formatage ne doit pas ce faire, ajouter le commentaire :
// @formatter:off
- puis ajouter en fin :
//@formatter:on
- Formater votre code , menu « Source/Format » ou touche « Ctrl + Shfit + F«
Le code sera formaté, sauf entre les deux directives « @formatter« , ce qui donne :
public class TestFormatageJava {
public String toJsonObject(String key, String value) {
StringBuilder sb = new StringBuilder();
// @formatter:off
sb.append("{\"")
.append(key)
.append("\":\"")
.append(value)
.append("\"}");
//@formatter:on
return sb.toString();
}
}Bien sûre, ce genre de directive n’est à utiliser qu’avec parcimonie 😉