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

public abstract class Format extends Object implements Serializable, Cloneable

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

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

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

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

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

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

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.

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

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