public class UIOutput extends UIComponentBase implements ValueHolder
UIOutput は UIComponent
であり、オプションで値式を介してモデル層 Bean から取得され、ユーザーに表示されます。ユーザーはレンダリングされた値を直接変更できません。表示のみを目的としています。
リクエスト処理ライフサイクルのレスポンスのレンダリングフェーズでは、次の規則に従って、このコンポーネントの現在の値を文字列に変換する必要があります(まだない場合)。
null
ではなく、まだ String
でない場合、次のように、変換に使用する Converter
(ある場合)を見つけます。null
ではなく、Converter
が見つかった場合、その getAsString()
メソッドを呼び出して変換を実行します。null
ではなく、Converter
が見つからなかった場合、現在の値で toString()
を呼び出して変換を実行します。 デフォルトでは、rendererType
プロパティを "jakarta.faces.Text
" に設定する必要があります。この値は、setRendererType()
メソッドを呼び出すことで変更できます。
修飾子と型 | フィールドと説明 |
---|---|
static StringSE | COMPONENT_FAMILY このコンポーネントの標準コンポーネントファミリ。 |
static StringSE | COMPONENT_TYPE このコンポーネントの標準コンポーネント型。 |
ATTRS_WITH_DECLARED_DEFAULT_VALUES, BEANINFO_KEY, bindings, COMPOSITE_COMPONENT_TYPE_KEY, COMPOSITE_FACET_NAME, CURRENT_COMPONENT, CURRENT_COMPOSITE_COMPONENT, FACETS_KEY, HONOR_CURRENT_COMPONENT_ATTRIBUTES_PARAM_NAME, VIEW_LOCATION_KEY
修飾子と型 | メソッドと説明 |
---|---|
void | clearInitialState()
|
Converter | getConverter() この UIComponent に登録されている Converter (ある場合)を返します。 |
StringSE | getFamily() このコンポーネントが属するコンポーネントファミリの識別子を返します。 |
ObjectSE | getLocalValue() 関連する ValueExpression を評価せずに、この UIComponent のローカル値(存在する場合)を返します。 |
ObjectSE | getValue() value プロパティを返します。 |
void | markInitialState() PartialStateHolder.markInitialState() が呼び出されたときに UIComponentBase で実行されたアクションに加えて、インストールされた Converter が PartialStateHolder であるかどうかを確認し、そうであれば PartialStateHolder.markInitialState() を呼び出します。 |
void | resetValue() このコンポーネントの値を初期化されていない状態にリセットする簡易メソッド。 |
void | restoreState(FacesContext context, ObjectSE state) state オブジェクトのエントリから状態を復元するために必要な処理を実行します。 |
ObjectSE | saveState(FacesContext context) インスタンスの状態を Serializable オブジェクトとして取得します。 |
void | setConverter(Converter converter) この UIComponent に登録されている Converter (ある場合)を設定します。 |
void | setValue(ObjectSE value) この UIComponent の値を設定します(ある場合)。 |
addClientBehavior, addFacesListener, broadcast, decode, encodeBegin, encodeChildren, encodeEnd, findComponent, getAttributes, getChildCount, getChildren, getClientBehaviors, getClientId, getDefaultEventName, getEventNames, getFacesContext, getFacesListeners, getFacet, getFacetCount, getFacets, getFacetsAndChildren, getId, getListenersForEventClass, getParent, getPassThroughAttributes, getRenderer, getRendererType, getRendersChildren, getValueBinding, invokeOnComponent, isRendered, isTransient, processDecodes, processRestoreState, processSaveState, processUpdates, processValidators, queueEvent, removeFacesListener, restoreAttachedState, saveAttachedState, setId, setParent, setRendered, setRendererType, setTransient, setValueBinding, subscribeToEvent, unsubscribeFromEvent
encodeAll, getClientId, getCompositeComponentParent, getContainerClientId, getCurrentComponent, getCurrentCompositeComponent, getNamingContainer, getPassThroughAttributes, getResourceBundleMap, getStateHelper, getStateHelper, getTransientStateHelper, getTransientStateHelper, getValueExpression, initialStateMarked, isCompositeComponent, isInView, isVisitable, popComponentFromEL, processEvent, pushComponentToEL, restoreTransientState, saveTransientState, setInView, setValueExpression, visitTree
cloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSE
public UIOutput()
デフォルトのプロパティ値で新しい UIOutput
インスタンスを作成します。
public StringSE getFamily()
UIComponent
このコンポーネントが属するコンポーネントファミリの識別子を返します。この識別子は、rendererType
プロパティの値と組み合わせて、このコンポーネントインスタンスに適切な Renderer
を選択するために使用できます。このメソッドは null
を返すべきではないことに注意してください
UIComponent
の getFamily
public Converter getConverter()
ValueHolder
この UIComponent
に登録されている Converter
(ある場合)を返します。
ValueHolder
の getConverter
public void setConverter(Converter converter)
ValueHolder
この UIComponent
に登録されている Converter
(ある場合)を設定します。
ValueHolder
の setConverter
converter
- 新しい Converter
(または null
)public ObjectSE getLocalValue()
ValueHolder
関連する ValueExpression
を評価せずに、この UIComponent
のローカル値(存在する場合)を返します。
ValueHolder
の getLocalValue
public ObjectSE getValue()
value プロパティを返します。
ValueHolder
の getValue
public void setValue(ObjectSE value)
ValueHolder
この UIComponent
の値を設定します(ある場合)。
ValueHolder
の setValue
value
- 新しいローカル値 public void resetValue()
このコンポーネントの値を初期化されていない状態にリセットする簡易メソッド。
public void markInitialState()
PartialStateHolder.markInitialState()
が呼び出されたときに UIComponentBase
で実行されたアクションに加えて、インストールされた Converter
が PartialStateHolder であるかどうかを確認し、そうであれば PartialStateHolder.markInitialState()
を呼び出します。
PartialStateHolder
の markInitialState
UIComponentBase
の markInitialState
public void clearInitialState()
UIComponentBase
PartialStateHolder
を実装するこのインスタンス上の添付オブジェクトごとに、添付オブジェクトで PartialStateHolder.clearInitialState()
を呼び出します。
PartialStateHolder
の clearInitialState
UIComponentBase
の clearInitialState
public ObjectSE saveState(FacesContext context)
StateHolder
インスタンスの状態を Serializable
オブジェクトとして取得します。
このインターフェースを実装するクラスが、StateHolder を実装するインスタンス(イベントハンドラー、バリデーターなどを含む UIComponent
など)への参照を持っている場合、このメソッドはそれらすべてのインスタンスで StateHolder.saveState(jakarta.faces.context.FacesContext)
メソッドも呼び出す必要があります。このメソッドは、子とファセットの状態を保存してはなりませんそれは StateManager
を介して行われます
このメソッドは、実装オブジェクトの状態を変更してはなりません。つまり、このコードを実行した後:
Object state = component.saveState(facesContext);
component
は、実行前と同じでなければなりません。
このメソッドからの戻り値は Serializable
でなければなりません
StateHolder
の saveState
UIComponentBase
の saveState
context
- Faces コンテキスト。public void restoreState(FacesContext context, ObjectSE state)
StateHolder
state オブジェクトのエントリから状態を復元するために必要な処理を実行します。
このインターフェースを実装するクラスが、StateHolder も実装するインスタンスへの参照を持っている場合(イベントハンドラー、バリデーターなどを備えた UIComponent
など)、このメソッドはそれらすべてのインスタンスで StateHolder.restoreState(jakarta.faces.context.FacesContext, java.lang.Object)
メソッドも呼び出す必要があります。
state
引数が null
の場合、アクションを実行せずに戻ります。
StateHolder
の restoreState
UIComponentBase
の restoreState
context
- Faces コンテキスト。state
- 状態。Copyright © 2018,2020 Eclipse Foundation.
Use is subject to license terms.