svn commit: r1354616 - /commons/proper/lang/trunk/src/site/xdoc/article3_0.xml

[mb...@apache.org]

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>