Spec-Zone .ru
спецификации, руководства, описания, API
|
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
java.lang.Object javax.faces.view.ViewDeclarationLanguage
public abstract class ViewDeclarationLanguage
Контракт, который язык объявления представления должен реализовать, чтобы взаимодействовать со временем выполнения JSF. Реализация этого class должна быть ориентирована на многопотоковое исполнение.
Экземпляры этого class являются определяющим контекст приложением и должны быть получены из ViewDeclarationLanguageFactory
.
Полевая Сводка | |
---|---|
static java.lang.String |
FACELETS_VIEW_DECLARATION_LANGUAGE_ID
Идентификатор для Facelets просматривает язык объявления. |
static java.lang.String |
JSP_VIEW_DECLARATION_LANGUAGE_ID
Идентификатор для JSP просматривает язык объявления. |
Сводка конструктора | |
---|---|
ViewDeclarationLanguage()
|
Сводка метода | |
---|---|
abstract void |
buildView(FacesContext context, UIViewRoot root)
Предпримите любые меры, определенные для этой реализации VDL, чтобы вызвать параметр |
abstract UIViewRoot |
createView(FacesContext context, java.lang.String viewId)
Создайте a |
abstract java.beans.BeanInfo |
getComponentMetadata(FacesContext context, Resource componentResource)
Возвратите ссылку на компонентные метаданные для составного компонента, представленного параметром |
java.lang.String |
getId()
Возвращает непустую строку, которая может использоваться, чтобы идентифицировать этот язык объявления представления. |
abstract Resource |
getScriptComponentResource(FacesContext context, Resource componentResource)
Возьмите реализацию определенное действие, чтобы обнаружить a |
abstract StateManagementStrategy |
getStateManagementStrategy(FacesContext context, java.lang.String viewId)
Для реализаций, которые хотят управлять реализацией сохранения состояния и восстановления, |
abstract ViewMetadata |
getViewMetadata(FacesContext context, java.lang.String viewId)
Возвратите ссылку на метаданные представления для представления, представленного параметром |
abstract void |
renderView(FacesContext context, UIViewRoot view)
Представьте представление, базированное в параметре |
abstract UIViewRoot |
restoreView(FacesContext context, java.lang.String viewId)
Восстановление a |
void |
retargetAttachedObjects(FacesContext context, UIComponent topLevelComponent, java.util.List<AttachedObjectHandler> handlers)
Принятие компонентных метаданных для параметра |
void |
retargetMethodExpressions(FacesContext context, UIComponent topLevelComponent)
Принятие компонентных метаданных для параметра |
boolean |
viewExists(FacesContext context, java.lang.String viewId)
Тесты, существует ли физический ресурс, соответствующий указанному viewId. |
Методы, наследованные от class java.lang. Объект |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Полевая Деталь |
---|
public static final java.lang.String JSP_VIEW_DECLARATION_LANGUAGE_ID
Идентификатор для JSP просматривает язык объявления.
public static final java.lang.String FACELETS_VIEW_DECLARATION_LANGUAGE_ID
Идентификатор для Facelets просматривает язык объявления.
Деталь конструктора |
---|
public ViewDeclarationLanguage()
Деталь метода |
---|
public abstract java.beans.BeanInfo getComponentMetadata(FacesContext context, Resource componentResource)
Возвратите ссылку на компонентные метаданные для составного компонента, представленного параметром componentResource
, или null
если метаданные не могут быть найдены. См. раздел JSF.7.6.2 для спецификации реализации по умолчанию. Реализации JSP должны бросить UnsupportedOperationException
.
context
- FacesContext
для этого запроса.componentResource
- Resource
это представляет компонент. java.lang.NullPointerException
- если какой-либо из параметров null
. FacesException
- если есть ошибка в получении метаданных UnsupportedOperationException
- если это - JSP VDL реализация.public abstract ViewMetadata getViewMetadata(FacesContext context, java.lang.String viewId)
Возвратите ссылку на метаданные представления для представления, представленного параметром viewId
, или null
если метаданные не могут быть найдены. См. раздел JSF.7.6.2 для спецификации реализации по умолчанию. Facelets для JSF 2 реализации должен возвратиться не -null
. Реализации JSP должны возвратиться null
.
context
- FacesContext
для этого запроса.viewId
- идентификатор представления от whith, чтобы извлечь метаданные java.lang.NullPointerException
- если какой-либо из параметров null
. FacesException
- если есть ошибка в получении метаданныхpublic abstract Resource getScriptComponentResource(FacesContext context, Resource componentResource)
Возьмите реализацию определенное действие, чтобы обнаружить a Resource
учитывая параметр componentResource
. См. раздел JSF.7.6.2 для спецификации реализации по умолчанию. Реализации JSP должны бросить UnsupportedOperationException
.
context
- FacesContext
для этого запроса.componentResource
- Resource
это представляет компонент. java.lang.NullPointerException
- если какой-либо из параметров null
. FacesException
- если есть ошибка в получении компонентного ресурса сценария UnsupportedOperationException
- если это - JSP VDL реализация.public abstract UIViewRoot createView(FacesContext context, java.lang.String viewId)
Создайте a UIViewRoot
от VDL, содержавшегося в артефакте, ссылается параметром viewId
. См. раздел JSF.7.6.2 для спецификации реализации по умолчанию.
context
- FacesContext
для этого запроса.viewId
- идентификатор артефакта, который содержит синтаксис VDL, который описывает это представление. java.lang.NullPointerException
- если какой-либо из параметров null
public abstract UIViewRoot restoreView(FacesContext context, java.lang.String viewId)
Восстановление a UIViewRoot
от ранее создаваемого представления. См. раздел JSF.7.6.2 для спецификации реализации по умолчанию.
context
- FacesContext
для этого запроса.viewId
- идентификатор для ранее представленного представления. java.lang.NullPointerException
- если какой-либо из параметров null
public void retargetAttachedObjects(FacesContext context, UIComponent topLevelComponent, java.util.List<AttachedObjectHandler> handlers)
Принятие компонентных метаданных для параметра topLevelComponent
был сделан доступным более ранним звонком ViewDeclarationLanguage#getComponentMetadata
, усильте компонентные метаданные с целью перенастройки присоединенных объектов от высокоуровневого компонента составного объекта до человека AttachedObjectTarget
экземпляры в составном компоненте. Этот метод нужно вызвать ViewDeclarationLanguage
реализация, создавая UIComponent
дерево, когда с составным компонентным использованием встречаются.
Должен быть реализован алгоритм, семантически эквивалентный следующему.
Получите метаданные для составного компонента. В настоящий момент это влечет за собой получение значения UIComponent#BEANINFO_KEY
компонентный атрибут, который будет экземпляром BeanInfo
. Если метаданные не могут быть найдены, зарегистрируйте сообщение об ошибке и возврат.
Доберитесь BeanDescriptor
от BeanInfo
.
Получите значение AttachedObjectTarget#ATTACHED_OBJECT_TARGETS_KEY
от BeanDescriptor
's getValue()
метод. Это будет a List<
. Позвольте этому быть targetList.AttachedObjectTarget
>
Для каждой curHandler записи в параметре handlers
Позвольте forAttributeValue быть возвратом из AttachedObjectHandler#getFor
.
Для каждой curTarget записи в targetList первый из следующих элементов, который вызывает соответствие, предпримет эти меры:
Для каждого UIComponent
в списке, возвращенном из curTarget.getTargets (), вызовите curHandler.applyAttachedObject (), передавая FacesContext
и UIComponent
.
и заставьте этот внутренний цикл завершаться.
Если curHandler является экземпляром ActionSource2AttachedObjectHandler
и curTarget является экземпляром ActionSource2AttachedObjectTarget
, и curTarget.getName () равен curTargetName, считайте это соответствием.
Если curHandler является экземпляром EditableValueHolderAttachedObjectHandler
и curTarget является экземпляром EditableValueHolderAttachedObjectTarget
, и curTarget.getName () равен curTargetName, считайте это соответствием.
Если curHandler является экземпляром ValueHolderAttachedObjectHandler
и curTarget является экземпляром ValueHolderAttachedObjectTarget
, и curTarget.getName () равен curTargetName, считайте это соответствием.
Если curHandler является экземпляром BehaviorHolderAttachedObjectHandler
и curTarget является экземпляром BehaviorHolderAttachedObjectTarget
, и любое из следующих условий является истиной,
null
и равно curTargetName.null
и curTarget.isDefaultEvent () true
.считайте это соответствием.
Реализация должна поддерживать перенастройку присоединенные объекты от верхнего уровня compsite компонент к целям, которые являются составными и несоставными компонентами.
Реализация состоит в том при условии, что бросит UnsupportedOperationException
. Реализация Поверхностей, совместимая с версией 2.0 и вне спецификации, должна переопределить этот метод.
context
- FacesContext для этого запроса.topLevelComponent
- UIComponent в представлении, к которому должны быть присоединены присоединенные объекты. У этого UIComponent должны быть свои компонентные метаданные, уже связанные и доступные от через API JavaBeans. java.lang.NullPointerException
- если какой-либо из параметров null
.public void retargetMethodExpressions(FacesContext context, UIComponent topLevelComponent)
Принятие компонентных метаданных для параметра topLevelComponent
был сделан доступным более ранним звонком ViewDeclarationLanguage#getComponentMetadata
, усильте компонентные метаданные с целью перенастройки любых выражений метода от высокоуровневого компонента до соответствующего внутреннего компонента. Для каждого атрибута, который является a MethodExpression
(как обозначено присутствием"method-signature
"атрибут и отсутствие"type
"атрибут), следующие меры должны быть предприняты:
Получите значение целевого атрибута. Если значение является a ValueExpression
оцените это. Если нет никакого целевого атрибута, позвольте имени элемента метаданных быть оцененным значением целевого атрибута.
Интерпретируйте цели как пространство (не, снабжают вкладками), разделенный список идентификаторов. Для каждой записи в списке:
Сочтите внутренний компонент topLevelComponent с идентификатором равным текущей записи списка. Для обсуждения этот компонент вызывают целью. Если не найденный, журнал и ошибка и продолжаются к следующему атрибуту.
Для обсуждения объявленное имя атрибута вызывают именем.
В карте атрибутов topLevelComponent ищите запись под ключевым именем. Предположите, что результатом является a ValueExpression
. Для обсуждения это - attributeValueExpression. Если не найденный, зарегистрируйте ошибку и продолжайте к следующему атрибуту.
Если имя равно строке "действие", или "actionListener" без кавычек, предположите, что цель ActionSource2
.
Если имя равно строке "блок проверки допустимости", или "valueChangeListener" без кавычек, предположите, что цель EditableValueHolder
.
Вызвать getExpressionString()
на attributeValueExpression и использовании, которые представляют в виде строки, чтобы создать a MethodExpression
из соответствующей подписи для имени.
Если имя не равно какой-либо из ранее перечисленных строк, вызвать getExpressionString()
на attributeValueExpression и использовании, которые представляют в виде строки, чтобы создать a MethodExpression
где подпись создается основанная на значении"method-signature
"атрибут <composite:attribute />
тег.
Позвольте результанту MethodExpression
вызовите attributeMethodExpression для обсуждения.
Если имя равно строке "действие" без кавычек, вызвать ActionSource2.setActionExpression(javax.el.MethodExpression)
на цели, передавая attributeMethodExpression.
Если имя равно строке "actionListener" без кавычек, вызвать ActionSource.addActionListener(javax.faces.event.ActionListener)
на цели, передавая attributeMethodExpression обернутый в a MethodExpressionActionListener
.
Если имя равно строке "блок проверки допустимости" без кавычек, вызвать EditableValueHolder.addValidator(javax.faces.validator.Validator)
на цели, передавая attributeMethodExpression обернутый в a MethodExpressionValidator
.
Если имя равно строке "valueChangeListener" без кавычек, вызвать EditableValueHolder.addValueChangeListener(javax.faces.event.ValueChangeListener)
на цели, передавая attributeMethodExpression обернутый в a MethodExpressionValueChangeListener
.
Иначе, предположите что MethodExpression
должен быть помещен в компонентный набор атрибута. runtme должен создать MethodExpression
экземпляр, основанный на значении"method-signature
"атрибут.
Реализация состоит в том при условии, что бросит UnsupportedOperationException
. Реализация Поверхностей, совместимая с версией 2.0 и вне спецификации, должна переопределить этот метод.
context
- FacesContext для этого запроса.topLevelComponent
- UIComponent в представлении, к которому должны быть присоединены присоединенные объекты. У этого UIComponent должны быть свои компонентные метаданные, уже связанные и доступные от через API JavaBeans. java.lang.NullPointerException
- если context
или topLevelComponent
null
.public abstract void buildView(FacesContext context, UIViewRoot root) throws java.io.IOException
Предпримите любые меры, определенные для этой реализации VDL, чтобы вызвать параметр UIViewRoot
который, должно быть, был создан через звонок createView(javax.faces.context.FacesContext, java.lang.String)
, быть заполненным с дочерними элементами.
Реализация Facelets должна обеспечить, чтобы разметка, включающая представление, была выполнена, с UIComponent
экземпляры в представлении, встреченном в том же самом порядке в глубину как в других методах жизненного цикла, определенных на UIComponent
, и добавил к представлению (но не представлял) во время обхода. Время выполнения должно гарантировать, что представление должно быть полностью заполнено прежде, чем любое следующее происходит.
PhaseListener.afterPhase(javax.faces.event.PhaseEvent)
метод любого PhaseListener
s присоединенный к приложению вызывается
UIViewRoot
фазовый слушатель, установленный через UIViewRoot.setAfterPhaseListener(javax.el.MethodExpression)
или UIViewRoot.addPhaseListener(javax.faces.event.PhaseListener)
вызываются.
Если root
уже заполняется с дочерними элементами, представление должно все еще быть восстановлено, но забота должна быть проявлена, чтобы гарантировать, что существующие компоненты правильно разделяются на пары с их дубликатами VDL в странице VDL. Кроме того, любые системные события, которые были бы обычно сгенерированы во время добавления или удаления компонентов от представления, должны быть временно недоступными во время создания представления и затем повторно включали, когда представление было создано.
context
- FacesContext
для этого запросаroot
- UIViewRoot
заполнить с дочерними элементами, использующими методы, определенные для этой реализации VDL. java.io.IOException
public abstract void renderView(FacesContext context, UIViewRoot view) throws java.io.IOException
Представьте представление, базированное в параметреview
. См. раздел JSF.7.6.2 для спецификации реализации по умолчанию.
context
- FacesContext
для этого запроса.view
- UIViewRoot
от раннего звонка createView(javax.faces.context.FacesContext, java.lang.String)
или restoreView(javax.faces.context.FacesContext, java.lang.String)
. java.lang.NullPointerException
- если какой-либо из параметров null
java.io.IOException
public abstract StateManagementStrategy getStateManagementStrategy(FacesContext context, java.lang.String viewId)
Для реализаций, которые хотят управлять реализацией сохранения состояния и восстановления, StateManagementStrategy
позволяет им делать так. Возврат null
указывает, что реализация хочет, чтобы время выполнения обработало сохранение состояния и восстановление. Реализации, которые предоставляют VDL Facelets для JSF 2.0 и позже должны возвратиться не -null
от этого метода.
public boolean viewExists(FacesContext context, java.lang.String viewId)
Тесты, существует ли физический ресурс, соответствующий указанному viewId.
Использование реализации по умолчанию ExternalContext.getResource()
определять местоположение физического ресурса.
context
- FacesContext
для этого запроса.viewId
- идентификатор представления, чтобы протестироватьpublic java.lang.String getId()
Возвращает непустую строку, которая может использоваться, чтобы идентифицировать этот язык объявления представления.
Реализация по умолчанию возвращает полностью определенное имя class реализации языка объявления представления. Подклассы могут переопределить, чтобы обеспечить более значимый идентификатор.
|
|||||||||
ПРЕДЫДУЩИЙ КЛАСС СЛЕДУЮЩИЙ КЛАСС | ФРЕЙМЫ НИКАКИЕ ФРЕЙМЫ | ||||||||
СВОДКА: ВЛОЖЕННЫЙ | ПОЛЕ | CONSTR | МЕТОД | ДЕТАЛЬ: ПОЛЕ | CONSTR | МЕТОД |
Авторское право © 2009-2011, Oracle Corporation и/или его филиалы. Все права защищены. Использование подвергается
Сгенерированный на 10-February-2011 12:41