Bean Validation

<h2 id="current-version">Current Version</h2>
<p>Bean Validation 2.0 is defined by <a href="https://jcp.org/en/jsr/detail?id=380">JSR 380</a>, approved 2017-07-31. This major release leverages language features in Java 8 that are very useful for the purposes of Bean Validation. So Java 8 is required as the minimum Java version.
</p><p>Other changes include:
</p>
<ul><li>Support for validating container elements by annotating type arguments of parameterized types, e.g. List<@Positive Integer> positiveNumbers; this also includes:
<ul><li>More flexible cascaded validation of collection types; e.g. values and keys of maps can be validated now: Map<@Valid CustomerType, @Valid Customer> customersByType</li>
<li>Support for java.util.Optional</li>
<li>Support for the property types declared by <a href="/facts/JavaFX/hWrAAmny">JavaFX</a></li>
<li>Support for custom container types by plugging in additional value extractors</li></ul></li>
<li>Support for the new date/time data types for @Past and @Future; fine-grained control over the current time and time zone used for validation</li>
<li>New built-in constraints: @Email, @NotEmpty, @NotBlank, @Positive, @PositiveOrZero, @Negative, @NegativeOrZero, @PastOrPresent and @FutureOrPresent</li>
<li>All built-in constraints are marked as repeatable now</li>
<li>Parameter names are retrieved using reflection</li>
<li>ConstraintValidator#initialize() is a default method</li>
<li>The namespace for Bean Validation XML descriptors has been changed to <a href="http://xmlns.jcp.org/xml/ns/validation/configuration">http://xmlns.jcp.org/xml/ns/validation/configuration</a>[<i>permanent dead link</i>] for META- INF/validation.xml and <a href="http://xmlns.jcp.org/xml/ns/validation/mapping">http://xmlns.jcp.org/xml/ns/validation/mapping</a>[<i>permanent dead link</i>] for constraint mapping files</li></ul>
<h2 id="previous-version">Previous Version</h2>
<p>Bean Validation 1.1 (<a href="http://www.jcp.org/en/jsr/detail?id=349">JSR 349</a>) improves upon the initial version 1.0 (<a href="https://jcp.org/en/jsr/detail?id=303">JSR 303</a>).  Significant changes<a class="footnote-ref" id="fnref:1" href="#fn:1"><sup>1</sup></a> include:
</p>
<ul><li>Validation of method arguments and return value</li>
<li>Dependency Injection</li>
<li>More open process in developing the specification</li></ul>
<p>Final release of <a href="http://beanvalidation.org/1.1/spec/">the 1.1 specification</a> occurred 2013-05-24.
</p>

<h2 id="further-reading">Further reading</h2>
<ul><li><a href="https://beanvalidation.org/">Official website</a>  Open development work of JSR 303, 349, & 380</li>
<li><a href="https://www.youtube.com/watch?v=GdKuxmtA65I">Video of presentation at Devoxx, *Bean Validation 2.0 - you’ve put your annotations everywhere! by Gunnar Morling*</a></li>
<li><a href="http://www.infoq.com/articles/emmanuel_bernard_interview">Interview with Spec Lead Emmanuel Bernard</a></li>
<li><a href="http://jcp.org/en/jsr/detail?id=303">JSR 303 Page</a></li>
<li><a href="http://www.hibernate.org/subprojects/validator.html">Hibernate Validator</a></li>
<li><a href="http://docs.jboss.org/hibernate/stable/beanvalidation/tck/reference/html_single/">Bean Validation TCK documentation</a></li>
<li><a href="http://community.jboss.org/wiki/BeanValidationTCK">How to run the Bean Validation TCK</a> <a href="https://web.archive.org/web/20100825101608/http://community.jboss.org/wiki/BeanValidationTCK">Archived</a> 2010-08-25 at the <a href="/facts/Wayback_Machine/nmQ3a6JC">Wayback Machine</a></li></ul>

<h2 id="references">References</h2>

<ol>
<li id="fn:1"><p>Emmanuel, Bernard. "Bean Validation 1.1 goals". Red Hat, Inc. Retrieved 2014-08-17. <a href="http://beanvalidation.org/1.1/changes/" target="_blank">http://beanvalidation.org/1.1/changes/</a> <a href="#fnref:1" class="footnote-back-ref">↩</a></p></li>
</ol>

Bean Validation open-in-new

Bean Validation