Spec-Zone .ru спецификации, руководства, описания, API

javax.faces
Класс FactoryFinder

java.lang.Object
  javax.faces.FactoryFinder

public final class FactoryFinder
расширяет java.lang. Объект

FactoryFinder реализует стандартный алгоритм открытия для всех объектов фабрики, определенных в API Поверхностей JavaServer. Для данной фабрики имя class соответствующая реализация class разыскивается основанный на следующем алгоритме. Элементы перечисляются в порядке уменьшающегося приоритета поиска:

• Если конфигурационный файл Поверхностей JavaServer, связанный в WEB-INF каталог веб-приложения содержит a factory запись данной фабрики имя class, та фабрика используется.

• Если конфигурационные файлы Поверхностей JavaServer, названные javax.faces.CONFIG_FILES ServletContext параметр init содержит любого factory записи данной фабрики имя class, те фабрики используются с последним имеющим приоритет.

• Если есть какие-либо конфигурационные файлы Поверхностей JavaServer, связанные в META-INF каталог любого раздражает ServletContext's пути ресурса, factory записи данной фабрики имя class в тех файлах используются с последним имеющим приоритет.

• Если a META-INF/services/{factory-class-name} ресурс видим к веб-приложению загрузчик class для вызывающего приложения (обычно в результате присутствования в декларации файла JAR), его первая строка читается и, как предполагают, имя реализации фабрики class, чтобы использовать.

• Если ни один из вышеупомянутых шагов не приводит к соответствию, реализация Поверхностей JavaServer, определенный class используется.

Если у какой-либо из фабрик, найденных на каком-либо из шагов выше, оказывается, есть конструктор с одним параметром с параметром тип, являющийся абстрактной фабрикой class, тот конструктор вызывается, и предыдущее соответствие передают конструктору. Например, говорит контейнерный поставщик, предоставленный реализации FacesContextFactory, и идентифицированный это в META-INF/services/javax.faces.context.FacesContextFactory во фляге на ClassLoder веб-приложения. Также скажите, что у этой реализации, обеспеченной контейнерным поставщиком, был один конструктор параметра, который взял a FacesContextFactory экземпляр. FactoryFinder система вызвала бы того конструктора с одним параметром, передавая реализацию FacesContextFactory если реализацией Поверхностей JavaServer.

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

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

Полевая Сводка

static java.lang.String	APPLICATION_FACTORY Имя свойства для ApplicationFactory Имя class.
static java.lang.String	EXCEPTION_HANDLER_FACTORY Имя свойства для ExceptionHandlerFactory Имя class.
static java.lang.String	EXTERNAL_CONTEXT_FACTORY Имя свойства для ExternalContextFactory Имя class.
static java.lang.String	FACELET_CACHE_FACTORY Имя свойства для FaceletCacheFactory Имя class.
static java.lang.String	FACES_CONTEXT_FACTORY Имя свойства для FacesContextFactory Имя class.
static java.lang.String	LIFECYCLE_FACTORY Имя свойства для LifecycleFactory Имя class.
static java.lang.String	PARTIAL_VIEW_CONTEXT_FACTORY Имя свойства для PartialViewContextFactory Имя class.
static java.lang.String	RENDER_KIT_FACTORY Имя свойства для RenderKitFactory Имя class.
static java.lang.String	TAG_HANDLER_DELEGATE_FACTORY Имя свойства для TagHandlerDelegate Имя class.
static java.lang.String	VIEW_DECLARATION_LANGUAGE_FACTORY Имя свойства для ViewDeclarationLanguage Имя class.
static java.lang.String	VISIT_CONTEXT_FACTORY Имя свойства для VisitContextFactory Имя class.

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

static java.lang.Object	getFactory(java.lang.String factoryName) Создайте (в случае необходимости) и возвратите экземпляр на веб-приложение соответствующей реализации class для указанной фабрики Поверхностей JavaServer class, основанный на алгоритме открытия, описанном в описании class.
static void	releaseFactories() Выпустите любые ссылки на экземпляры фабрики, связанные с загрузчиком class для веб-приложения вызова.
static void	setFactory(java.lang.String factoryName, java.lang.String implName) Этот метод сохранит параметр factoryName/implName отображение таким способом, который getFactory(java.lang.String) найдет это отображение, ища соответствие.

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

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

Полевая Деталь

APPLICATION_FACTORY

public static final java.lang.String APPLICATION_FACTORY

Имя свойства для ApplicationFactory Имя class.

См. Также:

