Format

public abstract class Format extends Object implements Serializable, Cloneable

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

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

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

Создание подклассов

Платформа Java предоставляет специализированные подклассы 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.

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

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