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, unsubscribeFromEventencodeAll, getClientId, getCompositeComponentParent, getContainerClientId, getCurrentComponent, getCurrentCompositeComponent, getNamingContainer, getPassThroughAttributes, getResourceBundleMap, getStateHelper, getStateHelper, getTransientStateHelper, getTransientStateHelper, getValueExpression, initialStateMarked, isCompositeComponent, isInView, isVisitable, popComponentFromEL, processEvent, pushComponentToEL, restoreTransientState, saveTransientState, setInView, setValueExpression, visitTreecloneSE, equalsSE, finalizeSE, getClassSE, hashCodeSE, notifySE, notifyAllSE, toStringSE, waitSE, waitSE, waitSEpublic 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()
UIComponentBasePartialStateHolder を実装するこのインスタンス上の添付オブジェクトごとに、添付オブジェクトで 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)
StateHolderstate オブジェクトのエントリから状態を復元するために必要な処理を実行します。
このインターフェースを実装するクラスが、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.