Постоянные Значения полей

EXCEPTION_HANDLER_FACTORY

public static final java.lang.String EXCEPTION_HANDLER_FACTORY

Имя свойства для ExceptionHandlerFactory Имя class.

См. Также:

Постоянные Значения полей

EXTERNAL_CONTEXT_FACTORY

public static final java.lang.String EXTERNAL_CONTEXT_FACTORY

Имя свойства для ExternalContextFactory Имя class.

См. Также:

Постоянные Значения полей

FACES_CONTEXT_FACTORY

public static final java.lang.String FACES_CONTEXT_FACTORY

Имя свойства для FacesContextFactory Имя class.

См. Также:

Постоянные Значения полей

FACELET_CACHE_FACTORY

public static final java.lang.String FACELET_CACHE_FACTORY

Имя свойства для FaceletCacheFactory Имя class.

С тех пор:

2.1

См. Также:

Постоянные Значения полей

PARTIAL_VIEW_CONTEXT_FACTORY

public static final java.lang.String PARTIAL_VIEW_CONTEXT_FACTORY

Имя свойства для PartialViewContextFactory Имя class.

См. Также:

Постоянные Значения полей

VISIT_CONTEXT_FACTORY

public static final java.lang.String VISIT_CONTEXT_FACTORY

Имя свойства для VisitContextFactory Имя class.

См. Также:

Постоянные Значения полей

LIFECYCLE_FACTORY

public static final java.lang.String LIFECYCLE_FACTORY

Имя свойства для LifecycleFactory Имя class.

См. Также:

Постоянные Значения полей

RENDER_KIT_FACTORY

public static final java.lang.String RENDER_KIT_FACTORY

Имя свойства для RenderKitFactory Имя class.

См. Также:

Постоянные Значения полей

VIEW_DECLARATION_LANGUAGE_FACTORY

public static final java.lang.String VIEW_DECLARATION_LANGUAGE_FACTORY

Имя свойства для ViewDeclarationLanguage Имя class.

См. Также:

Постоянные Значения полей

TAG_HANDLER_DELEGATE_FACTORY

public static final java.lang.String TAG_HANDLER_DELEGATE_FACTORY

Имя свойства для TagHandlerDelegate Имя class.

См. Также:

Постоянные Значения полей

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

getFactory

public static java.lang.Object getFactory(java.lang.String factoryName)
                                   throws FacesException

Создайте (в случае необходимости) и возвратите экземпляр на веб-приложение соответствующей реализации class для указанной фабрики Поверхностей JavaServer class, основанный на алгоритме открытия, описанном в описании class.

Стандартные фабрики и обертки в JSF вся реализация интерфейс FacesWrapper. Если возвращенный Object реализация одной из стандартных фабрик, должно быть законно бросить это к экземпляру FacesWrapper и вызовите FacesWrapper#getWrapped на экземпляре.

Параметры:

factoryName - Полностью определенное имя фабрики Поверхностей JavaServer, на которую требуют экземпляр реализации

Броски:

FacesException - если веб-приложение загрузчик class не может быть идентифицировано

FacesException - если экземпляр сконфигурированной реализации фабрики class не может быть загружен

FacesException - если экземпляр сконфигурированной реализации фабрики class нельзя инстанцировать

IllegalArgumentException - если factoryName не идентифицирует стандартное имя фабрики Поверхностей JavaServer

IllegalStateException - если нет никакой сконфигурированной реализации фабрики class для указанного имени фабрики

java.lang.NullPointerException - если factoryname нуль

setFactory

public static void setFactory(java.lang.String factoryName,
                              java.lang.String implName)

Этот метод сохранит параметр factoryName/implName отображение таким способом, который getFactory(java.lang.String) найдет это отображение, ища соответствие.

Этот метод не имеет никакого эффекта если getFactory() был уже вызван, ища фабрику для этого factoryName.

Этот метод может использоваться реализациями, чтобы сохранить отображение фабрики, анализируя конфигурационный файл Поверхностей

Броски:

IllegalArgumentException - если factoryName не идентифицирует стандартное имя фабрики Поверхностей JavaServer

java.lang.NullPointerException - если factoryname нуль

releaseFactories

public static void releaseFactories()
                             throws FacesException

Выпустите любые ссылки на экземпляры фабрики, связанные с загрузчиком class для веб-приложения вызова. Во время этого метода нужно вызвать завершения работы веб-приложения.

Броски:

FacesException - если веб-приложение загрузчик class не может быть идентифицировано