パッケージ jakarta.faces.component

クラス UIOutput

  • 実装されたすべてのインターフェース:
    PartialStateHolder、StateHolder、TransientStateHolder、ValueHolder、ComponentSystemEventListener、FacesListener、SystemEventListenerHolder、EventListenerSE
    既知の直属サブクラス
    HtmlBody、HtmlDoctype、HtmlHead、HtmlOutputFormat、HtmlOutputLabel、HtmlOutputLink、HtmlOutputText、UIInput、UIOutcomeTarget
    public class UIOutput
extends UIComponentBase
implements ValueHolder

    UIOutput は UIComponent であり、オプションで値式を介してモデル層 Bean から取得され、ユーザーに表示されます。ユーザーはレンダリングされた値を直接変更できません。表示のみを目的としています。

    リクエスト処理ライフサイクルのレスポンスのレンダリングフェーズでは、次の規則に従って、このコンポーネントの現在の値を文字列に変換する必要があります（まだない場合）。

    • 現在の値が null ではなく、まだ String でない場合、次のように、変換に使用する Converter（ある場合）を見つけます。
      • getConverter() が null 以外の Converter を返す場合、それを使用します。
      • Application.createConverter(Class) が現在の値のクラスを渡すと、NULL 以外の Converter が返され、それを使用します。
    • 現在の値が null ではなく、Converter が見つかった場合、その getAsString() メソッドを呼び出して変換を実行します。
    • 現在の値が null ではなく、Converter が見つからなかった場合、現在の値で toString() を呼び出して変換を実行します。

    デフォルトでは、rendererType プロパティを "jakarta.faces.Text" に設定する必要があります。この値は、setRendererType() メソッドを呼び出すことで変更できます。

    • フィールドの詳細

      • COMPONENT_FAMILY

        public static final StringSE COMPONENT_FAMILY

        このコンポーネントの標準コンポーネントファミリ。

        関連事項:
        定数フィールド値

    • コンストラクターの詳細

      • UIOutput

        public UIOutput()

        デフォルトのプロパティ値で新しい UIOutput インスタンスを作成します。

    • メソッドの詳細

      • getFamily

        public StringSE getFamily()
        クラスからコピーされた説明: UIComponent

        このコンポーネントが属するコンポーネントファミリの識別子を返します。この識別子は、rendererType プロパティの値と組み合わせて、このコンポーネントインスタンスに適切な Renderer を選択するために使用できます。このメソッドは null を返すべきではないことに注意してください

        次で指定:
        クラス UIComponent の getFamily 
        戻り値:
        コンポーネントファミリ（null 以外）。

      • setConverter

        public void setConverter​(Converter converter)
        インターフェースからコピーされた説明: ValueHolder

        この UIComponent に登録されている Converter（ある場合）を設定します。

        次で指定:
        インターフェース ValueHolder の setConverter 
        パラメーター:
        converter - 新しい Converter (または null)

      • getLocalValue

        public ObjectSE getLocalValue()
        インターフェースからコピーされた説明: ValueHolder

        関連する ValueExpression を評価せずに、この UIComponent のローカル値（存在する場合）を返します。

        次で指定:
        インターフェース ValueHolder の getLocalValue 
        戻り値:
        ローカル値。

      • getValue

        public ObjectSE getValue()

        value プロパティを返します。

        次で指定:
        インターフェース ValueHolder の getValue 
        戻り値:
        値。
        導入:
        2.2

      • setValue

        public void setValue​(ObjectSE value)
        インターフェースからコピーされた説明: ValueHolder

        この UIComponent の値を設定します（ある場合）。

        次で指定:
        インターフェース ValueHolder の setValue 
        パラメーター:
        value - 新しいローカル値

      • resetValue

        public void resetValue()

        このコンポーネントの値を初期化されていない状態にリセットする簡易メソッド。

        導入:
        2.2

      • saveState

        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 コンテキスト。
        戻り値:
        保存された状態。

      • restoreState

        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 - 状態。