You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@commons.apache.org by ba...@apache.org on 2013/10/17 08:18:48 UTC
svn commit: r882935 [3/37] - in
/websites/production/commons/content/proper/commons-lang: ./ apidocs/
apidocs/org/apache/commons/lang3/ apidocs/org/apache/commons/lang3/reflect/
apidocs/org/apache/commons/lang3/time/ apidocs/src-html/org/apache/commons...
Modified: websites/production/commons/content/proper/commons-lang/apidocs/org/apache/commons/lang3/BooleanUtils.html
==============================================================================
--- websites/production/commons/content/proper/commons-lang/apidocs/org/apache/commons/lang3/BooleanUtils.html (original)
+++ websites/production/commons/content/proper/commons-lang/apidocs/org/apache/commons/lang3/BooleanUtils.html Thu Oct 17 06:18:45 2013
@@ -114,7 +114,7 @@ Class BooleanUtils</H2>
<DT><B>Since:</B></DT>
<DD>2.0</DD>
<DT><B>Version:</B></DT>
- <DD>$Id: BooleanUtils.java 1488041 2013-05-30 22:44:47Z sebb $</DD>
+ <DD>$Id: BooleanUtils.java 1532491 2013-10-15 19:09:31Z britter $</DD>
</DL>
<HR>
@@ -190,6 +190,22 @@ Class BooleanUtils</H2>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>static boolean</CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/lang3/BooleanUtils.html#isOneTrue(boolean...)">isOneTrue</A></B>(boolean... array)</CODE>
+
+<BR>
+ Checks if exactly one of the given booleans is true.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A></CODE></FONT></TD>
+<TD><CODE><B><A HREF="../../../../org/apache/commons/lang3/BooleanUtils.html#isOneTrue(java.lang.Boolean...)">isOneTrue</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A>... array)</CODE>
+
+<BR>
+ Checks if exactly one of the given Booleans is true.</TD>
+</TR>
+<TR BGCOLOR="white" CLASS="TableRowColor">
+<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
+<CODE>static boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/commons/lang3/BooleanUtils.html#isTrue(java.lang.Boolean)">isTrue</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> bool)</CODE>
<BR>
@@ -666,10 +682,64 @@ public static boolean <A HREF="../../../
</DL>
<HR>
+<A NAME="isOneTrue(boolean...)"><!-- --></A><H3>
+isOneTrue</H3>
+<PRE>
+public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.162"><B>isOneTrue</B></A>(boolean... array)</PRE>
+<DL>
+<DD><p>Checks if exactly one of the given booleans is true.</p>
+
+ <pre>
+ BooleanUtils.isOneTrue(true, true) = false
+ BooleanUtils.isOneTrue(false, false) = false
+ BooleanUtils.isOneTrue(true, false) = true
+ BooleanUtils.isOneTrue(true, true) = false
+ BooleanUtils.isOneTrue(false, false) = false
+ BooleanUtils.isOneTrue(true, false) = true
+ </pre>
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>array</CODE> - an array of <code>boolean</code>s
+<DT><B>Returns:</B><DD><code>true</code> if the array containes the value true only once.
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if <code>array</code> is <code>null</code>
+<DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if <code>array</code> is empty.<DT><B>Since:</B></DT>
+ <DD>3.2</DD>
+</DL>
+</DD>
+</DL>
+<HR>
+
+<A NAME="isOneTrue(java.lang.Boolean...)"><!-- --></A><H3>
+isOneTrue</H3>
+<PRE>
+public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.205"><B>isOneTrue</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A>... array)</PRE>
+<DL>
+<DD><p>Checks if exactly one of the given Booleans is true.</p>
+
+ <pre>
+ BooleanUtils.isOneTrue(new Boolean[] { Boolean.TRUE, Boolean.TRUE }) = Boolean.FALSE
+ BooleanUtils.isOneTrue(new Boolean[] { Boolean.FALSE, Boolean.FALSE }) = Boolean.FALSE
+ BooleanUtils.isOneTrue(new Boolean[] { Boolean.TRUE, Boolean.FALSE }) = Boolean.TRUE
+ </pre>
+<P>
+<DD><DL>
+<DT><B>Parameters:</B><DD><CODE>array</CODE> - an array of <code>Boolean</code>s
+<DT><B>Returns:</B><DD><code>true</code> if the array containes a Boolean with value true only once.
+<DT><B>Throws:</B>
+<DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if <code>array</code> is <code>null</code>
+<DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if <code>array</code> is empty.
+<DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if <code>array</code> contains a <code>null</code><DT><B>Since:</B></DT>
+ <DD>3.2</DD>
+</DL>
+</DD>
+</DL>
+<HR>
+
<A NAME="toBoolean(java.lang.Boolean)"><!-- --></A><H3>
toBoolean</H3>
<PRE>
-public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.158"><B>toBoolean</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> bool)</PRE>
+public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.234"><B>toBoolean</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> bool)</PRE>
<DL>
<DD><p>Converts a Boolean to a boolean handling <code>null</code>
by returning <code>false</code>.</p>
@@ -690,7 +760,7 @@ public static boolean <A HREF="../../../
<A NAME="toBooleanDefaultIfNull(java.lang.Boolean, boolean)"><!-- --></A><H3>
toBooleanDefaultIfNull</H3>
<PRE>
-public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.175"><B>toBooleanDefaultIfNull</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> bool,
+public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.251"><B>toBooleanDefaultIfNull</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> bool,
boolean valueIfNull)</PRE>
<DL>
<DD><p>Converts a Boolean to a boolean handling <code>null</code>.</p>
@@ -711,7 +781,7 @@ public static boolean <A HREF="../../../
<A NAME="toBoolean(int)"><!-- --></A><H3>
toBoolean</H3>
<PRE>
-public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.198"><B>toBoolean</B></A>(int value)</PRE>
+public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.274"><B>toBoolean</B></A>(int value)</PRE>
<DL>
<DD><p>Converts an int to a boolean using the convention that <code>zero</code>
is <code>false</code>.</p>
@@ -733,7 +803,7 @@ public static boolean <A HREF="../../../
<A NAME="toBooleanObject(int)"><!-- --></A><H3>
toBooleanObject</H3>
<PRE>
-public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.216"><B>toBooleanObject</B></A>(int value)</PRE>
+public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.292"><B>toBooleanObject</B></A>(int value)</PRE>
<DL>
<DD><p>Converts an int to a Boolean using the convention that <code>zero</code>
is <code>false</code>.</p>
@@ -755,7 +825,7 @@ public static <A HREF="http://download.o
<A NAME="toBooleanObject(java.lang.Integer)"><!-- --></A><H3>
toBooleanObject</H3>
<PRE>
-public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.238"><B>toBooleanObject</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</A> value)</PRE>
+public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.314"><B>toBooleanObject</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</A> value)</PRE>
<DL>
<DD><p>Converts an Integer to a Boolean using the convention that <code>zero</code>
is <code>false</code>.</p>
@@ -781,7 +851,7 @@ public static <A HREF="http://download.o
<A NAME="toBoolean(int, int, int)"><!-- --></A><H3>
toBoolean</H3>
<PRE>
-public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.261"><B>toBoolean</B></A>(int value,
+public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.337"><B>toBoolean</B></A>(int value,
int trueValue,
int falseValue)</PRE>
<DL>
@@ -806,7 +876,7 @@ public static boolean <A HREF="../../../
<A NAME="toBoolean(java.lang.Integer, java.lang.Integer, java.lang.Integer)"><!-- --></A><H3>
toBoolean</H3>
<PRE>
-public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.289"><B>toBoolean</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</A> value,
+public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.365"><B>toBoolean</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</A> value,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</A> trueValue,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</A> falseValue)</PRE>
<DL>
@@ -832,7 +902,7 @@ public static boolean <A HREF="../../../
<A NAME="toBooleanObject(int, int, int, int)"><!-- --></A><H3>
toBooleanObject</H3>
<PRE>
-public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.324"><B>toBooleanObject</B></A>(int value,
+public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.400"><B>toBooleanObject</B></A>(int value,
int trueValue,
int falseValue,
int nullValue)</PRE>
@@ -859,7 +929,7 @@ public static <A HREF="http://download.o
<A NAME="toBooleanObject(java.lang.Integer, java.lang.Integer, java.lang.Integer, java.lang.Integer)"><!-- --></A><H3>
toBooleanObject</H3>
<PRE>
-public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.356"><B>toBooleanObject</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</A> value,
+public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.432"><B>toBooleanObject</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</A> value,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</A> trueValue,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</A> falseValue,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</A> nullValue)</PRE>
@@ -886,7 +956,7 @@ public static <A HREF="http://download.o
<A NAME="toInteger(boolean)"><!-- --></A><H3>
toInteger</H3>
<PRE>
-public static int <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.392"><B>toInteger</B></A>(boolean bool)</PRE>
+public static int <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.468"><B>toInteger</B></A>(boolean bool)</PRE>
<DL>
<DD><p>Converts a boolean to an int using the convention that
<code>zero</code> is <code>false</code>.</p>
@@ -906,7 +976,7 @@ public static int <A HREF="../../../../s
<A NAME="toIntegerObject(boolean)"><!-- --></A><H3>
toIntegerObject</H3>
<PRE>
-public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.408"><B>toIntegerObject</B></A>(boolean bool)</PRE>
+public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.484"><B>toIntegerObject</B></A>(boolean bool)</PRE>
<DL>
<DD><p>Converts a boolean to an Integer using the convention that
<code>zero</code> is <code>false</code>.</p>
@@ -926,7 +996,7 @@ public static <A HREF="http://download.o
<A NAME="toIntegerObject(java.lang.Boolean)"><!-- --></A><H3>
toIntegerObject</H3>
<PRE>
-public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.426"><B>toIntegerObject</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> bool)</PRE>
+public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.502"><B>toIntegerObject</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> bool)</PRE>
<DL>
<DD><p>Converts a Boolean to a Integer using the convention that
<code>zero</code> is <code>false</code>.</p>
@@ -948,7 +1018,7 @@ public static <A HREF="http://download.o
<A NAME="toInteger(boolean, int, int)"><!-- --></A><H3>
toInteger</H3>
<PRE>
-public static int <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.446"><B>toInteger</B></A>(boolean bool,
+public static int <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.522"><B>toInteger</B></A>(boolean bool,
int trueValue,
int falseValue)</PRE>
<DL>
@@ -969,7 +1039,7 @@ public static int <A HREF="../../../../s
<A NAME="toInteger(java.lang.Boolean, int, int, int)"><!-- --></A><H3>
toInteger</H3>
<PRE>
-public static int <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.465"><B>toInteger</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> bool,
+public static int <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.541"><B>toInteger</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> bool,
int trueValue,
int falseValue,
int nullValue)</PRE>
@@ -992,7 +1062,7 @@ public static int <A HREF="../../../../s
<A NAME="toIntegerObject(boolean, java.lang.Integer, java.lang.Integer)"><!-- --></A><H3>
toIntegerObject</H3>
<PRE>
-public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.485"><B>toIntegerObject</B></A>(boolean bool,
+public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.561"><B>toIntegerObject</B></A>(boolean bool,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</A> trueValue,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</A> falseValue)</PRE>
<DL>
@@ -1013,7 +1083,7 @@ public static <A HREF="http://download.o
<A NAME="toIntegerObject(java.lang.Boolean, java.lang.Integer, java.lang.Integer, java.lang.Integer)"><!-- --></A><H3>
toIntegerObject</H3>
<PRE>
-public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.504"><B>toIntegerObject</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> bool,
+public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.580"><B>toIntegerObject</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> bool,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</A> trueValue,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</A> falseValue,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Integer.html?is-external=true" title="class or interface in java.lang">Integer</A> nullValue)</PRE>
@@ -1036,7 +1106,7 @@ public static <A HREF="http://download.o
<A NAME="toBooleanObject(java.lang.String)"><!-- --></A><H3>
toBooleanObject</H3>
<PRE>
-public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.545"><B>toBooleanObject</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> str)</PRE>
+public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.621"><B>toBooleanObject</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> str)</PRE>
<DL>
<DD><p>Converts a String to a Boolean.</p>
@@ -1076,7 +1146,7 @@ public static <A HREF="http://download.o
<A NAME="toBooleanObject(java.lang.String, java.lang.String, java.lang.String, java.lang.String)"><!-- --></A><H3>
toBooleanObject</H3>
<PRE>
-public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.652"><B>toBooleanObject</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> str,
+public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.728"><B>toBooleanObject</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> str,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> trueString,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> falseString,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> nullString)</PRE>
@@ -1104,7 +1174,7 @@ public static <A HREF="http://download.o
<A NAME="toBoolean(java.lang.String)"><!-- --></A><H3>
toBoolean</H3>
<PRE>
-public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.705"><B>toBoolean</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> str)</PRE>
+public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.781"><B>toBoolean</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> str)</PRE>
<DL>
<DD><p>Converts a String to a boolean (optimised for performance).</p>
@@ -1141,7 +1211,7 @@ public static boolean <A HREF="../../../
<A NAME="toBoolean(java.lang.String, java.lang.String, java.lang.String)"><!-- --></A><H3>
toBoolean</H3>
<PRE>
-public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.723"><B>toBoolean</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> str,
+public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.799"><B>toBoolean</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> str,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> trueString,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> falseString)</PRE>
<DL>
@@ -1164,7 +1234,7 @@ public static boolean <A HREF="../../../
<A NAME="toStringTrueFalse(java.lang.Boolean)"><!-- --></A><H3>
toStringTrueFalse</H3>
<PRE>
-public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.754"><B>toStringTrueFalse</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> bool)</PRE>
+public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.830"><B>toStringTrueFalse</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> bool)</PRE>
<DL>
<DD><p>Converts a Boolean to a String returning <code>'true'</code>,
<code>'false'</code>, or <code>null</code>.</p>
@@ -1185,7 +1255,7 @@ public static <A HREF="http://download.o
<A NAME="toStringOnOff(java.lang.Boolean)"><!-- --></A><H3>
toStringOnOff</H3>
<PRE>
-public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.771"><B>toStringOnOff</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> bool)</PRE>
+public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.847"><B>toStringOnOff</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> bool)</PRE>
<DL>
<DD><p>Converts a Boolean to a String returning <code>'on'</code>,
<code>'off'</code>, or <code>null</code>.</p>
@@ -1206,7 +1276,7 @@ public static <A HREF="http://download.o
<A NAME="toStringYesNo(java.lang.Boolean)"><!-- --></A><H3>
toStringYesNo</H3>
<PRE>
-public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.788"><B>toStringYesNo</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> bool)</PRE>
+public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.864"><B>toStringYesNo</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> bool)</PRE>
<DL>
<DD><p>Converts a Boolean to a String returning <code>'yes'</code>,
<code>'no'</code>, or <code>null</code>.</p>
@@ -1227,7 +1297,7 @@ public static <A HREF="http://download.o
<A NAME="toString(java.lang.Boolean, java.lang.String, java.lang.String, java.lang.String)"><!-- --></A><H3>
toString</H3>
<PRE>
-public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.807"><B>toString</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> bool,
+public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.883"><B>toString</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> bool,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> trueString,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> falseString,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> nullString)</PRE>
@@ -1250,7 +1320,7 @@ public static <A HREF="http://download.o
<A NAME="toStringTrueFalse(boolean)"><!-- --></A><H3>
toStringTrueFalse</H3>
<PRE>
-public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.828"><B>toStringTrueFalse</B></A>(boolean bool)</PRE>
+public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.904"><B>toStringTrueFalse</B></A>(boolean bool)</PRE>
<DL>
<DD><p>Converts a boolean to a String returning <code>'true'</code>
or <code>'false'</code>.</p>
@@ -1270,7 +1340,7 @@ public static <A HREF="http://download.o
<A NAME="toStringOnOff(boolean)"><!-- --></A><H3>
toStringOnOff</H3>
<PRE>
-public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.844"><B>toStringOnOff</B></A>(boolean bool)</PRE>
+public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.920"><B>toStringOnOff</B></A>(boolean bool)</PRE>
<DL>
<DD><p>Converts a boolean to a String returning <code>'on'</code>
or <code>'off'</code>.</p>
@@ -1290,7 +1360,7 @@ public static <A HREF="http://download.o
<A NAME="toStringYesNo(boolean)"><!-- --></A><H3>
toStringYesNo</H3>
<PRE>
-public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.860"><B>toStringYesNo</B></A>(boolean bool)</PRE>
+public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.936"><B>toStringYesNo</B></A>(boolean bool)</PRE>
<DL>
<DD><p>Converts a boolean to a String returning <code>'yes'</code>
or <code>'no'</code>.</p>
@@ -1310,7 +1380,7 @@ public static <A HREF="http://download.o
<A NAME="toString(boolean, java.lang.String, java.lang.String)"><!-- --></A><H3>
toString</H3>
<PRE>
-public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.877"><B>toString</B></A>(boolean bool,
+public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.953"><B>toString</B></A>(boolean bool,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> trueString,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> falseString)</PRE>
<DL>
@@ -1331,7 +1401,7 @@ public static <A HREF="http://download.o
<A NAME="and(boolean...)"><!-- --></A><H3>
and</H3>
<PRE>
-public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.900"><B>and</B></A>(boolean... array)</PRE>
+public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.976"><B>and</B></A>(boolean... array)</PRE>
<DL>
<DD><p>Performs an and on a set of booleans.</p>
@@ -1358,7 +1428,7 @@ public static boolean <A HREF="../../../
<A NAME="and(java.lang.Boolean...)"><!-- --></A><H3>
and</H3>
<PRE>
-public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.935"><B>and</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A>... array)</PRE>
+public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.1011"><B>and</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A>... array)</PRE>
<DL>
<DD><p>Performs an and on an array of Booleans.</p>
@@ -1387,7 +1457,7 @@ public static <A HREF="http://download.o
<A NAME="or(boolean...)"><!-- --></A><H3>
or</H3>
<PRE>
-public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.968"><B>or</B></A>(boolean... array)</PRE>
+public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.1044"><B>or</B></A>(boolean... array)</PRE>
<DL>
<DD><p>Performs an or on a set of booleans.</p>
@@ -1415,7 +1485,7 @@ public static boolean <A HREF="../../../
<A NAME="or(java.lang.Boolean...)"><!-- --></A><H3>
or</H3>
<PRE>
-public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.1004"><B>or</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A>... array)</PRE>
+public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.1080"><B>or</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A>... array)</PRE>
<DL>
<DD><p>Performs an or on an array of Booleans.</p>
@@ -1445,7 +1515,7 @@ public static <A HREF="http://download.o
<A NAME="xor(boolean...)"><!-- --></A><H3>
xor</H3>
<PRE>
-public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.1036"><B>xor</B></A>(boolean... array)</PRE>
+public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.1112"><B>xor</B></A>(boolean... array)</PRE>
<DL>
<DD><p>Performs an xor on a set of booleans.</p>
@@ -1471,7 +1541,7 @@ public static boolean <A HREF="../../../
<A NAME="xor(java.lang.Boolean...)"><!-- --></A><H3>
xor</H3>
<PRE>
-public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.1078"><B>xor</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A>... array)</PRE>
+public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A> <A HREF="../../../../src-html/org/apache/commons/lang3/BooleanUtils.html#line.1145"><B>xor</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Boolean.html?is-external=true" title="class or interface in java.lang">Boolean</A>... array)</PRE>
<DL>
<DD><p>Performs an xor on an array of Booleans.</p>
Modified: websites/production/commons/content/proper/commons-lang/apidocs/org/apache/commons/lang3/ObjectUtils.Null.html
==============================================================================
--- websites/production/commons/content/proper/commons-lang/apidocs/org/apache/commons/lang3/ObjectUtils.Null.html (original)
+++ websites/production/commons/content/proper/commons-lang/apidocs/org/apache/commons/lang3/ObjectUtils.Null.html Thu Oct 17 06:18:45 2013
@@ -102,7 +102,7 @@ Class ObjectUtils.Null</H2>
</DL>
<HR>
<DL>
-<DT><PRE>public static class <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.660"><B>ObjectUtils.Null</B></A><DT>extends <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A><DT>implements <A HREF="http://download.oracle.com/javase/6/docs/api/java/io/Serializable.html?is-external=true" title="class or interface in java.io">Serializable</A></DL>
+<DT><PRE>public static class <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.671"><B>ObjectUtils.Null</B></A><DT>extends <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A><DT>implements <A HREF="http://download.oracle.com/javase/6/docs/api/java/io/Serializable.html?is-external=true" title="class or interface in java.io">Serializable</A></DL>
</PRE>
<P>
Modified: websites/production/commons/content/proper/commons-lang/apidocs/org/apache/commons/lang3/ObjectUtils.html
==============================================================================
--- websites/production/commons/content/proper/commons-lang/apidocs/org/apache/commons/lang3/ObjectUtils.html (original)
+++ websites/production/commons/content/proper/commons-lang/apidocs/org/apache/commons/lang3/ObjectUtils.html Thu Oct 17 06:18:45 2013
@@ -114,7 +114,7 @@ Class ObjectUtils</H2>
<DT><B>Since:</B></DT>
<DD>1.0</DD>
<DT><B>Version:</B></DT>
- <DD>$Id: ObjectUtils.java 1500545 2013-07-07 22:07:46Z brentworden $</DD>
+ <DD>$Id: ObjectUtils.java 1532011 2013-10-14 18:15:39Z britter $</DD>
</DL>
<HR>
@@ -366,8 +366,8 @@ int</CODE></FONT></TD>
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> object2)</CODE>
<BR>
- Compares two objects for equality, where either one or both
- objects may be <code>null</code>.</TD>
+ <B>Deprecated.</B> <I>this method has been replaces by <code>java.util.Objects.equals(Object, Object)</code> in Java 7 and will
+ be removed from future releases.</I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -390,8 +390,8 @@ int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/commons/lang3/ObjectUtils.html#hashCode(java.lang.Object)">hashCode</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> obj)</CODE>
<BR>
- Gets the hash code of an object returning zero when the
- object is <code>null</code>.</TD>
+ <B>Deprecated.</B> <I>this method has been replaced by <code>java.util.Objects.hashCode(Object)</code> in Java 7 and will be
+ removed in future releases</I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -399,7 +399,8 @@ int</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/commons/lang3/ObjectUtils.html#hashCodeMulti(java.lang.Object...)">hashCodeMulti</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A>... objects)</CODE>
<BR>
- Gets the hash code for multiple objects.</TD>
+ <B>Deprecated.</B> <I>this method has been replaced by <code>java.util.Objects.hash(Object...)</code> in Java 7 an will be
+ removed in future releases.</I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -548,8 +549,9 @@ T</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../../org/apache/commons/lang3/ObjectUtils.html#toString(java.lang.Object)">toString</A></B>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> obj)</CODE>
<BR>
- Gets the <code>toString</code> of an <code>Object</code> returning
- an empty string ("") if <code>null</code> input.</TD>
+ <B>Deprecated.</B> <I>this method has been replaces by <code>java.util.Objects.toString(Object)</code> in Java 7 and will be
+ removed in future releases. Note however that said method will return "null" for null references, while this
+ method returns and empty String. To preserve behavior use <code>java.util.Objects.toString(myObject, "")</code></I></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
@@ -558,8 +560,8 @@ T</CODE></FONT></TD>
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> nullStr)</CODE>
<BR>
- Gets the <code>toString</code> of an <code>Object</code> returning
- a specified text if <code>null</code> input.</TD>
+ <B>Deprecated.</B> <I>this method has been replaces by <code>java.util.Objects.toString(Object, String)</code> in Java 7 and
+ will be removed in future releases.</I></TD>
</TR>
</TABLE>
<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
@@ -697,9 +699,12 @@ public static <T> T <A HREF="../..
<A NAME="equals(java.lang.Object, java.lang.Object)"><!-- --></A><H3>
equals</H3>
<PRE>
-public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.153"><B>equals</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> object1,
+public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.155"><B>equals</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> object1,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> object2)</PRE>
<DL>
+<DD><B>Deprecated.</B> <I>this method has been replaces by <code>java.util.Objects.equals(Object, Object)</code> in Java 7 and will
+ be removed from future releases.</I>
+<P>
<DD><p>Compares two objects for equality, where either one or both
objects may be <code>null</code>.</p>
@@ -724,7 +729,7 @@ public static boolean <A HREF="../../../
<A NAME="notEqual(java.lang.Object, java.lang.Object)"><!-- --></A><H3>
notEqual</H3>
<PRE>
-public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.182"><B>notEqual</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> object1,
+public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.184"><B>notEqual</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> object1,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> object2)</PRE>
<DL>
<DD><p>Compares two objects for inequality, where either one or both
@@ -751,8 +756,11 @@ public static boolean <A HREF="../../../
<A NAME="hashCode(java.lang.Object)"><!-- --></A><H3>
hashCode</H3>
<PRE>
-public static int <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.199"><B>hashCode</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> obj)</PRE>
+public static int <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.203"><B>hashCode</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> obj)</PRE>
<DL>
+<DD><B>Deprecated.</B> <I>this method has been replaced by <code>java.util.Objects.hashCode(Object)</code> in Java 7 and will be
+ removed in future releases</I>
+<P>
<DD><p>Gets the hash code of an object returning zero when the
object is <code>null</code>.</p>
@@ -773,8 +781,11 @@ public static int <A HREF="../../../../s
<A NAME="hashCodeMulti(java.lang.Object...)"><!-- --></A><H3>
hashCodeMulti</H3>
<PRE>
-public static int <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.224"><B>hashCodeMulti</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A>... objects)</PRE>
+public static int <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.230"><B>hashCodeMulti</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A>... objects)</PRE>
<DL>
+<DD><B>Deprecated.</B> <I>this method has been replaced by <code>java.util.Objects.hash(Object...)</code> in Java 7 an will be
+ removed in future releases.</I>
+<P>
<DD><p>Gets the hash code for multiple objects.</p>
<p>This allows a hash code to be rapidly calculated for a number of objects.
@@ -802,7 +813,7 @@ public static int <A HREF="../../../../s
<A NAME="identityToString(java.lang.Object)"><!-- --></A><H3>
identityToString</H3>
<PRE>
-public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.252"><B>identityToString</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> object)</PRE>
+public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.258"><B>identityToString</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> object)</PRE>
<DL>
<DD><p>Gets the toString that would be produced by <code>Object</code>
if a class did not override toString itself. <code>null</code>
@@ -826,7 +837,7 @@ public static <A HREF="http://download.o
<A NAME="identityToString(java.lang.Appendable, java.lang.Object)"><!-- --></A><H3>
identityToString</H3>
<PRE>
-public static void <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.277"><B>identityToString</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Appendable.html?is-external=true" title="class or interface in java.lang">Appendable</A> appendable,
+public static void <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.283"><B>identityToString</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Appendable.html?is-external=true" title="class or interface in java.lang">Appendable</A> appendable,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> object)
throws <A HREF="http://download.oracle.com/javase/6/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</A></PRE>
<DL>
@@ -853,7 +864,7 @@ public static void <A HREF="../../../../
<A NAME="identityToString(org.apache.commons.lang3.text.StrBuilder, java.lang.Object)"><!-- --></A><H3>
identityToString</H3>
<PRE>
-public static void <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.301"><B>identityToString</B></A>(<A HREF="../../../../org/apache/commons/lang3/text/StrBuilder.html" title="class in org.apache.commons.lang3.text">StrBuilder</A> builder,
+public static void <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.307"><B>identityToString</B></A>(<A HREF="../../../../org/apache/commons/lang3/text/StrBuilder.html" title="class in org.apache.commons.lang3.text">StrBuilder</A> builder,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> object)</PRE>
<DL>
<DD><p>Appends the toString that would be produced by <code>Object</code>
@@ -877,7 +888,7 @@ public static void <A HREF="../../../../
<A NAME="identityToString(java.lang.StringBuffer, java.lang.Object)"><!-- --></A><H3>
identityToString</H3>
<PRE>
-public static void <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.325"><B>identityToString</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/StringBuffer.html?is-external=true" title="class or interface in java.lang">StringBuffer</A> buffer,
+public static void <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.331"><B>identityToString</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/StringBuffer.html?is-external=true" title="class or interface in java.lang">StringBuffer</A> buffer,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> object)</PRE>
<DL>
<DD><p>Appends the toString that would be produced by <code>Object</code>
@@ -901,7 +912,7 @@ public static void <A HREF="../../../../
<A NAME="identityToString(java.lang.StringBuilder, java.lang.Object)"><!-- --></A><H3>
identityToString</H3>
<PRE>
-public static void <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.349"><B>identityToString</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/StringBuilder.html?is-external=true" title="class or interface in java.lang">StringBuilder</A> builder,
+public static void <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.355"><B>identityToString</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/StringBuilder.html?is-external=true" title="class or interface in java.lang">StringBuilder</A> builder,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> object)</PRE>
<DL>
<DD><p>Appends the toString that would be produced by <code>Object</code>
@@ -925,8 +936,12 @@ public static void <A HREF="../../../../
<A NAME="toString(java.lang.Object)"><!-- --></A><H3>
toString</H3>
<PRE>
-public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.377"><B>toString</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> obj)</PRE>
+public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.386"><B>toString</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> obj)</PRE>
<DL>
+<DD><B>Deprecated.</B> <I>this method has been replaces by <code>java.util.Objects.toString(Object)</code> in Java 7 and will be
+ removed in future releases. Note however that said method will return "null" for null references, while this
+ method returns and empty String. To preserve behavior use <code>java.util.Objects.toString(myObject, "")</code></I>
+<P>
<DD><p>Gets the <code>toString</code> of an <code>Object</code> returning
an empty string ("") if <code>null</code> input.</p>
@@ -950,9 +965,12 @@ public static <A HREF="http://download.o
<A NAME="toString(java.lang.Object, java.lang.String)"><!-- --></A><H3>
toString</H3>
<PRE>
-public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.400"><B>toString</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> obj,
+public static <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.411"><B>toString</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> obj,
<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> nullStr)</PRE>
<DL>
+<DD><B>Deprecated.</B> <I>this method has been replaces by <code>java.util.Objects.toString(Object, String)</code> in Java 7 and
+ will be removed in future releases.</I>
+<P>
<DD><p>Gets the <code>toString</code> of an <code>Object</code> returning
a specified text if <code>null</code> input.</p>
@@ -977,7 +995,7 @@ public static <A HREF="http://download.o
<A NAME="min(java.lang.Comparable[])"><!-- --></A><A NAME="min(T...)"><!-- --></A><H3>
min</H3>
<PRE>
-public static <T extends <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</A><? super T>> T <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.419"><B>min</B></A>(T... values)</PRE>
+public static <T extends <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</A><? super T>> T <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.430"><B>min</B></A>(T... values)</PRE>
<DL>
<DD><p>Null safe comparison of Comparables.</p>
<P>
@@ -996,7 +1014,7 @@ public static <T extends <A HREF="htt
<A NAME="max(java.lang.Comparable[])"><!-- --></A><A NAME="max(T...)"><!-- --></A><H3>
max</H3>
<PRE>
-public static <T extends <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</A><? super T>> T <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.444"><B>max</B></A>(T... values)</PRE>
+public static <T extends <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</A><? super T>> T <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.455"><B>max</B></A>(T... values)</PRE>
<DL>
<DD><p>Null safe comparison of Comparables.</p>
<P>
@@ -1015,7 +1033,7 @@ public static <T extends <A HREF="htt
<A NAME="compare(java.lang.Comparable,java.lang.Comparable)"><!-- --></A><A NAME="compare(T, T)"><!-- --></A><H3>
compare</H3>
<PRE>
-public static <T extends <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</A><? super T>> int <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.466"><B>compare</B></A>(T c1,
+public static <T extends <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</A><? super T>> int <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.477"><B>compare</B></A>(T c1,
T c2)</PRE>
<DL>
<DD><p>Null safe comparison of Comparables.
@@ -1032,7 +1050,7 @@ public static <T extends <A HREF="htt
<A NAME="compare(java.lang.Comparable,java.lang.Comparable,boolean)"><!-- --></A><A NAME="compare(T, T, boolean)"><!-- --></A><H3>
compare</H3>
<PRE>
-public static <T extends <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</A><? super T>> int <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.483"><B>compare</B></A>(T c1,
+public static <T extends <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</A><? super T>> int <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.494"><B>compare</B></A>(T c1,
T c2,
boolean nullGreater)</PRE>
<DL>
@@ -1051,7 +1069,7 @@ public static <T extends <A HREF="htt
<A NAME="median(java.lang.Comparable[])"><!-- --></A><A NAME="median(T...)"><!-- --></A><H3>
median</H3>
<PRE>
-public static <T extends <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</A><? super T>> T <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.504"><B>median</B></A>(T... items)</PRE>
+public static <T extends <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Comparable.html?is-external=true" title="class or interface in java.lang">Comparable</A><? super T>> T <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.515"><B>median</B></A>(T... items)</PRE>
<DL>
<DD>Find the "best guess" middle value among comparables. If there is an even
number of total values, the lower of the two middle values will be returned.
@@ -1071,7 +1089,7 @@ public static <T extends <A HREF="htt
<A NAME="median(java.util.Comparator,java.lang.Object[])"><!-- --></A><A NAME="median(java.util.Comparator, T...)"><!-- --></A><H3>
median</H3>
<PRE>
-public static <T> T <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.526"><B>median</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/util/Comparator.html?is-external=true" title="class or interface in java.util">Comparator</A><T> comparator,
+public static <T> T <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.537"><B>median</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/util/Comparator.html?is-external=true" title="class or interface in java.util">Comparator</A><T> comparator,
T... items)</PRE>
<DL>
<DD>Find the "best guess" middle value among comparables. If there is an even
@@ -1092,7 +1110,7 @@ public static <T> T <A HREF="../..
<A NAME="mode(java.lang.Object[])"><!-- --></A><A NAME="mode(T...)"><!-- --></A><H3>
mode</H3>
<PRE>
-public static <T> T <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.548"><B>mode</B></A>(T... items)</PRE>
+public static <T> T <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.559"><B>mode</B></A>(T... items)</PRE>
<DL>
<DD>Find the most frequently occurring item.
<P>
@@ -1108,7 +1126,7 @@ public static <T> T <A HREF="../..
<A NAME="clone(java.lang.Object)"><!-- --></A><A NAME="clone(T)"><!-- --></A><H3>
clone</H3>
<PRE>
-public static <T> T <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.586"><B>clone</B></A>(T obj)</PRE>
+public static <T> T <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.597"><B>clone</B></A>(T obj)</PRE>
<DL>
<DD><p>Clone an object.</p>
<P>
@@ -1126,7 +1144,7 @@ public static <T> T <A HREF="../..
<A NAME="cloneIfPossible(java.lang.Object)"><!-- --></A><A NAME="cloneIfPossible(T)"><!-- --></A><H3>
cloneIfPossible</H3>
<PRE>
-public static <T> T <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.640"><B>cloneIfPossible</B></A>(T obj)</PRE>
+public static <T> T <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.651"><B>cloneIfPossible</B></A>(T obj)</PRE>
<DL>
<DD><p>Clone an object if possible.</p>
@@ -1151,7 +1169,7 @@ public static <T> T <A HREF="../..
<A NAME="CONST(boolean)"><!-- --></A><H3>
CONST</H3>
<PRE>
-public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.723"><B>CONST</B></A>(boolean v)</PRE>
+public static boolean <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.734"><B>CONST</B></A>(boolean v)</PRE>
<DL>
<DD>This method returns the provided value unchanged.
This can prevent javac from inlining a constant
@@ -1175,7 +1193,7 @@ public static boolean <A HREF="../../../
<A NAME="CONST(byte)"><!-- --></A><H3>
CONST</H3>
<PRE>
-public static byte <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.741"><B>CONST</B></A>(byte v)</PRE>
+public static byte <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.752"><B>CONST</B></A>(byte v)</PRE>
<DL>
<DD>This method returns the provided value unchanged.
This can prevent javac from inlining a constant
@@ -1199,7 +1217,7 @@ public static byte <A HREF="../../../../
<A NAME="CONST_BYTE(int)"><!-- --></A><H3>
CONST_BYTE</H3>
<PRE>
-public static byte <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.762"><B>CONST_BYTE</B></A>(int v)
+public static byte <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.773"><B>CONST_BYTE</B></A>(int v)
throws <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</A></PRE>
<DL>
<DD>This method returns the provided value unchanged.
@@ -1228,7 +1246,7 @@ public static byte <A HREF="../../../../
<A NAME="CONST(char)"><!-- --></A><H3>
CONST</H3>
<PRE>
-public static char <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.785"><B>CONST</B></A>(char v)</PRE>
+public static char <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.796"><B>CONST</B></A>(char v)</PRE>
<DL>
<DD>This method returns the provided value unchanged.
This can prevent javac from inlining a constant
@@ -1252,7 +1270,7 @@ public static char <A HREF="../../../../
<A NAME="CONST(short)"><!-- --></A><H3>
CONST</H3>
<PRE>
-public static short <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.803"><B>CONST</B></A>(short v)</PRE>
+public static short <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.814"><B>CONST</B></A>(short v)</PRE>
<DL>
<DD>This method returns the provided value unchanged.
This can prevent javac from inlining a constant
@@ -1276,7 +1294,7 @@ public static short <A HREF="../../../..
<A NAME="CONST_SHORT(int)"><!-- --></A><H3>
CONST_SHORT</H3>
<PRE>
-public static short <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.824"><B>CONST_SHORT</B></A>(int v)
+public static short <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.835"><B>CONST_SHORT</B></A>(int v)
throws <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/IllegalArgumentException.html?is-external=true" title="class or interface in java.lang">IllegalArgumentException</A></PRE>
<DL>
<DD>This method returns the provided value unchanged.
@@ -1305,7 +1323,7 @@ public static short <A HREF="../../../..
<A NAME="CONST(int)"><!-- --></A><H3>
CONST</H3>
<PRE>
-public static int <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.848"><B>CONST</B></A>(int v)</PRE>
+public static int <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.859"><B>CONST</B></A>(int v)</PRE>
<DL>
<DD>This method returns the provided value unchanged.
This can prevent javac from inlining a constant
@@ -1329,7 +1347,7 @@ public static int <A HREF="../../../../s
<A NAME="CONST(long)"><!-- --></A><H3>
CONST</H3>
<PRE>
-public static long <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.866"><B>CONST</B></A>(long v)</PRE>
+public static long <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.877"><B>CONST</B></A>(long v)</PRE>
<DL>
<DD>This method returns the provided value unchanged.
This can prevent javac from inlining a constant
@@ -1353,7 +1371,7 @@ public static long <A HREF="../../../../
<A NAME="CONST(float)"><!-- --></A><H3>
CONST</H3>
<PRE>
-public static float <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.884"><B>CONST</B></A>(float v)</PRE>
+public static float <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.895"><B>CONST</B></A>(float v)</PRE>
<DL>
<DD>This method returns the provided value unchanged.
This can prevent javac from inlining a constant
@@ -1377,7 +1395,7 @@ public static float <A HREF="../../../..
<A NAME="CONST(double)"><!-- --></A><H3>
CONST</H3>
<PRE>
-public static double <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.902"><B>CONST</B></A>(double v)</PRE>
+public static double <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.913"><B>CONST</B></A>(double v)</PRE>
<DL>
<DD>This method returns the provided value unchanged.
This can prevent javac from inlining a constant
@@ -1401,7 +1419,7 @@ public static double <A HREF="../../../.
<A NAME="CONST(java.lang.Object)"><!-- --></A><A NAME="CONST(T)"><!-- --></A><H3>
CONST</H3>
<PRE>
-public static <T> T <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.921"><B>CONST</B></A>(T v)</PRE>
+public static <T> T <A HREF="../../../../src-html/org/apache/commons/lang3/ObjectUtils.html#line.932"><B>CONST</B></A>(T v)</PRE>
<DL>
<DD>This method returns the provided value unchanged.
This can prevent javac from inlining a constant
Modified: websites/production/commons/content/proper/commons-lang/apidocs/org/apache/commons/lang3/RandomStringUtils.html
==============================================================================
--- websites/production/commons/content/proper/commons-lang/apidocs/org/apache/commons/lang3/RandomStringUtils.html (original)
+++ websites/production/commons/content/proper/commons-lang/apidocs/org/apache/commons/lang3/RandomStringUtils.html Thu Oct 17 06:18:45 2013
@@ -118,7 +118,7 @@ Class RandomStringUtils</H2>
<DT><B>Since:</B></DT>
<DD>1.0</DD>
<DT><B>Version:</B></DT>
- <DD>$Id: RandomStringUtils.java 1436770 2013-01-22 07:09:45Z ggregory $</DD>
+ <DD>$Id: RandomStringUtils.java 1532684 2013-10-16 08:28:42Z bayard $</DD>
</DL>
<HR>
@@ -417,8 +417,8 @@ public static <A HREF="http://download.o
characters as indicated by the arguments.</p>
<P>
<DD><DL>
-<DT><B>Parameters:</B><DD><CODE>count</CODE> - the length of random string to create<DD><CODE>letters</CODE> - if <code>true</code>, generated string will include
- alphabetic characters<DD><CODE>numbers</CODE> - if <code>true</code>, generated string will include
+<DT><B>Parameters:</B><DD><CODE>count</CODE> - the length of random string to create<DD><CODE>letters</CODE> - if <code>true</code>, generated string may include
+ alphabetic characters<DD><CODE>numbers</CODE> - if <code>true</code>, generated string may include
numeric characters
<DT><B>Returns:</B><DD>the random string</DL>
</DD>
@@ -441,8 +441,8 @@ public static <A HREF="http://download.o
characters as indicated by the arguments.</p>
<P>
<DD><DL>
-<DT><B>Parameters:</B><DD><CODE>count</CODE> - the length of random string to create<DD><CODE>start</CODE> - the position in set of chars to start at<DD><CODE>end</CODE> - the position in set of chars to end before<DD><CODE>letters</CODE> - if <code>true</code>, generated string will include
- alphabetic characters<DD><CODE>numbers</CODE> - if <code>true</code>, generated string will include
+<DT><B>Parameters:</B><DD><CODE>count</CODE> - the length of random string to create<DD><CODE>start</CODE> - the position in set of chars to start at<DD><CODE>end</CODE> - the position in set of chars to end before<DD><CODE>letters</CODE> - if <code>true</code>, generated string may include
+ alphabetic characters<DD><CODE>numbers</CODE> - if <code>true</code>, generated string may include
numeric characters
<DT><B>Returns:</B><DD>the random string</DL>
</DD>
Modified: websites/production/commons/content/proper/commons-lang/apidocs/org/apache/commons/lang3/StringUtils.html
==============================================================================
--- websites/production/commons/content/proper/commons-lang/apidocs/org/apache/commons/lang3/StringUtils.html (original)
+++ websites/production/commons/content/proper/commons-lang/apidocs/org/apache/commons/lang3/StringUtils.html Thu Oct 17 06:18:45 2013
@@ -187,7 +187,7 @@ Class StringUtils</H2>
<DT><B>Since:</B></DT>
<DD>1.0</DD>
<DT><B>Version:</B></DT>
- <DD>$Id: StringUtils.java 1527373 2013-09-29 18:06:03Z ggregory $</DD>
+ <DD>$Id: StringUtils.java 1531643 2013-10-13 09:02:07Z bayard $</DD>
<DT><B>See Also:</B><DD><A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang"><CODE>String</CODE></A></DL>
<HR>
Modified: websites/production/commons/content/proper/commons-lang/apidocs/org/apache/commons/lang3/reflect/TypeLiteral.html
==============================================================================
--- websites/production/commons/content/proper/commons-lang/apidocs/org/apache/commons/lang3/reflect/TypeLiteral.html (original)
+++ websites/production/commons/content/proper/commons-lang/apidocs/org/apache/commons/lang3/reflect/TypeLiteral.html Thu Oct 17 06:18:45 2013
@@ -99,17 +99,55 @@ Class TypeLiteral<T></H2>
</DL>
<HR>
<DL>
-<DT><PRE>public abstract class <A HREF="../../../../../src-html/org/apache/commons/lang3/reflect/TypeLiteral.html#line.33"><B>TypeLiteral<T></B></A><DT>extends <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A><DT>implements <A HREF="../../../../../org/apache/commons/lang3/reflect/Typed.html" title="interface in org.apache.commons.lang3.reflect">Typed</A><T></DL>
+<DT><PRE>public abstract class <A HREF="../../../../../src-html/org/apache/commons/lang3/reflect/TypeLiteral.html#line.71"><B>TypeLiteral<T></B></A><DT>extends <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A><DT>implements <A HREF="../../../../../org/apache/commons/lang3/reflect/Typed.html" title="interface in org.apache.commons.lang3.reflect">Typed</A><T></DL>
</PRE>
<P>
-Type literal comparable to <code>javax.enterprise.util.TypeLiteral</code>,
+<p>Type literal comparable to <code>javax.enterprise.util.TypeLiteral</code>,
made generally available outside the JEE context. Allows the passing around of
a "token" that represents a type in a typesafe manner, as opposed to
- passing the (non-parameterized) <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/reflect/Type.html?is-external=true" title="class or interface in java.lang.reflect"><CODE>Type</CODE></A> object itself.
- Additionally <A HREF="../../../../../org/apache/commons/lang3/reflect/TypeLiteral.html" title="class in org.apache.commons.lang3.reflect"><CODE>TypeLiteral</CODE></A> implements the <A HREF="../../../../../org/apache/commons/lang3/reflect/Typed.html" title="interface in org.apache.commons.lang3.reflect"><CODE>Typed</CODE></A> interface which
- is a generalization of this concept. It is suggested that APIs be defined in
- terms of the interface, which others might implemented in custom classes.
+ passing the (non-parameterized) <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/reflect/Type.html?is-external=true" title="class or interface in java.lang.reflect"><CODE>Type</CODE></A> object itself. Consider:</p>
+ <p>
+ You might see such a typesafe API as:
+ <pre>
+ class Typesafe {
+ <T> T obtain(Class<T> type, ...);
+ }
+ </pre>
+ Consumed in the manner of:
+ <pre>
+ Foo foo = typesafe.obtain(Foo.class, ...);
+ </pre>
+ Yet, you run into problems when you want to do this with a parameterized type:
+ <pre>
+ List<String> listOfString = typesafe.obtain(List.class, ...); // could only give us a raw List
+ </pre>
+ <code>java.lang.reflect.Type</code> might provide some value:
+ <pre>
+ Type listOfStringType = ...; // firstly, how to obtain this? Doable, but not straightforward.
+ List<String> listOfString = (List<String>) typesafe.obtain(listOfStringType, ...); // nongeneric Type would necessitate a cast
+ </pre>
+ The "type literal" concept was introduced to provide an alternative, i.e.:
+ <pre>
+ class Typesafe {
+ <T> T obtain(TypeLiteral<T> type, ...);
+ }
+ </pre>
+ Consuming code looks like:
+ <pre>
+ List<String> listOfString = typesafe.obtain(new TypeLiteral<List<String>>() {}, ...);
+ </pre>
+ This has the effect of "jumping up" a level to tie a <code>java.lang.reflect.Type</code>
+ to a type variable while simultaneously making it short work to obtain a
+ <code>Type</code> instance for any given type, inline.
+ </p>
+ <p>Additionally <A HREF="../../../../../org/apache/commons/lang3/reflect/TypeLiteral.html" title="class in org.apache.commons.lang3.reflect"><CODE>TypeLiteral</CODE></A> implements the <A HREF="../../../../../org/apache/commons/lang3/reflect/Typed.html" title="interface in org.apache.commons.lang3.reflect"><CODE>Typed</CODE></A> interface which
+ is a generalization of this concept, and which may be implemented in custom classes.
+ It is suggested that APIs be defined in terms of the interface, in the following manner:
+ <pre>
+ <T> T obtain(Typed<T> typed, ...);
+ </pre>
+ </p>
<P>
<P>
@@ -218,7 +256,7 @@ Type literal comparable to <code>javax.e
<A NAME="value"><!-- --></A><H3>
value</H3>
<PRE>
-public final <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/reflect/Type.html?is-external=true" title="class or interface in java.lang.reflect">Type</A> <A HREF="../../../../../src-html/org/apache/commons/lang3/reflect/TypeLiteral.html#line.41"><B>value</B></A></PRE>
+public final <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/reflect/Type.html?is-external=true" title="class or interface in java.lang.reflect">Type</A> <A HREF="../../../../../src-html/org/apache/commons/lang3/reflect/TypeLiteral.html#line.79"><B>value</B></A></PRE>
<DL>
<DD>Represented type.
<P>
@@ -239,7 +277,7 @@ public final <A HREF="http://download.or
<A NAME="TypeLiteral()"><!-- --></A><H3>
TypeLiteral</H3>
<PRE>
-protected <A HREF="../../../../../src-html/org/apache/commons/lang3/reflect/TypeLiteral.html#line.45"><B>TypeLiteral</B></A>()</PRE>
+protected <A HREF="../../../../../src-html/org/apache/commons/lang3/reflect/TypeLiteral.html#line.83"><B>TypeLiteral</B></A>()</PRE>
<DL>
</DL>
@@ -256,7 +294,7 @@ protected <A HREF="../../../../../src-ht
<A NAME="equals(java.lang.Object)"><!-- --></A><H3>
equals</H3>
<PRE>
-public final boolean <A HREF="../../../../../src-html/org/apache/commons/lang3/reflect/TypeLiteral.html#line.54"><B>equals</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> obj)</PRE>
+public final boolean <A HREF="../../../../../src-html/org/apache/commons/lang3/reflect/TypeLiteral.html#line.92"><B>equals</B></A>(<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> obj)</PRE>
<DL>
<DD><DL>
<DT><B>Overrides:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)" title="class or interface in java.lang">equals</A></CODE> in class <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A></CODE></DL>
@@ -270,7 +308,7 @@ public final boolean <A HREF="../../../.
<A NAME="hashCode()"><!-- --></A><H3>
hashCode</H3>
<PRE>
-public int <A HREF="../../../../../src-html/org/apache/commons/lang3/reflect/TypeLiteral.html#line.66"><B>hashCode</B></A>()</PRE>
+public int <A HREF="../../../../../src-html/org/apache/commons/lang3/reflect/TypeLiteral.html#line.104"><B>hashCode</B></A>()</PRE>
<DL>
<DD><DL>
<DT><B>Overrides:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#hashCode()" title="class or interface in java.lang">hashCode</A></CODE> in class <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A></CODE></DL>
@@ -284,7 +322,7 @@ public int <A HREF="../../../../../src-h
<A NAME="toString()"><!-- --></A><H3>
toString</H3>
<PRE>
-public <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../../src-html/org/apache/commons/lang3/reflect/TypeLiteral.html#line.71"><B>toString</B></A>()</PRE>
+public <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <A HREF="../../../../../src-html/org/apache/commons/lang3/reflect/TypeLiteral.html#line.109"><B>toString</B></A>()</PRE>
<DL>
<DD><DL>
<DT><B>Overrides:</B><DD><CODE><A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true#toString()" title="class or interface in java.lang">toString</A></CODE> in class <CODE><A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A></CODE></DL>
@@ -298,7 +336,7 @@ public <A HREF="http://download.oracle.c
<A NAME="getType()"><!-- --></A><H3>
getType</H3>
<PRE>
-public <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/reflect/Type.html?is-external=true" title="class or interface in java.lang.reflect">Type</A> <A HREF="../../../../../src-html/org/apache/commons/lang3/reflect/TypeLiteral.html#line.76"><B>getType</B></A>()</PRE>
+public <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/reflect/Type.html?is-external=true" title="class or interface in java.lang.reflect">Type</A> <A HREF="../../../../../src-html/org/apache/commons/lang3/reflect/TypeLiteral.html#line.114"><B>getType</B></A>()</PRE>
<DL>
<DD><B>Description copied from interface: <CODE><A HREF="../../../../../org/apache/commons/lang3/reflect/Typed.html#getType()">Typed</A></CODE></B></DD>
<DD>Get the <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/reflect/Type.html?is-external=true" title="class or interface in java.lang.reflect"><CODE>Type</CODE></A> represented by this entity.
Modified: websites/production/commons/content/proper/commons-lang/apidocs/org/apache/commons/lang3/reflect/Typed.html
==============================================================================
--- websites/production/commons/content/proper/commons-lang/apidocs/org/apache/commons/lang3/reflect/Typed.html (original)
+++ websites/production/commons/content/proper/commons-lang/apidocs/org/apache/commons/lang3/reflect/Typed.html Thu Oct 17 06:18:45 2013
@@ -95,7 +95,7 @@ Interface Typed<T></H2>
</DL>
<HR>
<DL>
-<DT><PRE>public interface <A HREF="../../../../../src-html/org/apache/commons/lang3/reflect/Typed.html#line.24"><B>Typed<T></B></A></DL>
+<DT><PRE>public interface <A HREF="../../../../../src-html/org/apache/commons/lang3/reflect/Typed.html#line.25"><B>Typed<T></B></A></DL>
</PRE>
<P>
@@ -103,6 +103,8 @@ Generalization of "has a type."
<P>
<P>
+<DL>
+<DT><B>See Also:</B><DD><A HREF="../../../../../org/apache/commons/lang3/reflect/TypeLiteral.html" title="class in org.apache.commons.lang3.reflect"><CODE>TypeLiteral</CODE></A></DL>
<HR>
<P>
@@ -140,7 +142,7 @@ Generalization of "has a type."
<A NAME="getType()"><!-- --></A><H3>
getType</H3>
<PRE>
-<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/reflect/Type.html?is-external=true" title="class or interface in java.lang.reflect">Type</A> <A HREF="../../../../../src-html/org/apache/commons/lang3/reflect/Typed.html#line.31"><B>getType</B></A>()</PRE>
+<A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/reflect/Type.html?is-external=true" title="class or interface in java.lang.reflect">Type</A> <A HREF="../../../../../src-html/org/apache/commons/lang3/reflect/Typed.html#line.32"><B>getType</B></A>()</PRE>
<DL>
<DD>Get the <A HREF="http://download.oracle.com/javase/6/docs/api/java/lang/reflect/Type.html?is-external=true" title="class or interface in java.lang.reflect"><CODE>Type</CODE></A> represented by this entity.
<P>