Package org.apache.cayenne.validation

## Class BeanValidationFailure

- java.lang.Object
- - org.apache.cayenne.validation.SimpleValidationFailure
  - - org.apache.cayenne.validation.BeanValidationFailure

- All Implemented Interfaces:
    `Serializable`, `ValidationFailure`

      public class BeanValidationFailure
      extends SimpleValidationFailure

  ValidationFailure implementation that described a failure of a single named property of a Java Bean object.
  Since:
    1.1
  See Also:
    Serialized Form

- - ### Field Summary

    Fields
    Modifier and Type | Field | Description
    --- | --- | ---
    `protected String` | `property` |

    - ### Fields inherited from class org.apache.cayenne.validation.SimpleValidationFailure

      `error, source`

  - ### Constructor Summary

    Constructors
    Constructor | Description
    --- | ---
    `BeanValidationFailure​(Object source, String property, Object error)` | Creates new BeanValidationFailure.

  - ### Method Summary

    All Methods Static Methods Instance Methods Concrete Methods
    Modifier and Type | Method | Description
    --- | --- | ---
    `String` | `getProperty()` | Returns a failed property of the failure source object.
    `String` | `toString()` | Returns a String representation of the failure.
    `static ValidationFailure` | `validateJavaClassName​(Object bean, String attribute, String identifier)` | A utility method that checks that a given string is a valid Java full class name, returning a non-null ValidationFailure if this is not so.
    `static ValidationFailure` | `validateMandatory​(Object bean, String attribute)` |
    `static ValidationFailure` | `validateMandatory​(Object bean, String attribute, Object value)` |
    `static ValidationFailure` | `validateNotEmpty​(Object bean, String attribute, String value)` | A utility method that returns a ValidationFailure if a string is either null or has a length of zero; otherwise returns null.
    `static ValidationFailure` | `validateNotEmpty​(Object bean, String attribute, Collection<?> value)` | Returns a ValidationFailure if a collection attribute of an object is null or empty.
    `static ValidationFailure` | `validateNotNull​(Object bean, String attribute, Object value)` |

    - ### Methods inherited from class org.apache.cayenne.validation.SimpleValidationFailure

      `getDescription, getError, getSource`

    - ### Methods inherited from class java.lang.Object

      `clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait`

- - ### Field Detail

    - #### property

          protected String property

  - ### Constructor Detail

    - #### BeanValidationFailure

          public BeanValidationFailure​(Object source,
                                       String property,
                                       Object error)

      Creates new BeanValidationFailure.

  - ### Method Detail

    - #### validateNotEmpty

          public static ValidationFailure validateNotEmpty​(Object bean,
                                                           String attribute,
                                                           Collection<?> value)

      Returns a ValidationFailure if a collection attribute of an object is null or empty.

    - #### validateMandatory

          public static ValidationFailure validateMandatory​(Object bean,
                                                            String attribute,
                                                            Object value)

    - #### validateMandatory

          public static ValidationFailure validateMandatory​(Object bean,
                                                            String attribute)

    - #### validateNotNull

          public static ValidationFailure validateNotNull​(Object bean,
                                                          String attribute,
                                                          Object value)

    - #### validateNotEmpty

          public static ValidationFailure validateNotEmpty​(Object bean,
                                                           String attribute,
                                                           String value)

      A utility method that returns a ValidationFailure if a string is either null or has a length of zero; otherwise returns null.

    - #### validateJavaClassName

          public static ValidationFailure validateJavaClassName​(Object bean,
                                                                String attribute,
                                                                String identifier)

      A utility method that checks that a given string is a valid Java full class name, returning a non-null ValidationFailure if this is not so. Special case: primitive arrays like byte[] are also handled as a valid java class name.
      Since:
        1.2

    - #### getProperty

          public String getProperty()

      Returns a failed property of the failure source object.

    - #### toString

          public String toString()

      Returns a String representation of the failure.
      Overrides:
        `toString` in class `SimpleValidationFailure`