Formater

W edytorze Java naciśnij kombinację klawiszy Ctrl+Shift+F, aby sformatować kod. Sformatowany zostanie wybrany fragment kodu, a jeśli nie wybrano fragmentu, zostanie sformatowany cały kod źródłowy. Pewne wskazówki dotyczące korzystania z formatera zawierają sekcje tego rozdziału.

Preferencje formatera Java są dostępne stronie preferencji Otwiera stronę preferencji formatera Java Formater Java.

Wyłączanie formatera wewnątrz sekcji

Formater można wyłączać/włączać w różnych sekcjach kodu, co przedstawiono w przykładzie poniżej:

Przykład dla formatera Java. W części kodu użyto znaczników wyłączających i włączających.

W powyższym fragmencie kodu użyto domyślnych nazw znaczników, ale można je zmienić na karcie Znaczniki wyłączania i włączania na stronie preferencji formatera Java.

Zawijanie najbardziej zewnętrznych wywołań metod

Od wersji 3.6 formater Java próbuje zawijać najpierw najbardziej zewnętrzne wywołania metod, aby uzyskać lepsze dane wyjściowe podczas zawijania wywołań metod zagnieżdżonych.

Poniżej przedstawiono przykład sformatowanego kodu, w którym formater zawinął wiersz między argumentami wywołania metody położonego najbardziej na zewnątrz, aby zachować każde wywołanie metody zagnieżdżonej w jednym wierszu.

Przykład formatera Java. Prosty fragment kodu ze sformatowanymi zagnieżdżonymi wywołaniami metod.

Nowa preferencja umożliwia wyłączenie tej strategii (np. w celu formatowania kodu w dotychczasowy sposób) przez usunięcie zaznaczenia preferencji Preferuj zawijanie wyrażeń zewnętrznych dostępnej na karcie Zawijanie wierszy na stronie preferencji formatera Java.

Uwaga: Choć aktualnie nowa strategia dotyczy wyłącznie zagnieżdżonych wywołań metod, w przyszłych wersjach może być rozszerzona o inne wyrażenia zagnieżdżane.

Kondensowanie komentarzy dokumentacji Javadoc i komentarzy blokowych

Użytkownicy mogą redukować liczbę wierszy sformatowany komentarzy wielowierszowych zgodnie z poniższym przykładem:

Przykład formatera Java. Prosty fragment kodu z komentarzami blokowymi i komentarzami dokumentacji Javadoc sformatowanymi przy użyciu mniejszej liczby wierszy niż w przypadku profilu domyślnego.

Aby aktywować to zachowanie, należy usunąć zaznaczenie preferencji /* i */ w osobnych wierszach dostępnej na karcie Komentarze strony preferencji formatera Java.

Podobna preferencja jest także dostępna dla komentarzy dokumentacji Javadoc.

Zachowywanie podziałów wierszy użytkownika

Użytkownicy mogą zachowywać podziały wierszy, nie łącząc wierszy w kodzie ani w komentarzach.

Na przykład już zawinięte wiersze instrukcji return w następującej instrukcji testowania:

Przykład kodu do sformatowania

zostaną zachowane przez formater, gdy zostanie użyta preferencja Nigdy nie łącz wierszy; po sformatowaniu kod będzie wyglądał następująco:

Kod sformatowany z użyciem preferencji Nigdy nie łącz wierszy

Aby aktywować to zachowanie, należy zaznaczyć preferencję Nigdy nie łącz wierszy dostępną na kartach Zawijanie wierszy i Komentarze strony preferencji formatera Java.

Pojęcia pokrewne

Edytor Java
Java Development Tools (JDT)

Informacje pokrewne

Menu Edycja
Preferencje edytora Java
Preferencje formatera