commons-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
Subject svn commit: r1354616 - /commons/proper/lang/trunk/src/site/xdoc/article3_0.xml
Date Wed, 27 Jun 2012 16:27:56 GMT
Author: mbenson
Date: Wed Jun 27 16:27:55 2012
New Revision: 1354616

[LANG-753] Document v3.x changes to Validate API


Modified: commons/proper/lang/trunk/src/site/xdoc/article3_0.xml
--- 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>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>

View raw message