Класс ChoiceFormat

public class ChoiceFormat extends NumberFormat

Класс ChoiceFormat позволяет привязать формат к диапазону чисел. Он обычно используется в MessageFormat для обработки множественных форм. Выбор задается возрастающим списком double, где каждый элемент определяет полуоткрытый интервал до следующего элемента:

 X matches j if and only if limit[j] ≤ X < limit[j+1]
 

Если совпадений нет, то используется либо первый, либо последний индекс, в зависимости от того, слишком ли мало или слишком велико число (X). Если массив пределов не отсортирован по возрастанию, результаты форматирования будут некорректными. ChoiceFormat также принимает \u221E как эквивалент бесконечности (INF).

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

При создании объекта ChoiceFormat, необходимо указать массив форматов и массив пределов. Длина этих массивов должна быть одинаковой. Например,

• пределы = {1,2,3,4,5,6,7}
  форматы = {"Вс","Пн","Вт","Ср","Чт","Пт","Сб"}
• пределы = {0, 1, ChoiceFormat.nextDouble(1)}
  форматы = {"нет файлов", "один файл", "множество файлов"}
  (nextDouble можно использовать для получения следующего большего double, чтобы создать полуоткрытый интервал.)

Вот простой пример, который демонстрирует форматирование и разбор:

double[] limits = {1,2,3,4,5,6,7};
String[] dayOfWeekNames = {"Sun","Mon","Tue","Wed","Thur","Fri","Sat"};
ChoiceFormat form = new ChoiceFormat(limits, dayOfWeekNames);
ParsePosition status = new ParsePosition(0);
for (double i = 0.0; i <= 8.0; ++i) {
    status.setIndex(0);
    System.out.println(i + " -> " + form.format(i) + " -> "
                             + form.parse(form.format(i),status));
}

Вот более сложный пример с форматом шаблона:

double[] filelimits = {0,1,2};
String[] filepart = {"are no files","is one file","are {2} files"};
ChoiceFormat fileform = new ChoiceFormat(filelimits, filepart);
Format[] testFormats = {fileform, null, NumberFormat.getInstance()};
MessageFormat pattform = new MessageFormat("There {0} on {1}");
pattform.setFormats(testFormats);
Object[] testArgs = {null, "ADisk", null};
for (int i = 0; i < 4; ++i) {
    testArgs[0] = Integer.valueOf(i);
    testArgs[2] = testArgs[0];
    System.out.println(pattform.format(testArgs));
}

Задание шаблона для объектов ChoiceFormat довольно просто. Например:

ChoiceFormat fmt = new ChoiceFormat(
     "-1#is negative| 0#is zero or fraction | 1#is one |1.0<is 1+ |2#is two |2<is more than 2.");
System.out.println("Formatter Pattern : " + fmt.toPattern());

System.out.println("Format with -INF : " + fmt.format(Double.NEGATIVE_INFINITY));
System.out.println("Format with -1.0 : " + fmt.format(-1.0));
System.out.println("Format with 0 : " + fmt.format(0));
System.out.println("Format with 0.9 : " + fmt.format(0.9));
System.out.println("Format with 1.0 : " + fmt.format(1));
System.out.println("Format with 1.5 : " + fmt.format(1.5));
System.out.println("Format with 2 : " + fmt.format(2));
System.out.println("Format with 2.1 : " + fmt.format(2.1));
System.out.println("Format with NaN : " + fmt.format(Double.NaN));
System.out.println("Format with +INF : " + fmt.format(Double.POSITIVE_INFINITY));

А результат вывода будет примерно таким:

 Format with -INF : is negative
 Format with -1.0 : is negative
 Format with 0 : is zero or fraction
 Format with 0.9 : is zero or fraction
 Format with 1.0 : is one
 Format with 1.5 : is 1+
 Format with 2 : is two
 Format with 2.1 : is more than 2.
 Format with NaN : is negative
 Format with +INF : is more than 2.
 

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

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