Форматирование вывода с помощью класса Formatter

Базовой частью поддержки создания форматированного вывода в языке Java служит класс Formatter, включенный в пакет java.util. Он обеспечивает преобразования формата (format conversions) позволяющие выводить числа, строки и время и даты практически в любом понравившемся вам формате. Класс функционирует подобно функции printf () языков C/C++, а значит, если Вы знакомы с этими языками, научиться использовать класс Formatter будет очень легко. Кроме того, это позволит в будущем упростить преобразование кода на языках C/C++ в исходный код на языке Java. Если Вы не знаете языков C/C++, все равно очень легко освоить форматирование данных.

Кроме класса Formatter в Java 2 версии 5.0 добавлен метод printf () для классов printstream и printwriter. Метод printf () автоматически использует класс Formatter и предлагает функциональные средства почти один к одному совпадающие с возможностями функции printf () языков C/C++, таким образом, облегчая в дальнейшем преобразование кода на C/C++ в код на языке Java.

Замечание

Несмотря на то, что класс Formatter и метод printf() языка Java действуют аналогично функции printf() языков C/C++, у них есть некоторые отличия и новые свойства. Поэтому, даже если Вы знакомы с языками C/C++, советую все же внимательно прочесть эту главу.

Конструкторы класса Formatter

Прежде чем Вы сможете использовать класс Formatter для форматирования

вывода, Вам придется создать объект типа Formatter. В общем, класс Formatter преобразует двоичную форму представления данных, используемых программой, в форматированный текст. Он сохраняет форматированный текст в буфере, содержимое которого Ваша программа может получить в любой нужный момент. Можно предоставить классу Formatter автоматическую поддержку этого буфера, либо явно задать его, когда создается объект класса Formatter. Существует возможность сохранения буфера класса Formatter в файле.

В классе Formatter определено много конструкторов, которые позволяют создавать объекты этого класса различными способами. Далее приведены некоторые их образцы.

Formatter()

Formatter(Appendable buf)

Formatter(Appendable buf, Locale loc)

Formatter(String filename)

throws FileNotFoundException

Formatter(String filename, String charset)

throws FileNotFoundException, unsupportedEncodingException

Formatter(File outF)

throws FileNotFoundException

Formatter(OutStream outStrm)

В приведенных образцах buf задает буфер для форматированного вывода. Если параметр buf равен null, класс Formatter автоматически размещает объект типа StringBuilder для хранения форматированного вывода. Параметр loc определяет региональные и языковые настройки. Если никаких настроек не задано, используются настройки по умолчанию. Параметр filename задаст имя файла, который получит форматированный вывод. Параметр charset определяет кодировку. Если она не задана, используется кодировка, установленная по умолчанию. Параметр outF передаст ссылку на открытый файл, в котором будет храниться форматированный вывод. В параметре outStrm передается ссылка на поток вывода, который будет получать отформатированные данные. Если используется файл, выходные данные также записываются в файл.

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