Java Doc for Errors.java in  » J2EE » spring-framework-2.0.6 » org » springframework » validation » Java Source Code / Java DocumentationJava Source Code and Java Documentation

Field names can be properties of the target object (e.g. "name" when binding to a customer object), or nested fields in case of subobjects (e.g. "address.street"). Supports subtree navigation via Errors.setNestedPath(String) : for example, an AddressValidator validates "address", not being aware that this is a subobject of customer.

Note: Errors objects are single-threaded.
author:
   Rod Johnson
author:
   Juergen Hoeller
See Also:   Errors.setNestedPath
See Also:   BindException
See Also:   DataBinder
See Also:   ValidationUtils

Returns a nested path with a dot, i.e.

The field name may be null or empty String to indicate the current object itself rather than a field of it.

The field name may be null or empty String to indicate the current object itself rather than a field of it.

The field name may be null or empty String to indicate the current object itself rather than a field of it.

"." = same as the org.springframework.beans.PropertyAccessor.NESTED_PROPERTY_SEPARATOR nested property separator in the beans package.

This is a onvenience method to avoid repeated reject(..) calls for merging an Errors instance into another Errors instance.

Note that the passed-in Errors instance is supposed to refer to the same target object, or at least contain compatible errors that apply to the target object of this Errors instance.
Parameters:
  errors - the Errors instance to merge in

Implementations should support not only full field names like "name" but also pattern matches like "na*" or "address.*".
Parameters:
  field - the field name a List of FieldError instances

Implementations should be able to determine the type even when the field value is null, for example from some associated descriptor.
Parameters:
  field - the field name the type of the field, or null if not determinable

Allows for convenient access to user-specified field values, even if there were type mismatches.
Parameters:
  field - the field name the current value of the given field

Returns a nested path with a dot, i.e. "address.", for easy building of concatenated paths. Default is an empty String.

A Errors.popNestedPath() call will reset the original nested path before the corresponding pushNestedPath(String) call.

Using the nested path stack allows to set temporary nested paths for subobjects without having to worry about a temporary path holder.

For example: current path "spouse.", pushNestedPath("child") -> result path "spouse.child."; popNestedPath() -> "spouse." again.
Parameters:
  subPath - the sub path to push onto the nested path stack
See Also:   Errors.popNestedPath

The field name may be null or empty String to indicate the current object itself rather than a field of it. This may result in a corresponding field error within the nested object graph or a global error if the current object is the top object.
Parameters:
  field - the field name (may be null or empty String)
Parameters:
  errorCode - error code, interpretable as a message key
See Also:   Errors.getNestedPath()

The field name may be null or empty String to indicate the current object itself rather than a field of it. This may result in a corresponding field error within the nested object graph or a global error if the current object is the top object.
Parameters:
  field - the field name (may be null or empty String)
Parameters:
  errorCode - error code, interpretable as a message key
Parameters:
  defaultMessage - fallback default message
See Also:   Errors.getNestedPath()

The field name may be null or empty String to indicate the current object itself rather than a field of it. This may result in a corresponding field error within the nested object graph or a global error if the current object is the top object.
Parameters:
  field - the field name (may be null or empty String)
Parameters:
  errorCode - error code, interpretable as a message key
Parameters:
  errorArgs - error arguments, for argument binding via MessageFormat(can be null)
Parameters:
  defaultMessage - fallback default message
See Also:   Errors.getNestedPath()

For example, an address validator could validate the subobject "address" of a customer object.
Parameters:
  nestedPath - nested path within this object,e.g. "address" (defaults to "", null is also acceptable).Can end with a dot: both "address" and "address." are valid.