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_NAME
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
コンストラクターと説明 |
---|
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, validateValue
getConverter, getLocalValue, setConverter
addClientBehavior, 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, unsubscribeFromEvent
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
getConverter, getLocalValue, setConverter
public 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
, PostValidateEvent
public 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 コンテキスト。ConverterException
protected 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 コンテキスト。ConverterException
Copyright © 2018,2020 Eclipse Foundation.
Use is subject to license terms.