UIComponentELTag
に置き換えられました。これは UIComponentClassicTagBase
を継承して、Jakarta Server Pages 2.1 の一部として導入された Jakarta Expression Language API を使用するプロパティを追加します。@DeprecatedSE public abstract class UIComponentTag extends UIComponentClassicTagBase implements Tag
UIComponentTag
は、Jakarta Server Faces によってレンダリングされるページのユーザーインターフェースコンポーネントに対応するすべての Jakarta Server Pages カスタムアクションの基本クラスです。
このバージョンの仕様では、UIComponentTag
は UIComponentClassicTagBase
を継承して Faces 1.1 Expression Language を使用するプロパティを追加します。
bodyContent, pageContext, UNIQUE_ID_PREFIX
log
EVAL_BODY_INCLUDE, EVAL_PAGE, SKIP_BODY, SKIP_PAGE
EVAL_BODY_BUFFERED, EVAL_BODY_TAG
EVAL_BODY_AGAIN
コンストラクターと説明 |
---|
UIComponentTag() 使用すべきではありません。 |
修飾子と型 | メソッドと説明 |
---|---|
protected UIComponent | createComponent(FacesContext context, StringSE newId) 使用すべきではありません。 Faces 1.1 EL API を使用して createComponent を実装します。 |
static UIComponentTag | getParentUIComponentTag(PageContext context) 使用すべきではありません。 |
protected boolean | hasBinding() 使用すべきではありません。 このコンポーネントに null 以外のバインディング属性がある場合、true を返します。 |
protected boolean | isSuppressed() 使用すべきではありません。 |
static boolean | isValueReference(StringSE value) 使用すべきではありません。 指定された値が値バインディング式の構文要件に準拠している場合、 true を返します。 |
void | release() 使用すべきではありません。 このタグハンドラーの実行中に割り当てられたリソースを解放します。 |
void | setBinding(StringSE binding) 使用すべきではありません。 コンポーネントの値バインディング式を設定します。 |
protected void | setProperties(UIComponent component) 使用すべきではありません。 このタグハンドラーインスタンスの対応するプロパティが明示的に設定されている場合、指定されたコンポーネントのプロパティと属性をオーバーライドします。 |
void | setRendered(StringSE rendered) 使用すべきではありません。 レンダリングされた属性のオーバーライドを設定します。 |
addChild, addFacet, addVerbatimAfterComponent, addVerbatimBeforeComponent, createVerbatimComponent, createVerbatimComponentFromBodyContent, doAfterBody, doEndTag, doInitBody, doStartTag, encodeBegin, encodeChildren, encodeEnd, findComponent, getBodyContent, getComponentInstance, getCreated, getCreatedComponents, getDoAfterBodyValue, getDoEndValue, getDoStartValue, getFacesContext, getFacesJspId, getFacetName, getId, getIndexOfNextChildTag, getJspId, getParent, getParentUIComponentClassicTagBase, getPreviousOut, setBodyContent, setId, setJspId, setPageContext, setParent, setupResponseWriter
getComponentType, getELContext, getRendererType
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE
doEndTag, doStartTag, getParent, setPageContext, setParent
public void setBinding(StringSE binding) throws JspException
コンポーネントの値バインディング式を設定します。
binding
- 新しい値バインディング式 IllegalArgumentExceptionSE
- 指定されたバインディングが有効な値バインディング式ではない場合。JspException
- バインディングを設定できない場合 protected boolean hasBinding()
UIComponentClassicTagBase
このコンポーネントに非 null
バインディング属性がある場合、true
を返します。このメソッドは、binding
プロパティを Faces 1.1 スタイルの式言語プロパティとして公開するサブクラスと、Jakarta Expression Language API プロパティとして公開するサブクラスを許可するために必要です。
UIComponentClassicTagBase
の hasBinding
public void setRendered(StringSE rendered)
レンダリングされた属性のオーバーライドを設定します。
rendered
- レンダリングされた属性の新しい値 protected boolean isSuppressed()
public static boolean isValueReference(StringSE value)
指定された値が値バインディング式の構文要件に準拠している場合、true
を返します。そのような表現 `* は、属性またはプロパティ値の遅延評価が基礎となる UIComponent
に設定されることを希望することを示すために、ほとんどのコンポーネントタグ属性で使用できます。
value
- 評価する値 NullPointerExceptionSE
- value
が null
の場合 public void release()
このタグハンドラーの実行中に割り当てられたリソースを解放します。
Tag
の release
UIComponentClassicTagBase
の release
protected void setProperties(UIComponent component)
UIComponentClassicTagBase
このタグハンドラーインスタンスの対応するプロパティが明示的に設定されている場合、指定されたコンポーネントのプロパティと属性をオーバーライドします。このメソッドは、指定された UIComponent
がこのタグハンドラーインスタンスの実行中に実際に作成された場合にのみ呼び出す必要があり、この呼び出しは UIComponent
がビューに追加される前に発生します。
追加のセットプロパティをサポートするタグサブクラスは、ベースクラス setProperties()
メソッドが引き続き呼び出されることを確認する必要があります。追加のプロパティ foo
および bar
をサポートする典型的な実装は、次のようになります。
protected void setProperties(UIComponent component) { super.setProperties(component); if (foo != null) { component.setAttribute("foo", foo); } if (bar != null) { component.setAttribute("bar", bar); } }
デフォルトの実装は、次のプロパティをオーバーライドします。
rendered
- このタグハンドラーインスタンスに rendered
プロパティの値が指定されている場合に設定します。rendererType
- getRendererType()
メソッドが null 以外の値を返す場合に設定します。UIComponentClassicTagBase
の setProperties
component
- プロパティがオーバーライドされる UIComponent
protected UIComponent createComponent(FacesContext context, StringSE newId)
Faces 1.1 EL API を使用して createComponent
を実装します。
UIComponentClassicTagBase
の createComponent
context
- 現在のリクエストの FacesContext
newId
- コンポーネントの IDpublic static UIComponentTag getParentUIComponentTag(PageContext context)
UIComponentTag
が存在する場合、最も近くにある UIComponentTag
を見つけて返します。それ以外の場合は、null
を返します。
context
- 現在のページの PageContext
Copyright © 2018,2020 Eclipse Foundation.
Use is subject to license terms.