クラス BindStatus
java.lang.ObjectSE
org.springframework.web.servlet.support.BindStatus
フィールドまたはオブジェクトのバインドステータスを公開する単純なアダプター。JSP バインドタグと FreeMarker マクロの両方で変数として設定します。
明らかに、オブジェクトステータス表現(つまり、フィールドレベルではなくオブジェクトレベルのエラー)には、式と値はありませんが、エラーコードとメッセージのみがあります。わかりやすくするため、および同じタグとマクロを使用できるようにするために、両方のシナリオで同じステータスクラスを使用しています。
- 作成者:
- Rod Johnson, Juergen Hoeller, Darren Davison
- 関連事項:
コンストラクターの概要
コンストラクターコンストラクター説明BindStatus
(RequestContext requestContext, StringSE path, boolean htmlEscape) フィールドまたはオブジェクトのステータスを表す新しい BindStatus インスタンスを作成します。メソッドのサマリー
修飾子と型メソッド説明findEditor
(ClassSE<?> valueClass) このバインドされたステータスが現在バインドされているプロパティに関連付けられている、指定された値クラスの PropertyEditor を見つけます。フィールドの実際の値を返します。フィールドに適切な表示値を返します。このバインドステータスが現在バインドされているプロパティの PropertyEditor を返します。存在する場合、フィールドまたはオブジェクトの最初のエラーコードを返します。StringSE[]
存在する場合、フィールドまたはオブジェクトのエラーコードを返します。存在する場合、フィールドまたはオブジェクトの最初のエラーメッセージを返します。StringSE[]
存在する場合、フィールドまたはオブジェクトの解決されたエラーメッセージを返します。getErrorMessagesAsString
(StringSE delimiter) 指定された区切り文字で区切られたすべてのメッセージを連結して、エラーメッセージ文字列を返します。このバインドステータスが現在関連付けられている Errors インスタンス(通常は BindingResult)を返します。それぞれのフィールドの入力名として HTML フォームで使用できるバインド式を返します。フィールド固有でない場合はnull
を返します。getPath()
値とエラーが解決される Bean とプロパティパスを返します (例: "customer.address.street" )。getValue()
フィールドの現在の値を返します。ClassSE<?>
フィールドの 'Class
' 型を取得します。boolean
isError()
このステータスがフィールドまたはオブジェクトのエラーを表す場合に返されます。toString()
コンストラクターの詳細
BindStatus
public BindStatus(RequestContext requestContext, StringSE path, boolean htmlEscape) throws IllegalStateExceptionSE フィールドまたはオブジェクトのステータスを表す新しい BindStatus インスタンスを作成します。- パラメーター:
requestContext
- 現在の RequestContextpath
- 値とエラーが解決される Bean とプロパティパス (たとえば、"customer.address.street" )htmlEscape
- HTML エスケープエラーメッセージと文字列値かどうか- 例外:
IllegalStateExceptionSE
- 対応する Errors オブジェクトが見つからない場合
メソッドの詳細
getPath
値とエラーが解決される Bean とプロパティパスを返します (例: "customer.address.street" )。getExpression
それぞれのフィールドの入力名として HTML フォームで使用できるバインド式を返します。フィールド固有でない場合はnull
を返します。再送信に適したバインドパス (例: "address.street" ) を返します。バインドタグで必要な完全なバインドパスは、"customer" Bean にバインドされている場合は "customer.address.street" であることに注意してください。
getValue
フィールドの現在の値、つまり、プロパティ値または拒否された更新のいずれかを返します。フィールド固有でない場合は、null
を返します。元の値がすでに文字列であった場合、この値は HTML エスケープ文字列になります。
getValueType
フィールドの 'Class
' 型を取得します。"getValue()
" が "null
" を返す可能性があるため、"getValue().getClass()
" の代わりにこれを優先します。getActualValue
フィールドの実際の値、つまり生のプロパティ値、使用できない場合はnull
を返します。getDisplayValue
フィールドに適切な表示値、つまり null でない場合は文字列化された値、null 値の場合は空の文字列を返します。元の値が null 以外の場合、この値は HTML エスケープ文字列になります。元の値の
toString
結果は HTML エスケープされます。isError
public boolean isError()このステータスがフィールドまたはオブジェクトのエラーを表す場合に返されます。getErrorCodes
存在する場合、フィールドまたはオブジェクトのエラーコードを返します。ない場合は null ではなく空の配列を返します。getErrorCode
存在する場合、フィールドまたはオブジェクトの最初のエラーコードを返します。getErrorMessages
存在する場合、フィールドまたはオブジェクトの解決されたエラーメッセージを返します。ない場合は null ではなく空の配列を返します。getErrorMessage
存在する場合、フィールドまたはオブジェクトの最初のエラーメッセージを返します。getErrorMessagesAsString
指定された区切り文字で区切られたすべてのメッセージを連結して、エラーメッセージ文字列を返します。- パラメーター:
delimiter
- 区切り文字列、たとえば "," または「
「- 戻り値:
- エラーメッセージ文字列
getErrors
このバインドステータスが現在関連付けられている Errors インスタンス(通常は BindingResult)を返します。- 戻り値:
- 現在のエラーインスタンス、または存在しない場合は
null
- 関連事項:
getEditor
このバインドステータスが現在バインドされているプロパティの PropertyEditor を返します。- 戻り値:
- 現在の PropertyEditor、または存在しない場合は
null
findEditor
このバインドされたステータスが現在バインドされているプロパティに関連付けられている、指定された値クラスの PropertyEditor を見つけます。- パラメーター:
valueClass
- エディターが必要とする値クラス- 戻り値:
- 関連する PropertyEditor、またはない場合は
null
toString