Формат класса

public abstract class Format extends Object implements Serializable, Cloneable

Format — это абстрактный базовый класс для форматирования информации, зависящей от локали, такой как даты, сообщения, числа и списки.

Format определяет программный интерфейс для форматирования локализованных объектов в String (метод format) и для разбора String обратно в объекты (метод parseObject).

Обычно метод parseObject формата должен уметь анализировать любую строку, отформатированную его методом format. Однако могут быть исключительные случаи, когда это невозможно. Например, метод format может создавать два соседних целых числа без разделителя, и в этом случае метод parseObject не сможет определить, какие цифры относятся к какому числу.

Наследование

Java Platform предоставляет специализированные подклассы Format — DateFormat, MessageFormat, NumberFormat и ListFormat — для форматирования дат, сообщений, чисел и списков соответственно.

Конкретные подклассы должны реализовать три метода:

1. format(Object obj, StringBuffer toAppendTo, FieldPosition pos)
2. formatToCharacterIterator(Object obj)
3. parseObject(String source, ParsePosition pos)

Эти общие методы позволяют полиморфный разбор и форматирование объектов и используются, например, в MessageFormat. Подклассы часто также предоставляют дополнительные format методы для определённых типов входных данных, а также parse методы для определённых типов выходных данных. Любой метод parse, который не принимает аргумент ParsePosition, должен выбрасывать ParseException, когда в начале входного текста нет текста в требуемом формате.

Большинство подклассов также будут реализовывать следующие фабричные методы:

1. getInstance для получения полезного объекта формата, соответствующего текущей локали
2. getInstance(Locale) для получения полезного объекта формата, соответствующего указанной локали

Кроме того, некоторые подклассы могут также реализовать другие getXxxxInstance методы для более специализированного управления. Например, класс NumberFormat предоставляет методы getPercentInstance и getCurrencyInstance для получения специализированных форматирователей чисел.

Подклассы Format, которые позволяют программистам создавать объекты для локалей (с getInstance(Locale), например), должны также реализовать следующий класс-метод:

 public static Locale[] getAvailableLocales()
 

Подклассы также могут рассмотреть возможность реализации гибкости при разборе. Определение гибкости должно быть делегировано подклассу.

И, наконец, подклассы могут определить набор констант для идентификации различных полей в отформатированном выводе. Эти константы используются для создания объекта FieldPosition, который определяет информацию, содержащуюся в поле, и его положение в отформатированном результате. Эти константы должны называться item_FIELD, где item идентифицирует поле. Примеры этих констант см. в ERA_FIELD и его друзьях в DateFormat.

Синхронизация

Форматы обычно не синхронизированы. Рекомендуется создавать отдельные экземпляры формата для каждого потока. Если несколько потоков одновременно обращаются к формату, он должен быть синхронизирован внешне.