Author: mbenson
Date: Wed Jun 27 16:27:55 2012
New Revision: 1354616
URL: http://svn.apache.org/viewvc?rev=1354616&view=rev
Log:
[LANG-753] Document v3.x changes to Validate API
Modified:
commons/proper/lang/trunk/src/site/xdoc/article3_0.xml
Modified: commons/proper/lang/trunk/src/site/xdoc/article3_0.xml
URL:
http://svn.apache.org/viewvc/commons/proper/lang/trunk/src/site/xdoc/article3_0.xml?rev=1354616&r1=1354615&r2=1354616&view=diff
==============================================================================
--- commons/proper/lang/trunk/src/site/xdoc/article3_0.xml (original)
+++ commons/proper/lang/trunk/src/site/xdoc/article3_0.xml Wed Jun 27 16:27:55
2012
@@ -185,6 +185,14 @@ available in the <a href="userguide.html
<li>StringUtils.isAlpha, isNumeric and isAlphanumeric now all return false
when passed an empty String. Previously they returned true. </li>
<li>SystemUtils.isJavaVersionAtLeast now relies on the
<code>java.specification.version</code> and not the <code>java.version</code>
System property. </li>
<li>StringEscapeUtils.escapeXml and escapeHtml no longer escape high value
Unicode characters by default. The text.translate package is available to
recreate the old behaviour. </li>
+<li>Validate utility methods have been changed and genericized to return the
+validated argument where possible, to allow for inline use. </li>
+<li>Validate utility methods handle validity violations arising from
+<code>null</code> values by throwing <code>NullPointerException</code>s.
+This better aligns with standard JDK behavior (lang <em>is</em> intended to
+complement <code>java.lang</code>, after all). Users upgrading from v2.x may
+need to adjust to this change. See <code>Validate#isTrue()</code> for a
+general-purpose mechanism to raise an
<code>IllegalArgumentException</code>.</li>
</ul>
</section>
