Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
ПРЕДЫДУЩИЙ СЛЕДУЮЩИЙ КЛАСС КЛАССА | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
java.lang.Object javax.faces.application.Application
public abstract class Application
Приложение представляет одноэлементный объект на веб-приложение, где приложения, основанные на Поверхностях JavaServer (или реализации, желающие обеспечить расширенную функциональность), могут зарегистрировать одиночные элементы всего приложения, которые обеспечивают функциональность, требуемую Поверхностями JavaServer. Реализации по умолчанию каждого объекта обеспечиваются для случаев, где приложение не хочет настраивать поведение.
Экземпляр Application
создается, вызывая getApplication()
метод ApplicationFactory
. Поскольку этот экземпляр совместно используется, он должен быть реализован ориентированным на многопотоковое исполнение способом.
Приложение также действует как фабрика для нескольких типов Объектов, определенных в Конфигурационном файле Поверхностей. Пожалуйста, см. Application#createComponent
, Application#createConverter
, и Application#createValidator
.
Сводка конструктора | |
---|---|
Application()
|
Сводка метода | ||
---|---|---|
void |
addBehavior(java.lang.String behaviorId, java.lang.String behaviorClass)
Зарегистрируйте новое отображение идентификатора поведения к имени соответствия Behavior class. |
|
abstract void |
addComponent(java.lang.String componentType, java.lang.String componentClass)
Зарегистрируйте новое отображение компонентного типа к имени соответствия UIComponent class. |
|
abstract void |
addConverter(java.lang.Class<?> targetClass, java.lang.String converterClass)
Зарегистрируйте новый преобразователь class, который способен к выполнению преобразований для указанного целевого class. |
|
abstract void |
addConverter(java.lang.String converterId, java.lang.String converterClass)
Зарегистрируйте новое отображение идентификатора преобразователя к имени соответствия Converter class. |
|
void |
addDefaultValidatorId(java.lang.String validatorId)
Зарегистрируйте блок проверки допустимости его идентификатором, который применяется ко всем |
|
void |
addELContextListener(ELContextListener listener)
Обеспечьте путь к приложениям Поверхностей, чтобы зарегистрироваться ELContextListener это будет уведомлено относительно создания ELContext экземпляры. |
|
void |
addELResolver(ELResolver resolver)
Вызовите параметр resolver быть добавленным к цепочке преобразователя как определено в разделе JSF.5.5.1 Спецификации Поверхностей JavaServer. |
|
abstract void |
addValidator(java.lang.String validatorId, java.lang.String validatorClass)
Зарегистрируйте новое отображение идентификатора блока проверки допустимости к имени соответствия Validator class. |
|
Поведение |
createBehavior(java.lang.String behaviorId)
Инстанцируйте и возвратите новое Behavior экземпляр class определяется предыдущим звонком addBehavior() для указанного идентификатора поведения. |
|
UIComponent |
createComponent(FacesContext context, Resource componentResource)
Инстанцируйте и возвратите новое |
|
UIComponent |
createComponent(FacesContext context, java.lang.String componentType, java.lang.String rendererType)
Как |
|
abstract UIComponent |
createComponent(java.lang.String componentType)
Инстанцируйте и возвратите новое UIComponent экземпляр class определяется предыдущим звонком addComponent() для указанного компонентного типа. |
|
abstract UIComponent |
createComponent(ValueBinding componentBinding, FacesContext context, java.lang.String componentType)
Осуждаемый. Это было заменено createComponent(javax.el.ValueExpression,javax.faces.context.FacesContext,java.lang.String) . |
|
UIComponent |
createComponent(ValueExpression componentExpression, FacesContext context, java.lang.String componentType)
Вызовите getValue() метод на указанном ValueExpression . |
|
UIComponent |
createComponent(ValueExpression componentExpression, FacesContext context, java.lang.String componentType, java.lang.String rendererType)
Как |
|
abstract Converter |
createConverter(java.lang.Class<?> targetClass)
Инстанцируйте и возвратите новое Converter экземпляр class, который зарегистрировал себя как способный к выполнению преобразований для объектов указанного типа. |
|
abstract Converter |
createConverter(java.lang.String converterId)
Инстанцируйте и возвратите новое Converter экземпляр class определяется предыдущим звонком addConverter() для указанного идентификатора преобразователя. |
|
abstract MethodBinding |
createMethodBinding(java.lang.String ref, java.lang.Class<?>[] params)
Осуждаемый. Это было заменено, вызывая getExpressionFactory() тогда ExpressionFactory#createMethodExpression . |
|
abstract Validator |
createValidator(java.lang.String validatorId)
Инстанцируйте и возвратите новое Validator экземпляр class определяется предыдущим звонком addValidator() для указанного идентификатора блока проверки допустимости. |
|
abstract ValueBinding |
createValueBinding(java.lang.String ref)
Осуждаемый. Это было заменено, вызывая getExpressionFactory() тогда ExpressionFactory#createValueExpression . |
|
|
evaluateExpressionGet(FacesContext context, java.lang.String expression, java.lang.Class<? extends T> expectedType)
Получите значение, оценивая выражение. |
|
abstract ActionListener |
getActionListener()
Возвратите значение по умолчанию ActionListener быть зарегистрированным для всех ActionSource компоненты в этом appication. |
|
java.util.Iterator<java.lang.String> |
getBehaviorIds()
Возвратитесь Iterator по набору в настоящий момент зарегистрированных идентификаторов поведения для этого Application . |
|
abstract java.util.Iterator<java.lang.String> |
getComponentTypes()
Возвратитесь Iterator по набору в настоящий момент определенного компонента вводит для этого Application . |
|
abstract java.util.Iterator<java.lang.String> |
getConverterIds()
Возвратитесь Iterator по набору в настоящий момент зарегистрированных идентификаторов преобразователя для этого Application . |
|
abstract java.util.Iterator<java.lang.Class<?>> |
getConverterTypes()
Возвратитесь Iterator по набору Class экземпляры те, для который Converter классы были явно зарегистрированы. |
|
abstract java.util.Locale |
getDefaultLocale()
Возвратите значение по умолчанию Locale для этого приложения. |
|
abstract java.lang.String |
getDefaultRenderKitId()
Возвратитесь renderKitId использоваться для того, чтобы представить это приложение. |
|
java.util.Map<java.lang.String,java.lang.String> |
getDefaultValidatorInfo()
Возвратите неизменное |
|
ELContextListener[] |
getELContextListeners()
Если никакие вызовы не были выполнены к addELContextListener(javax.el.ELContextListener) , этот метод должен возвратить пустой массив. |
|
ELResolver |
getELResolver()
Возвратите одиночный элемент ELResolver экземпляр, который будет использоваться для всего ЭЛЬ разрешения. |
|
ExpressionFactory |
getExpressionFactory()
Возвратитесь ExpressionFactory экземпляр для этого приложения. |
|
abstract java.lang.String |
getMessageBundle()
Возвратите полностью определенное имя class ResourceBundle использоваться для Поверхностей JavaServer обменивается сообщениями для этого приложения. |
|
abstract NavigationHandler |
getNavigationHandler()
Возвратитесь NavigationHandler экземпляр, который передадут результат, возвращенный любым вызванным действием приложения для этого веб-приложения. |
|
ProjectStage |
getProjectStage()
Возвратите этап проекта для в настоящий момент рабочего экземпляра приложения. |
|
abstract PropertyResolver |
getPropertyResolver()
Осуждаемый. Это было заменено getELResolver() . |
|
java.util.ResourceBundle |
getResourceBundle(FacesContext ctx, java.lang.String name)
Найдите a ResourceBundle как определено в ресурсах конфигурации приложения под указанным именем. |
|
ResourceHandler |
getResourceHandler()
Возвратите одиночный элемент, не сохраняющий состояние, ориентированный на многопотоковое исполнение |
|
abstract StateManager |
getStateManager()
Возвратитесь StateManager экземпляр, который будет использоваться во время Представления Восстановления и Представит фазы Ответа жизненного цикла обработки запросов. |
|
abstract java.util.Iterator<java.util.Locale> |
getSupportedLocales()
Возвратитесь Iterator по поддерживаемому Locale s для этого appication. |
|
abstract java.util.Iterator<java.lang.String> |
getValidatorIds()
Возвратитесь Iterator по набору в настоящий момент зарегистрированных идентификаторов блока проверки допустимости для этого Application . |
|
abstract VariableResolver |
getVariableResolver()
Осуждаемый. Это было заменено getELResolver() . |
|
abstract ViewHandler |
getViewHandler()
Возвратитесь ViewHandler экземпляр, который будет использоваться во время Представления Восстановления и Представит фазы Ответа жизненного цикла обработки запросов. |
|
void |
publishEvent(FacesContext context, java.lang.Class<? extends SystemEvent> systemEventClass, java.lang.Class<?> sourceBaseType, java.lang.Object source)
Этот метод функционирует точно как |
|
void |
publishEvent(FacesContext context, java.lang.Class<? extends SystemEvent> systemEventClass, java.lang.Object source)
Если |
|
void |
removeELContextListener(ELContextListener listener)
Удалите параметр listener от списка ELContextListener s. |
|
abstract void |
setActionListener(ActionListener listener)
Установите значение по умолчанию ActionListener быть зарегистрированным для всех ActionSource компоненты. |
|
abstract void |
setDefaultLocale(java.util.Locale locale)
Установите значение по умолчанию Locale для этого приложения. |
|
abstract void |
setDefaultRenderKitId(java.lang.String renderKitId)
Установите renderKitId использоваться, чтобы представить это приложение. |
|
abstract void |
setMessageBundle(java.lang.String bundle)
Определите полностью определенное имя class ResourceBundle использоваться для Поверхностей JavaServer обменивается сообщениями для этого приложения. |
|
abstract void |
setNavigationHandler(NavigationHandler handler)
Установите NavigationHandler экземпляр, который передадут результат, возвращенный любым вызванным действием приложения для этого веб-приложения. |
|
abstract void |
setPropertyResolver(PropertyResolver resolver)
Осуждаемый. Рекомендуемый способ влиять на выполнение ЭЛЬ состоит в том, чтобы обеспечить <el-resolver> элемент в правильном месте в ресурсах конфигурации приложения, которые рассмотрят в нормальном ходе вычисления выражения. Этот метод теперь вызовет параметр resolver быть обернутым в реализации ELResolver и представленный ЭЛЬ системе разрешения, как будто пользователь вызвал addELResolver(javax.el.ELResolver) . |
|
void |
setResourceHandler(ResourceHandler resourceHandler)
Установите |
|
abstract void |
setStateManager(StateManager manager)
Установите StateManager экземпляр, который будет использоваться во время Представления Восстановления и Представит фазы Ответа жизненного цикла обработки запросов. |
|
abstract void |
setSupportedLocales(java.util.Collection<java.util.Locale> locales)
Установите Locale экземпляры, представляющие поддерживаемый Locale s для этого приложения. |
|
abstract void |
setVariableResolver(VariableResolver resolver)
Осуждаемый. Рекомендуемый способ влиять на выполнение ЭЛЬ состоит в том, чтобы обеспечить <el-resolver> элемент в правильном месте в ресурсах конфигурации приложения, которые рассмотрят в нормальном ходе вычисления выражения. Этот метод теперь вызовет параметр resolver быть обернутым в реализации ELResolver и представленный ЭЛЬ системе разрешения, как будто пользователь вызвал addELResolver(javax.el.ELResolver) . |
|
abstract void |
setViewHandler(ViewHandler handler)
Установите ViewHandler экземпляр, который будет использоваться во время Представления Восстановления и Представит фазы Ответа жизненного цикла обработки запросов. |
|
void |
subscribeToEvent(java.lang.Class<? extends SystemEvent> systemEventClass, java.lang.Class<?> sourceClass, SystemEventListener listener)
Установите экземпляр слушателя, на который ссылается параметр |
|
void |
subscribeToEvent(java.lang.Class<? extends SystemEvent> systemEventClass, SystemEventListener listener)
Установите экземпляр слушателя, на который ссылается параметр |
|
void |
unsubscribeFromEvent(java.lang.Class<? extends SystemEvent> systemEventClass, java.lang.Class<?> sourceClass, SystemEventListener listener)
Удалите экземпляр слушателя, на который ссылается параметр |
|
void |
unsubscribeFromEvent(java.lang.Class<? extends SystemEvent> systemEventClass, SystemEventListener listener)
Удалите экземпляр слушателя, на который ссылается параметр |
Методы, наследованные от class java.lang. Объект |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Деталь конструктора |
---|
public Application()
Деталь метода |
---|
public abstract ActionListener getActionListener()
Возвратите значение по умолчанию ActionListener
быть зарегистрированным для всех ActionSource
компоненты в этом appication. Если явно не установлено реализация по умолчанию должна быть то, при условии, что выполняет следующие функции:
processAction()
метод должен сначала вызвать FacesContext.renderResponse()
чтобы обойти любые прошедшие фазы жизненного цикла, когда-то метод возвращается.processAction()
метод должен затем определить логический результат этого события, следующим образом: null
action
свойство, получите MethodBinding
от свойства, и вызова invoke()
на этом. Преобразуйте возвращенное значение (если любой) к Строке, и используйте его в качестве логического результата.null
.processAction()
метод должен наконец получить NavigationHandler
экземпляр для этого приложения и вызова NavigationHandler#handleNavigation
передача: FacesContext
для текущего запросаMethodBinding
экземпляр для action
свойство этого компонента, результат вызова MethodBinding#getExpressionString
на этом, нуль иначеОтметьте что спецификация значением по умолчанию ActionListener
contiues, чтобы призвать к использованию осуждаемого свойства (action
) и class (MethodBinding
). К сожалению, это необходимо потому что значение по умолчанию ActionListener
должен продолжать работать с компонентами, которые не реализуют ActionSource2
, и только реализация ActionSource
.
public abstract void setActionListener(ActionListener listener)
Установите значение по умолчанию ActionListener
быть зарегистрированным для всех ActionSource
компоненты.
listener
- Новое значение по умолчанию ActionListener
java.lang.NullPointerException
- если listener
null
public abstract java.util.Locale getDefaultLocale()
Возвратите значение по умолчанию Locale
для этого приложения. Если явно не установлено, null
возвращается.
public abstract void setDefaultLocale(java.util.Locale locale)
Установите значение по умолчанию Locale
для этого приложения.
locale
- Новое значение по умолчанию Locale
java.lang.NullPointerException
- если locale
null
public abstract java.lang.String getDefaultRenderKitId()
Возвратитесь renderKitId
использоваться для того, чтобы представить это приложение. Если явно не установлено, null
возвращается.
public abstract void setDefaultRenderKitId(java.lang.String renderKitId)
Установите renderKitId
использоваться, чтобы представить это приложение. Если клиент не обеспечил пользовательское ViewHandler
это поддерживает использование многократных RenderKit
экземпляры в том же самом приложении, этот метод нужно только вызвать при запуске приложения, прежде, чем любые запросы Поверхностей были обработаны. Это - ограничение текущей Спецификации, и может быть снято в будущем выпуске.
public abstract java.lang.String getMessageBundle()
Возвратите полностью определенное имя class ResourceBundle
использоваться для Поверхностей JavaServer обменивается сообщениями для этого приложения. Если явно не установлено, null
возвращается.
public abstract void setMessageBundle(java.lang.String bundle)
Определите полностью определенное имя class ResourceBundle
использоваться для Поверхностей JavaServer обменивается сообщениями для этого приложения. См. JavaDocs для java.util.ResourceBundle
class для получения дополнительной информации о синтаксисе для ресурса связывает имена.
bundle
- Базовое имя ресурса связывается, чтобы использоваться java.lang.NullPointerException
- если bundle
null
public abstract NavigationHandler getNavigationHandler()
Возвратитесь NavigationHandler
экземпляр, который передадут результат, возвращенный любым вызванным действием приложения для этого веб-приложения. Если явно не установлено реализация по умолчанию должна быть то, при условии, что выполняет функции, описанные в NavigationHandler
Описание class.
public abstract void setNavigationHandler(NavigationHandler handler)
Установите NavigationHandler
экземпляр, который передадут результат, возвращенный любым вызванным действием приложения для этого веб-приложения.
handler
- Новое NavigationHandler
экземпляр java.lang.NullPointerException
- если handler
null
public ResourceHandler getResourceHandler()
Возвратите одиночный элемент, не сохраняющий состояние, ориентированный на многопотоковое исполнение ResourceHandler
для этого приложения. Реализация JSF должна поддерживать следующие методы для того, чтобы объявить альтернативную реализацию ResourceHandler
.
ResourceHandler
реализация объявляется в ресурсах конфигурации приложения, давая полностью определенное имя class как значение <resource-handler>
элемент в пределах <application>
элемент.
Во всех вышеупомянутых случаях время выполнения должно использовать шаблон "декоратор" что касается любого сменного артефакта в JSF.
Реализация по умолчанию то, при условии, что броски UnsupportedOperationException
так, чтобы пользователи, которые украшают Application
может продолжать функционировать
public void setResourceHandler(ResourceHandler resourceHandler)
Установите ResourceHandler
экземпляр, который будет использоваться для того, чтобы представить разметку для ресурсов, и для того, чтобы удовлетворить клиентские запросы, чтобы подать ресурсы.
resourceHandler
- Новое ResourceHandler
экземпляр IllegalStateException
- если этот метод вызывают после того, как по крайней мере один запрос был обработан Lifecycle
экземпляр для этого приложения. java.lang.NullPointerException
- если resourceHandler
null
public abstract PropertyResolver getPropertyResolver()
getELResolver()
.
Возвратите a PropertyResolver
экземпляр, который переносится ELResolver
экземпляр, который Поверхности обеспечивают для объединенного ЭЛЬ для разрешения выражений, которые появляются программно в приложении.
Отметьте, что это больше не возвращает значение по умолчанию PropertyResolver
с тех пор, что class теперь не, который помогает в разрешении пользовательского PropertyResolver
s, чтобы влиять на ЭЛЬ процесс разрешения.
public abstract void setPropertyResolver(PropertyResolver resolver)
<el-resolver>
элемент в правильном месте в ресурсах конфигурации приложения, которые рассмотрят в нормальном ходе вычисления выражения. Этот метод теперь вызовет параметр resolver
быть обернутым в реализации ELResolver
и представленный ЭЛЬ системе разрешения, как будто пользователь вызвал addELResolver(javax.el.ELResolver)
.
Установите PropertyResolver
экземпляр, который будет использоваться, чтобы разрешить привязка значения и метод.
Этот метод теперь осуждается, но реализация должна заставить параметр быть установленным как глава наследства PropertyResolver
цепочка, заменяя любое существующее значение, которое было установлено от ресурсов конфигурации приложения.
Это недопустимо, чтобы вызвать этот метод после того, как приложение получило любые запросы от клиента. Если попытка предпринимается, чтобы зарегистрировать слушателя после того времени, это не должно иметь никакого эффекта.
resolver
- Новое PropertyResolver
экземпляр java.lang.NullPointerException
- если resolver
null
IllegalStateException
- если вызвано после первого запроса к FacesServlet
был обслужен.public java.util.ResourceBundle getResourceBundle(FacesContext ctx, java.lang.String name)
Найдите a ResourceBundle
как определено в ресурсах конфигурации приложения под указанным именем. Если a ResourceBundle
был определен для имени, возвратите экземпляр, который использует локаль тока UIViewRoot
.
Броски реализации по умолчанию UnsupportedOperationException
и обеспечивается в единственной цели не повреждения существующих приложений, которые расширяют этот class.
ResourceBundle
для текущего UIViewRoot, иначе нуль FacesException
- если пакет был определен, но не разрешимый java.lang.NullPointerException
- если ctx == нуль || называют == нульpublic ProjectStage getProjectStage()
Возвратите этап проекта для в настоящий момент рабочего экземпляра приложения. Значение по умолчанию ProjectStage#Production
Реализация этого метода должна выполнить следующий алгоритм или эквивалент с тем же самым конечным результатом, чтобы определить значение, чтобы возвратиться.
Если значение было уже определено предыдущим звонком в этот метод, просто возвратите то значение.
Ищите a JNDI
запись среды под ключом, данным значением ProjectStage#PROJECT_STAGE_JNDI_NAME
(возвратите тип java.lang.String
). Если найдено, продолжайте с алгоритмом ниже, иначе, ищите запись в initParamMap
из ExternalContext
от тока FacesContext
с ключом, данным значением ProjectStage#PROJECT_STAGE_PARAM_NAME
Если значение находится, см., может ли перечислимая константа быть получена, вызывая ProjectStage.valueOf()
, передача значения от initParamMap
. Если это успешно выполняется без исключения, сохраните значение и возвратите его.
Если не найденный, или какая-либо из предыдущих попыток обнаружить перечислимую постоянную величину перестали работать, зарегистрируйте дескриптивное сообщение об ошибке, присвойте значение как ProjectStage.Production
и возвратите это.
Реализация по умолчанию то, при условии, что броски UnsupportedOperationException
так, чтобы пользователи, которые украшают Application
может продолжать функционировать
public abstract VariableResolver getVariableResolver()
getELResolver()
.
Возвратитесь VariableResolver
это переносится ELResolver
экземпляр, который Поверхности обеспечивают для объединенного ЭЛЬ для разрешения выражений, которые появляются программно в приложении. Реализация VariableResolver
должен передать null
поскольку основной параметр за любые методы вызывается на базовое ELResolver
.
Отметьте, что этот метод больше не возвращает значение по умолчанию VariableResolver
, с тех пор, что class теперь не, который помогает в разрешении пользовательского VariableResolver
s, чтобы влиять на ЭЛЬ процесс разрешения.
public abstract void setVariableResolver(VariableResolver resolver)
<el-resolver>
элемент в правильном месте в ресурсах конфигурации приложения, которые рассмотрят в нормальном ходе вычисления выражения. Этот метод теперь вызовет параметр resolver
быть обернутым в реализации ELResolver
и представленный ЭЛЬ системе разрешения, как будто пользователь вызвал addELResolver(javax.el.ELResolver)
.
Установите VariableResolver
экземпляр, с которым будут консультироваться, чтобы разрешить привязка значения и метод.
Этот метод теперь осуждается, но реализация должна заставить параметр быть установленным как глава наследства VariableResolver
цепочка, заменяя любое существующее значение, которое было установлено от ресурсов конфигурации приложения.
Это недопустимо, чтобы вызвать этот метод после того, как приложение получило любые запросы от клиента. Если попытка предпринимается, чтобы зарегистрировать слушателя после того времени, это не должно иметь никакого эффекта.
resolver
- Новое VariableResolver
экземпляр java.lang.NullPointerException
- если resolver
null
IllegalStateException
- если вызвано после первого запроса к FacesServlet
был обслужен.public void addELResolver(ELResolver resolver)
Вызовите параметр resolver
быть добавленным к цепочке преобразователя как определено в разделе JSF.5.5.1 Спецификации Поверхностей JavaServer.
Не возможно удалить ELResolver
зарегистрированный в этом методе, как только это было зарегистрировано.
Это недопустимо, чтобы зарегистрироваться ELResolver
после того, как приложение получило любые запросы от клиента. Если попытка предпринимается, чтобы зарегистрировать слушателя после того времени, IllegalStateException
должен быть брошен. Это ограничение должно на месте позволить контейнеру JSP оптимизировать для общего падежа где не дополнительный ELResolver
s находятся в цепочке кроме стандартных. Допустимо добавить ELResolver
s прежде или после инициализации к a CompositeELResolver
это уже находится в цепочке.
Броски реализации по умолчанию UnsupportedOperationException
и обеспечивается в единственной цели не повреждения существующих приложений, которые расширяются Application
.
IllegalStateException
- если вызвано после первого запроса к FacesServlet
был обслужен.public ELResolver getELResolver()
Возвратите одиночный элемент ELResolver
экземпляр, который будет использоваться для всего ЭЛЬ разрешения. Это - фактически экземпляр CompositeELResolver
это должно содержать следующий ELResolver
экземпляры в следующем порядке:
ELResolver
экземпляры объявили использование <эль преобразователь> элемент в ресурсах конфигурации приложения.
implementation
это обертывает главу наследства VariableResolver
цепочка, согласно разделу VariableResolver ChainWrapper в Главе JSF.5 в документе спецификации.
implementation
это обертывает главу наследства PropertyResolver
цепочка, согласно разделу PropertyResolver ChainWrapper в Главе JSF.5 в документе спецификации.
Любой ELResolver
экземпляры добавили звонками addELResolver(javax.el.ELResolver)
.
Броски реализации по умолчанию UnsupportedOperationException
и обеспечивается в единственной цели не повреждения существующих приложений, которые расширяются Application
.
public abstract ViewHandler getViewHandler()
Возвратитесь ViewHandler
экземпляр, который будет использоваться во время Представления Восстановления и Представит фазы Ответа жизненного цикла обработки запросов. Если явно не установлено реализация по умолчанию должна быть то, при условии, что выполняет функции, описанные в ViewHandler
описание в Спецификации Поверхностей JavaServer.
public abstract void setViewHandler(ViewHandler handler)
Установите ViewHandler
экземпляр, который будет использоваться во время Представления Восстановления и Представит фазы Ответа жизненного цикла обработки запросов.
handler
- Новое ViewHandler
экземпляр IllegalStateException
- если этот метод вызывают после того, как по крайней мере один запрос был обработан Lifecycle
экземпляр для этого приложения. java.lang.NullPointerException
- если handler
null
public abstract StateManager getStateManager()
Возвратитесь StateManager
экземпляр, который будет использоваться во время Представления Восстановления и Представит фазы Ответа жизненного цикла обработки запросов. Если явно не установлено реализация по умолчанию должна быть то, при условии, что выполняет функции, описанные в StateManager
описание в Спецификации Поверхностей JavaServer.
public abstract void setStateManager(StateManager manager)
Установите StateManager
экземпляр, который будет использоваться во время Представления Восстановления и Представит фазы Ответа жизненного цикла обработки запросов.
manager
- Новое StateManager
экземпляр IllegalStateException
- если этот метод вызывают после того, как по крайней мере один запрос был обработан Lifecycle
экземпляр для этого приложения. java.lang.NullPointerException
- если manager
null
public void addBehavior(java.lang.String behaviorId, java.lang.String behaviorClass)
Зарегистрируйте новое отображение идентификатора поведения к имени соответствия Behavior
class. Это позволяет последующие звонки createBehavior()
служить фабрикой для Behavior
экземпляры.
behaviorId
- Идентификатор поведения, который будет зарегистрированbehaviorClass
- Полностью определенное имя class соответствия Behavior
реализация java.lang.NullPointerException
- если behaviorId
или behaviorClass
null
public Behavior createBehavior(java.lang.String behaviorId) throws FacesException
Инстанцируйте и возвратите новое Behavior
экземпляр class определяется предыдущим звонком addBehavior()
для указанного идентификатора поведения.
behaviorId
- Идентификатор поведения, для которого можно создать и возвратить новое Behavior
экземпляр FacesException
- если Behavior
не может быть создан java.lang.NullPointerException
- если behaviorId
null
public java.util.Iterator<java.lang.String> getBehaviorIds()
Возвратитесь Iterator
по набору в настоящий момент зарегистрированных идентификаторов поведения для этого Application
.
public abstract void addComponent(java.lang.String componentType, java.lang.String componentClass)
Зарегистрируйте новое отображение компонентного типа к имени соответствия UIComponent
class. Это позволяет последующие звонки createComponent()
служить фабрикой для UIComponent
экземпляры.
componentType
- Компонентный тип, который будет зарегистрированcomponentClass
- Полностью определенное имя class соответствия UIComponent
реализация java.lang.NullPointerException
- если componentType
или componentClass
null
public abstract UIComponent createComponent(java.lang.String componentType) throws FacesException
Инстанцируйте и возвратите новое UIComponent
экземпляр class определяется предыдущим звонком addComponent()
для указанного компонентного типа.
Прежде, чем компонентный экземпляр возвращается, он должен быть осмотрен для присутствия a ListenerFor
(или ListenersFor
) или ResourceDependency
(или ResourceDependencies
) аннотация. Если какая-либо из этих аннотаций присутствует, действие, перечисленное в ListenerFor
или ResourceDependency
должен быть взят на компоненте, прежде, чем он будет возвращен из этого метода. Эта разновидность createComponent
не должен осмотреть Renderer
для компонента, который будет возвращен для любого из перед упомянутыми аннотациями. Такой контроль является областью createComponent(ValueExpression, FacesContext, String, String)
или createComponent(FacesContext, String, String)
.
componentType
- Компонентный тип, для которого можно создать и возвратить новое UIComponent
экземпляр FacesException
- если a UIComponent
из указанного типа не может быть создан java.lang.NullPointerException
- если componentType
null
public abstract UIComponent createComponent(ValueBinding componentBinding, FacesContext context, java.lang.String componentType) throws FacesException
createComponent(javax.el.ValueExpression,javax.faces.context.FacesContext,java.lang.String)
.
Оберните параметр componentBinding
в реализации ValueExpression
и вызовите через к createComponent(javax.el.ValueExpression,javax.faces.context.FacesContext,java.lang.String)
.
componentBinding
- ValueBinding
представление компонентного значения обязательное выражение (обычно определяемый component
атрибут пользовательского тега)context
- FacesContext
для текущего запросаcomponentType
- Компонентный тип, чтобы создать, если ValueBinding
не возвращает компонентный экземпляр FacesException
- если a UIComponent
не может быть создан java.lang.NullPointerException
- если какой-либо параметр null
public UIComponent createComponent(ValueExpression componentExpression, FacesContext context, java.lang.String componentType) throws FacesException
Вызовите getValue()
метод на указанном ValueExpression
. Если это возвращает a UIComponent
экземпляр, возвратите это как значение этого метода. Если это не делает, инстанцируйте нового UIComponent
экземпляр указанного компонентного типа, передайте новый компонент к setValue()
метод указанного ValueExpression
, и возвратите это.
Прежде, чем компонентный экземпляр возвращается, он должен быть осмотрен для присутствия a ListenerFor
(или ListenersFor
) или ResourceDependency
(или ResourceDependencies
) аннотация. Если какая-либо из этих аннотаций присутствует, действие, перечисленное в ListenerFor
или ResourceDependency
должен быть взят на компоненте, прежде, чем он будет возвращен из этого метода. Эта разновидность createComponent
не должен осмотреть Renderer
для компонента, который будет возвращен для любого из перед упомянутыми аннотациями. Такой контроль является областью createComponent(ValueExpression, FacesContext, String, String)
или createComponent(FacesContext, String, String)
.
componentExpression
- ValueExpression
представление компонентного выражения (обычно определяемый component
атрибут пользовательского тега)context
- FacesContext
для текущего запросаcomponentType
- Компонентный тип, чтобы создать, если ValueExpression
не возвращает компонентный экземпляр FacesException
- если a UIComponent
не может быть создан java.lang.NullPointerException
- если какой-либо параметр null
Реализация по умолчанию то, при условии, что броски UnsupportedOperationException
так, чтобы пользователи, которые украшают Application
может продолжать функционировать.
public UIComponent createComponent(ValueExpression componentExpression, FacesContext context, java.lang.String componentType, java.lang.String rendererType)
Как createComponent(ValueExpression, FacesContext, String)
кроме Renderer
для компонента, который будет возвращен, должен быть осмотрен для аннотаций, упомянутых в createComponent(ValueExpression, FacesContext, String)
как определено в документации для того метода. Renderer
экземпляр, чтобы осмотреть должен быть получен, вызывая FacesContext#getRenderKit
и вызов RenderKit.getRenderer(java.lang.String, java.lang.String)
на результате, передавая параметр componentType
как первый параметр и результат вызова UIComponent#getFamily
на недавно создаваемом компоненте как второй параметр. Если не такой Renderer
может быть найден, сообщение должно быть зарегистрировано с полезным сообщением об ошибке. Иначе, UIComponent#setRendererType
должен быть обращен недавно создаваемый UIComponent
экземпляр, передавая параметр rendererType
как параметр.
Реализация по умолчанию то, при условии, что броски UnsupportedOperationException
так, чтобы пользователи, которые украшают Application
может продолжать функционировать.
componentExpression
- ValueExpression
представление компонентного выражения (обычно определяемый component
атрибут пользовательского тега)context
- FacesContext
для текущего запросаcomponentType
- Компонентный тип, чтобы создать, если ValueExpression
не возвращает компонентный экземплярrendererType
- Тип средства рендеринга Renderer
это представит этот компонент. A null
значение должно быть принято для этого параметра. FacesException
- если a UIComponent
не может быть создан java.lang.NullPointerException
- если любой из параметров componentExpression
, context
, или componentType
null
public UIComponent createComponent(FacesContext context, java.lang.String componentType, java.lang.String rendererType)
Как createComponent(String)
кроме Renderer
для компонента, который будет возвращен, должен быть осмотрен для аннотаций, упомянутых в createComponent(ValueExpression, FacesContext, String)
как определено в документации для того метода. Renderer
экземпляр, чтобы осмотреть должен быть получен, вызывая FacesContext#getRenderKit
и вызов RenderKit.getRenderer(java.lang.String, java.lang.String)
на результате, передавая параметр componentType
как первый параметр и результат вызова UIComponent#getFamily
на недавно создаваемом компоненте как второй параметр. Если не такой Renderer
может быть найден, сообщение должно быть зарегистрировано с полезным сообщением об ошибке. Иначе, UIComponent#setRendererType
должен быть обращен недавно создаваемый UIComponent
экземпляр, передавая параметр rendererType
как параметр.
Реализация по умолчанию то, при условии, что броски UnsupportedOperationException
так, чтобы пользователи, которые украшают Application
может продолжать функционировать
context
- FacesContext
для текущего запросаcomponentType
- Компонентный тип, чтобы создатьrendererType
- Тип средства рендеринга Renderer
это представит этот компонент. A null
значение должно быть принято для этого параметра. FacesException
- если a UIComponent
не может быть создан java.lang.NullPointerException
- если любой из параметров context
, или componentType
null
public UIComponent createComponent(FacesContext context, Resource componentResource)
Инстанцируйте и возвратите новое UIComponent
экземпляр от параметра Resource
. Алгоритм, семантически эквивалентный следующему, должен сопровождаться, чтобы инстанцировать UIComponent
возвратиться.
Получите ссылку на ViewDeclarationLanguage
для этого Application
экземпляр, вызывая ViewHandler#getViewDeclarationLanguage
, передача viewId
найденный, вызывая UIViewRoot.getViewId()
на UIViewRoot
в параметре FacesContext
.
Получите ссылку на составные компонентные метаданные для этого составного компонента, вызывая ViewDeclarationLanguage#getComponentMetadata
, передача facesContext
и componentResource
параметры этому методу. Эта версия спецификации JSF использует JavaBeans в качестве API к компонентным метаданным.
Определите если компонентный автор, объявленный a componentType
для этого компонентного экземпляра, получая BeanDescriptor
от компонентных метаданных и вызова getValue()
метод, передавая UIComponent#COMPOSITE_COMPONENT_TYPE_KEY
как параметр. Если не -null
, результатом должен быть a ValueExpression
чье значение component-type
из UIComponent
создаваться для этого Resource
компонент. Вызовите через к createComponent(java.lang.String)
создать компонент.
Иначе, определите если сценарий базируемый компонент для этого Resource
может быть найден, вызывая ViewDeclarationLanguage#getScriptComponentResource
. Если результат не -null
, и сценарий, записанный на одном из языков, перечисленных в JSF.4.3 документа прозы спецификации, создайте a UIComponent
экземпляр от ресурса сценария.
Иначе, позвольте имени библиотеки быть возвратом из вызова Resource#getLibraryName
на параметре componentResource
и имя ресурса быть возвратом из вызова Resource#getResourceName
на параметре componentResource
. Создайте полностью определенный Java имя class, удаляя любое расширение файла из имени ресурса и позвольте fqcn быть library-name + "." + resource-name
. Если class с именем fqcn не может быть найден, не предпринять меры и продолжаться к следующему шагу. Если любой из InstantiationException
, IllegalAccessException
, или ClassCastException
бросаются, обертывают исключение в a FacesException
и повторно бросьте это. Если какое-либо другое исключение выдается, зарегистрируйте исключение и продолжайте к следующему шагу.
Если ни один из предыдущих шагов не привел к a UIComponent
экземпляр, вызвать createComponent(java.lang.String)
передача"javax.faces.NamingContainer
"как параметр.
Вызвать UIComponent#setRendererType
на UIComponent
экземпляр, передавая"javax.faces.Composite
"как параметр.
Сохраните параметр Resource
в атрибутах Map
из UIComponent
под ключом, Resource#COMPONENT_RESOURCE_KEY
.
Компонентные метаданные составного объекта хранилища в атрибутах Map
из UIComponent
под ключом, UIComponent#BEANINFO_KEY
.
Прежде, чем компонентный экземпляр возвращается, он должен быть осмотрен для присутствия a ListenerFor
аннотация. Если эта аннотация присутствует, действие, перечисленное в ListenerFor
должен быть взят на компоненте, прежде, чем он будет возвращен из этого метода.
Реализация по умолчанию то, при условии, что броски UnsupportedOperationException
так, чтобы пользователи, которые украшают Application
может продолжать функционировать.
context
- FacesContext
для текущего запросаcomponentResource
- A Resource
это указывает на исходный файл, который обеспечивает реализацию компонента. FacesException
- если a UIComponent
от Resource
не может быть создан NullPointerException
- если какой-либо параметр null
java.lang.NullPointerException
- если неспособный, по любой причине, чтобы получить a ViewDeclarationLanguage
экземпляр как описано выше.public abstract java.util.Iterator<java.lang.String> getComponentTypes()
Возвратитесь Iterator
по набору в настоящий момент определенного компонента вводит для этого Application
.
public abstract void addConverter(java.lang.String converterId, java.lang.String converterClass)
Зарегистрируйте новое отображение идентификатора преобразователя к имени соответствия Converter
class. Это позволяет последующие звонки createConverter()
служить фабрикой для Converter
экземпляры.
converterId
- Идентификатор преобразователя, который будет зарегистрированconverterClass
- Полностью определенное имя class соответствия Converter
реализация java.lang.NullPointerException
- если converterId
или converterClass
null
public abstract void addConverter(java.lang.Class<?> targetClass, java.lang.String converterClass)
Зарегистрируйте новый преобразователь class, который способен к выполнению преобразований для указанного целевого class.
targetClass
- class, для которого регистрируется этот преобразовательconverterClass
- Полностью определенное имя class соответствия Converter
реализация java.lang.NullPointerException
- если targetClass
или converterClass
null
public abstract Converter createConverter(java.lang.String converterId)
Инстанцируйте и возвратите новое Converter
экземпляр class определяется предыдущим звонком addConverter()
для указанного идентификатора преобразователя.
Если toLowerCase()
из String
represenation значения"javax.faces.DATETIMECONVERTER_DEFAULT_TIMEZONE_IS_SYSTEM_TIMEZONE
"параметр конфигурации приложения"true
"(без кавычек) и Converter
экземпляр, который будет возвращен, является экземпляром DateTimeConverter
, DateTimeConverter.setTimeZone(java.util.TimeZone)
должен быть вызван, передавая возврат из TimeZone.getDefault()
.
Параметр converter
должен быть осмотрен для присутствия ResourceDependency
аннотация. Если ResourceDependency
аннотация присутствует, действие, описанное в ResourceDependency
должен быть взят. Если ResourceDependency
аннотация не присутствует, параметр converter
должен быть осмотрен для присутствия ResourceDependencies
аннотация. Если ResourceDependencies
аннотация присутствует, действие, описанное в ResourceDependencies
должен быть взят.
converterId
- Идентификатор преобразователя, для которого можно создать и возвратить новое Converter
экземпляр FacesException
- если Converter
не может быть создан java.lang.NullPointerException
- если converterId
null
public abstract Converter createConverter(java.lang.Class<?> targetClass)
Инстанцируйте и возвратите новое Converter
экземпляр class, который зарегистрировал себя как способный к выполнению преобразований для объектов указанного типа. Если не такой Converter
class может быть идентифицирован, возвратиться null
.
Определять местоположение соответствующего Converter
class, следующий алгоритм выполняется, останавливаясь как только соответствующее Converter
class находится:
Converter
зарегистрированный для целевого class непосредственно. Converter
зарегистрированный для интерфейсов, которые реализуются целевым class (прямо или косвенно).Converter
зарегистрированный для суперкласса (если любой) целевого class, рекурсивно обрабатывая иерархию наследования.Если Converter
имеет единственного конструктора параметра, который принимает a Class
, инстанцируйте Converter
использование того конструктора, передача параметра targetClass
как единственный параметр. Иначе, просто используйте конструктора нулевого параметра.
Если toLowerCase()
из String
represenation значения"javax.faces.DATETIMECONVERTER_DEFAULT_TIMEZONE_IS_SYSTEM_TIMEZONE
"параметр конфигурации приложения"true
"(без кавычек) и Converter
экземпляр, который будет возвращен, является экземпляром DateTimeConverter
, DateTimeConverter.setTimeZone(java.util.TimeZone)
должен быть вызван, передавая возврат из TimeZone.getDefault()
.
targetClass
- Предназначайтесь для class, для которого можно возвратить a Converter
FacesException
- если Converter
не может быть создан java.lang.NullPointerException
- если targetClass
null
public abstract java.util.Iterator<java.lang.String> getConverterIds()
Возвратитесь Iterator
по набору в настоящий момент зарегистрированных идентификаторов преобразователя для этого Application
.
public abstract java.util.Iterator<java.lang.Class<?>> getConverterTypes()
Возвратитесь Iterator
по набору Class
экземпляры те, для который Converter
классы были явно зарегистрированы.
public void addDefaultValidatorId(java.lang.String validatorId)
Зарегистрируйте блок проверки допустимости его идентификатором, который применяется ко всем UIInput
компоненты в представлении. Блок проверки допустимости, чтобы чаще всего служить этой роли BeanValidator
. Контракт использования для этого метода предполагает, что блок проверки допустимости был зарегистрирован, используя нормальный регистрационный механизм идентификатором".
Реализация состоит в том при условии, что не предпринимает мер так, чтобы пользователи, которые украшают Application
продолжайте работать.
public java.util.Map<java.lang.String,java.lang.String> getDefaultValidatorInfo()
Возвратите неизменное Map
по набору в настоящий момент зарегистрированных ID блока проверки допустимости значения по умолчанию и их class называют для этого Application
.
Реализация состоит в том при условии, что возвраты Collections.emptyMap
так, чтобы пользователи, которые украшают Application
продолжайте работать.
public ExpressionFactory getExpressionFactory()
Возвратитесь ExpressionFactory
экземпляр для этого приложения. Этот экземпляр используется методом удобства evaluateExpressionGet(javax.faces.context.FacesContext, java.lang.String, java.lang.Class<? extends T>)
.
Реализация должна возвратиться ExpressionFactory
от контейнера JSP, вызывая JspFactory.getDefaultFactory().getJspApplicationContext(servletContext).getExpressionFactory()
.
Реализация состоит в том при условии, что броски UnsupportedOperationException
так, чтобы пользователи, которые украшают Application
продолжайте работать.
public <T> T evaluateExpressionGet(FacesContext context, java.lang.String expression, java.lang.Class<? extends T> expectedType) throws ELException
Получите значение, оценивая выражение.
Вызвать getExpressionFactory()
тогда вызовите ExpressionFactory#createValueExpression
передача параметра expression
и expectedType
. Вызвать FacesContext#getELContext
и передайте это к ValueExpression#getValue
, возврат результата.
Реализация состоит в том при условии, что броски UnsupportedOperationException
так, чтобы пользователи, которые украшают Application
продолжайте работать.
ELException
public abstract MethodBinding createMethodBinding(java.lang.String ref, java.lang.Class<?>[] params) throws ReferenceSyntaxException
getExpressionFactory()
тогда ExpressionFactory#createMethodExpression
.
Вызвать getExpressionFactory()
тогда вызовите ExpressionFactory#createMethodExpression
, передача данных параметров, и обертки результат в a MethodBinding
реализация, возвращая это.
ref
- Обязательное выражение метода, для которого можно возвратить a MethodBinding
экземплярparams
- Подписи параметра, которые должны быть совместимыми с таковыми из метода, который будет вызван, или массив нулевой длиной или null
для метода, который не берет параметров java.lang.NullPointerException
- если ref
null
ReferenceSyntaxException
- если указанное ref
имеет недопустимый синтаксисpublic abstract java.util.Iterator<java.util.Locale> getSupportedLocales()
Возвратитесь Iterator
по поддерживаемому Locale
s для этого appication.
public abstract void setSupportedLocales(java.util.Collection<java.util.Locale> locales)
Установите Locale
экземпляры, представляющие поддерживаемый Locale
s для этого приложения.
locales
- Набор поддерживаемых Locale
s для этого приложения java.lang.NullPointerException
- если параметр newLocales
null
.public void addELContextListener(ELContextListener listener)
Обеспечьте путь к приложениям Поверхностей, чтобы зарегистрироваться ELContextListener
это будет уведомлено относительно создания ELContext
экземпляры. Однажды этот слушатель вызовут на запрос.
Реализация состоит в том при условии, что броски UnsupportedOperationException
так, чтобы пользователи, которые украшают Application
продолжайте работать.
public void removeELContextListener(ELContextListener listener)
Удалите параметр listener
от списка ELContextListener
s. Если listener
нуль, никакое исключение не выдается, и никакое действие не выполняется. Если listener
не находится в списке, никакое исключение не выдается, и никакое действие не выполняется.
Реализация состоит в том при условии, что броски UnsupportedOperationException
так, чтобы пользователи, которые украшают Application
продолжайте работать.
public ELContextListener[] getELContextListeners()
Если никакие вызовы не были выполнены к addELContextListener(javax.el.ELContextListener)
, этот метод должен возвратить пустой массив.
Иначе, возвратите массив, представляющий список слушателей, добавленных звонками addELContextListener(javax.el.ELContextListener)
.
Реализация состоит в том при условии, что броски UnsupportedOperationException
так, чтобы пользователи, которые украшают Application
продолжайте работать.
public abstract void addValidator(java.lang.String validatorId, java.lang.String validatorClass)
Зарегистрируйте новое отображение идентификатора блока проверки допустимости к имени соответствия Validator
class. Это позволяет последующие звонки createValidator()
служить фабрикой для Validator
экземпляры.
validatorId
- Идентификатор блока проверки допустимости, который будет зарегистрированvalidatorClass
- Полностью определенное имя class соответствия Validator
реализация java.lang.NullPointerException
- если validatorId
или validatorClass
null
public abstract Validator createValidator(java.lang.String validatorId) throws FacesException
Инстанцируйте и возвратите новое Validator
экземпляр class определяется предыдущим звонком addValidator()
для указанного идентификатора блока проверки допустимости.
Параметр validator
должен быть осмотрен для присутствия ResourceDependency
аннотация. Если ResourceDependency
аннотация присутствует, действие, описанное в ResourceDependency
должен быть взят. Если ResourceDependency
аннотация не присутствует, параметр validator
должен быть осмотрен для присутствия ResourceDependencies
аннотация. Если ResourceDependencies
аннотация присутствует, действие, описанное в ResourceDependencies
должен быть взят.
validatorId
- Идентификатор блока проверки допустимости, для которого можно создать и возвратить новое Validator
экземпляр FacesException
- если a Validator
из указанного идентификатора не может быть создан java.lang.NullPointerException
- если validatorId
null
public abstract java.util.Iterator<java.lang.String> getValidatorIds()
Возвратитесь Iterator
по набору в настоящий момент зарегистрированных идентификаторов блока проверки допустимости для этого Application
.
public abstract ValueBinding createValueBinding(java.lang.String ref) throws ReferenceSyntaxException
getExpressionFactory()
тогда ExpressionFactory#createValueExpression
.
Вызвать getExpressionFactory()
тогда вызовите ExpressionFactory#createValueExpression
, передача параметра ref
, Object.class
для expectedType, и null
, для fnMapper.
ref
- Обязательное выражение значения, для которого можно возвратить a ValueBinding
экземпляр java.lang.NullPointerException
- если ref
null
ReferenceSyntaxException
- если указанное ref
имеет недопустимый синтаксисpublic void publishEvent(FacesContext context, java.lang.Class<? extends SystemEvent> systemEventClass, java.lang.Object source)
Если FacesContext.isProcessingEvents()
true
и есть один или более слушателей для событий типа, представленного systemEventClass
, вызовите тех слушателей, передавая source
как источник события. Реализация должна быть с такой скоростью, как возможный в определении действительно ли слушатель для данного systemEventClass
и source
был установлен, и должен сразу возвратиться, как только такое определение было сделано. Реализация publishEvent
должен соблюдать требования, утвержденные в subscribeToEvent(java.lang.Class<? extends javax.faces.event.SystemEvent>, java.lang.Class<?>, javax.faces.event.SystemEventListener)
относительно хранения и извлечения экземпляров слушателя. Определенно, если subscribeToEvent(Class,Class,SystemEventListener)
был вызван, sourceClass
параметр должен соответствовать точно Class
из source
параметр в звонке publishEvent()
. Реализация не должна сделать никакого наследования hierarachy контроль, ища соответствие между sourceClass
переданный к subscribeToEvent(Class,Class,SystemEventListener)
и sourceClass
переданный к publishEvent()
чтобы найти любых слушателей, к которым должно быть опубликовано событие. В случае, где Class
из source
параметр не соответствует Class
из sourceClass
используемый, когда слушатель был подписан, используя subscribeToEvent()
, publishEvent(FacesContext,Class,Class,Object)
может использоваться, чтобы обеспечить Class
используемый, чтобы выполнить поиск слушателя и соответствие.
Реализация по умолчанию должна реализовать алгоритм, семантически эквивалентный следующему, чтобы определить местоположение экземпляров слушателя и вызвать их.
Если source
реализации параметра SystemEventListenerHolder
, вызвать SystemEventListenerHolder.getListenersForEventClass(java.lang.Class<? extends javax.faces.event.SystemEvent>)
на этом, передавая systemEventClass
параметр. Если список не пуст, выполните алгоритм traverseListenerList в списке.
Если какие-либо слушатели уровня представления были установлены предыдущими звонками subscribeToEvent(Class, Class, javax.faces.event.SystemEventListener)
на UIViewRoot
, выполните алгоритм traverseListenerList в списке слушателей для того события, установленного на UIViewRoot
.
Если любой Application
слушатели уровня были установлены предыдущими звонками subscribeToEvent(Class, Class, javax.faces.event.SystemEventListener)
, выполните алгоритм traverseListenerList в списке.
Если любой Application
слушатели уровня были установлены предыдущими звонками subscribeToEvent(Class, javax.faces.event.SystemEventListener)
, выполните алгоритм traverseListenerList в списке.
Если действие вызова processListener
метод вызывает AbortProcessingException
чтобы быть брошенной, обработка слушателей должна быть прервана, никакая дальнейшая обработка слушателей для этого события не должна иметь место, и исключение должно быть зарегистрировано с Level.SEVERE
.
Алгоритм traverseListenerList: Для каждого слушателя в списке,
Вызвать SystemEventListener.isListenerForSource(java.lang.Object)
, передача source
параметр. Если это возвращается false
, не предпримите меры на слушателе.
Иначе, если событие, которое передадут к экземплярам слушателя, еще не было создано, создайте событие, передавая source
как параметр конструктору с одним параметром, который берет Object
. Этот тот же самый экземпляр события нужно передать ко всем экземплярам слушателя.
Вызвать SystemEvent.isAppropriateListener(javax.faces.event.FacesListener)
, передача экземпляра слушателя как параметр. Если это возвращается false
, не предпримите меры на слушателе.
Вызвать SystemEvent.processListener(javax.faces.event.FacesListener)
, передача экземпляра слушателя.
Реализация по умолчанию то, при условии, что броски UnsupportedOperationException
так, чтобы пользователи, которые украшают Application
может продолжать функционировать
context
- FacesContext
для текущего запросаsystemEventClass
- Class
из события, которое публикуется.source
- Источник для события типа systemEventClass
. java.lang.NullPointerException
- если также context
, systemEventClass
или source
null
public void publishEvent(FacesContext context, java.lang.Class<? extends SystemEvent> systemEventClass, java.lang.Class<?> sourceBaseType, java.lang.Object source)
Этот метод функционирует точно как publishEvent(FacesContext,Class,Object)
, кроме времени выполнения должен использовать параметр sourceBaseType
найти соответствующего слушателя вместо того, чтобы использовать Class
из source
параметр.
Реализация по умолчанию то, при условии, что броски UnsupportedOperationException
так, чтобы пользователи, которые украшают Application
может продолжать функционировать
context
- FacesContext
для текущего запросаsystemEventClass
- Class
из события, которое публикуется.sourceBaseType
- Class
из исходного события, которое должно привыкнуть к поиску слушатель, к которому должно быть опубликовано это событие. Если этот параметр null
возврат из source.getClass()
должен использоваться в качестве sourceBaseType
.source
- Источник для события типа systemEventClass
. java.lang.NullPointerException
- если любые параметры за исключением sourceBaseType
null
public void subscribeToEvent(java.lang.Class<? extends SystemEvent> systemEventClass, java.lang.Class<?> sourceClass, SystemEventListener listener)
Установите экземпляр слушателя, на который ссылается параметр listener
в приложение как слушатель для событий типа systemEventClass
это происходит из объектов типа sourceClass
.
Если параметр sourceClass
не -null
, sourceClass
и systemEventClass
должен использоваться, чтобы сохранить параметр listener
в приложении таким способом, который listener
может быстро искаться реализацией publishEvent(javax.faces.context.FacesContext, java.lang.Class<? extends javax.faces.event.SystemEvent>, java.lang.Object)
данный systemEventClass
и экземпляр Class
ссылаемый sourceClass
. Если параметр sourceClass
null
, listener
должно быть поддающимся обнаружению реализацией publishEvent(javax.faces.context.FacesContext, java.lang.Class<? extends javax.faces.event.SystemEvent>, java.lang.Object)
учитывая только systemEventClass
.
systemEventClass
- Class
из того, события, для который listener
должен быть запущен.sourceClass
- Class
из экземпляра, который вызывает события типа systemEventClass
быть запущенным. Может быть null
.listener
- реализация SystemEventListener
чей SystemEventListener.processEvent(javax.faces.event.SystemEvent)
метод нужно вызвать когда события типа systemEventClass
запускаются. NullPointerException
- если любая комбинация systemEventClass
, или listener
null
.public void subscribeToEvent(java.lang.Class<? extends SystemEvent> systemEventClass, SystemEventListener listener)
Установите экземпляр слушателя, на который ссылается параметр listener
в приложение как слушатель для событий типа systemEventClass
. Реализация по умолчанию просто вызывает через к subscribeToEvent(Class, Class, javax.faces.event.SystemEventListener)
передача null
как sourceClass
параметр
Реализация по умолчанию то, при условии, что броски UnsupportedOperationException
так, чтобы пользователи, которые украшают Application
может продолжать функционировать
systemEventClass
- Class
из того, события, для который listener
должен быть запущен.listener
- реализация SystemEventListener
чей SystemEventListener.processEvent(javax.faces.event.SystemEvent)
метод нужно вызвать когда события типа systemEventClass
запускаются. NullPointerException
- если любая комбинация systemEventClass
, или listener
null
.public void unsubscribeFromEvent(java.lang.Class<? extends SystemEvent> systemEventClass, java.lang.Class<?> sourceClass, SystemEventListener listener)
Удалите экземпляр слушателя, на который ссылается параметр listener
из приложения как слушатель для событий типа systemEventClass
это происходит из объектов типа sourceClass
. См. subscribeToEvent(Class, Class, javax.faces.event.SystemEventListener)
для спецификации того, как слушатель сохранен, и поэтому, как она должна быть удалена.
systemEventClass
- Class
из того, события, для который listener
должен быть запущен.sourceClass
- Class
из экземпляра, который вызывает события типа systemEventClass
быть запущенным. Может быть null
.listener
- реализация SystemEventListener
удалить из внутренней структуры данных. NullPointerException
- если любая комбинация context
, systemEventClass
, или listener
null
.public void unsubscribeFromEvent(java.lang.Class<? extends SystemEvent> systemEventClass, SystemEventListener listener)
Удалите экземпляр слушателя, на который ссылается параметр listener
из приложения как слушатель для событий типа systemEventClass
. Реализация по умолчанию просто вызывает через к unsubscribeFromEvent(Class, javax.faces.event.SystemEventListener)
передача null
как sourceClass
параметр
systemEventClass
- Class
из того, события, для который listener
должен быть запущен.listener
- реализация SystemEventListener
удалить из внутренней структуры данных. NullPointerException
- если любая комбинация context
, systemEventClass
, или listener
null
. http://java.sun.com/javaee/javaserverfaces/reference/api/index.html
|
|||||||||
ПРЕДЫДУЩИЙ СЛЕДУЮЩИЙ КЛАСС КЛАССА | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается
Сгенерированный на 10-February-2011 12:41