Класс Format

public abstract class Format extends Object implements Serializable, Cloneable

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

Format определяет программный интерфейс для форматирования объектов, зависящих от локали, в Strings (метод format) и для разбора Strings обратно в объекты (метод 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.

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

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