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

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 — для форматирования дат, сообщений и чисел соответственно.

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

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.

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

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