Верстальщик

В редакторе Java нажмите Ctrl+Shift+F на коде для его форматирования. Если фрагмент кода не выбран, то форматируется весь исходный код, иначе - только выбранный фрагмент. Некоторые советы по работе с верстальщиком приведены в параграфах этой главы.

Учтите, что параметры Верстальщика Java доступны на странице параметров Открывает страницу параметров
Верстальщика Java Верстальщик Java.

Отключение верстальщика внутри разделов

Верстальщик можно отключить (или включить) в одном или нескольких разделах кода, как показано в приведенном ниже примере:

Пример верстальщика Java. Фрагмент кода с тегами включения и отключения верстальщика.

В приведенном выше фрагменте используются имена тегов по умолчанию, но их можно изменить на вкладке Теги выключения/включения страницы параметров Верстальщика Java.

Переносить крайние внешние вызовы методов

Начиная с версии 3.6, верстальщик Java пытается сначала переносить крайние внешние методы, чтобы улучшить вывод, при переносе вложенных вызовов методов на новую строку.

Ниже приведен пример отформатированного кода, в котором верстальщик перенес строку между аргументами крайнего вызова, чтобы оставить каждый вложенный вызов метода на отдельной строке:

Пример
верстальщика Java. Простой фрагмент с отформатированными вложенными вызовами методов.

Новый параметр позволяет вам отключить эту стратегию. Например, если вы хотите, чтобы код форматировался как раньше, то удалите отметку с параметра Предпочитать перенос внешних выражений на вкладке Перенос строк страницы параметров Верстальщик Java.

Примечание: в настоящее время новая стратегия применима только к вложенным вызовам методов, однако в будущих версиях ее можно будет расширить на другие вложенные выражения.

Сжатые комментарии Javadoc и блочные комментарии

Пользователи могут сократить количество строк отформатированных многострочных комментариев, как показано в приведенном ниже примере:

Пример верстальщика
Java. Простой фрагмент с отформатированными блочным комментарием и комментарием Javadoc с меньшим
числом строк по сравнению с профайлом по умолчанию.

Для того чтобы активировать это поведение, удалите отметку с параметра /* и */ на отдельных строках на вкладке Комментарии страницы параметров Верстальщик Java.

Такой же параметр предоставляется и для комментариев Javadoc.

Сохранить пользовательские разрывы строк

Пользователи могут сохранить разрывы строк, запретив объединение строк кода и комментариев.

Например, уже перенесенные строки оператора return в следующем блоке тестирования:

Пример форматирования кода

будут сохранены верстальщиком, если задан параметр Никогда не объединять строки, поэтому вывод будет отформатирован следующим образом:

Код, отформатированный с помощью
параметра Никогда не объединять строки

Для того чтобы активировать это поведение, отметьте параметр Никогда не объединять строки на вкладках Перенос строк и Комментарии страницы параметров Верстальщик Java.

Связанные концепции

Редактор Java
Средства разработки на Java (JDT)

Связанные справочники

Меню Правка
Параметры редактора Java
Параметры верстальщика