|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
javax.faces.webapp Class UIComponentTag
java.lang.Object javax.faces.webapp.UIComponentTagBase javax.faces.webapp.UIComponentClassicTagBase javax.faces.webapp.UIComponentTag
- All Implemented Interfaces:
- BodyTag, IterationTag, JspIdConsumer, JspTag, Tag
- Direct Known Subclasses:
- UIComponentBodyTag
Deprecated. Use of this class has been replaced with
UIComponentELTag
, which extends
UIComponentClassicTagBase
to add properties that use the
EL API introduced as part of JSP 2.1.
UIComponentTag
是所有满足以下条件的 JSP 自定义操作的基类:这些操作对应于 JavaServer Faces 所呈现的页面中的用户界面组件。
在此规范版本中,UIComponentTag
扩展了 UIComponentClassicTagBase
,添加了使用 Faces 1.1 表达式语言的属性。
deprecated |
此类的用途已由 UIComponentELTag 替代,后者扩展了 UIComponentClassicTagBase ,添加了使用作为 JSP 2.1 一部分引入的 EL API 的属性。 |
public abstract class UIComponentTag
- extends UIComponentClassicTagBase
- implements Tag
UIComponentTag
is the base class for all JSP custom
actions that correspond to user interface components in a page that is
rendered by JavaServer Faces.
In this version of the specification, UIComponentTag
extends UIComponentClassicTagBase
to add properties that use
the Faces 1.1 Expression Language.
Field Summary |
---|
Fields inherited from class javax.faces.webapp.UIComponentClassicTagBase |
---|
bodyContent, pageContext, UNIQUE_ID_PREFIX |
Fields inherited from class javax.faces.webapp.UIComponentTagBase |
---|
log |
Fields inherited from interface javax.servlet.jsp.tagext.Tag |
---|
EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE |
Fields inherited from interface javax.servlet.jsp.tagext.BodyTag |
---|
EVAL_BODY_BUFFERED, EVAL_BODY_TAG |
Fields inherited from interface javax.servlet.jsp.tagext.IterationTag |
---|
EVAL_BODY_AGAIN |
Constructor Summary | |
---|---|
UIComponentTag()
Deprecated. |
Method Summary | |
---|---|
protected UIComponent |
createComponent(FacesContext context,
String newId)
Deprecated. Implement createComponent using Faces 1.1 EL
API. |
static UIComponentTag |
getParentUIComponentTag(PageContext context)
Deprecated. Locate and return the nearest enclosing UIComponentTag
if any; otherwise, return null . |
protected boolean |
hasBinding()
Deprecated. Return true if this component has a
non-null binding attribute. |
protected boolean |
isSuppressed()
Deprecated. |
static boolean |
isValueReference(String value)
Deprecated. Return true if the specified value conforms to the
syntax requirements of a value binding expression. |
void |
release()
Deprecated. Release any resources allocated during the execution of this tag handler. |
void |
setBinding(String binding)
Deprecated. Set the value binding expression for our component. |
protected void |
setProperties(UIComponent component)
Deprecated. Override properties and attributes of the specified component, if the corresponding properties of this tag handler instance were explicitly set. |
void |
setRendered(String rendered)
Deprecated. Set an override for the rendered attribute. |
Methods inherited from class javax.faces.webapp.UIComponentTagBase |
---|
getComponentType, getELContext, getRendererType |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface javax.servlet.jsp.tagext.Tag |
---|
doEndTag, doStartTag, getParent, setPageContext, setParent |
Constructor Detail |
---|
public
UIComponentTag()
英文文档:
UIComponentTag
public UIComponentTag()
- Deprecated.
Method Detail |
---|
public void
setBinding(String binding) throws JspException
设置组件的值绑定表达式。
binding | 新的值绑定表达式 |
Throws | IllegalArgumentException: 如果指定的绑定不是有效的值绑定表达式。 |
setBinding
public void setBinding(String binding) throws JspException
- Deprecated.
Set the value binding expression for our component.
- Parameters:
binding
- The new value binding expression- Throws:
IllegalArgumentException
- if the specified binding is not a valid value binding expression.JspException
protected boolean
hasBinding()
英文文档:
hasBinding
protected boolean hasBinding()
- Deprecated.
- Description copied from class:
UIComponentClassicTagBase
Return
true
if this component has a non-null
binding attribute. This method is necessary to allow subclasses that expose thebinding
property as an Faces 1.1 style EL property as well as subclasses that expose it as an EL API property.- Specified by:
hasBinding
in classUIComponentClassicTagBase
public void
setRendered(String rendered)
为呈现的属性设置重写。
rendered | 呈现属性的新值 |
setRendered
public void setRendered(String rendered)
- Deprecated.
Set an override for the rendered attribute.
- Parameters:
rendered
- The new value for rendered attribute
protected boolean
isSuppressed()
英文文档:
isSuppressed
protected boolean isSuppressed()
- Deprecated.
public static boolean
isValueReference(String value)
如果指定的值符合值绑定表达式的语法要求,则返回 true
。这些表达式 ` * 可以对大多数组件标记属性使用,表示希望对要在底层 UIComponent
上设置的属性值进行延迟求值。
value | 要求值的值。 |
Throws | NullPointerException:
如果 value 为 null |
isValueReference
public static boolean isValueReference(String value)
- Deprecated.
Return
true
if the specified value conforms to the syntax requirements of a value binding expression. Such expressions ` * may be used on most component tag attributes to signal a desire for deferred evaluation of the attribute or property value to be set on the underlyingUIComponent
.- Parameters:
value
- The value to evaluate- Throws:
NullPointerException
- ifvalue
isnull
public void
release()
释放执行此标记处理程序期间分配的所有资源。
release
public void release()
- Deprecated.
Release any resources allocated during the execution of this tag handler.
- Specified by:
release
in interfaceTag
- Overrides:
release
in classUIComponentClassicTagBase
protected void
setProperties(UIComponent component)
component |
NullPointerException
要重写属性的 UIComponent |
setProperties
protected void setProperties(UIComponent component)
- Deprecated.
- Description copied from class:
UIComponentClassicTagBase
Override properties and attributes of the specified component, if the corresponding properties of this tag handler instance were explicitly set. This method must be called ONLY if the specified
UIComponent
was in fact created during the execution of this tag handler instance, and this call will occur BEFORE theUIComponent
is added to the view.Tag subclasses that want to support additional set properties must ensure that the base class
setProperties()
method is still called. A typical implementation that supports extra propertiesfoo
andbar
would look something like this:protected void setProperties(UIComponent component) { super.setProperties(component); if (foo != null) { component.setAttribute("foo", foo); } if (bar != null) { component.setAttribute("bar", bar); } }
The default implementation overrides the following properties:
rendered
- Set if a value for therendered
property is specified for this tag handler instance.rendererType
- Set if thegetRendererType()
method returns a non-null value.
- Specified by:
setProperties
in classUIComponentClassicTagBase
- Parameters:
component
-UIComponent
whose properties are to be overridden
protected UIComponent
createComponent(FacesContext context, String newId)
使用 Faces 1.1 EL API 实现 createComponent
。
context |
NullPointerException
当前请求的 FacesContext |
newId |
NullPointerException
当前请求的 FacesContext |
createComponent
protected UIComponent createComponent(FacesContext context, String newId)
- Deprecated.
Implement
createComponent
using Faces 1.1 EL API.- Specified by:
createComponent
in classUIComponentClassicTagBase
- Parameters:
context
-FacesContext
for the current requestnewId
- id of the component
public static UIComponentTag
getParentUIComponentTag(PageContext context)
查找并返回最新封装的 UIComponentTag
(如果有);否则返回 null
。
context |
当前页面的 PageContext |
getParentUIComponentTag
public static UIComponentTag getParentUIComponentTag(PageContext context)
- Deprecated.
Locate and return the nearest enclosing
UIComponentTag
if any; otherwise, returnnull
.- Parameters:
context
-PageContext
for the current page
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
Submit a bug or feature
Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.
PS : 未经我党受权你也可自由散发此文档。 如有任何错误请自行修正;若因此而造成任何损失请直接找人民主席,请勿与本人联系。谢谢!