public class UIViewParameter extends UIInput
UIViewParameter は、リクエストパラメーターとモデルプロパティまたは UIViewRoot プロパティ間のバインディングを表します。これは双方向バインディングです。
ViewDeclarationLanguage 実装では、<f:metadata /> 要素内に配置された <f:viewParam /> 要素が出現するたびに、このコンポーネントのインスタンスをビューに表示する必要があります。ユーザーはこのファセットを UIViewRoot 内に配置する必要があります。
このクラスは UIInput を継承するため、通常 UIInput インスタンスで実行されるすべてのアクションは、このクラスのインスタンスに対して有効です。このクラスのインスタンスは、Ajax リクエストを含む通常の Jakarta Server Faces ライフサイクルに参加します。
| 修飾子と型 | クラスと説明 |
|---|---|
static class | UIViewParameter.Reference 現在のビューがこの |
| 修飾子と型 | フィールドと説明 |
|---|---|
static StringSE | COMPONENT_FAMILY このコンポーネントの標準コンポーネントファミリ。 |
static StringSE | COMPONENT_TYPE このコンポーネントの標準コンポーネント型。 |
ALWAYS_PERFORM_VALIDATION_WHEN_REQUIRED_IS_TRUE, CONVERSION_MESSAGE_ID, EMPTY_STRING_AS_NULL_PARAM_NAME, REQUIRED_MESSAGE_ID, UPDATE_MESSAGE_ID, VALIDATE_EMPTY_FIELDS_PARAM_NAMEATTRS_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| コンストラクターと説明 |
|---|
UIViewParameter() デフォルトのプロパティ値で新しい UIViewParameter インスタンスを作成します。 |
| 修飾子と型 | メソッドと説明 |
|---|---|
void | decode(FacesContext context) スーパークラスの動作をオーバーライドして、 |
void | encodeAll(FacesContext context)
|
protected ObjectSE | getConvertedValue(FacesContext context, ObjectSE submittedValue) このクラスには |
StringSE | getFamily()このコンポーネントが属するコンポーネントファミリの識別子を返します。 |
StringSE | getName()値を取得するリクエストパラメーター名を返します。 |
StringSE | getStringValue(FacesContext context) このパラメーターの値が |
StringSE | getStringValueFromModel(FacesContext context)標準の変換手順を手動で実行して、値式から文字列値を取得します。 |
ObjectSE | getSubmittedValue() 送信された値は常に文字列であると想定しますが、このメソッドからの戻り値の型は |
boolean | isImmediate()
|
void | processValidators(FacesContext context) スーパークラスの動作を特殊化して、 |
void | setName(StringSE name)値を取得するリクエストパラメーター名を設定します。 |
void | setSubmittedValue(ObjectSE submittedValue)PENDING(ドキュメント)送信された値が親によって保存されないことに興味がある |
void | updateModel(FacesContext context) スーパークラス |
addValidator, addValueChangeListener, clearInitialState, compareValues, getConverterMessage, getRequiredMessage, getValidator, getValidatorMessage, getValidators, getValue, getValueChangeListener, getValueChangeListeners, isEmpty, isLocalValueSet, isRequired, isValid, markInitialState, processDecodes, processUpdates, removeValidator, removeValueChangeListener, resetValue, restoreState, saveState, setConverterMessage, setImmediate, setLocalValueSet, setRequired, setRequiredMessage, setValid, setValidator, setValidatorMessage, setValue, setValueChangeListener, validate, validateValuegetConverter, getLocalValue, setConverteraddClientBehavior, addFacesListener, broadcast, 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, processRestoreState, processSaveState, queueEvent, removeFacesListener, restoreAttachedState, saveAttachedState, setId, setParent, setRendered, setRendererType, setTransient, setValueBinding, subscribeToEvent, unsubscribeFromEventgetClientId, 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, waitSEgetConverter, getLocalValue, setConverterpublic UIViewParameter()
デフォルトのプロパティ値で新しい UIViewParameter インスタンスを作成します。
public StringSE getFamily()
UIComponent このコンポーネントが属するコンポーネントファミリの識別子を返します。この識別子は、rendererType プロパティの値と組み合わせて、このコンポーネントインスタンスに適切な Renderer を選択するために使用できます。このメソッドは null を返すべきではないことに注意してください
public StringSE getName()
値を取得するリクエストパラメーター名を返します。
public void setName(StringSE name)
値を取得するリクエストパラメーター名を設定します。
name - 新しいリクエストパラメーター名。public boolean isImmediate()
false を返します。即時設定はビューパラメーターには関係がないため、false であると想定する必要があります。
EditableValueHolder の isImmediate UIInput の isImmediate true、それ以外の場合は false。public ObjectSE getSubmittedValue()
送信された値は常に文字列であると想定しますが、このメソッドからの戻り値の型は Object です。
EditableValueHolder の getSubmittedValue UIInput の getSubmittedValue public void setSubmittedValue(ObjectSE submittedValue)
EditableValueHolder の setSubmittedValue UIInput の setSubmittedValue submittedValue - 新しく送信された値 public void decode(FacesContext context)
スーパークラスの動作をオーバーライドして、getName() によって指定された名前で受信リクエストパラメーターマップから値をプルし、UIInput.setSubmittedValue(java.lang.Object) への呼び出しで値を格納します。
UIInput の decode context - FacesContext(処理中のリクエスト)public void processValidators(FacesContext context)
スーパークラスの動作を特殊化して、 null を別の方法で扱います。このクラスでは、null 値と「必須」フラグが true に設定されていると、検証エラーが発生します。それ以外の場合、UIInput.EMPTY_STRING_AS_NULL_PARAM_NAME コンテキストパラメーターが true で値が null の場合、空の文字列を引数として渡して UIInput.setSubmittedValue(java.lang.Object) を呼び出します。これにより、Bean 検証を含む通常の検証処理が行われます。
UIInput の processValidators context - Faces コンテキスト。PreValidateEvent, PostValidateEventpublic void updateModel(FacesContext context)
スーパークラス UIInput.updateModel(jakarta.faces.context.FacesContext) を呼び出し、値が値式ではなく、有効であり、このライフサイクルの実行でローカル値が設定されている場合にのみ、値をリクエストスコープにプッシュする追加のアクションを実行します。
UIInput の updateModel context - FacesContext(処理中のリクエスト)public void encodeAll(FacesContext context) throws IOExceptionSE
UIViewRoot.encodeEnd(jakarta.faces.context.FacesContext) によって特別に呼び出されるこのメソッドは、送信された値を getStringValue(jakarta.faces.context.FacesContext) からの戻り値に設定するだけです。
UIComponent の encodeAll context - Faces コンテキスト。IOExceptionSE - I/O エラーが発生したとき。public StringSE getStringValue(FacesContext context)
このパラメーターの値が ValueExpression からのものである場合は式の値を返し、それ以外の場合はローカル値を返します。
context - Faces コンテキスト。public StringSE getStringValueFromModel(FacesContext context) throws ConverterException
標準の変換手順を手動で実行して、値式から文字列値を取得します。
context - Faces コンテキスト。ConverterExceptionprotected ObjectSE getConvertedValue(FacesContext context, ObjectSE submittedValue) throws ConverterException
このクラスには Renderer がないため、標準の HTML_BASIC RenderKit の component-family: jakarta.faces.Input および renderer-type: jakarta.faces.Text を利用して、その Renderer.getConvertedValue(jakarta.faces.context.FacesContext, jakarta.faces.component.UIComponent, java.lang.Object) メソッドを呼び出します。
UIInput の getConvertedValue submittedValue - 送信された値。context - Faces コンテキスト。ConverterExceptionCopyright © 2018,2020 Eclipse Foundation.
Use is subject to license terms.