java.util.spi

Класс LocaleServiceProvider

java.lang. Объект

java.util.spi. LocaleServiceProvider

Прямые Известные Подклассы:

BreakIteratorProvider, CollatorProvider, CurrencyNameProvider, DateFormatProvider, DateFormatSymbolsProvider, DecimalFormatSymbolsProvider, LocaleNameProvider, NumberFormatProvider, TimeZoneNameProvider

public abstract class LocaleServiceProvider
extends Object

Это - класс высшего качества всей локали чувствительные интерфейсы поставщика услуг (SPI).

Чувствительные интерфейсы поставщика услуг локали являются интерфейсами, которые соответствуют локали чувствительные классы в java.text и java.util пакеты. Интерфейсы включают конструкции локали чувствительные объекты и извлечение локализованных имен для этих пакетов. Локаль чувствительные методы фабрики и методы для извлечения имени в java.text и java.util пакеты используют реализации интерфейсов провайдера, чтобы предложить поддержку локалей вне набора локалей, поддерживаемых средой выполнения Java непосредственно.

Упаковка Локали Чувствительные Реализации Поставщика услуг

Реализации их локаль чувствительные службы упаковываются, используя Механизм Расширения Java в качестве установленных расширений. Провайдер идентифицирует себя с конфигурационным файлом провайдера в каталоге ресурса, META-INF/services, используя полностью определенное имя класса интерфейса провайдера в качестве имени файла. Файл должен содержать список полностью определенных конкретных имен классов провайдера, один на строку. Строка завершается любым из перевода строки ('\n'), возврат каретки ('\r'), или возврат каретки, сопровождаемый сразу переводом строки. Пространство и символы вкладки, окружающие каждое имя, так же как пустые строки, игнорируются. Символ комментария '#' ('#'); на каждой строке игнорируются все символы после первого символа комментария. Файл должен быть закодирован в UTF-8.

Если определенный конкретный класс провайдера назовут больше чем в одном конфигурационном файле, или будет назван в том же самом конфигурационном файле не раз, то копии будут проигнорированы. Конфигурационный файл, называя определенного провайдера не должен быть в том же самом файле фляги или другом модуле распределения как провайдер непосредственно. Провайдер должен быть доступным от того же самого загрузчика класса, который был первоначально запрошен, чтобы определить местоположение конфигурационного файла; это - не обязательно загрузчик класса, который загрузил файл.

Например, реализация DateFormatProvider класс должен принять форму файла фляги, который содержит файл:

 META-INF/services/java.text.spi.DateFormatProvider
 

И файл java.text.spi.DateFormatProvider должен иметь строку, такую как:

 com.foo.DateFormatProviderImpl
 

который является полностью определенным именем класса реализации класса DateFormatProvider.

Вызов Локали Чувствительные Службы

Локаль чувствительные методы фабрики и методы для извлечения имени в java.text и java.util пакеты вызывают методы поставщика услуг при необходимости, чтобы поддерживать требуемую локаль. Методы сначала проверяют, поддерживает ли сама среда выполнения Java требуемую локаль, и используйте ее поддержку при наличии. Иначе, они вызывают getAvailableLocales() методы установленных провайдеров для соответствующего интерфейса, чтобы найти тот, который поддерживает требуемую локаль. Если такой провайдер находится, его другие методы вызывают, чтобы получить требуемый объект или имя. Проверяя, поддерживается ли локаль, расширения локали игнорируются. Если ни среда выполнения Java непосредственно, ни установленный провайдер не поддерживают требуемую локаль, методы проходят через список локалей кандидата и повторяют проверку доступности для каждого, пока соответствие не находится. Алгоритм, используемый для того, чтобы создать список локалей кандидата, является тем же самым как тот, используемый ResourceBunlde по умолчанию (см. getCandidateLocales для деталей). Даже если локаль разрешается от списка кандидатов, методы, которые возвращают требуемые объекты, или к именам взывают с исходной требуемой локалью включая расширения. Среда выполнения Java должна поддерживать корневую локаль для всей локали чувствительные службы, чтобы гарантировать, что этот процесс завершается.

Провайдерам имен (но не провайдерам других объектов) позволяют возвратить нуль для некоторых запросов имени даже на локали, для которых они утверждают, что поддерживали включением их в их возвращаемом значении getAvailableLocales. Точно так же у самой среды выполнения Java, возможно, нет всех имен для всех локалей, которые она поддерживает. Это - то, потому что наборы объектов, на которые требуют имена, могут быть большими и измениться в течение долгого времени, так, чтобы было не всегда выполнимо покрыть их полностью. Если среда выполнения Java или провайдер возвратят нуль вместо имени, то поиск продолжится как описано выше, как будто локаль не поддерживалась.

С тех пор:

1.6

Сводка конструктора

Конструкторы

Модификатор	Конструктор и Описание
protected	LocaleServiceProvider() Единственный конструктор.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
abstract Locale[]	getAvailableLocales() Возвращает массив всех локалей, для которых этот поставщик услуг локали может обеспечить локализованные объекты или имена.

Методы java.lang унаследованный от класса. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

LocaleServiceProvider

protected LocaleServiceProvider()

Единственный конструктор. (Для вызова конструкторами подкласса, обычно неявными.)

Деталь метода

getAvailableLocales

public abstract Locale[] getAvailableLocales()

Возвращает массив всех локалей, для которых этот поставщик услуг локали может обеспечить локализованные объекты или имена.

Отметьте: Расширения в a Locale игнорируются во время поиска поставщика услуг. Таким образом, массив, возвращенный этим методом, не должен включать два или больше Locale объекты, только отличающиеся по их расширениям.

Возвраты:

Массив всех локалей, для которых этот поставщик услуг локали может обеспечить локализованные объекты или имена.